ListRecoveryPointsByResource - AWS Backup
Sintaks PermintaanURIParameter PermintaanIsi PermintaanSintaks ResponsElemen ResponsKesalahanLihat Juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

ListRecoveryPointsByResource

Informasi tentang titik pemulihan dari jenis yang ditentukan oleh sumber daya Amazon Resource Name (ARN).

catatan

Untuk Amazon EFS dan AmazonEC2, tindakan ini hanya mencantumkan titik pemulihan yang dibuat oleh AWS Backup.

Sintaks Permintaan

GET /resources/resourceArn/recovery-points/?managedByAWSBackupOnly=ManagedByAWSBackupOnly&maxResults=MaxResults&nextToken=NextToken HTTP/1.1

URIParameter Permintaan

Permintaan menggunakan URI parameter berikut.

ManagedByAWSBackupOnly

Atribut ini memfilter titik pemulihan berdasarkan kepemilikan.

Jika ini diatur keTRUE, respons akan berisi titik pemulihan yang terkait dengan sumber daya yang dipilih yang dikelola oleh AWS Backup.

Jika ini diatur keFALSE, respons akan berisi semua titik pemulihan yang terkait dengan sumber daya yang dipilih.

Jenis: Boolean

MaxResults

Jumlah maksimum item yang akan dikembalikan.

catatan

Amazon RDS membutuhkan nilai minimal 20.

Rentang yang Valid: Nilai minimum 1. Nilai maksimum 1000.

NextToken

Item berikutnya mengikuti sebagian daftar item yang dikembalikan. Misalnya, jika permintaan dibuat untuk mengembalikan MaxResults jumlah item, NextToken memungkinkan Anda mengembalikan lebih banyak item dalam daftar Anda mulai dari lokasi yang ditunjukkan oleh token berikutnya.

resourceArn

An ARN yang secara unik mengidentifikasi sumber daya. Format ARN tergantung pada jenis sumber daya.

Wajib: Ya

Isi Permintaan

Permintaan tidak memiliki isi permintaan.

Sintaks Respons

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RecoveryPoints": [ 
      { 
         "BackupSizeBytes": number,
         "BackupVaultName": "string",
         "CreationDate": number,
         "EncryptionKeyArn": "string",
         "IsParent": boolean,
         "ParentRecoveryPointArn": "string",
         "RecoveryPointArn": "string",
         "ResourceName": "string",
         "Status": "string",
         "StatusMessage": "string",
         "VaultType": "string"
      }
   ]
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Data berikut dikembalikan dalam JSON format oleh layanan.

NextToken

Item berikutnya mengikuti sebagian daftar item yang dikembalikan. Misalnya, jika permintaan dibuat untuk mengembalikan MaxResults jumlah item, NextToken memungkinkan Anda mengembalikan lebih banyak item dalam daftar Anda mulai dari lokasi yang ditunjukkan oleh token berikutnya.

Tipe: String

RecoveryPoints

Array objek yang berisi informasi rinci tentang titik pemulihan dari jenis sumber daya yang ditentukan.

catatan

Hanya poin EC2 pemulihan Amazon EFS dan Amazon yang kembali BackupVaultName.

Tipe: Array objek RecoveryPointByResource

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

InvalidParameterValueException

Menunjukkan bahwa ada sesuatu yang salah dengan nilai parameter. Misalnya, nilainya di luar jangkauan.

HTTPKode Status: 400

MissingParameterValueException

Menunjukkan bahwa parameter yang diperlukan tidak ada.

HTTPKode Status: 400

ResourceNotFoundException

Sumber daya yang diperlukan untuk tindakan tidak ada.

HTTPKode Status: 400

ServiceUnavailableException

Permintaan gagal karena kegagalan sementara server.

HTTPKode Status: 500

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini: