查询网络中存储的与账号相关的所有信息。返回的账号详细信息在不同调用之间可能会有所不同,因为端点可能会将请求路由到网络和区域内的不同验证器,而验证器在任何给定时间可能不在同一轮 ID 中。
HTTP 请求
:
GET https://universalledger.googleapis.com/v1/{endpoint=projects/*/locations/*/endpoints/*}:queryAccount 网址使用 gRPC 转码语法。
路径参数
| 参数 | |
|---|---|
endpoint |
必需。用于处理请求的端点。格式: |
查询参数
| 参数 | |
|---|---|
accountId |
必需。要获取其相关信息的账号 ID。该值的长度上限为 60 个字符。 |
roundId |
可选。要请求数据的执行轮次(类似于块“高度”)的 ID。返回的账号信息将准确反映此执行轮次的世界状态。如果未指定,则使用服务验证器已知的最新最终确定轮次。给定轮次 ID 的状态始终是一致且规范的。 |
请求正文
请求正文必须为空。
响应正文
针对 endpoints.queryAccount 的响应消息。
如果成功,响应正文将包含结构如下的数据:
| JSON 表示法 |
|---|
{
"account": {
object ( |
| 字段 | |
|---|---|
account |
账号信息,以及获取该信息时的高度。 |
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/cloud-platform
如需了解详情,请参阅 Authentication Overview。