aws-sdk-sns 1.39.0 → 1.43.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: a682ab972d2e0d345cb3744e2c9fc598533361f9e3ff6a7bea5187211b2890f6
4
- data.tar.gz: fe17783e400af144e7502e2e5f749125eec3f52a1189454e876efa657c4ef4d1
3
+ metadata.gz: f05e4227f3f52bdf1f05432dc79ec7cb799c13e1076c3de77c2d901b30a5fc0e
4
+ data.tar.gz: f39b27d844d1c4e5e9bdc23b731471f86b21fdb98a7c268c60f01b113fd55e63
5
5
  SHA512:
6
- metadata.gz: c4f6e8e556bfa2eaff651f228c84a5dcb3b2a2deffc2bde4ddb2e1795499e2cf6cc26768a5851cf915c775bdb5c1a40b8d5d444d38991d28d7c5c1724ea53edc
7
- data.tar.gz: 450ccb7990e24c81c06586ad52bec9360b1ee86e612e4ac6534d02128d362288952ce2ab300c3938e36ced72531996dd1454b5ee7b84a7b212d2926a3298739a
6
+ metadata.gz: de5a048a52648f5b0a6216264fdb52526952dc70ef90f0b7220c59858927ee9cc517e7d320dad767772b5f45ce6f3f92f9516cc551fe807b940420b80e81a343
7
+ data.tar.gz: f28a79f66749c61e52ea270d7e0c8d87a8dcbcaf3ccff460207328bff9c366fd9016ede104b70bd409753d58510a510135adac3c95304b60aee54b9fdae27768
data/CHANGELOG.md CHANGED
@@ -1,6 +1,26 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.43.0 (2021-07-28)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.42.0 (2021-07-06)
10
+ ------------------
11
+
12
+ * Feature - Documentation updates for Amazon SNS.
13
+
14
+ 1.41.0 (2021-06-01)
15
+ ------------------
16
+
17
+ * Feature - This release adds SMS sandbox in Amazon SNS and the ability to view all configured origination numbers. The SMS sandbox provides a safe environment for sending SMS messages, without risking your reputation as an SMS sender.
18
+
19
+ 1.40.0 (2021-04-23)
20
+ ------------------
21
+
22
+ * Feature - Amazon SNS adds two new attributes, TemplateId and EntityId, for using sender IDs to send SMS messages to destinations in India.
23
+
4
24
  1.39.0 (2021-03-10)
5
25
  ------------------
6
26
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.39.0
1
+ 1.43.0
data/lib/aws-sdk-sns.rb CHANGED
@@ -52,6 +52,6 @@ require_relative 'aws-sdk-sns/customizations'
52
52
  # @!group service
53
53
  module Aws::SNS
54
54
 
55
- GEM_VERSION = '1.39.0'
55
+ GEM_VERSION = '1.43.0'
56
56
 
57
57
  end
@@ -328,7 +328,7 @@ module Aws::SNS
328
328
  # @!group API Operations
329
329
 
330
330
  # Adds a statement to a topic's access control policy, granting access
331
- # for the specified AWS accounts to the specified actions.
331
+ # for the specified accounts to the specified actions.
332
332
  #
333
333
  # @option params [required, String] :topic_arn
334
334
  # The ARN of the topic whose access control policy you wish to modify.
@@ -337,9 +337,9 @@ module Aws::SNS
337
337
  # A unique identifier for the new policy statement.
338
338
  #
339
339
  # @option params [required, Array<String>] :aws_account_id
340
- # The AWS account IDs of the users (principals) who will be given access
341
- # to the specified actions. The users must have AWS accounts, but do not
342
- # need to be signed up for this service.
340
+ # The account IDs of the users (principals) who will be given access to
341
+ # the specified actions. The users must have account, but do not need to
342
+ # be signed up for this service.
343
343
  #
344
344
  # @option params [required, Array<String>] :action_name
345
345
  # The action you want to allow for the specified principal(s).
@@ -413,10 +413,10 @@ module Aws::SNS
413
413
  #
414
414
  # @option params [String] :authenticate_on_unsubscribe
415
415
  # Disallows unauthenticated unsubscribes of the subscription. If the
416
- # value of this parameter is `true` and the request has an AWS
417
- # signature, then only the topic owner and the subscription owner can
418
- # unsubscribe the endpoint. The unsubscribe action requires AWS
419
- # authentication.
416
+ # value of this parameter is `true` and the request has an Amazon Web
417
+ # Services signature, then only the topic owner and the subscription
418
+ # owner can unsubscribe the endpoint. The unsubscribe action requires
419
+ # Amazon Web Services authentication.
420
420
  #
421
421
  # @return [Types::ConfirmSubscriptionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
422
422
  #
@@ -484,7 +484,7 @@ module Aws::SNS
484
484
  # (Firebase Cloud Messaging).
485
485
  #
486
486
  # @option params [required, Hash<String,String>] :attributes
487
- # For a list of attributes, see [SetPlatformApplicationAttributes][1]
487
+ # For a list of attributes, see [SetPlatformApplicationAttributes][1].
488
488
  #
489
489
  #
490
490
  #
@@ -590,16 +590,58 @@ module Aws::SNS
590
590
  req.send_request(options)
591
591
  end
592
592
 
593
+ # Adds a destination phone number to an account in the SMS sandbox and
594
+ # sends a one-time password (OTP) to that phone number.
595
+ #
596
+ # When you start using Amazon SNS to send SMS messages, your account is
597
+ # in the *SMS sandbox*. The SMS sandbox provides a safe environment for
598
+ # you to try Amazon SNS features without risking your reputation as an
599
+ # SMS sender. While your account is in the SMS sandbox, you can use all
600
+ # of the features of Amazon SNS. However, you can send SMS messages only
601
+ # to verified destination phone numbers. For more information, including
602
+ # how to move out of the sandbox to send messages without restrictions,
603
+ # see [SMS sandbox][1] in the *Amazon SNS Developer Guide*.
604
+ #
605
+ #
606
+ #
607
+ # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-sms-sandbox.html
608
+ #
609
+ # @option params [required, String] :phone_number
610
+ # The destination phone number to verify. On verification, Amazon SNS
611
+ # adds this phone number to the list of verified phone numbers that you
612
+ # can send SMS messages to.
613
+ #
614
+ # @option params [String] :language_code
615
+ # The language to use for sending the OTP. The default value is `en-US`.
616
+ #
617
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
618
+ #
619
+ # @example Request syntax with placeholder values
620
+ #
621
+ # resp = client.create_sms_sandbox_phone_number({
622
+ # phone_number: "PhoneNumberString", # required
623
+ # language_code: "en-US", # accepts en-US, en-GB, es-419, es-ES, de-DE, fr-CA, fr-FR, it-IT, ja-JP, pt-BR, kr-KR, zh-CN, zh-TW
624
+ # })
625
+ #
626
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/CreateSMSSandboxPhoneNumber AWS API Documentation
627
+ #
628
+ # @overload create_sms_sandbox_phone_number(params = {})
629
+ # @param [Hash] params ({})
630
+ def create_sms_sandbox_phone_number(params = {}, options = {})
631
+ req = build_request(:create_sms_sandbox_phone_number, params)
632
+ req.send_request(options)
633
+ end
634
+
593
635
  # Creates a topic to which notifications can be published. Users can
594
636
  # create at most 100,000 standard topics (at most 1,000 FIFO topics).
595
- # For more information, see [https://aws.amazon.com/sns][1]. This action
596
- # is idempotent, so if the requester already owns a topic with the
597
- # specified name, that topic's ARN is returned without creating a new
598
- # topic.
637
+ # For more information, see [Creating an Amazon SNS topic][1] in the
638
+ # *Amazon SNS Developer Guide*. This action is idempotent, so if the
639
+ # requester already owns a topic with the specified name, that topic's
640
+ # ARN is returned without creating a new topic.
599
641
  #
600
642
  #
601
643
  #
602
- # [1]: http://aws.amazon.com/sns/
644
+ # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html
603
645
  #
604
646
  # @option params [required, String] :name
605
647
  # The name of the topic you want to create.
@@ -628,12 +670,12 @@ module Aws::SNS
628
670
  # * `Policy` – The policy that defines who can access your topic. By
629
671
  # default, only the topic owner can publish or subscribe to the topic.
630
672
  #
631
- # The following attribute applies only to [server-side-encryption][1]\:
673
+ # The following attribute applies only to [server-side encryption][1]\:
632
674
  #
633
- # * `KmsMasterKeyId` – The ID of an AWS-managed customer master key
634
- # (CMK) for Amazon SNS or a custom CMK. For more information, see [Key
635
- # Terms][2]. For more examples, see [KeyId][3] in the *AWS Key
636
- # Management Service API Reference*.
675
+ # * `KmsMasterKeyId` – The ID of an Amazon Web Services managed customer
676
+ # master key (CMK) for Amazon SNS or a custom CMK. For more
677
+ # information, see [Key Terms][2]. For more examples, see [KeyId][3]
678
+ # in the *Key Management Service API Reference*.
637
679
  #
638
680
  # ^
639
681
  #
@@ -654,8 +696,8 @@ module Aws::SNS
654
696
  # the body of the message (but not the attributes of the message).
655
697
  #
656
698
  # (Optional) To override the generated value, you can specify a
657
- # value for the the `MessageDeduplicationId` parameter for the
658
- # `Publish` action.
699
+ # value for the `MessageDeduplicationId` parameter for the `Publish`
700
+ # action.
659
701
  #
660
702
  #
661
703
  #
@@ -765,6 +807,42 @@ module Aws::SNS
765
807
  req.send_request(options)
766
808
  end
767
809
 
810
+ # Deletes an account's verified or pending phone number from the SMS
811
+ # sandbox.
812
+ #
813
+ # When you start using Amazon SNS to send SMS messages, your account is
814
+ # in the *SMS sandbox*. The SMS sandbox provides a safe environment for
815
+ # you to try Amazon SNS features without risking your reputation as an
816
+ # SMS sender. While your account is in the SMS sandbox, you can use all
817
+ # of the features of Amazon SNS. However, you can send SMS messages only
818
+ # to verified destination phone numbers. For more information, including
819
+ # how to move out of the sandbox to send messages without restrictions,
820
+ # see [SMS sandbox][1] in the *Amazon SNS Developer Guide*.
821
+ #
822
+ #
823
+ #
824
+ # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-sms-sandbox.html
825
+ #
826
+ # @option params [required, String] :phone_number
827
+ # The destination phone number to delete.
828
+ #
829
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
830
+ #
831
+ # @example Request syntax with placeholder values
832
+ #
833
+ # resp = client.delete_sms_sandbox_phone_number({
834
+ # phone_number: "PhoneNumberString", # required
835
+ # })
836
+ #
837
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/DeleteSMSSandboxPhoneNumber AWS API Documentation
838
+ #
839
+ # @overload delete_sms_sandbox_phone_number(params = {})
840
+ # @param [Hash] params ({})
841
+ def delete_sms_sandbox_phone_number(params = {}, options = {})
842
+ req = build_request(:delete_sms_sandbox_phone_number, params)
843
+ req.send_request(options)
844
+ end
845
+
768
846
  # Deletes a topic and all its subscriptions. Deleting a topic might
769
847
  # prevent some messages previously sent to the topic from being
770
848
  # delivered to subscribers. This action is idempotent, so deleting a
@@ -903,6 +981,39 @@ module Aws::SNS
903
981
  req.send_request(options)
904
982
  end
905
983
 
984
+ # Retrieves the SMS sandbox status for the calling account in the target
985
+ # Region.
986
+ #
987
+ # When you start using Amazon SNS to send SMS messages, your account is
988
+ # in the *SMS sandbox*. The SMS sandbox provides a safe environment for
989
+ # you to try Amazon SNS features without risking your reputation as an
990
+ # SMS sender. While your account is in the SMS sandbox, you can use all
991
+ # of the features of Amazon SNS. However, you can send SMS messages only
992
+ # to verified destination phone numbers. For more information, including
993
+ # how to move out of the sandbox to send messages without restrictions,
994
+ # see [SMS sandbox][1] in the *Amazon SNS Developer Guide*.
995
+ #
996
+ #
997
+ #
998
+ # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-sms-sandbox.html
999
+ #
1000
+ # @return [Types::GetSMSSandboxAccountStatusResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1001
+ #
1002
+ # * {Types::GetSMSSandboxAccountStatusResult#is_in_sandbox #is_in_sandbox} => Boolean
1003
+ #
1004
+ # @example Response structure
1005
+ #
1006
+ # resp.is_in_sandbox #=> Boolean
1007
+ #
1008
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/GetSMSSandboxAccountStatus AWS API Documentation
1009
+ #
1010
+ # @overload get_sms_sandbox_account_status(params = {})
1011
+ # @param [Hash] params ({})
1012
+ def get_sms_sandbox_account_status(params = {}, options = {})
1013
+ req = build_request(:get_sms_sandbox_account_status, params)
1014
+ req.send_request(options)
1015
+ end
1016
+
906
1017
  # Returns all of the properties of a subscription.
907
1018
  #
908
1019
  # @option params [required, String] :subscription_arn
@@ -1019,6 +1130,55 @@ module Aws::SNS
1019
1130
  req.send_request(options)
1020
1131
  end
1021
1132
 
1133
+ # Lists the calling account's dedicated origination numbers and their
1134
+ # metadata. For more information about origination numbers, see
1135
+ # [Origination numbers][1] in the *Amazon SNS Developer Guide*.
1136
+ #
1137
+ #
1138
+ #
1139
+ # [1]: https://docs.aws.amazon.com/sns/latest/dg/channels-sms-originating-identities-origination-numbers.html
1140
+ #
1141
+ # @option params [String] :next_token
1142
+ # Token that the previous `ListOriginationNumbers` request returns.
1143
+ #
1144
+ # @option params [Integer] :max_results
1145
+ # The maximum number of origination numbers to return.
1146
+ #
1147
+ # @return [Types::ListOriginationNumbersResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1148
+ #
1149
+ # * {Types::ListOriginationNumbersResult#next_token #next_token} => String
1150
+ # * {Types::ListOriginationNumbersResult#phone_numbers #phone_numbers} => Array&lt;Types::PhoneNumberInformation&gt;
1151
+ #
1152
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1153
+ #
1154
+ # @example Request syntax with placeholder values
1155
+ #
1156
+ # resp = client.list_origination_numbers({
1157
+ # next_token: "nextToken",
1158
+ # max_results: 1,
1159
+ # })
1160
+ #
1161
+ # @example Response structure
1162
+ #
1163
+ # resp.next_token #=> String
1164
+ # resp.phone_numbers #=> Array
1165
+ # resp.phone_numbers[0].created_at #=> Time
1166
+ # resp.phone_numbers[0].phone_number #=> String
1167
+ # resp.phone_numbers[0].status #=> String
1168
+ # resp.phone_numbers[0].iso_2_country_code #=> String
1169
+ # resp.phone_numbers[0].route_type #=> String, one of "Transactional", "Promotional", "Premium"
1170
+ # resp.phone_numbers[0].number_capabilities #=> Array
1171
+ # resp.phone_numbers[0].number_capabilities[0] #=> String, one of "SMS", "MMS", "VOICE"
1172
+ #
1173
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/ListOriginationNumbers AWS API Documentation
1174
+ #
1175
+ # @overload list_origination_numbers(params = {})
1176
+ # @param [Hash] params ({})
1177
+ def list_origination_numbers(params = {}, options = {})
1178
+ req = build_request(:list_origination_numbers, params)
1179
+ req.send_request(options)
1180
+ end
1181
+
1022
1182
  # Returns a list of phone numbers that are opted out, meaning you cannot
1023
1183
  # send SMS messages to them.
1024
1184
  #
@@ -1040,6 +1200,8 @@ module Aws::SNS
1040
1200
  # * {Types::ListPhoneNumbersOptedOutResponse#phone_numbers #phone_numbers} => Array&lt;String&gt;
1041
1201
  # * {Types::ListPhoneNumbersOptedOutResponse#next_token #next_token} => String
1042
1202
  #
1203
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1204
+ #
1043
1205
  # @example Request syntax with placeholder values
1044
1206
  #
1045
1207
  # resp = client.list_phone_numbers_opted_out({
@@ -1113,6 +1275,59 @@ module Aws::SNS
1113
1275
  req.send_request(options)
1114
1276
  end
1115
1277
 
1278
+ # Lists the calling account's current verified and pending destination
1279
+ # phone numbers in the SMS sandbox.
1280
+ #
1281
+ # When you start using Amazon SNS to send SMS messages, your account is
1282
+ # in the *SMS sandbox*. The SMS sandbox provides a safe environment for
1283
+ # you to try Amazon SNS features without risking your reputation as an
1284
+ # SMS sender. While your account is in the SMS sandbox, you can use all
1285
+ # of the features of Amazon SNS. However, you can send SMS messages only
1286
+ # to verified destination phone numbers. For more information, including
1287
+ # how to move out of the sandbox to send messages without restrictions,
1288
+ # see [SMS sandbox][1] in the *Amazon SNS Developer Guide*.
1289
+ #
1290
+ #
1291
+ #
1292
+ # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-sms-sandbox.html
1293
+ #
1294
+ # @option params [String] :next_token
1295
+ # Token that the previous `ListSMSSandboxPhoneNumbersInput` request
1296
+ # returns.
1297
+ #
1298
+ # @option params [Integer] :max_results
1299
+ # The maximum number of phone numbers to return.
1300
+ #
1301
+ # @return [Types::ListSMSSandboxPhoneNumbersResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1302
+ #
1303
+ # * {Types::ListSMSSandboxPhoneNumbersResult#phone_numbers #phone_numbers} => Array&lt;Types::SMSSandboxPhoneNumber&gt;
1304
+ # * {Types::ListSMSSandboxPhoneNumbersResult#next_token #next_token} => String
1305
+ #
1306
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1307
+ #
1308
+ # @example Request syntax with placeholder values
1309
+ #
1310
+ # resp = client.list_sms_sandbox_phone_numbers({
1311
+ # next_token: "nextToken",
1312
+ # max_results: 1,
1313
+ # })
1314
+ #
1315
+ # @example Response structure
1316
+ #
1317
+ # resp.phone_numbers #=> Array
1318
+ # resp.phone_numbers[0].phone_number #=> String
1319
+ # resp.phone_numbers[0].status #=> String, one of "Pending", "Verified"
1320
+ # resp.next_token #=> String
1321
+ #
1322
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/ListSMSSandboxPhoneNumbers AWS API Documentation
1323
+ #
1324
+ # @overload list_sms_sandbox_phone_numbers(params = {})
1325
+ # @param [Hash] params ({})
1326
+ def list_sms_sandbox_phone_numbers(params = {}, options = {})
1327
+ req = build_request(:list_sms_sandbox_phone_numbers, params)
1328
+ req.send_request(options)
1329
+ end
1330
+
1116
1331
  # Returns a list of the requester's subscriptions. Each call returns a
1117
1332
  # limited list of subscriptions, up to 100. If there are more
1118
1333
  # subscriptions, a `NextToken` is also returned. Use the `NextToken`
@@ -1282,7 +1497,7 @@ module Aws::SNS
1282
1497
  # You can opt in a phone number only once every 30 days.
1283
1498
  #
1284
1499
  # @option params [required, String] :phone_number
1285
- # The phone number to opt in.
1500
+ # The phone number to opt in. Use E.164 format.
1286
1501
  #
1287
1502
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1288
1503
  #
@@ -1322,7 +1537,7 @@ module Aws::SNS
1322
1537
  # For more information about formatting messages, see [Send Custom
1323
1538
  # Platform-Specific Payloads in Messages to Mobile Devices][1].
1324
1539
  #
1325
- # You can publish messages only to topics and endpoints in the same AWS
1540
+ # You can publish messages only to topics and endpoints in the same
1326
1541
  # Region.
1327
1542
  #
1328
1543
  #
@@ -1736,7 +1951,7 @@ module Aws::SNS
1736
1951
  # * Total number of parts
1737
1952
  #
1738
1953
  # To receive the report, the bucket must have a policy that allows the
1739
- # Amazon SNS service principle to perform the `s3:PutObject` and
1954
+ # Amazon SNS service principal to perform the `s3:PutObject` and
1740
1955
  # `s3:GetBucketLocation` actions.
1741
1956
  #
1742
1957
  # For an example bucket policy and usage report, see [Monitoring SMS
@@ -1814,7 +2029,7 @@ module Aws::SNS
1814
2029
  #
1815
2030
  #
1816
2031
  #
1817
- # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-kinesis-subscriber.html
2032
+ # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-firehose-as-subscriber.html
1818
2033
  #
1819
2034
  # @option params [String] :attribute_value
1820
2035
  # The new value for the attribute in JSON format.
@@ -1860,10 +2075,10 @@ module Aws::SNS
1860
2075
  #
1861
2076
  # The following attribute applies only to [server-side-encryption][1]\:
1862
2077
  #
1863
- # * `KmsMasterKeyId` – The ID of an AWS-managed customer master key
1864
- # (CMK) for Amazon SNS or a custom CMK. For more information, see [Key
1865
- # Terms][2]. For more examples, see [KeyId][3] in the *AWS Key
1866
- # Management Service API Reference*.
2078
+ # * `KmsMasterKeyId` – The ID of an Amazon Web Services managed customer
2079
+ # master key (CMK) for Amazon SNS or a custom CMK. For more
2080
+ # information, see [Key Terms][2]. For more examples, see [KeyId][3]
2081
+ # in the *Key Management Service API Reference*.
1867
2082
  #
1868
2083
  # ^
1869
2084
  #
@@ -1882,8 +2097,8 @@ module Aws::SNS
1882
2097
  # the body of the message (but not the attributes of the message).
1883
2098
  #
1884
2099
  # (Optional) To override the generated value, you can specify a
1885
- # value for the the `MessageDeduplicationId` parameter for the
1886
- # `Publish` action.
2100
+ # value for the `MessageDeduplicationId` parameter for the `Publish`
2101
+ # action.
1887
2102
  #
1888
2103
  #
1889
2104
  #
@@ -1917,8 +2132,8 @@ module Aws::SNS
1917
2132
 
1918
2133
  # Subscribes an endpoint to an Amazon SNS topic. If the endpoint type is
1919
2134
  # HTTP/S or email, or if the endpoint and the topic are not in the same
1920
- # AWS account, the endpoint owner must run the `ConfirmSubscription`
1921
- # action to confirm the subscription.
2135
+ # account, the endpoint owner must run the `ConfirmSubscription` action
2136
+ # to confirm the subscription.
1922
2137
  #
1923
2138
  # You call the `ConfirmSubscription` action with the token from the
1924
2139
  # subscription response. Confirmation tokens are valid for three days.
@@ -1946,8 +2161,7 @@ module Aws::SNS
1946
2161
  # * `application` – delivery of JSON-encoded message to an EndpointArn
1947
2162
  # for a mobile app and device
1948
2163
  #
1949
- # * `lambda` – delivery of JSON-encoded message to an AWS Lambda
1950
- # function
2164
+ # * `lambda` – delivery of JSON-encoded message to an Lambda function
1951
2165
  #
1952
2166
  # * `firehose` – delivery of JSON-encoded message to an Amazon Kinesis
1953
2167
  # Data Firehose delivery stream.
@@ -1975,7 +2189,7 @@ module Aws::SNS
1975
2189
  # * For the `application` protocol, the endpoint is the EndpointArn of a
1976
2190
  # mobile app and device.
1977
2191
  #
1978
- # * For the `lambda` protocol, the endpoint is the ARN of an AWS Lambda
2192
+ # * For the `lambda` protocol, the endpoint is the ARN of an Lambda
1979
2193
  # function.
1980
2194
  #
1981
2195
  # * For the `firehose` protocol, the endpoint is the ARN of an Amazon
@@ -1985,7 +2199,7 @@ module Aws::SNS
1985
2199
  # A map of attributes with their corresponding values.
1986
2200
  #
1987
2201
  # The following lists the names, descriptions, and values of the special
1988
- # request parameters that the `SetTopicAttributes` action uses:
2202
+ # request parameters that the `Subscribe` action uses:
1989
2203
  #
1990
2204
  # * `DeliveryPolicy` – The policy that defines how Amazon SNS retries
1991
2205
  # failed deliveries to HTTP/S endpoints.
@@ -2023,7 +2237,7 @@ module Aws::SNS
2023
2237
  #
2024
2238
  #
2025
2239
  #
2026
- # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-kinesis-subscriber.html
2240
+ # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-firehose-as-subscriber.html
2027
2241
  #
2028
2242
  # @option params [Boolean] :return_subscription_arn
2029
2243
  # Sets whether the response from the `Subscribe` request includes the
@@ -2084,9 +2298,9 @@ module Aws::SNS
2084
2298
  # * A new tag with a key identical to that of an existing tag overwrites
2085
2299
  # the existing tag.
2086
2300
  #
2087
- # * Tagging actions are limited to 10 TPS per AWS account, per AWS
2088
- # region. If your application requires a higher throughput, file a
2089
- # [technical support request][2].
2301
+ # * Tagging actions are limited to 10 TPS per account, per Region. If
2302
+ # your application requires a higher throughput, file a [technical
2303
+ # support request][2].
2090
2304
  #
2091
2305
  #
2092
2306
  #
@@ -2125,10 +2339,10 @@ module Aws::SNS
2125
2339
 
2126
2340
  # Deletes a subscription. If the subscription requires authentication
2127
2341
  # for deletion, only the owner of the subscription or the topic's owner
2128
- # can unsubscribe, and an AWS signature is required. If the
2129
- # `Unsubscribe` call does not require authentication and the requester
2130
- # is not the subscription owner, a final cancellation message is
2131
- # delivered to the endpoint, so that the endpoint owner can easily
2342
+ # can unsubscribe, and an Amazon Web Services signature is required. If
2343
+ # the `Unsubscribe` call does not require authentication and the
2344
+ # requester is not the subscription owner, a final cancellation message
2345
+ # is delivered to the endpoint, so that the endpoint owner can easily
2132
2346
  # resubscribe to the topic if the `Unsubscribe` request was unintended.
2133
2347
  #
2134
2348
  # This action is throttled at 100 transactions per second (TPS).
@@ -2184,6 +2398,47 @@ module Aws::SNS
2184
2398
  req.send_request(options)
2185
2399
  end
2186
2400
 
2401
+ # Verifies a destination phone number with a one-time password (OTP) for
2402
+ # the calling account.
2403
+ #
2404
+ # When you start using Amazon SNS to send SMS messages, your account is
2405
+ # in the *SMS sandbox*. The SMS sandbox provides a safe environment for
2406
+ # you to try Amazon SNS features without risking your reputation as an
2407
+ # SMS sender. While your account is in the SMS sandbox, you can use all
2408
+ # of the features of Amazon SNS. However, you can send SMS messages only
2409
+ # to verified destination phone numbers. For more information, including
2410
+ # how to move out of the sandbox to send messages without restrictions,
2411
+ # see [SMS sandbox][1] in the *Amazon SNS Developer Guide*.
2412
+ #
2413
+ #
2414
+ #
2415
+ # [1]: https://docs.aws.amazon.com/sns/latest/dg/sns-sms-sandbox.html
2416
+ #
2417
+ # @option params [required, String] :phone_number
2418
+ # The destination phone number to verify.
2419
+ #
2420
+ # @option params [required, String] :one_time_password
2421
+ # The OTP sent to the destination number from the
2422
+ # `CreateSMSSandBoxPhoneNumber` call.
2423
+ #
2424
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2425
+ #
2426
+ # @example Request syntax with placeholder values
2427
+ #
2428
+ # resp = client.verify_sms_sandbox_phone_number({
2429
+ # phone_number: "PhoneNumberString", # required
2430
+ # one_time_password: "OTPCode", # required
2431
+ # })
2432
+ #
2433
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/VerifySMSSandboxPhoneNumber AWS API Documentation
2434
+ #
2435
+ # @overload verify_sms_sandbox_phone_number(params = {})
2436
+ # @param [Hash] params ({})
2437
+ def verify_sms_sandbox_phone_number(params = {}, options = {})
2438
+ req = build_request(:verify_sms_sandbox_phone_number, params)
2439
+ req.send_request(options)
2440
+ end
2441
+
2187
2442
  # @!endgroup
2188
2443
 
2189
2444
  # @param params ({})
@@ -2197,7 +2452,7 @@ module Aws::SNS
2197
2452
  params: params,
2198
2453
  config: config)
2199
2454
  context[:gem_name] = 'aws-sdk-sns'
2200
- context[:gem_version] = '1.39.0'
2455
+ context[:gem_version] = '1.43.0'
2201
2456
  Seahorse::Client::Request.new(handlers, context)
2202
2457
  end
2203
2458