Exportar (0) Imprimir
Expandir todo

Comprobar disponibilidad del nombre del servicio en la nube

Actualizado: abril de 2014

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 Versión de HTTP

GET

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

HTTP/1.1

Ninguno.

La tabla siguiente describe los encabezados de solicitud.

 

Encabezado de solicitud Descripción

x-ms-version

Obligatorio. Especifica la versión de la operación que se utiliza para esta solicitud. Este encabezado debe establecerse en 2012-03-01 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>

La tabla siguiente describe los elementos clave en el cuerpo de la respuesta:

 

Nombre del elemento Descripción

Resultado

Valor booleano que indica si el nombre está disponible para que se utilice. True si el nombre está disponible; si no 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

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

El elemento Reason solamente se encuentra disponible si utiliza la versión 2013-03-01 o versiones posteriores.

Cualquier certificado de administración asociado a la suscripción especificada por <subscription-id> se puede usar para autenticar esta operación. Para obtener detalles adicionales, vea Autenticar solicitudes de administración del servicio.

Ninguno.

Mostrar:
© 2014 Microsoft