Backup Vaults - Get In Resource Group

Tjänst:

Data Protection

API-version:

2026-03-01

Returnerar resurssamling som tillhör en resursgrupp.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults?api-version=2026-03-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Svar

Name	Typ	Description
200 OK	BackupVaultResourceList	Azure-operationen slutfördes framgångsrikt.
Other Status Codes	CloudError	Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Get BackupVaults in ResourceGroup

Exempelbegäran

HTTP

GET https://management.azure.com/subscriptions/0b352192-dcac-4cc7-992e-a96190ccc68c/resourceGroups/SampleResourceGroup/providers/Microsoft.DataProtection/backupVaults?api-version=2026-03-01

Exempelsvar

Statuskod:

200

{
  "value": [
    {
      "name": "ExampleVault1",
      "type": "Microsoft.DataProtection/BackupVaults",
      "id": "/subscriptions/0b352192-dcac-4cc7-992e-a96190ccc68c/resourceGroups/SampleResourceGroup/providers/Microsoft.DataProtection/BackupVaults/ExampleVault1",
      "location": "WestUS",
      "properties": {
        "bcdrSecurityLevel": "Good",
        "featureSettings": {
          "crossRegionRestoreSettings": {
            "state": "Enabled"
          }
        },
        "provisioningState": "Succeeded",
        "secureScore": "Adequate",
        "securitySettings": {
          "softDeleteSettings": {
            "retentionDurationInDays": 14,
            "state": "Enabled"
          }
        },
        "storageSettings": [
          {
            "type": "LocallyRedundant",
            "datastoreType": "VaultStore"
          }
        ]
      },
      "tags": {
        "key1": "val1"
      }
    },
    {
      "name": "ExampleVault2",
      "type": "Microsoft.DataProtection/BackupVaults",
      "id": "/subscriptions/0b352192-dcac-4cc7-992e-a96190ccc68c/resourceGroups/SampleResourceGroup/providers/Microsoft.DataProtection/BackupVaults/ExampleVault2",
      "location": "WestUS",
      "properties": {
        "bcdrSecurityLevel": "Good",
        "featureSettings": {
          "crossRegionRestoreSettings": {
            "state": "Enabled"
          }
        },
        "monitoringSettings": {
          "azureMonitorAlertSettings": {
            "alertsForAllJobFailures": "Enabled"
          }
        },
        "provisioningState": "Succeeded",
        "secureScore": "Adequate",
        "securitySettings": {
          "softDeleteSettings": {
            "retentionDurationInDays": 14,
            "state": "Enabled"
          }
        },
        "storageSettings": [
          {
            "type": "LocallyRedundant",
            "datastoreType": "VaultStore"
          }
        ]
      },
      "tags": {
        "key1": "val1"
      }
    }
  ]
}

Definitioner

Name	Description
AlertsState
AzureMonitorAlertSettings	Inställningar för Azure Monitor-baserade aviseringar
BackupVault	Säkerhetskopieringsvalv
BackupVaultResource	Backup Vault-resurs
BackupVaultResourceList	Lista över BackupVault-resurser
BCDRSecurityLevel	Säkerhetsnivå för säkerhetskopieringsvalv
CloudError	Ett felsvar från Azure Backup.
CmkKekIdentity	Information om den hanterade identitet som används för CMK
CmkKeyVaultProperties	Egenskaperna för Key Vault som är värd för CMK
createdByType	Den typ av identitet som skapade resursen.
CrossRegionRestoreSettings
CrossRegionRestoreState	CrossRegionRestore-tillstånd
CrossSubscriptionRestoreSettings	CrossSubscriptionRestore-inställningar
CrossSubscriptionRestoreState	CrossSubscriptionRestore-tillstånd
DppIdentityDetails	Identitetsinformation
encryptionSettings	Kundhanterad nyckelinformation om resursen.
EncryptionState	Krypteringstillstånd för säkerhetskopieringsvalvet.
Error	Svar på resurshanteringsfel.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
FeatureSettings	Klass som innehåller funktionsinställningar för valv
IdentityType	Identitetstypen. "SystemAssigned" och "UserAssigned" är ömsesidigt uteslutande. "SystemAssigned" använder implicit skapad hanterad identitet.
ImmutabilitySettings	Oföränderlighetsinställningar på valvnivå
ImmutabilityState	Oföränderlighetstillstånd
InfrastructureEncryptionState	Aktivera/inaktivera tillståndet dubbelkryptering
MonitoringSettings	Övervakningsinställningar
ProvisioningState	Etableringstillstånd för BackupVault-resursen
ResourceMoveDetails	ResourceMoveDetails returneras som svar på GetResource-anrop från ARM
ResourceMoveState	Resursflytttillstånd för säkerhetskopieringsvalv
SecureScoreLevel	Säkerhetspoäng för säkerhetskopieringsvalv
SecuritySettings	Klass som innehåller säkerhetsinställningar för valv
SoftDeleteSettings	Relaterade inställningar för mjuk borttagning
SoftDeleteState	Tillstånd för mjuk borttagning
StorageSetting	Lagringsinställning
StorageSettingStoreTypes	Hämtar eller anger datalagringstypen.
StorageSettingTypes	Hämtar eller anger typen.
systemData	Metadata som rör skapande och senaste ändring av resursen.
UserAssignedIdentity	Användartilldelade identitetsegenskaper

AlertsState

Uppräkning

Värde	Description
Enabled
Disabled

AzureMonitorAlertSettings

Objekt

Inställningar för Azure Monitor-baserade aviseringar

Name	Typ	Description
alertsForAllJobFailures	AlertsState

BackupVault

Objekt

Säkerhetskopieringsvalv

Name	Typ	Description
bcdrSecurityLevel	BCDRSecurityLevel	Säkerhetsnivå för säkerhetskopieringsvalv
featureSettings	FeatureSettings	Funktionsinställningar
isVaultProtectedByResourceGuard	boolean	Skyddas valvet av resource guard
monitoringSettings	MonitoringSettings	Övervakningsinställningar
provisioningState	ProvisioningState	Etableringstillstånd för BackupVault-resursen
replicatedRegions	string[]	Lista över replikerade regioner för Backup Vault
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests som LAC-kontrollen ska utföras på
resourceMoveDetails	ResourceMoveDetails	Information om resursflytt för säkerhetskopieringsvalv
resourceMoveState	ResourceMoveState	Resursflytttillstånd för säkerhetskopieringsvalv
secureScore	SecureScoreLevel	Säkerhetspoäng för säkerhetskopieringsvalv
securitySettings	SecuritySettings	Säkerhetsinställningar
storageSettings	StorageSetting[]	Lagringsinställningar

BackupVaultResource

Objekt

Backup Vault-resurs

Name	Typ	Description
eTag	string	Valfri ETag.
id	string (arm-id)	Fullständigt kvalificerat resurs-ID för resursen. T.ex. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	DppIdentityDetails	Information om hanterad identitet för indata
location	string	Den geo-plats där resursen finns
name	string	Namnet på resursen
properties	BackupVault	Egenskaper för BackupVaultResource
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
tags	object	Resursetiketter.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

BackupVaultResourceList

Objekt

Lista över BackupVault-resurser

Name	Typ	Description
nextLink	string	URI:n för att hämta nästa sida med resurser. Anropa ListNext() hämtar nästa sida med resurser.
value	BackupVaultResource[]	Lista över resurser.

BCDRSecurityLevel

Uppräkning

Säkerhetsnivå för säkerhetskopieringsvalv

Värde	Description
Poor
Fair
Good
Excellent
NotSupported

CloudError

Objekt

Ett felsvar från Azure Backup.

Name	Typ	Description
error	Error	Svar på resurshanteringsfel.

CmkKekIdentity

Objekt

Information om den hanterade identitet som används för CMK

Name	Typ	Description
identityId	string	Den hanterade identitet som ska användas som har åtkomstbehörighet till Key Vault. Ange ett värde här om identitetstyper: "Användartilldelad" endast.
identityType	IdentityType	Identitetstypen. "SystemAssigned" och "UserAssigned" är ömsesidigt uteslutande. "SystemAssigned" använder implicit skapad hanterad identitet.

CmkKeyVaultProperties

Objekt

Egenskaperna för Key Vault som är värd för CMK

Name	Typ	Description
keyUri	string	Nyckel-URI för den kundhanterade nyckeln

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

CrossRegionRestoreSettings

Objekt

Name	Typ	Description
state	CrossRegionRestoreState	CrossRegionRestore-tillstånd

CrossRegionRestoreState

Uppräkning

CrossRegionRestore-tillstånd

Värde	Description
Disabled
Enabled

CrossSubscriptionRestoreSettings

Objekt

CrossSubscriptionRestore-inställningar

Name	Typ	Description
state	CrossSubscriptionRestoreState	CrossSubscriptionRestore-tillstånd

CrossSubscriptionRestoreState

Uppräkning

CrossSubscriptionRestore-tillstånd

Värde	Description
Disabled
PermanentlyDisabled
Enabled

DppIdentityDetails

Objekt

Identitetsinformation

Name	Typ	Description
principalId	string	Objekt-ID för objektet för tjänstens huvudnamn för den hanterade identitet som används för att bevilja rollbaserad åtkomst till en Azure-resurs.
tenantId	string	En globalt unik identifierare (GUID) som representerar Azure AD-klientorganisationen där resursen nu är medlem.
type	string	IdentityType som kan antingen vara SystemAssigned, UserAssigned, "SystemAssigned,UserAssigned" eller None
userAssignedIdentities	<string,  UserAssignedIdentity>	Hämtar eller anger användartilldelade identiteter.

encryptionSettings

Objekt

Kundhanterad nyckelinformation om resursen.

Name	Typ	Description
infrastructureEncryption	InfrastructureEncryptionState	Aktivera/inaktivera tillståndet dubbelkryptering
kekIdentity	CmkKekIdentity	Information om den hanterade identitet som används för CMK
keyVaultProperties	CmkKeyVaultProperties	Egenskaperna för Key Vault som är värd för CMK
state	EncryptionState	Krypteringstillstånd för säkerhetskopieringsvalvet.

EncryptionState

Uppräkning

Krypteringstillstånd för säkerhetskopieringsvalvet.

Värde	Description
Enabled	CMK-kryptering är aktiverat i Backup Vault
Disabled	CMK-kryptering är inaktiverat i Backup Vault. Användaren kan inte ange det här tillståndet när krypteringstillståndet är aktiverat.
Inconsistent	CMK-kryptering är i inkonsekvent tillstånd i Backup Vault. Det här tillståndet anger att användaren måste försöka utföra krypteringsinställningarna igen omedelbart för att korrigera tillståndet.

Error

Objekt

Svar på resurshanteringsfel.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	Error[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

FeatureSettings

Objekt

Klass som innehåller funktionsinställningar för valv

Name	Typ	Description
crossRegionRestoreSettings	CrossRegionRestoreSettings
crossSubscriptionRestoreSettings	CrossSubscriptionRestoreSettings	CrossSubscriptionRestore-inställningar

IdentityType

Uppräkning

Identitetstypen. "SystemAssigned" och "UserAssigned" är ömsesidigt uteslutande. "SystemAssigned" använder implicit skapad hanterad identitet.

Värde	Description
SystemAssigned
UserAssigned

ImmutabilitySettings

Objekt

Oföränderlighetsinställningar på valvnivå

Name	Typ	Description
state	ImmutabilityState	Oföränderlighetstillstånd

ImmutabilityState

Uppräkning

Oföränderlighetstillstånd

Värde	Description
Disabled
Unlocked
Locked

InfrastructureEncryptionState

Uppräkning

Aktivera/inaktivera tillståndet dubbelkryptering

Värde	Description
Enabled
Disabled

MonitoringSettings

Objekt

Övervakningsinställningar

Name	Typ	Description
azureMonitorAlertSettings	AzureMonitorAlertSettings	Inställningar för Azure Monitor-baserade aviseringar

ProvisioningState

Uppräkning

Etableringstillstånd för BackupVault-resursen

Värde	Description
Failed
Provisioning
Succeeded
Unknown
Updating

ResourceMoveDetails

Objekt

ResourceMoveDetails returneras som svar på GetResource-anrop från ARM

Name	Typ	Description
completionTimeUtc	string	Slutförandetid i UTC för den senaste ResourceMove-åtgärden. ISO 8601-format.
operationId	string	CorrelationId för senaste ResourceMove-åtgärdsförsök
sourceResourcePath	string	ARM-resurssökväg för källresurs
startTimeUtc	string	Starttid i UTC för den senaste ResourceMove-åtgärden. ISO 8601-format.
targetResourcePath	string	ARM-resurssökväg för målresursen som används i den senaste ResourceMove-åtgärden

ResourceMoveState

Uppräkning

Resursflytttillstånd för säkerhetskopieringsvalv

Värde	Description
Unknown
InProgress
PrepareFailed
CommitFailed
Failed
PrepareTimedout
CommitTimedout
CriticalFailure
PartialSuccess
MoveSucceeded

SecureScoreLevel

Uppräkning

Säkerhetspoäng för säkerhetskopieringsvalv

Värde	Description
None
Minimum
Adequate
Maximum
NotSupported

SecuritySettings

Objekt

Klass som innehåller säkerhetsinställningar för valv

Name	Typ	Description
encryptionSettings	encryptionSettings	Kundhanterad nyckelinformation om resursen.
immutabilitySettings	ImmutabilitySettings	Oföränderlighetsinställningar på valvnivå
softDeleteSettings	SoftDeleteSettings	Relaterade inställningar för mjuk borttagning

SoftDeleteSettings

Objekt

Relaterade inställningar för mjuk borttagning

Name	Typ	Description
retentionDurationInDays	number (double)	Varaktighet för kvarhållning av mjuk borttagning
state	SoftDeleteState	Tillstånd för mjuk borttagning

SoftDeleteState

Uppräkning

Tillstånd för mjuk borttagning

Värde	Description
Off	Mjuk borttagning är inaktiverat för BackupVault
On	Mjuk borttagning är aktiverat för BackupVault men kan stängas av
AlwaysOn	Mjuk borttagning är permanent aktiverat för BackupVault och inställningen kan inte ändras

StorageSetting

Objekt

Lagringsinställning

Name	Typ	Description
datastoreType	StorageSettingStoreTypes	Hämtar eller anger datalagringstypen.
type	StorageSettingTypes	Hämtar eller anger typen.

StorageSettingStoreTypes

Uppräkning

Hämtar eller anger datalagringstypen.

Värde	Description
ArchiveStore
OperationalStore
VaultStore

StorageSettingTypes

Uppräkning

Hämtar eller anger typen.

Värde	Description
GeoRedundant
LocallyRedundant
ZoneRedundant

systemData

Objekt

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

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

UserAssignedIdentity

Objekt

Användartilldelade identitetsegenskaper

Name	Typ	Description
clientId	string (uuid)	Klient-ID för den tilldelade identiteten.
principalId	string (uuid)	Huvud-ID för den tilldelade identiteten.