Estimate cost of a S3 instant access endpoint
Estimates cost for creating and maintaining a S3 instant access endpoint with given parameters.
- application/json
Request Body required
- backup_id string
The Clumio-assigned ID of the protection group S3 asset backup or protection group backup to be restored. Use the endpoints GET /backups/protection-groups/s3-assets for protection group S3 asset backup, and GET /backups/protection-groups for protection group backups to fetch valid values.
Note that only one of eitherbackup_id
orpitr
must be provided. - is_sync boolean
Whether to wait for the operation to complete.
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 object
The parameters to initiate a point-in-time creation of S3 instant access endpoint.
Note that only one of eitherbackup_id
orpitr
must be provided.restore_end_timestamp stringThe end time of the period in which the objects must be restored in RFC-3339 format. Objects modified before this given time will be restored. If
restore_end_timestamp
is provided withoutrestore_start_timestamp
, then it is the same as a point-in-time restore.restore_start_timestamp stringThe start time of the period in which the objects must be restored in RFC-3339 format. Objects modified since the given time will be restored.
- protection_group_s3_asset_id string required
Clumio-assigned ID of protection group S3 asset, representing the bucket within the protection group to restore from. Use the GET /datasources/protection-groups/s3-assets endpoint to fetch valid values.
- 200
- 202
- default
Success (Sync)
- application/api.clumio.restored-protection-group-instant-access-endpoints=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.
- estimated_cost double
The estimated cost for instant access endpoint.
- total_object_count int64
The count of objects to be restored.
- total_object_size int64
The total size in bytes of objects to be restored.
{
"_links": {
"_self": {
"href": "string",
"templated": true,
"type": "string"
}
},
"estimated_cost": 0,
"total_object_count": 0,
"total_object_size": 0
}
Success (Async)
- application/api.clumio.restored-protection-group-instant-access-endpoints=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.
cost-estimates-details-protection-group-instant-access-endpointURL to retrieve details of cost estimates
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.
- estimate_id string
The identifier for the requested estimate which is used to fetch results.
- 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"
}
},
"estimate_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"
}
]
}