aws_sdk_fsx/operation/describe_data_repository_associations/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::describe_data_repository_associations::_describe_data_repository_associations_output::DescribeDataRepositoryAssociationsOutputBuilder;
3
4pub use crate::operation::describe_data_repository_associations::_describe_data_repository_associations_input::DescribeDataRepositoryAssociationsInputBuilder;
5
6impl crate::operation::describe_data_repository_associations::builders::DescribeDataRepositoryAssociationsInputBuilder {
7    /// Sends a request with this input using the given client.
8    pub async fn send_with(
9        self,
10        client: &crate::Client,
11    ) -> ::std::result::Result<
12        crate::operation::describe_data_repository_associations::DescribeDataRepositoryAssociationsOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::describe_data_repository_associations::DescribeDataRepositoryAssociationsError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.describe_data_repository_associations();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `DescribeDataRepositoryAssociations`.
24///
25/// <p>Returns the description of specific Amazon FSx for Lustre or Amazon File Cache data repository associations, if one or more <code>AssociationIds</code> values are provided in the request, or if filters are used in the request. Data repository associations are supported on Amazon File Cache resources and all FSx for Lustre 2.12 and 2,15 file systems, excluding <code>scratch_1</code> deployment type.</p>
26/// <p>You can use filters to narrow the response to include just data repository associations for specific file systems (use the <code>file-system-id</code> filter with the ID of the file system) or caches (use the <code>file-cache-id</code> filter with the ID of the cache), or data repository associations for a specific repository type (use the <code>data-repository-type</code> filter with a value of <code>S3</code> or <code>NFS</code>). If you don't use filters, the response returns all data repository associations owned by your Amazon Web Services account in the Amazon Web Services Region of the endpoint that you're calling.</p>
27/// <p>When retrieving all data repository associations, you can paginate the response by using the optional <code>MaxResults</code> parameter to limit the number of data repository associations returned in a response. If more data repository associations remain, a <code>NextToken</code> value is returned in the response. In this case, send a later request with the <code>NextToken</code> request parameter set to the value of <code>NextToken</code> from the last response.</p>
28#[derive(::std::clone::Clone, ::std::fmt::Debug)]
29pub struct DescribeDataRepositoryAssociationsFluentBuilder {
30    handle: ::std::sync::Arc<crate::client::Handle>,
31    inner: crate::operation::describe_data_repository_associations::builders::DescribeDataRepositoryAssociationsInputBuilder,
32    config_override: ::std::option::Option<crate::config::Builder>,
33}
34impl
35    crate::client::customize::internal::CustomizableSend<
36        crate::operation::describe_data_repository_associations::DescribeDataRepositoryAssociationsOutput,
37        crate::operation::describe_data_repository_associations::DescribeDataRepositoryAssociationsError,
38    > for DescribeDataRepositoryAssociationsFluentBuilder
39{
40    fn send(
41        self,
42        config_override: crate::config::Builder,
43    ) -> crate::client::customize::internal::BoxFuture<
44        crate::client::customize::internal::SendResult<
45            crate::operation::describe_data_repository_associations::DescribeDataRepositoryAssociationsOutput,
46            crate::operation::describe_data_repository_associations::DescribeDataRepositoryAssociationsError,
47        >,
48    > {
49        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
50    }
51}
52impl DescribeDataRepositoryAssociationsFluentBuilder {
53    /// Creates a new `DescribeDataRepositoryAssociationsFluentBuilder`.
54    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
55        Self {
56            handle,
57            inner: ::std::default::Default::default(),
58            config_override: ::std::option::Option::None,
59        }
60    }
61    /// Access the DescribeDataRepositoryAssociations as a reference.
62    pub fn as_input(&self) -> &crate::operation::describe_data_repository_associations::builders::DescribeDataRepositoryAssociationsInputBuilder {
63        &self.inner
64    }
65    /// Sends the request and returns the response.
66    ///
67    /// If an error occurs, an `SdkError` will be returned with additional details that
68    /// can be matched against.
69    ///
70    /// By default, any retryable failures will be retried twice. Retry behavior
71    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
72    /// set when configuring the client.
73    pub async fn send(
74        self,
75    ) -> ::std::result::Result<
76        crate::operation::describe_data_repository_associations::DescribeDataRepositoryAssociationsOutput,
77        ::aws_smithy_runtime_api::client::result::SdkError<
78            crate::operation::describe_data_repository_associations::DescribeDataRepositoryAssociationsError,
79            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
80        >,
81    > {
82        let input = self
83            .inner
84            .build()
85            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
86        let runtime_plugins = crate::operation::describe_data_repository_associations::DescribeDataRepositoryAssociations::operation_runtime_plugins(
87            self.handle.runtime_plugins.clone(),
88            &self.handle.conf,
89            self.config_override,
90        );
91        crate::operation::describe_data_repository_associations::DescribeDataRepositoryAssociations::orchestrate(&runtime_plugins, input).await
92    }
93
94    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
95    pub fn customize(
96        self,
97    ) -> crate::client::customize::CustomizableOperation<
98        crate::operation::describe_data_repository_associations::DescribeDataRepositoryAssociationsOutput,
99        crate::operation::describe_data_repository_associations::DescribeDataRepositoryAssociationsError,
100        Self,
101    > {
102        crate::client::customize::CustomizableOperation::new(self)
103    }
104    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
105        self.set_config_override(::std::option::Option::Some(config_override.into()));
106        self
107    }
108
109    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
110        self.config_override = config_override;
111        self
112    }
113    /// Create a paginator for this request
114    ///
115    /// Paginators are used by calling [`send().await`](crate::operation::describe_data_repository_associations::paginator::DescribeDataRepositoryAssociationsPaginator::send) which returns a [`PaginationStream`](aws_smithy_async::future::pagination_stream::PaginationStream).
116    pub fn into_paginator(self) -> crate::operation::describe_data_repository_associations::paginator::DescribeDataRepositoryAssociationsPaginator {
117        crate::operation::describe_data_repository_associations::paginator::DescribeDataRepositoryAssociationsPaginator::new(self.handle, self.inner)
118    }
119    ///
120    /// Appends an item to `AssociationIds`.
121    ///
122    /// To override the contents of this collection use [`set_association_ids`](Self::set_association_ids).
123    ///
124    /// <p>IDs of the data repository associations whose descriptions you want to retrieve (String).</p>
125    pub fn association_ids(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
126        self.inner = self.inner.association_ids(input.into());
127        self
128    }
129    /// <p>IDs of the data repository associations whose descriptions you want to retrieve (String).</p>
130    pub fn set_association_ids(mut self, input: ::std::option::Option<::std::vec::Vec<::std::string::String>>) -> Self {
131        self.inner = self.inner.set_association_ids(input);
132        self
133    }
134    /// <p>IDs of the data repository associations whose descriptions you want to retrieve (String).</p>
135    pub fn get_association_ids(&self) -> &::std::option::Option<::std::vec::Vec<::std::string::String>> {
136        self.inner.get_association_ids()
137    }
138    ///
139    /// Appends an item to `Filters`.
140    ///
141    /// To override the contents of this collection use [`set_filters`](Self::set_filters).
142    ///
143    /// <p>A list of <code>Filter</code> elements.</p>
144    pub fn filters(mut self, input: crate::types::Filter) -> Self {
145        self.inner = self.inner.filters(input);
146        self
147    }
148    /// <p>A list of <code>Filter</code> elements.</p>
149    pub fn set_filters(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::Filter>>) -> Self {
150        self.inner = self.inner.set_filters(input);
151        self
152    }
153    /// <p>A list of <code>Filter</code> elements.</p>
154    pub fn get_filters(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::Filter>> {
155        self.inner.get_filters()
156    }
157    /// <p>The maximum number of resources to return in the response. This value must be an integer greater than zero.</p>
158    pub fn max_results(mut self, input: i32) -> Self {
159        self.inner = self.inner.max_results(input);
160        self
161    }
162    /// <p>The maximum number of resources to return in the response. This value must be an integer greater than zero.</p>
163    pub fn set_max_results(mut self, input: ::std::option::Option<i32>) -> Self {
164        self.inner = self.inner.set_max_results(input);
165        self
166    }
167    /// <p>The maximum number of resources to return in the response. This value must be an integer greater than zero.</p>
168    pub fn get_max_results(&self) -> &::std::option::Option<i32> {
169        self.inner.get_max_results()
170    }
171    /// <p>(Optional) Opaque pagination token returned from a previous operation (String). If present, this token indicates from what point you can continue processing the request, where the previous <code>NextToken</code> value left off.</p>
172    pub fn next_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
173        self.inner = self.inner.next_token(input.into());
174        self
175    }
176    /// <p>(Optional) Opaque pagination token returned from a previous operation (String). If present, this token indicates from what point you can continue processing the request, where the previous <code>NextToken</code> value left off.</p>
177    pub fn set_next_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
178        self.inner = self.inner.set_next_token(input);
179        self
180    }
181    /// <p>(Optional) Opaque pagination token returned from a previous operation (String). If present, this token indicates from what point you can continue processing the request, where the previous <code>NextToken</code> value left off.</p>
182    pub fn get_next_token(&self) -> &::std::option::Option<::std::string::String> {
183        self.inner.get_next_token()
184    }
185}
aws_sdk_fsx/operation/describe_data_repository_associations/builders.rs

aws_sdk_fsx/operation/describe_data_repository_associations/
builders.rs
