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