Method: projects.locations.endpoints.queryAccount

ネットワーク内のアカウントに関するすべての情報をクエリします。返されるアカウントの詳細は、呼び出しごとに異なる場合があります。これは、エンドポイントがネットワークとリージョン内の異なるバリデータにリクエストをルーティングする可能性があり、バリデータが特定のラウンド ID にない可能性があるためです。

HTTP リクエスト


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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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 をご覧ください。