aws-sdk-ses 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: 4769f4d81c68acf59213f348f243c2048f86cd52
4
- data.tar.gz: b19b28a88d7ec9fe6be1c7a2f3b4a3413cb7c67f
3
+ metadata.gz: 9001b8bd2fc995e6d948892722d458f5046c45e0
4
+ data.tar.gz: 906814fec8cf77b085e723da0ff0d7b472e5afc1
5
5
  SHA512:
6
- metadata.gz: 31056126e5b3d567c9d59218c4d2459915199ef608126e2519cb4aebc6c68957d115593b37b5cfc57a4dda7581b64e2d8fe424a7d54bb04555575f815b46d872
7
- data.tar.gz: 6e316987fc0789390584e4ca0b4ec4adbf12a401cc1ba9a476a350110f442aeb72921833d128a922e6b30ec60d8552b46c1a5889b2f599efdc7a2409bcc8722f
6
+ metadata.gz: 0de58b70f82675e8ef7762eb048ae8e6017e4f8e4bbc72d022f5c141ca0850e61dc825d996eaab8b948ddccfaeed4d52145143ebeb2198c8681db8194de0f3ab
7
+ data.tar.gz: bf08e12c048592b194d18126f089029948a806dc0ad6969fdb165bbfac43dba8fa4cb4852c90a2f1e8fc08c241d115e6d137330f7118f65b559ab65a1e68004e
data/lib/aws-sdk-ses.rb CHANGED
@@ -43,6 +43,6 @@ require_relative 'aws-sdk-ses/customizations'
43
43
  # @service
44
44
  module Aws::SES
45
45
 
46
- GEM_VERSION = '1.1.0'
46
+ GEM_VERSION = '1.2.0'
47
47
 
48
48
  end
@@ -149,14 +149,11 @@ module Aws::SES
149
149
  # rules and configurations are copied to the new receipt rule set and
150
150
  # are completely independent of the source rule set.
151
151
  #
152
- # For information about setting up rule sets, see the [Amazon SES
153
- # Developer Guide][1].
152
+ # For information about setting up rule sets, see the <i> <a
153
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rule-set.html">Amazon
154
+ # SES Developer Guide</a>.</i>
154
155
  #
155
- # This action is throttled at one request per second.
156
- #
157
- #
158
- #
159
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rule-set.html
156
+ # You can execute this operation no more than once per second.
160
157
  #
161
158
  # @option params [required, String] :rule_set_name
162
159
  # The name of the rule set to create. The name must:
@@ -202,14 +199,11 @@ module Aws::SES
202
199
  # Creates a configuration set.
203
200
  #
204
201
  # Configuration sets enable you to publish email sending events. For
205
- # information about using configuration sets, see the [Amazon SES
206
- # Developer Guide][1].
207
- #
208
- # This action is throttled at one request per second.
202
+ # information about using configuration sets, see the <i> <a
203
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html">Amazon
204
+ # SES Developer Guide</a>.</i>
209
205
  #
210
- #
211
- #
212
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html
206
+ # You can execute this operation no more than once per second.
213
207
  #
214
208
  # @option params [required, Types::ConfigurationSet] :configuration_set
215
209
  # A data structure that contains the name of the configuration set.
@@ -244,23 +238,19 @@ module Aws::SES
244
238
  #
245
239
  # An event destination is the AWS service to which Amazon SES publishes
246
240
  # the email sending events associated with a configuration set. For
247
- # information about using configuration sets, see the [Amazon SES
248
- # Developer Guide][1].
241
+ # information about using configuration sets, see the <i> <a
242
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html">Amazon
243
+ # SES Developer Guide</a>.</i>
249
244
  #
250
- # This action is throttled at one request per second.
251
- #
252
- #
253
- #
254
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html
245
+ # You can execute this operation no more than once per second.
255
246
  #
256
247
  # @option params [required, String] :configuration_set_name
257
- # The name of the configuration set to which to apply the event
258
- # destination.
248
+ # The name of the configuration set that the event destination should be
249
+ # associated with.
259
250
  #
260
251
  # @option params [required, Types::EventDestination] :event_destination
261
- # An object that describes the AWS service to which Amazon SES will
262
- # publish the email sending events associated with the specified
263
- # configuration set.
252
+ # An object that describes the AWS service that email sending event
253
+ # information will be published to.
264
254
  #
265
255
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
266
256
  #
@@ -300,16 +290,67 @@ module Aws::SES
300
290
  req.send_request(options)
301
291
  end
302
292
 
303
- # Creates a new IP address filter.
293
+ # Creates an association between a configuration set and a custom domain
294
+ # for open and click event tracking.
295
+ #
296
+ # By default, images and links used for tracking open and click events
297
+ # are hosted on domains operated by Amazon SES. You can configure a
298
+ # subdomain of your own to handle these events by redirecting them to
299
+ # the Amazon SES-operated domain. For information about using
300
+ # configuration sets, see [Configuring Custom Domains to Handle Open and
301
+ # Click Tracking][1] in the <i> <a
302
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/Welcome.html">Amazon
303
+ # SES Developer Guide</a>.</i>
304
+ #
305
+ #
306
+ #
307
+ # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/configure-custom-open-click-domains.html
308
+ #
309
+ # @option params [required, String] :configuration_set_name
310
+ # The name of the configuration set that the tracking options should be
311
+ # associated with.
304
312
  #
305
- # For information about setting up IP address filters, see the [Amazon
306
- # SES Developer Guide][1].
313
+ # @option params [required, Types::TrackingOptions] :tracking_options
314
+ # A domain that is used to redirect email recipients to an Amazon
315
+ # SES-operated domain. This domain captures open and click events
316
+ # generated by Amazon SES emails.
307
317
  #
308
- # This action is throttled at one request per second.
318
+ # For more information, see [Configuring Custom Domains to Handle Open
319
+ # and Click Tracking][1] in the <i> <a
320
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/Welcome.html">Amazon
321
+ # SES Developer Guide</a>.</i>
309
322
  #
310
323
  #
311
324
  #
312
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-ip-filters.html
325
+ # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/configure-custom-open-click-domains.html
326
+ #
327
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
328
+ #
329
+ # @example Request syntax with placeholder values
330
+ #
331
+ # resp = client.create_configuration_set_tracking_options({
332
+ # configuration_set_name: "ConfigurationSetName", # required
333
+ # tracking_options: { # required
334
+ # custom_redirect_domain: "CustomRedirectDomain",
335
+ # },
336
+ # })
337
+ #
338
+ # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateConfigurationSetTrackingOptions AWS API Documentation
339
+ #
340
+ # @overload create_configuration_set_tracking_options(params = {})
341
+ # @param [Hash] params ({})
342
+ def create_configuration_set_tracking_options(params = {}, options = {})
343
+ req = build_request(:create_configuration_set_tracking_options, params)
344
+ req.send_request(options)
345
+ end
346
+
347
+ # Creates a new IP address filter.
348
+ #
349
+ # For information about setting up IP address filters, see the <i> <a
350
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-ip-filters.html">Amazon
351
+ # SES Developer Guide</a>.</i>
352
+ #
353
+ # You can execute this operation no more than once per second.
313
354
  #
314
355
  # @option params [required, Types::ReceiptFilter] :filter
315
356
  # A data structure that describes the IP address filter to create, which
@@ -356,17 +397,14 @@ module Aws::SES
356
397
 
357
398
  # Creates a receipt rule.
358
399
  #
359
- # For information about setting up receipt rules, see the [Amazon SES
360
- # Developer Guide][1].
361
- #
362
- # This action is throttled at one request per second.
363
- #
400
+ # For information about setting up receipt rules, see the <i> <a
401
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rules.html">Amazon
402
+ # SES Developer Guide</a>.</i>
364
403
  #
365
- #
366
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rules.html
404
+ # You can execute this operation no more than once per second.
367
405
  #
368
406
  # @option params [required, String] :rule_set_name
369
- # The name of the rule set to which to add the rule.
407
+ # The name of the rule set that the receipt rule will be added to.
370
408
  #
371
409
  # @option params [String] :after
372
410
  # The name of an existing rule after which the new rule will be placed.
@@ -466,14 +504,11 @@ module Aws::SES
466
504
 
467
505
  # Creates an empty receipt rule set.
468
506
  #
469
- # For information about setting up receipt rule sets, see the [Amazon
470
- # SES Developer Guide][1].
471
- #
472
- # This action is throttled at one request per second.
473
- #
507
+ # For information about setting up receipt rule sets, see the <i> <a
508
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rule-set.html">Amazon
509
+ # SES Developer Guide</a>.</i>
474
510
  #
475
- #
476
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rule-set.html
511
+ # You can execute this operation no more than once per second.
477
512
  #
478
513
  # @option params [required, String] :rule_set_name
479
514
  # The name of the rule set to create. The name must:
@@ -511,17 +546,13 @@ module Aws::SES
511
546
  req.send_request(options)
512
547
  end
513
548
 
514
- # Deletes a configuration set.
515
- #
516
- # Configuration sets enable you to publish email sending events. For
517
- # information about using configuration sets, see the [Amazon SES
518
- # Developer Guide][1].
549
+ # Deletes a configuration set. Configuration sets enable you to publish
550
+ # email sending events. For information about using configuration sets,
551
+ # see the <i> <a
552
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html">Amazon
553
+ # SES Developer Guide</a>.</i>
519
554
  #
520
- # This action is throttled at one request per second.
521
- #
522
- #
523
- #
524
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html
555
+ # You can execute this operation no more than once per second.
525
556
  #
526
557
  # @option params [required, String] :configuration_set_name
527
558
  # The name of the configuration set to delete.
@@ -543,18 +574,14 @@ module Aws::SES
543
574
  req.send_request(options)
544
575
  end
545
576
 
546
- # Deletes a configuration set event destination.
547
- #
548
- # Configuration set event destinations are associated with configuration
549
- # sets, which enable you to publish email sending events. For
550
- # information about using configuration sets, see the [Amazon SES
551
- # Developer Guide][1].
552
- #
553
- # This action is throttled at one request per second.
577
+ # Deletes a configuration set event destination. Configuration set event
578
+ # destinations are associated with configuration sets, which enable you
579
+ # to publish email sending events. For information about using
580
+ # configuration sets, see the <i> <a
581
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html">Amazon
582
+ # SES Developer Guide</a>.</i>
554
583
  #
555
- #
556
- #
557
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html
584
+ # You can execute this operation no more than once per second.
558
585
  #
559
586
  # @option params [required, String] :configuration_set_name
560
587
  # The name of the configuration set from which to delete the event
@@ -581,10 +608,53 @@ module Aws::SES
581
608
  req.send_request(options)
582
609
  end
583
610
 
611
+ # Deletes an association between a configuration set and a custom domain
612
+ # for open and click event tracking.
613
+ #
614
+ # By default, images and links used for tracking open and click events
615
+ # are hosted on domains operated by Amazon SES. You can configure a
616
+ # subdomain of your own to handle these events by redirecting them to
617
+ # the Amazon SES-operated domain. For information about using
618
+ # configuration sets, see [Configuring Custom Domains to Handle Open and
619
+ # Click Tracking][1] in the <i> <a
620
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/Welcome.html">Amazon
621
+ # SES Developer Guide</a>.</i>
622
+ #
623
+ # <note markdown="1"> Deleting this kind of association will result in emails sent using the
624
+ # specified configuration set to capture open and click events using the
625
+ # standard, Amazon SES-operated domains.
626
+ #
627
+ # </note>
628
+ #
629
+ #
630
+ #
631
+ # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/configure-custom-open-click-domains.html
632
+ #
633
+ # @option params [required, String] :configuration_set_name
634
+ # The name of the configuration set from which you want to delete the
635
+ # tracking options.
636
+ #
637
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
638
+ #
639
+ # @example Request syntax with placeholder values
640
+ #
641
+ # resp = client.delete_configuration_set_tracking_options({
642
+ # configuration_set_name: "ConfigurationSetName", # required
643
+ # })
644
+ #
645
+ # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteConfigurationSetTrackingOptions AWS API Documentation
646
+ #
647
+ # @overload delete_configuration_set_tracking_options(params = {})
648
+ # @param [Hash] params ({})
649
+ def delete_configuration_set_tracking_options(params = {}, options = {})
650
+ req = build_request(:delete_configuration_set_tracking_options, params)
651
+ req.send_request(options)
652
+ end
653
+
584
654
  # Deletes the specified identity (an email address or a domain) from the
585
655
  # list of verified identities.
586
656
  #
587
- # This action is throttled at one request per second.
657
+ # You can execute this operation no more than once per second.
588
658
  #
589
659
  # @option params [required, String] :identity
590
660
  # The identity to be removed from the list of identities for the AWS
@@ -628,13 +698,11 @@ module Aws::SES
628
698
  #
629
699
  # Sending authorization is a feature that enables an identity owner to
630
700
  # authorize other senders to use its identities. For information about
631
- # using sending authorization, see the [Amazon SES Developer Guide][1].
701
+ # using sending authorization, see the <i> <a
702
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html">Amazon
703
+ # SES Developer Guide</a>.</i>
632
704
  #
633
- # This action is throttled at one request per second.
634
- #
635
- #
636
- #
637
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html
705
+ # You can execute this operation no more than once per second.
638
706
  #
639
707
  # @option params [required, String] :identity
640
708
  # The identity that is associated with the policy that you want to
@@ -678,14 +746,11 @@ module Aws::SES
678
746
 
679
747
  # Deletes the specified IP address filter.
680
748
  #
681
- # For information about managing IP address filters, see the [Amazon SES
682
- # Developer Guide][1].
683
- #
684
- # This action is throttled at one request per second.
749
+ # For information about managing IP address filters, see the <i> <a
750
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-ip-filters.html">Amazon
751
+ # SES Developer Guide</a>.</i>
685
752
  #
686
- #
687
- #
688
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-ip-filters.html
753
+ # You can execute this operation no more than once per second.
689
754
  #
690
755
  # @option params [required, String] :filter_name
691
756
  # The name of the IP address filter to delete.
@@ -718,14 +783,11 @@ module Aws::SES
718
783
 
719
784
  # Deletes the specified receipt rule.
720
785
  #
721
- # For information about managing receipt rules, see the [Amazon SES
722
- # Developer Guide][1].
723
- #
724
- # This action is throttled at one request per second.
786
+ # For information about managing receipt rules, see the <i> <a
787
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rules.html">Amazon
788
+ # SES Developer Guide</a>.</i>
725
789
  #
726
- #
727
- #
728
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rules.html
790
+ # You can execute this operation no more than once per second.
729
791
  #
730
792
  # @option params [required, String] :rule_set_name
731
793
  # The name of the receipt rule set that contains the receipt rule to
@@ -769,14 +831,11 @@ module Aws::SES
769
831
  #
770
832
  # </note>
771
833
  #
772
- # For information about managing receipt rule sets, see the [Amazon SES
773
- # Developer Guide][1].
774
- #
775
- # This action is throttled at one request per second.
834
+ # For information about managing receipt rule sets, see the <i> <a
835
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rule-sets.html">Amazon
836
+ # SES Developer Guide</a>.</i>
776
837
  #
777
- #
778
- #
779
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rule-sets.html
838
+ # You can execute this operation no more than once per second.
780
839
  #
781
840
  # @option params [required, String] :rule_set_name
782
841
  # The name of the receipt rule set to delete.
@@ -807,14 +866,8 @@ module Aws::SES
807
866
  req.send_request(options)
808
867
  end
809
868
 
810
- # Deletes the specified email address from the list of verified
811
- # addresses.
812
- #
813
- # The DeleteVerifiedEmailAddress action is deprecated as of the May 15,
814
- # 2012 release of Domain Verification. The DeleteIdentity action is now
815
- # preferred.
816
- #
817
- # This action is throttled at one request per second.
869
+ # Deprecated. Use the `DeleteIdentity` operation to delete email
870
+ # addresses and domains.
818
871
  #
819
872
  # @option params [required, String] :email_address
820
873
  # An email address to be removed from the list of verified addresses.
@@ -849,14 +902,11 @@ module Aws::SES
849
902
  # Returns the metadata and receipt rules for the receipt rule set that
850
903
  # is currently active.
851
904
  #
852
- # For information about setting up receipt rule sets, see the [Amazon
853
- # SES Developer Guide][1].
854
- #
855
- # This action is throttled at one request per second.
856
- #
905
+ # For information about setting up receipt rule sets, see the <i> <a
906
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rule-set.html">Amazon
907
+ # SES Developer Guide</a>.</i>
857
908
  #
858
- #
859
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rule-set.html
909
+ # You can execute this operation no more than once per second.
860
910
  #
861
911
  # @return [Types::DescribeActiveReceiptRuleSetResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
862
912
  #
@@ -937,17 +987,12 @@ module Aws::SES
937
987
  req.send_request(options)
938
988
  end
939
989
 
940
- # Returns the details of the specified configuration set.
941
- #
942
- # Configuration sets enable you to publish email sending events. For
943
- # information about using configuration sets, see the [Amazon SES
944
- # Developer Guide][1].
990
+ # Returns the details of the specified configuration set. For
991
+ # information about using configuration sets, see the <i> <a
992
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html">Amazon
993
+ # SES Developer Guide</a>.</i>
945
994
  #
946
- # This action is throttled at one request per second.
947
- #
948
- #
949
- #
950
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html
995
+ # You can execute this operation no more than once per second.
951
996
  #
952
997
  # @option params [required, String] :configuration_set_name
953
998
  # The name of the configuration set to describe.
@@ -959,12 +1004,13 @@ module Aws::SES
959
1004
  #
960
1005
  # * {Types::DescribeConfigurationSetResponse#configuration_set #configuration_set} => Types::ConfigurationSet
961
1006
  # * {Types::DescribeConfigurationSetResponse#event_destinations #event_destinations} => Array&lt;Types::EventDestination&gt;
1007
+ # * {Types::DescribeConfigurationSetResponse#tracking_options #tracking_options} => Types::TrackingOptions
962
1008
  #
963
1009
  # @example Request syntax with placeholder values
964
1010
  #
965
1011
  # resp = client.describe_configuration_set({
966
1012
  # configuration_set_name: "ConfigurationSetName", # required
967
- # configuration_set_attribute_names: ["eventDestinations"], # accepts eventDestinations
1013
+ # configuration_set_attribute_names: ["eventDestinations"], # accepts eventDestinations, trackingOptions
968
1014
  # })
969
1015
  #
970
1016
  # @example Response structure
@@ -982,6 +1028,7 @@ module Aws::SES
982
1028
  # resp.event_destinations[0].cloud_watch_destination.dimension_configurations[0].dimension_value_source #=> String, one of "messageTag", "emailHeader", "linkTag"
983
1029
  # resp.event_destinations[0].cloud_watch_destination.dimension_configurations[0].default_dimension_value #=> String
984
1030
  # resp.event_destinations[0].sns_destination.topic_arn #=> String
1031
+ # resp.tracking_options.custom_redirect_domain #=> String
985
1032
  #
986
1033
  # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DescribeConfigurationSet AWS API Documentation
987
1034
  #
@@ -994,17 +1041,14 @@ module Aws::SES
994
1041
 
995
1042
  # Returns the details of the specified receipt rule.
996
1043
  #
997
- # For information about setting up receipt rules, see the [Amazon SES
998
- # Developer Guide][1].
999
- #
1000
- # This action is throttled at one request per second.
1001
- #
1044
+ # For information about setting up receipt rules, see the <i> <a
1045
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rules.html">Amazon
1046
+ # SES Developer Guide</a>.</i>
1002
1047
  #
1003
- #
1004
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rules.html
1048
+ # You can execute this operation no more than once per second.
1005
1049
  #
1006
1050
  # @option params [required, String] :rule_set_name
1007
- # The name of the receipt rule set to which the receipt rule belongs.
1051
+ # The name of the receipt rule set that the receipt rule belongs to.
1008
1052
  #
1009
1053
  # @option params [required, String] :rule_name
1010
1054
  # The name of the receipt rule.
@@ -1089,14 +1133,11 @@ module Aws::SES
1089
1133
 
1090
1134
  # Returns the details of the specified receipt rule set.
1091
1135
  #
1092
- # For information about managing receipt rule sets, see the [Amazon SES
1093
- # Developer Guide][1].
1094
- #
1095
- # This action is throttled at one request per second.
1096
- #
1097
- #
1136
+ # For information about managing receipt rule sets, see the <i> <a
1137
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rule-sets.html">Amazon
1138
+ # SES Developer Guide</a>.</i>
1098
1139
  #
1099
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rule-sets.html
1140
+ # You can execute this operation no more than once per second.
1100
1141
  #
1101
1142
  # @option params [required, String] :rule_set_name
1102
1143
  # The name of the receipt rule set to describe.
@@ -1188,11 +1229,11 @@ module Aws::SES
1188
1229
  end
1189
1230
 
1190
1231
  # Returns the current status of Easy DKIM signing for an entity. For
1191
- # domain name identities, this action also returns the DKIM tokens that
1192
- # are required for Easy DKIM signing, and whether Amazon SES has
1232
+ # domain name identities, this operation also returns the DKIM tokens
1233
+ # that are required for Easy DKIM signing, and whether Amazon SES has
1193
1234
  # successfully verified that these tokens have been published.
1194
1235
  #
1195
- # This action takes a list of identities as input and returns the
1236
+ # This operation takes a list of identities as input and returns the
1196
1237
  # following information for each:
1197
1238
  #
1198
1239
  # * Whether Easy DKIM signing is enabled or disabled.
@@ -1204,15 +1245,13 @@ module Aws::SES
1204
1245
  # published in the domain's DNS. This information is only returned
1205
1246
  # for domain name identities, not for email addresses.
1206
1247
  #
1207
- # This action is throttled at one request per second and can only get
1248
+ # This operation is throttled at one request per second and can only get
1208
1249
  # DKIM attributes for up to 100 identities at a time.
1209
1250
  #
1210
1251
  # For more information about creating DNS records using DKIM tokens, go
1211
- # to the [Amazon SES Developer Guide][1].
1212
- #
1213
- #
1214
- #
1215
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim-dns-records.html
1252
+ # to the <i> <a
1253
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim-dns-records.html">Amazon
1254
+ # SES Developer Guide</a>.</i>
1216
1255
  #
1217
1256
  # @option params [required, Array<String>] :identities
1218
1257
  # A list of one or more verified identities - email addresses, domains,
@@ -1277,9 +1316,9 @@ module Aws::SES
1277
1316
  end
1278
1317
 
1279
1318
  # Returns the custom MAIL FROM attributes for a list of identities
1280
- # (email addresses and/or domains).
1319
+ # (email addresses : domains).
1281
1320
  #
1282
- # This action is throttled at one request per second and can only get
1321
+ # This operation is throttled at one request per second and can only get
1283
1322
  # custom MAIL FROM attributes for up to 100 identities at a time.
1284
1323
  #
1285
1324
  # @option params [required, Array<String>] :identities
@@ -1336,15 +1375,13 @@ module Aws::SES
1336
1375
  # Given a list of verified identities (email addresses and/or domains),
1337
1376
  # returns a structure describing identity notification attributes.
1338
1377
  #
1339
- # This action is throttled at one request per second and can only get
1378
+ # This operation is throttled at one request per second and can only get
1340
1379
  # notification attributes for up to 100 identities at a time.
1341
1380
  #
1342
1381
  # For more information about using notifications with Amazon SES, see
1343
- # the [Amazon SES Developer Guide][1].
1344
- #
1345
- #
1346
- #
1347
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/notifications.html
1382
+ # the <i> <a
1383
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/notifications.html">Amazon
1384
+ # SES Developer Guide</a>.</i>
1348
1385
  #
1349
1386
  # @option params [required, Array<String>] :identities
1350
1387
  # A list of one or more identities. You can specify an identity by using
@@ -1420,13 +1457,11 @@ module Aws::SES
1420
1457
  #
1421
1458
  # Sending authorization is a feature that enables an identity owner to
1422
1459
  # authorize other senders to use its identities. For information about
1423
- # using sending authorization, see the [Amazon SES Developer Guide][1].
1424
- #
1425
- # This action is throttled at one request per second.
1426
- #
1427
- #
1460
+ # using sending authorization, see the <i> <a
1461
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html">Amazon
1462
+ # SES Developer Guide</a>.</i>
1428
1463
  #
1429
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html
1464
+ # You can execute this operation no more than once per second.
1430
1465
  #
1431
1466
  # @option params [required, String] :identity
1432
1467
  # The identity for which the policies will be retrieved. You can specify
@@ -1508,7 +1543,7 @@ module Aws::SES
1508
1543
  # want to verify the domain, you must restart the verification process
1509
1544
  # from the beginning.
1510
1545
  #
1511
- # This action is throttled at one request per second and can only get
1546
+ # This operation is throttled at one request per second and can only get
1512
1547
  # verification attributes for up to 100 identities at a time.
1513
1548
  #
1514
1549
  # @option params [required, Array<String>] :identities
@@ -1560,9 +1595,9 @@ module Aws::SES
1560
1595
  req.send_request(options)
1561
1596
  end
1562
1597
 
1563
- # Returns the user's current sending limits.
1598
+ # Provides the sending limits for the Amazon SES account.
1564
1599
  #
1565
- # This action is throttled at one request per second.
1600
+ # You can execute this operation no more than once per second.
1566
1601
  #
1567
1602
  # @return [Types::GetSendQuotaResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1568
1603
  #
@@ -1600,13 +1635,12 @@ module Aws::SES
1600
1635
  req.send_request(options)
1601
1636
  end
1602
1637
 
1603
- # Returns the user's sending statistics. The result is a list of data
1604
- # points, representing the last two weeks of sending activity.
1638
+ # Provides sending statistics for the Amazon SES account. The result is
1639
+ # a list of data points, representing the last two weeks of sending
1640
+ # activity. Each data point in the list contains statistics for a
1641
+ # 15-minute period of time.
1605
1642
  #
1606
- # Each data point in the list contains statistics for a 15-minute
1607
- # interval.
1608
- #
1609
- # This action is throttled at one request per second.
1643
+ # You can execute this operation no more than once per second.
1610
1644
  #
1611
1645
  # @return [Types::GetSendStatisticsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1612
1646
  #
@@ -1665,14 +1699,18 @@ module Aws::SES
1665
1699
  req.send_request(options)
1666
1700
  end
1667
1701
 
1668
- # Lists the configuration sets associated with your AWS account.
1669
- #
1670
- # Configuration sets enable you to publish email sending events. For
1671
- # information about using configuration sets, see the [Amazon SES
1672
- # Developer Guide][1].
1702
+ # Provides a list of the configuration sets associated with your Amazon
1703
+ # SES account. For information about using configuration sets, see
1704
+ # [Monitoring Your Amazon SES Sending Activity][1] in the *Amazon SES
1705
+ # Developer Guide*.
1673
1706
  #
1674
- # This action is throttled at one request per second and can return up
1675
- # to 50 configuration sets at a time.
1707
+ # You can execute this operation no more than once per second. This
1708
+ # operation will return up to 50 configuration sets each time it is run.
1709
+ # If your Amazon SES account has more than 50 configuration sets, this
1710
+ # operation will also return a NextToken element. You can then execute
1711
+ # the `ListConfigurationSets` operation again, passing the `NextToken`
1712
+ # parameter and the value of the NextToken element to retrieve
1713
+ # additional results.
1676
1714
  #
1677
1715
  #
1678
1716
  #
@@ -1716,7 +1754,7 @@ module Aws::SES
1716
1754
  # Returns a list containing all of the identities (email addresses and
1717
1755
  # domains) for your AWS account, regardless of verification status.
1718
1756
  #
1719
- # This action is throttled at one request per second.
1757
+ # You can execute this operation no more than once per second.
1720
1758
  #
1721
1759
  # @option params [String] :identity_type
1722
1760
  # The type of the identities to list. Possible values are
@@ -1789,13 +1827,11 @@ module Aws::SES
1789
1827
  #
1790
1828
  # Sending authorization is a feature that enables an identity owner to
1791
1829
  # authorize other senders to use its identities. For information about
1792
- # using sending authorization, see the [Amazon SES Developer Guide][1].
1793
- #
1794
- # This action is throttled at one request per second.
1795
- #
1796
- #
1830
+ # using sending authorization, see the <i> <a
1831
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html">Amazon
1832
+ # SES Developer Guide</a>.</i>
1797
1833
  #
1798
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html
1834
+ # You can execute this operation no more than once per second.
1799
1835
  #
1800
1836
  # @option params [required, String] :identity
1801
1837
  # The identity that is associated with the policy for which the policies
@@ -1848,14 +1884,11 @@ module Aws::SES
1848
1884
 
1849
1885
  # Lists the IP address filters associated with your AWS account.
1850
1886
  #
1851
- # For information about managing IP address filters, see the [Amazon SES
1852
- # Developer Guide][1].
1887
+ # For information about managing IP address filters, see the <i> <a
1888
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-ip-filters.html">Amazon
1889
+ # SES Developer Guide</a>.</i>
1853
1890
  #
1854
- # This action is throttled at one request per second.
1855
- #
1856
- #
1857
- #
1858
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-ip-filters.html
1891
+ # You can execute this operation no more than once per second.
1859
1892
  #
1860
1893
  # @return [Types::ListReceiptFiltersResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1861
1894
  #
@@ -1903,14 +1936,11 @@ module Aws::SES
1903
1936
  # receive a `NextToken` that you can provide to the next call to
1904
1937
  # `ListReceiptRuleSets` to retrieve the additional entries.
1905
1938
  #
1906
- # For information about managing receipt rule sets, see the [Amazon SES
1907
- # Developer Guide][1].
1908
- #
1909
- # This action is throttled at one request per second.
1910
- #
1911
- #
1939
+ # For information about managing receipt rule sets, see the <i> <a
1940
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rule-sets.html">Amazon
1941
+ # SES Developer Guide</a>.</i>
1912
1942
  #
1913
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rule-sets.html
1943
+ # You can execute this operation no more than once per second.
1914
1944
  #
1915
1945
  # @option params [String] :next_token
1916
1946
  # A token returned from a previous call to `ListReceiptRuleSets` to
@@ -1963,14 +1993,8 @@ module Aws::SES
1963
1993
  req.send_request(options)
1964
1994
  end
1965
1995
 
1966
- # Returns a list containing all of the email addresses that have been
1967
- # verified.
1968
- #
1969
- # The ListVerifiedEmailAddresses action is deprecated as of the May 15,
1970
- # 2012 release of Domain Verification. The ListIdentities action is now
1971
- # preferred.
1972
- #
1973
- # This action is throttled at one request per second.
1996
+ # Deprecated. Use the `ListIdentities` operation to list the email
1997
+ # addresses and domains associated with your account.
1974
1998
  #
1975
1999
  # @return [Types::ListVerifiedEmailAddressesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1976
2000
  #
@@ -2016,16 +2040,14 @@ module Aws::SES
2016
2040
  #
2017
2041
  # Sending authorization is a feature that enables an identity owner to
2018
2042
  # authorize other senders to use its identities. For information about
2019
- # using sending authorization, see the [Amazon SES Developer Guide][1].
2020
- #
2021
- # This action is throttled at one request per second.
2022
- #
2043
+ # using sending authorization, see the <i> <a
2044
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html">Amazon
2045
+ # SES Developer Guide</a>.</i>
2023
2046
  #
2024
- #
2025
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html
2047
+ # You can execute this operation no more than once per second.
2026
2048
  #
2027
2049
  # @option params [required, String] :identity
2028
- # The identity to which the policy will apply. You can specify an
2050
+ # The identity that the policy will apply to. You can specify an
2029
2051
  # identity by using its name or by using its Amazon Resource Name (ARN).
2030
2052
  # Examples: `user@example.com`, `example.com`,
2031
2053
  # `arn:aws:ses:us-east-1:123456789012:identity/example.com`.
@@ -2086,14 +2108,11 @@ module Aws::SES
2086
2108
  #
2087
2109
  # </note>
2088
2110
  #
2089
- # For information about managing receipt rule sets, see the [Amazon SES
2090
- # Developer Guide][1].
2091
- #
2092
- # This action is throttled at one request per second.
2093
- #
2111
+ # For information about managing receipt rule sets, see the <i> <a
2112
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rule-sets.html">Amazon
2113
+ # SES Developer Guide</a>.</i>
2094
2114
  #
2095
- #
2096
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rule-sets.html
2115
+ # You can execute this operation no more than once per second.
2097
2116
  #
2098
2117
  # @option params [required, String] :rule_set_name
2099
2118
  # The name of the receipt rule set to reorder.
@@ -2142,14 +2161,12 @@ module Aws::SES
2142
2161
  #
2143
2162
  # </note>
2144
2163
  #
2145
- # For information about receiving email through Amazon SES, see the
2146
- # [Amazon SES Developer Guide][1].
2147
- #
2148
- # This action is throttled at one request per second.
2149
- #
2164
+ # For information about receiving email through Amazon SES, see the <i>
2165
+ # <a
2166
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email.html">Amazon
2167
+ # SES Developer Guide</a>.</i>
2150
2168
  #
2151
- #
2152
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email.html
2169
+ # You can execute this operation no more than once per second.
2153
2170
  #
2154
2171
  # @option params [required, String] :original_message_id
2155
2172
  # The message ID of the message to be bounced.
@@ -2241,38 +2258,43 @@ module Aws::SES
2241
2258
  req.send_request(options)
2242
2259
  end
2243
2260
 
2244
- # Composes an email message based on input data, and then immediately
2245
- # queues the message for sending.
2261
+ # Composes an email message and immediately queues it for sending. In
2262
+ # order to send email using the `SendEmail` operation, your message must
2263
+ # meet the following requirements:
2246
2264
  #
2247
- # There are several important points to know about `SendEmail`\:
2265
+ # * The message must be sent from a verified email address or domain. If
2266
+ # you attempt to send email using a non-verified address or domain,
2267
+ # the operation will result in an "Email address not verified"
2268
+ # error.
2248
2269
  #
2249
- # * You can only send email from verified email addresses and domains;
2250
- # otherwise, you will get an "Email address not verified" error. If
2251
- # your account is still in the Amazon SES sandbox, you must also
2252
- # verify every recipient email address except for the recipients
2253
- # provided by the Amazon SES mailbox simulator. For more information,
2254
- # go to the [Amazon SES Developer Guide][1].
2270
+ # * If your account is still in the Amazon SES sandbox, you may only
2271
+ # send to verified addresses or domains, or to email addresses
2272
+ # associated with the Amazon SES Mailbox Simulator. For more
2273
+ # information, see [Verifying Email Addresses and Domains][1] in the
2274
+ # *Amazon SES Developer Guide*.
2255
2275
  #
2256
- # * The total size of the message cannot exceed 10 MB. This includes any
2257
- # attachments that are part of the message.
2276
+ # * The total size of the message, including attachments, must be
2277
+ # smaller than 10 MB.
2258
2278
  #
2259
- # * You must provide at least one recipient email address. The recipient
2260
- # address can be a To: address, a CC: address, or a BCC: address. If
2261
- # any email address you provide is invalid, Amazon SES rejects the
2262
- # entire email.
2279
+ # * The message must include at least one recipient email address. The
2280
+ # recipient address can be a To: address, a CC: address, or a BCC:
2281
+ # address. If a recipient email address is invalid (that is, it is not
2282
+ # in the format *UserName@\[SubDomain.\]Domain.TopLevelDomain*), the
2283
+ # entire message will be rejected, even if the message contains other
2284
+ # recipients that are valid.
2263
2285
  #
2264
- # * Amazon SES has a limit on the total number of recipients per
2265
- # message. The combined number of To:, CC: and BCC: email addresses
2266
- # cannot exceed 50. If you need to send an email message to a larger
2267
- # audience, you can divide your recipient list into groups of 50 or
2268
- # fewer, and then call Amazon SES repeatedly to send the message to
2269
- # each group.
2286
+ # * The message may not include more than 50 recipients, across the To:,
2287
+ # CC: and BCC: fields. If you need to send an email message to a
2288
+ # larger audience, you can divide your recipient list into groups of
2289
+ # 50 or fewer, and then call the `SendEmail` operation several times
2290
+ # to send the message to each group.
2270
2291
  #
2271
- # * For every message that you send, the total number of recipients
2272
- # (To:, CC: and BCC:) is counted against your sending quota - the
2273
- # maximum number of emails you can send in a 24-hour period. For
2274
- # information about your sending quota, go to the [Amazon SES
2275
- # Developer Guide][2].
2292
+ # For every message that you send, the total number of recipients
2293
+ # (including each recipient in the To:, CC: and BCC: fields) is counted
2294
+ # against the maximum number of emails you can send in a 24-hour period
2295
+ # (your *sending quota*). For more information about sending quotas in
2296
+ # Amazon SES, see [Managing Your Amazon SES Sending Limits][2] in the
2297
+ # *Amazon SES Developer Guide*.
2276
2298
  #
2277
2299
  #
2278
2300
  #
@@ -2300,7 +2322,7 @@ module Aws::SES
2300
2322
  #
2301
2323
  # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-addresses-and-domains.html
2302
2324
  # [2]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html
2303
- # [3]: http://tools.ietf.org/html/rfc2047
2325
+ # [3]: https://tools.ietf.org/html/rfc2047
2304
2326
  #
2305
2327
  # @option params [required, Types::Destination] :destination
2306
2328
  # The destination for this email, composed of To:, CC:, and BCC: fields.
@@ -2313,7 +2335,7 @@ module Aws::SES
2313
2335
  # replies to the message, each reply-to address will receive the reply.
2314
2336
  #
2315
2337
  # @option params [String] :return_path
2316
- # The email address to which bounces and complaints are to be forwarded
2338
+ # The email address that bounces and complaints will be forwarded to
2317
2339
  # when feedback forwarding is enabled. If the message cannot be
2318
2340
  # delivered to the recipient, then an error message will be returned
2319
2341
  # from the recipient's ISP; this message will then be forwarded to the
@@ -2473,53 +2495,64 @@ module Aws::SES
2473
2495
  req.send_request(options)
2474
2496
  end
2475
2497
 
2476
- # Sends an email message, with header and content specified by the
2477
- # client. The `SendRawEmail` action is useful for sending multipart MIME
2478
- # emails. The raw text of the message must comply with Internet email
2479
- # standards; otherwise, the message cannot be sent.
2480
- #
2481
- # There are several important points to know about `SendRawEmail`\:
2482
- #
2483
- # * You can only send email from verified email addresses and domains;
2484
- # otherwise, you will get an "Email address not verified" error. If
2485
- # your account is still in the Amazon SES sandbox, you must also
2486
- # verify every recipient email address except for the recipients
2487
- # provided by the Amazon SES mailbox simulator. For more information,
2488
- # go to the [Amazon SES Developer Guide][1].
2489
- #
2490
- # * The total size of the message cannot exceed 10 MB. This includes any
2491
- # attachments that are part of the message.
2492
- #
2493
- # * You must provide at least one recipient email address. The recipient
2494
- # address can be a To: address, a CC: address, or a BCC: address. If
2495
- # any email address you provide is invalid, Amazon SES rejects the
2496
- # entire email.
2497
- #
2498
- # * Amazon SES has a limit on the total number of recipients per
2499
- # message. The combined number of To:, CC: and BCC: email addresses
2500
- # cannot exceed 50. If you need to send an email message to a larger
2501
- # audience, you can divide your recipient list into groups of 50 or
2502
- # fewer, and then call Amazon SES repeatedly to send the message to
2503
- # each group.
2504
- #
2505
- # * The To:, CC:, and BCC: headers in the raw message can contain a
2506
- # group list. Note that each recipient in a group list counts towards
2507
- # the 50-recipient limit.
2508
- #
2509
- # * Amazon SES overrides any Message-ID and Date headers you provide.
2510
- #
2511
- # * For every message that you send, the total number of recipients
2512
- # (To:, CC: and BCC:) is counted against your sending quota - the
2513
- # maximum number of emails you can send in a 24-hour period. For
2514
- # information about your sending quota, go to the [Amazon SES
2515
- # Developer Guide][2].
2498
+ # Composes an email message and immediately queues it for sending. When
2499
+ # calling this operation, you may specify the message headers as well as
2500
+ # the content. The `SendRawEmail` operation is particularly useful for
2501
+ # sending multipart MIME emails (such as those that contain both a
2502
+ # plain-text and an HTML version).
2503
+ #
2504
+ # In order to send email using the `SendRawEmail` operation, your
2505
+ # message must meet the following requirements:
2506
+ #
2507
+ # * The message must be sent from a verified email address or domain. If
2508
+ # you attempt to send email using a non-verified address or domain,
2509
+ # the operation will result in an "Email address not verified"
2510
+ # error.
2511
+ #
2512
+ # * If your account is still in the Amazon SES sandbox, you may only
2513
+ # send to verified addresses or domains, or to email addresses
2514
+ # associated with the Amazon SES Mailbox Simulator. For more
2515
+ # information, see [Verifying Email Addresses and Domains][1] in the
2516
+ # *Amazon SES Developer Guide*.
2517
+ #
2518
+ # * The total size of the message, including attachments, must be
2519
+ # smaller than 10 MB.
2520
+ #
2521
+ # * The message must include at least one recipient email address. The
2522
+ # recipient address can be a To: address, a CC: address, or a BCC:
2523
+ # address. If a recipient email address is invalid (that is, it is not
2524
+ # in the format *UserName@\[SubDomain.\]Domain.TopLevelDomain*), the
2525
+ # entire message will be rejected, even if the message contains other
2526
+ # recipients that are valid.
2527
+ #
2528
+ # * The message may not include more than 50 recipients, across the To:,
2529
+ # CC: and BCC: fields. If you need to send an email message to a
2530
+ # larger audience, you can divide your recipient list into groups of
2531
+ # 50 or fewer, and then call the `SendRawEmail` operation several
2532
+ # times to send the message to each group.
2533
+ #
2534
+ # For every message that you send, the total number of recipients
2535
+ # (including each recipient in the To:, CC: and BCC: fields) is counted
2536
+ # against the maximum number of emails you can send in a 24-hour period
2537
+ # (your *sending quota*). For more information about sending quotas in
2538
+ # Amazon SES, see [Managing Your Amazon SES Sending Limits][2] in the
2539
+ # *Amazon SES Developer Guide*.
2540
+ #
2541
+ # Additionally, keep the following considerations in mind when using the
2542
+ # `SendRawEmail` operation:
2543
+ #
2544
+ # * Although you can customize the message headers when using the
2545
+ # `SendRawEmail` operation, Amazon SES will automatically apply its
2546
+ # own `Message-ID` and `Date` headers; if you passed these headers
2547
+ # when creating the message, they will be overwritten by the values
2548
+ # that Amazon SES provides.
2516
2549
  #
2517
2550
  # * If you are using sending authorization to send on behalf of another
2518
2551
  # user, `SendRawEmail` enables you to specify the cross-account
2519
- # identity for the email's "Source," "From," and "Return-Path"
2520
- # parameters in one of two ways: you can pass optional parameters
2521
- # `SourceArn`, `FromArn`, and/or `ReturnPathArn` to the API, or you
2522
- # can include the following X-headers in the header of your raw email:
2552
+ # identity for the email's Source, From, and Return-Path parameters
2553
+ # in one of two ways: you can pass optional parameters `SourceArn`,
2554
+ # `FromArn`, and/or `ReturnPathArn` to the API, or you can include the
2555
+ # following X-headers in the header of your raw email:
2523
2556
  #
2524
2557
  # * `X-SES-SOURCE-ARN`
2525
2558
  #
@@ -2527,17 +2560,17 @@ module Aws::SES
2527
2560
  #
2528
2561
  # * `X-SES-RETURN-PATH-ARN`
2529
2562
  #
2530
- # Do not include these X-headers in the DKIM signature, because they
2531
- # are removed by Amazon SES before sending the email.
2563
+ # Do not include these X-headers in the DKIM signature; Amazon SES
2564
+ # will remove them before sending the email.
2532
2565
  #
2533
- # For the most common sending authorization use case, we recommend
2534
- # that you specify the `SourceIdentityArn` and do not specify either
2535
- # the `FromIdentityArn` or `ReturnPathIdentityArn`. (The same note
2536
- # applies to the corresponding X-headers.) If you only specify the
2537
- # `SourceIdentityArn`, Amazon SES will simply set the "From" address
2538
- # and the "Return Path" address to the identity specified in
2566
+ # For most common sending authorization scenarios, we recommend that
2567
+ # you specify the `SourceIdentityArn` parameter and not the
2568
+ # `FromIdentityArn` or `ReturnPathIdentityArn` parameters. If you only
2569
+ # specify the `SourceIdentityArn` parameter, Amazon SES will set the
2570
+ # From and Return Path addresses to the identity specified in
2539
2571
  # `SourceIdentityArn`. For more information about sending
2540
- # authorization, see the [Amazon SES Developer Guide][3].
2572
+ # authorization, see the [Using Sending Authorization with Amazon
2573
+ # SES][3] in the *Amazon SES Developer Guide*.
2541
2574
  #
2542
2575
  #
2543
2576
  #
@@ -2558,14 +2591,14 @@ module Aws::SES
2558
2591
  #
2559
2592
  # <note markdown="1"> If you specify the `Source` parameter and have feedback forwarding
2560
2593
  # enabled, then bounces and complaints will be sent to this email
2561
- # address. This takes precedence over any *Return-Path* header that you
2594
+ # address. This takes precedence over any Return-Path header that you
2562
2595
  # might include in the raw text of the message.
2563
2596
  #
2564
2597
  # </note>
2565
2598
  #
2566
2599
  #
2567
2600
  #
2568
- # [1]: http://tools.ietf.org/html/rfc2047
2601
+ # [1]: https://tools.ietf.org/html/rfc2047
2569
2602
  #
2570
2603
  # @option params [Array<String>] :destinations
2571
2604
  # A list of destinations for the message, consisting of To:, CC:, and
@@ -2747,14 +2780,11 @@ module Aws::SES
2747
2780
  #
2748
2781
  # </note>
2749
2782
  #
2750
- # For information about managing receipt rule sets, see the [Amazon SES
2751
- # Developer Guide][1].
2783
+ # For information about managing receipt rule sets, see the <i> <a
2784
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rule-sets.html">Amazon
2785
+ # SES Developer Guide</a>.</i>
2752
2786
  #
2753
- # This action is throttled at one request per second.
2754
- #
2755
- #
2756
- #
2757
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rule-sets.html
2787
+ # You can execute this operation no more than once per second.
2758
2788
  #
2759
2789
  # @option params [String] :rule_set_name
2760
2790
  # The name of the receipt rule set to make active. Setting this value to
@@ -2788,26 +2818,23 @@ module Aws::SES
2788
2818
 
2789
2819
  # Enables or disables Easy DKIM signing of email sent from an identity:
2790
2820
  #
2791
- # * If Easy DKIM signing is enabled for a domain name identity (e.g.,
2821
+ # * If Easy DKIM signing is enabled for a domain name identity (such as
2792
2822
  # `example.com`), then Amazon SES will DKIM-sign all email sent by
2793
- # addresses under that domain name (e.g., `user@example.com`).
2823
+ # addresses under that domain name (for example, `user@example.com`).
2794
2824
  #
2795
2825
  # * If Easy DKIM signing is enabled for an email address, then Amazon
2796
2826
  # SES will DKIM-sign all email sent by that email address.
2797
2827
  #
2798
- # For email addresses (e.g., `user@example.com`), you can only enable
2799
- # Easy DKIM signing if the corresponding domain (e.g., `example.com`)
2800
- # has been set up for Easy DKIM using the AWS Console or the
2801
- # `VerifyDomainDkim` action.
2802
- #
2803
- # This action is throttled at one request per second.
2804
- #
2805
- # For more information about Easy DKIM signing, go to the [Amazon SES
2806
- # Developer Guide][1].
2807
- #
2828
+ # For email addresses (for example, `user@example.com`), you can only
2829
+ # enable Easy DKIM signing if the corresponding domain (in this case,
2830
+ # `example.com`) has been set up for Easy DKIM using the AWS Console or
2831
+ # the `VerifyDomainDkim` operation.
2808
2832
  #
2833
+ # You can execute this operation no more than once per second.
2809
2834
  #
2810
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html
2835
+ # For more information about Easy DKIM signing, go to the <i> <a
2836
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html">Amazon
2837
+ # SES Developer Guide</a>.</i>
2811
2838
  #
2812
2839
  # @option params [required, String] :identity
2813
2840
  # The identity for which DKIM signing should be enabled or disabled.
@@ -2855,14 +2882,12 @@ module Aws::SES
2855
2882
  #
2856
2883
  # </note>
2857
2884
  #
2858
- # This action is throttled at one request per second.
2885
+ # You can execute this operation no more than once per second.
2859
2886
  #
2860
2887
  # For more information about using notifications with Amazon SES, see
2861
- # the [Amazon SES Developer Guide][1].
2862
- #
2863
- #
2864
- #
2865
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/notifications.html
2888
+ # the <i> <a
2889
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/notifications.html">Amazon
2890
+ # SES Developer Guide</a>.</i>
2866
2891
  #
2867
2892
  # @option params [required, String] :identity
2868
2893
  # The identity for which to set bounce and complaint notification
@@ -2910,14 +2935,12 @@ module Aws::SES
2910
2935
  # SES includes the original email headers in the Amazon Simple
2911
2936
  # Notification Service (Amazon SNS) notifications of a specified type.
2912
2937
  #
2913
- # This action is throttled at one request per second.
2938
+ # You can execute this operation no more than once per second.
2914
2939
  #
2915
2940
  # For more information about using notifications with Amazon SES, see
2916
- # the [Amazon SES Developer Guide][1].
2917
- #
2918
- #
2919
- #
2920
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/notifications.html
2941
+ # the <i> <a
2942
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/notifications.html">Amazon
2943
+ # SES Developer Guide</a>.</i>
2921
2944
  #
2922
2945
  # @option params [required, String] :identity
2923
2946
  # The identity for which to enable or disable headers in notifications.
@@ -2974,14 +2997,11 @@ module Aws::SES
2974
2997
  # To send emails using the specified MAIL FROM domain, you must add an
2975
2998
  # MX record to your MAIL FROM domain's DNS settings. If you want your
2976
2999
  # emails to pass Sender Policy Framework (SPF) checks, you must also add
2977
- # or update an SPF record. For more information, see the [Amazon SES
2978
- # Developer Guide][1].
2979
- #
2980
- # This action is throttled at one request per second.
3000
+ # or update an SPF record. For more information, see the <i> <a
3001
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/mail-from-set.html">Amazon
3002
+ # SES Developer Guide</a>.</i>
2981
3003
  #
2982
- #
2983
- #
2984
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/mail-from-set.html
3004
+ # You can execute this operation no more than once per second.
2985
3005
  #
2986
3006
  # @option params [required, String] :identity
2987
3007
  # The verified identity for which you want to enable or disable the
@@ -3053,14 +3073,11 @@ module Aws::SES
3053
3073
  #
3054
3074
  # </note>
3055
3075
  #
3056
- # This action is throttled at one request per second.
3057
- #
3058
- # For more information about feedback notification, see the [Amazon SES
3059
- # Developer Guide][1].
3076
+ # You can execute this operation no more than once per second.
3060
3077
  #
3061
- #
3062
- #
3063
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/notifications.html
3078
+ # For more information about feedback notification, see the <i> <a
3079
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/notifications.html">Amazon
3080
+ # SES Developer Guide</a>.</i>
3064
3081
  #
3065
3082
  # @option params [required, String] :identity
3066
3083
  # The identity for which the Amazon SNS topic will be set. You can
@@ -3111,14 +3128,11 @@ module Aws::SES
3111
3128
  # Sets the position of the specified receipt rule in the receipt rule
3112
3129
  # set.
3113
3130
  #
3114
- # For information about managing receipt rules, see the [Amazon SES
3115
- # Developer Guide][1].
3116
- #
3117
- # This action is throttled at one request per second.
3131
+ # For information about managing receipt rules, see the <i> <a
3132
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rules.html">Amazon
3133
+ # SES Developer Guide</a>.</i>
3118
3134
  #
3119
- #
3120
- #
3121
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rules.html
3135
+ # You can execute this operation no more than once per second.
3122
3136
  #
3123
3137
  # @option params [required, String] :rule_set_name
3124
3138
  # The name of the receipt rule set that contains the receipt rule to
@@ -3161,7 +3175,12 @@ module Aws::SES
3161
3175
  req.send_request(options)
3162
3176
  end
3163
3177
 
3164
- # Updates the event destination of a configuration set.
3178
+ # Updates the event destination of a configuration set. Event
3179
+ # destinations are associated with configuration sets, which enable you
3180
+ # to publish email sending events to Amazon CloudWatch, Amazon Kinesis
3181
+ # Firehose, or Amazon Simple Notification Service (Amazon SNS). For
3182
+ # information about using configuration sets, see [Monitoring Your
3183
+ # Amazon SES Sending Activity][1] in the *Amazon SES Developer Guide*.
3165
3184
  #
3166
3185
  # <note markdown="1"> When you create or update an event destination, you must provide one,
3167
3186
  # and only one, destination. The destination can be Amazon CloudWatch,
@@ -3170,20 +3189,15 @@ module Aws::SES
3170
3189
  #
3171
3190
  # </note>
3172
3191
  #
3173
- # Event destinations are associated with configuration sets, which
3174
- # enable you to publish email sending events to Amazon CloudWatch,
3175
- # Amazon Kinesis Firehose, or Amazon Simple Notification Service (Amazon
3176
- # SNS). For information about using configuration sets, see the [Amazon
3177
- # SES Developer Guide][1].
3178
- #
3179
- # This action is throttled at one request per second.
3192
+ # You can execute this operation no more than once per second.
3180
3193
  #
3181
3194
  #
3182
3195
  #
3183
3196
  # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html
3184
3197
  #
3185
3198
  # @option params [required, String] :configuration_set_name
3186
- # The name of the configuration set that you want to update.
3199
+ # The name of the configuration set that contains the event destination
3200
+ # that you want to update.
3187
3201
  #
3188
3202
  # @option params [required, Types::EventDestination] :event_destination
3189
3203
  # The event destination object that you want to apply to the specified
@@ -3227,19 +3241,70 @@ module Aws::SES
3227
3241
  req.send_request(options)
3228
3242
  end
3229
3243
 
3230
- # Updates a receipt rule.
3244
+ # Modifies an association between a configuration set and a custom
3245
+ # domain for open and click event tracking.
3246
+ #
3247
+ # By default, images and links used for tracking open and click events
3248
+ # are hosted on domains operated by Amazon SES. You can configure a
3249
+ # subdomain of your own to handle these events by redirecting them to
3250
+ # the Amazon SES-operated domain. For information about using
3251
+ # configuration sets, see [Configuring Custom Domains to Handle Open and
3252
+ # Click Tracking][1] in the <i> <a
3253
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/Welcome.html">Amazon
3254
+ # SES Developer Guide</a>.</i>
3255
+ #
3256
+ #
3257
+ #
3258
+ # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/configure-custom-open-click-domains.html
3259
+ #
3260
+ # @option params [required, String] :configuration_set_name
3261
+ # The name of the configuration set for which you want to update the
3262
+ # custom tracking domain.
3263
+ #
3264
+ # @option params [required, Types::TrackingOptions] :tracking_options
3265
+ # A domain that is used to redirect email recipients to an Amazon
3266
+ # SES-operated domain. This domain captures open and click events
3267
+ # generated by Amazon SES emails.
3231
3268
  #
3232
- # For information about managing receipt rules, see the [Amazon SES
3233
- # Developer Guide][1].
3269
+ # For more information, see [Configuring Custom Domains to Handle Open
3270
+ # and Click Tracking][1] in the <i> <a
3271
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/Welcome.html">Amazon
3272
+ # SES Developer Guide</a>.</i>
3234
3273
  #
3235
- # This action is throttled at one request per second.
3236
3274
  #
3237
3275
  #
3276
+ # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/configure-custom-open-click-domains.html
3238
3277
  #
3239
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rules.html
3278
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3279
+ #
3280
+ # @example Request syntax with placeholder values
3281
+ #
3282
+ # resp = client.update_configuration_set_tracking_options({
3283
+ # configuration_set_name: "ConfigurationSetName", # required
3284
+ # tracking_options: { # required
3285
+ # custom_redirect_domain: "CustomRedirectDomain",
3286
+ # },
3287
+ # })
3288
+ #
3289
+ # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateConfigurationSetTrackingOptions AWS API Documentation
3290
+ #
3291
+ # @overload update_configuration_set_tracking_options(params = {})
3292
+ # @param [Hash] params ({})
3293
+ def update_configuration_set_tracking_options(params = {}, options = {})
3294
+ req = build_request(:update_configuration_set_tracking_options, params)
3295
+ req.send_request(options)
3296
+ end
3297
+
3298
+ # Updates a receipt rule.
3299
+ #
3300
+ # For information about managing receipt rules, see the <i> <a
3301
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rules.html">Amazon
3302
+ # SES Developer Guide</a>.</i>
3303
+ #
3304
+ # You can execute this operation no more than once per second.
3240
3305
  #
3241
3306
  # @option params [required, String] :rule_set_name
3242
- # The name of the receipt rule set to which the receipt rule belongs.
3307
+ # The name of the receipt rule set that the receipt rule belongs to.
3243
3308
  #
3244
3309
  # @option params [required, Types::ReceiptRule] :rule
3245
3310
  # A data structure that contains the updated receipt rule information.
@@ -3337,17 +3402,15 @@ module Aws::SES
3337
3402
  # take up to 72 hours. Upon successful detection, Amazon SES will be
3338
3403
  # able to DKIM-sign email originating from that domain.
3339
3404
  #
3340
- # This action is throttled at one request per second.
3405
+ # You can execute this operation no more than once per second.
3341
3406
  #
3342
3407
  # To enable or disable Easy DKIM signing for a domain, use the
3343
- # `SetIdentityDkimEnabled` action.
3408
+ # `SetIdentityDkimEnabled` operation.
3344
3409
  #
3345
3410
  # For more information about creating DNS records using DKIM tokens, go
3346
- # to the [Amazon SES Developer Guide][1].
3347
- #
3348
- #
3349
- #
3350
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim-dns-records.html
3411
+ # to the <i> <a
3412
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim-dns-records.html">Amazon
3413
+ # SES Developer Guide</a>.</i>
3351
3414
  #
3352
3415
  # @option params [required, String] :domain
3353
3416
  # The name of the domain to be verified for Easy DKIM signing.
@@ -3394,9 +3457,16 @@ module Aws::SES
3394
3457
  req.send_request(options)
3395
3458
  end
3396
3459
 
3397
- # Verifies a domain.
3460
+ # Adds a domain to the list of identities for your Amazon SES account
3461
+ # and attempts to verify it. For more information about verifying
3462
+ # domains, see [Verifying Email Addresses and Domains][1] in the *Amazon
3463
+ # SES Developer Guide*.
3398
3464
  #
3399
- # This action is throttled at one request per second.
3465
+ # You can execute this operation no more than once per second.
3466
+ #
3467
+ #
3468
+ #
3469
+ # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-addresses-and-domains.html
3400
3470
  #
3401
3471
  # @option params [required, String] :domain
3402
3472
  # The domain to be verified.
@@ -3438,14 +3508,8 @@ module Aws::SES
3438
3508
  req.send_request(options)
3439
3509
  end
3440
3510
 
3441
- # Verifies an email address. This action causes a confirmation email
3442
- # message to be sent to the specified address.
3443
- #
3444
- # The VerifyEmailAddress action is deprecated as of the May 15, 2012
3445
- # release of Domain Verification. The VerifyEmailIdentity action is now
3446
- # preferred.
3447
- #
3448
- # This action is throttled at one request per second.
3511
+ # Deprecated. Use the `VerifyEmailIdentity` operation to verify a new
3512
+ # email address.
3449
3513
  #
3450
3514
  # @option params [required, String] :email_address
3451
3515
  # The email address to be verified.
@@ -3476,10 +3540,11 @@ module Aws::SES
3476
3540
  req.send_request(options)
3477
3541
  end
3478
3542
 
3479
- # Verifies an email address. This action causes a confirmation email
3480
- # message to be sent to the specified address.
3543
+ # Adds an email address to the list of identities for your Amazon SES
3544
+ # account and attempts to verify it. This operation causes a
3545
+ # confirmation email message to be sent to the specified address.
3481
3546
  #
3482
- # This action is throttled at one request per second.
3547
+ # You can execute this operation no more than once per second.
3483
3548
  #
3484
3549
  # @option params [required, String] :email_address
3485
3550
  # The email address to be verified.
@@ -3523,7 +3588,7 @@ module Aws::SES
3523
3588
  params: params,
3524
3589
  config: config)
3525
3590
  context[:gem_name] = 'aws-sdk-ses'
3526
- context[:gem_version] = '1.1.0'
3591
+ context[:gem_version] = '1.2.0'
3527
3592
  Seahorse::Client::Request.new(handlers, context)
3528
3593
  end
3529
3594