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.

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:

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.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.7.2 or higher.

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

Syntax

C#
public abstract Task<ReplaceImageInstanceTypeSpecificationResponse> ReplaceImageInstanceTypeSpecificationAsync(
         ReplaceImageInstanceTypeSpecificationRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.EC2.Model.ReplaceImageInstanceTypeSpecificationRequest

Container for the necessary parameters to execute the ReplaceImageInstanceTypeSpecification service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the ReplaceImageInstanceTypeSpecification service method, as returned by EC2.

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

See Also