Verificar disponibilidade do nome da conta de armazenamento

 

O Verificar disponibilidade de nome de conta de armazenamento operação verifica se o nome da conta de armazenamento especificado está disponível ou se ele já foi usado.

Solicitação

O Verificar disponibilidade de nome de conta de armazenamento solicitação pode ser especificada da seguinte maneira. Substitua <subscription-id> com sua ID de assinatura e <storage-account-name> com o nome do que você deseja usar para a conta de armazenamento.

Método	URI de solicitação
GET	https://management.core.windows.net/<subscription-id>/services/storageservices/operations/isavailable/<storage-account-name>

Você deve certificar-se de que a solicitação é feita ao serviço de gerenciamento seja segura. Para obter detalhes adicionais, consulte autenticar solicitações de gerenciamento de serviço.

Parâmetros de URI

Nenhum.

Cabeçalhos de solicitação

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

Cabeçalho da solicitação	Descrição
x-ms-version	Necessário. Especifica a versão da operação a ser usada para esta solicitação. Este cabeçalho deve ser definido como 2012-03-01 ou superior. Para obter mais informações sobre cabeçalhos de controle de versão, consulte o controle de versão do serviço de gerenciamento.

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). Para obter informações sobre códigos de status, consulte Status do gerenciamento de serviço e códigos de erro.

Cabeçalhos de resposta

A resposta para essa operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem a especificação do 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.

Corpo da resposta

O formato do corpo da resposta é o seguinte:

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

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

Nome do elemento	Descrição
Resultado	Especifica um valor booliano que indica se o nome está disponível para uso. Se true, o nome está disponível. Se false, o nome já foi usado e não pode ser usado.
Motivo	Especifica o motivo que não pôde ser usado um nome de conta de armazenamento. O valor será true se o nome pode ser usado. O motivo elemento só é retornado com a versão 2013-03-01 ou superior.