DescribeRecoveryPoint

Mengembalikan metadata yang terkait dengan titik pemulihan, termasuk ID, status, enkripsi, dan siklus hidup.

Sintaks Permintaan

GET /backup-vaults/backupVaultName/recovery-points/recoveryPointArn?backupVaultAccountId=BackupVaultAccountId HTTP/1.1

URIParameter Permintaan

Permintaan menggunakan URI parameter berikut.

BackupVaultAccountId

ID akun dari brankas cadangan yang ditentukan.

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.

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

Wajib: Ya

recoveryPointArn

Amazon Resource Name (ARN) yang secara unik mengidentifikasi titik pemulihan; misalnya,. arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45

Wajib: Ya

Isi Permintaan

Permintaan tidak memiliki isi permintaan.

Sintaks Respons

HTTP/1.1 200
Content-type: application/json

{
   "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",
   "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",
   "StorageClass": "string",
   "VaultType": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Data berikut dikembalikan dalam JSON format oleh layanan.

BackupSizeInBytes

Ukuran, dalam byte, cadangan.

Tipe: Long

BackupVaultArn

Sebuah ARN yang secara unik mengidentifikasi brankas cadangan; misalnya,. arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault

Tipe: String

BackupVaultName

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

Tipe: String

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

CalculatedLifecycle

Sebuah CalculatedLifecycle benda yang berisi DeleteAt dan MoveToColdStorageAt stempel waktu.

Tipe: Objek CalculatedLifecycle

CompletionDate

Tanggal dan waktu pekerjaan untuk membuat titik pemulihan selesai, dalam format Unix dan Waktu Universal Terkoordinasi ()UTC. Nilai akurat CompletionDate untuk milidetik. Misalnya, nilai 1516925490.087 mewakili Jumat, 26 Januari 2018 12:11:30.087.

Tipe: Timestamp

CompositeMemberIdentifier

Pengidentifikasi sumber daya dalam grup komposit, seperti titik pemulihan bersarang (anak) milik tumpukan komposit (induk). ID ditransfer dari ID logis dalam tumpukan.

Tipe: String

CreatedBy

Berisi informasi identifikasi tentang pembuatan titik pemulihan, termasukBackupPlanArn,BackupPlanId,BackupPlanVersion, dan BackupRuleId rencana cadangan yang digunakan untuk membuatnya.

Tipe: Objek RecoveryPointCreator

CreationDate

Tanggal dan waktu titik pemulihan dibuat, dalam format Unix dan Waktu Universal Terkoordinasi ()UTC. Nilai akurat CreationDate untuk milidetik. Misalnya, nilai 1516925490.087 mewakili Jumat, 26 Januari 2018 12:11:30.087.

Tipe: Timestamp

EncryptionKeyArn

Kunci enkripsi sisi server yang digunakan untuk melindungi cadangan Anda; misalnya,. arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

Tipe: String

IamRoleArn

Menentukan IAM peran yang ARN digunakan untuk membuat titik pemulihan target; misalnya,arn:aws:iam::123456789012:role/S3Access.

Tipe: String

IsEncrypted

Nilai Boolean yang dikembalikan TRUE seolah-olah titik pemulihan yang ditentukan dienkripsi, atau FALSE jika titik pemulihan tidak dienkripsi.

Jenis: Boolean

IsParent

Ini mengembalikan nilai boolean bahwa titik pemulihan adalah pekerjaan induk (komposit).

Jenis: Boolean

LastRestoreTime

Tanggal dan waktu dimana titik pemulihan terakhir dipulihkan, dalam format Unix dan Coordinated Universal Time ()UTC. Nilai akurat LastRestoreTime untuk milidetik. Misalnya, nilai 1516925490.087 mewakili Jumat, 26 Januari 2018 12:11:30.087.

Tipe: Timestamp

Lifecycle

Siklus hidup menentukan kapan sumber daya yang dilindungi dialihkan ke penyimpanan dingin dan kapan sumber daya tersebut kedaluwarsa. AWS Backup transisi dan kedaluwarsa backup secara otomatis sesuai dengan siklus hidup yang Anda tentukan.

Cadangan yang dialihkan ke cold storage harus disimpan dalam cold storage selama minimal 90 hari. Oleh karena itu, pengaturan “retensi” harus 90 hari lebih besar dari pengaturan “transisi ke dingin setelah hari”. Pengaturan “transisi ke dingin setelah hari” tidak dapat diubah setelah cadangan dialihkan ke dingin.

Jenis sumber daya yang dapat bertransisi ke penyimpanan dingin tercantum dalam tabel Ketersediaan fitur menurut sumber daya. AWS Backup mengabaikan ekspresi ini untuk jenis sumber daya lainnya.

Tipe: Objek Lifecycle

ParentRecoveryPointArn

Ini adalah ARN yang secara unik mengidentifikasi titik pemulihan induk (komposit); misalnya,. arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45

Tipe: String

RecoveryPointArn

An ARN yang secara unik mengidentifikasi titik pemulihan; misalnya,. arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45

Tipe: String

ResourceArn

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

Tipe: String

ResourceName

Nama sumber daya milik cadangan yang ditentukan.

Tipe: String

ResourceType

Jenis AWS sumber daya untuk disimpan sebagai titik pemulihan; misalnya, volume Amazon Elastic Block Store (AmazonEBS) atau database Amazon Relational Database Service (RDSAmazon).

Tipe: String

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

SourceBackupVaultArn

Amazon Resource Name (ARN) yang secara unik mengidentifikasi brankas sumber daya tempat sumber daya awalnya dicadangkan; misalnya,. arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault Jika pemulihan dikembalikan ke AWS akun atau Wilayah yang sama, nilai ini akan menjadinull.

Tipe: String

Status

Kode status yang menentukan keadaan titik pemulihan.

PARTIALstatus menunjukkan tidak AWS Backup dapat membuat titik pemulihan sebelum jendela cadangan ditutup. Untuk meningkatkan jendela paket cadangan Anda menggunakanAPI, lihat UpdateBackupPlan. Anda juga dapat meningkatkan jendela paket cadangan menggunakan Konsol dengan memilih dan mengedit paket cadangan Anda.

EXPIREDStatus menunjukkan bahwa titik pemulihan telah melebihi periode retensi, tetapi AWS Backup tidak memiliki izin atau tidak dapat menghapusnya. Untuk menghapus titik pemulihan ini secara manual, lihat Langkah 3: Hapus titik pemulihan di bagian Bersihkan sumber daya Memulai.

STOPPEDstatus terjadi pada pencadangan berkelanjutan di mana pengguna telah mengambil beberapa tindakan yang menyebabkan pencadangan berkelanjutan dinonaktifkan. Hal ini dapat disebabkan oleh penghapusan izin, mematikan versi, mematikan acara yang dikirim ke EventBridge, atau menonaktifkan EventBridge aturan yang diberlakukan oleh. AWS Backup Untuk titik pemulihan sumber daya Amazon S3RDS, Amazon, dan Amazon Aurora, status ini terjadi ketika periode retensi aturan pencadangan berkelanjutan diubah.

Untuk menyelesaikan STOPPED status, pastikan semua izin yang diminta sudah ada dan pembuatan versi diaktifkan di bucket S3. Setelah kondisi ini terpenuhi, contoh berikutnya dari aturan cadangan yang berjalan akan menghasilkan titik pemulihan berkelanjutan baru yang dibuat. Poin pemulihan dengan STOPPED status tidak perlu dihapus.

Untuk EC2 STOPPED status SAP HANA di Amazon terjadi karena tindakan pengguna, kesalahan konfigurasi aplikasi, atau kegagalan pencadangan. Untuk memastikan bahwa backup berkelanjutan masa depan berhasil, lihat status titik pemulihan dan periksa SAP HANA detailnya.

Tipe: String

Nilai yang Valid: COMPLETED | PARTIAL | DELETING | EXPIRED

StatusMessage

Pesan status yang menjelaskan status titik pemulihan.

Tipe: String

StorageClass

Menentukan kelas penyimpanan dari titik pemulihan. Nilai yang valid adalah WARM atau COLD.

Tipe: String

Nilai yang Valid: WARM | COLD | DELETED

VaultType

Jenis lemari besi tempat titik pemulihan yang dijelaskan disimpan.

Tipe: String

Nilai yang Valid: BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT

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:

• AWS Antarmuka Baris Perintah

• AWS SDKuntuk. NET

• AWS SDKuntuk C ++

• AWS SDKuntuk Go v2

• AWS SDKuntuk Java V2

• AWS SDKuntuk JavaScript V3

• AWS SDKuntuk PHP V3

• AWS SDKuntuk Python

• AWS SDKpara Ruby V3