2018/11/07 - Amazon Elastic Compute Cloud - 4 updated api methods
Changes VM Import/Export now supports generating encrypted EBS snapshots, as well as AMIs backed by encrypted EBS snapshots during the import process.
{'ImportImageTasks': {'Encrypted': 'boolean', 'KmsKeyId': 'string'}}
Displays details about an import virtual machine or import snapshot tasks that are already created.
See also: AWS API Documentation
Request Syntax
client.describe_import_image_tasks(
DryRun=True|False,
Filters=[
{
'Name': 'string',
'Values': [
'string',
]
},
],
ImportTaskIds=[
'string',
],
MaxResults=123,
NextToken='string'
)
boolean
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation . Otherwise, it is UnauthorizedOperation .
list
Filter tasks using the task-state filter and one of the following values: active, completed, deleting, deleted.
(dict) --
A filter name and value pair that is used to return a more specific list of results from a describe operation. Filters can be used to match a set of resources by specific criteria, such as tags, attributes, or IDs. The filters supported by a describe operation are documented with the describe operation. For example:
DescribeAvailabilityZones
DescribeImages
DescribeInstances
DescribeKeyPairs
DescribeSecurityGroups
DescribeSnapshots
DescribeSubnets
DescribeTags
DescribeVolumes
DescribeVpcs
Name (string) --
The name of the filter. Filter names are case-sensitive.
Values (list) --
One or more filter values. Filter values are case-sensitive.
(string) --
list
A list of import image task IDs.
(string) --
integer
The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value.
string
A token that indicates the next page of results.
dict
Response Syntax
{
'ImportImageTasks': [
{
'Architecture': 'string',
'Description': 'string',
'Encrypted': True|False,
'Hypervisor': 'string',
'ImageId': 'string',
'ImportTaskId': 'string',
'KmsKeyId': 'string',
'LicenseType': 'string',
'Platform': 'string',
'Progress': 'string',
'SnapshotDetails': [
{
'Description': 'string',
'DeviceName': 'string',
'DiskImageSize': 123.0,
'Format': 'string',
'Progress': 'string',
'SnapshotId': 'string',
'Status': 'string',
'StatusMessage': 'string',
'Url': 'string',
'UserBucket': {
'S3Bucket': 'string',
'S3Key': 'string'
}
},
],
'Status': 'string',
'StatusMessage': 'string'
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Contains the output for DescribeImportImageTasks.
ImportImageTasks (list) --
A list of zero or more import image tasks that are currently active or were completed or canceled in the previous 7 days.
(dict) --
Describes an import image task.
Architecture (string) --
The architecture of the virtual machine.
Valid values: i386 | x86_64
Description (string) --
A description of the import task.
Encrypted (boolean) --
Indicates whether the image is encrypted.
Hypervisor (string) --
The target hypervisor for the import task.
Valid values: xen
ImageId (string) --
The ID of the Amazon Machine Image (AMI) of the imported virtual machine.
ImportTaskId (string) --
The ID of the import image task.
KmsKeyId (string) --
The identifier for the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to create the encrypted image.
LicenseType (string) --
The license type of the virtual machine.
Platform (string) --
The description string for the import image task.
Progress (string) --
The percentage of progress of the import image task.
SnapshotDetails (list) --
Information about the snapshots.
(dict) --
Describes the snapshot created from the imported disk.
Description (string) --
A description for the snapshot.
DeviceName (string) --
The block device mapping for the snapshot.
DiskImageSize (float) --
The size of the disk in the snapshot, in GiB.
Format (string) --
The format of the disk image from which the snapshot is created.
Progress (string) --
The percentage of progress for the task.
SnapshotId (string) --
The snapshot ID of the disk being imported.
Status (string) --
A brief status of the snapshot creation.
StatusMessage (string) --
A detailed status message for the snapshot creation.
Url (string) --
The URL used to access the disk image.
UserBucket (dict) --
The S3 bucket for the disk image.
S3Bucket (string) --
The S3 bucket from which the disk image was created.
S3Key (string) --
The file name of the disk image.
Status (string) --
A brief status for the import image task.
StatusMessage (string) --
A descriptive status message for the import image task.
NextToken (string) --
The token to use to get the next page of results. This value is null when there are no more results to return.
{'ImportSnapshotTasks': {'SnapshotTaskDetail': {'Encrypted': 'boolean',
'KmsKeyId': 'string'}}}
Describes your import snapshot tasks.
See also: AWS API Documentation
Request Syntax
client.describe_import_snapshot_tasks(
DryRun=True|False,
Filters=[
{
'Name': 'string',
'Values': [
'string',
]
},
],
ImportTaskIds=[
'string',
],
MaxResults=123,
NextToken='string'
)
boolean
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation . Otherwise, it is UnauthorizedOperation .
list
One or more filters.
(dict) --
A filter name and value pair that is used to return a more specific list of results from a describe operation. Filters can be used to match a set of resources by specific criteria, such as tags, attributes, or IDs. The filters supported by a describe operation are documented with the describe operation. For example:
DescribeAvailabilityZones
DescribeImages
DescribeInstances
DescribeKeyPairs
DescribeSecurityGroups
DescribeSnapshots
DescribeSubnets
DescribeTags
DescribeVolumes
DescribeVpcs
Name (string) --
The name of the filter. Filter names are case-sensitive.
Values (list) --
One or more filter values. Filter values are case-sensitive.
(string) --
list
A list of import snapshot task IDs.
(string) --
integer
The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value.
string
A token that indicates the next page of results.
dict
Response Syntax
{
'ImportSnapshotTasks': [
{
'Description': 'string',
'ImportTaskId': 'string',
'SnapshotTaskDetail': {
'Description': 'string',
'DiskImageSize': 123.0,
'Encrypted': True|False,
'Format': 'string',
'KmsKeyId': 'string',
'Progress': 'string',
'SnapshotId': 'string',
'Status': 'string',
'StatusMessage': 'string',
'Url': 'string',
'UserBucket': {
'S3Bucket': 'string',
'S3Key': 'string'
}
}
},
],
'NextToken': 'string'
}
Response Structure
(dict) --
Contains the output for DescribeImportSnapshotTasks.
ImportSnapshotTasks (list) --
A list of zero or more import snapshot tasks that are currently active or were completed or canceled in the previous 7 days.
(dict) --
Describes an import snapshot task.
Description (string) --
A description of the import snapshot task.
ImportTaskId (string) --
The ID of the import snapshot task.
SnapshotTaskDetail (dict) --
Describes an import snapshot task.
Description (string) --
The description of the snapshot.
DiskImageSize (float) --
The size of the disk in the snapshot, in GiB.
Encrypted (boolean) --
Indicates whether the snapshot is encrypted.
Format (string) --
The format of the disk image from which the snapshot is created.
KmsKeyId (string) --
The identifier for the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to create the encrypted snapshot.
Progress (string) --
The percentage of completion for the import snapshot task.
SnapshotId (string) --
The snapshot ID of the disk being imported.
Status (string) --
A brief status for the import snapshot task.
StatusMessage (string) --
A detailed status message for the import snapshot task.
Url (string) --
The URL of the disk image from which the snapshot is created.
UserBucket (dict) --
The S3 bucket for the disk image.
S3Bucket (string) --
The S3 bucket from which the disk image was created.
S3Key (string) --
The file name of the disk image.
NextToken (string) --
The token to use to get the next page of results. This value is null when there are no more results to return.
{'Encrypted': 'boolean', 'KmsKeyId': 'string'}
Import single or multi-volume disk images or EBS snapshots into an Amazon Machine Image (AMI). For more information, see Importing a VM as an Image Using VM Import/Export in the VM Import/Export User Guide .
See also: AWS API Documentation
Request Syntax
client.import_image(
Architecture='string',
ClientData={
'Comment': 'string',
'UploadEnd': datetime(2015, 1, 1),
'UploadSize': 123.0,
'UploadStart': datetime(2015, 1, 1)
},
ClientToken='string',
Description='string',
DiskContainers=[
{
'Description': 'string',
'DeviceName': 'string',
'Format': 'string',
'SnapshotId': 'string',
'Url': 'string',
'UserBucket': {
'S3Bucket': 'string',
'S3Key': 'string'
}
},
],
DryRun=True|False,
Encrypted=True|False,
Hypervisor='string',
KmsKeyId='string',
LicenseType='string',
Platform='string',
RoleName='string'
)
string
The architecture of the virtual machine.
Valid values: i386 | x86_64
dict
The client-specific data.
Comment (string) --
A user-defined comment about the disk upload.
UploadEnd (datetime) --
The time that the disk upload ends.
UploadSize (float) --
The size of the uploaded disk image, in GiB.
UploadStart (datetime) --
The time that the disk upload starts.
string
The token to enable idempotency for VM import requests.
string
A description string for the import image task.
list
Information about the disk containers.
(dict) --
Describes the disk container object for an import image task.
Description (string) --
The description of the disk image.
DeviceName (string) --
The block device mapping for the disk.
Format (string) --
The format of the disk image being imported.
Valid values: VHD | VMDK | OVA
SnapshotId (string) --
The ID of the EBS snapshot to be used for importing the snapshot.
Url (string) --
The URL to the Amazon S3-based disk image being imported. The URL can either be a https URL (https://..) or an Amazon S3 URL (s3://..)
UserBucket (dict) --
The S3 bucket for the disk image.
S3Bucket (string) --
The name of the S3 bucket where the disk image is located.
S3Key (string) --
The file name of the disk image.
boolean
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation . Otherwise, it is UnauthorizedOperation .
boolean
Specifies whether the destination AMI of the imported image should be encrypted. The default CMK for EBS is used unless you specify a non-default AWS Key Management Service (AWS KMS) CMK using KmsKeyId . For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide .
string
The target hypervisor platform.
Valid values: xen
string
An identifier for the AWS Key Management Service (AWS KMS) customer master key (CMK) to use when creating the encrypted AMI. This parameter is only required if you want to use a non-default CMK; if this parameter is not specified, the default CMK for EBS is used. If a KmsKeyId is specified, the Encrypted flag must also be set.
The CMK identifier may be provided in any of the following formats:
Key ID
Key alias, in the form ``alias/ExampleAlias ``
ARN using key ID. The ID ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the key namespace, and then the CMK ID. For example, arn:aws:kms:us-east-1 :012345678910 :key/abcd1234-a123-456a-a12b-a123b4cd56ef .
ARN using key alias. The alias ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the alias namespace, and then the CMK alias. For example, arn:aws:kms:us-east-1 :012345678910 :alias/ExampleAlias .
AWS parses KmsKeyId asynchronously, meaning that the action you call may appear to complete even though you provided an invalid identifier. This action will eventually report failure.
The specified CMK must exist in the region that the AMI is being copied to.
string
The license type to be used for the Amazon Machine Image (AMI) after importing.
Note: You may only use BYOL if you have existing licenses with rights to use these licenses in a third party cloud like AWS. For more information, see Prerequisites in the VM Import/Export User Guide.
Valid values: AWS | BYOL
string
The operating system of the virtual machine.
Valid values: Windows | Linux
string
The name of the role to use when not using the default role, 'vmimport'.
dict
Response Syntax
{
'Architecture': 'string',
'Description': 'string',
'Encrypted': True|False,
'Hypervisor': 'string',
'ImageId': 'string',
'ImportTaskId': 'string',
'KmsKeyId': 'string',
'LicenseType': 'string',
'Platform': 'string',
'Progress': 'string',
'SnapshotDetails': [
{
'Description': 'string',
'DeviceName': 'string',
'DiskImageSize': 123.0,
'Format': 'string',
'Progress': 'string',
'SnapshotId': 'string',
'Status': 'string',
'StatusMessage': 'string',
'Url': 'string',
'UserBucket': {
'S3Bucket': 'string',
'S3Key': 'string'
}
},
],
'Status': 'string',
'StatusMessage': 'string'
}
Response Structure
(dict) --
Contains the output for ImportImage.
Architecture (string) --
The architecture of the virtual machine.
Description (string) --
A description of the import task.
Encrypted (boolean) --
Indicates whether the AMI is encypted.
Hypervisor (string) --
The target hypervisor of the import task.
ImageId (string) --
The ID of the Amazon Machine Image (AMI) created by the import task.
ImportTaskId (string) --
The task ID of the import image task.
KmsKeyId (string) --
The identifier for the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to create the encrypted AMI.
LicenseType (string) --
The license type of the virtual machine.
Platform (string) --
The operating system of the virtual machine.
Progress (string) --
The progress of the task.
SnapshotDetails (list) --
Information about the snapshots.
(dict) --
Describes the snapshot created from the imported disk.
Description (string) --
A description for the snapshot.
DeviceName (string) --
The block device mapping for the snapshot.
DiskImageSize (float) --
The size of the disk in the snapshot, in GiB.
Format (string) --
The format of the disk image from which the snapshot is created.
Progress (string) --
The percentage of progress for the task.
SnapshotId (string) --
The snapshot ID of the disk being imported.
Status (string) --
A brief status of the snapshot creation.
StatusMessage (string) --
A detailed status message for the snapshot creation.
Url (string) --
The URL used to access the disk image.
UserBucket (dict) --
The S3 bucket for the disk image.
S3Bucket (string) --
The S3 bucket from which the disk image was created.
S3Key (string) --
The file name of the disk image.
Status (string) --
A brief status of the task.
StatusMessage (string) --
A detailed status message of the import task.
{'Encrypted': 'boolean', 'KmsKeyId': 'string'}
Response {'SnapshotTaskDetail': {'Encrypted': 'boolean', 'KmsKeyId': 'string'}}
Imports a disk into an EBS snapshot.
See also: AWS API Documentation
Request Syntax
client.import_snapshot(
ClientData={
'Comment': 'string',
'UploadEnd': datetime(2015, 1, 1),
'UploadSize': 123.0,
'UploadStart': datetime(2015, 1, 1)
},
ClientToken='string',
Description='string',
DiskContainer={
'Description': 'string',
'Format': 'string',
'Url': 'string',
'UserBucket': {
'S3Bucket': 'string',
'S3Key': 'string'
}
},
DryRun=True|False,
Encrypted=True|False,
KmsKeyId='string',
RoleName='string'
)
dict
The client-specific data.
Comment (string) --
A user-defined comment about the disk upload.
UploadEnd (datetime) --
The time that the disk upload ends.
UploadSize (float) --
The size of the uploaded disk image, in GiB.
UploadStart (datetime) --
The time that the disk upload starts.
string
Token to enable idempotency for VM import requests.
string
The description string for the import snapshot task.
dict
Information about the disk container.
Description (string) --
The description of the disk image being imported.
Format (string) --
The format of the disk image being imported.
Valid values: VHD | VMDK | OVA
Url (string) --
The URL to the Amazon S3-based disk image being imported. It can either be a https URL (https://..) or an Amazon S3 URL (s3://..).
UserBucket (dict) --
The S3 bucket for the disk image.
S3Bucket (string) --
The name of the S3 bucket where the disk image is located.
S3Key (string) --
The file name of the disk image.
boolean
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation . Otherwise, it is UnauthorizedOperation .
boolean
Specifies whether the destination snapshot of the imported image should be encrypted. The default CMK for EBS is used unless you specify a non-default AWS Key Management Service (AWS KMS) CMK using KmsKeyId . For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide .
string
An identifier for the AWS Key Management Service (AWS KMS) customer master key (CMK) to use when creating the encrypted snapshot. This parameter is only required if you want to use a non-default CMK; if this parameter is not specified, the default CMK for EBS is used. If a KmsKeyId is specified, the Encrypted flag must also be set.
The CMK identifier may be provided in any of the following formats:
Key ID
Key alias, in the form ``alias/ExampleAlias ``
ARN using key ID. The ID ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the key namespace, and then the CMK ID. For example, arn:aws:kms:us-east-1 :012345678910 :key/abcd1234-a123-456a-a12b-a123b4cd56ef .
ARN using key alias. The alias ARN contains the arn:aws:kms namespace, followed by the region of the CMK, the AWS account ID of the CMK owner, the alias namespace, and then the CMK alias. For example, arn:aws:kms:us-east-1 :012345678910 :alias/ExampleAlias .
AWS parses KmsKeyId asynchronously, meaning that the action you call may appear to complete even though you provided an invalid identifier. This action will eventually report failure.
The specified CMK must exist in the region that the snapshot is being copied to.
string
The name of the role to use when not using the default role, 'vmimport'.
dict
Response Syntax
{
'Description': 'string',
'ImportTaskId': 'string',
'SnapshotTaskDetail': {
'Description': 'string',
'DiskImageSize': 123.0,
'Encrypted': True|False,
'Format': 'string',
'KmsKeyId': 'string',
'Progress': 'string',
'SnapshotId': 'string',
'Status': 'string',
'StatusMessage': 'string',
'Url': 'string',
'UserBucket': {
'S3Bucket': 'string',
'S3Key': 'string'
}
}
}
Response Structure
(dict) --
Contains the output for ImportSnapshot.
Description (string) --
A description of the import snapshot task.
ImportTaskId (string) --
The ID of the import snapshot task.
SnapshotTaskDetail (dict) --
Information about the import snapshot task.
Description (string) --
The description of the snapshot.
DiskImageSize (float) --
The size of the disk in the snapshot, in GiB.
Encrypted (boolean) --
Indicates whether the snapshot is encrypted.
Format (string) --
The format of the disk image from which the snapshot is created.
KmsKeyId (string) --
The identifier for the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to create the encrypted snapshot.
Progress (string) --
The percentage of completion for the import snapshot task.
SnapshotId (string) --
The snapshot ID of the disk being imported.
Status (string) --
A brief status for the import snapshot task.
StatusMessage (string) --
A detailed status message for the import snapshot task.
Url (string) --
The URL of the disk image from which the snapshot is created.
UserBucket (dict) --
The S3 bucket for the disk image.
S3Bucket (string) --
The S3 bucket from which the disk image was created.
S3Key (string) --
The file name of the disk image.