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. |