aws_sdk_ecs/operation/create_capacity_provider/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::create_capacity_provider::_create_capacity_provider_output::CreateCapacityProviderOutputBuilder;
3
4pub use crate::operation::create_capacity_provider::_create_capacity_provider_input::CreateCapacityProviderInputBuilder;
5
6impl crate::operation::create_capacity_provider::builders::CreateCapacityProviderInputBuilder {
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::create_capacity_provider::CreateCapacityProviderOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::create_capacity_provider::CreateCapacityProviderError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.create_capacity_provider();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `CreateCapacityProvider`.
24///
25/// <p>Creates a new capacity provider. Capacity providers are associated with an Amazon ECS cluster and are used in capacity provider strategies to facilitate cluster auto scaling.</p>
26/// <p>Only capacity providers that use an Auto Scaling group can be created. Amazon ECS tasks on Fargate use the <code>FARGATE</code> and <code>FARGATE_SPOT</code> capacity providers. These providers are available to all accounts in the Amazon Web Services Regions that Fargate supports.</p>
27#[derive(::std::clone::Clone, ::std::fmt::Debug)]
28pub struct CreateCapacityProviderFluentBuilder {
29    handle: ::std::sync::Arc<crate::client::Handle>,
30    inner: crate::operation::create_capacity_provider::builders::CreateCapacityProviderInputBuilder,
31    config_override: ::std::option::Option<crate::config::Builder>,
32}
33impl
34    crate::client::customize::internal::CustomizableSend<
35        crate::operation::create_capacity_provider::CreateCapacityProviderOutput,
36        crate::operation::create_capacity_provider::CreateCapacityProviderError,
37    > for CreateCapacityProviderFluentBuilder
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::create_capacity_provider::CreateCapacityProviderOutput,
45            crate::operation::create_capacity_provider::CreateCapacityProviderError,
46        >,
47    > {
48        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
49    }
50}
51impl CreateCapacityProviderFluentBuilder {
52    /// Creates a new `CreateCapacityProviderFluentBuilder`.
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 CreateCapacityProvider as a reference.
61    pub fn as_input(&self) -> &crate::operation::create_capacity_provider::builders::CreateCapacityProviderInputBuilder {
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::create_capacity_provider::CreateCapacityProviderOutput,
76        ::aws_smithy_runtime_api::client::result::SdkError<
77            crate::operation::create_capacity_provider::CreateCapacityProviderError,
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::create_capacity_provider::CreateCapacityProvider::operation_runtime_plugins(
86            self.handle.runtime_plugins.clone(),
87            &self.handle.conf,
88            self.config_override,
89        );
90        crate::operation::create_capacity_provider::CreateCapacityProvider::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::create_capacity_provider::CreateCapacityProviderOutput,
98        crate::operation::create_capacity_provider::CreateCapacityProviderError,
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    /// <p>The name of the capacity provider. Up to 255 characters are allowed. They include letters (both upper and lowercase letters), numbers, underscores (_), and hyphens (-). The name can't be prefixed with "<code>aws</code>", "<code>ecs</code>", or "<code>fargate</code>".</p>
113    pub fn name(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
114        self.inner = self.inner.name(input.into());
115        self
116    }
117    /// <p>The name of the capacity provider. Up to 255 characters are allowed. They include letters (both upper and lowercase letters), numbers, underscores (_), and hyphens (-). The name can't be prefixed with "<code>aws</code>", "<code>ecs</code>", or "<code>fargate</code>".</p>
118    pub fn set_name(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
119        self.inner = self.inner.set_name(input);
120        self
121    }
122    /// <p>The name of the capacity provider. Up to 255 characters are allowed. They include letters (both upper and lowercase letters), numbers, underscores (_), and hyphens (-). The name can't be prefixed with "<code>aws</code>", "<code>ecs</code>", or "<code>fargate</code>".</p>
123    pub fn get_name(&self) -> &::std::option::Option<::std::string::String> {
124        self.inner.get_name()
125    }
126    /// <p>The details of the Auto Scaling group for the capacity provider.</p>
127    pub fn auto_scaling_group_provider(mut self, input: crate::types::AutoScalingGroupProvider) -> Self {
128        self.inner = self.inner.auto_scaling_group_provider(input);
129        self
130    }
131    /// <p>The details of the Auto Scaling group for the capacity provider.</p>
132    pub fn set_auto_scaling_group_provider(mut self, input: ::std::option::Option<crate::types::AutoScalingGroupProvider>) -> Self {
133        self.inner = self.inner.set_auto_scaling_group_provider(input);
134        self
135    }
136    /// <p>The details of the Auto Scaling group for the capacity provider.</p>
137    pub fn get_auto_scaling_group_provider(&self) -> &::std::option::Option<crate::types::AutoScalingGroupProvider> {
138        self.inner.get_auto_scaling_group_provider()
139    }
140    ///
141    /// Appends an item to `tags`.
142    ///
143    /// To override the contents of this collection use [`set_tags`](Self::set_tags).
144    ///
145    /// <p>The metadata that you apply to the capacity provider to categorize and organize them more conveniently. Each tag consists of a key and an optional value. You define both of them.</p>
146    /// <p>The following basic restrictions apply to tags:</p>
147    /// <ul>
148    /// <li>
149    /// <p>Maximum number of tags per resource - 50</p></li>
150    /// <li>
151    /// <p>For each resource, each tag key must be unique, and each tag key can have only one value.</p></li>
152    /// <li>
153    /// <p>Maximum key length - 128 Unicode characters in UTF-8</p></li>
154    /// <li>
155    /// <p>Maximum value length - 256 Unicode characters in UTF-8</p></li>
156    /// <li>
157    /// <p>If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.</p></li>
158    /// <li>
159    /// <p>Tag keys and values are case-sensitive.</p></li>
160    /// <li>
161    /// <p>Do not use <code>aws:</code>, <code>AWS:</code>, or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for Amazon Web Services use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.</p></li>
162    /// </ul>
163    pub fn tags(mut self, input: crate::types::Tag) -> Self {
164        self.inner = self.inner.tags(input);
165        self
166    }
167    /// <p>The metadata that you apply to the capacity provider to categorize and organize them more conveniently. Each tag consists of a key and an optional value. You define both of them.</p>
168    /// <p>The following basic restrictions apply to tags:</p>
169    /// <ul>
170    /// <li>
171    /// <p>Maximum number of tags per resource - 50</p></li>
172    /// <li>
173    /// <p>For each resource, each tag key must be unique, and each tag key can have only one value.</p></li>
174    /// <li>
175    /// <p>Maximum key length - 128 Unicode characters in UTF-8</p></li>
176    /// <li>
177    /// <p>Maximum value length - 256 Unicode characters in UTF-8</p></li>
178    /// <li>
179    /// <p>If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.</p></li>
180    /// <li>
181    /// <p>Tag keys and values are case-sensitive.</p></li>
182    /// <li>
183    /// <p>Do not use <code>aws:</code>, <code>AWS:</code>, or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for Amazon Web Services use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.</p></li>
184    /// </ul>
185    pub fn set_tags(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::Tag>>) -> Self {
186        self.inner = self.inner.set_tags(input);
187        self
188    }
189    /// <p>The metadata that you apply to the capacity provider to categorize and organize them more conveniently. Each tag consists of a key and an optional value. You define both of them.</p>
190    /// <p>The following basic restrictions apply to tags:</p>
191    /// <ul>
192    /// <li>
193    /// <p>Maximum number of tags per resource - 50</p></li>
194    /// <li>
195    /// <p>For each resource, each tag key must be unique, and each tag key can have only one value.</p></li>
196    /// <li>
197    /// <p>Maximum key length - 128 Unicode characters in UTF-8</p></li>
198    /// <li>
199    /// <p>Maximum value length - 256 Unicode characters in UTF-8</p></li>
200    /// <li>
201    /// <p>If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.</p></li>
202    /// <li>
203    /// <p>Tag keys and values are case-sensitive.</p></li>
204    /// <li>
205    /// <p>Do not use <code>aws:</code>, <code>AWS:</code>, or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for Amazon Web Services use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.</p></li>
206    /// </ul>
207    pub fn get_tags(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::Tag>> {
208        self.inner.get_tags()
209    }
210}