Container for the parameters to the ReplaceImageInstanceTypeSpecification operation. Replaces or removes the instance type specification for an AMI. The instance type specification defines which instance types are compatible with the AMI.
When you launch an instance using RunInstances,
Amazon EC2 validates the requested instance type against the AMI's instance type specification.
If the instance type is not compatible, the request fails with an InvalidParameterCombination
error.
You can specify supported instance types, unsupported instance types, or both. The evaluation logic is as follows:
No specification set – all instance types are allowed.
Only
UnsupportedInstanceTypesset – All instance types are allowed except those that match the unsupported list.SupportedInstanceTypesset – The instance type must match the supported list and must not match the unsupported list.
Instance type entries support wildcard patterns using * (for example, t3.*
matches all t3 sizes).
To remove an existing instance type specification, omit the InstanceTypeSpecification
parameter or set it to null.
To set the instance type specification, you must be the AMI owner. You cannot set an instance type specification on an AMI that is listed in Amazon Web Services Marketplace, and you cannot list an AMI in Amazon Web Services Marketplace if it has an instance type specification set.
In this article ▶
Inheritance Hierarchy
Amazon.Runtime.AmazonWebServiceRequest
Amazon.EC2.AmazonEC2Request
Amazon.EC2.Model.ReplaceImageInstanceTypeSpecificationRequest
Namespace: Amazon.EC2.Model
Assembly: AWSSDK.EC2.dll
Version: 3.x.y.z
Syntax
public class ReplaceImageInstanceTypeSpecificationRequest : AmazonEC2Request IAmazonWebServiceRequest
The ReplaceImageInstanceTypeSpecificationRequest type exposes the following members
Constructors
| Name | Description | |
|---|---|---|
|
ReplaceImageInstanceTypeSpecificationRequest() |
Properties
| Name | Type | Description | |
|---|---|---|---|
|
|
DryRun | System.Nullable<System.Boolean> |
Gets and sets the property DryRun.
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 |
|
|
ImageId | System.String |
Gets and sets the property ImageId. The ID of the AMI. |
|
|
InstanceTypeSpecification | Amazon.EC2.Model.InstanceTypeSpecificationRequest |
Gets and sets the property InstanceTypeSpecification. The instance type specification to set on the AMI. Omit this parameter to remove the existing instance type specification. |
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