Struct aws_sdk_ec2::client::fluent_builders::DescribeHostReservations

source ·

pub struct DescribeHostReservations { /* private fields */ }

Expand description

Fluent builder constructing a request to DescribeHostReservations.

Describes reservations that are associated with Dedicated Hosts in your account.

Implementations§

source §

impl DescribeHostReservations

source

pub async fn customize(
self
) -> Result<CustomizableOperation<DescribeHostReservations, AwsResponseRetryClassifier>, SdkError<DescribeHostReservationsError>>

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.

source

pub async fn send(
self
) -> Result<DescribeHostReservationsOutput, SdkError<DescribeHostReservationsError>>

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.

source

pub fn into_paginator(self) -> DescribeHostReservationsPaginator

Create a paginator for this request

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

source

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 (for example, m4).
payment-option - The payment option (NoUpfront | PartialUpfront | AllUpfront).
state - The state of the reservation (payment-pending | payment-failed | active | retired).
tag: - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.
tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

source

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

The filters.

instance-family - The instance family (for example, m4).
payment-option - The payment option (NoUpfront | PartialUpfront | AllUpfront).
state - The state of the reservation (payment-pending | payment-failed | active | retired).
tag: - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.
tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

source

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

Appends an item to HostReservationIdSet.

To override the contents of this collection use set_host_reservation_id_set.

The host reservation IDs.

source

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

The host reservation IDs.

source

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.

source

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.

source