Поделиться через


Storage Accounts - Check Name Availability

Проверяет, является ли имя учетной записи хранения действительным и еще не используется.

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

Параметры URI

Имя В Обязательно Тип Описание
subscriptionId
path True

string

minLength: 1

Идентификатор целевой подписки.

api-version
query True

string

minLength: 1

Версия API, используемая для данной операции.

Текст запроса

Имя Обязательно Тип Описание
name True

string

Имя учетной записи хранения.

type True

Type

Тип ресурса Microsoft.Storage/storageAccounts

Ответы

Имя Тип Описание
200 OK

CheckNameAvailabilityResult

OK — операция по проверке доступности имени учетной записи хранения выполнена успешно.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

StorageAccountCheckNameAvailability

Образец запроса

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

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

Пример ответа

{
  "nameAvailable": true
}

Определения

Имя Описание
CheckNameAvailabilityResult

Ответ операции CheckNameAvailability.

Reason

Получает причину, по которой не удалось использовать имя учетной записи хранения. Элемент Reason возвращается только в том случае, если NameAvailable имеет значение false.

StorageAccountCheckNameAvailabilityParameters

Параметры, используемые для проверки доступности имени учетной записи хранения.

Type

Тип ресурса Microsoft.Storage/storageAccounts

CheckNameAvailabilityResult

Ответ операции CheckNameAvailability.

Имя Тип Описание
message

string

Получает сообщение об ошибке с более подробным объяснением значения Reason.

nameAvailable

boolean

Получает логическое значение, указывающее, доступно ли имя для использования. Если true, то имя доступно. Если значение false, имя уже занято или является недействительным и не может быть использовано.

reason

Reason

Получает причину, по которой не удалось использовать имя учетной записи хранения. Элемент Reason возвращается только в том случае, если NameAvailable имеет значение false.

Reason

Получает причину, по которой не удалось использовать имя учетной записи хранения. Элемент Reason возвращается только в том случае, если NameAvailable имеет значение false.

Значение Описание
AccountNameInvalid
AlreadyExists

StorageAccountCheckNameAvailabilityParameters

Параметры, используемые для проверки доступности имени учетной записи хранения.

Имя Тип Описание
name

string

Имя учетной записи хранения.

type

Type

Тип ресурса Microsoft.Storage/storageAccounts

Type

Тип ресурса Microsoft.Storage/storageAccounts

Значение Описание
Microsoft.Storage/storageAccounts