Vérification de la disponibilité des noms de services cloud

Article
08/05/2023

L'opération Check Hosted Service Name Availability vérifie la disponibilité du nom du service cloud spécifié.

Requête

La demande Check Hosted Service Name Availability peut être spécifiée comme suit. Remplacez <subscription-id> par votre ID d'abonnement et <cloudservice-name> par le nom du service cloud que vous souhaitez utiliser.

Méthode	URI de demande
GET	`https://management.core.windows.net/<subscription-id>/services/hostedservices/operations/isavailable/<cloudservice-name>`

Paramètres URI

Aucun.

En-têtes de requête

Le tableau suivant décrit les en-têtes de la demande.

En-tête de requête	Description
`x-ms-version`	Obligatoire. Spécifie la version de l'opération à utiliser pour cette demande. Cet en-tête doit avoir la valeur `2012-03-01` ou une valeur supérieure.

Corps de la requête

Aucun.

response

La réponse inclut un code d'état HTTP, un ensemble d'en-têtes de réponse et un corps de réponse.

Code d’état

Une opération réussie envoie le code d'état 200 (OK).

En-têtes de réponse

La réponse de l'opération inclut les en-têtes suivants. La réponse peut aussi inclure des en-têtes HTTP standard supplémentaires.

En-tête de réponse	Description
`x-ms-request-id`	Valeur qui identifie de façon unique une demande effectuée au service de gestion.

Corps de la réponse

Le corps de la réponse présente le format suivant :

  
<?xml version="1.0" encoding="utf-8"?>  
<AvailabilityResponse xmlns=”http://schemas.microsoft.com/windowsazure”>  
  <Result>name-availability</Result>  
  <Reason>reason</Reason>  
</AvailabilityResponse>

Le tableau suivant décrit les éléments dans le corps de la réponse.

Nom de l'élément Description

Résultat Valeur booléenne qui indique si le nom est disponible pour vous. true si le nom est disponible ; sinon false.

Pour les versions antérieures à 2013-03 01, l'opération retourne true pour les noms disponibles, même s'ils sont réservés ou profanes. Avec les en-têtes de la version 2013-03-01 et des versions ultérieures, l'opération renvoie false pour les mots réservés ou profanes.

Motif Indique pourquoi le nom ne peut pas être utilisé pour créer le service cloud.

Les valeurs possibles sont les suivantes :

- HostedServiceAlreadyExists : retourné si le nom du service cloud existe déjà.
- HostedServiceNameNotValid : retourné si le nom du service cloud utilise des caractères non pris en charge, des mots réservés ou des mots grossissables.

L’élément Reason est disponible uniquement à l’aide de la version 2013-03-01 ou ultérieure.

Nom de l'élément	Description
Résultat	Valeur booléenne qui indique si le nom est disponible pour vous. `true` si le nom est disponible ; sinon `false`. Pour les versions antérieures à 2013-03 01, l'opération retourne `true` pour les noms disponibles, même s'ils sont réservés ou profanes. Avec les en-têtes de la version 2013-03-01 et des versions ultérieures, l'opération renvoie `false` pour les mots réservés ou profanes.
Motif	Indique pourquoi le nom ne peut pas être utilisé pour créer le service cloud. Les valeurs possibles sont les suivantes : - `HostedServiceAlreadyExists` : retourné si le nom du service cloud existe déjà. - `HostedServiceNameNotValid` : retourné si le nom du service cloud utilise des caractères non pris en charge, des mots réservés ou des mots grossissables. L’élément `Reason` est disponible uniquement à l’aide de la version 2013-03-01 ou ultérieure.

Partager via