Method: projects.locations.endpoints.queryAccount

查询网络中存储的与账号相关的所有信息。返回的账号详细信息在不同调用之间可能会有所不同,因为端点可能会将请求路由到网络和区域内的不同验证器,而验证器在任何给定时间可能不在同一轮 ID 中。

HTTP 请求


GET https://universalledger.googleapis.com/v1/{endpoint=projects/*/locations/*/endpoints/*}:queryAccount

网址使用 gRPC 转码语法。

路径参数

参数
endpoint

string

必需。用于处理请求的端点。格式:projects/{project}/locations/{location}/endpoints/{endpoint} 位置是区域。

查询参数

参数
accountId

string

必需。要获取其相关信息的账号 ID。该值的长度上限为 60 个字符。

roundId

string (int64 format)

可选。要请求数据的执行轮次(类似于块“高度”)的 ID。返回的账号信息将准确反映此执行轮次的世界状态。如果未指定,则使用服务验证器已知的最新最终确定轮次。给定轮次 ID 的状态始终是一致且规范的。

请求正文

请求正文必须为空。

响应正文

针对 endpoints.queryAccount 的响应消息。

如果成功,响应正文将包含结构如下的数据:

JSON 表示法
{
  "account": {
    object (Account)
  }
}
字段
account

object (Account)

账号信息,以及获取该信息时的高度。

授权范围

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情,请参阅 Authentication Overview