aws_sdk_fsx/operation/describe_data_repository_tasks/
builders.rs

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

aws_sdk_fsx/operation/describe_data_repository_tasks/
builders.rs
