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 |
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 |
Request body
The request body contains data with the following structure:
| JSON representation |
|---|
{ "decision": enum ( |
| Fields | |
|---|---|
decision |
Required. The caller's decision. |
authorizationInfo |
Required. The caller's authorization over a TransactionSigningPayload, signed with the authorization key of the User whose
|
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.