Deleted Backup Vaults - List By Location

服務:: Data Protection

API 版本:: 2026-03-01

依位置列出已刪除的備份保存庫

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DataProtection/locations/{location}/deletedVaults?api-version=2026-03-01

URI 參數

名稱	位於	必要	類型	Description
location	path	True	string minLength: 1	Azure 區域的名稱。
subscriptionId	path	True	string (uuid)	目標訂用帳戶的標識碼。此值必須是 UUID。
api-version	query	True	string minLength: 1	用於此作業的 API 版本。

回應

名稱	類型	Description
200 OK	DeletedBackupVaultResourceListResult	Azure 運作順利完成。
Other Status Codes	ErrorResponse	未預期的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

List deleted backup vaults by location

範例要求

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.DataProtection/locations/westus/deletedVaults?api-version=2026-03-01

範例回覆

狀態碼:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.DataProtection/locations/westus/deletedBackupVaults/deleted-vault-01",
      "name": "deleted-vault-01",
      "type": "Microsoft.DataProtection/deletedBackupVaults",
      "properties": {
        "originalBackupVaultId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.DataProtection/backupVaults/sample-vault",
        "originalBackupVaultName": "sample-vault",
        "originalBackupVaultResourcePath": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.DataProtection/backupVaults/sample-vault",
        "resourceDeletionInfo": {
          "deletionTime": "2025-09-18T10:00:00.000Z",
          "scheduledPurgeTime": "2025-10-18T10:00:00.000Z",
          "deleteActivityId": "00000000-0000-0000-0000-000000000000"
        },
        "monitoringSettings": {
          "azureMonitorAlertSettings": {
            "alertsForAllJobFailures": "Enabled"
          }
        },
        "provisioningState": "Succeeded",
        "resourceMoveState": "Unknown",
        "securitySettings": {
          "softDeleteSettings": {
            "state": "On",
            "retentionDurationInDays": 14
          },
          "immutabilitySettings": {
            "state": "Disabled"
          }
        },
        "storageSettings": [
          {
            "datastoreType": "VaultStore",
            "type": "LocallyRedundant"
          }
        ],
        "isVaultProtectedByResourceGuard": false,
        "featureSettings": {
          "crossSubscriptionRestoreSettings": {
            "state": "Disabled"
          },
          "crossRegionRestoreSettings": {
            "state": "Disabled"
          }
        },
        "secureScore": "Maximum",
        "resourceGuardOperationRequests": [],
        "replicatedRegions": []
      }
    }
  ]
}

定義

名稱	Description
AlertsState
AzureMonitorAlertSettings	Azure 監視器型警示的設定
BCDRSecurityLevel	備份保存庫的安全性層級
CmkKekIdentity	CMK 所使用的受控識別詳細數據
CmkKeyVaultProperties	裝載 CMK 之 Key Vault 的屬性
createdByType	建立資源的身分識別類型。
CrossRegionRestoreSettings
CrossRegionRestoreState	CrossRegionRestore 狀態
CrossSubscriptionRestoreSettings	CrossSubscriptionRestore 設定
CrossSubscriptionRestoreState	CrossSubscriptionRestore 狀態
DeletedBackupVault	已刪除的備份保存庫 - 使用與 BackupVault 的組合和其他刪除中繼資料
DeletedBackupVaultResource	已刪除的備份保存庫資源（從 2025-09-01 版開始提供）
DeletedBackupVaultResourceListResult	DeletedBackupVaultResource 清單作業的回應。
encryptionSettings	客戶管理的資源金鑰詳細數據。
EncryptionState	備份保存庫的加密狀態。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
FeatureSettings	包含保存庫功能設定的類別
IdentityType	識別類型。 'SystemAssigned' 和 'UserAssigned' 互斥。 'SystemAssigned' 將使用隱含建立的受控識別。
ImmutabilitySettings	保存庫層級的不變性設定
ImmutabilityState	不變性狀態
InfrastructureEncryptionState	啟用/停用雙重加密狀態
MonitoringSettings	監視設定
ProvisioningState	BackupVault 資源的布建狀態
ResourceDeletionInfo	追蹤資源的刪除資訊（備份保存庫）
ResourceMoveDetails	ResourceMoveDetails 將會傳回，以回應ARM的 GetResource 呼叫
ResourceMoveState	備份保存庫的資源移動狀態
SecureScoreLevel	備份保存庫的安全分數
SecuritySettings	包含保存庫安全性設定的類別
SoftDeleteSettings	虛刪除相關設定
SoftDeleteState	虛刪除的狀態
StorageSetting	記憶體設定
StorageSettingStoreTypes	取得或設定數據存放區的型別。
StorageSettingTypes	取得或設定型別。
systemData	與建立和上次修改資源相關的元數據。

AlertsState

列舉型別

值	Description
Enabled
Disabled

AzureMonitorAlertSettings

Object

Azure 監視器型警示的設定

名稱	類型	Description
alertsForAllJobFailures	AlertsState

BCDRSecurityLevel

列舉型別

備份保存庫的安全性層級

值	Description
Poor
Fair
Good
Excellent
NotSupported

CmkKekIdentity

Object

CMK 所使用的受控識別詳細數據

名稱	類型	Description
identityId	string	要用來具有 Key Vault 訪問許可權的受控識別。請在這裡提供值，以防身分識別類型為：『UserAssigned』。
identityType	IdentityType	識別類型。 'SystemAssigned' 和 'UserAssigned' 互斥。 'SystemAssigned' 將使用隱含建立的受控識別。

CmkKeyVaultProperties

Object

裝載 CMK 之 Key Vault 的屬性

名稱	類型	Description
keyUri	string	客戶管理金鑰的金鑰 URI

createdByType

列舉型別

建立資源的身分識別類型。

值	Description
User
Application
ManagedIdentity
Key

CrossRegionRestoreSettings

Object

名稱	類型	Description
state	CrossRegionRestoreState	CrossRegionRestore 狀態

CrossRegionRestoreState

列舉型別

CrossRegionRestore 狀態

值	Description
Disabled
Enabled

CrossSubscriptionRestoreSettings

Object

CrossSubscriptionRestore 設定

名稱	類型	Description
state	CrossSubscriptionRestoreState	CrossSubscriptionRestore 狀態

CrossSubscriptionRestoreState

列舉型別

CrossSubscriptionRestore 狀態

值	Description
Disabled
PermanentlyDisabled
Enabled

DeletedBackupVault

Object

已刪除的備份保存庫 - 使用與 BackupVault 的組合和其他刪除中繼資料

名稱	類型	Description
bcdrSecurityLevel	BCDRSecurityLevel	備份保存庫的安全性層級
featureSettings	FeatureSettings	功能設定
isVaultProtectedByResourceGuard	boolean	是否受資源防護保護的保存庫
monitoringSettings	MonitoringSettings	監視設定
originalBackupVaultId	string	原始備份保存庫的資源識別碼
originalBackupVaultName	string	原始備份保存庫的資源名稱
originalBackupVaultResourcePath	string	原始備份保存庫的資源路徑
provisioningState	ProvisioningState	BackupVault 資源的布建狀態
replicatedRegions	string[]	備份保存庫的複寫區域清單
resourceDeletionInfo	ResourceDeletionInfo	追蹤資源的刪除資訊（備份保存庫）
resourceGuardOperationRequests	string[]	將執行 LAC 檢查的 ResourceGuardOperationRequests
resourceMoveDetails	ResourceMoveDetails	備份保存庫的資源移動詳細數據
resourceMoveState	ResourceMoveState	備份保存庫的資源移動狀態
secureScore	SecureScoreLevel	備份保存庫的安全分數
securitySettings	SecuritySettings	安全性設定
storageSettings	StorageSetting[]	記憶體設定

DeletedBackupVaultResource

Object

已刪除的備份保存庫資源（從 2025-09-01 版開始提供）

名稱	類型	Description
id	string (arm-id)	資源的完整資源標識碼。例如，“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
name	string	資源的名稱
properties	DeletedBackupVault	此資源的資源特定屬性。
systemData	systemData	包含 createdBy 和 modifiedBy 資訊的 Azure Resource Manager 元數據。
type	string	資源的類型。例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

DeletedBackupVaultResourceListResult

Object

DeletedBackupVaultResource 清單作業的回應。

名稱	類型	Description
nextLink	string (uri)	專案下一頁的連結
value	DeletedBackupVaultResource[]	此頁面上的 DeletedBackupVaultResource 專案

encryptionSettings

Object

客戶管理的資源金鑰詳細數據。

名稱	類型	Description
infrastructureEncryption	InfrastructureEncryptionState	啟用/停用雙重加密狀態
kekIdentity	CmkKekIdentity	CMK 所使用的受控識別詳細數據
keyVaultProperties	CmkKeyVaultProperties	裝載 CMK 之 Key Vault 的屬性
state	EncryptionState	備份保存庫的加密狀態。

EncryptionState

列舉型別

備份保存庫的加密狀態。

值	Description
Enabled	備份保存庫上已啟用 CMK 加密
Disabled	備份保存庫上已停用CMK加密。一旦加密狀態為「已啟用」，用戶就無法設定此狀態。
Inconsistent	備份保存庫上的 CMK 加密狀態不一致。此狀態表示用戶必須立即重試加密設定作業，以更正狀態。

ErrorAdditionalInfo

Object

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

Object

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳情
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

Object

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

FeatureSettings

Object

包含保存庫功能設定的類別

名稱	類型	Description
crossRegionRestoreSettings	CrossRegionRestoreSettings
crossSubscriptionRestoreSettings	CrossSubscriptionRestoreSettings	CrossSubscriptionRestore 設定

IdentityType

列舉型別

識別類型。 'SystemAssigned' 和 'UserAssigned' 互斥。 'SystemAssigned' 將使用隱含建立的受控識別。

值	Description
SystemAssigned
UserAssigned

ImmutabilitySettings

Object

保存庫層級的不變性設定

名稱	類型	Description
state	ImmutabilityState	不變性狀態

ImmutabilityState

列舉型別

不變性狀態

值	Description
Disabled
Unlocked
Locked

InfrastructureEncryptionState

列舉型別

啟用/停用雙重加密狀態

值	Description
Enabled
Disabled

MonitoringSettings

Object

監視設定

名稱	類型	Description
azureMonitorAlertSettings	AzureMonitorAlertSettings	Azure 監視器型警示的設定

ProvisioningState

列舉型別

BackupVault 資源的布建狀態

值	Description
Failed
Provisioning
Succeeded
Unknown
Updating

ResourceDeletionInfo

Object

追蹤資源的刪除資訊（備份保存庫）

名稱	類型	Description
deleteActivityId	string	刪除活動識別碼，以疑難排解刪除追蹤資源
deletionTime	string (date-time)	指定追蹤資源的刪除時間（備份保存庫）
scheduledPurgeTime	string (date-time)	指定追蹤資源的排程清除時間（備份保存庫）

ResourceMoveDetails

Object

ResourceMoveDetails 將會傳回，以回應ARM的 GetResource 呼叫

名稱	類型	Description
completionTimeUtc	string	已嘗試最新 ResourceMove 作業 UTC 的完成時間。 ISO 8601 格式。
operationId	string	已嘗試的最新 ResourceMove 作業 CorrelationId
sourceResourcePath	string	來源資源的 ARM 資源路徑
startTimeUtc	string	嘗試最新 ResourceMove 作業 UTC 的開始時間。 ISO 8601 格式。
targetResourcePath	string	最新 ResourceMove 作業中使用的目標資源的 ARM 資源路徑

ResourceMoveState

列舉型別

備份保存庫的資源移動狀態

值	Description
Unknown
InProgress
PrepareFailed
CommitFailed
Failed
PrepareTimedout
CommitTimedout
CriticalFailure
PartialSuccess
MoveSucceeded

SecureScoreLevel

列舉型別

備份保存庫的安全分數

值	Description
None
Minimum
Adequate
Maximum
NotSupported

SecuritySettings

Object

包含保存庫安全性設定的類別

名稱	類型	Description
encryptionSettings	encryptionSettings	客戶管理的資源金鑰詳細數據。
immutabilitySettings	ImmutabilitySettings	保存庫層級的不變性設定
softDeleteSettings	SoftDeleteSettings	虛刪除相關設定

SoftDeleteSettings

Object

虛刪除相關設定

名稱	類型	Description
retentionDurationInDays	number (double)	虛刪除保留期間
state	SoftDeleteState	虛刪除的狀態

SoftDeleteState

列舉型別

虛刪除的狀態

值	Description
Off	已關閉BackupVault的虛刪除
On	虛刪除已啟用BackupVault，但可以關閉
AlwaysOn	已永久啟用BackupVault的虛刪除，且無法變更設定

StorageSetting

Object

記憶體設定

名稱	類型	Description
datastoreType	StorageSettingStoreTypes	取得或設定數據存放區的型別。
type	StorageSettingTypes	取得或設定型別。

StorageSettingStoreTypes

列舉型別

取得或設定數據存放區的型別。

值	Description
ArchiveStore
OperationalStore
VaultStore

StorageSettingTypes

列舉型別

取得或設定型別。

值	Description
GeoRedundant
LocallyRedundant
ZoneRedundant

systemData

Object

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string (date-time)	資源建立的時間戳（UTC）。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string (date-time)	上次修改的資源時間戳（UTC）
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

共用方式為

Deleted Backup Vaults - List By Location

URI 參數

回應

安全性

azure_auth

範圍

範例

List deleted backup vaults by location

範例要求

範例回覆

定義

AlertsState

AzureMonitorAlertSettings

BCDRSecurityLevel

CmkKekIdentity

CmkKeyVaultProperties

createdByType

CrossRegionRestoreSettings

CrossRegionRestoreState

CrossSubscriptionRestoreSettings

CrossSubscriptionRestoreState

DeletedBackupVault

DeletedBackupVaultResource

DeletedBackupVaultResourceListResult

encryptionSettings

EncryptionState

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FeatureSettings

IdentityType

ImmutabilitySettings

ImmutabilityState

InfrastructureEncryptionState

MonitoringSettings

ProvisioningState

ResourceDeletionInfo

ResourceMoveDetails

ResourceMoveState

SecureScoreLevel

SecuritySettings

SoftDeleteSettings

SoftDeleteState

StorageSetting

StorageSettingStoreTypes

StorageSettingTypes

systemData