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/// <p>For AI/ML resources, the response includes the <code>ResourceSubCategory</code> field. For self-hosted AI resources and their host resources, the response also includes <code>ResourceInfo</code> with AI-specific details. Self-hosted AI resources use a <code>ResourceType</code> with the <code>SelfHosted::AI::</code> prefix, such as <code>SelfHosted::AI::Model</code>, <code>SelfHosted::AI::Agent</code>, <code>SelfHosted::AI::InferenceEndpoint</code>, and <code>SelfHosted::AI::ExternalEndpoint</code>.</p>
29/// <p>If you filter by <code>ResourceSubCategory</code>, you must also include a <code>ResourceCategory</code> string filter with comparison set to <code>EQUALS</code> and value <code>AI/ML</code> in the same request.</p>
30#[derive(::std::clone::Clone, ::std::fmt::Debug)]
31pub struct GetResourcesV2FluentBuilder {
32 handle: ::std::sync::Arc<crate::client::Handle>,
33 inner: crate::operation::get_resources_v2::builders::GetResourcesV2InputBuilder,
34 config_override: ::std::option::Option<crate::config::Builder>,
35}
36impl
37 crate::client::customize::internal::CustomizableSend<
38 crate::operation::get_resources_v2::GetResourcesV2Output,
39 crate::operation::get_resources_v2::GetResourcesV2Error,
40 > for GetResourcesV2FluentBuilder
41{
42 fn send(
43 self,
44 config_override: crate::config::Builder,
45 ) -> crate::client::customize::internal::BoxFuture<
46 crate::client::customize::internal::SendResult<
47 crate::operation::get_resources_v2::GetResourcesV2Output,
48 crate::operation::get_resources_v2::GetResourcesV2Error,
49 >,
50 > {
51 ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
52 }
53}
54impl GetResourcesV2FluentBuilder {
55 /// Creates a new `GetResourcesV2FluentBuilder`.
56 pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
57 Self {
58 handle,
59 inner: ::std::default::Default::default(),
60 config_override: ::std::option::Option::None,
61 }
62 }
63 /// Access the GetResourcesV2 as a reference.
64 pub fn as_input(&self) -> &crate::operation::get_resources_v2::builders::GetResourcesV2InputBuilder {
65 &self.inner
66 }
67 /// Sends the request and returns the response.
68 ///
69 /// If an error occurs, an `SdkError` will be returned with additional details that
70 /// can be matched against.
71 ///
72 /// By default, any retryable failures will be retried twice. Retry behavior
73 /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
74 /// set when configuring the client.
75 pub async fn send(
76 self,
77 ) -> ::std::result::Result<
78 crate::operation::get_resources_v2::GetResourcesV2Output,
79 ::aws_smithy_runtime_api::client::result::SdkError<
80 crate::operation::get_resources_v2::GetResourcesV2Error,
81 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
82 >,
83 > {
84 let input = self
85 .inner
86 .build()
87 .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
88 let runtime_plugins = crate::operation::get_resources_v2::GetResourcesV2::operation_runtime_plugins(
89 self.handle.runtime_plugins.clone(),
90 &self.handle.conf,
91 self.config_override,
92 );
93 crate::operation::get_resources_v2::GetResourcesV2::orchestrate(&runtime_plugins, input).await
94 }
95
96 /// Consumes this builder, creating a customizable operation that can be modified before being sent.
97 pub fn customize(
98 self,
99 ) -> crate::client::customize::CustomizableOperation<
100 crate::operation::get_resources_v2::GetResourcesV2Output,
101 crate::operation::get_resources_v2::GetResourcesV2Error,
102 Self,
103 > {
104 crate::client::customize::CustomizableOperation::new(self)
105 }
106 pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
107 self.set_config_override(::std::option::Option::Some(config_override.into()));
108 self
109 }
110
111 pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
112 self.config_override = config_override;
113 self
114 }
115 /// Create a paginator for this request
116 ///
117 /// 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).
118 pub fn into_paginator(self) -> crate::operation::get_resources_v2::paginator::GetResourcesV2Paginator {
119 crate::operation::get_resources_v2::paginator::GetResourcesV2Paginator::new(self.handle, self.inner)
120 }
121 /// <p>Filters resources based on a set of criteria.</p>
122 pub fn filters(mut self, input: crate::types::ResourcesFilters) -> Self {
123 self.inner = self.inner.filters(input);
124 self
125 }
126 /// <p>Filters resources based on a set of criteria.</p>
127 pub fn set_filters(mut self, input: ::std::option::Option<crate::types::ResourcesFilters>) -> Self {
128 self.inner = self.inner.set_filters(input);
129 self
130 }
131 /// <p>Filters resources based on a set of criteria.</p>
132 pub fn get_filters(&self) -> &::std::option::Option<crate::types::ResourcesFilters> {
133 self.inner.get_filters()
134 }
135 /// <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>
136 /// <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>
137 /// <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>
138 pub fn scopes(mut self, input: crate::types::ResourceScopes) -> Self {
139 self.inner = self.inner.scopes(input);
140 self
141 }
142 /// <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>
143 /// <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>
144 /// <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>
145 pub fn set_scopes(mut self, input: ::std::option::Option<crate::types::ResourceScopes>) -> Self {
146 self.inner = self.inner.set_scopes(input);
147 self
148 }
149 /// <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>
150 /// <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>
151 /// <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>
152 pub fn get_scopes(&self) -> &::std::option::Option<crate::types::ResourceScopes> {
153 self.inner.get_scopes()
154 }
155 ///
156 /// Appends an item to `SortCriteria`.
157 ///
158 /// To override the contents of this collection use [`set_sort_criteria`](Self::set_sort_criteria).
159 ///
160 /// <p>The resource attributes used to sort the list of returned resources.</p>
161 pub fn sort_criteria(mut self, input: crate::types::SortCriterion) -> Self {
162 self.inner = self.inner.sort_criteria(input);
163 self
164 }
165 /// <p>The resource attributes used to sort the list of returned resources.</p>
166 pub fn set_sort_criteria(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::SortCriterion>>) -> Self {
167 self.inner = self.inner.set_sort_criteria(input);
168 self
169 }
170 /// <p>The resource attributes used to sort the list of returned resources.</p>
171 pub fn get_sort_criteria(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::SortCriterion>> {
172 self.inner.get_sort_criteria()
173 }
174 /// <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>
175 pub fn next_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
176 self.inner = self.inner.next_token(input.into());
177 self
178 }
179 /// <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>
180 pub fn set_next_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
181 self.inner = self.inner.set_next_token(input);
182 self
183 }
184 /// <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>
185 pub fn get_next_token(&self) -> &::std::option::Option<::std::string::String> {
186 self.inner.get_next_token()
187 }
188 /// <p>The maximum number of results to return.</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 maximum number of results to return.</p>
194 pub fn set_max_results(mut self, input: ::std::option::Option<i32>) -> Self {
195 self.inner = self.inner.set_max_results(input);
196 self
197 }
198 /// <p>The maximum number of results to return.</p>
199 pub fn get_max_results(&self) -> &::std::option::Option<i32> {
200 self.inner.get_max_results()
201 }
202}