Freigeben über


Aliases - Create Or Update

Erstellt einen neuen Suchalias oder aktualisiert einen Alias, falls er bereits vorhanden ist.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
aliasName
path True

string

Die Definition des zu erstellenden oder zu aktualisierenden Alias.

endpoint
path True

string

Die Endpunkt-URL des Suchdiensts.

api-version
query True

string

Client-API-Version.

Anforderungsheader

Name Erforderlich Typ Beschreibung
x-ms-client-request-id

string

uuid

Die Tracking-ID, die mit der Anforderung gesendet wurde, beim Debuggen zu helfen.

If-Match

string

Definiert die If-Match Bedingung. Der Vorgang wird nur ausgeführt, wenn das ETag auf dem Server mit diesem Wert übereinstimmt.

If-None-Match

string

Definiert die If-None-Match-Bedingung. Der Vorgang wird nur ausgeführt, wenn das ETag auf dem Server nicht mit diesem Wert übereinstimmt.

Prefer True

string

Weist den Dienst bei HTTP PUT-Anforderungen an, die erstellte/aktualisierte Ressource nach Erfolg zurückzugeben.

Anforderungstext

Name Erforderlich Typ Beschreibung
indexes True

string[]

Der Name des Indexes, dem dieser Alias zugeordnet ist. Es kann nur ein Indexname angegeben werden.

name True

string

Der Name des Alias.

@odata.etag

string

Das ETag des Alias.

Antworten

Name Typ Beschreibung
200 OK

SearchAlias

201 Created

SearchAlias

Other Status Codes

ErrorResponse

Fehlerantwort.

Beispiele

SearchServiceCreateOrUpdateAlias

Beispielanforderung

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


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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

SearchAlias

Stellt einen Indexalias dar, der eine Zuordnung vom Aliasnamen zu einem Index beschreibt. Der Aliasname kann anstelle des Indexnamens für unterstützte Vorgänge verwendet werden.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

SearchAlias

Stellt einen Indexalias dar, der eine Zuordnung vom Aliasnamen zu einem Index beschreibt. Der Aliasname kann anstelle des Indexnamens für unterstützte Vorgänge verwendet werden.

Name Typ Beschreibung
@odata.etag

string

Das ETag des Alias.

indexes

string[]

Der Name des Indexes, dem dieser Alias zugeordnet ist. Es kann nur ein Indexname angegeben werden.

name

string

Der Name des Alias.