Partager via


Vérifier la disponibilité des noms des comptes de stockage

 

Publication: mars 2016

Le Vérifier disponibilité du nom de compte de stockage opération vérifie si le nom de compte de stockage spécifié est disponible, ou s’il a déjà été utilisé.

Demande

Le disponibilité du nom de compte de stockage Vérifiez demande peut être spécifiée comme suit. Remplacez <subscription-id> par votre ID d’abonnement et <storage-account-name> avec le nom que vous souhaitez utiliser pour le compte de stockage.

(Méthode)

URI de la demande

GET

https://management.core.windows.net/<subscription-id>/services/storageservices/operations/isavailable/<storage-account-name>

Vous devez vous assurer que la demande est faite pour le service de gestion est sécurisée. Pour plus d'informations, consultez authentification des demandes de Service gestion.

Paramètres URI

Aucun.

En-têtes de requête

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

En-tête de demande

Description

x-ms-version

Requis. Spécifie la version de l'opération à utiliser pour cette demande. Cet en-tête doit être défini sur 2012-03-01 ou une version ultérieure. Pour plus d'informations sur les en-têtes de contrôle de version, consultez Service Management version.

Corps de la demande

Aucun.

Réponse

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 renvoie le code d'état 200 (OK). Pour plus d'informations sur les codes d'état, consultez état de gestion de Service et les Codes d'erreur.

En-têtes de réponse

La réponse pour cette opération inclut les en-têtes suivants. La réponse peut également inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standards se conforment à la spécification du protocole HTTP/1.1https://go.microsoft.com/fwlink/?linkid=150478.

En-tête de réponse

Description

x-ms-request-id

Une valeur qui identifie de façon unique une demande adressée au service de gestion.

Corps de réponse

Le format du corps de réponse est comme suit :

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

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

Nom de l'élément

Description

Résultat

Spécifie une valeur booléenne qui indique si le nom est disponible, vous pouvez utiliser. Si true, le nom est disponible. Si false, le nom a déjà été utilisé et ne peut pas être utilisé.

Raison

Spécifie la raison qu’un nom de compte de stockage ne peut pas servir. La valeur sera true Si le nom peut être utilisé.

Le raison élément est uniquement renvoyé avec la version 2013-03-01 ou une version ultérieure.