¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Check Cloud Service Name Availability

Comprobar disponibilidad del nombre del servicio en la nube

Actualizado: junio de 2015

La operación Check Hosted Service Name Availability comprueba la disponibilidad del nombre del servicio en la nube especificado.

La solicitud Check Hosted Service Name Availability se puede especificar como sigue. Reemplace <subscription-id> con el identificador de la suscripción y <cloudservice-name> con el nombre del servicio en la nube que quiera utilizar.

 

Método URI de solicitud

GET

https://management.core.windows.net/<subscription-id>/services/hostedservices/operations/isavailable/<cloudservice-name>

Debe asegurarse de que la solicitud que se realice al servicio de administración sea segura. Para obtener detalles adicionales, vea Autenticar solicitudes de administración del servicio.

Ninguna.

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 utiliza para esta solicitud. Este encabezado debería establecerse en 01.03.12 o posterior. Para obtener más información acerca de los encabezados de control de versiones, vea Control de versiones de la administración del servicio.

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

Una operación correcta devuelve el código de estado 200 (Correcto). Para obtener información acerca de los códigos de estado, vea Estado y códigos de error de administración del servicio.

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.1.

 

Encabezado de respuesta Descripción

x-ms-request-id

Valor que identifica de forma exclusiva una solicitud realizada ante el servicio de administración.

El formato del cuerpo de respuesta es el siguiente:


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

En la tabla siguiente se describen los elementos del cuerpo de respuesta.

 

Nombre del elemento Descripción

Result

Valor booleano que indica si el nombre está disponible para que se utilice. true si el nombre está disponible; de lo contrario, false.

Para las versiones anteriores a 2013-03 - 01, la operación devuelve true para los nombres no tomados aunque estuvieran reservados o fueran inadecuados. Con encabezados de la versión 2013-03-01 y versiones posteriores, la operación devuelve false palabras reservadas o inadecuadas.

Reason

Indica por qué el nombre no puede utilizarse para crear el servicio en la nube.

Los valores posibles son:

  • HostedServiceAlreadyExists: se devuelve si ya existe el nombre del servicio de nube.

  • HostedServiceNameNotValid: se devuelve si el nombre del servicio de nube usa palabras soeces, palabras reservadas o caracteres no admitidos.

El elemento Reason solamente se encuentra disponible si utiliza la versión 01.03.13 o versiones posteriores.

Mostrar:
© 2015 Microsoft