翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
GetBlock
ジャーナルの指定されたアドレスにあるブロックオブジェクトを返します。また、DigestTipAddress が指定されている場合は、指定されたブロックの証明を検証のために返します。
ブロック内のデータコンテンツの詳細については、「Amazon QLDB デベロッパーガイド」の「ジャーナルコンテンツ」を参照してください。
指定された台帳が存在しないか、DELETING ステータスの場合は、ResourceNotFoundException をスローします。
指定された台帳が CREATING ステータスの場合は、ResourcePreconditionNotMetException をスローします。
指定されたアドレスを持つブロックが存在しない場合は、InvalidParameterException をスローします。
リクエストの構文
POST /ledgers/name/block HTTP/1.1
Content-type: application/json
{
"BlockAddress": {
"IonText": "string"
},
"DigestTipAddress": {
"IonText": "string"
}
}URI リクエストパラメータ
リクエストでは、次の URI パラメータを使用します。
- name
-
台帳の名前。
長さの制限：最小長 1、最大長は 32 です。
パターン:
(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$必須: はい
リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
- BlockAddress
-
リクエストするブロックの場所。アドレスは、
strandIdとsequenceNoという 2 つのフィールドを含む Amazon Ion 構造です。例:
{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}。型: ValueHolder オブジェクト
必須: はい
- DigestTipAddress
-
証明をリクエストするダイジェストの対象となっている最新のブロックの場所。アドレスは、
strandIdとsequenceNoという 2 つのフィールドを含む Amazon Ion 構造です。例:
{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}。型: ValueHolder オブジェクト
必須: いいえ
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"Block": {
"IonText": "string"
},
"Proof": {
"IonText": "string"
}
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- Block
-
Amazon Ion 形式のブロックデータオブジェクト。
型: ValueHolder オブジェクト
- Proof
-
GetBlockリクエストによって返される、Amazon Ion 形式の証明オブジェクト。証明には、指定されたブロックから始まるマークルツリーを使用して指定されたダイジェストを再計算するために必要なハッシュ値のリストが含まれます。型: ValueHolder オブジェクト
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- InvalidParameterException
-
リクエスト内の 1 つ以上のパラメータが有効ではありません。
HTTP ステータスコード: 400
- ResourceNotFoundException
-
指定されたリソースは存在しません。
HTTP ステータスコード: 404
- ResourcePreconditionNotMetException
-
事前に条件が満たされていなかったため、オペレーションが失敗しました。
HTTP ステータスコード: 412
以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
