Aliases - Create Or Update
Erstellt einen neuen Suchalias oder aktualisiert einen Alias, sofern er bereits vorhanden ist.
PUT {endpoint}/aliases('{aliasName}')?api-version=2024-05-01-preview
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
alias
|
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 Verfolgungs-ID, die mit der Anforderung gesendet wurde, um 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 Bedingung If-None-Match. 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 bei 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 | ||
201 Created | ||
Other Status Codes |
Fehlerantwort. |
Beispiele
SearchServiceCreateOrUpdateAlias
Beispielanforderung
PUT https://myservice.search.windows.net/aliases('production')?api-version=2024-05-01-preview
{
"name": "production",
"indexes": [
"hotels"
]
}
Beispiel für eine Antwort
{
"name": "production",
"indexes": [
"hotels"
]
}
{
"name": "production",
"indexes": [
"hotels"
]
}
Definitionen
Name | Beschreibung |
---|---|
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
Error |
Die Fehlerdetails. |
Error |
Fehlerantwort |
Search |
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 |
Die zusätzlichen Fehlerinformationen. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
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. |