Struct aws_sdk_ec2::client::fluent_builders::DescribeSpotPriceHistory

pub struct DescribeSpotPriceHistory { /* private fields */ }

Fluent builder constructing a request to DescribeSpotPriceHistory.

Describes the Spot price history. For more information, see Spot Instance pricing history in the Amazon EC2 User Guide for Linux Instances.

When you specify a start and end time, the operation returns the prices of the instance types within that time range. It also returns the last price change before the start time, which is the effective price as of the start time.

Implementations

impl DescribeSpotPriceHistory

pub async fn customize(
    self
) -> Result<CustomizableOperation<DescribeSpotPriceHistory, AwsResponseRetryClassifier>, SdkError<DescribeSpotPriceHistoryError>>

Consume this builder, creating a customizable operation that can be modified before being sent. The operation’s inner http::Request can be modified as well.

pub async fn send(
    self
) -> Result<DescribeSpotPriceHistoryOutput, SdkError<DescribeSpotPriceHistoryError>>

Sends the request and returns the response.

If an error occurs, an SdkError will be returned with additional details that can be matched against.

By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.

pub fn into_paginator(self) -> DescribeSpotPriceHistoryPaginator

Create a paginator for this request

Paginators are used by calling send().await which returns a Stream.

pub fn filters(self, input: Filter) -> Self

Appends an item to Filters.

To override the contents of this collection use set_filters.

One or more filters.

• availability-zone - The Availability Zone for which prices should be returned.

• instance-type - The type of instance (for example, m3.medium).

• product-description - The product description for the Spot price (Linux/UNIX | Red Hat Enterprise Linux | SUSE Linux | Windows | Linux/UNIX (Amazon VPC) | Red Hat Enterprise Linux (Amazon VPC) | SUSE Linux (Amazon VPC) | Windows (Amazon VPC)).

• spot-price - The Spot price. The value must match exactly (or use wildcards; greater than or less than comparison is not supported).

• timestamp - The time stamp of the Spot price history, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). You can use wildcards (* and ?). Greater than or less than comparison is not supported.

pub fn set_filters(self, input: Option<Vec<Filter>>) -> Self

One or more filters.

• availability-zone - The Availability Zone for which prices should be returned.

• instance-type - The type of instance (for example, m3.medium).

• product-description - The product description for the Spot price (Linux/UNIX | Red Hat Enterprise Linux | SUSE Linux | Windows | Linux/UNIX (Amazon VPC) | Red Hat Enterprise Linux (Amazon VPC) | SUSE Linux (Amazon VPC) | Windows (Amazon VPC)).

• spot-price - The Spot price. The value must match exactly (or use wildcards; greater than or less than comparison is not supported).

• timestamp - The time stamp of the Spot price history, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). You can use wildcards (* and ?). Greater than or less than comparison is not supported.

pub fn availability_zone(self, input: impl Into<String>) -> Self

Filters the results by the specified Availability Zone.

pub fn set_availability_zone(self, input: Option<String>) -> Self

Filters the results by the specified Availability Zone.

pub fn dry_run(self, input: bool) -> Self

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.

pub fn set_dry_run(self, input: Option<bool>) -> Self

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.

pub fn end_time(self, input: DateTime) -> Self

The date and time, up to the current date, from which to stop retrieving the price history data, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

pub fn set_end_time(self, input: Option<DateTime>) -> Self

The date and time, up to the current date, from which to stop retrieving the price history data, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

pub fn instance_types(self, input: InstanceType) -> Self

Appends an item to InstanceTypes.

To override the contents of this collection use set_instance_types.

Filters the results by the specified instance types.

pub fn set_instance_types(self, input: Option<Vec<InstanceType>>) -> Self

Filters the results by the specified instance types.

pub fn max_results(self, input: i32) -> Self

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

pub fn set_max_results(self, input: Option<i32>) -> Self

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

pub fn next_token(self, input: impl Into<String>) -> Self

The token for the next set of results.

pub fn set_next_token(self, input: Option<String>) -> Self

The token for the next set of results.

pub fn product_descriptions(self, input: impl Into<String>) -> Self

Appends an item to ProductDescriptions.

To override the contents of this collection use set_product_descriptions.

Filters the results by the specified basic product descriptions.

pub fn set_product_descriptions(self, input: Option<Vec<String>>) -> Self

Filters the results by the specified basic product descriptions.

pub fn start_time(self, input: DateTime) -> Self

The date and time, up to the past 90 days, from which to start retrieving the price history data, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

pub fn set_start_time(self, input: Option<DateTime>) -> Self

The date and time, up to the past 90 days, from which to start retrieving the price history data, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

Trait Implementations

impl Clone for DescribeSpotPriceHistory

fn clone(&self) -> DescribeSpotPriceHistory

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DescribeSpotPriceHistory

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.