Retrieve an S3 asset within a protection group.
Returns a representation of the specified protection group S3 asset.
Path Parameters
- protection_group_s3_asset_id string required
Performs the operation on the protection group S3 asset with the specified ID.
Query Parameters
- lookback_days int64
Calculate backup status for the last
lookback_days
days.
- 200
- default
Success
- application/api.clumio.protection-groups-s3-assets=v1+json
- Schema
- Example (from schema)
Schema
_embedded object
_links object
- account_native_id string
The AWS-assigned ID of the account associated with the DynamoDB table.
- added_by_bucket_rule boolean
Whether this bucket was added to this protection group by the bucket rule
- added_by_user boolean
Whether this bucket was added to this protection group by the user
- aws_region string
The AWS region associated with the DynamoDB table.
backup_status_info object
- backup_target_aws_region string
The backup target AWS region associated with the protection group S3 asset.
backup_tier_stats object[]
- bucket_id string
The Clumio-assigned ID of the bucket
- bucket_name string
The name of the bucket
- created_timestamp string
Creation time of the protection group in RFC-3339 format.
- earliest_available_backup_timestamp string
Timestamp of the earliest protection group backup which has not expired yet. Represented in RFC-3339 format. Only available for Read API.
- environment_id string
The Clumio-assigned ID of the AWS environment associated with the protection group.
- group_id string
The Clumio-assigned ID of the protection group
- group_name string
The name of the protection group
- id string
The Clumio-assigned ID that represents the bucket within the protection group.
- is_deleted boolean
Determines whether the protection group bucket has been deleted
- last_backup_timestamp string
Time of the last backup in RFC-3339 format.
- last_continuous_backup_timestamp string
Time of the last successful continuous backup in RFC-3339 format.
- organizational_unit_id string
The Clumio-assigned ID of the organizational unit associated with the protection group.
protection_info object
protection_stats object
- protection_status string
The protection status of the protection group. Possible values include "protected", "unprotected", and "unsupported". If the protection group does not support backups, then this field has a value of
unsupported
. - total_backed_up_object_count int64
Cumulative count of all unexpired objects in each backup (any new or updated since the last backup) that have been backed up as part of this protection group
- total_backed_up_size_bytes int64
Cumulative size of all unexpired objects in each backup (any new or updated since the last backup) that have been backed up as part of this protection group
- unsupported_reason string
The unsupported reason for the S3 bucket.
{
"_embedded": {},
"_links": {
"_self": {
"href": "string",
"templated": true,
"type": "string"
},
"delete-bucket-protection-group": {
"href": "string",
"templated": true,
"type": "string"
},
"list-backup-protection-group-s3-assets": {
"href": "string",
"templated": true,
"type": "string"
},
"read-organizational-unit": {
"href": "string",
"templated": true,
"type": "string"
},
"read-policy-definition": {
"href": "string",
"templated": true,
"type": "string"
}
},
"account_native_id": "string",
"added_by_bucket_rule": true,
"added_by_user": true,
"aws_region": "string",
"backup_status_info": {
"backup_status": "string",
"last_failed_policy_start_timestamp": "string",
"last_successful_policy_start_timestamp": "string",
"operation_info_list": [
{
"backup_status": "string",
"last_failed_policy_start_timestamp": "string",
"last_successful_policy_start_timestamp": "string",
"operation": "string"
}
]
},
"backup_target_aws_region": "string",
"backup_tier_stats": [
{
"backup_tier": "string",
"total_backed_up_object_count": 0,
"total_backed_up_size_bytes": 0
}
],
"bucket_id": "string",
"bucket_name": "string",
"created_timestamp": "string",
"earliest_available_backup_timestamp": "string",
"environment_id": "string",
"group_id": "string",
"group_name": "string",
"id": "string",
"is_deleted": true,
"last_backup_timestamp": "string",
"last_continuous_backup_timestamp": "string",
"organizational_unit_id": "string",
"protection_info": {
"inheriting_entity_id": "string",
"inheriting_entity_type": "string",
"policy_id": "string"
},
"protection_stats": {
"deactivated_count": 0,
"protected_count": 0,
"unprotected_count": 0
},
"protection_status": "string",
"total_backed_up_object_count": 0,
"total_backed_up_size_bytes": 0,
"unsupported_reason": "string"
}
Error
- application/json
- Schema
- Example (from schema)
Schema
errors object[]
{
"errors": [
{
"error_code": 0,
"error_message": "string"
}
]
}
GET /datasources/protection-groups/s3-assets/:protection_group_s3_asset_id
Authorization
Request
Request
curl -L -X GET 'https://us-west-2.api.clumio.com/datasources/protection-groups/s3-assets/:protection_group_s3_asset_id' \
-H 'Accept: application/api.clumio.protection-groups-s3-assets=v1+json' \
-H 'Authorization: Bearer <TOKEN>'
curl -L -X GET 'https://us-west-2.api.clumio.com/datasources/protection-groups/s3-assets/:protection_group_s3_asset_id' \
-H 'Accept: application/api.clumio.protection-groups-s3-assets=v1+json' \
-H 'Authorization: Bearer <TOKEN>'
curl -L -X GET 'https://us-west-2.api.clumio.com/datasources/protection-groups/s3-assets/:protection_group_s3_asset_id' \
-H 'Accept: application/api.clumio.protection-groups-s3-assets=v1+json' \
-H 'Authorization: Bearer <TOKEN>'
curl -L -X GET 'https://us-west-2.api.clumio.com/datasources/protection-groups/s3-assets/:protection_group_s3_asset_id' \
-H 'Accept: application/api.clumio.protection-groups-s3-assets=v1+json' \
-H 'Authorization: Bearer <TOKEN>'
curl -L -X GET 'https://us-west-2.api.clumio.com/datasources/protection-groups/s3-assets/:protection_group_s3_asset_id' \
-H 'Accept: application/api.clumio.protection-groups-s3-assets=v1+json' \
-H 'Authorization: Bearer <TOKEN>'
curl -L -X GET 'https://us-west-2.api.clumio.com/datasources/protection-groups/s3-assets/:protection_group_s3_asset_id' \
-H 'Accept: application/api.clumio.protection-groups-s3-assets=v1+json' \
-H 'Authorization: Bearer <TOKEN>'
curl -L -X GET 'https://us-west-2.api.clumio.com/datasources/protection-groups/s3-assets/:protection_group_s3_asset_id' \
-H 'Accept: application/api.clumio.protection-groups-s3-assets=v1+json' \
-H 'Authorization: Bearer <TOKEN>'