Comprobar disponibilidad del nombre del servicio en la nube

Artículo
07/19/2023

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

Request

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>`

Parámetros de identificador URI

Ninguno.

Encabezados de solicitud

La tabla siguiente describe los encabezados de solicitud.

Encabezado de solicitud	Descripción
`x-ms-version`	Necesario. Especifica la versión de la operación que se utiliza para esta solicitud. Este encabezado debe establecerse `2012-03-01` en o superior.

Cuerpo de la solicitud

Ninguno.

Response

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

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar.

Encabezado de respuesta	Descripción
`x-ms-request-id`	Valor que identifica de forma exclusiva una solicitud realizada ante el servicio de administración.

Cuerpo de la respuesta

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

Resultado Valor booleano que indica si el nombre está disponible para su uso. 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.

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

Los valores posibles son:

- HostedServiceAlreadyExists : se devuelve si el nombre del servicio en la nube ya existe.
- HostedServiceNameNotValid : se devuelve si el nombre del servicio en la nube usa caracteres no admitidos, palabras reservadas o palabras soeces.

El Reason elemento solo está disponible con la versión 2013-03-01 o posterior.

Nombre del elemento	Descripción
Resultado	Valor booleano que indica si el nombre está disponible para su uso. `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.
Motivo	Indica por qué el nombre no puede utilizarse para crear el servicio en la nube. Los valores posibles son: - `HostedServiceAlreadyExists` : se devuelve si el nombre del servicio en la nube ya existe. - `HostedServiceNameNotValid` : se devuelve si el nombre del servicio en la nube usa caracteres no admitidos, palabras reservadas o palabras soeces. El `Reason` elemento solo está disponible con la versión 2013-03-01 o posterior.