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

# GetRevision
<a name="API_GetRevision"></a>

Mengembalikan objek data revisi untuk ID dokumen tertentu dan alamat blok. Juga mengembalikan bukti revisi yang ditentukan untuk verifikasi jika `DigestTipAddress` disediakan.

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

```
POST /ledgers/name/revision HTTP/1.1
Content-type: application/json

{
   "BlockAddress": { 
      "IonText": "string"
   },
   "DigestTipAddress": { 
      "IonText": "string"
   },
   "DocumentId": "string"
}
```

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

Permintaan menggunakan parameter URI berikut.

 ** [name](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-uri-Name"></a>
Nama buku besar.  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 32.  
Pola: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Wajib: Ya

## Isi Permintaan
<a name="API_GetRevision_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [BlockAddress](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-BlockAddress"></a>
Lokasi blok revisi dokumen yang akan diverifikasi. Alamat adalah struktur Amazon Ion yang memiliki dua bidang: `strandId` dan`sequenceNo`.  
Sebagai contoh: `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}`.  
Tipe: Objek [ValueHolder](API_ValueHolder.md)  
Wajib: Ya

 ** [DigestTipAddress](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-DigestTipAddress"></a>
Lokasi blok terbaru yang dicakup oleh intisari untuk meminta bukti. Alamat adalah struktur Amazon Ion yang memiliki dua bidang: `strandId` dan`sequenceNo`.  
Sebagai contoh: `{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}`.  
Tipe: Objek [ValueHolder](API_ValueHolder.md)  
Wajib: Tidak

 ** [DocumentId](#API_GetRevision_RequestSyntax) **   <a name="qldb-GetRevision-request-DocumentId"></a>
UUID (diwakili dalam teks yang disandikan Base62) dari dokumen yang akan diverifikasi.  
Tipe: String  
Kendala Panjang: Panjang tetap 22.  
Pola: `^[A-Za-z-0-9]+$`   
Diperlukan: Ya

## Sintaksis Respons
<a name="API_GetRevision_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Proof": { 
      "IonText": "string"
   },
   "Revision": { 
      "IonText": "string"
   }
}
```

## Elemen Respons
<a name="API_GetRevision_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [Proof](#API_GetRevision_ResponseSyntax) **   <a name="qldb-GetRevision-response-Proof"></a>
Objek bukti dalam format Amazon Ion dikembalikan oleh `GetRevision` permintaan. Bukti berisi daftar nilai hash yang diperlukan untuk menghitung ulang intisari yang ditentukan menggunakan pohon Merkle, dimulai dengan revisi dokumen yang ditentukan.  
Tipe: Objek [ValueHolder](API_ValueHolder.md)

 ** [Revision](#API_GetRevision_ResponseSyntax) **   <a name="qldb-GetRevision-response-Revision"></a>
Objek data revisi dokumen dalam format Amazon Ion.  
Tipe: Objek [ValueHolder](API_ValueHolder.md)

## Kesalahan
<a name="API_GetRevision_Errors"></a>

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

 ** InvalidParameterException **   
Satu atau beberapa parameter dalam permintaan tidak valid.  
Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Sumber daya yang ditentukan tidak ada.  
Kode Status HTTP: 404

 ** ResourcePreconditionNotMetException **   
Operasi gagal karena kondisi tidak terpenuhi sebelumnya.  
Kode Status HTTP: 412

## Lihat Juga
<a name="API_GetRevision_SeeAlso"></a>

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