List S3 Instant Access endpoints
Lists S3 instant access endpoints depending on the filters present in the body.
Query Parameters
- limit int64
Limits the size of the response on each page to the specified number of items.
- start string
Sets the page number used to browse the collection. Pages are indexed starting from 1 (i.e.,
?start=1
). - filter string
Narrows down the results to only the items that satisfy the filter criteria. The following table lists the supported filter fields for this resource and the filter conditions that can be applied on those fields:
For more information about filtering, refer to the Filtering section of this guide.Field Filter Condition Description protection_group_id $eq The Clumio-assigned ID of the protection group associated with the desired endpoints. protection_group_s3_asset_id $eq The Clumio-assigned ID of the Protection Group S3 asset associated with the desired endpoints. The field must be used with protection_group_id.
- 200
- default
Success
- application/api.clumio.restored-protection-group-instant-access-endpoints=v1+json
- Schema
- Example (from schema)
Schema
_embedded object
Embedded responses related to the resource.
items object[]
A collection of requested items.
_embedded object
Embedded responses related to the resource.
read-protection-group-s3-assetEmbeds the associated protection group S3 asset
_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-protection-group-instant-access-endpointURL to the detailed information of the instant access endpoint
read-protection-group-instant-access-endpoint-role-permissionURL to the role permissions of the instant access endpoint
read-protection-group-instant-access-endpoint-uriURL for getting URI of the instant access endpoint
read-protection-group-s3-assetURL to the associated protection group S3 asset
aws_account_id stringThe AWS-assigned ID of the account associated with the S3 instant access endpoint.
backup_region stringThe AWS region of the S3 instant access endpoint and its source backup.
bucket_name stringThe name of source bucket.
created_timestamp stringThe time that this endpoint was created, in RFC-3339 format.
endpoint_status stringThe status of the S3 instant access endpoint. Possible values include "preparing", "active", "expiring", and "expired".
expiry_timestamp stringThe time that this endpoint expires, in RFC-3339 format.
id stringThe Clumio-assigned ID of the S3 instant access endpoint.
name stringThe user-assigned name of the S3 instant access endpoint.
objects_created_after stringThe time in RFC-3339 format that the restored objects are backed up from.
objects_created_before stringThe time in RFC-3339 format that the restored objects are backed up to.
organizational_unit_id stringThe Clumio-assigned ID of the organizational unit associated with the S3 instant access endpoint.
protection_group_id stringThe Clumio-assigned ID of the protection group this endpoint is created for.
protection_group_name stringThe user-assigned name of the protection group this endpoints is created for.
protection_group_s3_asset_id stringThe Clumio-assigned ID of the bucket protection group.
region stringThe AWS region of the source bucket.
restore_timestamp stringThe time at which the backup was restored from this endpoint in RFC-3339 format. Deprecated.
updated_timestamp stringThe time that this endpoint was last updated, in RFC-3339 format.
_links object
URLs to pages related to the resource.
_first object
The HATEOAS link to the first page of results.
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.
_next object
The HATEOAS link to the next page of results.
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.
_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.
- current_count int64
The number of items listed on the current page.
- limit int64
The maximum number of items displayed per page in the response.
- start string
The page token used to get this response.
{
"_embedded": {
"items": [
{
"_embedded": {},
"_links": {
"_self": {
"href": "string",
"templated": true,
"type": "string"
}
},
"aws_account_id": "string",
"backup_region": "string",
"bucket_name": "string",
"created_timestamp": "string",
"endpoint_status": "string",
"expiry_timestamp": "string",
"id": "string",
"name": "string",
"objects_created_after": "string",
"objects_created_before": "string",
"organizational_unit_id": "string",
"protection_group_id": "string",
"protection_group_name": "string",
"protection_group_s3_asset_id": "string",
"region": "string",
"restore_timestamp": "string",
"updated_timestamp": "string"
}
]
},
"_links": {
"_first": {
"href": "string",
"templated": true,
"type": "string"
},
"_next": {
"href": "string",
"templated": true,
"type": "string"
},
"_self": {
"href": "string",
"templated": true,
"type": "string"
}
},
"current_count": 0,
"limit": 0,
"start": "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"
}
]
}