Compartilhar via


Storage Accounts - Check Name Availability

Verifica se o nome da conta de armazenamento é válido e ainda não está em uso.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Storage/checkNameAvailability?api-version=2023-05-01

Parâmetros do URI

Name Em Necessário Tipo Description
subscriptionId
path True

string

A ID da assinatura de destino.

api-version
query True

string

A versão da API a ser usada para esta operação.

Corpo do Pedido

Name Necessário Tipo Description
name True

string

O nome da conta de armazenamento.

type True

Type

O tipo de recurso, Microsoft.Storage/storageAccounts

Respostas

Name Tipo Description
200 OK

CheckNameAvailabilityResult

OK -- A operação para verificar a disponibilidade do nome da conta de armazenamento foi bem-sucedida.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

StorageAccountCheckNameAvailability

Pedido de amostra

POST https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Storage/checkNameAvailability?api-version=2023-05-01

{
  "name": "sto3363",
  "type": "Microsoft.Storage/storageAccounts"
}

Resposta da amostra

{
  "nameAvailable": true
}

Definições

Name Description
CheckNameAvailabilityResult

A resposta da operação CheckNameAvailability.

Reason

Obtém o motivo pelo qual um nome de conta de armazenamento não pôde ser usado. O elemento Reason só será retornado se NameAvailable for false.

StorageAccountCheckNameAvailabilityParameters

Os parâmetros usados para verificar a disponibilidade do nome da conta de armazenamento.

Type

O tipo de recurso, Microsoft.Storage/storageAccounts

CheckNameAvailabilityResult

A resposta da operação CheckNameAvailability.

Name Tipo Description
message

string

Obtém uma mensagem de erro explicando o valor Reason com mais detalhes.

nameAvailable

boolean

Obtém um valor booleano que indica se o nome está disponível para uso. Se verdadeiro, o nome está disponível. Se falso, o nome já foi retirado ou é inválido e não pode ser usado.

reason

Reason

Obtém o motivo pelo qual um nome de conta de armazenamento não pôde ser usado. O elemento Reason só será retornado se NameAvailable for false.

Reason

Obtém o motivo pelo qual um nome de conta de armazenamento não pôde ser usado. O elemento Reason só será retornado se NameAvailable for false.

Name Tipo Description
AccountNameInvalid

string

AlreadyExists

string

StorageAccountCheckNameAvailabilityParameters

Os parâmetros usados para verificar a disponibilidade do nome da conta de armazenamento.

Name Tipo Description
name

string

O nome da conta de armazenamento.

type

Type

O tipo de recurso, Microsoft.Storage/storageAccounts

Type

O tipo de recurso, Microsoft.Storage/storageAccounts

Name Tipo Description
Microsoft.Storage/storageAccounts

string