Aliases - Create Or Update

Szolgáltatás:: Search Service

API-verzió:: 2025-11-01-preview

Létrehoz egy új keresési aliast, vagy frissíti az aliast, ha már létezik.

PUT {endpoint}/aliases('{aliasName}')?api-version=2025-11-01-preview

URI-paraméterek

Név	In	Kötelező	Típus	Description
aliasName	path	True	string	Az alias neve.
endpoint	path	True	string (uri)	A keresési szolgáltatás végpontjának URL-címe.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem fejléce

Név	Kötelező	Típus	Description
x-ms-client-request-id		string (uuid)	A kérés átlátszatlan, globálisan egyedi, ügyfél által generált sztringazonosítója.
Accept		Accept	Az Elfogadás fejléce.
If-Match		string	Meghatározza a If-Match feltételt. A művelet csak akkor lesz végrehajtva, ha a kiszolgálón lévő ETag megegyezik ezzel az értékkel.
If-None-Match		string	Meghatározza az If-None-Match feltételt. A művelet csak akkor lesz végrehajtva, ha a kiszolgálón lévő ETag nem egyezik meg ezzel az értékkel.
Prefer	True	Prefer	HTTP PUT-kérések esetén arra utasítja a szolgáltatást, hogy sikeres esetben adja vissza a létrehozott/frissített erőforrást.

Kérelem törzse

Név	Kötelező	Típus	Description
indexes	True	string[]	Annak az indexnek a neve, amelyre az alias leképezhető. Csak egy indexnév adható meg.
name	True	string	Az alias neve.
@odata.etag		string	Az álnév ETag-je.

Válaszok

Név	Típus	Description
200 OK	SearchAlias	A kérés sikeres volt.
201 Created	SearchAlias	A kérés sikeres volt, és ennek eredményeként új erőforrás jött létre.
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Biztonság

api-key

Típus: apiKey
In: header

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Hatókörök

Név	Description
https://search.azure.com/.default

Példák

SearchServiceCreateOrUpdateAlias

Mintakérelem

HTTP

PUT https://previewexampleservice.search.windows.net/aliases('myalias')?api-version=2025-11-01-preview





{
  "name": "myalias",
  "indexes": [
    "preview-test"
  ],
  "@odata.etag": "0x1234568AE7E58A1"
}

Mintaválasz

Állapotkód:: 200

{
  "name": "myalias",
  "indexes": [
    "preview-test"
  ]
}

Állapotkód:: 201

{
  "name": "myalias",
  "indexes": [
    "preview-test"
  ]
}

Definíciók

Név	Description
Accept	Az Elfogadás fejléce.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Az Összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)
Prefer	HTTP PUT-kérések esetén arra utasítja a szolgáltatást, hogy sikeres esetben adja vissza a létrehozott/frissített erőforrást.
SearchAlias	Egy index aliasát jelöli, amely az alias nevéből az indexbe való leképezést írja le. Az aliasnév a támogatott műveletek indexneve helyett használható.

Accept

Felsorolás

Az Elfogadás fejléce.

Érték	Description
application/json;odata.metadata=minimal

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Név	Típus	Description
info		A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Név	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Tárgy

Az Összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)

Név	Típus	Description
error	ErrorDetail	A hibaobjektum.

Prefer

Felsorolás

HTTP PUT-kérések esetén arra utasítja a szolgáltatást, hogy sikeres esetben adja vissza a létrehozott/frissített erőforrást.

Érték	Description
return=representation

SearchAlias

Tárgy

Egy index aliasát jelöli, amely az alias nevéből az indexbe való leképezést írja le. Az aliasnév a támogatott műveletek indexneve helyett használható.

Név	Típus	Description
@odata.etag	string	Az álnév ETag-je.
indexes	string[]	Annak az indexnek a neve, amelyre az alias leképezhető. Csak egy indexnév adható meg.
name	string	Az alias neve.