Esta página foi útil?
Seus comentários sobre este conteúdo são importantes. Queremos saber sua opinião.
Comentários adicionais?
1500 caracteres restantes
Biblioteca MSDN

Verificar disponibilidade do nome do serviço de nuvem

Atualizado: junho de 2015

A operação Check Hosted Service Name Availability verifica se há disponibilidade do nome do serviço de nuvem especificado.

A solicitação Check Hosted Service Name Availability pode ser especificada da seguinte maneira. Substitua <subscription-id> por sua ID da assinatura e <cloudservice-name> pelo nome do serviço de nuvem que você gostaria de usar.

 

Método URI de solicitação

GET

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

Verifique se a solicitação feita ao serviço de gerenciamento é segura. Para obter mais detalhes, consulte Autenticando solicitações do gerenciamento de serviços.

Nenhuma.

A tabela a seguir descreve os cabeçalhos da solicitação.

 

Cabeçalho de solicitação Descrição

x-ms-version

Obrigatória. Especifica a versão da operação a ser usada para esta solicitação. Este cabeçalho deve ser definido como 01.03.12 ou posterior. Para obter mais informações sobre cabeçalhos de controle de versão, consulte Controle de versão de gerenciamento de serviço.

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

Uma operação bem-sucedida retorna o código de status 200 (OK). Para obter informações sobre códigos de status, consulte Status de Gerenciamento de Serviço e códigos de erro.

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem à especificação de protocolo HTTP/1.1.

 

Cabeçalho de resposta Descrição

x-ms-request-id

Um valor que identifica exclusivamente uma solicitação feita no serviço de gerenciamento.

Formato do corpo da resposta:


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

A tabela a seguir descreve os elementos no corpo da resposta.

 

Nome do elemento Descrição

Resultado

Um valor booliano que indica se o nome está disponível para uso. true se o nome estiver disponível; caso contrário, false.

Para versões anteriores a 2013-03-01, a operação retornava true para nomes não utilizados mesmo se estivessem reservados ou se fossem profanos. Com os cabeçalhos da versão de 2013-03-01 e posterior, a operação retorna false para palavras reservadas ou profanas.

Motivo

Indica por que o nome não pode ser usado para criar o serviço de nuvem.

Os possíveis valores são:

  • HostedServiceAlreadyExists – retornado se o nome do serviço de nuvem já existir.

  • HostedServiceNameNotValid – retornado se o nome do serviço de nuvem usar caracteres sem suporte, palavras reservadas ou palavras impróprias.

O elemento Reason só estará disponível com a versão 01.03.13 ou superior.

Mostrar:
© 2015 Microsoft