Backup Vaults - Get In Resource Group

Layanan:

Data Protection

Versi API:

2026-03-01

Mengembalikan kumpulan sumber daya milik grup sumber daya.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Respons

Nama	Jenis	Deskripsi
200 OK	BackupVaultResourceList	Operasi Azure berhasil diselesaikan.
Other Status Codes	CloudError	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

Get BackupVaults in ResourceGroup

Permintaan sampel

HTTP

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

Respon sampel

Kode status:

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

Definisi

Nama	Deskripsi
AlertsState
AzureMonitorAlertSettings	Pengaturan untuk pemberitahuan berbasis Azure Monitor
BackupVault	Penyimpanan Cadangan
BackupVaultResource	Sumber Daya Vault Cadangan
BackupVaultResourceList	Daftar sumber daya BackupVault
BCDRSecurityLevel	Tingkat Keamanan Vault Cadangan
CloudError	Respons kesalahan dari Azure Backup.
CmkKekIdentity	Detail identitas terkelola yang digunakan untuk CMK
CmkKeyVaultProperties	Properti Key Vault yang menghosting CMK
createdByType	Jenis identitas yang membuat sumber daya.
CrossRegionRestoreSettings
CrossRegionRestoreState	Status CrossRegionRestore
CrossSubscriptionRestoreSettings	Pengaturan CrossSubscriptionRestore
CrossSubscriptionRestoreState	Status CrossSubscriptionRestore
DppIdentityDetails	Detail identitas
encryptionSettings	Detail Kunci yang Dikelola Pelanggan dari sumber daya.
EncryptionState	Status enkripsi Vault Cadangan.
Error	Respons kesalahan manajemen sumber daya.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
FeatureSettings	Kelas yang berisi pengaturan fitur vault
IdentityType	Jenis identitas. 'SystemAssigned' dan 'UserAssigned' saling eksklusif. 'SystemAssigned' akan menggunakan identitas terkelola yang dibuat secara implisit.
ImmutabilitySettings	Pengaturan Imutabilitas pada tingkat vault
ImmutabilityState	Status kekekalan
InfrastructureEncryptionState	Mengaktifkan/Menonaktifkan status Enkripsi Ganda
MonitoringSettings	Pengaturan Pemantauan
ProvisioningState	Status provisi sumber daya BackupVault
ResourceMoveDetails	ResourceMoveDetails akan dikembalikan sebagai respons terhadap panggilan GetResource dari ARM
ResourceMoveState	Status pemindahan sumber daya untuk brankas cadangan
SecureScoreLevel	Skor Aman Brankas Cadangan
SecuritySettings	Kelas yang berisi pengaturan keamanan vault
SoftDeleteSettings	Pengaturan terkait penghapusan sementara
SoftDeleteState	Status penghapusan sementara
StorageSetting	Pengaturan penyimpanan
StorageSettingStoreTypes	Mendapatkan atau mengatur jenis datastore.
StorageSettingTypes	Mendapatkan atau mengatur jenisnya.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
UserAssignedIdentity	Properti identitas yang ditetapkan pengguna

AlertsState

Enumerasi

Nilai	Deskripsi
Enabled
Disabled

AzureMonitorAlertSettings

Objek

Pengaturan untuk pemberitahuan berbasis Azure Monitor

Nama	Jenis	Deskripsi
alertsForAllJobFailures	AlertsState

BackupVault

Objek

Penyimpanan Cadangan

Nama	Jenis	Deskripsi
bcdrSecurityLevel	BCDRSecurityLevel	Tingkat Keamanan Vault Cadangan
featureSettings	FeatureSettings	Pengaturan Fitur
isVaultProtectedByResourceGuard	boolean	Apakah vault dilindungi oleh resource guard
monitoringSettings	MonitoringSettings	Pengaturan Pemantauan
provisioningState	ProvisioningState	Status provisi sumber daya BackupVault
replicatedRegions	string[]	Daftar wilayah yang direplikasi untuk Vault Cadangan
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests di mana pemeriksaan LAC akan dilakukan
resourceMoveDetails	ResourceMoveDetails	Detail pemindahan sumber daya untuk brankas cadangan
resourceMoveState	ResourceMoveState	Status pemindahan sumber daya untuk brankas cadangan
secureScore	SecureScoreLevel	Skor Aman Brankas Cadangan
securitySettings	SecuritySettings	Pengaturan Keamanan
storageSettings	StorageSetting[]	Pengaturan Penyimpanan

BackupVaultResource

Objek

Sumber Daya Vault Cadangan

Nama	Jenis	Deskripsi
eTag	string	ETag Opsional.
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	DppIdentityDetails	Masukkan Detail Identitas Terkelola
location	string	Lokasi geografis tempat sumber daya berada
name	string	Nama sumber daya
properties	BackupVault	Properti BackupVaultResource
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

BackupVaultResourceList

Objek

Daftar sumber daya BackupVault

Nama	Jenis	Deskripsi
nextLink	string	Uri untuk mengambil halaman sumber daya berikutnya. Panggil ListNext() mengambil halaman sumber daya berikutnya.
value	BackupVaultResource[]	Daftar sumber daya.

BCDRSecurityLevel

Enumerasi

Tingkat Keamanan Vault Cadangan

Nilai	Deskripsi
Poor
Fair
Good
Excellent
NotSupported

CloudError

Objek

Respons kesalahan dari Azure Backup.

Nama	Jenis	Deskripsi
error	Error	Respons kesalahan manajemen sumber daya.

CmkKekIdentity

Objek

Detail identitas terkelola yang digunakan untuk CMK

Nama	Jenis	Deskripsi
identityId	string	Identitas terkelola yang akan digunakan yang memiliki izin akses ke Key Vault. Berikan nilai di sini jika jenis identitas: 'UserAssigned' saja.
identityType	IdentityType	Jenis identitas. 'SystemAssigned' dan 'UserAssigned' saling eksklusif. 'SystemAssigned' akan menggunakan identitas terkelola yang dibuat secara implisit.

CmkKeyVaultProperties

Objek

Properti Key Vault yang menghosting CMK

Nama	Jenis	Deskripsi
keyUri	string	Uri kunci Kunci yang Dikelola Pelanggan

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

CrossRegionRestoreSettings

Objek

Nama	Jenis	Deskripsi
state	CrossRegionRestoreState	Status CrossRegionRestore

CrossRegionRestoreState

Enumerasi

Status CrossRegionRestore

Nilai	Deskripsi
Disabled
Enabled

CrossSubscriptionRestoreSettings

Objek

Pengaturan CrossSubscriptionRestore

Nama	Jenis	Deskripsi
state	CrossSubscriptionRestoreState	Status CrossSubscriptionRestore

CrossSubscriptionRestoreState

Enumerasi

Status CrossSubscriptionRestore

Nilai	Deskripsi
Disabled
PermanentlyDisabled
Enabled

DppIdentityDetails

Objek

Detail identitas

Nama	Jenis	Deskripsi
principalId	string	ID objek objek perwakilan layanan untuk identitas terkelola yang digunakan untuk memberikan akses berbasis peran ke sumber daya Azure.
tenantId	string	Pengidentifikasi Unik Global (GUID) yang mewakili penyewa Microsoft Azure AD tempat sumber daya sekarang menjadi anggota.
type	string	IdentityType yang dapat berupa SystemAssigned, UserAssigned, 'SystemAssigned,UserAssigned' atau None
userAssignedIdentities	<string,  UserAssignedIdentity>	Mendapatkan atau mengatur identitas yang ditetapkan pengguna.

encryptionSettings

Objek

Detail Kunci yang Dikelola Pelanggan dari sumber daya.

Nama	Jenis	Deskripsi
infrastructureEncryption	InfrastructureEncryptionState	Mengaktifkan/Menonaktifkan status Enkripsi Ganda
kekIdentity	CmkKekIdentity	Detail identitas terkelola yang digunakan untuk CMK
keyVaultProperties	CmkKeyVaultProperties	Properti Key Vault yang menghosting CMK
state	EncryptionState	Status enkripsi Vault Cadangan.

EncryptionState

Enumerasi

Status enkripsi Vault Cadangan.

Nilai	Deskripsi
Enabled	Enkripsi CMK diaktifkan pada Brankas Cadangan
Disabled	Enkripsi CMK dinonaktifkan pada Backup Vault. Pengguna tidak dapat mengatur status ini setelah Status Enkripsi 'Diaktifkan'.
Inconsistent	Enkripsi CMK dalam status tidak konsisten pada Brankas Cadangan. Status ini menunjukkan bahwa pengguna perlu mencoba kembali operasi pengaturan enkripsi segera untuk memperbaiki status.

Error

Objek

Respons kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	Error[]	Rincian kesalahan.
message	string	Pesan kesalahan.
target	string	Sasaran kesalahan.

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

FeatureSettings

Objek

Kelas yang berisi pengaturan fitur vault

Nama	Jenis	Deskripsi
crossRegionRestoreSettings	CrossRegionRestoreSettings
crossSubscriptionRestoreSettings	CrossSubscriptionRestoreSettings	Pengaturan CrossSubscriptionRestore

IdentityType

Enumerasi

Jenis identitas. 'SystemAssigned' dan 'UserAssigned' saling eksklusif. 'SystemAssigned' akan menggunakan identitas terkelola yang dibuat secara implisit.

Nilai	Deskripsi
SystemAssigned
UserAssigned

ImmutabilitySettings

Objek

Pengaturan Imutabilitas pada tingkat vault

Nama	Jenis	Deskripsi
state	ImmutabilityState	Status kekekalan

ImmutabilityState

Enumerasi

Status kekekalan

Nilai	Deskripsi
Disabled
Unlocked
Locked

InfrastructureEncryptionState

Enumerasi

Mengaktifkan/Menonaktifkan status Enkripsi Ganda

Nilai	Deskripsi
Enabled
Disabled

MonitoringSettings

Objek

Pengaturan Pemantauan

Nama	Jenis	Deskripsi
azureMonitorAlertSettings	AzureMonitorAlertSettings	Pengaturan untuk pemberitahuan berbasis Azure Monitor

ProvisioningState

Enumerasi

Status provisi sumber daya BackupVault

Nilai	Deskripsi
Failed
Provisioning
Succeeded
Unknown
Updating

ResourceMoveDetails

Objek

ResourceMoveDetails akan dikembalikan sebagai respons terhadap panggilan GetResource dari ARM

Nama	Jenis	Deskripsi
completionTimeUtc	string	Waktu penyelesaian dalam UTC dari operasi ResourceMove terbaru yang dicoba. Format ISO 8601.
operationId	string	CorrelationId dari operasi ResourceMove terbaru yang dicoba
sourceResourcePath	string	Jalur sumber daya ARM sumber daya sumber
startTimeUtc	string	Waktu mulai dalam UTC dari operasi ResourceMove terbaru yang dicoba. Format ISO 8601.
targetResourcePath	string	Jalur sumber daya ARM dari sumber daya target yang digunakan dalam operasi ResourceMove terbaru

ResourceMoveState

Enumerasi

Status pemindahan sumber daya untuk brankas cadangan

Nilai	Deskripsi
Unknown
InProgress
PrepareFailed
CommitFailed
Failed
PrepareTimedout
CommitTimedout
CriticalFailure
PartialSuccess
MoveSucceeded

SecureScoreLevel

Enumerasi

Skor Aman Brankas Cadangan

Nilai	Deskripsi
None
Minimum
Adequate
Maximum
NotSupported

SecuritySettings

Objek

Kelas yang berisi pengaturan keamanan vault

Nama	Jenis	Deskripsi
encryptionSettings	encryptionSettings	Detail Kunci yang Dikelola Pelanggan dari sumber daya.
immutabilitySettings	ImmutabilitySettings	Pengaturan Imutabilitas pada tingkat vault
softDeleteSettings	SoftDeleteSettings	Pengaturan terkait penghapusan sementara

SoftDeleteSettings

Objek

Pengaturan terkait penghapusan sementara

Nama	Jenis	Deskripsi
retentionDurationInDays	number (double)	Durasi retensi penghapusan sementara
state	SoftDeleteState	Status penghapusan sementara

SoftDeleteState

Enumerasi

Status penghapusan sementara

Nilai	Deskripsi
Off	Penghapusan Sementara dinonaktifkan untuk BackupVault
On	Penghapusan Sementara diaktifkan untuk BackupVault tetapi dapat dinonaktifkan
AlwaysOn	Penghapusan Sementara diaktifkan secara permanen untuk BackupVault dan pengaturan tidak dapat diubah

StorageSetting

Objek

Pengaturan penyimpanan

Nama	Jenis	Deskripsi
datastoreType	StorageSettingStoreTypes	Mendapatkan atau mengatur jenis datastore.
type	StorageSettingTypes	Mendapatkan atau mengatur jenisnya.

StorageSettingStoreTypes

Enumerasi

Mendapatkan atau mengatur jenis datastore.

Nilai	Deskripsi
ArchiveStore
OperationalStore
VaultStore

StorageSettingTypes

Enumerasi

Mendapatkan atau mengatur jenisnya.

Nilai	Deskripsi
GeoRedundant
LocallyRedundant
ZoneRedundant

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

UserAssignedIdentity

Objek

Properti identitas yang ditetapkan pengguna

Nama	Jenis	Deskripsi
clientId	string (uuid)	ID klien dari identitas yang ditetapkan.
principalId	string (uuid)	ID utama identitas yang ditetapkan.