Method: projects.locations.endpoints.submitOperationalTransaction

Envia uma transação operacional para a rede. Esse método só retorna depois que a transação é replicada na maioria dos validadores da rede ou se ela falha.

Solicitação HTTP


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

Os URLs usam a sintaxe de Transcodificação gRPC.

Parâmetros de caminho

Parâmetros
endpoint

string

Obrigatório. O endpoint para atender à solicitação. Formato: projects/{project}/locations/{location}/endpoints/{endpoint}. O local é uma região.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "serializedSignedOperationalTransaction": string
}
Campos
serializedSignedOperationalTransaction

string (bytes format)

Obrigatório. Um SignedTransaction serializado em protobuf para enviar ao livro-razão. A transação do cliente incluída precisa ser operacional, e o remetente precisa ser o operador da plataforma. O uso de um formato serializado garante que todos os validadores calculem o mesmo ID de transação como o resumo SHA-256 dos bytes serializados.

Uma string codificada em base64.

Corpo da resposta

Mensagem de resposta para endpoints.submitOperationalTransaction.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "transactionDigestHex": string
}
Campos
transactionDigestHex

string

Identificador que representa exclusivamente a transação operacional enviada. É a representação hexadecimal do resumo SHA-256 da serializedSignedOperationalTransaction. Esse ID de transação é fornecido para que um cliente possa rastrear a transação sem precisar implementar a lógica de hash. O identificador pode ser usado diretamente em chamadas de API subsequentes, por exemplo, para consultar o estado da transação.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.