aws_sdk_ec2/operation/describe_principal_id_format/builders.rs
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::describe_principal_id_format::_describe_principal_id_format_output::DescribePrincipalIdFormatOutputBuilder;
3
4pub use crate::operation::describe_principal_id_format::_describe_principal_id_format_input::DescribePrincipalIdFormatInputBuilder;
5
6impl crate::operation::describe_principal_id_format::builders::DescribePrincipalIdFormatInputBuilder {
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_principal_id_format::DescribePrincipalIdFormatOutput,
13 ::aws_smithy_runtime_api::client::result::SdkError<
14 crate::operation::describe_principal_id_format::DescribePrincipalIdFormatError,
15 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16 >,
17 > {
18 let mut fluent_builder = client.describe_principal_id_format();
19 fluent_builder.inner = self;
20 fluent_builder.send().await
21 }
22}
23/// Fluent builder constructing a request to `DescribePrincipalIdFormat`.
24///
25/// <p>Describes the ID format settings for the root user and all IAM roles and IAM users that have explicitly specified a longer ID (17-character ID) preference.</p>
26/// <p>By default, all IAM roles and IAM users default to the same ID settings as the root user, unless they explicitly override the settings. This request is useful for identifying those IAM users and IAM roles that have overridden the default ID settings.</p>
27/// <p>The following resource types support longer IDs: <code>bundle</code> | <code>conversion-task</code> | <code>customer-gateway</code> | <code>dhcp-options</code> | <code>elastic-ip-allocation</code> | <code>elastic-ip-association</code> | <code>export-task</code> | <code>flow-log</code> | <code>image</code> | <code>import-task</code> | <code>instance</code> | <code>internet-gateway</code> | <code>network-acl</code> | <code>network-acl-association</code> | <code>network-interface</code> | <code>network-interface-attachment</code> | <code>prefix-list</code> | <code>reservation</code> | <code>route-table</code> | <code>route-table-association</code> | <code>security-group</code> | <code>snapshot</code> | <code>subnet</code> | <code>subnet-cidr-block-association</code> | <code>volume</code> | <code>vpc</code> | <code>vpc-cidr-block-association</code> | <code>vpc-endpoint</code> | <code>vpc-peering-connection</code> | <code>vpn-connection</code> | <code>vpn-gateway</code>.</p>
28#[derive(::std::clone::Clone, ::std::fmt::Debug)]
29pub struct DescribePrincipalIdFormatFluentBuilder {
30 handle: ::std::sync::Arc<crate::client::Handle>,
31 inner: crate::operation::describe_principal_id_format::builders::DescribePrincipalIdFormatInputBuilder,
32 config_override: ::std::option::Option<crate::config::Builder>,
33}
34impl
35 crate::client::customize::internal::CustomizableSend<
36 crate::operation::describe_principal_id_format::DescribePrincipalIdFormatOutput,
37 crate::operation::describe_principal_id_format::DescribePrincipalIdFormatError,
38 > for DescribePrincipalIdFormatFluentBuilder
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_principal_id_format::DescribePrincipalIdFormatOutput,
46 crate::operation::describe_principal_id_format::DescribePrincipalIdFormatError,
47 >,
48 > {
49 ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
50 }
51}
52impl DescribePrincipalIdFormatFluentBuilder {
53 /// Creates a new `DescribePrincipalIdFormatFluentBuilder`.
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 DescribePrincipalIdFormat as a reference.
62 pub fn as_input(&self) -> &crate::operation::describe_principal_id_format::builders::DescribePrincipalIdFormatInputBuilder {
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_principal_id_format::DescribePrincipalIdFormatOutput,
77 ::aws_smithy_runtime_api::client::result::SdkError<
78 crate::operation::describe_principal_id_format::DescribePrincipalIdFormatError,
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_principal_id_format::DescribePrincipalIdFormat::operation_runtime_plugins(
87 self.handle.runtime_plugins.clone(),
88 &self.handle.conf,
89 self.config_override,
90 );
91 crate::operation::describe_principal_id_format::DescribePrincipalIdFormat::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_principal_id_format::DescribePrincipalIdFormatOutput,
99 crate::operation::describe_principal_id_format::DescribePrincipalIdFormatError,
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_principal_id_format::paginator::DescribePrincipalIdFormatPaginator::send) which returns a [`PaginationStream`](aws_smithy_async::future::pagination_stream::PaginationStream).
116 pub fn into_paginator(self) -> crate::operation::describe_principal_id_format::paginator::DescribePrincipalIdFormatPaginator {
117 crate::operation::describe_principal_id_format::paginator::DescribePrincipalIdFormatPaginator::new(self.handle, self.inner)
118 }
119 /// <p>Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
120 pub fn dry_run(mut self, input: bool) -> Self {
121 self.inner = self.inner.dry_run(input);
122 self
123 }
124 /// <p>Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
125 pub fn set_dry_run(mut self, input: ::std::option::Option<bool>) -> Self {
126 self.inner = self.inner.set_dry_run(input);
127 self
128 }
129 /// <p>Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
130 pub fn get_dry_run(&self) -> &::std::option::Option<bool> {
131 self.inner.get_dry_run()
132 }
133 ///
134 /// Appends an item to `Resources`.
135 ///
136 /// To override the contents of this collection use [`set_resources`](Self::set_resources).
137 ///
138 /// <p>The type of resource: <code>bundle</code> | <code>conversion-task</code> | <code>customer-gateway</code> | <code>dhcp-options</code> | <code>elastic-ip-allocation</code> | <code>elastic-ip-association</code> | <code>export-task</code> | <code>flow-log</code> | <code>image</code> | <code>import-task</code> | <code>instance</code> | <code>internet-gateway</code> | <code>network-acl</code> | <code>network-acl-association</code> | <code>network-interface</code> | <code>network-interface-attachment</code> | <code>prefix-list</code> | <code>reservation</code> | <code>route-table</code> | <code>route-table-association</code> | <code>security-group</code> | <code>snapshot</code> | <code>subnet</code> | <code>subnet-cidr-block-association</code> | <code>volume</code> | <code>vpc</code> | <code>vpc-cidr-block-association</code> | <code>vpc-endpoint</code> | <code>vpc-peering-connection</code> | <code>vpn-connection</code> | <code>vpn-gateway</code></p>
139 pub fn resources(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
140 self.inner = self.inner.resources(input.into());
141 self
142 }
143 /// <p>The type of resource: <code>bundle</code> | <code>conversion-task</code> | <code>customer-gateway</code> | <code>dhcp-options</code> | <code>elastic-ip-allocation</code> | <code>elastic-ip-association</code> | <code>export-task</code> | <code>flow-log</code> | <code>image</code> | <code>import-task</code> | <code>instance</code> | <code>internet-gateway</code> | <code>network-acl</code> | <code>network-acl-association</code> | <code>network-interface</code> | <code>network-interface-attachment</code> | <code>prefix-list</code> | <code>reservation</code> | <code>route-table</code> | <code>route-table-association</code> | <code>security-group</code> | <code>snapshot</code> | <code>subnet</code> | <code>subnet-cidr-block-association</code> | <code>volume</code> | <code>vpc</code> | <code>vpc-cidr-block-association</code> | <code>vpc-endpoint</code> | <code>vpc-peering-connection</code> | <code>vpn-connection</code> | <code>vpn-gateway</code></p>
144 pub fn set_resources(mut self, input: ::std::option::Option<::std::vec::Vec<::std::string::String>>) -> Self {
145 self.inner = self.inner.set_resources(input);
146 self
147 }
148 /// <p>The type of resource: <code>bundle</code> | <code>conversion-task</code> | <code>customer-gateway</code> | <code>dhcp-options</code> | <code>elastic-ip-allocation</code> | <code>elastic-ip-association</code> | <code>export-task</code> | <code>flow-log</code> | <code>image</code> | <code>import-task</code> | <code>instance</code> | <code>internet-gateway</code> | <code>network-acl</code> | <code>network-acl-association</code> | <code>network-interface</code> | <code>network-interface-attachment</code> | <code>prefix-list</code> | <code>reservation</code> | <code>route-table</code> | <code>route-table-association</code> | <code>security-group</code> | <code>snapshot</code> | <code>subnet</code> | <code>subnet-cidr-block-association</code> | <code>volume</code> | <code>vpc</code> | <code>vpc-cidr-block-association</code> | <code>vpc-endpoint</code> | <code>vpc-peering-connection</code> | <code>vpn-connection</code> | <code>vpn-gateway</code></p>
149 pub fn get_resources(&self) -> &::std::option::Option<::std::vec::Vec<::std::string::String>> {
150 self.inner.get_resources()
151 }
152 /// <p>The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value.</p>
153 pub fn max_results(mut self, input: i32) -> Self {
154 self.inner = self.inner.max_results(input);
155 self
156 }
157 /// <p>The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value.</p>
158 pub fn set_max_results(mut self, input: ::std::option::Option<i32>) -> Self {
159 self.inner = self.inner.set_max_results(input);
160 self
161 }
162 /// <p>The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value.</p>
163 pub fn get_max_results(&self) -> &::std::option::Option<i32> {
164 self.inner.get_max_results()
165 }
166 /// <p>The token to request the next page of results.</p>
167 pub fn next_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
168 self.inner = self.inner.next_token(input.into());
169 self
170 }
171 /// <p>The token to request the next page of results.</p>
172 pub fn set_next_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
173 self.inner = self.inner.set_next_token(input);
174 self
175 }
176 /// <p>The token to request the next page of results.</p>
177 pub fn get_next_token(&self) -> &::std::option::Option<::std::string::String> {
178 self.inner.get_next_token()
179 }
180}