View a markdown version of this page

ðŸ”ī Hot News: AWSEC/latest/APIReference/API ImageCriterionRequest.html - āļŠāļĢāļļāļ›āļ”āļĢāļēāļĄāđˆāļēāļĨāđˆāļēāļŠāļļāļ”

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

  • 50 values for ImageWatermarks

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

ImageName.N

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

ImageProvider.N

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

ImageWatermark.N

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

Type: Array of ImageWatermarkFilterRequest objects

Required: No

MarketplaceProductCode.N

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: