Aliases - Create Or Update

Reference

Služba:: Search Service

Verze rozhraní API:: 2024-05-01-preview

Vytvoří nový alias vyhledávání nebo aktualizuje alias, pokud už existuje.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
aliasName	path	True	string	Definice aliasu, který chcete vytvořit nebo aktualizovat.
endpoint	path	True	string	Adresa URL koncového bodu vyhledávací služby.
api-version	query	True	string	Verze rozhraní API klienta.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
x-ms-client-request-id		string uuid	ID sledování odeslané spolu s požadavkem na pomoc s laděním.
If-Match		string	Definuje podmínku If-Match. Operace se provede pouze v případě, že značka ETag na serveru odpovídá této hodnotě.
If-None-Match		string	Definuje podmínku If-None-Match. Operace se provede pouze v případě, že značka ETag na serveru neodpovídá této hodnotě.
Prefer	True	string	V případě požadavků HTTP PUT dává službě pokyn, aby v případě úspěchu vrátila vytvořený nebo aktualizovaný prostředek.

Text požadavku

Name	Vyžadováno	Typ	Description
indexes	True	string[]	Název indexu, na který se tento alias mapuje. Může být zadán pouze jeden název indexu.
name	True	string	Název aliasu.
@odata.etag		string	Značka ETag aliasu.

Odpovědi

Name	Typ	Description
200 OK	SearchAlias
201 Created	SearchAlias
Other Status Codes	ErrorResponse	Odpověď na chybu.

Příklady

SearchServiceCreateOrUpdateAlias

Ukázkový požadavek

HTTP

PUT https://myservice.search.windows.net/aliases('production')?api-version=2024-05-01-preview


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

Ukázková odpověď

Stavový kód:: 200

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

Stavový kód:: 201

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

Definice

Name	Description
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Odpověď na chybu
SearchAlias	Představuje alias indexu, který popisuje mapování z názvu aliasu na index. Název aliasu se dá použít místo názvu indexu pro podporované operace.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě
code	string	Kód chyby
details	ErrorDetail[]	Podrobnosti o chybě
message	string	Chybová zpráva
target	string	Cíl chyby.

ErrorResponse

Odpověď na chybu

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

SearchAlias

Představuje alias indexu, který popisuje mapování z názvu aliasu na index. Název aliasu se dá použít místo názvu indexu pro podporované operace.

Name	Typ	Description
@odata.etag	string	Značka ETag aliasu.
indexes	string[]	Název indexu, na který se tento alias mapuje. Může být zadán pouze jeden název indexu.
name	string	Název aliasu.

Sdílet prostřednictvím