Method: projects.locations.endpoints.queryAccount

非推奨: 代わりに、endpoints.queryData メソッドを使用してください。ネットワーク内のアカウントに保存されているすべての情報をクエリします。エンドポイントは、ネットワークとリージョン内の異なるバリデータにリクエストをルーティングする可能性があり、バリデータは特定の時点で同じラウンド 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 をご覧ください。

IAM 権限

endpoint リソースに対する次の IAM 権限が必要です。

  • universalledger.endpoints.readNetwork

詳細については、IAM のドキュメントをご覧ください。