ImageCriterionRequest - Amazon Elastic Compute Cloud

ImageCriterionRequest

The criteria that are evaluated to determine which AMIs are discoverable and usable in your account for the specified AWS 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

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

Contents

CreationDateCondition

The maximum age for allowed images.

Type: CreationDateConditionRequest object

Required: No

DeprecationTimeCondition

The maximum period since deprecation for allowed images.

Type: DeprecationTimeConditionRequest object

Required: No

ImageNames

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

Type: Array of strings

Required: No

ImageProviders

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 AWS Marketplace.

  • aws-backup-vault: Allow AMIs created by AWS 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

Type: Array of strings

Required: No

MarketplaceProductCodes

The AWS Marketplace product codes for allowed images.

Length: 1-25 characters

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

Maximum: 50 values

Type: Array of strings

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: