

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

# Langkah 1: Meminta intisari di QLDB
<a name="verification.digest"></a>

**penting**  
Pemberitahuan akhir dukungan: Pelanggan yang ada akan dapat menggunakan Amazon QLDB hingga akhir dukungan pada 07/31/2025. Untuk detail selengkapnya, lihat [Memigrasi Buku Besar QLDB Amazon ke Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Amazon QLDB menyediakan API untuk meminta intisari yang mencakup ujung jurnal *saat ini di buku* besar Anda. Tip jurnal mengacu pada blok komitmen terbaru pada saat QLDB menerima permintaan Anda. Anda dapat menggunakan Konsol Manajemen AWS, AWS SDK, atau AWS Command Line Interface (AWS CLI) untuk mendapatkan intisari.

**Topics**
+ [Konsol Manajemen AWS](#verification.digest.con)
+ [QLDB API](#verification.digest.api)

## Konsol Manajemen AWS
<a name="verification.digest.con"></a>

Ikuti langkah-langkah ini untuk meminta intisari menggunakan konsol QLDB.

**Untuk meminta intisari (konsol)**

1. [Masuk ke Konsol Manajemen AWS, dan buka konsol QLDB Amazon di /qldb. https://console.aws.amazon.com](https://console.aws.amazon.com/qldb)

1. Di panel navigasi, pilih **Buku Besar**.

1. Dalam daftar buku besar, pilih nama buku besar yang ingin Anda minta intisari.

1. Pilih **Dapatkan intisari**. Kotak dialog **Get digest** menampilkan detail intisari berikut:
   + **Digest** — Nilai hash SHA-256 dari intisari yang Anda minta.
   + **Alamat tip intisari** — Lokasi blok terbaru dalam jurnal yang dicakup oleh intisari yang Anda minta. Alamat memiliki dua bidang berikut:
     + `strandId`— ID unik untai jurnal yang berisi blok.
     + `sequenceNo`— Nomor indeks yang menentukan lokasi blok di dalam untai.
   + **Buku Besar** — Nama buku besar yang Anda minta intisari.
   + **Tanggal** — Stempel waktu saat Anda meminta intisari.

1. Tinjau informasi intisari. Lalu, pilih **Simpan**. Anda dapat menyimpan nama file default, atau memasukkan nama baru.
**catatan**  
Anda mungkin memperhatikan bahwa nilai hash dan alamat tip intisari Anda berubah bahkan ketika Anda tidak memodifikasi data apa pun di buku besar Anda. *Ini karena konsol mengambil katalog sistem buku besar setiap kali Anda menjalankan kueri di editor PartiQL.* Ini adalah transaksi baca yang berkomitmen pada jurnal dan menyebabkan alamat blok terbaru berubah.

   Langkah ini menyimpan file plaintext dengan konten dalam format [Amazon Ion](ion.md). File ini memiliki ekstensi nama file `.ion.txt` dan berisi semua informasi intisari yang tercantum pada kotak dialog sebelumnya. Berikut ini adalah contoh isi file digest. Urutan bidang dapat bervariasi tergantung pada browser Anda.

   ```
   {
     "digest": "42zaJOfV8iGutVGNaIuzQWhD5Xb/5B9lScHnvxPXm9E=",
     "digestTipAddress": "{strandId:\"BlFTjlSXze9BIh1KOszcE3\",sequenceNo:73}",
     "ledger": "my-ledger",
     "date": "2019-04-17T16:57:26.749Z"
   }
   ```

1. Simpan file ini di mana Anda dapat mengaksesnya di masa depan. Kemudian, Anda dapat menggunakan file ini untuk memverifikasi revisi dokumen terhadap.
**penting**  
Revisi dokumen yang Anda verifikasi nanti harus dicakup oleh intisari yang Anda simpan. Artinya, nomor urut alamat dokumen harus kurang dari atau sama dengan nomor urut **alamat tip Digest**.

## QLDB API
<a name="verification.digest.api"></a>

Anda juga dapat meminta intisari dari buku besar Anda dengan menggunakan Amazon QLDB API dengan SDK atau file. AWS AWS CLI QLDB API menyediakan operasi berikut untuk digunakan oleh program aplikasi:
+ [GetDigest](https://docs.aws.amazon.com/qldb/latest/developerguide/API_GetDigest.html)— Mengembalikan intisari buku besar di blok komitmen terbaru dalam jurnal. Responsnya mencakup nilai hash 256-bit dan alamat blok.

*Untuk informasi tentang meminta intisari menggunakan AWS CLI, lihat perintah [get-digest di Referensi](https://docs.aws.amazon.com/cli/latest/reference/qldb/get-digest.html) Perintah.AWS CLI *

### Aplikasi sampel
<a name="verification.digest.api.sample"></a>

Untuk contoh kode Java, lihat GitHub repositori [amazon-qldb-dmv-sampleaws-samples/](https://github.com/aws-samples/amazon-qldb-dmv-sample-java) -java. Untuk petunjuk tentang cara mengunduh dan menginstal aplikasi sampel ini, lihat[Menginstal aplikasi sampel Amazon QLDB Java](sample-app.java.md). Sebelum meminta intisari, pastikan Anda mengikuti Langkah 1-3 [Tutorial Java](getting-started.java.tutorial.md) untuk membuat buku besar sampel dan memuatnya dengan data sampel.

Kode tutorial di kelas [GetDigest](https://github.com/aws-samples/amazon-qldb-dmv-sample-java/blob/master/src/main/java/software/amazon/qldb/tutorial/GetDigest.java)memberikan contoh meminta intisari dari buku besar `vehicle-registration` sampel.

Untuk memverifikasi revisi dokumen menggunakan intisari yang Anda simpan, lanjutkan ke. [Langkah 2: Memverifikasi data Anda di QLDB](verification.verify.md)