aws_sdk_evidently/operation/create_launch/builders.rs
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::create_launch::_create_launch_output::CreateLaunchOutputBuilder;
3
4pub use crate::operation::create_launch::_create_launch_input::CreateLaunchInputBuilder;
5
6impl crate::operation::create_launch::builders::CreateLaunchInputBuilder {
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_launch::CreateLaunchOutput,
13 ::aws_smithy_runtime_api::client::result::SdkError<
14 crate::operation::create_launch::CreateLaunchError,
15 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16 >,
17 > {
18 let mut fluent_builder = client.create_launch();
19 fluent_builder.inner = self;
20 fluent_builder.send().await
21 }
22}
23/// Fluent builder constructing a request to `CreateLaunch`.
24///
25/// <p>Creates a <i>launch</i> of a given feature. Before you create a launch, you must create the feature to use for the launch.</p>
26/// <p>You can use a launch to safely validate new features by serving them to a specified percentage of your users while you roll out the feature. You can monitor the performance of the new feature to help you decide when to ramp up traffic to more users. This helps you reduce risk and identify unintended consequences before you fully launch the feature.</p>
27/// <p>Don't use this operation to update an existing launch. Instead, use <a href="https://docs.aws.amazon.com/cloudwatchevidently/latest/APIReference/API_UpdateLaunch.html">UpdateLaunch</a>.</p>
28#[deprecated(note = "AWS CloudWatch Evidently has been deprecated since 11/17/2025.", since = "11/17/2025")]
29#[derive(::std::clone::Clone, ::std::fmt::Debug)]
30pub struct CreateLaunchFluentBuilder {
31 handle: ::std::sync::Arc<crate::client::Handle>,
32 inner: crate::operation::create_launch::builders::CreateLaunchInputBuilder,
33 config_override: ::std::option::Option<crate::config::Builder>,
34}
35impl
36 crate::client::customize::internal::CustomizableSend<
37 crate::operation::create_launch::CreateLaunchOutput,
38 crate::operation::create_launch::CreateLaunchError,
39 > for CreateLaunchFluentBuilder
40{
41 fn send(
42 self,
43 config_override: crate::config::Builder,
44 ) -> crate::client::customize::internal::BoxFuture<
45 crate::client::customize::internal::SendResult<
46 crate::operation::create_launch::CreateLaunchOutput,
47 crate::operation::create_launch::CreateLaunchError,
48 >,
49 > {
50 ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
51 }
52}
53impl CreateLaunchFluentBuilder {
54 /// Creates a new `CreateLaunchFluentBuilder`.
55 pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
56 Self {
57 handle,
58 inner: ::std::default::Default::default(),
59 config_override: ::std::option::Option::None,
60 }
61 }
62 /// Access the CreateLaunch as a reference.
63 pub fn as_input(&self) -> &crate::operation::create_launch::builders::CreateLaunchInputBuilder {
64 &self.inner
65 }
66 /// Sends the request and returns the response.
67 ///
68 /// If an error occurs, an `SdkError` will be returned with additional details that
69 /// can be matched against.
70 ///
71 /// By default, any retryable failures will be retried twice. Retry behavior
72 /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
73 /// set when configuring the client.
74 pub async fn send(
75 self,
76 ) -> ::std::result::Result<
77 crate::operation::create_launch::CreateLaunchOutput,
78 ::aws_smithy_runtime_api::client::result::SdkError<
79 crate::operation::create_launch::CreateLaunchError,
80 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
81 >,
82 > {
83 let input = self
84 .inner
85 .build()
86 .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
87 let runtime_plugins = crate::operation::create_launch::CreateLaunch::operation_runtime_plugins(
88 self.handle.runtime_plugins.clone(),
89 &self.handle.conf,
90 self.config_override,
91 );
92 crate::operation::create_launch::CreateLaunch::orchestrate(&runtime_plugins, input).await
93 }
94
95 /// Consumes this builder, creating a customizable operation that can be modified before being sent.
96 pub fn customize(
97 self,
98 ) -> crate::client::customize::CustomizableOperation<
99 crate::operation::create_launch::CreateLaunchOutput,
100 crate::operation::create_launch::CreateLaunchError,
101 Self,
102 > {
103 crate::client::customize::CustomizableOperation::new(self)
104 }
105 pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
106 self.set_config_override(::std::option::Option::Some(config_override.into()));
107 self
108 }
109
110 pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
111 self.config_override = config_override;
112 self
113 }
114 /// <p>The name or ARN of the project that you want to create the launch in.</p>
115 pub fn project(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
116 self.inner = self.inner.project(input.into());
117 self
118 }
119 /// <p>The name or ARN of the project that you want to create the launch in.</p>
120 pub fn set_project(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
121 self.inner = self.inner.set_project(input);
122 self
123 }
124 /// <p>The name or ARN of the project that you want to create the launch in.</p>
125 pub fn get_project(&self) -> &::std::option::Option<::std::string::String> {
126 self.inner.get_project()
127 }
128 /// <p>The name for the new launch.</p>
129 pub fn name(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
130 self.inner = self.inner.name(input.into());
131 self
132 }
133 /// <p>The name for the new launch.</p>
134 pub fn set_name(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
135 self.inner = self.inner.set_name(input);
136 self
137 }
138 /// <p>The name for the new launch.</p>
139 pub fn get_name(&self) -> &::std::option::Option<::std::string::String> {
140 self.inner.get_name()
141 }
142 /// <p>An optional description for the launch.</p>
143 pub fn description(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
144 self.inner = self.inner.description(input.into());
145 self
146 }
147 /// <p>An optional description for the launch.</p>
148 pub fn set_description(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
149 self.inner = self.inner.set_description(input);
150 self
151 }
152 /// <p>An optional description for the launch.</p>
153 pub fn get_description(&self) -> &::std::option::Option<::std::string::String> {
154 self.inner.get_description()
155 }
156 /// <p>An array of structures that define the traffic allocation percentages among the feature variations during each step of the launch.</p>
157 pub fn scheduled_splits_config(mut self, input: crate::types::ScheduledSplitsLaunchConfig) -> Self {
158 self.inner = self.inner.scheduled_splits_config(input);
159 self
160 }
161 /// <p>An array of structures that define the traffic allocation percentages among the feature variations during each step of the launch.</p>
162 pub fn set_scheduled_splits_config(mut self, input: ::std::option::Option<crate::types::ScheduledSplitsLaunchConfig>) -> Self {
163 self.inner = self.inner.set_scheduled_splits_config(input);
164 self
165 }
166 /// <p>An array of structures that define the traffic allocation percentages among the feature variations during each step of the launch.</p>
167 pub fn get_scheduled_splits_config(&self) -> &::std::option::Option<crate::types::ScheduledSplitsLaunchConfig> {
168 self.inner.get_scheduled_splits_config()
169 }
170 ///
171 /// Appends an item to `metricMonitors`.
172 ///
173 /// To override the contents of this collection use [`set_metric_monitors`](Self::set_metric_monitors).
174 ///
175 /// <p>An array of structures that define the metrics that will be used to monitor the launch performance.</p>
176 pub fn metric_monitors(mut self, input: crate::types::MetricMonitorConfig) -> Self {
177 self.inner = self.inner.metric_monitors(input);
178 self
179 }
180 /// <p>An array of structures that define the metrics that will be used to monitor the launch performance.</p>
181 pub fn set_metric_monitors(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::MetricMonitorConfig>>) -> Self {
182 self.inner = self.inner.set_metric_monitors(input);
183 self
184 }
185 /// <p>An array of structures that define the metrics that will be used to monitor the launch performance.</p>
186 pub fn get_metric_monitors(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::MetricMonitorConfig>> {
187 self.inner.get_metric_monitors()
188 }
189 ///
190 /// Appends an item to `groups`.
191 ///
192 /// To override the contents of this collection use [`set_groups`](Self::set_groups).
193 ///
194 /// <p>An array of structures that contains the feature and variations that are to be used for the launch.</p>
195 pub fn groups(mut self, input: crate::types::LaunchGroupConfig) -> Self {
196 self.inner = self.inner.groups(input);
197 self
198 }
199 /// <p>An array of structures that contains the feature and variations that are to be used for the launch.</p>
200 pub fn set_groups(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::LaunchGroupConfig>>) -> Self {
201 self.inner = self.inner.set_groups(input);
202 self
203 }
204 /// <p>An array of structures that contains the feature and variations that are to be used for the launch.</p>
205 pub fn get_groups(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::LaunchGroupConfig>> {
206 self.inner.get_groups()
207 }
208 /// <p>When Evidently assigns a particular user session to a launch, it must use a randomization ID to determine which variation the user session is served. This randomization ID is a combination of the entity ID and <code>randomizationSalt</code>. If you omit <code>randomizationSalt</code>, Evidently uses the launch name as the <code>randomizationSalt</code>.</p>
209 pub fn randomization_salt(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
210 self.inner = self.inner.randomization_salt(input.into());
211 self
212 }
213 /// <p>When Evidently assigns a particular user session to a launch, it must use a randomization ID to determine which variation the user session is served. This randomization ID is a combination of the entity ID and <code>randomizationSalt</code>. If you omit <code>randomizationSalt</code>, Evidently uses the launch name as the <code>randomizationSalt</code>.</p>
214 pub fn set_randomization_salt(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
215 self.inner = self.inner.set_randomization_salt(input);
216 self
217 }
218 /// <p>When Evidently assigns a particular user session to a launch, it must use a randomization ID to determine which variation the user session is served. This randomization ID is a combination of the entity ID and <code>randomizationSalt</code>. If you omit <code>randomizationSalt</code>, Evidently uses the launch name as the <code>randomizationSalt</code>.</p>
219 pub fn get_randomization_salt(&self) -> &::std::option::Option<::std::string::String> {
220 self.inner.get_randomization_salt()
221 }
222 ///
223 /// Adds a key-value pair to `tags`.
224 ///
225 /// To override the contents of this collection use [`set_tags`](Self::set_tags).
226 ///
227 /// <p>Assigns one or more tags (key-value pairs) to the launch.</p>
228 /// <p>Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values.</p>
229 /// <p>Tags don't have any semantic meaning to Amazon Web Services and are interpreted strictly as strings of characters.</p>
230 /// <p>You can associate as many as 50 tags with a launch.</p>
231 /// <p>For more information, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services resources</a>.</p>
232 pub fn tags(mut self, k: impl ::std::convert::Into<::std::string::String>, v: impl ::std::convert::Into<::std::string::String>) -> Self {
233 self.inner = self.inner.tags(k.into(), v.into());
234 self
235 }
236 /// <p>Assigns one or more tags (key-value pairs) to the launch.</p>
237 /// <p>Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values.</p>
238 /// <p>Tags don't have any semantic meaning to Amazon Web Services and are interpreted strictly as strings of characters.</p>
239 /// <p>You can associate as many as 50 tags with a launch.</p>
240 /// <p>For more information, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services resources</a>.</p>
241 pub fn set_tags(mut self, input: ::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>>) -> Self {
242 self.inner = self.inner.set_tags(input);
243 self
244 }
245 /// <p>Assigns one or more tags (key-value pairs) to the launch.</p>
246 /// <p>Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values.</p>
247 /// <p>Tags don't have any semantic meaning to Amazon Web Services and are interpreted strictly as strings of characters.</p>
248 /// <p>You can associate as many as 50 tags with a launch.</p>
249 /// <p>For more information, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services resources</a>.</p>
250 pub fn get_tags(&self) -> &::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>> {
251 self.inner.get_tags()
252 }
253}