Method: projects.locations.instances.keyRings.keys.transactions.recordSignerDecision

Records a signer's decision to authorize or deny a Transaction.

A decision is allowed only while the Transaction is PENDING_AUTHORIZATION and before expireTime. When enough signers authorize it, the server evaluates the Transaction against the transaction policies again, as of createTime, and attempts to sign it. This evaluation doesn't change policyEvaluationRecord. The server returns the Transaction in state SIGNING_SUCCEEDED with finalSignature, plus recoveryId for EC_SIGN_SECP256K1, or in state SIGNING_FAILED if that policy evaluation or signing fails. In that case, the server sets stateMessage. To retry after SIGNING_FAILED, create a new Transaction. When so many signers deny it that the thresholds cannot be met, the Transaction moves to REJECTED.

The deciding User is the User whose principal matches the authenticated identity of the caller. That User must have the SIGNER role, have an authorizationKey, and hold a key share of the Key of the Transaction. A caller without the SIGNER role gets PERMISSION_DENIED, and a caller that holds no key share gets NOT_FOUND. Each User can record at most one decision per Transaction. A second call fails with ALREADY_EXISTS.

The request fails with FAILED_PRECONDITION if the Key is not ACTIVE or the Transaction is not PENDING_AUTHORIZATION. If expireTime has passed, the server moves a pending Transaction to EXPIRED and returns FAILED_PRECONDITION.

HTTP request

POST https://mpc.googleapis.com/v1beta/{name=projects/*/locations/*/instances/*/keyRings/*/keys/*/transactions/*}:recordSignerDecision

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The name of the Transaction to record the decision for. Format: projects/{project}/locations/{location}/instances/{instance}/keyRings/{keyRing}/keys/{key}/transactions/{transaction} It takes the form projects/{project}/locations/{location}/instances/{instance}/keyRings/{keyring}/keys/{key}/transactions/{transaction}.

Request body

The request body contains data with the following structure:

JSON representation
{
  "decision": enum (Decision),
  "authorizationInfo": {
    object (AuthorizationInfo)
  }
}
Fields
decision

enum (Decision)

Required. The caller's decision.

authorizationInfo

object (AuthorizationInfo)

Required. The caller's authorization over a TransactionSigningPayload, signed with the authorization key of the User whose principal matches the caller, with:

  • transaction: set to name
  • decision: set to decision
  • signingMessage: set to the stored Transaction's signingMessage

Response body

If successful, the response body contains an instance of Transaction.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.