Partilhar via


Verificar a Disponibilidade do Nome do Serviço Cloud

A Check Hosted Service Name Availability operação verifica a disponibilidade do nome do serviço cloud especificado.

Pedir

O Check Hosted Service Name Availability pedido pode ser especificado da seguinte forma. Substitua <subscription-id> pelo seu ID de subscrição e <cloudservice-name> pelo nome do serviço cloud que pretende utilizar.

Método URI do pedido
GET https://management.core.windows.net/<subscription-id>/services/hostedservices/operations/isavailable/<cloudservice-name>

Parâmetros do URI

Nenhum.

Cabeçalhos do Pedido

A tabela seguinte descreve os cabeçalhos do pedido.

Cabeçalho do Pedido Description
x-ms-version Obrigatório. Especifica a versão da operação a utilizar para este pedido. Este cabeçalho deve ser definido como 2012-03-01 ou superior.

Corpo do Pedido

Nenhum.

Resposta

A resposta inclui um código de estado HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Código de Estado

Uma operação bem-sucedida devolve o código de estado 200 (OK).

Cabeçalhos de Resposta

A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão adicionais.

Cabeçalho de Resposta Description
x-ms-request-id Um valor que identifica exclusivamente um pedido feito no serviço de gestão.

Corpo da Resposta

O formato do corpo de resposta é o seguinte:

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

A tabela seguinte descreve os elementos no corpo da resposta.

Nome do elemento Descrição
Resultado Um valor booleano que indica se o nome está disponível para utilização. true se o nome estiver disponível; caso contrário false, .

Para versões anteriores a 2013-03-01, a operação foi devolvida true para nomes não utilizados, mesmo que fossem reservados ou profanos. Com os cabeçalhos de versão de 2013-03-01 e posterior, a operação devolve false palavras reservadas ou profanas.
Razão Indica o motivo pelo qual o nome não pode ser utilizado para criar o serviço cloud.

Os valores possíveis são:

- HostedServiceAlreadyExists – devolvido se o nome do serviço cloud já existir.
- HostedServiceNameNotValid – devolvido se o nome do serviço cloud utilizar carateres não suportados, palavras reservadas ou palavras profanas.

O Reason elemento só está disponível com a versão 2013-03-01 ou superior.