ListRecoveryPointsByBackupVault - AWS Backup
Minta SintaksParameter Permintaan URIIsi PermintaanSintaks ResponsElemen ResponsKesalahanLihat Juga

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

ListRecoveryPointsByBackupVault

Mengembalikan informasi rinci tentang titik pemulihan yang disimpan dalam brankas cadangan.

Minta Sintaks

GET /backup-vaults/backupVaultName/recovery-points/?backupPlanId=ByBackupPlanId&backupVaultAccountId=BackupVaultAccountId&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&maxResults=MaxResults&nextToken=NextToken&parentRecoveryPointArn=ByParentRecoveryPointArn&resourceArn=ByResourceArn&resourceType=ByResourceType HTTP/1.1

Parameter Permintaan URI

Permintaan menggunakan parameter URI berikut.

BackupVaultAccountId

Parameter ini akan mengurutkan daftar titik pemulihan berdasarkan ID akun.

Pola: ^[0-9]{12}$

backupVaultName

Nama kontainer logis tempat cadangan disimpan. Vault cadangan diidentifikasi berdasarkan nama yang unik untuk akun yang digunakan untuk membuatnya dan Wilayah AWS tempatnya dibuat.

catatan

Nama brankas cadangan mungkin tidak tersedia saat layanan yang didukung membuat cadangan.

Pola: ^[a-zA-Z0-9\-\_]{2,50}$

Wajib: Ya

ByBackupPlanId

Mengembalikan hanya titik pemulihan yang cocok dengan ID rencana cadangan yang ditentukan.

ByCreatedAfter

Mengembalikan hanya titik pemulihan yang dibuat setelah stempel waktu yang ditentukan.

ByCreatedBefore

Mengembalikan hanya titik pemulihan yang dibuat sebelum stempel waktu yang ditentukan.

ByParentRecoveryPointArn

Ini hanya mengembalikan titik pemulihan yang cocok dengan titik pemulihan induk (komposit) yang ditentukan Amazon Resource Name (ARN).

ByResourceArn

Mengembalikan hanya titik pemulihan yang cocok dengan sumber daya yang ditentukan Amazon Resource Name (ARN).

ByResourceType

Mengembalikan hanya titik pemulihan yang cocok dengan jenis sumber daya tertentu:

  • Aurorauntuk Amazon Aurora

  • CloudFormationuntuk AWS CloudFormation

  • DocumentDBuntuk Amazon DocumentDB (dengan kompatibilitas MongoDB)

  • DynamoDBuntuk Amazon DynamoDB

  • EBSuntuk Amazon Elastic Block Store

  • EC2untuk Amazon Elastic Compute Cloud

  • EFSuntuk Amazon Elastic File System

  • FSxuntuk Amazon FSx

  • Neptuneuntuk Amazon Neptunus

  • RDSuntuk Amazon Relational Database Service

  • Redshiftuntuk Amazon Redshift

  • S3untuk Amazon Simple Storage Service (Amazon S3)

  • SAP HANA on Amazon EC2untuk database SAP HANA pada instans Amazon Elastic Compute Cloud

  • Storage Gatewayuntuk AWS Storage Gateway

  • Timestreamuntuk Amazon Timestream

  • VirtualMachineuntuk mesin VMware virtual

Pola: ^[a-zA-Z0-9\-\_\.]{1,50}$

MaxResults

Jumlah maksimum item yang akan dikembalikan.

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.

Isi Permintaan

Permintaan tidak memiliki isi permintaan.

Sintaks Respons

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "RecoveryPoints": [ 
      { 
         "BackupSizeInBytes": number,
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "CalculatedLifecycle": { 
            "DeleteAt": number,
            "MoveToColdStorageAt": number
         },
         "CompletionDate": number,
         "CompositeMemberIdentifier": "string",
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanVersion": "string",
            "BackupRuleId": "string"
         },
         "CreationDate": number,
         "EncryptionKeyArn": "string",
         "IamRoleArn": "string",
         "IndexStatus": "string",
         "IndexStatusMessage": "string",
         "InitiationDate": number,
         "IsEncrypted": boolean,
         "IsParent": boolean,
         "LastRestoreTime": number,
         "Lifecycle": { 
            "DeleteAfterDays": number,
            "MoveToColdStorageAfterDays": number,
            "OptInToArchiveForSupportedResources": boolean
         },
         "ParentRecoveryPointArn": "string",
         "RecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string",
         "SourceBackupVaultArn": "string",
         "Status": "string",
         "StatusMessage": "string",
         "VaultType": "string"
      }
   ]
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

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 yang disimpan di brankas cadangan.

Tipe: Array objek RecoveryPointByBackupVault

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.

Context

Type

Kode Status HTTP: 400

MissingParameterValueException

Menunjukkan bahwa parameter yang diperlukan tidak ada.

Context

Type

Kode Status HTTP: 400

ResourceNotFoundException

Sumber daya yang diperlukan untuk tindakan tidak ada.

Context

Type

Kode Status HTTP: 400

ServiceUnavailableException

Permintaan gagal karena kegagalan sementara server.

Context

Type

Kode Status HTTP: 500

Lihat Juga

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