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

# GetBlock
<a name="API_GetBlock"></a>

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](https://docs.aws.amazon.com/qldb/latest/developerguide/journal-contents.html) di Panduan Pengembang *QLDB Amazon*.

Jika buku besar yang ditentukan tidak ada atau dalam `DELETING` status, maka melempar`ResourceNotFoundException`.

Jika buku besar yang ditentukan dalam `CREATING` status, maka lempar`ResourcePreconditionNotMetException`.

Jika tidak ada blok dengan alamat yang ditentukan, maka melempar`InvalidParameterException`.

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

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

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

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

Permintaan menggunakan parameter URI berikut.

 ** [name](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-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_GetBlock_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [BlockAddress](#API_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-request-BlockAddress"></a>
Lokasi blok yang ingin Anda minta. 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_GetBlock_RequestSyntax) **   <a name="qldb-GetBlock-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

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

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

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

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [Block](#API_GetBlock_ResponseSyntax) **   <a name="qldb-GetBlock-response-Block"></a>
Objek data blok dalam format Amazon Ion.  
Tipe: Objek [ValueHolder](API_ValueHolder.md)

 ** [Proof](#API_GetBlock_ResponseSyntax) **   <a name="qldb-GetBlock-response-Proof"></a>
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](API_ValueHolder.md)

## Kesalahan
<a name="API_GetBlock_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_GetBlock_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/GetBlock) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/GetBlock) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/GetBlock) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/GetBlock) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/GetBlock) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/GetBlock) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/GetBlock)