Aliases - Create Or Update

Referens

Tjänst:: Search Service

API-version:: 2024-09-01-preview

Skapar ett nytt sökalias eller uppdaterar ett alias om det redan finns.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
aliasName	path	True	string	Definitionen av aliaset som ska skapas eller uppdateras.
endpoint	path	True	string	Slutpunkts-URL:en för söktjänsten.
api-version	query	True	string	Klient-API-version.

Begärandehuvud

Name	Obligatorisk	Typ	Description
x-ms-client-request-id		string uuid	Spårnings-ID:t som skickas med begäran för att hjälpa till med felsökning.
If-Match		string	Definierar villkoret If-Match. Åtgärden utförs endast om ETag på servern matchar det här värdet.
If-None-Match		string	Definierar villkoret If-None-Match. Åtgärden utförs endast om ETag på servern inte matchar det här värdet.
Prefer	True	string	För HTTP PUT-begäranden instruerar du tjänsten att returnera den skapade/uppdaterade resursen när den lyckas.

Begärandetext

Name	Obligatorisk	Typ	Description
indexes	True	string[]	Namnet på det index som aliaset mappar till. Endast ett indexnamn kan anges.
name	True	string	Namnet på aliaset.
@odata.etag		string	Aliasets ETag.

Svar

Name	Typ	Description
200 OK	SearchAlias
201 Created	SearchAlias
Other Status Codes	ErrorResponse	Felsvar.

Exempel

SearchServiceCreateOrUpdateAlias

Exempelbegäran

HTTP

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





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

Exempelsvar

Statuskod:: 200

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

Statuskod:: 201

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

Definitioner

Name	Description
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
SearchAlias	Representerar ett indexalias som beskriver en mappning från aliasnamnet till ett index. Aliasnamnet kan användas i stället för indexnamnet för åtgärder som stöds.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

SearchAlias

Representerar ett indexalias som beskriver en mappning från aliasnamnet till ett index. Aliasnamnet kan användas i stället för indexnamnet för åtgärder som stöds.

Name	Typ	Description
@odata.etag	string	Aliasets ETag.
indexes	string[]	Namnet på det index som aliaset mappar till. Endast ett indexnamn kan anges.
name	string	Namnet på aliaset.

Dela via