Skip to content

EC2  >  Operations  >  describe_image_attribute

describe_image_attribute

Operation

describe_image_attribute async

describe_image_attribute(input: DescribeImageAttributeInput, plugins: list[Plugin] | None = None) -> DescribeImageAttributeOutput

Describes the specified attribute of the specified AMI. You can specify only one attribute at a time.

Note

The order of the elements in the response, including those within nested structures, might vary. Applications should not assume the elements appear in a particular order.

Parameters:

Name Type Description Default
input DescribeImageAttributeInput

An instance of DescribeImageAttributeInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
DescribeImageAttributeOutput

An instance of DescribeImageAttributeOutput.

Input

DescribeImageAttributeInput dataclass

Bases: _SerdeShape

Contains the parameters for DescribeImageAttribute.

Attributes

attribute class-attribute instance-attribute
attribute: str | None = ...

The AMI attribute.

Note: The blockDeviceMapping attribute is deprecated. Using this attribute returns the Client.AuthFailure error. To get information about the block device mappings for an AMI, describe the image instead.

dry_run class-attribute instance-attribute
dry_run: bool | None = ...

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.

image_id class-attribute instance-attribute
image_id: str | None = ...

The ID of the AMI.

Output

DescribeImageAttributeOutput dataclass

Bases: _SerdeShape

Describes an image attribute.

Attributes

block_device_mappings class-attribute instance-attribute
block_device_mappings: list[BlockDeviceMapping] | None = ...

The block device mapping entries.

boot_mode class-attribute instance-attribute
boot_mode: AttributeValue | None = ...

The boot mode.

deregistration_protection class-attribute instance-attribute
deregistration_protection: AttributeValue | None = ...

Indicates whether deregistration protection is enabled for the AMI.

description class-attribute instance-attribute
description: AttributeValue | None = ...

A description for the AMI.

image_id class-attribute instance-attribute
image_id: str | None = ...

The ID of the AMI.

imds_support class-attribute instance-attribute
imds_support: AttributeValue | None = ...

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.

kernel_id class-attribute instance-attribute
kernel_id: AttributeValue | None = ...

The kernel ID.

last_launched_time class-attribute instance-attribute
last_launched_time: AttributeValue | None = ...

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.

Note

lastLaunchedTime data is available starting April 2017.

launch_permissions class-attribute instance-attribute
launch_permissions: list[LaunchPermission] | None = ...

The launch permissions.

product_codes class-attribute instance-attribute
product_codes: list[ProductCode] | None = ...

The product codes.

ramdisk_id class-attribute instance-attribute
ramdisk_id: AttributeValue | None = ...

The RAM disk ID.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.

sriov_net_support class-attribute instance-attribute
sriov_net_support: AttributeValue | None = ...

Indicates whether enhanced networking with the Intel 82599 Virtual Function interface is enabled.

tpm_support class-attribute instance-attribute
tpm_support: AttributeValue | None = ...

If the image is configured for NitroTPM support, the value is v2.0.

uefi_data class-attribute instance-attribute
uefi_data: AttributeValue | None = ...

Base64 representation of the non-volatile UEFI variable store. To retrieve the UEFI data, use the GetInstanceUefiData command. You can inspect and modify the UEFI data by using the python-uefivars tool on GitHub. For more information, see UEFI Secure Boot for Amazon EC2 instances in the Amazon EC2 User Guide.