Skip to content

purchase_reserved_instances_offering

Operation

purchase_reserved_instances_offering

Purchases a Reserved Instance for use with your account. With Reserved Instances, you pay a lower hourly rate compared to On-Demand instance pricing.

Use DescribeReservedInstancesOfferings to get a list of Reserved Instance offerings that match your specifications. After you've purchased a Reserved Instance, you can check for your new Reserved Instance with DescribeReservedInstances.

To queue a purchase for a future date and time, specify a purchase time. If you do not specify a purchase time, the default is the current time.

For more information, see Reserved Instances and Sell in the Reserved Instance Marketplace in the Amazon EC2 User Guide.

Parameters:

Name Type Description Default
request PurchaseReservedInstancesOfferingInput | PurchaseReservedInstancesOfferingInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[PurchaseReservedInstancesOfferingInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
PurchaseReservedInstancesOfferingOutput

An instance of PurchaseReservedInstancesOfferingOutput.

purchase_reserved_instances_offering async

Purchases a Reserved Instance for use with your account. With Reserved Instances, you pay a lower hourly rate compared to On-Demand instance pricing.

Use DescribeReservedInstancesOfferings to get a list of Reserved Instance offerings that match your specifications. After you've purchased a Reserved Instance, you can check for your new Reserved Instance with DescribeReservedInstances.

To queue a purchase for a future date and time, specify a purchase time. If you do not specify a purchase time, the default is the current time.

For more information, see Reserved Instances and Sell in the Reserved Instance Marketplace in the Amazon EC2 User Guide.

Parameters:

Name Type Description Default
request PurchaseReservedInstancesOfferingInput | PurchaseReservedInstancesOfferingInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[PurchaseReservedInstancesOfferingInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
PurchaseReservedInstancesOfferingOutput

An instance of PurchaseReservedInstancesOfferingOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

PurchaseReservedInstancesOfferingInputDict

Bases: TypedDict

Dictionary form of PurchaseReservedInstancesOfferingInput.

Attributes

dry_run instance-attribute
dry_run: bool | None

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 DryRunOperation. Otherwise, it is UnauthorizedOperation.

instance_count instance-attribute
instance_count: Required[int]

The number of Reserved Instances to purchase.

limit_price instance-attribute

Specified for Reserved Instance Marketplace offerings to limit the total order and ensure that the Reserved Instances are not purchased at unexpected prices.

purchase_time instance-attribute
purchase_time: datetime | None

The time at which to purchase the Reserved Instance, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

reserved_instances_offering_id instance-attribute
reserved_instances_offering_id: Required[str]

The ID of the Reserved Instance offering to purchase.

PurchaseReservedInstancesOfferingInput dataclass

Bases: _SerdeShape

Contains the parameters for PurchaseReservedInstancesOffering.

Attributes

dry_run class-attribute instance-attribute
dry_run: bool | None = ...

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 DryRunOperation. Otherwise, it is UnauthorizedOperation.

instance_count class-attribute instance-attribute
instance_count: int | None = ...

The number of Reserved Instances to purchase.

limit_price class-attribute instance-attribute
limit_price: ReservedInstanceLimitPrice | None = ...

Specified for Reserved Instance Marketplace offerings to limit the total order and ensure that the Reserved Instances are not purchased at unexpected prices.

purchase_time class-attribute instance-attribute
purchase_time: datetime | None = ...

The time at which to purchase the Reserved Instance, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

reserved_instances_offering_id class-attribute instance-attribute
reserved_instances_offering_id: str | None = ...

The ID of the Reserved Instance offering to purchase.

Output

PurchaseReservedInstancesOfferingOutput dataclass

Bases: _SerdeShape

Contains the output of PurchaseReservedInstancesOffering.

Attributes

reserved_instances_id class-attribute instance-attribute
reserved_instances_id: str | None = ...

The IDs of the purchased Reserved Instances. If your purchase crosses into a discounted pricing tier, the final Reserved Instances IDs might change. For more information, see Crossing pricing tiers in the Amazon EC2 User Guide.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.