aws_sdk_mediaconnect/client/list_reservations.rs
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2impl super::Client {
3 /// Constructs a fluent builder for the [`ListReservations`](crate::operation::list_reservations::builders::ListReservationsFluentBuilder) operation.
4 /// This operation supports pagination; See [`into_paginator()`](crate::operation::list_reservations::builders::ListReservationsFluentBuilder::into_paginator).
5 ///
6 /// - The fluent builder is configurable:
7 /// - [`max_results(i32)`](crate::operation::list_reservations::builders::ListReservationsFluentBuilder::max_results) / [`set_max_results(Option<i32>)`](crate::operation::list_reservations::builders::ListReservationsFluentBuilder::set_max_results):<br>required: **false**<br><p>The maximum number of results to return per API request.</p> <p>For example, you submit a <code>ListReservations</code> request with <code>MaxResults</code> set at 5. Although 20 items match your request, the service returns no more than the first 5 items. (The service also returns a NextToken value that you can use to fetch the next batch of results.)</p> <p>The service might return fewer results than the <code>MaxResults</code> value. If <code>MaxResults</code> is not included in the request, the service defaults to pagination with a maximum of 10 results per page.</p><br>
8 /// - [`next_token(impl Into<String>)`](crate::operation::list_reservations::builders::ListReservationsFluentBuilder::next_token) / [`set_next_token(Option<String>)`](crate::operation::list_reservations::builders::ListReservationsFluentBuilder::set_next_token):<br>required: **false**<br><p>The token that identifies the batch of results that you want to see.</p> <p>For example, you submit a <code>ListReservations</code> request with <code>MaxResults</code> set at 5. The service returns the first batch of results (up to 5) and a <code>NextToken</code> value. To see the next batch of results, you can submit the <code>ListOfferings</code> request a second time and specify the <code>NextToken</code> value.</p><br>
9 /// - On success, responds with [`ListReservationsOutput`](crate::operation::list_reservations::ListReservationsOutput) with field(s):
10 /// - [`next_token(Option<String>)`](crate::operation::list_reservations::ListReservationsOutput::next_token): <p>The token that identifies the batch of results that you want to see.</p> <p>For example, you submit a <code>ListReservations</code> request with <code>MaxResults</code> set at 5. The service returns the first batch of results (up to 5) and a <code>NextToken</code> value. To see the next batch of results, you can submit the <code>ListReservations</code> request a second time and specify the <code>NextToken</code> value.</p>
11 /// - [`reservations(Option<Vec::<Reservation>>)`](crate::operation::list_reservations::ListReservationsOutput::reservations): <p>A list of all reservations that have been purchased by this account in the current Amazon Web Services Region.</p>
12 /// - On failure, responds with [`SdkError<ListReservationsError>`](crate::operation::list_reservations::ListReservationsError)
13 pub fn list_reservations(&self) -> crate::operation::list_reservations::builders::ListReservationsFluentBuilder {
14 crate::operation::list_reservations::builders::ListReservationsFluentBuilder::new(self.handle.clone())
15 }
16}