Recovery Points - List

Layanan:

Data Protection

Versi API:

2026-06-01

Mengembalikan daftar Titik Pemulihan untuk DataSource dalam vault.

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

Dengan parameter opsional:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}/recoveryPoints?api-version=2026-06-01&$filter={$filter}&$skipToken={$skipToken}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
backupInstanceName	path	True	string	Nama instans cadangan.
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.
vaultName	path	True	string	Nama vault cadangan.
api-version	query	True	string minLength: 1	Versi API yang akan digunakan untuk operasi ini.
$filter	query		string	Opsi filter OData.
$skipToken	query		string	filter skipToken.

Respons

Nama	Jenis	Deskripsi
200 OK	AzureBackupRecoveryPointResourceList	Operasi Azure berhasil diselesaikan.
Other Status Codes	CloudError	Respons kesalahan yang tidak 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

List Recovery Points in a Vault

Permintaan sampel

HTTP

GET https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1/recoveryPoints?api-version=2026-06-01

Respon sampel

Kode status:

200

{
  "value": [
    {
      "name": "7fb2cddd-c5b3-44f6-a0d9-db3c4f9d5e35",
      "type": "microsoft.dataprotection/backupvaults/backupInstances/recoveryPoints",
      "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/HelloTest/providers/Microsoft.DataProtection/backupVaults/HelloTestVault/backupInstances/653213d-c5b3-44f6-a0d9-db3c4f9d8e34/recoveryPoints/7fb2cddd-c5b3-44f6-a0d9-db3c4f9d5f25",
      "properties": {
        "expiryTime": "2023-03-01T13:00:00Z",
        "friendlyName": "panbha4",
        "objectType": "AzureBackupDiscreteRecoveryPoint",
        "recoveryPointDataStoresDetails": [
          {
            "type": "Snapshot",
            "creationTime": "2019-03-01T13:00:00Z",
            "id": "0ff03512-b333-4509-a6c7-12164c8b1dce",
            "metaData": "123456"
          },
          {
            "type": "BackupStorage",
            "creationTime": "2019-03-01T13:00:00Z",
            "id": "5d8cfd30-722e-4bab-85f6-4a9d01ffc6f1",
            "metaData": "123456"
          }
        ],
        "recoveryPointState": "Completed",
        "recoveryPointTime": "2019-03-01T13:00:00Z",
        "recoveryPointType": "Full"
      }
    },
    {
      "name": "7fb2cddd-c5b3-44f6-a0d9-db3c4f9d5f25",
      "type": "microsoft.dataprotection/backupvaults/backupInstances/recoveryPoints",
      "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/HelloTest/providers/Microsoft.DataProtection/backupVaults/HelloTestVault/backupInstances/653213d-c5b3-44f6-a0d9-db3c4f9d8e34/recoveryPoints/7fb2cddd-c5b3-44f6-a0d9-db3c4f9d5f25",
      "properties": {
        "friendlyName": "panbha4",
        "objectType": "AzureBackupDiscreteRecoveryPoint",
        "recoveryPointDataStoresDetails": [
          {
            "type": "Snapshot",
            "creationTime": "2019-03-01T13:00:00Z",
            "id": "808cfd30-722e-4bab-85f6-4a9d01ffc6f2",
            "metaData": "123456"
          },
          {
            "type": "BackupStorage",
            "creationTime": "2019-03-01T13:00:00Z",
            "id": "798cfd30-722e-4bab-85f6-4a9d01ffc6f3",
            "metaData": "123456"
          }
        ],
        "recoveryPointState": "Completed",
        "recoveryPointTime": "2019-03-01T13:00:00Z",
        "recoveryPointType": "Full"
      }
    }
  ]
}

Definisi

Nama	Deskripsi
AzureBackupDiscreteRecoveryPoint	RecoveryPoint diskrit cadangan Azure
AzureBackupRecoveryPointResource	Sumber daya Azure backup recoveryPoint
AzureBackupRecoveryPointResourceList	Daftar sumber daya Azure backup recoveryPoint
CloudError	Respons kesalahan dari Azure Backup.
createdByType	Jenis identitas yang membuat sumber daya tersebut.
Error	Respons kesalahan manajemen sumber daya.
ErrorAdditionalInfo	Informasi tambahan tentang kesalahan pengelolaan sumber daya.
RecoveryPointCompletionState	Menentukan kelengkapan titik pemulihan. Parsial (yaitu, hanya beberapa item yang dimaksudkan yang dicadangkan), atau Selesai (yaitu, SEMUA item yang dimaksudkan yang dicadangkan).
RecoveryPointDataStoreDetails	Detail datastore RecoveryPoint
RehydrationStatus
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

AzureBackupDiscreteRecoveryPoint

Objek

RecoveryPoint diskrit cadangan Azure

Nama	Jenis	Deskripsi
expiryTime	string (date-time)
friendlyName	string
objectType	string: AzureBackupDiscreteRecoveryPoint
policyName	string
policyVersion	string
recoveryPointDataStoresDetails	RecoveryPointDataStoreDetails[]	Detail datastore RecoveryPoint
recoveryPointId	string
recoveryPointState	RecoveryPointCompletionState	Menentukan kelengkapan titik pemulihan. Parsial (yaitu, hanya beberapa item yang dimaksudkan yang dicadangkan), atau Selesai (yaitu, SEMUA item yang dimaksudkan yang dicadangkan).
recoveryPointTime	string (date-time)
recoveryPointType	string
retentionTagName	string
retentionTagVersion	string

AzureBackupRecoveryPointResource

Objek

Sumber daya Azure backup recoveryPoint

Nama	Jenis	Deskripsi
id	string (arm-id)	ID sumber daya lengkap untuk sumber daya tersebut. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nama sumber daya.
properties	AzureBackupRecoveryPoint: AzureBackupDiscreteRecoveryPoint	Properti AzureBackupRecoveryPointResource
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

AzureBackupRecoveryPointResourceList

Objek

Daftar sumber daya Azure backup recoveryPoint

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

CloudError

Objek

Respons kesalahan dari Azure Backup.

Nama	Jenis	Deskripsi
error	Error	Respons kesalahan manajemen sumber daya.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya tersebut.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

Error

Objek

Respons kesalahan manajemen sumber daya.

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

ErrorAdditionalInfo

Objek

Informasi tambahan tentang kesalahan pengelolaan sumber daya.

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

RecoveryPointCompletionState

Enumerasi

Menentukan kelengkapan titik pemulihan. Parsial (yaitu, hanya beberapa item yang dimaksudkan yang dicadangkan), atau Selesai (yaitu, SEMUA item yang dimaksudkan yang dicadangkan).

Nilai	Deskripsi
Completed
Partial

RecoveryPointDataStoreDetails

Objek

Detail datastore RecoveryPoint

Nama	Jenis	Deskripsi
creationTime	string (date-time)
expiryTime	string (date-time)
id	string
metaData	string
rehydrationExpiryTime	string (date-time)
rehydrationStatus	RehydrationStatus
state	string
type	string
visible	boolean

RehydrationStatus

Enumerasi

Nilai	Deskripsi
CREATE_IN_PROGRESS
COMPLETED
DELETE_IN_PROGRESS
DELETED
FAILED

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 tersebut.
createdByType	createdByType	Jenis identitas yang membuat sumber daya tersebut.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir kali mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.