AWS SDK Version 4 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

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:

Each ImageCriterion can include up to:

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

Inheritance Hierarchy

System.Object
  Amazon.EC2.Model.ImageCriterionRequest

Namespace: Amazon.EC2.Model
Assembly: AWSSDK.EC2.dll
Version: 3.x.y.z

Syntax

C#
public class ImageCriterionRequest

The ImageCriterionRequest type exposes the following members

Constructors

NameDescription
Public Method ImageCriterionRequest()

Properties

NameTypeDescription
Public Property CreationDateCondition Amazon.EC2.Model.CreationDateConditionRequest

Gets and sets the property CreationDateCondition.

The maximum age for allowed images.

Public Property DeprecationTimeCondition Amazon.EC2.Model.DeprecationTimeConditionRequest

Gets and sets the property DeprecationTimeCondition.

The maximum period since deprecation for allowed images.

Public Property ImageNames System.Collections.Generic.List<System.String>

Gets and sets the property 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

Starting with version 4 of the SDK this property will default to null. If no data for this property is returned from the service the property will also be null. This was changed to improve performance and allow the SDK and caller to distinguish between a property not set or a property being empty to clear out a value. To retain the previous SDK behavior set the AWSConfigs.InitializeCollections static property to true.

Public Property ImageProviders System.Collections.Generic.List<System.String>

Gets and sets the property 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 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

Starting with version 4 of the SDK this property will default to null. If no data for this property is returned from the service the property will also be null. This was changed to improve performance and allow the SDK and caller to distinguish between a property not set or a property being empty to clear out a value. To retain the previous SDK behavior set the AWSConfigs.InitializeCollections static property to true.

Public Property MarketplaceProductCodes System.Collections.Generic.List<System.String>

Gets and sets the property MarketplaceProductCodes.

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

Starting with version 4 of the SDK this property will default to null. If no data for this property is returned from the service the property will also be null. This was changed to improve performance and allow the SDK and caller to distinguish between a property not set or a property being empty to clear out a value. To retain the previous SDK behavior set the AWSConfigs.InitializeCollections static property to true.

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.7.2 and newer