GetDigest - 亚马逊 Quantum Ledger 数据库(亚马逊QLDB)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

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

GetDigest 代表请求返回的摘要的 256 位哈希值。

类型:Base64 编码的二进制数据对象

长度限制:固定长度为 32。

DigestTipAddress

摘要中要求提供证据的最新数据块位置。地址是一种包含两个字段的 strandIdAmazon Ion 结构:即 和 sequenceNo

类型:ValueHolder 对象

错误

有关所有操作返回的常见错误的信息,请参阅常见错误

InvalidParameterException

请求中的一项或多项参数无效。

HTTP 状态代码:400

ResourceNotFoundException

指定的资源不存在。

HTTP 状态代码:404

ResourcePreconditionNotMetException

由于未提前满足条件,操作失败。

HTTP 状态代码:412

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: