Verificar disponibilidade do nome do serviço de nuvem

Artigo
07/19/2023

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

Solicitação

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 da solicitação
GET	`https://management.core.windows.net/<subscription-id>/services/hostedservices/operations/isavailable/<cloudservice-name>`

Parâmetros de URI

Nenhum.

Cabeçalhos de solicitação

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

Cabeçalho da solicitação	Descrição
`x-ms-version`	Obrigatórios. Especifica a versão da operação a ser usada para esta solicitação. Esse cabeçalho deve ser definido como `2012-03-01` ou superior.

Corpo da solicitação

Nenhum.

Resposta

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

Código de status

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

Cabeçalhos de resposta

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

Cabeçalho de Resposta	Descrição
`x-ms-request-id`	Um valor que identifica exclusivamente uma solicitação feita no serviço de gerenciamento.

Corpo da resposta

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 valores possíveis 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 profanas.

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

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 valores possíveis 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 profanas. O `Reason` elemento só está disponível usando a versão 2013-03-01 ou superior.

Compartilhar via