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


Vaults - Get

Получает указанное хранилище ключей Azure.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}?api-version=2024-11-01

Параметры URI

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

string

Имя группы ресурсов, к которой принадлежит хранилище.

subscriptionId
path True

string

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

vaultName
path True

string

Название хранилища.

api-version
query True

string

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

Ответы

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

Vault

Извлеченный сейф

Other Status Codes

CloudError

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

Примеры

Retrieve a vault

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

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-resource-group/providers/Microsoft.KeyVault/vaults/sample-vault?api-version=2024-11-01

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

{
  "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"
  }
}

Определения

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

Удостоверение, имеющее доступ к хранилищу ключей. Все удостоверения в массиве должны использовать тот же идентификатор клиента, что и идентификатор клиента хранилища ключей.

ActionsRequired

Сообщение, указывающее, требуются ли изменения в поставщике услуг, требуются какие-либо обновления для потребителя.

CertificatePermissions

Разрешения на сертификаты

CloudError

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

CloudErrorBody

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

CreateMode

Режим создания хранилища, указывающий, требуется ли восстановить хранилище.

identityType

Тип удостоверения, создавшего ресурс хранилища ключей.

IPRule

Правило, регулирующее доступность хранилища с определенного IP-адреса или диапазона IP-адресов.

KeyPermissions

Разрешения на ключи

NetworkRuleAction

Действие по умолчанию, если правило из ipRules и из virtualNetworkRules не совпадает. Это используется только после оценки свойства обхода.

NetworkRuleBypassOptions

Указывает, какой трафик может обойти правила сети. Это может быть "AzureServices" или "Нет". Если значение по умолчанию не задано, — AzureServices.

NetworkRuleSet

Набор правил, регулирующих сетевой доступ хранилища.

Permissions

Разрешения, которые удостоверение имеет для ключей, секретов, сертификатов и хранилища.

PrivateEndpoint

Свойства объекта частной конечной точки.

PrivateEndpointConnectionItem

Элемент подключения к частной конечной точке.

PrivateEndpointConnectionProvisioningState

Текущее состояние подготовки.

PrivateEndpointServiceConnectionStatus

Состояние подключения к частной конечной точке.

PrivateLinkServiceConnectionState

Объект, представляющий состояние утверждения подключения к приватному каналу.

SecretPermissions

Разрешения на секреты

Sku

Сведения о номере SKU

SkuFamily

Имя семейства SKU

SkuName

Имя SKU, указывающее, является ли хранилище ключей стандартным хранилищем или хранилищем класса Premium.

StoragePermissions

Разрешения для учетных записей хранения

SystemData

Метаданные, относящиеся к созданию и последнему изменению ресурса хранилища ключей.

Vault

Информация о ресурсах с расширенными сведениями.

VaultProperties

Свойства хранилища

VaultProvisioningState

Состояние подготовки хранилища.

VirtualNetworkRule

Правило, регулирующее доступность хранилища из определенной виртуальной сети.

AccessPolicyEntry

Удостоверение, имеющее доступ к хранилищу ключей. Все удостоверения в массиве должны использовать тот же идентификатор клиента, что и идентификатор клиента хранилища ключей.

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

string (uuid)

Идентификатор приложения клиента, выполняющего запрос от имени субъекта

objectId

string

Идентификатор объекта пользователя, субъекта-службы или группы безопасности в клиенте Azure Active Directory для хранилища. Идентификатор объекта должен быть уникальным для списка политик доступа.

permissions

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

CloudErrorBody

Ответ об ошибке от поставщика ресурсов 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

NetworkRuleBypassOptions

Указывает, какой трафик может обойти правила сети. Это может быть "AzureServices" или "Нет". Если значение по умолчанию не задано, — AzureServices.

defaultAction

NetworkRuleAction

Действие по умолчанию, если правило из ipRules и из virtualNetworkRules не совпадает. Это используется только после оценки свойства обхода.

ipRules

IPRule[]

Список правил IP-адресов.

virtualNetworkRules

VirtualNetworkRule[]

Список правил виртуальной сети.

Permissions

Разрешения, которые удостоверение имеет для ключей, секретов, сертификатов и хранилища.

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

CertificatePermissions[]

Разрешения на сертификаты

keys

KeyPermissions[]

Разрешения на ключи

secrets

SecretPermissions[]

Разрешения на секреты

storage

StoragePermissions[]

Разрешения для учетных записей хранения

PrivateEndpoint

Свойства объекта частной конечной точки.

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

string

Полный идентификатор ресурса частной конечной точки.

PrivateEndpointConnectionItem

Элемент подключения к частной конечной точке.

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

string

Изменяется всякий раз при изменении состояния подключения к частной конечной точке.

id

string

Идентификатор подключения к частной конечной точке.

properties.privateEndpoint

PrivateEndpoint

Свойства объекта частной конечной точки.

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Состояние утверждения подключения приватного канала.

properties.provisioningState

PrivateEndpointConnectionProvisioningState

Состояние подготовки подключения к частной конечной точке.

PrivateEndpointConnectionProvisioningState

Текущее состояние подготовки.

Значение Описание
Succeeded
Creating
Updating
Deleting
Failed
Disconnected

PrivateEndpointServiceConnectionStatus

Состояние подключения к частной конечной точке.

Значение Описание
Pending
Approved
Rejected
Disconnected

PrivateLinkServiceConnectionState

Объект, представляющий состояние утверждения подключения к приватному каналу.

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

ActionsRequired

Сообщение, указывающее, требуются ли изменения в поставщике услуг, требуются какие-либо обновления для потребителя.

description

string

Причина утверждения или отклонения.

status

PrivateEndpointServiceConnectionStatus

Указывает, утверждено ли подключение, отклонено или удалено владельцем хранилища ключей.

SecretPermissions

Разрешения на секреты

Значение Описание
all
get
list
set
delete
backup
restore
recover
purge

Sku

Сведения о номере SKU

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

SkuFamily

Имя семейства SKU

name

SkuName

Имя 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

identityType

Тип удостоверения, создавшего ресурс хранилища ключей.

lastModifiedAt

string (date-time)

Метка времени последнего изменения ресурса хранилища ключей (UTC).

lastModifiedBy

string

Удостоверение, которое последним изменило ресурс хранилища ключей.

lastModifiedByType

identityType

Тип удостоверения, которое последним изменило ресурс хранилища ключей.

Vault

Информация о ресурсах с расширенными сведениями.

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

string

Полный идентификатор ресурса хранилища ключей.

location

string

Расположение ресурса хранилища ключей в Azure.

name

string

Имя ресурса хранилища ключей.

properties

VaultProperties

Свойства хранилища

systemData

SystemData

Системные метаданные для хранилища ключей.

tags

object

Теги, назначенные ресурсу хранилища ключей.

type

string

Тип ресурса хранилища ключей.

VaultProperties

Свойства хранилища

Имя Тип Default value Описание
accessPolicies

AccessPolicyEntry[]

Массив 0–1024 удостоверений, имеющих доступ к хранилищу ключей. Все удостоверения в массиве должны использовать тот же идентификатор клиента, что и идентификатор клиента хранилища ключей. Если createMode задано значение recover, политики доступа не требуются. В противном случае требуются политики доступа.

createMode

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

NetworkRuleSet

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

privateEndpointConnections

PrivateEndpointConnectionItem[]

Список подключений к частным конечным точкам, связанных с хранилищем ключей.

provisioningState

VaultProvisioningState

Состояние подготовки хранилища.

publicNetworkAccess

string

enabled

Свойство, указываемое, будет ли хранилище принимать трафик из общедоступного Интернета. Если задано значение "отключено" весь трафик, кроме трафика частной конечной точки, и то, что происходит из доверенных служб, будет заблокировано. Это переопределит установленные правила брандмауэра, что означает, что даже если правила брандмауэра присутствуют, мы не будем учитывать правила.

sku

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.