Roll back a transaction (DELETE)


The DELETE command rolls back a transaction that you have already committed to its initial state. 

The macro unmigrated-inline-wiki-markup from Confluence is no longer available.

Note

You can roll back a transaction only if it has not yet been terminated.

Command overview

Method — DELETE
 Resource — Transaction
 Resource identifier — Transaction identifier (tid) returned in the request that initiated the transaction

Parameters

Parameter

Description

Example

usr 1

A valid system user name (case sensitive)

usr=myUsername

pwd 1

The password that corresponds to the usr (user name) parameter (case sensitive)

pwd=myPassword
rollback

Indicates whether you want to roll back the transaction identified by the resource identifier

If you do not specify the rollback parameter, the system terminates the transaction.

rollback=true

 1 This parameter is required.

Sample request

https://10.0.0.1/rest/configurationAPI/transactionAPI/1.0/transaction/7484?usr=jdoe&pwd=pa55w0rd!&rollback=true

Sample successful response

<?xml version="1.0" encoding="UTF-8"?>
<response>
<status result="success"></status>
</response>

Sample unsuccessful response

<?xml version="1.0" encoding="UTF-8"?>
<response>
<status result="failure">
 <msg code="XXXXX" severity="ERROR">Execution failure.
  Transaction is already committed.</msg>
</status>
</response>

Related topic

Transaction-API-XML-reference

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*