Vaults - Get
Получает указанное хранилище ключей Azure.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}?api-version=2024-11-01
Параметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
resource
|
path | True |
string |
Имя группы ресурсов, к которой принадлежит хранилище. |
|
subscription
|
path | True |
string |
Учетные данные подписки, которые однозначно определяют подписку Microsoft Azure. Идентификатор подписки входит в состав URI для каждого вызова службы. |
|
vault
|
path | True |
string |
Название хранилища. |
|
api-version
|
query | True |
string |
Версия клиентского API. |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 OK |
Извлеченный сейф |
|
| Other Status Codes |
Ответ на ошибку, описывающий причину сбоя операции. |
Примеры
Retrieve a vault
Образец запроса
Пример ответа
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-resource-group/providers/Microsoft.KeyVault/vaults/sample-vault",
"name": "sample-vault",
"type": "Microsoft.KeyVault/vaults",
"location": "westus",
"tags": {},
"systemData": {
"createdBy": "keyVaultUser1",
"createdByType": "User",
"createdAt": "2020-01-01T12:00:00.0000000Z",
"lastModifiedBy": "keyVaultUser2",
"lastModifiedByType": "User",
"lastModifiedAt": "2020-01-01T12:00:00.0000000Z"
},
"properties": {
"sku": {
"family": "A",
"name": "standard"
},
"tenantId": "00000000-0000-0000-0000-000000000000",
"accessPolicies": [
{
"tenantId": "00000000-0000-0000-0000-000000000000",
"objectId": "00000000-0000-0000-0000-000000000000",
"permissions": {
"keys": [
"encrypt",
"decrypt",
"wrapKey",
"unwrapKey",
"sign",
"verify",
"get",
"list",
"create",
"update",
"import",
"delete",
"backup",
"restore",
"recover",
"purge"
],
"secrets": [
"get",
"list",
"set",
"delete",
"backup",
"restore",
"recover",
"purge"
],
"certificates": [
"get",
"list",
"delete",
"create",
"import",
"update",
"managecontacts",
"getissuers",
"listissuers",
"setissuers",
"deleteissuers",
"manageissuers",
"recover",
"purge"
]
}
}
],
"enabledForDeployment": true,
"enabledForDiskEncryption": true,
"enabledForTemplateDeployment": true,
"hsmPoolResourceId": "00000000-0000-0000-0000-000000000000",
"vaultUri": "https://sample-vault.vault.azure.net",
"provisioningState": "Succeeded",
"publicNetworkAccess": "Enabled"
}
}
Определения
| Имя | Описание |
|---|---|
|
Access |
Удостоверение, имеющее доступ к хранилищу ключей. Все удостоверения в массиве должны использовать тот же идентификатор клиента, что и идентификатор клиента хранилища ключей. |
|
Actions |
Сообщение, указывающее, требуются ли изменения в поставщике услуг, требуются какие-либо обновления для потребителя. |
|
Certificate |
Разрешения на сертификаты |
|
Cloud |
Ответ об ошибке от поставщика ресурсов Key Vault |
|
Cloud |
Ответ об ошибке от поставщика ресурсов Key Vault |
|
Create |
Режим создания хранилища, указывающий, требуется ли восстановить хранилище. |
|
identity |
Тип удостоверения, создавшего ресурс хранилища ключей. |
| IPRule |
Правило, регулирующее доступность хранилища с определенного IP-адреса или диапазона IP-адресов. |
|
Key |
Разрешения на ключи |
|
Network |
Действие по умолчанию, если правило из ipRules и из virtualNetworkRules не совпадает. Это используется только после оценки свойства обхода. |
|
Network |
Указывает, какой трафик может обойти правила сети. Это может быть "AzureServices" или "Нет". Если значение по умолчанию не задано, — AzureServices. |
|
Network |
Набор правил, регулирующих сетевой доступ хранилища. |
| Permissions |
Разрешения, которые удостоверение имеет для ключей, секретов, сертификатов и хранилища. |
|
Private |
Свойства объекта частной конечной точки. |
|
Private |
Элемент подключения к частной конечной точке. |
|
Private |
Текущее состояние подготовки. |
|
Private |
Состояние подключения к частной конечной точке. |
|
Private |
Объект, представляющий состояние утверждения подключения к приватному каналу. |
|
Secret |
Разрешения на секреты |
| Sku |
Сведения о номере SKU |
|
Sku |
Имя семейства SKU |
|
Sku |
Имя SKU, указывающее, является ли хранилище ключей стандартным хранилищем или хранилищем класса Premium. |
|
Storage |
Разрешения для учетных записей хранения |
|
System |
Метаданные, относящиеся к созданию и последнему изменению ресурса хранилища ключей. |
| Vault |
Информация о ресурсах с расширенными сведениями. |
|
Vault |
Свойства хранилища |
|
Vault |
Состояние подготовки хранилища. |
|
Virtual |
Правило, регулирующее доступность хранилища из определенной виртуальной сети. |
AccessPolicyEntry
Удостоверение, имеющее доступ к хранилищу ключей. Все удостоверения в массиве должны использовать тот же идентификатор клиента, что и идентификатор клиента хранилища ключей.
| Имя | Тип | Описание |
|---|---|---|
| applicationId |
string (uuid) |
Идентификатор приложения клиента, выполняющего запрос от имени субъекта |
| objectId |
string |
Идентификатор объекта пользователя, субъекта-службы или группы безопасности в клиенте Azure Active Directory для хранилища. Идентификатор объекта должен быть уникальным для списка политик доступа. |
| permissions |
Разрешения удостоверения имеются для ключей, секретов и сертификатов. |
|
| tenantId |
string (uuid) |
Идентификатор клиента Azure Active Directory, который следует использовать для проверки подлинности запросов к хранилищу ключей. |
ActionsRequired
Сообщение, указывающее, требуются ли изменения в поставщике услуг, требуются какие-либо обновления для потребителя.
| Значение | Описание |
|---|---|
| None |
CertificatePermissions
Разрешения на сертификаты
| Значение | Описание |
|---|---|
| all | |
| get | |
| list | |
| delete | |
| create | |
| import | |
| update | |
| managecontacts | |
| getissuers | |
| listissuers | |
| setissuers | |
| deleteissuers | |
| manageissuers | |
| recover | |
| purge | |
| backup | |
| restore |
CloudError
Ответ об ошибке от поставщика ресурсов Key Vault
| Имя | Тип | Описание |
|---|---|---|
| error |
Ответ об ошибке от поставщика ресурсов Key Vault |
CloudErrorBody
Ответ об ошибке от поставщика ресурсов Key Vault
| Имя | Тип | Описание |
|---|---|---|
| code |
string |
Код ошибки. Это мнемосхема, которую можно использовать программно. |
| message |
string |
Понятное сообщение об ошибке. Сообщение обычно локализовано и может различаться в зависимости от версии службы. |
CreateMode
Режим создания хранилища, указывающий, требуется ли восстановить хранилище.
| Значение | Описание |
|---|---|
| recover | |
| default |
identityType
Тип удостоверения, создавшего ресурс хранилища ключей.
| Значение | Описание |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
IPRule
Правило, регулирующее доступность хранилища с определенного IP-адреса или диапазона IP-адресов.
| Имя | Тип | Описание |
|---|---|---|
| value |
string |
Диапазон адресов IPv4 в нотации CIDR, например "124.56.78.91" (простой IP-адрес) или "124.56.78.0/24" (все адреса, начинающиеся с 124.56.78). |
KeyPermissions
Разрешения на ключи
| Значение | Описание |
|---|---|
| all | |
| encrypt | |
| decrypt | |
| wrapKey | |
| unwrapKey | |
| sign | |
| verify | |
| get | |
| list | |
| create | |
| update | |
| import | |
| delete | |
| backup | |
| restore | |
| recover | |
| purge | |
| release | |
| rotate | |
| getrotationpolicy | |
| setrotationpolicy |
NetworkRuleAction
Действие по умолчанию, если правило из ipRules и из virtualNetworkRules не совпадает. Это используется только после оценки свойства обхода.
| Значение | Описание |
|---|---|
| Allow | |
| Deny |
NetworkRuleBypassOptions
Указывает, какой трафик может обойти правила сети. Это может быть "AzureServices" или "Нет". Если значение по умолчанию не задано, — AzureServices.
| Значение | Описание |
|---|---|
| AzureServices | |
| None |
NetworkRuleSet
Набор правил, регулирующих сетевой доступ хранилища.
| Имя | Тип | Описание |
|---|---|---|
| bypass |
Указывает, какой трафик может обойти правила сети. Это может быть "AzureServices" или "Нет". Если значение по умолчанию не задано, — AzureServices. |
|
| defaultAction |
Действие по умолчанию, если правило из ipRules и из virtualNetworkRules не совпадает. Это используется только после оценки свойства обхода. |
|
| ipRules |
IPRule[] |
Список правил IP-адресов. |
| virtualNetworkRules |
Список правил виртуальной сети. |
Permissions
Разрешения, которые удостоверение имеет для ключей, секретов, сертификатов и хранилища.
| Имя | Тип | Описание |
|---|---|---|
| certificates |
Разрешения на сертификаты |
|
| keys |
Разрешения на ключи |
|
| secrets |
Разрешения на секреты |
|
| storage |
Разрешения для учетных записей хранения |
PrivateEndpoint
Свойства объекта частной конечной точки.
| Имя | Тип | Описание |
|---|---|---|
| id |
string |
Полный идентификатор ресурса частной конечной точки. |
PrivateEndpointConnectionItem
Элемент подключения к частной конечной точке.
| Имя | Тип | Описание |
|---|---|---|
| etag |
string |
Изменяется всякий раз при изменении состояния подключения к частной конечной точке. |
| id |
string |
Идентификатор подключения к частной конечной точке. |
| properties.privateEndpoint |
Свойства объекта частной конечной точки. |
|
| properties.privateLinkServiceConnectionState |
Состояние утверждения подключения приватного канала. |
|
| properties.provisioningState |
Состояние подготовки подключения к частной конечной точке. |
PrivateEndpointConnectionProvisioningState
Текущее состояние подготовки.
| Значение | Описание |
|---|---|
| Succeeded | |
| Creating | |
| Updating | |
| Deleting | |
| Failed | |
| Disconnected |
PrivateEndpointServiceConnectionStatus
Состояние подключения к частной конечной точке.
| Значение | Описание |
|---|---|
| Pending | |
| Approved | |
| Rejected | |
| Disconnected |
PrivateLinkServiceConnectionState
Объект, представляющий состояние утверждения подключения к приватному каналу.
| Имя | Тип | Описание |
|---|---|---|
| actionsRequired |
Сообщение, указывающее, требуются ли изменения в поставщике услуг, требуются какие-либо обновления для потребителя. |
|
| description |
string |
Причина утверждения или отклонения. |
| status |
Указывает, утверждено ли подключение, отклонено или удалено владельцем хранилища ключей. |
SecretPermissions
Разрешения на секреты
| Значение | Описание |
|---|---|
| all | |
| get | |
| list | |
| set | |
| delete | |
| backup | |
| restore | |
| recover | |
| purge |
Sku
Сведения о номере SKU
| Имя | Тип | Описание |
|---|---|---|
| family |
Имя семейства SKU |
|
| name |
Имя SKU, указывающее, является ли хранилище ключей стандартным хранилищем или хранилищем класса Premium. |
SkuFamily
Имя семейства SKU
| Значение | Описание |
|---|---|
| A |
SkuName
Имя SKU, указывающее, является ли хранилище ключей стандартным хранилищем или хранилищем класса Premium.
| Значение | Описание |
|---|---|
| standard | |
| premium |
StoragePermissions
Разрешения для учетных записей хранения
| Значение | Описание |
|---|---|
| all | |
| get | |
| list | |
| delete | |
| set | |
| update | |
| regeneratekey | |
| recover | |
| purge | |
| backup | |
| restore | |
| setsas | |
| listsas | |
| getsas | |
| deletesas |
SystemData
Метаданные, относящиеся к созданию и последнему изменению ресурса хранилища ключей.
| Имя | Тип | Описание |
|---|---|---|
| createdAt |
string (date-time) |
Временная метка создания ресурса хранилища ключей (UTC). |
| createdBy |
string |
Удостоверение, создавшее ресурс хранилища ключей. |
| createdByType |
Тип удостоверения, создавшего ресурс хранилища ключей. |
|
| lastModifiedAt |
string (date-time) |
Метка времени последнего изменения ресурса хранилища ключей (UTC). |
| lastModifiedBy |
string |
Удостоверение, которое последним изменило ресурс хранилища ключей. |
| lastModifiedByType |
Тип удостоверения, которое последним изменило ресурс хранилища ключей. |
Vault
Информация о ресурсах с расширенными сведениями.
| Имя | Тип | Описание |
|---|---|---|
| id |
string |
Полный идентификатор ресурса хранилища ключей. |
| location |
string |
Расположение ресурса хранилища ключей в Azure. |
| name |
string |
Имя ресурса хранилища ключей. |
| properties |
Свойства хранилища |
|
| systemData |
Системные метаданные для хранилища ключей. |
|
| tags |
object |
Теги, назначенные ресурсу хранилища ключей. |
| type |
string |
Тип ресурса хранилища ключей. |
VaultProperties
Свойства хранилища
| Имя | Тип | Default value | Описание |
|---|---|---|---|
| accessPolicies |
Массив 0–1024 удостоверений, имеющих доступ к хранилищу ключей. Все удостоверения в массиве должны использовать тот же идентификатор клиента, что и идентификатор клиента хранилища ключей. Если |
||
| createMode |
Режим создания хранилища, указывающий, требуется ли восстановить хранилище. |
||
| enablePurgeProtection |
boolean |
Свойство, указывающее, включена ли защита от очистки для этого хранилища. Установка этого свойства на значение true активирует защиту от очистки для этого хранилища и его содержимого. Только служба Key Vault может инициировать жесткое, безвозвратное удаление. Параметр действует только в том случае, если обратимое удаление также включено. Включение этой функции необратимо. Т. е. свойство не принимает значение false в качестве значения. |
|
| enableRbacAuthorization |
boolean |
False |
Свойство, определяющее, как разрешены действия с данными. Если значение true, хранилище ключей будет использовать управление доступом на основе ролей (RBAC) для авторизации действий с данными, а политики доступа, указанные в свойствах хранилища, будут игнорироваться. Если значение false, хранилище ключей будет использовать политики доступа, указанные в свойствах хранилища, и любые политики, хранящиеся в Azure Resource Manager, будут игнорироваться. Если значение NULL или не указано, хранилище создается со значением false по умолчанию. Обратите внимание, что действия управления всегда авторизованы с помощью RBAC. |
| enableSoftDelete |
boolean |
True |
Свойство, указываемое, включена ли функция обратимого удаления для этого хранилища ключей. Если при создании нового хранилища ключей не задано значение (true или false), по умолчанию оно будет иметь значение true. Если задано значение true, его нельзя вернуть к false. |
| enabledForDeployment |
boolean |
False |
Свойство, указываемое, разрешены ли виртуальные машины Azure получать сертификаты, хранящиеся в виде секретов из хранилища ключей. |
| enabledForDiskEncryption |
boolean |
False |
Свойство, указываемое, разрешено ли шифрование дисков Azure извлекать секреты из хранилища и распаковывать ключи. |
| enabledForTemplateDeployment |
boolean |
False |
Свойство, указываемое, разрешено ли Azure Resource Manager получать секреты из хранилища ключей. |
| hsmPoolResourceId |
string |
Идентификатор ресурса пула HSM. |
|
| networkAcls |
Правила, управляющие специальными возможностями хранилища ключей из определенных сетевых расположений. |
||
| privateEndpointConnections |
Список подключений к частным конечным точкам, связанных с хранилищем ключей. |
||
| provisioningState |
Состояние подготовки хранилища. |
||
| publicNetworkAccess |
string |
enabled |
Свойство, указываемое, будет ли хранилище принимать трафик из общедоступного Интернета. Если задано значение "отключено" весь трафик, кроме трафика частной конечной точки, и то, что происходит из доверенных служб, будет заблокировано. Это переопределит установленные правила брандмауэра, что означает, что даже если правила брандмауэра присутствуют, мы не будем учитывать правила. |
| sku |
Сведения о номере SKU |
||
| softDeleteRetentionInDays |
integer (int32) |
90 |
Дни хранения данных softDelete. Он принимает >=7 и <=90. |
| tenantId |
string (uuid) |
Идентификатор клиента Azure Active Directory, который следует использовать для проверки подлинности запросов к хранилищу ключей. |
|
| vaultUri |
string |
Универсальный код ресурса (URI) хранилища для выполнения операций с ключами и секретами. |
VaultProvisioningState
Состояние подготовки хранилища.
| Значение | Описание |
|---|---|
| Succeeded | |
| RegisteringDns |
VirtualNetworkRule
Правило, регулирующее доступность хранилища из определенной виртуальной сети.
| Имя | Тип | Описание |
|---|---|---|
| id |
string |
Полный идентификатор ресурса подсети виртуальной сети, например "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1". |
| ignoreMissingVnetServiceEndpoint |
boolean |
Свойство, указываемое, будет ли NRP игнорировать проверку, настроена ли родительская подсеть serviceEndpoints. |