Preview a protection group S3 asset restore
Preview a protection group S3 asset restore
Path Parameters
- protection_group_s3_asset_id string required
Performs the operation on the ProtectionGroup with the specified ID.
- application/json
Request Body required
- backup_id string
Backup ID.
- is_sync_preview boolean
Response type to be sync
object_filters object
Search for or restore only objects that pass the source object filter.
etag stringFilter for objects with this etag.
latest_version_only boolean requiredIf set to true, filter for latest versions only. Otherwise, all versions will be returned.
max_object_size_bytes int64Filter for objects with at most this size in bytes.
min_object_size_bytes int64Filter for objects with at least this size in bytes.
object_key_contains stringFilter for objects whose key contains this string.
object_key_matches stringFilter for objects whose key matches this string.
object_key_prefix stringFilter for objects that start with this key prefix.
object_key_suffix stringFilter for objects that end with this key suffix.
storage_classes string[]Storage class to include in the restore. If not specified, then all objects across all storage classes will be restored. Valid values are:
S3 Standard
,S3 Standard-IA
,S3 Intelligent-Tiering
andS3 One Zone-IA
.version_id stringFilter for objects with this version ID.
- pitr_end_timestamp string
The end timestamp of the period within which objects are to be restored, in RFC-3339 format. Clumio searches for objects modified before the given time. If
pitr_end_timestamp
is empty, Clumio searches for objects modified up to the current time of the restore request.
Ifpitr_end_timestamp
is given withoutpitr_start_timestamp
, it is the same as point in time preview. - pitr_start_timestamp string
The start timestamp of the period within which objects are to be restored, in RFC-3339 format. Clumio searches for objects modified since the given time. If
pitr_start_timestamp
is empty, Clumio searches for objects from the beginning of the first backup.
- 200
- 202
- default
Success (Sync)
- application/api.clumio.restored-protection-group-s3-assets=v1+json
- Schema
- Example (from schema)
Schema
_links object
URLs to pages related to the resource.
_self object
The HATEOAS link to this resource.
href stringThe URI for the referenced operation.
templated booleanDetermines whether the "href" link is a URI template. If set to
true
, the "href" link is a URI template.type stringThe HTTP method to be used with the "href" link for the referenced operation.
objects object[]
The fetched objects as a result of the preview.
Note that this field is given only for sync request.bucket stringBucket the object belongs to
etag stringEtag of the contents of the object.
last_backup_time stringLast time the object was backed up as an RFC3339 string.
last_modified_time stringLast modified time of the object as an RFC3339 string.
object_key stringObject key
protection_group_asset_id stringThe Clumio-assigned ID of a protection group S3 asset, which represents the bucket within the protection group to restore from.
region stringregion of the backup object
restore_cookie stringEncrypted metadata for the object to be restored
You can getrestore_cookie
via POST /restores/protection-groups/{protection_group_id}/previewssize_in_bytes int64Size in Bytes
storage_class stringPossible values: [
S3 Standard
,S3 Standard-IA
,S3 Intelligent-Tiering
,S3 One Zone-IA
]Storage class. Valid values are:
S3 Standard
,S3 Standard-IA
,S3 Intelligent-Tiering
, andS3 One Zone-IA
.version_id stringVersion ID
{
"_links": {
"_self": {
"href": "string",
"templated": true,
"type": "string"
}
},
"objects": [
{
"bucket": "string",
"etag": "string",
"last_backup_time": "string",
"last_modified_time": "string",
"object_key": "string",
"protection_group_asset_id": "string",
"region": "string",
"restore_cookie": "string",
"size_in_bytes": 0,
"storage_class": "S3 Standard",
"version_id": "string"
}
]
}
Success (Async)
- application/api.clumio.restored-protection-group-s3-assets=v1+json
- Schema
- Example (from schema)
Schema
_links object
URLs to pages related to the resource.
_self object
The HATEOAS link to this resource.
href stringThe URI for the referenced operation.
templated booleanDetermines whether the "href" link is a URI template. If set to
true
, the "href" link is a URI template.type stringThe HTTP method to be used with the "href" link for the referenced operation.
read-task object
A HATEOAS link to the task associated with this resource.
href stringThe URI for the referenced operation.
templated booleanDetermines whether the "href" link is a URI template. If set to
true
, the "href" link is a URI template.type stringThe HTTP method to be used with the "href" link for the referenced operation.
- preview_id string
The identifier for the requested preview which is used to fetch results of the preview.
- task_id string
The Clumio-assigned ID of the task created by this restore request. The progress of the task can be monitored using the
GET /tasks/{task_id}
endpoint.
Note that this field is given only for async request.
{
"_links": {
"_self": {
"href": "string",
"templated": true,
"type": "string"
},
"read-task": {
"href": "string",
"templated": true,
"type": "string"
}
},
"preview_id": "string",
"task_id": "string"
}
Error
- application/json
- Schema
- Example (from schema)
Schema
errors object[]
A list of errors encountered during runtime.
error_code uint32error_message stringThe reason for the error.
{
"errors": [
{
"error_code": 0,
"error_message": "string"
}
]
}