Aliases - Create Or Update

Szolgáltatás:: Search Service

API-verzió:: 2025-08-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-08-01-preview

URI-paraméterek

Name	In	Kötelező	Típus	Description
aliasName	path	True	string	A létrehozandó vagy frissítendő alias definíciója.
endpoint	path	True	string	A keresési szolgáltatás végpontjának URL-címe.
api-version	query	True	string	Ügyfél API verziója.

Kérelem fejléce

Name	Kötelező	Típus	Description
x-ms-client-request-id		string (uuid)	A hibakeresési kérelemmel küldött nyomkövetési azonosító.
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	string	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

Name	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

Name	Típus	Description
200 OK	SearchAlias
201 Created	SearchAlias
Other Status Codes	ErrorResponse	Hibaválasz.

Példák

SearchServiceCreateOrUpdateAlias

Mintakérelem

HTTP

PUT https://previewexampleservice.search.windows.net/aliases('myalias')?api-version=2025-08-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

Name	Description
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
SearchAlias	Egy indexaliast jelöl, amely az alias nevének és az indexnek a leképezését írja le. Az alias neve használható az index neve helyett a támogatott műveletekhez.

ErrorAdditionalInfo

Tárgy

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

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Name	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

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

SearchAlias

Tárgy

Egy indexaliast jelöl, amely az alias nevének és az indexnek a leképezését írja le. Az alias neve használható az index neve helyett a támogatott műveletekhez.

Name	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.