Method: projects.locations.endpoints.submitOperationalTransaction

Envia uma transação operacional para a rede. Esse método retorna somente depois que a transação é replicada na maioria dos validadores na rede ou se a transação 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 disponibilizar a 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 da transação que 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 do serializedSignedOperationalTransaction. Esse ID da transação é fornecido para que um cliente possa acompanhar a transação sem precisar implementar a lógica de hash. O identificador pode ser usado diretamente nas próximas chamadas de API, 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.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso endpoint:

  • universalledger.endpoints.submit

Para mais informações, consulte a documentação do IAM.