Struct aws_sdk_ec2::client::fluent_builders::DescribeHostReservationOfferings

pub struct DescribeHostReservationOfferings { /* private fields */ }

Fluent builder constructing a request to DescribeHostReservationOfferings.

Describes the Dedicated Host reservations that are available to purchase.

The results describe all of the Dedicated Host reservation offerings, including offerings that might not match the instance family and Region of your Dedicated Hosts. When purchasing an offering, ensure that the instance family and Region of the offering matches that of the Dedicated Hosts with which it is to be associated. For more information about supported instance types, see Dedicated Hosts in the Amazon EC2 User Guide.

Implementations

impl DescribeHostReservationOfferings

pub async fn customize(
    self
) -> Result<CustomizableOperation<DescribeHostReservationOfferings, AwsResponseRetryClassifier>, SdkError<DescribeHostReservationOfferingsError>>

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<DescribeHostReservationOfferingsOutput, SdkError<DescribeHostReservationOfferingsError>>

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) -> DescribeHostReservationOfferingsPaginator

Create a paginator for this request

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

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

Appends an item to Filter.

To override the contents of this collection use set_filter.

The filters.

• instance-family - The instance family of the offering (for example, m4).

• payment-option - The payment option (NoUpfront | PartialUpfront | AllUpfront).

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

The filters.

• instance-family - The instance family of the offering (for example, m4).

• payment-option - The payment option (NoUpfront | PartialUpfront | AllUpfront).

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

This is the maximum duration of the reservation to purchase, specified in seconds. Reservations are available in one-year and three-year terms. The number of seconds specified must be the number of seconds in a year (365x24x60x60) times one of the supported durations (1 or 3). For example, specify 94608000 for three years.

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

This is the maximum duration of the reservation to purchase, specified in seconds. Reservations are available in one-year and three-year terms. The number of seconds specified must be the number of seconds in a year (365x24x60x60) times one of the supported durations (1 or 3). For example, specify 94608000 for three years.

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

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned nextToken value. This value can be between 5 and 500. If maxResults is given a larger value than 500, you receive an error.

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

The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned nextToken value. This value can be between 5 and 500. If maxResults is given a larger value than 500, you receive an error.

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

This is the minimum duration of the reservation you'd like to purchase, specified in seconds. Reservations are available in one-year and three-year terms. The number of seconds specified must be the number of seconds in a year (365x24x60x60) times one of the supported durations (1 or 3). For example, specify 31536000 for one year.

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

This is the minimum duration of the reservation you'd like to purchase, specified in seconds. Reservations are available in one-year and three-year terms. The number of seconds specified must be the number of seconds in a year (365x24x60x60) times one of the supported durations (1 or 3). For example, specify 31536000 for one year.

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

The token to use to retrieve the next page of results.

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

The token to use to retrieve the next page of results.

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

The ID of the reservation offering.

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

The ID of the reservation offering.

Trait Implementations

impl Clone for DescribeHostReservationOfferings

fn clone(&self) -> DescribeHostReservationOfferings

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DescribeHostReservationOfferings

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

Formats the value using the given formatter.