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

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

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 Ion 结构:即 strandIdsequenceNo

例如:{strandId:"BlFTjlSXze9BIh1KOszcE3",sequenceNo:14}

类型:ValueHolder 对象

必需:是

DigestTipAddress

摘要中要求提供证据的最新数据块位置。地址是一种包含两个字段的 strandIdAmazon Ion 结构:即 和 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 Ion 格式的区块数据对象。

类型:ValueHolder 对象

Proof

GetBlock 请求返回的 Amazon Ion 格式的证明对象。证明包含使用默克尔树重新计算指定摘要所需哈希值列表,从指定的区块开始。

类型:ValueHolder 对象

错误

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

InvalidParameterException

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

HTTP 状态代码:400

ResourceNotFoundException

指定的资源不存在。

HTTP 状态代码:404

ResourcePreconditionNotMetException

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

HTTP 状态代码:412

另请参阅

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