Skip to content

Image

Source code in docs_src/capo_ec2/types/image.py
class Image(TypedDict, closed=True):
    platform_details: NotRequired["capo_ec2.types.string.String"]
    """<p>The platform details associated with the billing code of the AMI. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-billing-info.html">Understand AMI billing information</a> in the <i>Amazon EC2 User Guide</i>.</p>"""
    usage_operation: NotRequired["capo_ec2.types.string.String"]
    """<p>The operation of the Amazon EC2 instance and the billing code that is associated with the AMI. <code>usageOperation</code> corresponds to the <a href="https://docs.aws.amazon.com/cur/latest/userguide/Lineitem-columns.html#Lineitem-details-O-Operation">lineitem/Operation</a> column on your Amazon Web Services Cost and Usage Report and in the <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/price-changes.html">Amazon Web Services Price List API</a>. You can view these fields on the <b>Instances</b> or <b>AMIs</b> pages in the Amazon EC2 console, or in the responses that are returned by the <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeImages.html">DescribeImages</a> command in the Amazon EC2 API, or the <a href="https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html">describe-images</a> command in the CLI.</p>"""
    block_device_mappings: NotRequired[
        "capo_ec2.types.block_device_mapping_list.BlockDeviceMappingList"
    ]
    """<p>Any block device mapping entries.</p>"""
    description: NotRequired["capo_ec2.types.string.String"]
    """<p>The description of the AMI that was provided during image creation.</p>"""
    ena_support: NotRequired["capo_ec2.types.boolean.Boolean"]
    """<p>Specifies whether enhanced networking with ENA is enabled.</p>"""
    hypervisor: NotRequired["capo_ec2.types.hypervisor_type.HypervisorType"]
    """<p>The hypervisor type of the image. Only <code>xen</code> is supported. <code>ovm</code> is not supported.</p>"""
    image_owner_alias: NotRequired["capo_ec2.types.string.String"]
    """<p>The owner alias (<code>amazon</code> | <code>aws-backup-vault</code> | <code>aws-marketplace</code>).</p>"""
    name: NotRequired["capo_ec2.types.string.String"]
    """<p>The name of the AMI that was provided during image creation.</p>"""
    root_device_name: NotRequired["capo_ec2.types.string.String"]
    """<p>The device name of the root device volume (for example, <code>/dev/sda1</code>).</p>"""
    root_device_type: NotRequired["capo_ec2.types.device_type.DeviceType"]
    """<p>The type of root device used by the AMI. The AMI can use an Amazon EBS volume or an instance store volume.</p>"""
    sriov_net_support: NotRequired["capo_ec2.types.string.String"]
    """<p>Specifies whether enhanced networking with the Intel 82599 Virtual Function interface is enabled.</p>"""
    state_reason: NotRequired["capo_ec2.types.state_reason.StateReason"]
    """<p>The reason for the state change.</p>"""
    tags: NotRequired["capo_ec2.types.tag_list.TagList"]
    """<p>Any tags assigned to the image.</p>"""
    virtualization_type: NotRequired[
        "capo_ec2.types.virtualization_type.VirtualizationType"
    ]
    """<p>The type of virtualization of the AMI.</p>"""
    boot_mode: NotRequired["capo_ec2.types.boot_mode_values.BootModeValues"]
    """<p>The boot mode of the image. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-boot.html">Instance launch behavior with Amazon EC2 boot modes</a> in the <i>Amazon EC2 User Guide</i>.</p>"""
    tpm_support: NotRequired["capo_ec2.types.tpm_support_values.TpmSupportValues"]
    """<p>If the image is configured for NitroTPM support, the value is <code>v2.0</code>. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nitrotpm.html">NitroTPM</a> in the <i>Amazon EC2 User Guide</i>.</p>"""
    deprecation_time: NotRequired["capo_ec2.types.string.String"]
    """<p>The date and time to deprecate the AMI, in UTC, in the following format: <i>YYYY</i>-<i>MM</i>-<i>DD</i>T<i>HH</i>:<i>MM</i>:<i>SS</i>Z. If you specified a value for seconds, Amazon EC2 rounds the seconds to the nearest minute.</p>"""
    imds_support: NotRequired["capo_ec2.types.imds_support_values.ImdsSupportValues"]
    """<p>If <code>v2.0</code>, it indicates that IMDSv2 is specified in the AMI. Instances launched from this AMI will have <code>HttpTokens</code> automatically set to <code>required</code> so that, by default, the instance requires that IMDSv2 is used when requesting instance metadata. In addition, <code>HttpPutResponseHopLimit</code> is set to <code>2</code>. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-new-instances.html#configure-IMDS-new-instances-ami-configuration">Configure the AMI</a> in the <i>Amazon EC2 User Guide</i>.</p>"""
    source_instance_id: NotRequired["capo_ec2.types.string.String"]
    """<p>The ID of the instance that the AMI was created from if the AMI was created using <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateImage.html">CreateImage</a>. This field only appears if the AMI was created using CreateImage.</p>"""
    deregistration_protection: NotRequired["capo_ec2.types.string.String"]
    """<p>Indicates whether deregistration protection is enabled for the AMI.</p>"""
    last_launched_time: NotRequired["capo_ec2.types.string.String"]
    """<p>The date and time, in <a href="http://www.iso.org/iso/iso8601">ISO 8601 date-time format</a>, 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.</p> <note> <p> <code>lastLaunchedTime</code> data is available starting April 2017.</p> </note>"""
    image_allowed: NotRequired["capo_ec2.types.boolean.Boolean"]
    """<p>If <code>true</code>, the AMI satisfies the criteria for Allowed AMIs and can be discovered and used in the account. If <code>false</code> and Allowed AMIs is set to <code>enabled</code>, the AMI can't be discovered or used in the account. If <code>false</code> and Allowed AMIs is set to <code>audit-mode</code>, the AMI can be discovered and used in the account.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-allowed-amis.html">Control the discovery and use of AMIs in Amazon EC2 with Allowed AMIs</a> in <i>Amazon EC2 User Guide</i>.</p>"""
    source_image_id: NotRequired["capo_ec2.types.string.String"]
    """<p>The ID of the source AMI from which the AMI was created.</p>"""
    source_image_region: NotRequired["capo_ec2.types.string.String"]
    """<p>The Region of the source AMI.</p>"""
    free_tier_eligible: NotRequired["capo_ec2.types.boolean.Boolean"]
    """<p>Indicates whether the image is eligible for Amazon Web Services Free Tier.</p> <ul> <li> <p>If <code>true</code>, the AMI is eligible for Free Tier and can be used to launch instances under the Free Tier limits.</p> </li> <li> <p>If <code>false</code>, the AMI is not eligible for Free Tier.</p> </li> </ul>"""
    public_ssm_parameter_name: NotRequired["capo_ec2.types.string.String"]
    """<p>The name of the public Systems Manager parameter that resolves to this AMI, under the <code>aws/service/</code> namespace.</p>"""
    image_watermarks: NotRequired[
        "capo_ec2.types.image_watermark_list.ImageWatermarkList"
    ]
    """<p>The watermarks attached to the AMI.</p>"""
    instance_type_specification: NotRequired[
        "capo_ec2.types.instance_type_specification.InstanceTypeSpecification"
    ]
    """<p>The instance type specification for the AMI, which defines which instance types are compatible with this image.</p>"""
    image_id: NotRequired["capo_ec2.types.string.String"]
    """<p>The ID of the AMI.</p>"""
    image_location: NotRequired["capo_ec2.types.string.String"]
    """<p>The location of the AMI.</p>"""
    state: NotRequired["capo_ec2.types.image_state.ImageState"]
    """<p>The current state of the AMI. If the state is <code>available</code>, the image is successfully registered and can be used to launch an instance.</p>"""
    owner_id: NotRequired["capo_ec2.types.string.String"]
    """<p>The ID of the Amazon Web Services account that owns the image.</p>"""
    creation_date: NotRequired["capo_ec2.types.string.String"]
    """<p>The date and time the image was created.</p>"""
    public: NotRequired["capo_ec2.types.boolean.Boolean"]
    """<p>Indicates whether the image has public launch permissions. The value is <code>true</code> if this image has public launch permissions or <code>false</code> if it has only implicit and explicit launch permissions.</p>"""
    product_codes: NotRequired["capo_ec2.types.product_code_list.ProductCodeList"]
    """<p>Any product codes associated with the AMI.</p>"""
    architecture: NotRequired["capo_ec2.types.architecture_values.ArchitectureValues"]
    """<p>The architecture of the image.</p>"""
    image_type: NotRequired["capo_ec2.types.image_type_values.ImageTypeValues"]
    """<p>The type of image.</p>"""
    kernel_id: NotRequired["capo_ec2.types.string.String"]
    """<p>The kernel associated with the image, if any. Only applicable for machine images.</p>"""
    ramdisk_id: NotRequired["capo_ec2.types.string.String"]
    """<p>The RAM disk associated with the image, if any. Only applicable for machine images.</p>"""
    platform: NotRequired["capo_ec2.types.platform_values.PlatformValues"]
    """<p>This value is set to <code>windows</code> for Windows AMIs; otherwise, it is blank.</p>"""

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_id instance-attribute

image_id: NotRequired[String]

The ID of the AMI.

image_location instance-attribute

image_location: NotRequired[String]

The location of the AMI.

image_owner_alias instance-attribute

image_owner_alias: NotRequired[String]

The owner alias (amazon | aws-backup-vault | aws-marketplace).

image_type instance-attribute

image_type: NotRequired[ImageTypeValues]

The type of image.

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.

tags instance-attribute

tags: NotRequired[TagList]

Any tags assigned to the image.

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.