本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
GetDigest
傳回分錄中最新確認區塊中分類帳的摘要。該響應包括 256 位哈希值和塊地址。
請求語法
POST /ledgers/name
/digest HTTP/1.1
URI 請求參數
請求會使用下列 URI 參數。
- name
-
分類帳的名稱。
長度限制:長度下限為 1。長度上限為 32。
模式:
(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$
必要:是
請求主體
請求沒有請求主體。
回應語法
HTTP/1.1 200
Content-type: application/json
{
"Digest": blob,
"DigestTipAddress": {
"IonText": "string"
}
}
回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- Digest
-
256 位哈希值表示由請求返回的摘要。
GetDigest
類型:Base64 編碼的二進位資料物件
長度約束:固定長度為 32。
- DigestTipAddress
-
您要求的摘要所涵蓋的最新區塊位置。地址是具有兩個字段的 Amazon 離子結構:
strandId
和sequenceNo
。類型:ValueHolder 物件
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
- InvalidParameterException
-
請求中的一個或多個參數無效。
HTTP 狀態碼:400
- ResourceNotFoundException
-
指定的資源不存在。
HTTP 狀態碼:404
- ResourcePreconditionNotMetException
-
作業失敗,因為未事先滿足條件。
HTTP 狀態碼:412
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: