GetRevision - Amazon Quantum Ledger Database (Amazon QLDB)

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

GetRevision

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

Minta Sintaks

POST /ledgers/name/revision HTTP/1.1 Content-type: application/json { "BlockAddress": { "IonText": "string" }, "DigestTipAddress": { "IonText": "string" }, "DocumentId": "string" }

Parameter Permintaan URI

Permintaan menggunakan parameter URI berikut.

name

Nama buku besar.

Batasan Panjang: Panjang minimum 1. Panjang maksimum 32.

Pola: (?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$

Wajib: Ya

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

BlockAddress

Lokasi blok revisi dokumen yang akan diverifikasi. Alamat adalah struktur Amazon Ion yang memiliki dua bidang: strandId dansequenceNo.

Misalnya: {strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}.

Tipe: Objek ValueHolder

Wajib: Ya

DigestTipAddress

Lokasi blok terbaru yang dicakup oleh intisari untuk meminta bukti. Alamat adalah struktur Amazon Ion yang memiliki dua bidang: strandId dansequenceNo.

Misalnya: {strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}.

Tipe: Objek ValueHolder

Wajib: Tidak

DocumentId

UUID (diwakili dalam teks yang disandikan Base62) dari dokumen yang akan diverifikasi.

Jenis: String

Kendala Panjang: Panjang tetap 22.

Pola: ^[A-Za-z-0-9]+$

Diperlukan: Ya

Sintaksis Respons

HTTP/1.1 200 Content-type: application/json { "Proof": { "IonText": "string" }, "Revision": { "IonText": "string" } }

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

Proof

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

Revision

Objek data revisi dokumen dalam format Amazon Ion.

Tipe: Objek ValueHolder

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: