Aliases - Create Or Update

Szolgáltatás:: Search Service

API-verzió:: 2024-03-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=2024-03-01-Preview

URI-paraméterek

Name	In	Kötelező	Típus	Description
aliasName	path	True	string	A létrehozni vagy frissíteni kívánt alias definíciója.
endpoint	path	True	string	A keresési szolgáltatás végponti 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 kéréssel együtt küldött nyomkövetési azonosító, amely segít a hibakeresésben.
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 megfelel ennek az értéknek.
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 utasítja a szolgáltatást, hogy a létrehozott/frissített erőforrást adja vissza a sikerhez.

Kérelem törzse

Name	Kötelező	Típus	Description
indexes	True	string[]	Annak az indexnek a neve, amelybe az alias megfelel. Csak egy indexnév adható meg.
name	True	string	Az alias neve.
@odata.etag		string	Az alias ETagje.

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://myservice.search.windows.net/aliases('production')?api-version=2024-03-01-Preview


{
  "name": "production",
  "indexes": [
    "hotels"
  ]
}

Mintaválasz

Állapotkód:: 200

{
  "name": "production",
  "indexes": [
    "hotels"
  ]
}

Állapotkód:: 201

{
  "name": "production",
  "indexes": [
    "hotels"
  ]
}

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

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

Name	Típus	Description
@odata.etag	string	Az alias ETagje.
indexes	string[]	Annak az indexnek a neve, amelybe az alias megfelel. Csak egy indexnév adható meg.
name	string	Az alias neve.