Verificar a Disponibilidade do Nome do Serviço Cloud

Artigo
07/19/2023

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.

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.