Retrieve an EC2 instance backup
Returns a representation of the specified EC2 instance backup.
Path Parameters
- backup_id string required
Performs the operation on the backup with the specified ID.
- 200
- default
Success
- application/api.clumio.backup-aws-ec2-instances=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.
restore-aws-ec2-instance object
A resource-specific HATEOAS link.
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.
- account_native_id string
The AWS-assigned ID of the account associated with the backup.
ami object
An Amazon Machine Image is a supported and maintained image provided by AWS that provides the information required to launch an instance.
ami_native_id stringThe AWS-assigned ID of the AMI.
architecture stringThe architecture of the AMI. Possible values include 'i386', 'x86_64', and 'arm64'.
has_ena_support booleanSpecifies whether enhanced networking with ENA is enabled.
hypervisor_type stringThe hypervisor type of the AMI. Possible values include 'ovm' and 'xen'.
image_type stringType of Image (machine | kernel | ramdisk ).
is_public booleanA Boolean that indicates whether the image is public.
name stringThe name of the AMI.
number_of_ebs_volumes int64Number of ebs volumes.
number_of_ephemeral_volumes int64Number of ephemeral volumes.
owner_id stringThe ID of the Amazon Web Services account that owns the image.
platform stringThe platform of the AMI. Possible values include "windows" and "linux".
root_device_name stringPossible values: [
/dev/xvda
,/dev/sda1
]The name of the root device used by the AMI.
root_device_type stringPossible values: [
ebs
,instance-store
]The type of root device used by the AMI.
sriov_net_support stringA value of simple indicates that enhanced networking with the Intel 82599 VF interface is enabled.
virtualization_type stringThe type of virtualization of the AMI. Possible values include 'hvm' and 'paravirtual.'
attached_backup_ebs_volumes object[]
The EBS volumes attached to the instance.
id stringThe Clumio-assigned id for the volume.
is_root booleanDetermines whether this device is the root for the instance.
kms_key_native_id stringThe AWS-assigned id of the KMS key used for encryption of the volume.
name stringThe device name for the EBS volume. For example, '/dev/xvda'.
size int64The size of the EBS volume. Measured in bytes (B).
status stringThe status of the EBS volume. Possible values include 'attaching', 'attached', 'detaching', 'detached'.
tags object[]
The AWS tags applied to the EBS volume.
key stringThe AWS-assigned tag key.
value stringThe AWS-assigned tag value.
type stringThe type of the volume. Possible values include 'gp2', 'io1', 'st1', 'sc1', and 'standard'.
utilized_size_in_bytes uint64The number of bytes written in the EBS volume.
volume_native_id stringThe AWS-assigned ID of the EBS volume.
- aws_az string
The availability zone of the instance.
- aws_region string
The AWS region in which the instance backup resides. For example,
us-west-2
. backup_ami object
An Amazon Machine Image is a supported and maintained image provided by AWS that provides the information required to launch an instance.
ami_native_id stringThe AWS-assigned ID of the AMI.
architecture stringThe architecture of the AMI. Possible values include 'i386', 'x86_64', and 'arm64'.
has_ena_support booleanSpecifies whether enhanced networking with ENA is enabled.
hypervisor_type stringThe hypervisor type of the AMI. Possible values include 'ovm' and 'xen'.
image_type stringType of Image (machine | kernel | ramdisk ).
is_public booleanA Boolean that indicates whether the image is public.
name stringThe name of the AMI.
number_of_ebs_volumes int64Number of ebs volumes.
number_of_ephemeral_volumes int64Number of ephemeral volumes.
owner_id stringThe ID of the Amazon Web Services account that owns the image.
platform stringThe platform of the AMI. Possible values include "windows" and "linux".
root_device_name stringPossible values: [
/dev/xvda
,/dev/sda1
]The name of the root device used by the AMI.
root_device_type stringPossible values: [
ebs
,instance-store
]The type of root device used by the AMI.
sriov_net_support stringA value of simple indicates that enhanced networking with the Intel 82599 VF interface is enabled.
virtualization_type stringThe type of virtualization of the AMI. Possible values include 'hvm' and 'paravirtual.'
- backup_tier string
The tier to which the backup is tagged to.
- browsing_failed_reason string
Possible values: [
file_limit_exceeded
,browsing_unavailable
]The reason that browsing is unavailable for the backup. If browse indexing is successful, then this field has a value of
null
. - expiration_timestamp string
The timestamp of when this backup expires. Represented in RFC-3339 format.
iam_instance_profile object
Denotes an IAM instance profile. An instance profile is a container for an IAM role that you can use to pass role information to an EC2 instance when the instance starts.
arn stringThe Amazon Resource Name (ARN) specifying the IAM instance profile.
name stringThe AWS-assigned name of the IAM instance profile.
native_id stringThe AWS-assigned ID of the IAM instance profile.
- id string
The Clumio-assigned ID of the instance backup.
- instance_id string
The Clumio-assigned ID of the EC2 instance associated with the instance backup.
- instance_native_id string
The AWS-assigned ID of the EC2 instance associated with the instance backup.
instance_store_block_device_mappings object[]
The InstanceStore volumes attached to the instance.
encryption stringEncryption for the instance store volume. Possible values include 'hardware encrypted' and 'Not encrypted'.
is_nvme booleanDetermines whether or not the volume is a NVME instance store volume or a non-NVME instance store volume.
name stringThe device name for the instance store volume. For example, '/dev/sdb'.
size int64The size of the instance store volume. Measured in bytes (B).
type stringThe type of the block device. Only possible value is "Instance Store".
virtual_name stringThe AWS-assigned name of the instance store volume.
- instance_type string
The instance type of the original EC2 instance before backup. For example,
m5.large
. - is_browsable boolean
Determines whether browsing is available for the backup. If
true
, then browsing is available for the backup. - key_pair_name string
The name of the key pair associated with this instance. If this instance was not launched with an associated key pair, then this field has a value of
null
. - key_pair_native_id string
The ID of the key pair associated with this instance. If this instance was not launched with an associated key pair, then this field has a value of
null
. - migration_timestamp string
The timestamp of when the migration was triggered. This field will be set only for migration backups. Represented in RFC-3339 format.
network_interfaces object[]
The network interfaces attached to the instance.
device_index int64The device index for the network interface.
network_interface_native_id stringThe AWS-assigned ID for the network interface.
public_ip stringThe public IP v4 address of the network interface if one was assigned.
security_group_native_ids string[]The AWS-assigned IDs for the security groups associated with this network interface.
subnet_native_id stringThe subnet native ID for the network interface.
virtual_name stringThe AWS-assigned name of the network interface. For example,
eth0
.- public_ip_address string
The public IP v4 address of the instance if one was assigned.
- size int64
The size of the instance backup. This is the sum of all the EBS volumes attached to the EC2 measured in gigabytes (GB).
- start_timestamp string
The timestamp of when this backup started. Represented in RFC-3339 format.
- subnet_native_id string
The AWS-assigned Subnet ID of the EC2 instance.
tags object[]
The instance tags applied to the original EC2 instance before backup.
key stringThe AWS-assigned tag key.
value stringThe AWS-assigned tag value.
- type string
Possible values: [
clumio_backup
,aws_snapshot
]The type of the backup.
- utilized_size_in_bytes uint64
The total number of bytes written in all the disks of the EC2 instance.
- vpc_native_id string
The AWS-assigned ID of the VPC associated with the EC2 instance.
{
"_links": {
"_self": {
"href": "string",
"templated": true,
"type": "string"
},
"restore-aws-ec2-instance": {
"href": "string",
"templated": true,
"type": "string"
}
},
"account_native_id": "string",
"ami": {
"ami_native_id": "string",
"architecture": "string",
"has_ena_support": true,
"hypervisor_type": "string",
"image_type": "string",
"is_public": true,
"name": "string",
"number_of_ebs_volumes": 0,
"number_of_ephemeral_volumes": 0,
"owner_id": "string",
"platform": "string",
"root_device_name": "/dev/xvda",
"root_device_type": "ebs",
"sriov_net_support": "string",
"virtualization_type": "string"
},
"attached_backup_ebs_volumes": [
{
"id": "string",
"is_root": true,
"kms_key_native_id": "string",
"name": "string",
"size": 0,
"status": "string",
"tags": [
{
"key": "string",
"value": "string"
}
],
"type": "string",
"utilized_size_in_bytes": 0,
"volume_native_id": "string"
}
],
"aws_az": "string",
"aws_region": "string",
"backup_ami": {
"ami_native_id": "string",
"architecture": "string",
"has_ena_support": true,
"hypervisor_type": "string",
"image_type": "string",
"is_public": true,
"name": "string",
"number_of_ebs_volumes": 0,
"number_of_ephemeral_volumes": 0,
"owner_id": "string",
"platform": "string",
"root_device_name": "/dev/xvda",
"root_device_type": "ebs",
"sriov_net_support": "string",
"virtualization_type": "string"
},
"backup_tier": "string",
"browsing_failed_reason": "file_limit_exceeded",
"expiration_timestamp": "string",
"iam_instance_profile": {
"arn": "string",
"name": "string",
"native_id": "string"
},
"id": "string",
"instance_id": "string",
"instance_native_id": "string",
"instance_store_block_device_mappings": [
{
"encryption": "string",
"is_nvme": true,
"name": "string",
"size": 0,
"type": "string",
"virtual_name": "string"
}
],
"instance_type": "string",
"is_browsable": true,
"key_pair_name": "string",
"key_pair_native_id": "string",
"migration_timestamp": "string",
"network_interfaces": [
{
"device_index": 0,
"network_interface_native_id": "string",
"public_ip": "string",
"security_group_native_ids": [
"string"
],
"subnet_native_id": "string",
"virtual_name": "string"
}
],
"public_ip_address": "string",
"size": 0,
"start_timestamp": "string",
"subnet_native_id": "string",
"tags": [
{
"key": "string",
"value": "string"
}
],
"type": "clumio_backup",
"utilized_size_in_bytes": 0,
"vpc_native_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"
}
]
}