本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
GetRevision
傳回指定文件 ID 和區塊位址的修訂資料物件。如DigestTipAddress果有提供，也會傳回指定修訂版本的證明以進行驗證。
請求語法
POST /ledgers/name/revision HTTP/1.1
Content-type: application/json
{
"BlockAddress": {
"IonText": "string"
},
"DigestTipAddress": {
"IonText": "string"
},
"DocumentId": "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 物件
必要：否
- DocumentId
-
要驗證的文件的 UUID (以 Base62 編碼的文字表示)。
類型：字串
長度約束：固定長度為 22。
模式：
^[A-Za-z-0-9]+$必要：是
回應語法
HTTP/1.1 200
Content-type: application/json
{
"Proof": {
"IonText": "string"
},
"Revision": {
"IonText": "string"
}
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- Proof
-
GetRevision請求返回的 Amazon 離子格式的證明對象。證明包含使用默克爾樹重新計算指定摘要所需的哈希值列表，從指定的文檔修訂版本開始。類型：ValueHolder 物件
- Revision
-
Amazon 離子格式的文檔修訂數據對象。
類型：ValueHolder 物件
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- InvalidParameterException
-
請求中的一個或多個參數無效。
HTTP 狀態碼：400
- ResourceNotFoundException
-
指定的資源不存在。
HTTP 狀態碼：404
- ResourcePreconditionNotMetException
-
作業失敗，因為未事先滿足條件。
HTTP 狀態碼：412
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：
