Skip to content

EC2  >  Structures  >  ImageCriterionRequest

ImageCriterionRequest

Structure Class

ImageCriterionRequest dataclass

Bases: _SerdeShape

The criteria that are evaluated to determine which AMIs are discoverable and usable in your account for the specified Amazon Web Services Region.

The ImageCriteria can include up to:

  • 10 ImageCriterion

Each ImageCriterion can include up to:

  • 200 values for ImageProviders

  • 50 values for ImageNames

  • 50 values for MarketplaceProductCodes

  • 50 values for ImageWatermarks

For more information, see How Allowed AMIs works in the Amazon EC2 User Guide.

Attributes

creation_date_condition class-attribute instance-attribute 
creation_date_condition: CreationDateConditionRequest | None = ...

The maximum age for allowed images.

deprecation_time_condition class-attribute instance-attribute 
deprecation_time_condition: DeprecationTimeConditionRequest | None = ...

The maximum period since deprecation for allowed images.

image_names class-attribute instance-attribute 
image_names: list[str] | None = ...

The names of allowed images. Names can include wildcards (? and *).

Length: 1--128 characters. With ?, the minimum is 3 characters.

Valid characters:

  • Letters: A–Z, a–z

  • Numbers: 0–9

  • Special characters: ( ) [ ] . / - ' @ _ * ?

  • Spaces

Maximum: 50 values

image_providers class-attribute instance-attribute 
image_providers: list[str] | None = ...

The image providers whose images are allowed.

Possible values:

  • amazon: Allow AMIs created by Amazon or verified providers.

  • aws-marketplace: Allow AMIs created by verified providers in the Amazon Web Services Marketplace.

  • aws-backup-vault: Allow AMIs created by Amazon Web Services Backup.

  • 12-digit account ID: Allow AMIs created by the specified accounts. One or more account IDs can be specified.

  • none: Allow AMIs created by your own account only. When none is specified, no other values can be specified.

Maximum: 200 values

image_watermarks class-attribute instance-attribute 
image_watermarks: list[ImageWatermarkFilterRequest] | None = ...

The watermark criteria that an AMI must match to be allowed. An AMI is allowed if it carries at least one watermark that satisfies an ImageWatermarkFilter. A watermark satisfies a filter when all specified fields in the ImageWatermarkFilter match the corresponding values on the watermark of the AMI.

Maximum: 50 values

marketplace_product_codes class-attribute instance-attribute 
marketplace_product_codes: list[str] | None = ...

The Amazon Web Services Marketplace product codes for allowed images.

Length: 1-25 characters

Valid characters: Letters (A–Z, a–z) and numbers (0–9)

Maximum: 50 values

scan_result_condition class-attribute instance-attribute 
scan_result_condition: ScanResultConditionRequest | None = ...

The Amazon Inspector scan-result criteria that an AMI must meet to be allowed. The criteria can limit the highest finding severity, the number of days since Amazon Inspector last scanned the AMI, and the number of days since Amazon Inspector reported a fix as available.