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


Vaults - Check Name Availability

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

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.KeyVault/checkNameAvailability?api-version=2024-11-01

Параметры URI

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

string

Учетные данные подписки, которые однозначно определяют подписку Microsoft Azure. Идентификатор подписки входит в состав URI для каждого вызова службы.

api-version
query True

string

Версия клиентского API.

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

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

string

Имя хранилища.

type True

Type

Тип ресурса Microsoft.KeyVault/vaults

Ответы

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

CheckNameAvailabilityResult

OK -- Операция по проверке доступности имени хранилища прошла успешно.

Other Status Codes

CloudError

Ответ на ошибку, описывающий причину сбоя операции.

Примеры

Validate a vault name

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

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.KeyVault/checkNameAvailability?api-version=2024-11-01

{
  "name": "sample-vault",
  "type": "Microsoft.KeyVault/vaults"
}

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

{
  "nameAvailable": true
}

Определения

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

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

CloudError

Ответ об ошибке от поставщика ресурсов Key Vault

CloudErrorBody

Ответ об ошибке от поставщика ресурсов Key Vault

Reason

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

Type

Тип ресурса Microsoft.KeyVault/vaults

VaultCheckNameAvailabilityParameters

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

CheckNameAvailabilityResult

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

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

string

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

nameAvailable

boolean

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

reason

Reason

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

CloudError

Ответ об ошибке от поставщика ресурсов Key Vault

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

CloudErrorBody

Ответ об ошибке от поставщика ресурсов Key Vault

CloudErrorBody

Ответ об ошибке от поставщика ресурсов Key Vault

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

string

Код ошибки. Это мнемосхема, которую можно использовать программно.

message

string

Понятное сообщение об ошибке. Сообщение обычно локализовано и может различаться в зависимости от версии службы.

Reason

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

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

Type

Тип ресурса Microsoft.KeyVault/vaults

Значение Описание
Microsoft.KeyVault/vaults

VaultCheckNameAvailabilityParameters

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

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

string

Имя хранилища.

type

Type

Тип ресурса Microsoft.KeyVault/vaults