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
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::send_text_message::_send_text_message_input::SendTextMessageInputBuilder;
pub use crate::operation::send_text_message::_send_text_message_output::SendTextMessageOutputBuilder;
impl crate::operation::send_text_message::builders::SendTextMessageInputBuilder {
/// Sends a request with this input using the given client.
pub async fn send_with(
self,
client: &crate::Client,
) -> ::std::result::Result<
crate::operation::send_text_message::SendTextMessageOutput,
::aws_smithy_runtime_api::client::result::SdkError<
crate::operation::send_text_message::SendTextMessageError,
::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
>,
> {
let mut fluent_builder = client.send_text_message();
fluent_builder.inner = self;
fluent_builder.send().await
}
}
/// Fluent builder constructing a request to `SendTextMessage`.
///
/// <p>Creates a new text message and sends it to a recipient's phone number. SendTextMessage only sends an SMS message to one recipient each time it is invoked.</p>
/// <p>SMS throughput limits are measured in Message Parts per Second (MPS). Your MPS limit depends on the destination country of your messages, as well as the type of phone number (origination number) that you use to send the message. For more information about MPS, see <a href="https://docs.aws.amazon.com/sms-voice/latest/userguide/sms-limitations-mps.html">Message Parts per Second (MPS) limits</a> in the <i>End User Messaging SMS User Guide</i>.</p>
#[derive(::std::clone::Clone, ::std::fmt::Debug)]
pub struct SendTextMessageFluentBuilder {
handle: ::std::sync::Arc<crate::client::Handle>,
inner: crate::operation::send_text_message::builders::SendTextMessageInputBuilder,
config_override: ::std::option::Option<crate::config::Builder>,
}
impl
crate::client::customize::internal::CustomizableSend<
crate::operation::send_text_message::SendTextMessageOutput,
crate::operation::send_text_message::SendTextMessageError,
> for SendTextMessageFluentBuilder
{
fn send(
self,
config_override: crate::config::Builder,
) -> crate::client::customize::internal::BoxFuture<
crate::client::customize::internal::SendResult<
crate::operation::send_text_message::SendTextMessageOutput,
crate::operation::send_text_message::SendTextMessageError,
>,
> {
::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
}
}
impl SendTextMessageFluentBuilder {
/// Creates a new `SendTextMessageFluentBuilder`.
pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
Self {
handle,
inner: ::std::default::Default::default(),
config_override: ::std::option::Option::None,
}
}
/// Access the SendTextMessage as a reference.
pub fn as_input(&self) -> &crate::operation::send_text_message::builders::SendTextMessageInputBuilder {
&self.inner
}
/// 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::send_text_message::SendTextMessageOutput,
::aws_smithy_runtime_api::client::result::SdkError<
crate::operation::send_text_message::SendTextMessageError,
::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
>,
> {
let input = self
.inner
.build()
.map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
let runtime_plugins = crate::operation::send_text_message::SendTextMessage::operation_runtime_plugins(
self.handle.runtime_plugins.clone(),
&self.handle.conf,
self.config_override,
);
crate::operation::send_text_message::SendTextMessage::orchestrate(&runtime_plugins, input).await
}
/// Consumes this builder, creating a customizable operation that can be modified before being sent.
pub fn customize(
self,
) -> crate::client::customize::CustomizableOperation<
crate::operation::send_text_message::SendTextMessageOutput,
crate::operation::send_text_message::SendTextMessageError,
Self,
> {
crate::client::customize::CustomizableOperation::new(self)
}
pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
self.set_config_override(::std::option::Option::Some(config_override.into()));
self
}
pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
self.config_override = config_override;
self
}
/// <p>The destination phone number in E.164 format.</p>
pub fn destination_phone_number(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.destination_phone_number(input.into());
self
}
/// <p>The destination phone number in E.164 format.</p>
pub fn set_destination_phone_number(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_destination_phone_number(input);
self
}
/// <p>The destination phone number in E.164 format.</p>
pub fn get_destination_phone_number(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_destination_phone_number()
}
/// <p>The origination identity of the message. This can be either the PhoneNumber, PhoneNumberId, PhoneNumberArn, RcsAgentId, RcsAgentArn, SenderId, SenderIdArn, PoolId, or PoolArn.</p><important>
/// <p>If you are using a shared End User Messaging SMS resource then you must use the full Amazon Resource Name(ARN).</p>
/// </important>
pub fn origination_identity(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.origination_identity(input.into());
self
}
/// <p>The origination identity of the message. This can be either the PhoneNumber, PhoneNumberId, PhoneNumberArn, RcsAgentId, RcsAgentArn, SenderId, SenderIdArn, PoolId, or PoolArn.</p><important>
/// <p>If you are using a shared End User Messaging SMS resource then you must use the full Amazon Resource Name(ARN).</p>
/// </important>
pub fn set_origination_identity(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_origination_identity(input);
self
}
/// <p>The origination identity of the message. This can be either the PhoneNumber, PhoneNumberId, PhoneNumberArn, RcsAgentId, RcsAgentArn, SenderId, SenderIdArn, PoolId, or PoolArn.</p><important>
/// <p>If you are using a shared End User Messaging SMS resource then you must use the full Amazon Resource Name(ARN).</p>
/// </important>
pub fn get_origination_identity(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_origination_identity()
}
/// <p>The body of the text message.</p>
pub fn message_body(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.message_body(input.into());
self
}
/// <p>The body of the text message.</p>
pub fn set_message_body(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_message_body(input);
self
}
/// <p>The body of the text message.</p>
pub fn get_message_body(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_message_body()
}
/// <p>The type of message. Valid values are for messages that are critical or time-sensitive and PROMOTIONAL for messages that aren't critical or time-sensitive.</p>
pub fn message_type(mut self, input: crate::types::MessageType) -> Self {
self.inner = self.inner.message_type(input);
self
}
/// <p>The type of message. Valid values are for messages that are critical or time-sensitive and PROMOTIONAL for messages that aren't critical or time-sensitive.</p>
pub fn set_message_type(mut self, input: ::std::option::Option<crate::types::MessageType>) -> Self {
self.inner = self.inner.set_message_type(input);
self
}
/// <p>The type of message. Valid values are for messages that are critical or time-sensitive and PROMOTIONAL for messages that aren't critical or time-sensitive.</p>
pub fn get_message_type(&self) -> &::std::option::Option<crate::types::MessageType> {
self.inner.get_message_type()
}
/// <p>When you register a short code in the US, you must specify a program name. If you don’t have a US short code, omit this attribute.</p>
pub fn keyword(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.keyword(input.into());
self
}
/// <p>When you register a short code in the US, you must specify a program name. If you don’t have a US short code, omit this attribute.</p>
pub fn set_keyword(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_keyword(input);
self
}
/// <p>When you register a short code in the US, you must specify a program name. If you don’t have a US short code, omit this attribute.</p>
pub fn get_keyword(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_keyword()
}
/// <p>The name of the configuration set to use. This can be either the ConfigurationSetName or ConfigurationSetArn.</p>
pub fn configuration_set_name(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.configuration_set_name(input.into());
self
}
/// <p>The name of the configuration set to use. This can be either the ConfigurationSetName or ConfigurationSetArn.</p>
pub fn set_configuration_set_name(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_configuration_set_name(input);
self
}
/// <p>The name of the configuration set to use. This can be either the ConfigurationSetName or ConfigurationSetArn.</p>
pub fn get_configuration_set_name(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_configuration_set_name()
}
/// <p>The maximum amount that you want to spend, in US dollars, per each text message. If the calculated amount to send the text message is greater than <code>MaxPrice</code>, the message is not sent and an error is returned.</p>
pub fn max_price(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.max_price(input.into());
self
}
/// <p>The maximum amount that you want to spend, in US dollars, per each text message. If the calculated amount to send the text message is greater than <code>MaxPrice</code>, the message is not sent and an error is returned.</p>
pub fn set_max_price(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_max_price(input);
self
}
/// <p>The maximum amount that you want to spend, in US dollars, per each text message. If the calculated amount to send the text message is greater than <code>MaxPrice</code>, the message is not sent and an error is returned.</p>
pub fn get_max_price(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_max_price()
}
/// <p>How long the text message is valid for, in seconds. By default this is 72 hours. If the messages isn't handed off before the TTL expires we stop attempting to hand off the message and return <code>TTL_EXPIRED</code> event.</p>
pub fn time_to_live(mut self, input: i32) -> Self {
self.inner = self.inner.time_to_live(input);
self
}
/// <p>How long the text message is valid for, in seconds. By default this is 72 hours. If the messages isn't handed off before the TTL expires we stop attempting to hand off the message and return <code>TTL_EXPIRED</code> event.</p>
pub fn set_time_to_live(mut self, input: ::std::option::Option<i32>) -> Self {
self.inner = self.inner.set_time_to_live(input);
self
}
/// <p>How long the text message is valid for, in seconds. By default this is 72 hours. If the messages isn't handed off before the TTL expires we stop attempting to hand off the message and return <code>TTL_EXPIRED</code> event.</p>
pub fn get_time_to_live(&self) -> &::std::option::Option<i32> {
self.inner.get_time_to_live()
}
///
/// Adds a key-value pair to `Context`.
///
/// To override the contents of this collection use [`set_context`](Self::set_context).
///
/// <p>You can specify custom data in this field. If you do, that data is logged to the event destination.</p>
pub fn context(mut self, k: impl ::std::convert::Into<::std::string::String>, v: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.context(k.into(), v.into());
self
}
/// <p>You can specify custom data in this field. If you do, that data is logged to the event destination.</p>
pub fn set_context(mut self, input: ::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>>) -> Self {
self.inner = self.inner.set_context(input);
self
}
/// <p>You can specify custom data in this field. If you do, that data is logged to the event destination.</p>
pub fn get_context(&self) -> &::std::option::Option<::std::collections::HashMap<::std::string::String, ::std::string::String>> {
self.inner.get_context()
}
///
/// Adds a key-value pair to `DestinationCountryParameters`.
///
/// To override the contents of this collection use [`set_destination_country_parameters`](Self::set_destination_country_parameters).
///
/// <p>This field is used for any country-specific registration requirements. Currently, this setting is only used when you send messages to recipients in India using a sender ID. For more information see <a href="https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-sms-senderid-india.html">Special requirements for sending SMS messages to recipients in India</a>.</p>
/// <ul>
/// <li>
/// <p><code>IN_ENTITY_ID</code> The entity ID or Principal Entity (PE) ID that you received after completing the sender ID registration process.</p></li>
/// <li>
/// <p><code>IN_TEMPLATE_ID</code> The template ID that you received after completing the sender ID registration process.</p><important>
/// <p>Make sure that the Template ID that you specify matches your message template exactly. If your message doesn't match the template that you provided during the registration process, the mobile carriers might reject your message.</p>
/// </important></li>
/// </ul>
pub fn destination_country_parameters(
mut self,
k: crate::types::DestinationCountryParameterKey,
v: impl ::std::convert::Into<::std::string::String>,
) -> Self {
self.inner = self.inner.destination_country_parameters(k, v.into());
self
}
/// <p>This field is used for any country-specific registration requirements. Currently, this setting is only used when you send messages to recipients in India using a sender ID. For more information see <a href="https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-sms-senderid-india.html">Special requirements for sending SMS messages to recipients in India</a>.</p>
/// <ul>
/// <li>
/// <p><code>IN_ENTITY_ID</code> The entity ID or Principal Entity (PE) ID that you received after completing the sender ID registration process.</p></li>
/// <li>
/// <p><code>IN_TEMPLATE_ID</code> The template ID that you received after completing the sender ID registration process.</p><important>
/// <p>Make sure that the Template ID that you specify matches your message template exactly. If your message doesn't match the template that you provided during the registration process, the mobile carriers might reject your message.</p>
/// </important></li>
/// </ul>
pub fn set_destination_country_parameters(
mut self,
input: ::std::option::Option<::std::collections::HashMap<crate::types::DestinationCountryParameterKey, ::std::string::String>>,
) -> Self {
self.inner = self.inner.set_destination_country_parameters(input);
self
}
/// <p>This field is used for any country-specific registration requirements. Currently, this setting is only used when you send messages to recipients in India using a sender ID. For more information see <a href="https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-sms-senderid-india.html">Special requirements for sending SMS messages to recipients in India</a>.</p>
/// <ul>
/// <li>
/// <p><code>IN_ENTITY_ID</code> The entity ID or Principal Entity (PE) ID that you received after completing the sender ID registration process.</p></li>
/// <li>
/// <p><code>IN_TEMPLATE_ID</code> The template ID that you received after completing the sender ID registration process.</p><important>
/// <p>Make sure that the Template ID that you specify matches your message template exactly. If your message doesn't match the template that you provided during the registration process, the mobile carriers might reject your message.</p>
/// </important></li>
/// </ul>
pub fn get_destination_country_parameters(
&self,
) -> &::std::option::Option<::std::collections::HashMap<crate::types::DestinationCountryParameterKey, ::std::string::String>> {
self.inner.get_destination_country_parameters()
}
/// <p>When set to true, the message is checked and validated, but isn't sent to the end recipient. You are not charged for using <code>DryRun</code>.</p>
/// <p>The Message Parts per Second (MPS) limit when using <code>DryRun</code> is five. If your origination identity has a lower MPS limit then the lower MPS limit is used. For more information about MPS limits, see <a href="https://docs.aws.amazon.com/sms-voice/latest/userguide/sms-limitations-mps.html">Message Parts per Second (MPS) limits</a> in the <i>End User Messaging SMS User Guide</i>..</p>
pub fn dry_run(mut self, input: bool) -> Self {
self.inner = self.inner.dry_run(input);
self
}
/// <p>When set to true, the message is checked and validated, but isn't sent to the end recipient. You are not charged for using <code>DryRun</code>.</p>
/// <p>The Message Parts per Second (MPS) limit when using <code>DryRun</code> is five. If your origination identity has a lower MPS limit then the lower MPS limit is used. For more information about MPS limits, see <a href="https://docs.aws.amazon.com/sms-voice/latest/userguide/sms-limitations-mps.html">Message Parts per Second (MPS) limits</a> in the <i>End User Messaging SMS User Guide</i>..</p>
pub fn set_dry_run(mut self, input: ::std::option::Option<bool>) -> Self {
self.inner = self.inner.set_dry_run(input);
self
}
/// <p>When set to true, the message is checked and validated, but isn't sent to the end recipient. You are not charged for using <code>DryRun</code>.</p>
/// <p>The Message Parts per Second (MPS) limit when using <code>DryRun</code> is five. If your origination identity has a lower MPS limit then the lower MPS limit is used. For more information about MPS limits, see <a href="https://docs.aws.amazon.com/sms-voice/latest/userguide/sms-limitations-mps.html">Message Parts per Second (MPS) limits</a> in the <i>End User Messaging SMS User Guide</i>..</p>
pub fn get_dry_run(&self) -> &::std::option::Option<bool> {
self.inner.get_dry_run()
}
/// <p>The unique identifier for the protect configuration.</p>
pub fn protect_configuration_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
self.inner = self.inner.protect_configuration_id(input.into());
self
}
/// <p>The unique identifier for the protect configuration.</p>
pub fn set_protect_configuration_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
self.inner = self.inner.set_protect_configuration_id(input);
self
}
/// <p>The unique identifier for the protect configuration.</p>
pub fn get_protect_configuration_id(&self) -> &::std::option::Option<::std::string::String> {
self.inner.get_protect_configuration_id()
}
/// <p>Set to true to enable message feedback for the message. When a user receives the message you need to update the message status using <code>PutMessageFeedback</code>.</p>
pub fn message_feedback_enabled(mut self, input: bool) -> Self {
self.inner = self.inner.message_feedback_enabled(input);
self
}
/// <p>Set to true to enable message feedback for the message. When a user receives the message you need to update the message status using <code>PutMessageFeedback</code>.</p>
pub fn set_message_feedback_enabled(mut self, input: ::std::option::Option<bool>) -> Self {
self.inner = self.inner.set_message_feedback_enabled(input);
self
}
/// <p>Set to true to enable message feedback for the message. When a user receives the message you need to update the message status using <code>PutMessageFeedback</code>.</p>
pub fn get_message_feedback_enabled(&self) -> &::std::option::Option<bool> {
self.inner.get_message_feedback_enabled()
}
}