Aliases - Create Or Update

Reference

Služba:: Search Service

Verze rozhraní API:: 2023-10-01-Preview

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

PUT {endpoint}/aliases('{aliasName}')?api-version=2023-10-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	SearchError	Odpověď na chybu.

Příklady

SearchServiceCreateOrUpdateAlias

Ukázkový požadavek

HTTP

PUT https://myservice.search.windows.net/aliases('production')?api-version=2023-10-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
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.
SearchError	Popisuje chybový stav rozhraní API.

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.

SearchError

Popisuje chybový stav rozhraní API.

Name	Typ	Description
code	string	Jeden ze serverem definované sady kódů chyb.
details	SearchError[]	Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě.
message	string	Lidsky čitelná reprezentace chyby.

Sdílet prostřednictvím