Image
¶
Source code in docs_src/capo_ec2/types/image.py
architecture
instance-attribute
¶
architecture: NotRequired[ArchitectureValues]
The architecture of the image.
block_device_mappings
instance-attribute
¶
block_device_mappings: NotRequired[BlockDeviceMappingList]
Any block device mapping entries.
boot_mode
instance-attribute
¶
boot_mode: NotRequired[BootModeValues]
The boot mode of the image. For more information, see Instance launch behavior with Amazon EC2 boot modes in the Amazon EC2 User Guide.
creation_date
instance-attribute
¶
creation_date: NotRequired[String]
The date and time the image was created.
deprecation_time
instance-attribute
¶
deprecation_time: NotRequired[String]
The date and time to deprecate the AMI, in UTC, in the following format: YYYY-MM-DDTHH:MM:SSZ. If you specified a value for seconds, Amazon EC2 rounds the seconds to the nearest minute.
deregistration_protection
instance-attribute
¶
deregistration_protection: NotRequired[String]
Indicates whether deregistration protection is enabled for the AMI.
description
instance-attribute
¶
description: NotRequired[String]
The description of the AMI that was provided during image creation.
ena_support
instance-attribute
¶
ena_support: NotRequired[Boolean]
Specifies whether enhanced networking with ENA is enabled.
free_tier_eligible
instance-attribute
¶
free_tier_eligible: NotRequired[Boolean]
Indicates whether the image is eligible for Amazon Web Services Free Tier.
-
If
true, the AMI is eligible for Free Tier and can be used to launch instances under the Free Tier limits. -
If
false, the AMI is not eligible for Free Tier.
hypervisor
instance-attribute
¶
hypervisor: NotRequired[HypervisorType]
The hypervisor type of the image. Only xen is supported. ovm is not supported.
image_allowed
instance-attribute
¶
image_allowed: NotRequired[Boolean]
If true, the AMI satisfies the criteria for Allowed AMIs and can be discovered and used in the account. If false and Allowed AMIs is set to enabled, the AMI can't be discovered or used in the account. If false and Allowed AMIs is set to audit-mode, the AMI can be discovered and used in the account.
For more information, see Control the discovery and use of AMIs in Amazon EC2 with Allowed AMIs in Amazon EC2 User Guide.
image_owner_alias
instance-attribute
¶
image_owner_alias: NotRequired[String]
The owner alias (amazon | aws-backup-vault | aws-marketplace).
image_watermarks
instance-attribute
¶
image_watermarks: NotRequired[ImageWatermarkList]
The watermarks attached to the AMI.
imds_support
instance-attribute
¶
imds_support: NotRequired[ImdsSupportValues]
If v2.0, it indicates that IMDSv2 is specified in the AMI. Instances launched from this AMI will have HttpTokens automatically set to required so that, by default, the instance requires that IMDSv2 is used when requesting instance metadata. In addition, HttpPutResponseHopLimit is set to 2. For more information, see Configure the AMI in the Amazon EC2 User Guide.
instance_type_specification
instance-attribute
¶
instance_type_specification: NotRequired[InstanceTypeSpecification]
The instance type specification for the AMI, which defines which instance types are compatible with this image.
kernel_id
instance-attribute
¶
kernel_id: NotRequired[String]
The kernel associated with the image, if any. Only applicable for machine images.
last_launched_time
instance-attribute
¶
last_launched_time: NotRequired[String]
The date and time, in ISO 8601 date-time format, when the AMI was last used to launch an EC2 instance. When the AMI is used to launch an instance, there is a 24-hour delay before that usage is reported.
lastLaunchedTime data is available starting April 2017.
name
instance-attribute
¶
name: NotRequired[String]
The name of the AMI that was provided during image creation.
owner_id
instance-attribute
¶
owner_id: NotRequired[String]
The ID of the Amazon Web Services account that owns the image.
platform
instance-attribute
¶
platform: NotRequired[PlatformValues]
This value is set to windows for Windows AMIs; otherwise, it is blank.
platform_details
instance-attribute
¶
platform_details: NotRequired[String]
The platform details associated with the billing code of the AMI. For more information, see Understand AMI billing information in the Amazon EC2 User Guide.
product_codes
instance-attribute
¶
product_codes: NotRequired[ProductCodeList]
Any product codes associated with the AMI.
public
instance-attribute
¶
public: NotRequired[Boolean]
Indicates whether the image has public launch permissions. The value is true if this image has public launch permissions or false if it has only implicit and explicit launch permissions.
public_ssm_parameter_name
instance-attribute
¶
public_ssm_parameter_name: NotRequired[String]
The name of the public Systems Manager parameter that resolves to this AMI, under the aws/service/ namespace.
ramdisk_id
instance-attribute
¶
ramdisk_id: NotRequired[String]
The RAM disk associated with the image, if any. Only applicable for machine images.
root_device_name
instance-attribute
¶
root_device_name: NotRequired[String]
The device name of the root device volume (for example, /dev/sda1).
root_device_type
instance-attribute
¶
root_device_type: NotRequired[DeviceType]
The type of root device used by the AMI. The AMI can use an Amazon EBS volume or an instance store volume.
source_image_id
instance-attribute
¶
source_image_id: NotRequired[String]
The ID of the source AMI from which the AMI was created.
source_image_region
instance-attribute
¶
source_image_region: NotRequired[String]
The Region of the source AMI.
source_instance_id
instance-attribute
¶
source_instance_id: NotRequired[String]
The ID of the instance that the AMI was created from if the AMI was created using CreateImage. This field only appears if the AMI was created using CreateImage.
sriov_net_support
instance-attribute
¶
sriov_net_support: NotRequired[String]
Specifies whether enhanced networking with the Intel 82599 Virtual Function interface is enabled.
state
instance-attribute
¶
state: NotRequired[ImageState]
The current state of the AMI. If the state is available, the image is successfully registered and can be used to launch an instance.
state_reason
instance-attribute
¶
state_reason: NotRequired[StateReason]
The reason for the state change.
tpm_support
instance-attribute
¶
tpm_support: NotRequired[TpmSupportValues]
If the image is configured for NitroTPM support, the value is v2.0. For more information, see NitroTPM in the Amazon EC2 User Guide.
usage_operation
instance-attribute
¶
usage_operation: NotRequired[String]
The operation of the Amazon EC2 instance and the billing code that is associated with the AMI. usageOperation corresponds to the lineitem/Operation column on your Amazon Web Services Cost and Usage Report and in the Amazon Web Services Price List API. You can view these fields on the Instances or AMIs pages in the Amazon EC2 console, or in the responses that are returned by the DescribeImages command in the Amazon EC2 API, or the describe-images command in the CLI.
virtualization_type
instance-attribute
¶
virtualization_type: NotRequired[VirtualizationType]
The type of virtualization of the AMI.