Restore from Archive

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
`restoreToOriginal`	boolean	Set whether or not to restore to the original artifact location (saved on the Cold instance).	Required if `centralDestinationPath` is not set
`fallbackDestinationPath`	string	If `restoreToOriginal` is set as `true` and the original location does not exist anymore, restore to this fallback location. `fallbackDestinationPath` must contain at least the repository key. Note Before providing the `fallbackDestinationPath`, ensure that the path already exists.	Required if `restoreToOriginal` is set
`centralDestinationPath`	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 `test_repo` and the original path is `pypi-local/jfrogapp/0.1`, the files will be restored to `test_repo/pypi-local/jfrogapp/0.1`. `centralDestinationPath` and `restoreToOriginal` are mutually exclusive. Note Before providing the `centralDestinationPath`, ensure that the path already exists.	Required if `restoreToOriginal` is not set
`addNamespace`	boolean	This is set as `true` by default and you do not have to include the namespace when adding items for `itemsToRestore`. When set as `false`, you must include the namespace when adding items for `itemsToRestore`.	Optional
`itemsToRestore`	string	Comma-separated list of the items or paths to be restored. Format: `“itemsToRestore”: [“<repository_name>/path/to/file”, “<repository_name>/path/to/folder/” …,]` Note Folder paths must end with a `/` while file paths must not. Note Since `addNamespace` is set as `true` by default, you do not have to include the namespace with the path for `itemsToRestore`. However, if `addNamespace`is set as `false`, ensure that the repository name includes the namespace that was generated during the archive process and the full repository path. Example: `gbbxmcuj_pypi-local/jfrogapp/0.1/jfrogapp-0.1.tar.gz` Where: `gbbxmcuj` is the namespace `pypi-local` is the name of the repository `jfrogapp/0.1/jfrogapp-0.1.tar.gz` is the full path for the item to be restored 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