Jump to

• Request
• Response

Unlock Atomic Transaction

put

/restproxy/api/v2/atomicTransactions/{globalTransactionId}

Unlock an atomic transaction. Sends a request to unlock chaincode keys locked by a previous atomic transaction.

Request

Supported Media Types

• application/json

Path Parameters

• globalTransactionId: string
  Global Transaction ID

Body ()

Request to unlock chaincode keys locked by a previous atomic transaction

Root Schema : schema

Type: object

Show Source

• chaincode: string
  ID of the chaincode to invoke
• channel: string
  ID of the channel to invoke the transaction
• endorsers(optional): array endorsers
  Endorsers for the chaincode
• isCommit(optional): boolean
  Default Value: false

  Optionally, specify whether to commit or rollback the transaction
• prepareTxid: string
  Transaction ID of the prepared transaction
• timeout(optional): integer(int64)
  Timeout in ms for the chaincode to invoke

{
    "type":"object",
    "required":[
        "chaincode",
        "channel",
        "prepareTxid"
    ],
    "properties":{
        "channel":{
            "description":"ID of the channel to invoke the transaction",
            "type":"string"
        },
        "chaincode":{
            "description":"ID of the chaincode to invoke",
            "type":"string"
        },
        "endorsers":{
            "description":"Endorsers for the chaincode",
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "timeout":{
            "description":"Timeout in ms for the chaincode to invoke",
            "type":"integer",
            "format":"int64"
        },
        "prepareTxid":{
            "description":"Transaction ID of the prepared transaction",
            "type":"string"
        },
        "isCommit":{
            "description":"Optionally, specify whether to commit or rollback the transaction",
            "type":"boolean",
            "default":false
        }
    }
}

Nested Schema : endorsers

Type: array

Endorsers for the chaincode

Show Source

• Array of: string

{
    "description":"Endorsers for the chaincode",
    "type":"array",
    "items":{
        "type":"string"
    }
}

Back to Top

Response

Supported Media Types

• application/json

201 Response

Successful operation for sync transaction

Body ()

Root Schema : schema

Type: object

Show Source

• error(optional): string
  Default Value:
• result(optional): object result
• returnCode: string
  Allowed Values: [ "Success", "Failure" ]

{
    "type":"object",
    "required":[
        "returnCode"
    ],
    "properties":{
        "returnCode":{
            "$ref":"#/definitions/returnCode"
        },
        "error":{
            "type":"string",
            "default":""
        },
        "result":{
            "type":"object",
            "required":[
                "txid",
                "payload",
                "encode"
            ],
            "properties":{
                "txid":{
                    "type":"string"
                },
                "message":{
                    "type":"string"
                },
                "payload":{
                    "$ref":"#/definitions/AnyValue"
                },
                "encode":{
                    "$ref":"#/definitions/encode"
                }
            }
        }
    }
}

Nested Schema : result

Type: object

Show Source

• encode: string
  Allowed Values: [ "UTF-8", "JSON", "base64" ]
• message(optional): string
• payload:
• txid: string

{
    "type":"object",
    "required":[
        "txid",
        "payload",
        "encode"
    ],
    "properties":{
        "txid":{
            "type":"string"
        },
        "message":{
            "type":"string"
        },
        "payload":{
            "$ref":"#/definitions/AnyValue"
        },
        "encode":{
            "$ref":"#/definitions/encode"
        }
    }
}

400 Response

Bad Request

401 Response

Not authorized

403 Response

Forbidden

404 Response

Invalid parameters

500 Response

Service unavailable

Back to Top