aws-sdk-sns 1.1.0 → 1.2.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
  SHA1:
3
- metadata.gz: 8393984926abcf033041ba143f085cbfea7827c2
4
- data.tar.gz: c7747a43d1cd0647840fe86b466de71d73bb934c
3
+ metadata.gz: 3e52d411de1a9d172ce7196d4ffe7b95d7e215e0
4
+ data.tar.gz: d88aba2790baad66c9e09b8a34de83299b2e4aab
5
5
  SHA512:
6
- metadata.gz: 635e85332de11274061d700088b42bcebc8dbe27f34674182328e8970dec1a20611811f08ba0dee43d9096bedc8f412872309e17280f631212f5776d95032b7a
7
- data.tar.gz: 2987b96196887aa81058f210186519bb4fc31d6e3a45bd3adcc6e93b78bb531663ec841d0f053a11f69edee12902dae607a32aa0a69d98cffca8128938170bd9
6
+ metadata.gz: e61e4f527093683ab6bb0e481a6c29ccf5ecac23342cf6864ba3fe106af7a5aef0efd34c4e747fe35992afe35819619ccbe9787afabc359045a0d6f63d4212cb
7
+ data.tar.gz: 246935eee50df48455129477c7df24150d8d6f971e8acf2ae90c9e3515bd04868cd8e275f3de2f3662913a282a05f073aa4ad8b7c03e852c669daced5fd162b1
@@ -46,6 +46,6 @@ require_relative 'aws-sdk-sns/customizations'
46
46
  # @service
47
47
  module Aws::SNS
48
48
 
49
- GEM_VERSION = '1.1.0'
49
+ GEM_VERSION = '1.2.0'
50
50
 
51
51
  end
@@ -722,6 +722,8 @@ module Aws::SNS
722
722
  # return, NextToken will be null. For more information, see [Using
723
723
  # Amazon SNS Mobile Push Notifications][1].
724
724
  #
725
+ # This action is throttled at 30 transactions per second (TPS).
726
+ #
725
727
  #
726
728
  #
727
729
  # [1]: http://docs.aws.amazon.com/sns/latest/dg/SNSMobilePush.html
@@ -816,6 +818,8 @@ module Aws::SNS
816
818
  # more records to return, NextToken will be null. For more information,
817
819
  # see [Using Amazon SNS Mobile Push Notifications][1].
818
820
  #
821
+ # This action is throttled at 15 transactions per second (TPS).
822
+ #
819
823
  #
820
824
  #
821
825
  # [1]: http://docs.aws.amazon.com/sns/latest/dg/SNSMobilePush.html
@@ -858,6 +862,8 @@ module Aws::SNS
858
862
  # subscriptions, a `NextToken` is also returned. Use the `NextToken`
859
863
  # parameter in a new `ListSubscriptions` call to get further results.
860
864
  #
865
+ # This action is throttled at 30 transactions per second (TPS).
866
+ #
861
867
  # @option params [String] :next_token
862
868
  # Token returned by the previous `ListSubscriptions` request.
863
869
  #
@@ -897,6 +903,8 @@ module Aws::SNS
897
903
  # parameter in a new `ListSubscriptionsByTopic` call to get further
898
904
  # results.
899
905
  #
906
+ # This action is throttled at 30 transactions per second (TPS).
907
+ #
900
908
  # @option params [required, String] :topic_arn
901
909
  # The ARN of the topic for which you wish to find subscriptions.
902
910
  #
@@ -939,6 +947,8 @@ module Aws::SNS
939
947
  # also returned. Use the `NextToken` parameter in a new `ListTopics`
940
948
  # call to get further results.
941
949
  #
950
+ # This action is throttled at 30 transactions per second (TPS).
951
+ #
942
952
  # @option params [String] :next_token
943
953
  # Token returned by the previous `ListTopics` request.
944
954
  #
@@ -993,11 +1003,16 @@ module Aws::SNS
993
1003
  req.send_request(options)
994
1004
  end
995
1005
 
996
- # Sends a message to all of a topic's subscribed endpoints. When a
997
- # `messageId` is returned, the message has been saved and Amazon SNS
998
- # will attempt to deliver it to the topic's subscribers shortly. The
999
- # format of the outgoing message to each subscribed endpoint depends on
1000
- # the notification protocol.
1006
+ # Sends a message to an Amazon SNS topic or sends a text message (SMS
1007
+ # message) directly to a phone number.
1008
+ #
1009
+ # If you send a message to a topic, Amazon SNS delivers the message to
1010
+ # each endpoint that is subscribed to the topic. The format of the
1011
+ # message depends on the notification protocol for each subscribed
1012
+ # endpoint.
1013
+ #
1014
+ # When a `messageId` is returned, the message has been saved and Amazon
1015
+ # SNS will attempt to deliver it shortly.
1001
1016
  #
1002
1017
  # To use the `Publish` action for sending a message to a mobile
1003
1018
  # endpoint, such as an app on a Kindle device or mobile phone, you must
@@ -1032,17 +1047,29 @@ module Aws::SNS
1032
1047
  # must specify a value for the `TargetArn` or `TopicArn` parameters.
1033
1048
  #
1034
1049
  # @option params [required, String] :message
1035
- # The message you want to send to the topic.
1050
+ # The message you want to send.
1051
+ #
1052
+ # If you are publishing to a topic and you want to send the same message
1053
+ # to all transport protocols, include the text of the message as a
1054
+ # String value. If you want to send different messages for each
1055
+ # transport protocol, set the value of the `MessageStructure` parameter
1056
+ # to `json` and use a JSON object for the `Message` parameter.
1057
+ #
1058
+ #
1036
1059
  #
1037
- # If you want to send the same message to all transport protocols,
1038
- # include the text of the message as a String value.
1060
+ # Constraints:
1039
1061
  #
1040
- # If you want to send different messages for each transport protocol,
1041
- # set the value of the `MessageStructure` parameter to `json` and use a
1042
- # JSON object for the `Message` parameter.
1062
+ # * With the exception of SMS, messages must be UTF-8 encoded strings
1063
+ # and at most 256 KB in size (262144 bytes, not 262144 characters).
1043
1064
  #
1044
- # Constraints: Messages must be UTF-8 encoded strings at most 256 KB in
1045
- # size (262144 bytes, not 262144 characters).
1065
+ # * For SMS, each message can contain up to 140 bytes, and the character
1066
+ # limit depends on the encoding scheme. For example, an SMS message
1067
+ # can contain 160 GSM characters, 140 ASCII characters, or 70 UCS-2
1068
+ # characters. If you publish a message that exceeds the size limit,
1069
+ # Amazon SNS sends it as multiple messages, each fitting within the
1070
+ # size limit. Messages are not cut off in the middle of a word but on
1071
+ # whole-word boundaries. The total size limit for a single SMS publish
1072
+ # action is 1600 bytes.
1046
1073
  #
1047
1074
  # JSON-specific constraints:
1048
1075
  #
@@ -1316,8 +1343,10 @@ module Aws::SNS
1316
1343
  # messages, you will incur costs that exceed your limit.
1317
1344
  #
1318
1345
  # By default, the spend limit is set to the maximum allowed by Amazon
1319
- # SNS. If you want to exceed the maximum, contact [AWS Support][1] or
1320
- # your AWS sales representative for a service limit increase.
1346
+ # SNS. If you want to raise the limit, submit an [SNS Limit Increase
1347
+ # case][1]. For **New limit value**, enter your desired monthly spend
1348
+ # limit. In the **Use Case Description** field, explain that you are
1349
+ # requesting an SMS monthly spend limit increase.
1321
1350
  #
1322
1351
  # `DeliveryStatusIAMRole` – The ARN of the IAM role that allows Amazon
1323
1352
  # SNS to write logs about SMS deliveries in CloudWatch Logs. For each
@@ -1381,7 +1410,7 @@ module Aws::SNS
1381
1410
  #
1382
1411
  #
1383
1412
  #
1384
- # [1]: https://aws.amazon.com/premiumsupport/
1413
+ # [1]: https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-sns
1385
1414
  # [2]: http://docs.aws.amazon.com/sns/latest/dg/sms_stats.html
1386
1415
  #
1387
1416
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -1403,8 +1432,8 @@ module Aws::SNS
1403
1432
  req.send_request(options)
1404
1433
  end
1405
1434
 
1406
- # Allows a subscription owner to set an attribute of the topic to a new
1407
- # value.
1435
+ # Allows a subscription owner to set an attribute of the subscription to
1436
+ # a new value.
1408
1437
  #
1409
1438
  # @option params [required, String] :subscription_arn
1410
1439
  # The ARN of the subscription to modify.
@@ -1413,7 +1442,8 @@ module Aws::SNS
1413
1442
  # The name of the attribute you want to set. Only a subset of the
1414
1443
  # subscriptions attributes are mutable.
1415
1444
  #
1416
- # Valid values: `DeliveryPolicy` \| `RawMessageDelivery`
1445
+ # Valid values: `DeliveryPolicy` \| `FilterPolicy` \|
1446
+ # `RawMessageDelivery`
1417
1447
  #
1418
1448
  # @option params [String] :attribute_value
1419
1449
  # The new value for the attribute in JSON format.
@@ -1476,6 +1506,8 @@ module Aws::SNS
1476
1506
  # the confirmation message. Confirmation tokens are valid for three
1477
1507
  # days.
1478
1508
  #
1509
+ # This action is throttled at 100 transactions per second (TPS).
1510
+ #
1479
1511
  # @option params [required, String] :topic_arn
1480
1512
  # The ARN of the topic you want to subscribe to.
1481
1513
  #
@@ -1526,6 +1558,26 @@ module Aws::SNS
1526
1558
  # * For the `lambda` protocol, the endpoint is the ARN of an AWS Lambda
1527
1559
  # function.
1528
1560
  #
1561
+ # @option params [Hash<String,String>] :attributes
1562
+ # Assigns attributes to the subscription as a map of key-value pairs.
1563
+ # You can assign any attribute that is supported by the
1564
+ # `SetSubscriptionAttributes` action.
1565
+ #
1566
+ # @option params [Boolean] :return_subscription_arn
1567
+ # Sets whether the response from the `Subscribe` request includes the
1568
+ # subscription ARN, even if the subscription is not yet confirmed.
1569
+ #
1570
+ # If you set this parameter to `false`, the response includes the ARN
1571
+ # for confirmed subscriptions, but it includes an ARN value of "pending
1572
+ # subscription" for subscriptions that are not yet confirmed. A
1573
+ # subscription becomes confirmed when the subscriber calls the
1574
+ # `ConfirmSubscription` action with a confirmation token.
1575
+ #
1576
+ # If you set this parameter to `true`, the response includes the ARN in
1577
+ # all cases, even if the subscription is not yet confirmed.
1578
+ #
1579
+ # The default value is `false`.
1580
+ #
1529
1581
  # @return [Types::SubscribeResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1530
1582
  #
1531
1583
  # * {Types::SubscribeResponse#subscription_arn #subscription_arn} => String
@@ -1536,6 +1588,10 @@ module Aws::SNS
1536
1588
  # topic_arn: "topicARN", # required
1537
1589
  # protocol: "protocol", # required
1538
1590
  # endpoint: "endpoint",
1591
+ # attributes: {
1592
+ # "attributeName" => "attributeValue",
1593
+ # },
1594
+ # return_subscription_arn: false,
1539
1595
  # })
1540
1596
  #
1541
1597
  # @example Response structure
@@ -1559,6 +1615,8 @@ module Aws::SNS
1559
1615
  # delivered to the endpoint, so that the endpoint owner can easily
1560
1616
  # resubscribe to the topic if the `Unsubscribe` request was unintended.
1561
1617
  #
1618
+ # This action is throttled at 100 transactions per second (TPS).
1619
+ #
1562
1620
  # @option params [required, String] :subscription_arn
1563
1621
  # The ARN of the subscription to be deleted.
1564
1622
  #
@@ -1592,7 +1650,7 @@ module Aws::SNS
1592
1650
  params: params,
1593
1651
  config: config)
1594
1652
  context[:gem_name] = 'aws-sdk-sns'
1595
- context[:gem_version] = '1.1.0'
1653
+ context[:gem_version] = '1.2.0'
1596
1654
  Seahorse::Client::Request.new(handlers, context)
1597
1655
  end
1598
1656
 
@@ -31,6 +31,7 @@ module Aws::SNS
31
31
  DeleteTopicInput = Shapes::StructureShape.new(name: 'DeleteTopicInput')
32
32
  Endpoint = Shapes::StructureShape.new(name: 'Endpoint')
33
33
  EndpointDisabledException = Shapes::StructureShape.new(name: 'EndpointDisabledException')
34
+ FilterPolicyLimitExceededException = Shapes::StructureShape.new(name: 'FilterPolicyLimitExceededException')
34
35
  GetEndpointAttributesInput = Shapes::StructureShape.new(name: 'GetEndpointAttributesInput')
35
36
  GetEndpointAttributesResponse = Shapes::StructureShape.new(name: 'GetEndpointAttributesResponse')
36
37
  GetPlatformApplicationAttributesInput = Shapes::StructureShape.new(name: 'GetPlatformApplicationAttributesInput')
@@ -316,6 +317,8 @@ module Aws::SNS
316
317
  SubscribeInput.add_member(:topic_arn, Shapes::ShapeRef.new(shape: topicARN, required: true, location_name: "TopicArn"))
317
318
  SubscribeInput.add_member(:protocol, Shapes::ShapeRef.new(shape: protocol, required: true, location_name: "Protocol"))
318
319
  SubscribeInput.add_member(:endpoint, Shapes::ShapeRef.new(shape: endpoint, location_name: "Endpoint"))
320
+ SubscribeInput.add_member(:attributes, Shapes::ShapeRef.new(shape: SubscriptionAttributesMap, location_name: "Attributes"))
321
+ SubscribeInput.add_member(:return_subscription_arn, Shapes::ShapeRef.new(shape: boolean, location_name: "ReturnSubscriptionArn"))
319
322
  SubscribeInput.struct_class = Types::SubscribeInput
320
323
 
321
324
  SubscribeResponse.add_member(:subscription_arn, Shapes::ShapeRef.new(shape: subscriptionARN, location_name: "SubscriptionArn"))
@@ -700,6 +703,7 @@ module Aws::SNS
700
703
  o.input = Shapes::ShapeRef.new(shape: SetSubscriptionAttributesInput)
701
704
  o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
702
705
  o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
706
+ o.errors << Shapes::ShapeRef.new(shape: FilterPolicyLimitExceededException)
703
707
  o.errors << Shapes::ShapeRef.new(shape: InternalErrorException)
704
708
  o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
705
709
  o.errors << Shapes::ShapeRef.new(shape: AuthorizationErrorException)
@@ -724,6 +728,7 @@ module Aws::SNS
724
728
  o.input = Shapes::ShapeRef.new(shape: SubscribeInput)
725
729
  o.output = Shapes::ShapeRef.new(shape: SubscribeResponse)
726
730
  o.errors << Shapes::ShapeRef.new(shape: SubscriptionLimitExceededException)
731
+ o.errors << Shapes::ShapeRef.new(shape: FilterPolicyLimitExceededException)
727
732
  o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
728
733
  o.errors << Shapes::ShapeRef.new(shape: InternalErrorException)
729
734
  o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
@@ -127,17 +127,29 @@ module Aws::SNS
127
127
  # If you don't specify a value for the `PhoneNumber` parameter, you
128
128
  # must specify a value for the `TargetArn` or `TopicArn` parameters.
129
129
  # @option options [required, String] :message
130
- # The message you want to send to the topic.
130
+ # The message you want to send.
131
131
  #
132
- # If you want to send the same message to all transport protocols,
133
- # include the text of the message as a String value.
132
+ # If you are publishing to a topic and you want to send the same message
133
+ # to all transport protocols, include the text of the message as a
134
+ # String value. If you want to send different messages for each
135
+ # transport protocol, set the value of the `MessageStructure` parameter
136
+ # to `json` and use a JSON object for the `Message` parameter.
134
137
  #
135
- # If you want to send different messages for each transport protocol,
136
- # set the value of the `MessageStructure` parameter to `json` and use a
137
- # JSON object for the `Message` parameter.
138
138
  #
139
- # Constraints: Messages must be UTF-8 encoded strings at most 256 KB in
140
- # size (262144 bytes, not 262144 characters).
139
+ #
140
+ # Constraints:
141
+ #
142
+ # * With the exception of SMS, messages must be UTF-8 encoded strings
143
+ # and at most 256 KB in size (262144 bytes, not 262144 characters).
144
+ #
145
+ # * For SMS, each message can contain up to 140 bytes, and the character
146
+ # limit depends on the encoding scheme. For example, an SMS message
147
+ # can contain 160 GSM characters, 140 ASCII characters, or 70 UCS-2
148
+ # characters. If you publish a message that exceeds the size limit,
149
+ # Amazon SNS sends it as multiple messages, each fitting within the
150
+ # size limit. Messages are not cut off in the middle of a word but on
151
+ # whole-word boundaries. The total size limit for a single SMS publish
152
+ # action is 1600 bytes.
141
153
  #
142
154
  # JSON-specific constraints:
143
155
  #
@@ -33,21 +33,33 @@ module Aws::SNS
33
33
  # A map of the subscription's attributes. Attributes in this map
34
34
  # include the following:
35
35
  #
36
- # * `SubscriptionArn` -- the subscription's ARN
36
+ # * `ConfirmationWasAuthenticated` -- `true` if the subscription
37
+ # confirmation request was authenticated.
37
38
  #
38
- # * `TopicArn` -- the topic ARN that the subscription is associated with
39
+ # * `DeliveryPolicy` -- The JSON serialization of the subscription's
40
+ # delivery policy.
39
41
  #
40
- # * `Owner` -- the AWS account ID of the subscription's owner
42
+ # * `EffectiveDeliveryPolicy` -- The JSON serialization of the effective
43
+ # delivery policy that takes into account the topic delivery policy
44
+ # and account system defaults.
41
45
  #
42
- # * `ConfirmationWasAuthenticated` -- true if the subscription
43
- # confirmation request was authenticated
46
+ # * `FilterPolicy` -- The filter policy JSON that is assigned to the
47
+ # subscription.
44
48
  #
45
- # * `DeliveryPolicy` -- the JSON serialization of the subscription's
46
- # delivery policy
49
+ # * `Owner` -- The AWS account ID of the subscription's owner.
47
50
  #
48
- # * `EffectiveDeliveryPolicy` -- the JSON serialization of the effective
49
- # delivery policy that takes into account the topic delivery policy
50
- # and account system defaults
51
+ # * `PendingConfirmation` -- `true` if the subscription hasn't been
52
+ # confirmed. To confirm a pending subscription, call the
53
+ # `ConfirmSubscription` action with a confirmation token.
54
+ #
55
+ # * `RawMessageDelivery` -- `true` if raw message delivery is enabled
56
+ # for the subscription. Raw messages are free of JSON formatting and
57
+ # can be sent to HTTP/S and Amazon SQS endpoints.
58
+ #
59
+ # * `SubscriptionArn` -- The subscription's ARN.
60
+ #
61
+ # * `TopicArn` -- The topic ARN that the subscription is associated
62
+ # with.
51
63
  # @return [Hash<String,String>]
52
64
  def attributes
53
65
  data[:attributes]
@@ -112,7 +124,8 @@ module Aws::SNS
112
124
  # The name of the attribute you want to set. Only a subset of the
113
125
  # subscriptions attributes are mutable.
114
126
  #
115
- # Valid values: `DeliveryPolicy` \| `RawMessageDelivery`
127
+ # Valid values: `DeliveryPolicy` \| `FilterPolicy` \|
128
+ # `RawMessageDelivery`
116
129
  # @option options [String] :attribute_value
117
130
  # The new value for the attribute in JSON format.
118
131
  # @return [EmptyStructure]
@@ -189,17 +189,29 @@ module Aws::SNS
189
189
  # If you don't specify a value for the `PhoneNumber` parameter, you
190
190
  # must specify a value for the `TargetArn` or `TopicArn` parameters.
191
191
  # @option options [required, String] :message
192
- # The message you want to send to the topic.
192
+ # The message you want to send.
193
193
  #
194
- # If you want to send the same message to all transport protocols,
195
- # include the text of the message as a String value.
194
+ # If you are publishing to a topic and you want to send the same message
195
+ # to all transport protocols, include the text of the message as a
196
+ # String value. If you want to send different messages for each
197
+ # transport protocol, set the value of the `MessageStructure` parameter
198
+ # to `json` and use a JSON object for the `Message` parameter.
196
199
  #
197
- # If you want to send different messages for each transport protocol,
198
- # set the value of the `MessageStructure` parameter to `json` and use a
199
- # JSON object for the `Message` parameter.
200
200
  #
201
- # Constraints: Messages must be UTF-8 encoded strings at most 256 KB in
202
- # size (262144 bytes, not 262144 characters).
201
+ #
202
+ # Constraints:
203
+ #
204
+ # * With the exception of SMS, messages must be UTF-8 encoded strings
205
+ # and at most 256 KB in size (262144 bytes, not 262144 characters).
206
+ #
207
+ # * For SMS, each message can contain up to 140 bytes, and the character
208
+ # limit depends on the encoding scheme. For example, an SMS message
209
+ # can contain 160 GSM characters, 140 ASCII characters, or 70 UCS-2
210
+ # characters. If you publish a message that exceeds the size limit,
211
+ # Amazon SNS sends it as multiple messages, each fitting within the
212
+ # size limit. Messages are not cut off in the middle of a word but on
213
+ # whole-word boundaries. The total size limit for a single SMS publish
214
+ # action is 1600 bytes.
203
215
  #
204
216
  # JSON-specific constraints:
205
217
  #
@@ -310,6 +322,10 @@ module Aws::SNS
310
322
  # subscription = topic.subscribe({
311
323
  # protocol: "protocol", # required
312
324
  # endpoint: "endpoint",
325
+ # attributes: {
326
+ # "attributeName" => "attributeValue",
327
+ # },
328
+ # return_subscription_arn: false,
313
329
  # })
314
330
  # @param [Hash] options ({})
315
331
  # @option options [required, String] :protocol
@@ -357,6 +373,24 @@ module Aws::SNS
357
373
  #
358
374
  # * For the `lambda` protocol, the endpoint is the ARN of an AWS Lambda
359
375
  # function.
376
+ # @option options [Hash<String,String>] :attributes
377
+ # Assigns attributes to the subscription as a map of key-value pairs.
378
+ # You can assign any attribute that is supported by the
379
+ # `SetSubscriptionAttributes` action.
380
+ # @option options [Boolean] :return_subscription_arn
381
+ # Sets whether the response from the `Subscribe` request includes the
382
+ # subscription ARN, even if the subscription is not yet confirmed.
383
+ #
384
+ # If you set this parameter to `false`, the response includes the ARN
385
+ # for confirmed subscriptions, but it includes an ARN value of "pending
386
+ # subscription" for subscriptions that are not yet confirmed. A
387
+ # subscription becomes confirmed when the subscriber calls the
388
+ # `ConfirmSubscription` action with a confirmation token.
389
+ #
390
+ # If you set this parameter to `true`, the response includes the ARN in
391
+ # all cases, even if the subscription is not yet confirmed.
392
+ #
393
+ # The default value is `false`.
360
394
  # @return [Subscription]
361
395
  def subscribe(options = {})
362
396
  options = options.merge(topic_arn: @arn)
@@ -531,22 +531,33 @@ module Aws::SNS
531
531
  # A map of the subscription's attributes. Attributes in this map
532
532
  # include the following:
533
533
  #
534
- # * `SubscriptionArn` -- the subscription's ARN
534
+ # * `ConfirmationWasAuthenticated` -- `true` if the subscription
535
+ # confirmation request was authenticated.
535
536
  #
536
- # * `TopicArn` -- the topic ARN that the subscription is associated
537
- # with
537
+ # * `DeliveryPolicy` -- The JSON serialization of the subscription's
538
+ # delivery policy.
538
539
  #
539
- # * `Owner` -- the AWS account ID of the subscription's owner
540
+ # * `EffectiveDeliveryPolicy` -- The JSON serialization of the
541
+ # effective delivery policy that takes into account the topic
542
+ # delivery policy and account system defaults.
540
543
  #
541
- # * `ConfirmationWasAuthenticated` -- true if the subscription
542
- # confirmation request was authenticated
544
+ # * `FilterPolicy` -- The filter policy JSON that is assigned to the
545
+ # subscription.
543
546
  #
544
- # * `DeliveryPolicy` -- the JSON serialization of the subscription's
545
- # delivery policy
547
+ # * `Owner` -- The AWS account ID of the subscription's owner.
546
548
  #
547
- # * `EffectiveDeliveryPolicy` -- the JSON serialization of the
548
- # effective delivery policy that takes into account the topic
549
- # delivery policy and account system defaults
549
+ # * `PendingConfirmation` -- `true` if the subscription hasn't been
550
+ # confirmed. To confirm a pending subscription, call the
551
+ # `ConfirmSubscription` action with a confirmation token.
552
+ #
553
+ # * `RawMessageDelivery` -- `true` if raw message delivery is enabled
554
+ # for the subscription. Raw messages are free of JSON formatting and
555
+ # can be sent to HTTP/S and Amazon SQS endpoints.
556
+ #
557
+ # * `SubscriptionArn` -- The subscription's ARN.
558
+ #
559
+ # * `TopicArn` -- The topic ARN that the subscription is associated
560
+ # with.
550
561
  # @return [Hash<String,String>]
551
562
  #
552
563
  # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/GetSubscriptionAttributesResponse AWS API Documentation
@@ -899,8 +910,8 @@ module Aws::SNS
899
910
  #
900
911
  # @!attribute [rw] data_type
901
912
  # Amazon SNS supports the following logical data types: String,
902
- # Number, and Binary. For more information, see [Message Attribute
903
- # Data Types][1].
913
+ # String.Array, Number, and Binary. For more information, see [Message
914
+ # Attribute Data Types][1].
904
915
  #
905
916
  #
906
917
  #
@@ -1019,17 +1030,30 @@ module Aws::SNS
1019
1030
  # @return [String]
1020
1031
  #
1021
1032
  # @!attribute [rw] message
1022
- # The message you want to send to the topic.
1033
+ # The message you want to send.
1034
+ #
1035
+ # If you are publishing to a topic and you want to send the same
1036
+ # message to all transport protocols, include the text of the message
1037
+ # as a String value. If you want to send different messages for each
1038
+ # transport protocol, set the value of the `MessageStructure`
1039
+ # parameter to `json` and use a JSON object for the `Message`
1040
+ # parameter.
1041
+ #
1023
1042
  #
1024
- # If you want to send the same message to all transport protocols,
1025
- # include the text of the message as a String value.
1026
1043
  #
1027
- # If you want to send different messages for each transport protocol,
1028
- # set the value of the `MessageStructure` parameter to `json` and use
1029
- # a JSON object for the `Message` parameter.
1044
+ # Constraints:
1030
1045
  #
1031
- # Constraints: Messages must be UTF-8 encoded strings at most 256 KB
1032
- # in size (262144 bytes, not 262144 characters).
1046
+ # * With the exception of SMS, messages must be UTF-8 encoded strings
1047
+ # and at most 256 KB in size (262144 bytes, not 262144 characters).
1048
+ #
1049
+ # * For SMS, each message can contain up to 140 bytes, and the
1050
+ # character limit depends on the encoding scheme. For example, an
1051
+ # SMS message can contain 160 GSM characters, 140 ASCII characters,
1052
+ # or 70 UCS-2 characters. If you publish a message that exceeds the
1053
+ # size limit, Amazon SNS sends it as multiple messages, each fitting
1054
+ # within the size limit. Messages are not cut off in the middle of a
1055
+ # word but on whole-word boundaries. The total size limit for a
1056
+ # single SMS publish action is 1600 bytes.
1033
1057
  #
1034
1058
  # JSON-specific constraints:
1035
1059
  #
@@ -1284,8 +1308,10 @@ module Aws::SNS
1284
1308
  # messages, you will incur costs that exceed your limit.
1285
1309
  #
1286
1310
  # By default, the spend limit is set to the maximum allowed by Amazon
1287
- # SNS. If you want to exceed the maximum, contact [AWS Support][1] or
1288
- # your AWS sales representative for a service limit increase.
1311
+ # SNS. If you want to raise the limit, submit an [SNS Limit Increase
1312
+ # case][1]. For **New limit value**, enter your desired monthly spend
1313
+ # limit. In the **Use Case Description** field, explain that you are
1314
+ # requesting an SMS monthly spend limit increase.
1289
1315
  #
1290
1316
  # `DeliveryStatusIAMRole` – The ARN of the IAM role that allows Amazon
1291
1317
  # SNS to write logs about SMS deliveries in CloudWatch Logs. For each
@@ -1349,7 +1375,7 @@ module Aws::SNS
1349
1375
  #
1350
1376
  #
1351
1377
  #
1352
- # [1]: https://aws.amazon.com/premiumsupport/
1378
+ # [1]: https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&amp;limitType=service-code-sns
1353
1379
  # [2]: http://docs.aws.amazon.com/sns/latest/dg/sms_stats.html
1354
1380
  # @return [Hash<String,String>]
1355
1381
  #
@@ -1385,7 +1411,8 @@ module Aws::SNS
1385
1411
  # The name of the attribute you want to set. Only a subset of the
1386
1412
  # subscriptions attributes are mutable.
1387
1413
  #
1388
- # Valid values: `DeliveryPolicy` \| `RawMessageDelivery`
1414
+ # Valid values: `DeliveryPolicy` \| `FilterPolicy` \|
1415
+ # `RawMessageDelivery`
1389
1416
  # @return [String]
1390
1417
  #
1391
1418
  # @!attribute [rw] attribute_value
@@ -1445,6 +1472,10 @@ module Aws::SNS
1445
1472
  # topic_arn: "topicARN", # required
1446
1473
  # protocol: "protocol", # required
1447
1474
  # endpoint: "endpoint",
1475
+ # attributes: {
1476
+ # "attributeName" => "attributeValue",
1477
+ # },
1478
+ # return_subscription_arn: false,
1448
1479
  # }
1449
1480
  #
1450
1481
  # @!attribute [rw] topic_arn
@@ -1500,21 +1531,47 @@ module Aws::SNS
1500
1531
  # Lambda function.
1501
1532
  # @return [String]
1502
1533
  #
1534
+ # @!attribute [rw] attributes
1535
+ # Assigns attributes to the subscription as a map of key-value pairs.
1536
+ # You can assign any attribute that is supported by the
1537
+ # `SetSubscriptionAttributes` action.
1538
+ # @return [Hash<String,String>]
1539
+ #
1540
+ # @!attribute [rw] return_subscription_arn
1541
+ # Sets whether the response from the `Subscribe` request includes the
1542
+ # subscription ARN, even if the subscription is not yet confirmed.
1543
+ #
1544
+ # If you set this parameter to `false`, the response includes the ARN
1545
+ # for confirmed subscriptions, but it includes an ARN value of
1546
+ # "pending subscription" for subscriptions that are not yet
1547
+ # confirmed. A subscription becomes confirmed when the subscriber
1548
+ # calls the `ConfirmSubscription` action with a confirmation token.
1549
+ #
1550
+ # If you set this parameter to `true`, the response includes the ARN
1551
+ # in all cases, even if the subscription is not yet confirmed.
1552
+ #
1553
+ # The default value is `false`.
1554
+ # @return [Boolean]
1555
+ #
1503
1556
  # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/SubscribeInput AWS API Documentation
1504
1557
  #
1505
1558
  class SubscribeInput < Struct.new(
1506
1559
  :topic_arn,
1507
1560
  :protocol,
1508
- :endpoint)
1561
+ :endpoint,
1562
+ :attributes,
1563
+ :return_subscription_arn)
1509
1564
  include Aws::Structure
1510
1565
  end
1511
1566
 
1512
1567
  # Response for Subscribe action.
1513
1568
  #
1514
1569
  # @!attribute [rw] subscription_arn
1515
- # The ARN of the subscription, if the service was able to create a
1516
- # subscription immediately (without requiring endpoint owner
1517
- # confirmation).
1570
+ # The ARN of the subscription if it is confirmed, or the string
1571
+ # "pending confirmation" if the subscription requires confirmation.
1572
+ # However, if the API request parameter `ReturnSubscriptionArn` is
1573
+ # true, then the value is always the subscription ARN, even if the
1574
+ # subscription requires confirmation.
1518
1575
  # @return [String]
1519
1576
  #
1520
1577
  # @see http://docs.aws.amazon.com/goto/WebAPI/sns-2010-03-31/SubscribeResponse AWS API Documentation
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-sns
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.1.0
4
+ version: 1.2.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2017-09-14 00:00:00.000000000 Z
11
+ date: 2018-06-01 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -80,7 +80,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
80
80
  version: '0'
81
81
  requirements: []
82
82
  rubyforge_project:
83
- rubygems_version: 2.5.1
83
+ rubygems_version: 2.5.2.3
84
84
  signing_key:
85
85
  specification_version: 4
86
86
  summary: AWS SDK for Ruby - Amazon SNS