Dela via


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
resourceGroupName
path True

string

Namnet på den resursgrupp som valvet tillhör.

subscriptionId
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.

vaultName
path True

string

Namnet på valvet.

api-version
query True

string

Klient-API-version.

Svar

Name Typ Description
200 OK

Vault

Hämtat valv

Other Status Codes

CloudError

Felsvar som beskriver varför åtgärden misslyckades.

Exempel

Retrieve a vault

Exempelbegäran

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

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
AccessPolicyEntry

En identitet som har åtkomst till nyckelvalvet. Alla identiteter i matrisen måste använda samma klient-ID som nyckelvalvets klient-ID.

ActionsRequired

Ett meddelande som anger om ändringar på tjänstleverantören kräver några uppdateringar på konsumenten.

CertificatePermissions

Behörigheter till certifikat

CloudError

Ett felsvar från 密钥保管库 resursprovidern

CloudErrorBody

Ett felsvar från 密钥保管库 resursprovidern

CreateMode

Valvets skapandeläge för att ange om valvet behöver återställas eller inte.

identityType

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.

KeyPermissions

Behörigheter till nycklar

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.

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".

NetworkRuleSet

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.

PrivateEndpoint

Egenskaper för objekt för privat slutpunkt.

PrivateEndpointConnectionItem

Anslutningsobjekt för privat slutpunkt.

PrivateEndpointConnectionProvisioningState

Det aktuella etableringstillståndet.

PrivateEndpointServiceConnectionStatus

Anslutningsstatus för privat slutpunkt.

PrivateLinkServiceConnectionState

Ett objekt som representerar godkännandetillståndet för den privata länkanslutningen.

SecretPermissions

Behörigheter till hemligheter

Sku

SKU-information

SkuFamily

SKU-familjenamn

SkuName

SKU-namn för att ange om nyckelvalvet är ett standardvalv eller ett Premium-valv.

StoragePermissions

Behörigheter till lagringskonton

SystemData

Metadata som rör skapande och senaste ändring av nyckelvalvsresursen.

Vault

Resursinformation med utökade detaljer.

VaultProperties

Egenskaper för valvet

VaultProvisioningState

Etableringstillstånd för valvet.

VirtualNetworkRule

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

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

CloudErrorBody

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

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".

defaultAction

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.

ipRules

IPRule[]

Listan över IP-adressregler.

virtualNetworkRules

VirtualNetworkRule[]

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

CertificatePermissions[]

Behörigheter till certifikat

keys

KeyPermissions[]

Behörigheter till nycklar

secrets

SecretPermissions[]

Behörigheter till hemligheter

storage

StoragePermissions[]

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

PrivateEndpoint

Egenskaper för det privata slutpunktsobjektet.

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Godkännandetillstånd för den privata länkanslutningen.

properties.provisioningState

PrivateEndpointConnectionProvisioningState

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

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

PrivateEndpointServiceConnectionStatus

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

SkuFamily

SKU-familjenamn

name

SkuName

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

identityType

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

identityType

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

VaultProperties

Egenskaper för valvet

systemData

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

AccessPolicyEntry[]

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 är inställt på recoverkrävs inte åtkomstprinciper. Annars krävs åtkomstprinciper.

createMode

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

NetworkRuleSet

Regler som styr åtkomsten till nyckelvalvet från specifika nätverksplatser.

privateEndpointConnections

PrivateEndpointConnectionItem[]

Lista över privata slutpunktsanslutningar som är associerade med nyckelvalvet.

provisioningState

VaultProvisioningState

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

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.