Method: projects.locations.endpoints.queryAccount

Nicht mehr unterstützt: Verwenden Sie stattdessen die Methode endpoints.queryData. Fragt alle im Netzwerk gespeicherten Informationen zu einem Konto ab. Die zurückgegebenen Kontodetails können von Aufruf zu Aufruf variieren, da ein Endpunkt Anfragen an verschiedene Validatoren innerhalb des Netzwerks und der Region weiterleiten kann und die Validatoren zu einem bestimmten Zeitpunkt möglicherweise nicht dieselbe Runden-ID haben.

HTTP-Anfrage


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

Für die URLs wird die Syntax der gRPC-Transcodierung verwendet.

Pfadparameter

Parameter
endpoint

string

Erforderlich. Der Endpunkt, der die Anfrage verarbeitet. Format: projects/{project}/locations/{location}/endpoints/{endpoint} Der Standort ist eine Region.

Suchparameter

Parameter
accountId

string

Erforderlich. Die Konto-ID, zu der Informationen abgerufen werden sollen. Der Wert ist auf 60 Zeichen beschränkt.
roundId

string (int64 format)

Optional. Die ID der Ausführungsrunde (ähnlich der Blockhöhe), für die Daten angefordert werden sollen. Die zurückgegebenen Kontoinformationen sind für den Weltstatus in dieser Ausführungsrunde korrekt. Wenn keine Angabe erfolgt, wird die letzte abgeschlossene Runde verwendet, die dem bereitstellenden Validator bekannt ist. Der Status bei einer bestimmten Runden-ID ist immer konsistent und kanonisch.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für endpoints.queryAccount.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "account": {
    object (Account)
  }
}
Felder
account

object (Account)

Die Kontoinformationen sowie die Höhe, in der sie abgerufen wurden.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource endpoint:

  • universalledger.endpoints.readNetwork

Weitere Informationen finden Sie in der IAM-Dokumentation.