Comprobar disponibilidad de nombre de cuenta de almacenamiento

 

Publicada: marzo de 2016

El comprobar la disponibilidad de nombre de la cuenta de almacenamiento operación comprueba si el nombre de la cuenta de almacenamiento especificado está disponible, o si ya ha tomado.

Solicitud

El comprobar la disponibilidad de nombre de la cuenta de almacenamiento solicitud se puede especificar como sigue. Reemplace <subscription-id> con el identificador de suscripción y <storage-account-name> con el nombre que desea utilizar para la cuenta de almacenamiento.

(Método)	URI de solicitud
GET	https://management.core.windows.net/<subscription-id>/services/storageservices/operations/isavailable/<storage-account-name>

Debe asegurarse de que la solicitud que se realiza en el servicio de administración es segura. Para obtener más información, consulte autenticar solicitudes de administración de servicio.

Parámetros de URI

Ninguno.

Encabezados de solicitud

La tabla siguiente describe los encabezados de solicitud.

Encabezado de solicitud	Descripción
x-ms-version	Requerido. Especifica la versión de la operación que se utilizará para esta solicitud. Este encabezado debe establecerse en 2012-03-01 o superior. Para obtener más información acerca de los encabezados de control de versiones, consulte versiones del servicio de administración de.

Cuerpo de la solicitud

Ninguno.

Respuesta

La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.

Código de estado

Una operación correcta devuelve el código de estado 200 (OK). Para obtener información acerca de los códigos de estado, consulte estado de administración del servicio y los códigos de Error.

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar cumplen la especificación del protocolo HTTP/1.1https://go.microsoft.com/fwlink/?linkid=150478.

Encabezado de respuesta	Descripción
x-ms-request-id	Un valor que identifica de forma única una solicitud realizada en el servicio de administración.

Cuerpo de respuesta

El formato del cuerpo de respuesta es el siguiente:

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

La tabla siguiente describen los elementos en el cuerpo de respuesta.

Nombre del elemento	Descripción
Resultado	Especifica un valor booleano que indica si el nombre está disponible para su uso. Si true, el nombre está disponible. Si false, el nombre ya está en uso y no se puede usar.
Motivo	Especifica el motivo de que no se pudo usar un nombre de cuenta de almacenamiento. El valor será true Si se puede utilizar el nombre. El razón elemento solamente se devuelve con la versión 2013-03-01 o posterior.