Aliases - Delete

Service:
Search Service
Version d'API:
2025-11-01-preview

Supprime un alias de recherche et son mappage associé à un index. Cette opération est permanente, sans option de récupération. L’index mappé n’est pas touché par cette opération.

DELETE {endpoint}/aliases('{aliasName}')?api-version=2025-11-01-preview

Paramètres URI

Nom Dans Obligatoire Type Description
aliasName
 path True

string

Nom de l’alias.
endpoint
 path True

string (uri)

URL du point de terminaison du service de recherche.
api-version
 query True

string

minLength: 1

Version de l’API à utiliser pour cette opération.

En-tête de la demande

Nom Obligatoire Type Description
Accept

Accept

L’en-tête Accept.
If-Match

string

Définit la condition If-Match. L’opération ne sera effectuée que si l’ETag sur le serveur correspond à cette valeur.
If-None-Match

string

Définit la condition If-None-Match. L’opération ne sera effectuée que si l’ETag sur le serveur ne correspond pas à cette valeur.
x-ms-client-request-id

string (uuid)

Identificateur de chaîne opaque, globalement unique et généré par le client pour la requête.

Réponses

Nom Type Description
204 No Content

Il n’existe aucun contenu à envoyer pour cette demande, mais les en-têtes peuvent être utiles.
404 Not Found

Le serveur ne trouve pas la ressource demandée.
Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

api-key

Type: apiKey
Dans: header

OAuth2Auth

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Étendues

Nom Description
https://search.azure.com/.default

Exemples

SearchServiceDeleteAlias

Exemple de requête

DELETE https://previewexampleservice.search.windows.net/aliases('tempalias')?api-version=2025-11-01-preview

Exemple de réponse

Code d’état:
204
Code d’état:
404

Définitions

Nom Description
Accept

L’en-tête Accept.
ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail

Détail de l’erreur.
ErrorResponse

Réponse d’erreur courante pour toutes les API Azure Resource Manager afin de retourner les détails de l’erreur pour les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.).

Accept

Énumération

L’en-tête Accept.

Valeur Description
application/json;odata.metadata=minimal

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

Informations supplémentaires.
type

string

Type d’informations supplémentaire.

ErrorDetail

Objet

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.
code

string

Code d'erreur.
details

ErrorDetail[]

Détails de l’erreur.
message

string

Message d’erreur.
target

string

Cible d’erreur.

ErrorResponse

Objet

Réponse d’erreur courante pour toutes les API Azure Resource Manager afin de retourner les détails de l’erreur pour les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.).

Nom Type Description
error

ErrorDetail

Objet d’erreur.