aws_sdk_shield/operation/list_attacks/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::list_attacks::_list_attacks_output::ListAttacksOutputBuilder;
3
4pub use crate::operation::list_attacks::_list_attacks_input::ListAttacksInputBuilder;
5
6impl crate::operation::list_attacks::builders::ListAttacksInputBuilder {
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::list_attacks::ListAttacksOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::list_attacks::ListAttacksError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.list_attacks();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `ListAttacks`.
24///
25/// <p>Returns all ongoing DDoS attacks or all DDoS attacks during a specified time period.</p>
26#[derive(::std::clone::Clone, ::std::fmt::Debug)]
27pub struct ListAttacksFluentBuilder {
28    handle: ::std::sync::Arc<crate::client::Handle>,
29    inner: crate::operation::list_attacks::builders::ListAttacksInputBuilder,
30    config_override: ::std::option::Option<crate::config::Builder>,
31}
32impl
33    crate::client::customize::internal::CustomizableSend<
34        crate::operation::list_attacks::ListAttacksOutput,
35        crate::operation::list_attacks::ListAttacksError,
36    > for ListAttacksFluentBuilder
37{
38    fn send(
39        self,
40        config_override: crate::config::Builder,
41    ) -> crate::client::customize::internal::BoxFuture<
42        crate::client::customize::internal::SendResult<
43            crate::operation::list_attacks::ListAttacksOutput,
44            crate::operation::list_attacks::ListAttacksError,
45        >,
46    > {
47        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
48    }
49}
50impl ListAttacksFluentBuilder {
51    /// Creates a new `ListAttacksFluentBuilder`.
52    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
53        Self {
54            handle,
55            inner: ::std::default::Default::default(),
56            config_override: ::std::option::Option::None,
57        }
58    }
59    /// Access the ListAttacks as a reference.
60    pub fn as_input(&self) -> &crate::operation::list_attacks::builders::ListAttacksInputBuilder {
61        &self.inner
62    }
63    /// Sends the request and returns the response.
64    ///
65    /// If an error occurs, an `SdkError` will be returned with additional details that
66    /// can be matched against.
67    ///
68    /// By default, any retryable failures will be retried twice. Retry behavior
69    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
70    /// set when configuring the client.
71    pub async fn send(
72        self,
73    ) -> ::std::result::Result<
74        crate::operation::list_attacks::ListAttacksOutput,
75        ::aws_smithy_runtime_api::client::result::SdkError<
76            crate::operation::list_attacks::ListAttacksError,
77            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
78        >,
79    > {
80        let input = self
81            .inner
82            .build()
83            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
84        let runtime_plugins = crate::operation::list_attacks::ListAttacks::operation_runtime_plugins(
85            self.handle.runtime_plugins.clone(),
86            &self.handle.conf,
87            self.config_override,
88        );
89        crate::operation::list_attacks::ListAttacks::orchestrate(&runtime_plugins, input).await
90    }
91
92    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
93    pub fn customize(
94        self,
95    ) -> crate::client::customize::CustomizableOperation<
96        crate::operation::list_attacks::ListAttacksOutput,
97        crate::operation::list_attacks::ListAttacksError,
98        Self,
99    > {
100        crate::client::customize::CustomizableOperation::new(self)
101    }
102    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
103        self.set_config_override(::std::option::Option::Some(config_override.into()));
104        self
105    }
106
107    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
108        self.config_override = config_override;
109        self
110    }
111    /// Create a paginator for this request
112    ///
113    /// Paginators are used by calling [`send().await`](crate::operation::list_attacks::paginator::ListAttacksPaginator::send) which returns a [`PaginationStream`](aws_smithy_async::future::pagination_stream::PaginationStream).
114    pub fn into_paginator(self) -> crate::operation::list_attacks::paginator::ListAttacksPaginator {
115        crate::operation::list_attacks::paginator::ListAttacksPaginator::new(self.handle, self.inner)
116    }
117    ///
118    /// Appends an item to `ResourceArns`.
119    ///
120    /// To override the contents of this collection use [`set_resource_arns`](Self::set_resource_arns).
121    ///
122    /// <p>The ARNs (Amazon Resource Names) of the resources that were attacked. If you leave this blank, all applicable resources for this account will be included.</p>
123    pub fn resource_arns(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
124        self.inner = self.inner.resource_arns(input.into());
125        self
126    }
127    /// <p>The ARNs (Amazon Resource Names) of the resources that were attacked. If you leave this blank, all applicable resources for this account will be included.</p>
128    pub fn set_resource_arns(mut self, input: ::std::option::Option<::std::vec::Vec<::std::string::String>>) -> Self {
129        self.inner = self.inner.set_resource_arns(input);
130        self
131    }
132    /// <p>The ARNs (Amazon Resource Names) of the resources that were attacked. If you leave this blank, all applicable resources for this account will be included.</p>
133    pub fn get_resource_arns(&self) -> &::std::option::Option<::std::vec::Vec<::std::string::String>> {
134        self.inner.get_resource_arns()
135    }
136    /// <p>The start of the time period for the attacks. This is a <code>timestamp</code> type. The request syntax listing for this call indicates a <code>number</code> type, but you can provide the time in any valid <a href="https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-types.html#parameter-type-timestamp">timestamp format</a> setting.</p>
137    pub fn start_time(mut self, input: crate::types::TimeRange) -> Self {
138        self.inner = self.inner.start_time(input);
139        self
140    }
141    /// <p>The start of the time period for the attacks. This is a <code>timestamp</code> type. The request syntax listing for this call indicates a <code>number</code> type, but you can provide the time in any valid <a href="https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-types.html#parameter-type-timestamp">timestamp format</a> setting.</p>
142    pub fn set_start_time(mut self, input: ::std::option::Option<crate::types::TimeRange>) -> Self {
143        self.inner = self.inner.set_start_time(input);
144        self
145    }
146    /// <p>The start of the time period for the attacks. This is a <code>timestamp</code> type. The request syntax listing for this call indicates a <code>number</code> type, but you can provide the time in any valid <a href="https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-types.html#parameter-type-timestamp">timestamp format</a> setting.</p>
147    pub fn get_start_time(&self) -> &::std::option::Option<crate::types::TimeRange> {
148        self.inner.get_start_time()
149    }
150    /// <p>The end of the time period for the attacks. This is a <code>timestamp</code> type. The request syntax listing for this call indicates a <code>number</code> type, but you can provide the time in any valid <a href="https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-types.html#parameter-type-timestamp">timestamp format</a> setting.</p>
151    pub fn end_time(mut self, input: crate::types::TimeRange) -> Self {
152        self.inner = self.inner.end_time(input);
153        self
154    }
155    /// <p>The end of the time period for the attacks. This is a <code>timestamp</code> type. The request syntax listing for this call indicates a <code>number</code> type, but you can provide the time in any valid <a href="https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-types.html#parameter-type-timestamp">timestamp format</a> setting.</p>
156    pub fn set_end_time(mut self, input: ::std::option::Option<crate::types::TimeRange>) -> Self {
157        self.inner = self.inner.set_end_time(input);
158        self
159    }
160    /// <p>The end of the time period for the attacks. This is a <code>timestamp</code> type. The request syntax listing for this call indicates a <code>number</code> type, but you can provide the time in any valid <a href="https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-types.html#parameter-type-timestamp">timestamp format</a> setting.</p>
161    pub fn get_end_time(&self) -> &::std::option::Option<crate::types::TimeRange> {
162        self.inner.get_end_time()
163    }
164    /// <p>When you request a list of objects from Shield Advanced, if the response does not include all of the remaining available objects, Shield Advanced includes a <code>NextToken</code> value in the response. You can retrieve the next batch of objects by requesting the list again and providing the token that was returned by the prior call in your request.</p>
165    /// <p>You can indicate the maximum number of objects that you want Shield Advanced to return for a single call with the <code>MaxResults</code> setting. Shield Advanced will not return more than <code>MaxResults</code> objects, but may return fewer, even if more objects are still available.</p>
166    /// <p>Whenever more objects remain that Shield Advanced has not yet returned to you, the response will include a <code>NextToken</code> value.</p>
167    /// <p>On your first call to a list operation, leave this setting empty.</p>
168    pub fn next_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
169        self.inner = self.inner.next_token(input.into());
170        self
171    }
172    /// <p>When you request a list of objects from Shield Advanced, if the response does not include all of the remaining available objects, Shield Advanced includes a <code>NextToken</code> value in the response. You can retrieve the next batch of objects by requesting the list again and providing the token that was returned by the prior call in your request.</p>
173    /// <p>You can indicate the maximum number of objects that you want Shield Advanced to return for a single call with the <code>MaxResults</code> setting. Shield Advanced will not return more than <code>MaxResults</code> objects, but may return fewer, even if more objects are still available.</p>
174    /// <p>Whenever more objects remain that Shield Advanced has not yet returned to you, the response will include a <code>NextToken</code> value.</p>
175    /// <p>On your first call to a list operation, leave this setting empty.</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>When you request a list of objects from Shield Advanced, if the response does not include all of the remaining available objects, Shield Advanced includes a <code>NextToken</code> value in the response. You can retrieve the next batch of objects by requesting the list again and providing the token that was returned by the prior call in your request.</p>
181    /// <p>You can indicate the maximum number of objects that you want Shield Advanced to return for a single call with the <code>MaxResults</code> setting. Shield Advanced will not return more than <code>MaxResults</code> objects, but may return fewer, even if more objects are still available.</p>
182    /// <p>Whenever more objects remain that Shield Advanced has not yet returned to you, the response will include a <code>NextToken</code> value.</p>
183    /// <p>On your first call to a list operation, leave this setting empty.</p>
184    pub fn get_next_token(&self) -> &::std::option::Option<::std::string::String> {
185        self.inner.get_next_token()
186    }
187    /// <p>The greatest number of objects that you want Shield Advanced to return to the list request. Shield Advanced might return fewer objects than you indicate in this setting, even if more objects are available. If there are more objects remaining, Shield Advanced will always also return a <code>NextToken</code> value in the response.</p>
188    /// <p>The default setting is 20.</p>
189    pub fn max_results(mut self, input: i32) -> Self {
190        self.inner = self.inner.max_results(input);
191        self
192    }
193    /// <p>The greatest number of objects that you want Shield Advanced to return to the list request. Shield Advanced might return fewer objects than you indicate in this setting, even if more objects are available. If there are more objects remaining, Shield Advanced will always also return a <code>NextToken</code> value in the response.</p>
194    /// <p>The default setting is 20.</p>
195    pub fn set_max_results(mut self, input: ::std::option::Option<i32>) -> Self {
196        self.inner = self.inner.set_max_results(input);
197        self
198    }
199    /// <p>The greatest number of objects that you want Shield Advanced to return to the list request. Shield Advanced might return fewer objects than you indicate in this setting, even if more objects are available. If there are more objects remaining, Shield Advanced will always also return a <code>NextToken</code> value in the response.</p>
200    /// <p>The default setting is 20.</p>
201    pub fn get_max_results(&self) -> &::std::option::Option<i32> {
202        self.inner.get_max_results()
203    }
204}