Method: projects.locations.endpoints.queryAccount

Esegue una query su tutte le informazioni archiviate su un account nella rete. I dettagli dell'account restituiti possono variare tra le chiamate, perché un endpoint può instradare le richieste a diversi validatori all'interno della rete e della regione e i validatori potrebbero non avere lo stesso ID round in un determinato momento.

Richiesta HTTP


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

Gli URL utilizzano la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
endpoint

string

Obbligatorio. L'endpoint per gestire la richiesta. Formato: projects/{project}/locations/{location}/endpoints/{endpoint} La località è una regione.

Parametri di query

Parametri
accountId

string

Obbligatorio. L'ID account di cui ottenere informazioni. Il valore è limitato a 60 caratteri.

roundId

string (int64 format)

Facoltativo. L'ID del round di esecuzione (simile all'"altezza" del blocco) in cui richiedere i dati. Le informazioni sull'account restituite saranno accurate per lo stato del mondo in questo round di esecuzione. Se non viene specificato, viene utilizzato l'ultimo round finalizzato noto al validatore di pubblicazione. Lo stato in un determinato ID round è sempre coerente e canonico.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per endpoints.queryAccount.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "account": {
    object (Account)
  }
}
Campi
account

object (Account)

Le informazioni sull'account, insieme all'altezza in cui sono state ottenute.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la Authentication Overview.