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

GetBlock

Mengembalikan objek blok pada alamat tertentu dalam jurnal. Juga mengembalikan bukti blok yang ditentukan untuk verifikasi jika DigestTipAddress disediakan.

Untuk informasi tentang konten data dalam satu blok, lihat Konten jurnal di Panduan Pengembang QLDB Amazon.

Jika buku besar yang ditentukan tidak ada atau dalam DELETING status, maka melemparResourceNotFoundException.

Jika buku besar yang ditentukan dalam CREATING status, maka lemparResourcePreconditionNotMetException.

Jika tidak ada blok dengan alamat yang ditentukan, maka melemparInvalidParameterException.

Minta Sintaks

POST /ledgers/name/block HTTP/1.1 Content-type: application/json { "BlockAddress": { "IonText": "string" }, "DigestTipAddress": { "IonText": "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 yang ingin Anda minta. 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

Sintaksis Respons

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

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

Block

Objek data blok dalam format Amazon Ion.

Tipe: Objek ValueHolder

Proof

Objek bukti dalam format Amazon Ion dikembalikan oleh GetBlock permintaan. Bukti berisi daftar nilai hash yang diperlukan untuk menghitung ulang intisari yang ditentukan menggunakan pohon Merkle, dimulai dengan blok yang ditentukan.

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: