Description: Triggers restoration of multiple items from the Archive. An admin can choose one of the following options:
Restore items to the original location and provide fallback repository in case the original location was deprecated.
Restore to a dedicated central repository.
Note
Restore operation only moves the items back to the Warm instance location and does not delete them from the Cold instance.
Note: This Cold Artifact Storage feature is available only for Artifactory Enterprise and Enterprise+ users.
Since: Artifactory 7.27.3
Security: Requires an admin user
Usage: POST /api/retention/restore
Consumes: application/json
Query Parameter:
Parameters | Type | Description | Required/Optional |
---|---|---|---|
| boolean | Set whether or not to restore to the original artifact location (saved on the Cold instance). | Required if |
| string | If NoteBefore providing the | Required if |
| string | The repository key where the files need to be restored. The files will be restored to this repository according to its original path hierarchy. For example, if the repository key is
NoteBefore providing the | Required if |
| boolean | This is set as When set as | Optional |
| string | Comma-separated list of the items or paths to be restored. Format: NoteFolder paths must end with a NoteSince Example: Where:
For information about getting the namespace, see Get Namespace. | Required |
Sample Request:
POST /api/retention/restore
{ "restoreToOriginal" : true, "fallbackDestinationPath" : "urs-generic-dev-local", "itemsToRestore": [ "urs-generic-dev-local/webapp_python.tar.gz", "urs-generic-dev-local/webapp_python_azure.tar.gz" ] }
Sample Response: Successful
{ "response": "Restore requestprocess haswas been accepted for processing.initialized successfully.", "failed_to_restore_items": {} }
Sample Response: Failed
{ "response": "Restoration operation failed, some of the requested files could not be restored", "failed_to_restore_items": { "ifuwxrbf_urs-generic-dev-local/webapp_python.tar.gz": "File does not exist in path", "ifuwxrbf_urs-generic-dev-local/webapp_python_azure.tar.gz": "File does not exist in path" } }
Status:
200: Success