1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::create_cluster::_create_cluster_output::CreateClusterOutputBuilder;
pub use crate::operation::create_cluster::_create_cluster_input::CreateClusterInputBuilder;
/// Fluent builder constructing a request to `CreateCluster`.
///
/// <p>Creates an empty cluster. Each cluster supports five nodes. You use the <code>CreateJob</code> action separately to create the jobs for each of these nodes. The cluster does not ship until these five node jobs have been created.</p>
#[derive(std::clone::Clone, std::fmt::Debug)]
pub struct CreateClusterFluentBuilder {
handle: std::sync::Arc<crate::client::Handle>,
inner: crate::operation::create_cluster::builders::CreateClusterInputBuilder,
}
impl CreateClusterFluentBuilder {
/// Creates a new `CreateCluster`.
pub(crate) fn new(handle: std::sync::Arc<crate::client::Handle>) -> Self {
Self {
handle,
inner: Default::default(),
}
}
/// Consume this builder, creating a customizable operation that can be modified before being
/// sent. The operation's inner [http::Request] can be modified as well.
pub async fn customize(
self,
) -> std::result::Result<
crate::client::customize::CustomizableOperation<
crate::operation::create_cluster::CreateCluster,
aws_http::retry::AwsResponseRetryClassifier,
>,
aws_smithy_http::result::SdkError<crate::operation::create_cluster::CreateClusterError>,
> {
let handle = self.handle.clone();
let operation = self
.inner
.build()
.map_err(aws_smithy_http::result::SdkError::construction_failure)?
.make_operation(&handle.conf)
.await
.map_err(aws_smithy_http::result::SdkError::construction_failure)?;
Ok(crate::client::customize::CustomizableOperation { handle, operation })
}
/// Sends the request and returns the response.
///
/// If an error occurs, an `SdkError` will be returned with additional details that
/// can be matched against.
///
/// By default, any retryable failures will be retried twice. Retry behavior
/// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
/// set when configuring the client.
pub async fn send(
self,
) -> std::result::Result<
crate::operation::create_cluster::CreateClusterOutput,
aws_smithy_http::result::SdkError<crate::operation::create_cluster::CreateClusterError>,
> {
let op = self
.inner
.build()
.map_err(aws_smithy_http::result::SdkError::construction_failure)?
.make_operation(&self.handle.conf)
.await
.map_err(aws_smithy_http::result::SdkError::construction_failure)?;
self.handle.client.call(op).await
}
/// <p>The type of job for this cluster. Currently, the only job type supported for clusters is <code>LOCAL_USE</code>.</p>
/// <p>For more information, see "https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the <i>Snowcone User Guide</i> or "https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the <i>Snowcone User Guide</i>.</p>
pub fn job_type(mut self, input: crate::types::JobType) -> Self {
self.inner = self.inner.job_type(input);
self
}
/// <p>The type of job for this cluster. Currently, the only job type supported for clusters is <code>LOCAL_USE</code>.</p>
/// <p>For more information, see "https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the <i>Snowcone User Guide</i> or "https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the <i>Snowcone User Guide</i>.</p>
pub fn set_job_type(mut self, input: std::option::Option<crate::types::JobType>) -> Self {
self.inner = self.inner.set_job_type(input);
self
}
/// <p>The resources associated with the cluster job. These resources include Amazon S3 buckets and optional Lambda functions written in the Python language. </p>
pub fn resources(mut self, input: crate::types::JobResource) -> Self {
self.inner = self.inner.resources(input);
self
}
/// <p>The resources associated with the cluster job. These resources include Amazon S3 buckets and optional Lambda functions written in the Python language. </p>
pub fn set_resources(mut self, input: std::option::Option<crate::types::JobResource>) -> Self {
self.inner = self.inner.set_resources(input);
self
}
/// <p>Specifies the service or services on the Snow Family device that your transferred data will be exported from or imported into. Amazon Web Services Snow Family device clusters support Amazon S3 and NFS (Network File System).</p>
pub fn on_device_service_configuration(
mut self,
input: crate::types::OnDeviceServiceConfiguration,
) -> Self {
self.inner = self.inner.on_device_service_configuration(input);
self
}
/// <p>Specifies the service or services on the Snow Family device that your transferred data will be exported from or imported into. Amazon Web Services Snow Family device clusters support Amazon S3 and NFS (Network File System).</p>
pub fn set_on_device_service_configuration(
mut self,
input: std::option::Option<crate::types::OnDeviceServiceConfiguration>,
) -> Self {
self.inner = self.inner.set_on_device_service_configuration(input);
self
}
/// <p>An optional description of this specific cluster, for example <code>Environmental Data Cluster-01</code>.</p>
pub fn description(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.description(input.into());
self
}
/// <p>An optional description of this specific cluster, for example <code>Environmental Data Cluster-01</code>.</p>
pub fn set_description(mut self, input: std::option::Option<std::string::String>) -> Self {
self.inner = self.inner.set_description(input);
self
}
/// <p>The ID for the address that you want the cluster shipped to.</p>
pub fn address_id(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.address_id(input.into());
self
}
/// <p>The ID for the address that you want the cluster shipped to.</p>
pub fn set_address_id(mut self, input: std::option::Option<std::string::String>) -> Self {
self.inner = self.inner.set_address_id(input);
self
}
/// <p>The <code>KmsKeyARN</code> value that you want to associate with this cluster. <code>KmsKeyARN</code> values are created by using the <a href="https://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html">CreateKey</a> API action in Key Management Service (KMS). </p>
pub fn kms_key_arn(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.kms_key_arn(input.into());
self
}
/// <p>The <code>KmsKeyARN</code> value that you want to associate with this cluster. <code>KmsKeyARN</code> values are created by using the <a href="https://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html">CreateKey</a> API action in Key Management Service (KMS). </p>
pub fn set_kms_key_arn(mut self, input: std::option::Option<std::string::String>) -> Self {
self.inner = self.inner.set_kms_key_arn(input);
self
}
/// <p>The <code>RoleARN</code> that you want to associate with this cluster. <code>RoleArn</code> values are created by using the <a href="https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html">CreateRole</a> API action in Identity and Access Management (IAM).</p>
pub fn role_arn(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.role_arn(input.into());
self
}
/// <p>The <code>RoleARN</code> that you want to associate with this cluster. <code>RoleArn</code> values are created by using the <a href="https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html">CreateRole</a> API action in Identity and Access Management (IAM).</p>
pub fn set_role_arn(mut self, input: std::option::Option<std::string::String>) -> Self {
self.inner = self.inner.set_role_arn(input);
self
}
/// <p>The type of Snow Family devices to use for this cluster. </p> <note>
/// <p>For cluster jobs, Amazon Web Services Snow Family currently supports only the <code>EDGE</code> device type.</p>
/// </note>
/// <p>For more information, see "https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the <i>Snowcone User Guide</i> or "https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the <i>Snowcone User Guide</i>.</p>
pub fn snowball_type(mut self, input: crate::types::SnowballType) -> Self {
self.inner = self.inner.snowball_type(input);
self
}
/// <p>The type of Snow Family devices to use for this cluster. </p> <note>
/// <p>For cluster jobs, Amazon Web Services Snow Family currently supports only the <code>EDGE</code> device type.</p>
/// </note>
/// <p>For more information, see "https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the <i>Snowcone User Guide</i> or "https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the <i>Snowcone User Guide</i>.</p>
pub fn set_snowball_type(
mut self,
input: std::option::Option<crate::types::SnowballType>,
) -> Self {
self.inner = self.inner.set_snowball_type(input);
self
}
/// <p>The shipping speed for each node in this cluster. This speed doesn't dictate how soon you'll get each Snowball Edge device, rather it represents how quickly each device moves to its destination while in transit. Regional shipping speeds are as follows: </p>
/// <ul>
/// <li> <p>In Australia, you have access to express shipping. Typically, Snow devices shipped express are delivered in about a day.</p> </li>
/// <li> <p>In the European Union (EU), you have access to express shipping. Typically, Snow devices shipped express are delivered in about a day. In addition, most countries in the EU have access to standard shipping, which typically takes less than a week, one way.</p> </li>
/// <li> <p>In India, Snow devices are delivered in one to seven days.</p> </li>
/// <li> <p>In the United States of America (US), you have access to one-day shipping and two-day shipping.</p> </li>
/// </ul>
/// <ul>
/// <li> <p>In Australia, you have access to express shipping. Typically, devices shipped express are delivered in about a day.</p> </li>
/// <li> <p>In the European Union (EU), you have access to express shipping. Typically, Snow devices shipped express are delivered in about a day. In addition, most countries in the EU have access to standard shipping, which typically takes less than a week, one way.</p> </li>
/// <li> <p>In India, Snow devices are delivered in one to seven days.</p> </li>
/// <li> <p>In the US, you have access to one-day shipping and two-day shipping.</p> </li>
/// </ul>
pub fn shipping_option(mut self, input: crate::types::ShippingOption) -> Self {
self.inner = self.inner.shipping_option(input);
self
}
/// <p>The shipping speed for each node in this cluster. This speed doesn't dictate how soon you'll get each Snowball Edge device, rather it represents how quickly each device moves to its destination while in transit. Regional shipping speeds are as follows: </p>
/// <ul>
/// <li> <p>In Australia, you have access to express shipping. Typically, Snow devices shipped express are delivered in about a day.</p> </li>
/// <li> <p>In the European Union (EU), you have access to express shipping. Typically, Snow devices shipped express are delivered in about a day. In addition, most countries in the EU have access to standard shipping, which typically takes less than a week, one way.</p> </li>
/// <li> <p>In India, Snow devices are delivered in one to seven days.</p> </li>
/// <li> <p>In the United States of America (US), you have access to one-day shipping and two-day shipping.</p> </li>
/// </ul>
/// <ul>
/// <li> <p>In Australia, you have access to express shipping. Typically, devices shipped express are delivered in about a day.</p> </li>
/// <li> <p>In the European Union (EU), you have access to express shipping. Typically, Snow devices shipped express are delivered in about a day. In addition, most countries in the EU have access to standard shipping, which typically takes less than a week, one way.</p> </li>
/// <li> <p>In India, Snow devices are delivered in one to seven days.</p> </li>
/// <li> <p>In the US, you have access to one-day shipping and two-day shipping.</p> </li>
/// </ul>
pub fn set_shipping_option(
mut self,
input: std::option::Option<crate::types::ShippingOption>,
) -> Self {
self.inner = self.inner.set_shipping_option(input);
self
}
/// <p>The Amazon Simple Notification Service (Amazon SNS) notification settings for this cluster.</p>
pub fn notification(mut self, input: crate::types::Notification) -> Self {
self.inner = self.inner.notification(input);
self
}
/// <p>The Amazon Simple Notification Service (Amazon SNS) notification settings for this cluster.</p>
pub fn set_notification(
mut self,
input: std::option::Option<crate::types::Notification>,
) -> Self {
self.inner = self.inner.set_notification(input);
self
}
/// <p>The forwarding address ID for a cluster. This field is not supported in most regions.</p>
pub fn forwarding_address_id(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.forwarding_address_id(input.into());
self
}
/// <p>The forwarding address ID for a cluster. This field is not supported in most regions.</p>
pub fn set_forwarding_address_id(
mut self,
input: std::option::Option<std::string::String>,
) -> Self {
self.inner = self.inner.set_forwarding_address_id(input);
self
}
/// <p>The tax documents required in your Amazon Web Services Region.</p>
pub fn tax_documents(mut self, input: crate::types::TaxDocuments) -> Self {
self.inner = self.inner.tax_documents(input);
self
}
/// <p>The tax documents required in your Amazon Web Services Region.</p>
pub fn set_tax_documents(
mut self,
input: std::option::Option<crate::types::TaxDocuments>,
) -> Self {
self.inner = self.inner.set_tax_documents(input);
self
}
/// <p>Allows you to securely operate and manage Snow devices in a cluster remotely from outside of your internal network. When set to <code>INSTALLED_AUTOSTART</code>, remote management will automatically be available when the device arrives at your location. Otherwise, you need to use the Snowball Client to manage the device.</p>
pub fn remote_management(mut self, input: crate::types::RemoteManagement) -> Self {
self.inner = self.inner.remote_management(input);
self
}
/// <p>Allows you to securely operate and manage Snow devices in a cluster remotely from outside of your internal network. When set to <code>INSTALLED_AUTOSTART</code>, remote management will automatically be available when the device arrives at your location. Otherwise, you need to use the Snowball Client to manage the device.</p>
pub fn set_remote_management(
mut self,
input: std::option::Option<crate::types::RemoteManagement>,
) -> Self {
self.inner = self.inner.set_remote_management(input);
self
}
/// <p>If provided, each job will be automatically created and associated with the new cluster. If not provided, will be treated as 0.</p>
pub fn initial_cluster_size(mut self, input: i32) -> Self {
self.inner = self.inner.initial_cluster_size(input);
self
}
/// <p>If provided, each job will be automatically created and associated with the new cluster. If not provided, will be treated as 0.</p>
pub fn set_initial_cluster_size(mut self, input: std::option::Option<i32>) -> Self {
self.inner = self.inner.set_initial_cluster_size(input);
self
}
/// <p>Force to create cluster when user attempts to overprovision or underprovision a cluster. A cluster is overprovisioned or underprovisioned if the initial size of the cluster is more (overprovisioned) or less (underprovisioned) than what needed to meet capacity requirement specified with <code>OnDeviceServiceConfiguration</code>.</p>
pub fn force_create_jobs(mut self, input: bool) -> Self {
self.inner = self.inner.force_create_jobs(input);
self
}
/// <p>Force to create cluster when user attempts to overprovision or underprovision a cluster. A cluster is overprovisioned or underprovisioned if the initial size of the cluster is more (overprovisioned) or less (underprovisioned) than what needed to meet capacity requirement specified with <code>OnDeviceServiceConfiguration</code>.</p>
pub fn set_force_create_jobs(mut self, input: std::option::Option<bool>) -> Self {
self.inner = self.inner.set_force_create_jobs(input);
self
}
/// Appends an item to `LongTermPricingIds`.
///
/// To override the contents of this collection use [`set_long_term_pricing_ids`](Self::set_long_term_pricing_ids).
///
/// <p>Lists long-term pricing id that will be used to associate with jobs automatically created for the new cluster.</p>
pub fn long_term_pricing_ids(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.long_term_pricing_ids(input.into());
self
}
/// <p>Lists long-term pricing id that will be used to associate with jobs automatically created for the new cluster.</p>
pub fn set_long_term_pricing_ids(
mut self,
input: std::option::Option<std::vec::Vec<std::string::String>>,
) -> Self {
self.inner = self.inner.set_long_term_pricing_ids(input);
self
}
/// <p>If your job is being created in one of the US regions, you have the option of specifying what size Snow device you'd like for this job. In all other regions, Snowballs come with 80 TB in storage capacity.</p>
/// <p>For more information, see "https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the <i>Snowcone User Guide</i> or "https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the <i>Snowcone User Guide</i>.</p>
pub fn snowball_capacity_preference(mut self, input: crate::types::SnowballCapacity) -> Self {
self.inner = self.inner.snowball_capacity_preference(input);
self
}
/// <p>If your job is being created in one of the US regions, you have the option of specifying what size Snow device you'd like for this job. In all other regions, Snowballs come with 80 TB in storage capacity.</p>
/// <p>For more information, see "https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the <i>Snowcone User Guide</i> or "https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html" (Snow Family Devices and Capacity) in the <i>Snowcone User Guide</i>.</p>
pub fn set_snowball_capacity_preference(
mut self,
input: std::option::Option<crate::types::SnowballCapacity>,
) -> Self {
self.inner = self.inner.set_snowball_capacity_preference(input);
self
}
}