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

# DescribeRecoveryPoint
<a name="API_DescribeRecoveryPoint"></a>

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

## Minta Sintaks
<a name="API_DescribeRecoveryPoint_RequestSyntax"></a>

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

## Parameter Permintaan URI
<a name="API_DescribeRecoveryPoint_RequestParameters"></a>

Permintaan menggunakan parameter URI berikut.

 ** [BackupVaultAccountId](#API_DescribeRecoveryPoint_RequestSyntax) **   <a name="Backup-DescribeRecoveryPoint-request-uri-BackupVaultAccountId"></a>
ID akun dari brankas cadangan yang ditentukan.  
Pola: `^[0-9]{12}$` 

 ** [backupVaultName](#API_DescribeRecoveryPoint_RequestSyntax) **   <a name="Backup-DescribeRecoveryPoint-request-uri-BackupVaultName"></a>
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](#API_DescribeRecoveryPoint_RequestSyntax) **   <a name="Backup-DescribeRecoveryPoint-request-uri-RecoveryPointArn"></a>
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
<a name="API_DescribeRecoveryPoint_RequestBody"></a>

Permintaan tidak memiliki isi permintaan.

## Sintaks Respons
<a name="API_DescribeRecoveryPoint_ResponseSyntax"></a>

```
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
<a name="API_DescribeRecoveryPoint_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [BackupSizeInBytes](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-BackupSizeInBytes"></a>
Ukuran, dalam byte, cadangan.  
Tipe: Long

 ** [BackupVaultArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-BackupVaultArn"></a>
ARN yang secara unik mengidentifikasi brankas cadangan; misalnya,. `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`  
Tipe: String

 ** [BackupVaultName](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-BackupVaultName"></a>
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](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-CalculatedLifecycle"></a>
Sebuah `CalculatedLifecycle` benda yang berisi `DeleteAt` dan `MoveToColdStorageAt` stempel waktu.  
Tipe: Objek [CalculatedLifecycle](API_CalculatedLifecycle.md)

 ** [CompletionDate](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-CompletionDate"></a>
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](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-CompositeMemberIdentifier"></a>
Pengidentifikasi sumber daya dalam grup komposit, seperti titik pemulihan bersarang (anak) milik tumpukan komposit (induk). ID ditransfer dari [ID logis](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-syntax) dalam tumpukan.  
Tipe: String

 ** [CreatedBy](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-CreatedBy"></a>
Berisi informasi identifikasi tentang pembuatan titik pemulihan, termasuk`BackupPlanArn`,`BackupPlanId`,`BackupPlanVersion`, dan `BackupRuleId` rencana cadangan yang digunakan untuk membuatnya.  
Tipe: Objek [RecoveryPointCreator](API_RecoveryPointCreator.md)

 ** [CreationDate](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-CreationDate"></a>
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](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-EncryptionKeyArn"></a>
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](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-EncryptionKeyType"></a>
Jenis kunci enkripsi yang digunakan untuk titik pemulihan. Nilai yang valid adalah CUSTOMER\$1MANAGED\$1KMS\$1KEY untuk kunci yang dikelola pelanggan atau \$1OWNED\$1KMS\$1KEY untuk kunci yang dimiliki. AWS AWS  
Tipe: String  
Nilai yang Valid: `AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY` 

 ** [IamRoleArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-IamRoleArn"></a>
Menentukan peran IAM ARN digunakan untuk membuat titik pemulihan target; misalnya,. `arn:aws:iam::123456789012:role/S3Access`  
Tipe: String

 ** [IndexStatus](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-IndexStatus"></a>
Ini adalah status saat ini untuk indeks cadangan yang terkait dengan titik pemulihan yang ditentukan.  
Status adalah: `PENDING` \$1 \$1 `ACTIVE` \$1 `FAILED` `DELETING`   
Titik pemulihan dengan indeks yang berstatus `ACTIVE` dapat dimasukkan dalam pencarian.  
Tipe: String  
Nilai yang Valid: `PENDING | ACTIVE | FAILED | DELETING` 

 ** [IndexStatusMessage](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-IndexStatusMessage"></a>
String dalam bentuk pesan terperinci yang menjelaskan status indeks cadangan yang terkait dengan titik pemulihan.  
Tipe: String

 ** [InitiationDate](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-InitiationDate"></a>
Tanggal dan waktu ketika pekerjaan cadangan yang menciptakan titik pemulihan ini dimulai, dalam format Unix dan Coordinated Universal Time (UTC).  
Tipe: Timestamp

 ** [IsEncrypted](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-IsEncrypted"></a>
Nilai Boolean yang dikembalikan `TRUE` seolah-olah titik pemulihan yang ditentukan dienkripsi, atau `FALSE` jika titik pemulihan tidak dienkripsi.  
Jenis: Boolean

 ** [IsParent](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-IsParent"></a>
Ini mengembalikan nilai boolean bahwa titik pemulihan adalah pekerjaan induk (komposit).  
Jenis: Boolean

 ** [LastRestoreTime](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-LastRestoreTime"></a>
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](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-Lifecycle"></a>
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](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup mengabaikan ekspresi ini untuk jenis sumber daya lainnya.  
Tipe: Objek [Lifecycle](API_Lifecycle.md)

 ** [ParentRecoveryPointArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-ParentRecoveryPointArn"></a>
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](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-RecoveryPointArn"></a>
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](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-ResourceArn"></a>
ARN yang secara unik mengidentifikasi sumber daya yang disimpan. Format ARN tergantung pada jenis sumber daya.  
Tipe: String

 ** [ResourceName](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-ResourceName"></a>
Nama sumber daya milik cadangan yang ditentukan.  
Tipe: String

 ** [ResourceType](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-ResourceType"></a>
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](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-ScanResults"></a>
Berisi hasil pemindaian terbaru terhadap titik pemulihan dan saat ini termasuk`MalwareScanner`,`ScanJobState`,`Findings`, dan `LastScanTimestamp`   
Tipe: Array objek [ScanResult](API_ScanResult.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 5 item.

 ** [SourceBackupVaultArn](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-SourceBackupVaultArn"></a>
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 menjadi`null`.  
Tipe: String

 ** [Status](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-Status"></a>
Kode status yang menentukan keadaan titik pemulihan. Untuk informasi selengkapnya, lihat [Status titik pemulihan](https://docs.aws.amazon.com/aws-backup/latest/devguide/applicationstackbackups.html#cfnrecoverypointstatus) di *Panduan AWS Backup Pengembang*.  
+  `CREATING`status menunjukkan bahwa AWS Backup pekerjaan telah dimulai untuk sumber daya. Proses pencadangan telah dimulai dan secara aktif memproses pekerjaan cadangan untuk titik pemulihan terkait.
+  `AVAILABLE`status menunjukkan bahwa cadangan berhasil dibuat untuk titik pemulihan. Proses pencadangan telah selesai tanpa masalah, dan titik pemulihan sekarang siap digunakan.
+  `PARTIAL`status menunjukkan titik pemulihan komposit memiliki satu atau lebih titik pemulihan bersarang yang tidak ada dalam cadangan.
+  `EXPIRED`Status 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](https://docs.aws.amazon.com/aws-backup/latest/devguide/gs-cleanup-resources.html#cleanup-backups) di bagian *Bersihkan sumber daya* *Memulai*.
+  `STOPPED`status 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](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-StatusMessage"></a>
Pesan status yang menjelaskan status titik pemulihan.  
Tipe: String

 ** [StorageClass](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-StorageClass"></a>
Menentukan kelas penyimpanan dari titik pemulihan. Nilai yang valid adalah `WARM` atau `COLD`.  
Tipe: String  
Nilai yang Valid: `WARM | COLD | DELETED` 

 ** [VaultType](#API_DescribeRecoveryPoint_ResponseSyntax) **   <a name="Backup-DescribeRecoveryPoint-response-VaultType"></a>
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
<a name="API_DescribeRecoveryPoint_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Jenis Kesalahan Umum](CommonErrors.md).

 ** 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
<a name="API_DescribeRecoveryPoint_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeRecoveryPoint) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeRecoveryPoint)