Recovery Points - List

參考

服務:: Recovery Services - Backup

API 版本:: 2024-10-01

列出備份項目的備份複本。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/recoveryPoints?api-version=2024-10-01

含選擇性參數:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/recoveryPoints?api-version=2024-10-01&$filter={$filter}

URI 參數

名稱	位於	必要	類型	Description
containerName	path	True	string	與備份專案相關聯的容器名稱。
fabricName	path	True	string	與備份專案相關聯的網狀架構名稱。
protectedItemName	path	True	string	要擷取備份複本的備份專案。
resourceGroupName	path	True	string	復原服務保存庫所在的資源群組名稱。
subscriptionId	path	True	string	訂用帳戶標識碼。
vaultName	path	True	string	復原服務保存庫的名稱。
api-version	query	True	string	用戶端 API 版本。
$filter	query		string	OData 篩選選項。

回應

名稱	類型	Description
200 OK	RecoveryPointResourceList	還行
Other Status Codes	CloudError	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

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

範圍

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

範例

Get Protected Azure Vm Recovery Points

範例要求

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rshhtestmdvmrg/providers/Microsoft.RecoveryServices/vaults/rshvault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall/protectedItems/VM;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall/recoveryPoints?api-version=2024-10-01

範例回覆

狀態碼:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rshhtestmdvmrg/providers/Microsoft.RecoveryServices/vaults/rshvault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall/protectedItems/VM;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall/recoveryPoints/22244821112382",
      "name": "22244821112382",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
      "properties": {
        "objectType": "IaasVMRecoveryPoint",
        "recoveryPointType": "CrashConsistent",
        "recoveryPointTime": "2017-12-21T22:48:25.4353958Z",
        "recoveryPointAdditionalInfo": "",
        "sourceVMStorageType": "NormalStorage",
        "isSourceVMEncrypted": false,
        "isInstantIlrSessionActive": false,
        "recoveryPointTierDetails": [
          {
            "type": "InstantRP",
            "status": "Deleted"
          },
          {
            "type": "HardenedRP",
            "status": "Valid"
          }
        ],
        "recoveryPointMoveReadinessInfo": {
          "Archive": {
            "isReadyForMove": true
          }
        },
        "isManagedVirtualMachine": true,
        "virtualMachineSize": "Standard_D1",
        "originalStorageAccountOption": false
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rshhtestmdvmrg/providers/Microsoft.RecoveryServices/vaults/rshvault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall/protectedItems/VM;iaasvmcontainerv2;rshhtestmdvmrg;rshmdvmsmall/recoveryPoints/24977149827250",
      "name": "24977149827250",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
      "properties": {
        "objectType": "IaasVMRecoveryPoint",
        "recoveryPointType": "CrashConsistent",
        "recoveryPointTime": "2017-12-20T22:49:44.3317945Z",
        "recoveryPointAdditionalInfo": "",
        "sourceVMStorageType": "NormalStorage",
        "isSourceVMEncrypted": false,
        "isInstantIlrSessionActive": false,
        "recoveryPointTierDetails": [
          {
            "type": "InstantRP",
            "status": "Deleted"
          },
          {
            "type": "HardenedRP",
            "status": "Deleted"
          },
          {
            "type": "ArchivedRP",
            "status": "Rehydrated",
            "extendedInfo": {
              "RehydratedRPExpiryTime": "2020-12-21T22:48:25.4353958Z"
            }
          }
        ],
        "recoveryPointMoveReadinessInfo": {
          "ArchivedRP": {
            "isReadyForMove": false,
            "additionalInfo": "Recovery point cannot be moved to archive tier since it has already been moved."
          }
        },
        "isManagedVirtualMachine": true,
        "virtualMachineSize": "Standard_D1",
        "originalStorageAccountOption": false,
        "zones": [
          "1"
        ],
        "isPrivateAccessEnabledOnAnyDisk": true
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/FijiValidation-asr-microsoftrrdclab3-408/providers/Microsoft.RecoveryServices/vaults/testVault408/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;fijivalidation-asr-microsoftrrdclab3-408;vm408/protectedItems/VM;iaasvmcontainerv2;fijivalidation-asr-microsoftrrdclab3-408;vm408/recoveryPoints/70477518625276",
      "name": "70477518625276",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
      "properties": {
        "objectType": "IaasVMRecoveryPoint",
        "recoveryPointType": "CrashConsistent",
        "recoveryPointTime": "2023-09-22T20:02:00.1225746Z",
        "recoveryPointAdditionalInfo": "",
        "sourceVMStorageType": "PremiumVMOnPartialPremiumStorage",
        "isSourceVMEncrypted": true,
        "isInstantIlrSessionActive": false,
        "recoveryPointTierDetails": [
          {
            "type": "InstantRP",
            "status": "Valid"
          },
          {
            "type": "HardenedRP",
            "status": "Valid"
          }
        ],
        "isManagedVirtualMachine": true,
        "virtualMachineSize": "Standard_D2s_v3",
        "originalStorageAccountOption": false,
        "osType": "Windows",
        "recoveryPointMoveReadinessInfo": {
          "ArchivedRP": {
            "isReadyForMove": false,
            "additionalInfo": "We're still determining if this Recovery Point can be moved.. Please check again after some time."
          }
        },
        "extendedLocation": {
          "name": "microsoftrrdclab3",
          "type": "EdgeZone"
        },
        "securityType": "None",
        "isPrivateAccessEnabledOnAnyDisk": false
      }
    }
  ],
  "nextLink": null
}

定義

名稱	Description
AzureFileShareRecoveryPoint	Azure 檔案共用工作負載特定的備份複本。
AzureWorkloadPointInTimeRecoveryPoint	PointInTime 特有的恢復點
AzureWorkloadRecoveryPoint	工作負載特定恢復點，特別封裝完整/差異恢復點
AzureWorkloadSAPHanaPointInTimeRecoveryPoint	SAPHana 中 PointInTime 特有的恢復點
AzureWorkloadSAPHanaRecoveryPoint	SAPHana 特定的恢復點，特別封裝完整/差異恢復點
AzureWorkloadSQLPointInTimeRecoveryPoint	PointInTime 特有的恢復點
AzureWorkloadSQLRecoveryPoint	SQL 特定恢復點，特別封裝完整/差異恢復點以及擴充資訊
AzureWorkloadSQLRecoveryPointExtendedInfo	擴充資訊類別詳細數據
BEKDetails	BEK 是 bitlocker 加密金鑰。
CloudError	來自容器實例服務的錯誤回應。
CloudErrorBody	來自容器實例服務的錯誤回應。
DiskInformation	磁碟資訊
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ExtendedLocation	VM 所在的恢復點擴充位置。
GenericRecoveryPoint	一般備份複本。
IaasVMRecoveryPoint	IaaS VM 工作負載特定的備份複本。
KEKDetails	KEK 是 BEK 的加密金鑰。
KeyAndSecretDetails	BEK 是 bitlocker 金鑰。 KEK 是 BEK 的加密金鑰如果 VM 已加密，則我們將儲存下列詳細資料： Secret（BEK） - URL + 備份數據 + vaultId。 Key（KEK） - URL + 備份數據 + vaultId。 EncryptionMechanism BEK 和 KEK 可能會有不同的保存庫標識碼。
PointInTimeRange	提供記錄範圍的詳細數據
RecoveryPointDiskConfiguration	磁碟設定
RecoveryPointMoveReadinessInfo
RecoveryPointProperties	恢復點的屬性
RecoveryPointResource	備份複本的基類。工作負載特定的備份復本衍生自這個類別。
RecoveryPointResourceList	RecoveryPoint 資源清單
RecoveryPointTierInformationV2	RecoveryPoint 層資訊 V2
RecoveryPointTierStatus	恢復點層狀態。
RecoveryPointTierType	恢復點層類型。
RestorePointType	還原點的類型
SQLDataDirectory	SQLDataDirectory 資訊
SQLDataDirectoryType	數據目錄對應的類型

AzureFileShareRecoveryPoint

Azure 檔案共用工作負載特定的備份複本。

名稱	類型	Description
fileShareSnapshotUri	string	如果適用，則包含檔案共用快照集的URL
objectType	string: AzureFileShareRecoveryPoint	這個屬性將做為決定型別多型鏈結中特定類型的歧視性。
recoveryPointProperties	RecoveryPointProperties	恢復點的屬性
recoveryPointSizeInGB	integer	包含恢復點大小
recoveryPointTime	string	建立此備份複本的時間。
recoveryPointType	string	備份複本的類型。指定它是當機時一致的備份或應用程式一致。

AzureWorkloadPointInTimeRecoveryPoint

PointInTime 特有的恢復點

名稱	類型	Description
objectType	string: AzureWorkloadPointInTimeRecoveryPoint	這個屬性將做為決定型別多型鏈結中特定類型的歧視性。
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	要移至另一層的 RP 資格
recoveryPointProperties	RecoveryPointProperties	恢復點的屬性
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	恢復點層資訊。
recoveryPointTimeInUTC	string	建立恢復點的 UTC 時間
timeRanges	PointInTimeRange[]	記錄範圍清單
type	RestorePointType	還原點的類型

AzureWorkloadRecoveryPoint

工作負載特定恢復點，特別封裝完整/差異恢復點

名稱	類型	Description
objectType	string: AzureWorkloadRecoveryPoint	這個屬性將做為決定型別多型鏈結中特定類型的歧視性。
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	要移至另一層的 RP 資格
recoveryPointProperties	RecoveryPointProperties	恢復點的屬性
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	恢復點層資訊。
recoveryPointTimeInUTC	string	建立恢復點的 UTC 時間
type	RestorePointType	還原點的類型

AzureWorkloadSAPHanaPointInTimeRecoveryPoint

SAPHana 中 PointInTime 特有的恢復點

名稱	類型	Description
objectType	string: AzureWorkloadSAPHanaPointInTimeRecoveryPoint	這個屬性將做為決定型別多型鏈結中特定類型的歧視性。
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	要移至另一層的 RP 資格
recoveryPointProperties	RecoveryPointProperties	恢復點的屬性
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	恢復點層資訊。
recoveryPointTimeInUTC	string	建立恢復點的 UTC 時間
timeRanges	PointInTimeRange[]	記錄範圍清單
type	RestorePointType	還原點的類型

AzureWorkloadSAPHanaRecoveryPoint

SAPHana 特定的恢復點，特別封裝完整/差異恢復點

名稱	類型	Description
objectType	string: AzureWorkloadSAPHanaRecoveryPoint	這個屬性將做為決定型別多型鏈結中特定類型的歧視性。
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	要移至另一層的 RP 資格
recoveryPointProperties	RecoveryPointProperties	恢復點的屬性
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	恢復點層資訊。
recoveryPointTimeInUTC	string	建立恢復點的 UTC 時間
type	RestorePointType	還原點的類型

AzureWorkloadSQLPointInTimeRecoveryPoint

PointInTime 特有的恢復點

名稱	類型	Description
extendedInfo	AzureWorkloadSQLRecoveryPointExtendedInfo	提供資料目錄詳細數據的擴充資訊。會在兩種情況下填入：當使用 GetRecoveryPoint 存取特定恢復點時，或當 ListRecoveryPoints 僅使用 ExtendedInfo 查詢篩選來呼叫 Log RP 時
objectType	string: AzureWorkloadSQLPointInTimeRecoveryPoint	這個屬性將做為決定型別多型鏈結中特定類型的歧視性。
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	要移至另一層的 RP 資格
recoveryPointProperties	RecoveryPointProperties	恢復點的屬性
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	恢復點層資訊。
recoveryPointTimeInUTC	string	建立恢復點的 UTC 時間
timeRanges	PointInTimeRange[]	記錄範圍清單
type	RestorePointType	還原點的類型

AzureWorkloadSQLRecoveryPoint

SQL 特定恢復點，特別封裝完整/差異恢復點以及擴充資訊

名稱	類型	Description
extendedInfo	AzureWorkloadSQLRecoveryPointExtendedInfo	提供資料目錄詳細數據的擴充資訊。會在兩種情況下填入：當使用 GetRecoveryPoint 存取特定恢復點時，或當 ListRecoveryPoints 僅使用 ExtendedInfo 查詢篩選來呼叫 Log RP 時
objectType	string: AzureWorkloadSQLRecoveryPoint	這個屬性將做為決定型別多型鏈結中特定類型的歧視性。
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	要移至另一層的 RP 資格
recoveryPointProperties	RecoveryPointProperties	恢復點的屬性
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	恢復點層資訊。
recoveryPointTimeInUTC	string	建立恢復點的 UTC 時間
type	RestorePointType	還原點的類型

AzureWorkloadSQLRecoveryPointExtendedInfo

擴充資訊類別詳細數據

名稱	類型	Description
dataDirectoryPaths	SQLDataDirectory[]	還原作業期間的數據目錄路徑清單。
dataDirectoryTimeInUTC	string	擷取資料目錄資訊的 UTC 時間

BEKDetails

BEK 是 bitlocker 加密金鑰。

名稱	類型	Description
secretData	string	BEK 數據。
secretUrl	string	秘密為 BEK。
secretVaultId	string	儲存此秘密的 Key Vault 識別符。

CloudError

來自容器實例服務的錯誤回應。

名稱	類型	Description
error	CloudErrorBody	error 物件。

CloudErrorBody

來自容器實例服務的錯誤回應。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤的識別碼。程序代碼是不變的，而且是要以程序設計方式取用。
details	CloudErrorBody[]	錯誤的其他詳細數據清單。
message	string	描述錯誤的訊息，適用於在使用者介面中顯示。
target	string	特定錯誤的目標。例如，錯誤中的屬性名稱。

DiskInformation

磁碟資訊

名稱	類型	Description
lun	integer
name	string

ErrorAdditionalInfo

資源管理錯誤其他資訊。

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

ExtendedLocation

VM 所在的恢復點擴充位置。

名稱	類型	Description
name	string	擴充位置的名稱。
type	string	擴充位置的類型。可能的值包括：'EdgeZone'

GenericRecoveryPoint

一般備份複本。

名稱	類型	Description
friendlyName	string	備份複本的易記名稱。
objectType	string: GenericRecoveryPoint	這個屬性將做為決定型別多型鏈結中特定類型的歧視性。
recoveryPointAdditionalInfo	string	與此備份復本相關聯的其他資訊。
recoveryPointProperties	RecoveryPointProperties	恢復點的屬性
recoveryPointTime	string	建立此備份複本的時間。
recoveryPointType	string	備份複本的類型。

IaasVMRecoveryPoint

IaaS VM 工作負載特定的備份複本。

名稱	類型	Description
extendedLocation	ExtendedLocation	VM 恢復點的擴充位置，如果 VM 位於公用雲端，則應該是 Null
isInstantIlrSessionActive	boolean	這是從此備份復本復原專案的會話仍然作用中。
isManagedVirtualMachine	boolean	VM 是否具有受控磁碟
isPrivateAccessEnabledOnAnyDisk	boolean	此旗標表示 VM 中的任何磁碟是否使用私人存取網路設定
isSourceVMEncrypted	boolean	識別 VM 是否在建立備份複本時加密。
keyAndSecret	KeyAndSecretDetails	復原加密 VM 的必要詳細數據。僅適用於 IsSourceVMEncrypted 為 true 時。
objectType	string: IaasVMRecoveryPoint	這個屬性將做為決定型別多型鏈結中特定類型的歧視性。
originalStorageAccountOption	boolean	原始記憶體帳戶選項
osType	string	OS 類型
recoveryPointAdditionalInfo	string	與此備份復本相關聯的其他資訊。
recoveryPointDiskConfiguration	RecoveryPointDiskConfiguration	磁碟設定
recoveryPointMoveReadinessInfo	<string, RecoveryPointMoveReadinessInfo>	要移至另一層的 RP 資格
recoveryPointProperties	RecoveryPointProperties	恢復點的屬性
recoveryPointTierDetails	RecoveryPointTierInformationV2[]	恢復點層資訊。
recoveryPointTime	string	建立此備份複本的時間。
recoveryPointType	string	備份複本的類型。
securityType	string	磁碟的安全性類型
sourceVMStorageType	string	建立備份複本之 VM 的記憶體類型。
virtualMachineSize	string	虛擬機大小
zones	string[]	識別備份時 VM 的區域。僅適用於區域釘選的 Vm

KEKDetails

KEK 是 BEK 的加密金鑰。

名稱	類型	Description
keyBackupData	string	KEK 數據。
keyUrl	string	金鑰是 KEK。
keyVaultId	string	儲存此金鑰的 Key Vault 識別碼。

KeyAndSecretDetails

BEK 是 bitlocker 金鑰。 KEK 是 BEK 的加密金鑰如果 VM 已加密，則我們將儲存下列詳細資料：

Secret（BEK） - URL + 備份數據 + vaultId。
Key（KEK） - URL + 備份數據 + vaultId。
EncryptionMechanism BEK 和 KEK 可能會有不同的保存庫標識碼。

名稱	類型	Description
bekDetails	BEKDetails	BEK 是 bitlocker 加密金鑰。
encryptionMechanism	string	加密機制：None/SinglePass/DoublePass
kekDetails	KEKDetails	KEK 是 BEK 的加密金鑰。

PointInTimeRange

提供記錄範圍的詳細數據

名稱	類型	Description
endTime	string	記錄復原之時間範圍的結束時間。
startTime	string	記錄復原時間範圍的開始時間。

RecoveryPointDiskConfiguration

磁碟設定

名稱	類型	Description
excludedDiskList	DiskInformation[]	從備份排除的磁碟資訊
includedDiskList	DiskInformation[]	備份中包含的磁碟資訊
numberOfDisksAttachedToVm	integer	連結至 VM 的磁碟數目
numberOfDisksIncludedInBackup	integer	備份中包含的磁碟數目

RecoveryPointMoveReadinessInfo

名稱	類型	Description
additionalInfo	string
isReadyForMove	boolean

RecoveryPointProperties

恢復點的屬性

名稱	類型	Description
expiryTime	string	UTC 恢復點的到期時間。
isSoftDeleted	boolean	布爾值，指出 RP 是否處於虛刪除狀態
ruleName	string	在管理生命周期的恢復點上標記的規則名稱

RecoveryPointResource

備份複本的基類。工作負載特定的備份復本衍生自這個類別。

名稱	類型	Description
eTag	string	選擇性 ETag。
id	string	資源標識子代表資源的完整路徑。
location	string	資源位置。
name	string	與資源相關聯的資源名稱。
properties	RecoveryPoint: AzureFileShareRecoveryPoint AzureWorkloadPointInTimeRecoveryPoint AzureWorkloadRecoveryPoint AzureWorkloadSAPHanaPointInTimeRecoveryPoint AzureWorkloadSAPHanaRecoveryPoint AzureWorkloadSQLPointInTimeRecoveryPoint AzureWorkloadSQLRecoveryPoint GenericRecoveryPoint IaasVMRecoveryPoint	RecoveryPointResource 屬性
tags	object	資源標籤。
type	string	資源類型代表命名空間/ResourceType/ResourceType/... 格式的完整路徑。

RecoveryPointResourceList

RecoveryPoint 資源清單

名稱	類型	Description
nextLink	string	要擷取下一頁資源的 URI。呼叫 ListNext（）會擷取下一頁的資源。
value	RecoveryPointResource[]	資源清單。

RecoveryPointTierInformationV2

RecoveryPoint 層資訊 V2

名稱	類型	Description
extendedInfo	object	恢復點層狀態。
status	RecoveryPointTierStatus	恢復點層狀態。
type	RecoveryPointTierType	恢復點層類型。

RecoveryPointTierStatus

恢復點層狀態。

名稱	類型	Description
Deleted	string
Disabled	string
Invalid	string
Rehydrated	string
Valid	string

RecoveryPointTierType

恢復點層類型。

名稱	類型	Description
ArchivedRP	string
HardenedRP	string
InstantRP	string
Invalid	string

RestorePointType

還原點的類型

名稱	類型	Description
Differential	string
Full	string
Incremental	string
Invalid	string
Log	string
SnapshotCopyOnlyFull	string
SnapshotFull	string

SQLDataDirectory

SQLDataDirectory 資訊

名稱	類型	Description
logicalName	string	檔案的邏輯名稱
path	string	檔案路徑
type	SQLDataDirectoryType	數據目錄對應的類型

SQLDataDirectoryType

數據目錄對應的類型

名稱	類型	Description
Data	string
Invalid	string
Log	string

共用方式為