本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
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
-
您要請求的塊的位置。地址是具有兩個字段的 Amazon 離子結構：
strandId和sequenceNo。例如：
{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}。類型：ValueHolder 物件
必要：是
- DigestTipAddress
-
摘要涵蓋要求證明的最新區塊位置。地址是具有兩個字段的 Amazon 離子結構：
strandId和sequenceNo。例如：
{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:49}。類型：ValueHolder 物件
必要：否
回應語法
HTTP/1.1 200
Content-type: application/json
{
"Block": {
"IonText": "string"
},
"Proof": {
"IonText": "string"
}
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- Block
-
Amazon 離子格式的塊數據對象。
類型：ValueHolder 物件
- Proof
-
GetBlock請求返回的 Amazon 離子格式的證明對象。證明包含使用默克爾樹（從指定塊開始）重新計算指定摘要所需的哈希值列表。類型：ValueHolder 物件
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- InvalidParameterException
-
請求中的一個或多個參數無效。
HTTP 狀態碼：400
- ResourceNotFoundException
-
指定的資源不存在。
HTTP 狀態碼：404
- ResourcePreconditionNotMetException
-
作業失敗，因為條件未事先滿足。
HTTP 狀態碼：412
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：
