aws_sdk_securityhub/operation/get_resources_v2/builders.rs
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::get_resources_v2::_get_resources_v2_input::GetResourcesV2InputBuilder;
3
4pub use crate::operation::get_resources_v2::_get_resources_v2_output::GetResourcesV2OutputBuilder;
5
6impl crate::operation::get_resources_v2::builders::GetResourcesV2InputBuilder {
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::get_resources_v2::GetResourcesV2Output,
13 ::aws_smithy_runtime_api::client::result::SdkError<
14 crate::operation::get_resources_v2::GetResourcesV2Error,
15 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16 >,
17 > {
18 let mut fluent_builder = client.get_resources_v2();
19 fluent_builder.inner = self;
20 fluent_builder.send().await
21 }
22}
23/// Fluent builder constructing a request to `GetResourcesV2`.
24///
25/// <p>Returns a list of resources.</p>
26/// <p>You can use the <code>Scopes</code> parameter to define the data boundary for the query. Currently, <code>Scopes</code> supports <code>AwsOrganizations</code>, which lets you retrieve resources from your entire organization or from specific organizational units. Only the delegated administrator account can use <code>Scopes</code>.</p>
27/// <p>You can use the <code>Filters</code> parameter to refine results based on resource attributes. You can use <code>Scopes</code> and <code>Filters</code> independently or together. When both are provided, <code>Scopes</code> narrows the data set first, and then <code>Filters</code> refines results within that scoped data set.</p>
28#[derive(::std::clone::Clone, ::std::fmt::Debug)]
29pub struct GetResourcesV2FluentBuilder {
30 handle: ::std::sync::Arc<crate::client::Handle>,
31 inner: crate::operation::get_resources_v2::builders::GetResourcesV2InputBuilder,
32 config_override: ::std::option::Option<crate::config::Builder>,
33}
34impl
35 crate::client::customize::internal::CustomizableSend<
36 crate::operation::get_resources_v2::GetResourcesV2Output,
37 crate::operation::get_resources_v2::GetResourcesV2Error,
38 > for GetResourcesV2FluentBuilder
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::get_resources_v2::GetResourcesV2Output,
46 crate::operation::get_resources_v2::GetResourcesV2Error,
47 >,
48 > {
49 ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
50 }
51}
52impl GetResourcesV2FluentBuilder {
53 /// Creates a new `GetResourcesV2FluentBuilder`.
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 GetResourcesV2 as a reference.
62 pub fn as_input(&self) -> &crate::operation::get_resources_v2::builders::GetResourcesV2InputBuilder {
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::get_resources_v2::GetResourcesV2Output,
77 ::aws_smithy_runtime_api::client::result::SdkError<
78 crate::operation::get_resources_v2::GetResourcesV2Error,
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::get_resources_v2::GetResourcesV2::operation_runtime_plugins(
87 self.handle.runtime_plugins.clone(),
88 &self.handle.conf,
89 self.config_override,
90 );
91 crate::operation::get_resources_v2::GetResourcesV2::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::get_resources_v2::GetResourcesV2Output,
99 crate::operation::get_resources_v2::GetResourcesV2Error,
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::get_resources_v2::paginator::GetResourcesV2Paginator::send) which returns a [`PaginationStream`](aws_smithy_async::future::pagination_stream::PaginationStream).
116 pub fn into_paginator(self) -> crate::operation::get_resources_v2::paginator::GetResourcesV2Paginator {
117 crate::operation::get_resources_v2::paginator::GetResourcesV2Paginator::new(self.handle, self.inner)
118 }
119 /// <p>Filters resources based on a set of criteria.</p>
120 pub fn filters(mut self, input: crate::types::ResourcesFilters) -> Self {
121 self.inner = self.inner.filters(input);
122 self
123 }
124 /// <p>Filters resources based on a set of criteria.</p>
125 pub fn set_filters(mut self, input: ::std::option::Option<crate::types::ResourcesFilters>) -> Self {
126 self.inner = self.inner.set_filters(input);
127 self
128 }
129 /// <p>Filters resources based on a set of criteria.</p>
130 pub fn get_filters(&self) -> &::std::option::Option<crate::types::ResourcesFilters> {
131 self.inner.get_filters()
132 }
133 /// <p>Limits the results to resources from specific organizational units or from the delegated administrator's organization. Only the delegated administrator account can use this parameter. Other accounts receive an <code>AccessDeniedException</code>.</p>
134 /// <p>This parameter is optional. If you omit it, the delegated administrator sees resources from all accounts across the entire organization. Other accounts see only their own resources.</p>
135 /// <p>You can specify up to 10 entries in <code>Scopes.AwsOrganizations</code>. If multiple entries are specified, the entries are combined using OR logic.</p>
136 pub fn scopes(mut self, input: crate::types::ResourceScopes) -> Self {
137 self.inner = self.inner.scopes(input);
138 self
139 }
140 /// <p>Limits the results to resources from specific organizational units or from the delegated administrator's organization. Only the delegated administrator account can use this parameter. Other accounts receive an <code>AccessDeniedException</code>.</p>
141 /// <p>This parameter is optional. If you omit it, the delegated administrator sees resources from all accounts across the entire organization. Other accounts see only their own resources.</p>
142 /// <p>You can specify up to 10 entries in <code>Scopes.AwsOrganizations</code>. If multiple entries are specified, the entries are combined using OR logic.</p>
143 pub fn set_scopes(mut self, input: ::std::option::Option<crate::types::ResourceScopes>) -> Self {
144 self.inner = self.inner.set_scopes(input);
145 self
146 }
147 /// <p>Limits the results to resources from specific organizational units or from the delegated administrator's organization. Only the delegated administrator account can use this parameter. Other accounts receive an <code>AccessDeniedException</code>.</p>
148 /// <p>This parameter is optional. If you omit it, the delegated administrator sees resources from all accounts across the entire organization. Other accounts see only their own resources.</p>
149 /// <p>You can specify up to 10 entries in <code>Scopes.AwsOrganizations</code>. If multiple entries are specified, the entries are combined using OR logic.</p>
150 pub fn get_scopes(&self) -> &::std::option::Option<crate::types::ResourceScopes> {
151 self.inner.get_scopes()
152 }
153 ///
154 /// Appends an item to `SortCriteria`.
155 ///
156 /// To override the contents of this collection use [`set_sort_criteria`](Self::set_sort_criteria).
157 ///
158 /// <p>The resource attributes used to sort the list of returned resources.</p>
159 pub fn sort_criteria(mut self, input: crate::types::SortCriterion) -> Self {
160 self.inner = self.inner.sort_criteria(input);
161 self
162 }
163 /// <p>The resource attributes used to sort the list of returned resources.</p>
164 pub fn set_sort_criteria(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::SortCriterion>>) -> Self {
165 self.inner = self.inner.set_sort_criteria(input);
166 self
167 }
168 /// <p>The resource attributes used to sort the list of returned resources.</p>
169 pub fn get_sort_criteria(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::SortCriterion>> {
170 self.inner.get_sort_criteria()
171 }
172 /// <p>The token required for pagination. On your first call, set the value of this parameter to <code>NULL</code>. For subsequent calls, to continue listing data, set the value of this parameter to the value returned in the previous response.</p>
173 pub fn next_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
174 self.inner = self.inner.next_token(input.into());
175 self
176 }
177 /// <p>The token required for pagination. On your first call, set the value of this parameter to <code>NULL</code>. For subsequent calls, to continue listing data, set the value of this parameter to the value returned in the previous response.</p>
178 pub fn set_next_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
179 self.inner = self.inner.set_next_token(input);
180 self
181 }
182 /// <p>The token required for pagination. On your first call, set the value of this parameter to <code>NULL</code>. For subsequent calls, to continue listing data, set the value of this parameter to the value returned in the previous response.</p>
183 pub fn get_next_token(&self) -> &::std::option::Option<::std::string::String> {
184 self.inner.get_next_token()
185 }
186 /// <p>The maximum number of results to return.</p>
187 pub fn max_results(mut self, input: i32) -> Self {
188 self.inner = self.inner.max_results(input);
189 self
190 }
191 /// <p>The maximum number of results to return.</p>
192 pub fn set_max_results(mut self, input: ::std::option::Option<i32>) -> Self {
193 self.inner = self.inner.set_max_results(input);
194 self
195 }
196 /// <p>The maximum number of results to return.</p>
197 pub fn get_max_results(&self) -> &::std::option::Option<i32> {
198 self.inner.get_max_results()
199 }
200}