Deleting snapshots
You can use the Process Admin Console or a REST
API call to delete snapshots of process applications or toolkits from Process Server or Process Center.
You
can only perform this operation if your user ID is a member of the
administrator group.
Important: Before you delete any snapshots, make sure
that the prerequisites for snapshot deletion are met.
- For information about the prerequisites for deleting snapshots from Process Server see BPMDeleteSnapshot command.
- For information about the prerequisites for deleting snapshots from Process Center see BPMSnapshotCleanup command.
Using the Process Admin Console
- Click .
- Select the command Delete Snapshots.
- Specify values for the command's parameters.
- Click Submit.
- If there is an error, you will see the error message. Otherwise, you can check the progress of the deletion in the system log.
Using a REST API call
Call the BPM operations REST API DELETE https://host:port/ops/std/bpm/containers/acronym/versions. Where acronym is the acronym of the process application or toolkit that contains the snapshots to delete.
Remember: For IBM® BPM
on Cloud,
the operations REST APIs have the following URL, https://hostname.bpm.ibmcloud.com/bpm/environment/ops/std/bpm/containers/acronym/versions,
where environment has the value dev for
the development system, test for the test system,
or run for the production (runtime) system.
Important: Depending on whether host:port resolves
to a Process Server or a Process Center, different parameters are
required, optional, or ignored. For details about the BPM operations
REST APIs and to try invoking them from a browser, use the Swagger
interface. The Swagger interface is available at the URL https://server:port/ops/explorer Where server is
the host name of your BPM server and port is the
port number that is used by the BPM server. For example, https://localhost:9443/ops/explorer
The
following examples illustrate how to use the REST API to delete snapshots
from Process Server and Process Center.
- Process Server examples
- Delete named snapshots V01 and V02 of
toolkit TK1:
DELETE http://host:port/ops/std/bpm/containers/TK1/versions?versions=V01,V02
- Delete the last and default snapshot VLAST of
process application APP1:
DELETE http://host:port/ops/std/bpm/containers/APP1/versions?versions=VLAST&force=true
- Delete named snapshots V01 and V02 of
toolkit TK1:
- Process Center examples
- Delete archived named snapshots V01 and V02 of
the default track of toolkit TK1:
DELETE http://host:port/ops/std/bpm/containers/TK1/versions?versions=V01,V02
- Delete all unnamed snapshots except the tip snapshot of track Test of
toolkit TK1:
DELETE http://host:port/ops/std/bpm/containers/TK1/versions?branch_name=Test&kept_number=0
- Delete all unnamed snapshots of track Test of
process application APP1 created before snapshot V20:
DELETE http://host:port/ops/std/bpm/containers/APP1/versions?branch_name=Test&created_before_snapshot=V20
- Delete all unnamed snapshots of track Test of
process application APP1 created before a point in
time:
DELETE http://host:port/ops/std/bpm/containers/APP1/versions?branch_name=Test&created_before=2016-10-01T00:00:00-06:00
Remember: If you need to specify a time zone that is ahead of UTC, you must encode the + symbol as %2B. For example, for the Central European Time zone +01:00, you must use %2B01:00 in your URL. Alternatively, you can specify a UTC date, for example ended_after=2016-01-01T01:00:00Z.
- Delete archived named snapshots V01 and V02 of
the default track of toolkit TK1:
Important: All
calls to the IBM BPM operations
REST API require that the HTTP header BPMCSRFToken is
set with every request. For information about how to obtain a token,
see Preventing cross site request forgery.
Using wsadmin commands
- To delete snapshots from Process Server see BPMDeleteSnapshot command.
- To delete snapshots from Process Center see BPMSnapshotCleanup command.