purchase_reserved_instances_offering¶
Operation¶
purchase_reserved_instances_offering
¶
purchase_reserved_instances_offering(request: PurchaseReservedInstancesOfferingInput | PurchaseReservedInstancesOfferingInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[PurchaseReservedInstancesOfferingInputDict]) -> PurchaseReservedInstancesOfferingOutput
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 |
purchase_reserved_instances_offering
async
¶
purchase_reserved_instances_offering(request: PurchaseReservedInstancesOfferingInput | PurchaseReservedInstancesOfferingInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[PurchaseReservedInstancesOfferingInputDict]) -> PurchaseReservedInstancesOfferingOutput
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 |
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
¶
The number of Reserved Instances to purchase.
limit_price
instance-attribute
¶
limit_price: ReservedInstanceLimitPrice | ReservedInstanceLimitPriceDict | None
Specified for Reserved Instance Marketplace offerings to limit the total order and ensure that the Reserved Instances are not purchased at unexpected prices.
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.
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
¶
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.