DescribeRecoveryPoint - 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.

DescribeRecoveryPoint

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

Minta Sintaks

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

Parameter Permintaan URI

Permintaan menggunakan parameter URI 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

Nama Sumber Daya Amazon (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",
      "BackupPlanName": "string",
      "BackupPlanVersion": "string",
      "BackupRuleCron": "string",
      "BackupRuleId": "string",
      "BackupRuleName": "string",
      "BackupRuleTimezone": "string"
   },
   "CreationDate": number,
   "EncryptionKeyArn": "string",
   "EncryptionKeyType": "string",
   "IamRoleArn": "string",
   "IndexStatus": "string",
   "IndexStatusMessage": "string",
   "InitiationDate": number,
   "IsEncrypted": boolean,
   "IsParent": boolean,
   "LastRestoreTime": number,
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "ParentRecoveryPointArn": "string",
   "RecoveryPointArn": "string",
   "ResourceArn": "string",
   "ResourceName": "string",
   "ResourceType": "string",
   "ScanResults": [ 
      { 
         "Findings": [ "string" ],
         "LastScanTimestamp": number,
         "MalwareScanner": "string",
         "ScanJobState": "string"
      }
   ],
   "SourceBackupVaultArn": "string",
   "Status": "string",
   "StatusMessage": "string",
   "StorageClass": "string",
   "VaultType": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

BackupSizeInBytes

Ukuran, dalam byte, cadangan.

Tipe: Long

BackupVaultArn

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 Coordinated Universal Time (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 Coordinated Universal Time (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

EncryptionKeyType

Jenis kunci enkripsi yang digunakan untuk titik pemulihan. Nilai yang valid adalah CUSTOMER_MANAGED_KMS_KEY untuk kunci yang dikelola pelanggan atau _OWNED_KMS_KEY untuk kunci yang dimiliki. AWS AWS

Tipe: String

Nilai yang Valid: AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY

IamRoleArn

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

Tipe: String

IndexStatus

Ini adalah status saat ini untuk indeks cadangan yang terkait dengan titik pemulihan yang ditentukan.

Status adalah: PENDING | | ACTIVE | FAILED DELETING

Titik pemulihan dengan indeks yang berstatus ACTIVE dapat dimasukkan dalam pencarian.

Tipe: String

Nilai yang Valid: PENDING | ACTIVE | FAILED | DELETING

IndexStatusMessage

String dalam bentuk pesan terperinci yang menjelaskan status indeks cadangan yang terkait dengan titik pemulihan.

Tipe: String

InitiationDate

Tanggal dan waktu ketika pekerjaan cadangan yang menciptakan titik pemulihan ini dimulai, dalam format Unix dan Coordinated Universal Time (UTC).

Tipe: Timestamp

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 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 lama dari pengaturan "transisi ke penyimpanan dingin setelah beberapa hari". Pengaturan "transisi ke penyimpanan dingin setelah beberapa hari" tidak dapat diubah setelah pencadangan telah ditransisi ke penyimpanan 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

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

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 (Amazon EBS) atau database Amazon Relational Database Service (Amazon RDS).

Tipe: String

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

ScanResults

Berisi hasil pemindaian terbaru terhadap titik pemulihan dan saat ini termasukMalwareScanner,ScanJobState,Findings, dan LastScanTimestamp

Tipe: Array objek ScanResult

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 5 item.

SourceBackupVaultArn

Nama Sumber Daya Amazon (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. Untuk informasi selengkapnya, lihat Status titik pemulihan di Panduan AWS Backup Pengembang.

  • CREATINGstatus menunjukkan bahwa AWS Backup pekerjaan telah dimulai untuk sumber daya. Proses pencadangan telah dimulai dan secara aktif memproses pekerjaan cadangan untuk titik pemulihan terkait.

  • AVAILABLEstatus menunjukkan bahwa cadangan berhasil dibuat untuk titik pemulihan. Proses pencadangan telah selesai tanpa masalah, dan titik pemulihan sekarang siap digunakan.

  • PARTIALstatus menunjukkan titik pemulihan komposit memiliki satu atau lebih titik pemulihan bersarang yang tidak ada dalam cadangan.

  • 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 S3, Amazon RDS, 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 status STOPTED tidak perlu dihapus.

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

Tipe: String

Nilai yang Valid: COMPLETED | PARTIAL | DELETING | EXPIRED | AVAILABLE | STOPPED | CREATING

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 | RESTORE_ACCESS_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.

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: