Vaults - Get
Hämtar det angivna Azure-nyckelvalvet.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}?api-version=2024-11-01
URI-parametrar
| Name | I | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string |
Namnet på den resursgrupp som valvet tillhör. |
|
subscription
|
path | True |
string |
Prenumerationsautentiseringsuppgifter som unikt identifierar Microsoft Azure-prenumeration. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop. |
|
vault
|
path | True |
string |
Namnet på valvet. |
|
api-version
|
query | True |
string |
Klient-API-version. |
Svar
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Hämtat valv |
|
| Other Status Codes |
Felsvar som beskriver varför åtgärden misslyckades. |
Exempel
Retrieve a vault
Exempelbegäran
Exempelsvar
{
"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"
}
}
Definitioner
| Name | Description |
|---|---|
|
Access |
En identitet som har åtkomst till nyckelvalvet. Alla identiteter i matrisen måste använda samma klient-ID som nyckelvalvets klient-ID. |
|
Actions |
Ett meddelande som anger om ändringar på tjänstleverantören kräver några uppdateringar på konsumenten. |
|
Certificate |
Behörigheter till certifikat |
|
Cloud |
Ett felsvar från 密钥保管库 resursprovidern |
|
Cloud |
Ett felsvar från 密钥保管库 resursprovidern |
|
Create |
Valvets skapandeläge för att ange om valvet behöver återställas eller inte. |
|
identity |
Den typ av identitet som skapade nyckelvalvsresursen. |
| IPRule |
En regel som styr tillgängligheten för ett valv från en specifik IP-adress eller ett visst IP-intervall. |
|
Key |
Behörigheter till nycklar |
|
Network |
Standardåtgärden när ingen regel från ipRules och från virtualNetworkRules matchar. Detta används endast efter att förbikopplingsegenskapen har utvärderats. |
|
Network |
Talar om för vilken trafik som kan kringgå nätverksregler. Det kan vara "AzureServices" eller "None". Om det inte anges är standardvärdet "AzureServices". |
|
Network |
En uppsättning regler som styr nätverkstillgängligheten för ett valv. |
| Permissions |
Behörigheter som identiteten har för nycklar, hemligheter, certifikat och lagring. |
|
Private |
Egenskaper för objekt för privat slutpunkt. |
|
Private |
Anslutningsobjekt för privat slutpunkt. |
|
Private |
Det aktuella etableringstillståndet. |
|
Private |
Anslutningsstatus för privat slutpunkt. |
|
Private |
Ett objekt som representerar godkännandetillståndet för den privata länkanslutningen. |
|
Secret |
Behörigheter till hemligheter |
| Sku |
SKU-information |
|
Sku |
SKU-familjenamn |
|
Sku |
SKU-namn för att ange om nyckelvalvet är ett standardvalv eller ett Premium-valv. |
|
Storage |
Behörigheter till lagringskonton |
|
System |
Metadata som rör skapande och senaste ändring av nyckelvalvsresursen. |
| Vault |
Resursinformation med utökade detaljer. |
|
Vault |
Egenskaper för valvet |
|
Vault |
Etableringstillstånd för valvet. |
|
Virtual |
En regel som styr tillgängligheten för ett valv från ett specifikt virtuellt nätverk. |
AccessPolicyEntry
En identitet som har åtkomst till nyckelvalvet. Alla identiteter i matrisen måste använda samma klient-ID som nyckelvalvets klient-ID.
| Name | Typ | Description |
|---|---|---|
| applicationId |
string (uuid) |
Program-ID för klienten som begär för ett huvudnamn |
| objectId |
string |
Objekt-ID för en användare, tjänstens huvudnamn eller säkerhetsgrupp i Azure Active Directory-klientorganisationen för valvet. Objekt-ID:t måste vara unikt för listan över åtkomstprinciper. |
| permissions |
Behörigheter som identiteten har för nycklar, hemligheter och certifikat. |
|
| tenantId |
string (uuid) |
Det Azure Active Directory-klient-ID som ska användas för att autentisera begäranden till nyckelvalvet. |
ActionsRequired
Ett meddelande som anger om ändringar på tjänstleverantören kräver några uppdateringar på konsumenten.
| Värde | Description |
|---|---|
| None |
CertificatePermissions
Behörigheter till certifikat
| Värde | Description |
|---|---|
| all | |
| get | |
| list | |
| delete | |
| create | |
| import | |
| update | |
| managecontacts | |
| getissuers | |
| listissuers | |
| setissuers | |
| deleteissuers | |
| manageissuers | |
| recover | |
| purge | |
| backup | |
| restore |
CloudError
Ett felsvar från 密钥保管库 resursprovidern
| Name | Typ | Description |
|---|---|---|
| error |
Ett felsvar från 密钥保管库 resursprovidern |
CloudErrorBody
Ett felsvar från 密钥保管库 resursprovidern
| Name | Typ | Description |
|---|---|---|
| code |
string |
Felkod. Detta är en mnemonik som kan användas programmatiskt. |
| message |
string |
Användarvänligt felmeddelande. Meddelandet är vanligtvis lokaliserat och kan variera beroende på tjänstversion. |
CreateMode
Valvets skapandeläge för att ange om valvet behöver återställas eller inte.
| Värde | Description |
|---|---|
| recover | |
| default |
identityType
Den typ av identitet som skapade nyckelvalvsresursen.
| Värde | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
IPRule
En regel som styr tillgängligheten för ett valv från en specifik IP-adress eller ett visst IP-intervall.
| Name | Typ | Description |
|---|---|---|
| value |
string |
Ett IPv4-adressintervall i CIDR-notation, till exempel "124.56.78.91" (enkel IP-adress) eller "124.56.78.0/24" (alla adresser som börjar med 124.56.78). |
KeyPermissions
Behörigheter till nycklar
| Värde | Description |
|---|---|
| all | |
| encrypt | |
| decrypt | |
| wrapKey | |
| unwrapKey | |
| sign | |
| verify | |
| get | |
| list | |
| create | |
| update | |
| import | |
| delete | |
| backup | |
| restore | |
| recover | |
| purge | |
| release | |
| rotate | |
| getrotationpolicy | |
| setrotationpolicy |
NetworkRuleAction
Standardåtgärden när ingen regel från ipRules och från virtualNetworkRules matchar. Detta används endast efter att förbikopplingsegenskapen har utvärderats.
| Värde | Description |
|---|---|
| Allow | |
| Deny |
NetworkRuleBypassOptions
Talar om för vilken trafik som kan kringgå nätverksregler. Det kan vara "AzureServices" eller "None". Om det inte anges är standardvärdet "AzureServices".
| Värde | Description |
|---|---|
| AzureServices | |
| None |
NetworkRuleSet
En uppsättning regler som styr nätverkstillgängligheten för ett valv.
| Name | Typ | Description |
|---|---|---|
| bypass |
Talar om för vilken trafik som kan kringgå nätverksregler. Det kan vara "AzureServices" eller "None". Om det inte anges är standardvärdet "AzureServices". |
|
| defaultAction |
Standardåtgärden när ingen regel från ipRules och från virtualNetworkRules matchar. Detta används endast efter att förbikopplingsegenskapen har utvärderats. |
|
| ipRules |
IPRule[] |
Listan över IP-adressregler. |
| virtualNetworkRules |
Listan över regler för virtuella nätverk. |
Permissions
Behörigheter som identiteten har för nycklar, hemligheter, certifikat och lagring.
| Name | Typ | Description |
|---|---|---|
| certificates |
Behörigheter till certifikat |
|
| keys |
Behörigheter till nycklar |
|
| secrets |
Behörigheter till hemligheter |
|
| storage |
Behörigheter till lagringskonton |
PrivateEndpoint
Egenskaper för objekt för privat slutpunkt.
| Name | Typ | Description |
|---|---|---|
| id |
string |
Fullständig identifierare för den privata slutpunktsresursen. |
PrivateEndpointConnectionItem
Anslutningsobjekt för privat slutpunkt.
| Name | Typ | Description |
|---|---|---|
| etag |
string |
Ändras när det sker en ändring i tillståndet för den privata slutpunktsanslutningen. |
| id |
string |
ID för anslutning till privat slutpunkt. |
| properties.privateEndpoint |
Egenskaper för det privata slutpunktsobjektet. |
|
| properties.privateLinkServiceConnectionState |
Godkännandetillstånd för den privata länkanslutningen. |
|
| properties.provisioningState |
Etableringstillstånd för den privata slutpunktsanslutningen. |
PrivateEndpointConnectionProvisioningState
Det aktuella etableringstillståndet.
| Värde | Description |
|---|---|
| Succeeded | |
| Creating | |
| Updating | |
| Deleting | |
| Failed | |
| Disconnected |
PrivateEndpointServiceConnectionStatus
Anslutningsstatus för privat slutpunkt.
| Värde | Description |
|---|---|
| Pending | |
| Approved | |
| Rejected | |
| Disconnected |
PrivateLinkServiceConnectionState
Ett objekt som representerar godkännandetillståndet för den privata länkanslutningen.
| Name | Typ | Description |
|---|---|---|
| actionsRequired |
Ett meddelande som anger om ändringar på tjänstleverantören kräver några uppdateringar på konsumenten. |
|
| description |
string |
Anledningen till godkännande eller avvisande. |
| status |
Anger om anslutningen har godkänts, avvisats eller tagits bort av nyckelvalvets ägare. |
SecretPermissions
Behörigheter till hemligheter
| Värde | Description |
|---|---|
| all | |
| get | |
| list | |
| set | |
| delete | |
| backup | |
| restore | |
| recover | |
| purge |
Sku
SKU-information
| Name | Typ | Description |
|---|---|---|
| family |
SKU-familjenamn |
|
| name |
SKU-namn för att ange om nyckelvalvet är ett standardvalv eller ett Premium-valv. |
SkuFamily
SKU-familjenamn
| Värde | Description |
|---|---|
| A |
SkuName
SKU-namn för att ange om nyckelvalvet är ett standardvalv eller ett Premium-valv.
| Värde | Description |
|---|---|
| standard | |
| premium |
StoragePermissions
Behörigheter till lagringskonton
| Värde | Description |
|---|---|
| all | |
| get | |
| list | |
| delete | |
| set | |
| update | |
| regeneratekey | |
| recover | |
| purge | |
| backup | |
| restore | |
| setsas | |
| listsas | |
| getsas | |
| deletesas |
SystemData
Metadata som rör skapande och senaste ändring av nyckelvalvsresursen.
| Name | Typ | Description |
|---|---|---|
| createdAt |
string (date-time) |
Tidsstämpeln för att skapa nyckelvalvsresursen (UTC). |
| createdBy |
string |
Identiteten som skapade nyckelvalvsresursen. |
| createdByType |
Den typ av identitet som skapade nyckelvalvsresursen. |
|
| lastModifiedAt |
string (date-time) |
Tidsstämpeln för den senaste ändringen av nyckelvalvsresursen (UTC). |
| lastModifiedBy |
string |
Identiteten som senast ändrade nyckelvalvsresursen. |
| lastModifiedByType |
Den typ av identitet som senast ändrade nyckelvalvsresursen. |
Vault
Resursinformation med utökade detaljer.
| Name | Typ | Description |
|---|---|---|
| id |
string |
Fullständigt kvalificerad identifierare för nyckelvalvsresursen. |
| location |
string |
Azure-platsen för nyckelvalvsresursen. |
| name |
string |
Namnet på nyckelvalvsresursen. |
| properties |
Egenskaper för valvet |
|
| systemData |
Systemmetadata för nyckelvalvet. |
|
| tags |
object |
Taggar som tilldelats nyckelvalvsresursen. |
| type |
string |
Resurstyp för nyckelvalvsresursen. |
VaultProperties
Egenskaper för valvet
| Name | Typ | Standardvärde | Description |
|---|---|---|---|
| accessPolicies |
En matris med 0 till 1 024 identiteter som har åtkomst till nyckelvalvet. Alla identiteter i matrisen måste använda samma klient-ID som nyckelvalvets klient-ID. När |
||
| createMode |
Valvets skapandeläge för att ange om valvet behöver återställas eller inte. |
||
| enablePurgeProtection |
boolean |
Egenskap som anger om skydd mot rensning är aktiverat för det här valvet. Om du anger den här egenskapen till true aktiveras skydd mot rensning för det här valvet och dess innehåll . Endast Key Vault-tjänsten kan initiera en hård och oåterkallelig borttagning. Inställningen är endast effektiv om mjuk borttagning också är aktiverad. Det går inte att ångra aktiveringen av den här funktionen, dvs. egenskapen accepterar inte false som värde. |
|
| enableRbacAuthorization |
boolean |
False |
Egenskap som styr hur dataåtgärder auktoriseras. När det är sant använder nyckelvalvet rollbaserad åtkomstkontroll (RBAC) för auktorisering av dataåtgärder och de åtkomstprinciper som anges i valvegenskaper ignoreras. När det är falskt använder nyckelvalvet de åtkomstprinciper som anges i valvegenskaper och alla principer som lagras i Azure Resource Manager ignoreras. Om null eller inte anges skapas valvet med standardvärdet false. Observera att hanteringsåtgärder alltid är auktoriserade med RBAC. |
| enableSoftDelete |
boolean |
True |
Egenskap för att ange om funktionen "mjuk borttagning" är aktiverad för det här nyckelvalvet. Om det inte är inställt på något värde (sant eller falskt) när du skapar ett nytt nyckelvalv, anges det som standard till sant. När värdet är sant kan det inte återställas till false. |
| enabledForDeployment |
boolean |
False |
Egenskap för att ange om virtuella Azure-datorer tillåts hämta certifikat som lagras som hemligheter från nyckelvalvet. |
| enabledForDiskEncryption |
boolean |
False |
Egenskap för att ange om Azure Disk Encryption tillåts hämta hemligheter från valvet och packa upp nycklar. |
| enabledForTemplateDeployment |
boolean |
False |
Egenskap för att ange om Azure Resource Manager tillåts hämta hemligheter från nyckelvalvet. |
| hsmPoolResourceId |
string |
Resurs-ID:t för HSM-poolen. |
|
| networkAcls |
Regler som styr åtkomsten till nyckelvalvet från specifika nätverksplatser. |
||
| privateEndpointConnections |
Lista över privata slutpunktsanslutningar som är associerade med nyckelvalvet. |
||
| provisioningState |
Etableringstillstånd för valvet. |
||
| publicNetworkAccess |
string |
enabled |
Egenskap för att ange om valvet ska acceptera trafik från offentligt Internet. Om den är inställd på "inaktiverad" blockeras all trafik utom privat slutpunktstrafik och den som kommer från betrodda tjänster. Detta åsidosätter de angivna brandväggsreglerna, vilket innebär att även om brandväggsreglerna finns kommer vi inte att respektera reglerna. |
| sku |
SKU-information |
||
| softDeleteRetentionInDays |
integer (int32) |
90 |
softTa bort datakvarhållningsdagar. Den accepterar >=7 och <=90. |
| tenantId |
string (uuid) |
Det Azure Active Directory-klient-ID som ska användas för att autentisera begäranden till nyckelvalvet. |
|
| vaultUri |
string |
URI:n för valvet för att utföra åtgärder på nycklar och hemligheter. |
VaultProvisioningState
Etableringstillstånd för valvet.
| Värde | Description |
|---|---|
| Succeeded | |
| RegisteringDns |
VirtualNetworkRule
En regel som styr tillgängligheten för ett valv från ett specifikt virtuellt nätverk.
| Name | Typ | Description |
|---|---|---|
| id |
string |
Fullständigt resurs-ID för ett vnet-undernät, till exempel "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1". |
| ignoreMissingVnetServiceEndpoint |
boolean |
Egenskap för att ange om NRP ska ignorera kontrollen om det överordnade undernätet har serviceEndpoints konfigurerade. |