aws-sdk-ses 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -47,6 +47,8 @@ module Aws::SES
47
47
  CreateConfigurationSetEventDestinationResponse = Shapes::StructureShape.new(name: 'CreateConfigurationSetEventDestinationResponse')
48
48
  CreateConfigurationSetRequest = Shapes::StructureShape.new(name: 'CreateConfigurationSetRequest')
49
49
  CreateConfigurationSetResponse = Shapes::StructureShape.new(name: 'CreateConfigurationSetResponse')
50
+ CreateConfigurationSetTrackingOptionsRequest = Shapes::StructureShape.new(name: 'CreateConfigurationSetTrackingOptionsRequest')
51
+ CreateConfigurationSetTrackingOptionsResponse = Shapes::StructureShape.new(name: 'CreateConfigurationSetTrackingOptionsResponse')
50
52
  CreateReceiptFilterRequest = Shapes::StructureShape.new(name: 'CreateReceiptFilterRequest')
51
53
  CreateReceiptFilterResponse = Shapes::StructureShape.new(name: 'CreateReceiptFilterResponse')
52
54
  CreateReceiptRuleRequest = Shapes::StructureShape.new(name: 'CreateReceiptRuleRequest')
@@ -54,11 +56,14 @@ module Aws::SES
54
56
  CreateReceiptRuleSetRequest = Shapes::StructureShape.new(name: 'CreateReceiptRuleSetRequest')
55
57
  CreateReceiptRuleSetResponse = Shapes::StructureShape.new(name: 'CreateReceiptRuleSetResponse')
56
58
  CustomMailFromStatus = Shapes::StringShape.new(name: 'CustomMailFromStatus')
59
+ CustomRedirectDomain = Shapes::StringShape.new(name: 'CustomRedirectDomain')
57
60
  DefaultDimensionValue = Shapes::StringShape.new(name: 'DefaultDimensionValue')
58
61
  DeleteConfigurationSetEventDestinationRequest = Shapes::StructureShape.new(name: 'DeleteConfigurationSetEventDestinationRequest')
59
62
  DeleteConfigurationSetEventDestinationResponse = Shapes::StructureShape.new(name: 'DeleteConfigurationSetEventDestinationResponse')
60
63
  DeleteConfigurationSetRequest = Shapes::StructureShape.new(name: 'DeleteConfigurationSetRequest')
61
64
  DeleteConfigurationSetResponse = Shapes::StructureShape.new(name: 'DeleteConfigurationSetResponse')
65
+ DeleteConfigurationSetTrackingOptionsRequest = Shapes::StructureShape.new(name: 'DeleteConfigurationSetTrackingOptionsRequest')
66
+ DeleteConfigurationSetTrackingOptionsResponse = Shapes::StructureShape.new(name: 'DeleteConfigurationSetTrackingOptionsResponse')
62
67
  DeleteIdentityPolicyRequest = Shapes::StructureShape.new(name: 'DeleteIdentityPolicyRequest')
63
68
  DeleteIdentityPolicyResponse = Shapes::StructureShape.new(name: 'DeleteIdentityPolicyResponse')
64
69
  DeleteIdentityRequest = Shapes::StructureShape.new(name: 'DeleteIdentityRequest')
@@ -128,6 +133,7 @@ module Aws::SES
128
133
  InvalidS3ConfigurationException = Shapes::StructureShape.new(name: 'InvalidS3ConfigurationException')
129
134
  InvalidSNSDestinationException = Shapes::StructureShape.new(name: 'InvalidSNSDestinationException')
130
135
  InvalidSnsTopicException = Shapes::StructureShape.new(name: 'InvalidSnsTopicException')
136
+ InvalidTrackingOptionsException = Shapes::StructureShape.new(name: 'InvalidTrackingOptionsException')
131
137
  InvocationType = Shapes::StringShape.new(name: 'InvocationType')
132
138
  KinesisFirehoseDestination = Shapes::StructureShape.new(name: 'KinesisFirehoseDestination')
133
139
  LambdaAction = Shapes::StructureShape.new(name: 'LambdaAction')
@@ -228,8 +234,13 @@ module Aws::SES
228
234
  StopScope = Shapes::StringShape.new(name: 'StopScope')
229
235
  Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
230
236
  TlsPolicy = Shapes::StringShape.new(name: 'TlsPolicy')
237
+ TrackingOptions = Shapes::StructureShape.new(name: 'TrackingOptions')
238
+ TrackingOptionsAlreadyExistsException = Shapes::StructureShape.new(name: 'TrackingOptionsAlreadyExistsException')
239
+ TrackingOptionsDoesNotExistException = Shapes::StructureShape.new(name: 'TrackingOptionsDoesNotExistException')
231
240
  UpdateConfigurationSetEventDestinationRequest = Shapes::StructureShape.new(name: 'UpdateConfigurationSetEventDestinationRequest')
232
241
  UpdateConfigurationSetEventDestinationResponse = Shapes::StructureShape.new(name: 'UpdateConfigurationSetEventDestinationResponse')
242
+ UpdateConfigurationSetTrackingOptionsRequest = Shapes::StructureShape.new(name: 'UpdateConfigurationSetTrackingOptionsRequest')
243
+ UpdateConfigurationSetTrackingOptionsResponse = Shapes::StructureShape.new(name: 'UpdateConfigurationSetTrackingOptionsResponse')
233
244
  UpdateReceiptRuleRequest = Shapes::StructureShape.new(name: 'UpdateReceiptRuleRequest')
234
245
  UpdateReceiptRuleResponse = Shapes::StructureShape.new(name: 'UpdateReceiptRuleResponse')
235
246
  VerificationAttributes = Shapes::MapShape.new(name: 'VerificationAttributes')
@@ -308,6 +319,12 @@ module Aws::SES
308
319
 
309
320
  CreateConfigurationSetResponse.struct_class = Types::CreateConfigurationSetResponse
310
321
 
322
+ CreateConfigurationSetTrackingOptionsRequest.add_member(:configuration_set_name, Shapes::ShapeRef.new(shape: ConfigurationSetName, required: true, location_name: "ConfigurationSetName"))
323
+ CreateConfigurationSetTrackingOptionsRequest.add_member(:tracking_options, Shapes::ShapeRef.new(shape: TrackingOptions, required: true, location_name: "TrackingOptions"))
324
+ CreateConfigurationSetTrackingOptionsRequest.struct_class = Types::CreateConfigurationSetTrackingOptionsRequest
325
+
326
+ CreateConfigurationSetTrackingOptionsResponse.struct_class = Types::CreateConfigurationSetTrackingOptionsResponse
327
+
311
328
  CreateReceiptFilterRequest.add_member(:filter, Shapes::ShapeRef.new(shape: ReceiptFilter, required: true, location_name: "Filter"))
312
329
  CreateReceiptFilterRequest.struct_class = Types::CreateReceiptFilterRequest
313
330
 
@@ -336,6 +353,11 @@ module Aws::SES
336
353
 
337
354
  DeleteConfigurationSetResponse.struct_class = Types::DeleteConfigurationSetResponse
338
355
 
356
+ DeleteConfigurationSetTrackingOptionsRequest.add_member(:configuration_set_name, Shapes::ShapeRef.new(shape: ConfigurationSetName, required: true, location_name: "ConfigurationSetName"))
357
+ DeleteConfigurationSetTrackingOptionsRequest.struct_class = Types::DeleteConfigurationSetTrackingOptionsRequest
358
+
359
+ DeleteConfigurationSetTrackingOptionsResponse.struct_class = Types::DeleteConfigurationSetTrackingOptionsResponse
360
+
339
361
  DeleteIdentityPolicyRequest.add_member(:identity, Shapes::ShapeRef.new(shape: Identity, required: true, location_name: "Identity"))
340
362
  DeleteIdentityPolicyRequest.add_member(:policy_name, Shapes::ShapeRef.new(shape: PolicyName, required: true, location_name: "PolicyName"))
341
363
  DeleteIdentityPolicyRequest.struct_class = Types::DeleteIdentityPolicyRequest
@@ -378,6 +400,7 @@ module Aws::SES
378
400
 
379
401
  DescribeConfigurationSetResponse.add_member(:configuration_set, Shapes::ShapeRef.new(shape: ConfigurationSet, location_name: "ConfigurationSet"))
380
402
  DescribeConfigurationSetResponse.add_member(:event_destinations, Shapes::ShapeRef.new(shape: EventDestinations, location_name: "EventDestinations"))
403
+ DescribeConfigurationSetResponse.add_member(:tracking_options, Shapes::ShapeRef.new(shape: TrackingOptions, location_name: "TrackingOptions"))
381
404
  DescribeConfigurationSetResponse.struct_class = Types::DescribeConfigurationSetResponse
382
405
 
383
406
  DescribeReceiptRuleRequest.add_member(:rule_set_name, Shapes::ShapeRef.new(shape: ReceiptRuleSetName, required: true, location_name: "RuleSetName"))
@@ -732,12 +755,21 @@ module Aws::SES
732
755
  StopAction.add_member(:topic_arn, Shapes::ShapeRef.new(shape: AmazonResourceName, location_name: "TopicArn"))
733
756
  StopAction.struct_class = Types::StopAction
734
757
 
758
+ TrackingOptions.add_member(:custom_redirect_domain, Shapes::ShapeRef.new(shape: CustomRedirectDomain, location_name: "CustomRedirectDomain"))
759
+ TrackingOptions.struct_class = Types::TrackingOptions
760
+
735
761
  UpdateConfigurationSetEventDestinationRequest.add_member(:configuration_set_name, Shapes::ShapeRef.new(shape: ConfigurationSetName, required: true, location_name: "ConfigurationSetName"))
736
762
  UpdateConfigurationSetEventDestinationRequest.add_member(:event_destination, Shapes::ShapeRef.new(shape: EventDestination, required: true, location_name: "EventDestination"))
737
763
  UpdateConfigurationSetEventDestinationRequest.struct_class = Types::UpdateConfigurationSetEventDestinationRequest
738
764
 
739
765
  UpdateConfigurationSetEventDestinationResponse.struct_class = Types::UpdateConfigurationSetEventDestinationResponse
740
766
 
767
+ UpdateConfigurationSetTrackingOptionsRequest.add_member(:configuration_set_name, Shapes::ShapeRef.new(shape: ConfigurationSetName, required: true, location_name: "ConfigurationSetName"))
768
+ UpdateConfigurationSetTrackingOptionsRequest.add_member(:tracking_options, Shapes::ShapeRef.new(shape: TrackingOptions, required: true, location_name: "TrackingOptions"))
769
+ UpdateConfigurationSetTrackingOptionsRequest.struct_class = Types::UpdateConfigurationSetTrackingOptionsRequest
770
+
771
+ UpdateConfigurationSetTrackingOptionsResponse.struct_class = Types::UpdateConfigurationSetTrackingOptionsResponse
772
+
741
773
  UpdateReceiptRuleRequest.add_member(:rule_set_name, Shapes::ShapeRef.new(shape: ReceiptRuleSetName, required: true, location_name: "RuleSetName"))
742
774
  UpdateReceiptRuleRequest.add_member(:rule, Shapes::ShapeRef.new(shape: ReceiptRule, required: true, location_name: "Rule"))
743
775
  UpdateReceiptRuleRequest.struct_class = Types::UpdateReceiptRuleRequest
@@ -824,6 +856,17 @@ module Aws::SES
824
856
  o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
825
857
  end)
826
858
 
859
+ api.add_operation(:create_configuration_set_tracking_options, Seahorse::Model::Operation.new.tap do |o|
860
+ o.name = "CreateConfigurationSetTrackingOptions"
861
+ o.http_method = "POST"
862
+ o.http_request_uri = "/"
863
+ o.input = Shapes::ShapeRef.new(shape: CreateConfigurationSetTrackingOptionsRequest)
864
+ o.output = Shapes::ShapeRef.new(shape: CreateConfigurationSetTrackingOptionsResponse)
865
+ o.errors << Shapes::ShapeRef.new(shape: ConfigurationSetDoesNotExistException)
866
+ o.errors << Shapes::ShapeRef.new(shape: TrackingOptionsAlreadyExistsException)
867
+ o.errors << Shapes::ShapeRef.new(shape: InvalidTrackingOptionsException)
868
+ end)
869
+
827
870
  api.add_operation(:create_receipt_filter, Seahorse::Model::Operation.new.tap do |o|
828
871
  o.name = "CreateReceiptFilter"
829
872
  o.http_method = "POST"
@@ -878,6 +921,16 @@ module Aws::SES
878
921
  o.errors << Shapes::ShapeRef.new(shape: EventDestinationDoesNotExistException)
879
922
  end)
880
923
 
924
+ api.add_operation(:delete_configuration_set_tracking_options, Seahorse::Model::Operation.new.tap do |o|
925
+ o.name = "DeleteConfigurationSetTrackingOptions"
926
+ o.http_method = "POST"
927
+ o.http_request_uri = "/"
928
+ o.input = Shapes::ShapeRef.new(shape: DeleteConfigurationSetTrackingOptionsRequest)
929
+ o.output = Shapes::ShapeRef.new(shape: DeleteConfigurationSetTrackingOptionsResponse)
930
+ o.errors << Shapes::ShapeRef.new(shape: ConfigurationSetDoesNotExistException)
931
+ o.errors << Shapes::ShapeRef.new(shape: TrackingOptionsDoesNotExistException)
932
+ end)
933
+
881
934
  api.add_operation(:delete_identity, Seahorse::Model::Operation.new.tap do |o|
882
935
  o.name = "DeleteIdentity"
883
936
  o.http_method = "POST"
@@ -1196,6 +1249,17 @@ module Aws::SES
1196
1249
  o.errors << Shapes::ShapeRef.new(shape: InvalidSNSDestinationException)
1197
1250
  end)
1198
1251
 
1252
+ api.add_operation(:update_configuration_set_tracking_options, Seahorse::Model::Operation.new.tap do |o|
1253
+ o.name = "UpdateConfigurationSetTrackingOptions"
1254
+ o.http_method = "POST"
1255
+ o.http_request_uri = "/"
1256
+ o.input = Shapes::ShapeRef.new(shape: UpdateConfigurationSetTrackingOptionsRequest)
1257
+ o.output = Shapes::ShapeRef.new(shape: UpdateConfigurationSetTrackingOptionsResponse)
1258
+ o.errors << Shapes::ShapeRef.new(shape: ConfigurationSetDoesNotExistException)
1259
+ o.errors << Shapes::ShapeRef.new(shape: TrackingOptionsDoesNotExistException)
1260
+ o.errors << Shapes::ShapeRef.new(shape: InvalidTrackingOptionsException)
1261
+ end)
1262
+
1199
1263
  api.add_operation(:update_receipt_rule, Seahorse::Model::Operation.new.tap do |o|
1200
1264
  o.name = "UpdateReceiptRule"
1201
1265
  o.http_method = "POST"
@@ -366,13 +366,16 @@ module Aws::SES
366
366
 
367
367
  # The name of the configuration set.
368
368
  #
369
- # Configuration sets enable you to publish email sending events. For
370
- # information about using configuration sets, see the [Amazon SES
371
- # Developer Guide][1].
369
+ # Configuration sets let you create groups of rules that you can apply
370
+ # to the emails you send using Amazon SES. For more information about
371
+ # using configuration sets, see [Using Amazon SES Configuration Sets][1]
372
+ # in the <i> <a
373
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/">Amazon
374
+ # SES Developer Guide</a>.</i>
372
375
  #
373
376
  #
374
377
  #
375
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html
378
+ # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/using-configuration-sets.html
376
379
  #
377
380
  # @note When making an API call, you may pass ConfigurationSet
378
381
  # data as a hash:
@@ -382,12 +385,13 @@ module Aws::SES
382
385
  # }
383
386
  #
384
387
  # @!attribute [rw] name
385
- # The name of the configuration set. The name must:
388
+ # The name of the configuration set. The name must meet the following
389
+ # requirements:
386
390
  #
387
- # * Contain only ASCII letters (a-z, A-Z), numbers (0-9), underscores
388
- # (\_), or dashes (-).
391
+ # * Contain only letters (a-z, A-Z), numbers (0-9), underscores (\_),
392
+ # or dashes (-).
389
393
  #
390
- # * Contain less than 64 characters.
394
+ # * Contain 64 characters or fewer.
391
395
  # @return [String]
392
396
  #
393
397
  # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ConfigurationSet AWS API Documentation
@@ -468,14 +472,13 @@ module Aws::SES
468
472
  # }
469
473
  #
470
474
  # @!attribute [rw] configuration_set_name
471
- # The name of the configuration set to which to apply the event
472
- # destination.
475
+ # The name of the configuration set that the event destination should
476
+ # be associated with.
473
477
  # @return [String]
474
478
  #
475
479
  # @!attribute [rw] event_destination
476
- # An object that describes the AWS service to which Amazon SES will
477
- # publish the email sending events associated with the specified
478
- # configuration set.
480
+ # An object that describes the AWS service that email sending event
481
+ # information will be published to.
479
482
  # @return [Types::EventDestination]
480
483
  #
481
484
  # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateConfigurationSetEventDestinationRequest AWS API Documentation
@@ -526,6 +529,53 @@ module Aws::SES
526
529
  #
527
530
  class CreateConfigurationSetResponse < Aws::EmptyStructure; end
528
531
 
532
+ # Represents a request to create an open and click tracking option
533
+ # object in a configuration set.
534
+ #
535
+ # @note When making an API call, you may pass CreateConfigurationSetTrackingOptionsRequest
536
+ # data as a hash:
537
+ #
538
+ # {
539
+ # configuration_set_name: "ConfigurationSetName", # required
540
+ # tracking_options: { # required
541
+ # custom_redirect_domain: "CustomRedirectDomain",
542
+ # },
543
+ # }
544
+ #
545
+ # @!attribute [rw] configuration_set_name
546
+ # The name of the configuration set that the tracking options should
547
+ # be associated with.
548
+ # @return [String]
549
+ #
550
+ # @!attribute [rw] tracking_options
551
+ # A domain that is used to redirect email recipients to an Amazon
552
+ # SES-operated domain. This domain captures open and click events
553
+ # generated by Amazon SES emails.
554
+ #
555
+ # For more information, see [Configuring Custom Domains to Handle Open
556
+ # and Click Tracking][1] in the <i> <a
557
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/Welcome.html">Amazon
558
+ # SES Developer Guide</a>.</i>
559
+ #
560
+ #
561
+ #
562
+ # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/configure-custom-open-click-domains.html
563
+ # @return [Types::TrackingOptions]
564
+ #
565
+ # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateConfigurationSetTrackingOptionsRequest AWS API Documentation
566
+ #
567
+ class CreateConfigurationSetTrackingOptionsRequest < Struct.new(
568
+ :configuration_set_name,
569
+ :tracking_options)
570
+ include Aws::Structure
571
+ end
572
+
573
+ # An empty element returned on a successful request.
574
+ #
575
+ # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateConfigurationSetTrackingOptionsResponse AWS API Documentation
576
+ #
577
+ class CreateConfigurationSetTrackingOptionsResponse < Aws::EmptyStructure; end
578
+
529
579
  # Represents a request to create a new IP address filter. You use IP
530
580
  # address filters when you receive email with Amazon SES. For more
531
581
  # information, see the [Amazon SES Developer Guide][1].
@@ -628,7 +678,7 @@ module Aws::SES
628
678
  # }
629
679
  #
630
680
  # @!attribute [rw] rule_set_name
631
- # The name of the rule set to which to add the rule.
681
+ # The name of the rule set that the receipt rule will be added to.
632
682
  # @return [String]
633
683
  #
634
684
  # @!attribute [rw] after
@@ -769,6 +819,34 @@ module Aws::SES
769
819
  #
770
820
  class DeleteConfigurationSetResponse < Aws::EmptyStructure; end
771
821
 
822
+ # Represents a request to delete open and click tracking options in a
823
+ # configuration set.
824
+ #
825
+ # @note When making an API call, you may pass DeleteConfigurationSetTrackingOptionsRequest
826
+ # data as a hash:
827
+ #
828
+ # {
829
+ # configuration_set_name: "ConfigurationSetName", # required
830
+ # }
831
+ #
832
+ # @!attribute [rw] configuration_set_name
833
+ # The name of the configuration set from which you want to delete the
834
+ # tracking options.
835
+ # @return [String]
836
+ #
837
+ # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteConfigurationSetTrackingOptionsRequest AWS API Documentation
838
+ #
839
+ class DeleteConfigurationSetTrackingOptionsRequest < Struct.new(
840
+ :configuration_set_name)
841
+ include Aws::Structure
842
+ end
843
+
844
+ # An empty element returned on a successful request.
845
+ #
846
+ # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteConfigurationSetTrackingOptionsResponse AWS API Documentation
847
+ #
848
+ class DeleteConfigurationSetTrackingOptionsResponse < Aws::EmptyStructure; end
849
+
772
850
  # Represents a request to delete a sending authorization policy for an
773
851
  # identity. Sending authorization is an Amazon SES feature that enables
774
852
  # you to authorize other senders to use your identities. For
@@ -1017,7 +1095,7 @@ module Aws::SES
1017
1095
  #
1018
1096
  # {
1019
1097
  # configuration_set_name: "ConfigurationSetName", # required
1020
- # configuration_set_attribute_names: ["eventDestinations"], # accepts eventDestinations
1098
+ # configuration_set_attribute_names: ["eventDestinations"], # accepts eventDestinations, trackingOptions
1021
1099
  # }
1022
1100
  #
1023
1101
  # @!attribute [rw] configuration_set_name
@@ -1053,11 +1131,17 @@ module Aws::SES
1053
1131
  # A list of event destinations associated with the configuration set.
1054
1132
  # @return [Array<Types::EventDestination>]
1055
1133
  #
1134
+ # @!attribute [rw] tracking_options
1135
+ # The name of the custom open and click tracking domain associated
1136
+ # with the configuration set.
1137
+ # @return [Types::TrackingOptions]
1138
+ #
1056
1139
  # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DescribeConfigurationSetResponse AWS API Documentation
1057
1140
  #
1058
1141
  class DescribeConfigurationSetResponse < Struct.new(
1059
1142
  :configuration_set,
1060
- :event_destinations)
1143
+ :event_destinations,
1144
+ :tracking_options)
1061
1145
  include Aws::Structure
1062
1146
  end
1063
1147
 
@@ -1078,7 +1162,7 @@ module Aws::SES
1078
1162
  # }
1079
1163
  #
1080
1164
  # @!attribute [rw] rule_set_name
1081
- # The name of the receipt rule set to which the receipt rule belongs.
1165
+ # The name of the receipt rule set that the receipt rule belongs to.
1082
1166
  # @return [String]
1083
1167
  #
1084
1168
  # @!attribute [rw] rule_name
@@ -1165,7 +1249,7 @@ module Aws::SES
1165
1249
  #
1166
1250
  #
1167
1251
  #
1168
- # [1]: http://tools.ietf.org/html/rfc2047
1252
+ # [1]: https://tools.ietf.org/html/rfc2047
1169
1253
  #
1170
1254
  # @note When making an API call, you may pass Destination
1171
1255
  # data as a hash:
@@ -1197,8 +1281,8 @@ module Aws::SES
1197
1281
  include Aws::Structure
1198
1282
  end
1199
1283
 
1200
- # Contains information about the event destination to which the
1201
- # specified email sending events are published.
1284
+ # Contains information about the event destination that the specified
1285
+ # email sending events will be published to.
1202
1286
  #
1203
1287
  # <note markdown="1"> When you create or update an event destination, you must provide one,
1204
1288
  # and only one, destination. The destination can be Amazon CloudWatch,
@@ -1767,12 +1851,9 @@ module Aws::SES
1767
1851
  #
1768
1852
  # Event destinations, such as Amazon Kinesis Firehose, are associated
1769
1853
  # with configuration sets, which enable you to publish email sending
1770
- # events. For information about using configuration sets, see the
1771
- # [Amazon SES Developer Guide][1].
1772
- #
1773
- #
1774
- #
1775
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html
1854
+ # events. For information about using configuration sets, see the <i> <a
1855
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html">Amazon
1856
+ # SES Developer Guide</a>.</i>
1776
1857
  #
1777
1858
  # @note When making an API call, you may pass KinesisFirehoseDestination
1778
1859
  # data as a hash:
@@ -1788,8 +1869,8 @@ module Aws::SES
1788
1869
  # @return [String]
1789
1870
  #
1790
1871
  # @!attribute [rw] delivery_stream_arn
1791
- # The ARN of the Amazon Kinesis Firehose stream to which to publish
1792
- # email sending events.
1872
+ # The ARN of the Amazon Kinesis Firehose stream that email sending
1873
+ # events should be published to.
1793
1874
  # @return [String]
1794
1875
  #
1795
1876
  # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/KinesisFirehoseDestination AWS API Documentation
@@ -1807,15 +1888,14 @@ module Aws::SES
1807
1888
  # To enable Amazon SES to call your AWS Lambda function or to publish to
1808
1889
  # an Amazon SNS topic of another account, Amazon SES must have
1809
1890
  # permission to access those resources. For information about giving
1810
- # permissions, see the [Amazon SES Developer Guide][1].
1891
+ # permissions, see the <i> <a
1892
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-permissions.html">Amazon
1893
+ # SES Developer Guide</a>.</i>
1811
1894
  #
1812
1895
  # For information about using AWS Lambda actions in receipt rules, see
1813
- # the [Amazon SES Developer Guide][2].
1814
- #
1815
- #
1816
- #
1817
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-permissions.html
1818
- # [2]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-action-lambda.html
1896
+ # the <i> <a
1897
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-action-lambda.html">Amazon
1898
+ # SES Developer Guide</a>.</i>
1819
1899
  #
1820
1900
  # @note When making an API call, you may pass LambdaAction
1821
1901
  # data as a hash:
@@ -1830,24 +1910,18 @@ module Aws::SES
1830
1910
  # The Amazon Resource Name (ARN) of the Amazon SNS topic to notify
1831
1911
  # when the Lambda action is taken. An example of an Amazon SNS topic
1832
1912
  # ARN is `arn:aws:sns:us-west-2:123456789012:MyTopic`. For more
1833
- # information about Amazon SNS topics, see the [Amazon SNS Developer
1834
- # Guide][1].
1835
- #
1836
- #
1837
- #
1838
- # [1]: http://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html
1913
+ # information about Amazon SNS topics, see the <i> <a
1914
+ # href="http://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html">Amazon
1915
+ # SNS Developer Guide</a>.</i>
1839
1916
  # @return [String]
1840
1917
  #
1841
1918
  # @!attribute [rw] function_arn
1842
1919
  # The Amazon Resource Name (ARN) of the AWS Lambda function. An
1843
1920
  # example of an AWS Lambda function ARN is
1844
1921
  # `arn:aws:lambda:us-west-2:account-id:function:MyFunction`. For more
1845
- # information about AWS Lambda, see the [AWS Lambda Developer
1846
- # Guide][1].
1847
- #
1848
- #
1849
- #
1850
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/welcome.html
1922
+ # information about AWS Lambda, see the <i> <a
1923
+ # href="http://docs.aws.amazon.com/lambda/latest/dg/welcome.html">AWS
1924
+ # Lambda Developer Guide</a>.</i>
1851
1925
  # @return [String]
1852
1926
  #
1853
1927
  # @!attribute [rw] invocation_type
@@ -1856,16 +1930,14 @@ module Aws::SES
1856
1930
  # immediately result in a response, and a value of `Event` means that
1857
1931
  # the function will be invoked asynchronously. The default value is
1858
1932
  # `Event`. For information about AWS Lambda invocation types, see the
1859
- # [AWS Lambda Developer Guide][1].
1933
+ # <i> <a
1934
+ # href="http://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html">AWS
1935
+ # Lambda Developer Guide</a>.</i>
1860
1936
  #
1861
1937
  # There is a 30-second timeout on `RequestResponse` invocations. You
1862
1938
  # should use `Event` invocation in most cases. Use `RequestResponse`
1863
1939
  # only when you want to make a mail flow decision, such as whether to
1864
1940
  # stop the receipt rule or the receipt rule set.
1865
- #
1866
- #
1867
- #
1868
- # [1]: http://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html
1869
1941
  # @return [String]
1870
1942
  #
1871
1943
  # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/LambdaAction AWS API Documentation
@@ -2181,12 +2253,10 @@ module Aws::SES
2181
2253
  # Notification (DSN) when an email that Amazon SES receives on your
2182
2254
  # behalf bounces.
2183
2255
  #
2184
- # For information about receiving email through Amazon SES, see the
2185
- # [Amazon SES Developer Guide][1].
2186
- #
2187
- #
2188
- #
2189
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email.html
2256
+ # For information about receiving email through Amazon SES, see the <i>
2257
+ # <a
2258
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email.html">Amazon
2259
+ # SES Developer Guide</a>.</i>
2190
2260
  #
2191
2261
  # @note When making an API call, you may pass MessageDsn
2192
2262
  # data as a hash:
@@ -2298,7 +2368,7 @@ module Aws::SES
2298
2368
  # }
2299
2369
  #
2300
2370
  # @!attribute [rw] identity
2301
- # The identity to which the policy will apply. You can specify an
2371
+ # The identity that the policy will apply to. You can specify an
2302
2372
  # identity by using its name or by using its Amazon Resource Name
2303
2373
  # (ARN). Examples: `user@example.com`, `example.com`,
2304
2374
  # `arn:aws:ses:us-east-1:123456789012:identity/example.com`.
@@ -2576,8 +2646,8 @@ module Aws::SES
2576
2646
  # take when it receives mail on behalf of one or more email addresses or
2577
2647
  # domains that you own.
2578
2648
  #
2579
- # Each receipt rule defines a set of email addresses or domains to which
2580
- # it applies. If the email addresses or domains match at least one
2649
+ # Each receipt rule defines a set of email addresses or domains that it
2650
+ # applies to. If the email addresses or domains match at least one
2581
2651
  # recipient address of the message, Amazon SES executes all of the
2582
2652
  # receipt rule's actions on the message.
2583
2653
  #
@@ -2660,8 +2730,8 @@ module Aws::SES
2660
2730
  # @return [String]
2661
2731
  #
2662
2732
  # @!attribute [rw] recipients
2663
- # The recipient domains and email addresses to which the receipt rule
2664
- # applies. If this field is not specified, this rule will match all
2733
+ # The recipient domains and email addresses that the receipt rule
2734
+ # applies to. If this field is not specified, this rule will match all
2665
2735
  # recipients under all verified domains.
2666
2736
  # @return [Array<String>]
2667
2737
  #
@@ -2672,7 +2742,7 @@ module Aws::SES
2672
2742
  # @return [Array<Types::ReceiptAction>]
2673
2743
  #
2674
2744
  # @!attribute [rw] scan_enabled
2675
- # If `true`, then messages to which this receipt rule applies are
2745
+ # If `true`, then messages that this receipt rule applies to are
2676
2746
  # scanned for spam and viruses. The default value is `false`.
2677
2747
  # @return [Boolean]
2678
2748
  #
@@ -2754,11 +2824,11 @@ module Aws::SES
2754
2824
  # }
2755
2825
  #
2756
2826
  # @!attribute [rw] final_recipient
2757
- # The email address to which the message was ultimately delivered.
2758
- # This corresponds to the `Final-Recipient` in the DSN. If not
2759
- # specified, `FinalRecipient` will be set to the `Recipient` specified
2760
- # in the `BouncedRecipientInfo` structure. Either `FinalRecipient` or
2761
- # the recipient in `BouncedRecipientInfo` must be a recipient of the
2827
+ # The email address that the message was ultimately delivered to. This
2828
+ # corresponds to the `Final-Recipient` in the DSN. If not specified,
2829
+ # `FinalRecipient` will be set to the `Recipient` specified in the
2830
+ # `BouncedRecipientInfo` structure. Either `FinalRecipient` or the
2831
+ # recipient in `BouncedRecipientInfo` must be a recipient of the
2762
2832
  # original bounced message.
2763
2833
  #
2764
2834
  # <note markdown="1"> Do not prepend the `FinalRecipient` email address with `rfc 822;`,
@@ -2923,8 +2993,8 @@ module Aws::SES
2923
2993
  # @return [String]
2924
2994
  #
2925
2995
  # @!attribute [rw] bucket_name
2926
- # The name of the Amazon S3 bucket to which to save the received
2927
- # email.
2996
+ # The name of the Amazon S3 bucket that incoming email will be saved
2997
+ # to.
2928
2998
  # @return [String]
2929
2999
  #
2930
3000
  # @!attribute [rw] object_key_prefix
@@ -2966,7 +3036,8 @@ module Aws::SES
2966
3036
  # access to use your AWS KMS keys for decryption. This encryption
2967
3037
  # client is currently available with the [AWS Java SDK][3] and [AWS
2968
3038
  # Ruby SDK][4] only. For more information about client-side encryption
2969
- # using AWS KMS master keys, see the [Amazon S3 Developer Guide][5].
3039
+ # using AWS KMS master keys, see the [Amazon S3 Developer
3040
+ # Guide](AmazonS3/latest/dev/UsingClientSideEncryption.html).
2970
3041
  #
2971
3042
  #
2972
3043
  #
@@ -2974,7 +3045,6 @@ module Aws::SES
2974
3045
  # [2]: http://docs.aws.amazon.com/kms/latest/developerguide/concepts.html
2975
3046
  # [3]: http://aws.amazon.com/sdk-for-java/
2976
3047
  # [4]: http://aws.amazon.com/sdk-for-ruby/
2977
- # [5]: http://alpha-docs-aws.amazon.com/AmazonS3/latest/dev/UsingClientSideEncryption.html
2978
3048
  # @return [String]
2979
3049
  #
2980
3050
  # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/S3Action AWS API Documentation
@@ -3052,12 +3122,9 @@ module Aws::SES
3052
3122
  #
3053
3123
  # Event destinations, such as Amazon SNS, are associated with
3054
3124
  # configuration sets, which enable you to publish email sending events.
3055
- # For information about using configuration sets, see the [Amazon SES
3056
- # Developer Guide][1].
3057
- #
3058
- #
3059
- #
3060
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html
3125
+ # For information about using configuration sets, see the <i> <a
3126
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html">Amazon
3127
+ # SES Developer Guide</a>.</i>
3061
3128
  #
3062
3129
  # @note When making an API call, you may pass SNSDestination
3063
3130
  # data as a hash:
@@ -3067,15 +3134,12 @@ module Aws::SES
3067
3134
  # }
3068
3135
  #
3069
3136
  # @!attribute [rw] topic_arn
3070
- # The ARN of the Amazon SNS topic to which you want to publish email
3071
- # sending events. An example of an Amazon SNS topic ARN is
3072
- # arn:aws:sns:us-west-2:123456789012:MyTopic. For more information
3073
- # about Amazon SNS topics, see the [ *Amazon SNS Developer Guide*
3074
- # ][1].
3075
- #
3076
- #
3077
- #
3078
- # [1]: http://docs.aws.amazon.com/http:/alpha-docs-aws.amazon.com/sns/latest/dg/CreateTopic.html
3137
+ # The ARN of the Amazon SNS topic that email sending events will be
3138
+ # published to. An example of an Amazon SNS topic ARN is
3139
+ # `arn:aws:sns:us-west-2:123456789012:MyTopic`. For more information
3140
+ # about Amazon SNS topics, see the <i> <a
3141
+ # href="http://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html">Amazon
3142
+ # SNS Developer Guide</a>.</i>
3079
3143
  # @return [String]
3080
3144
  #
3081
3145
  # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SNSDestination AWS API Documentation
@@ -3295,7 +3359,7 @@ module Aws::SES
3295
3359
  #
3296
3360
  # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-addresses-and-domains.html
3297
3361
  # [2]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html
3298
- # [3]: http://tools.ietf.org/html/rfc2047
3362
+ # [3]: https://tools.ietf.org/html/rfc2047
3299
3363
  # @return [String]
3300
3364
  #
3301
3365
  # @!attribute [rw] destination
@@ -3314,14 +3378,14 @@ module Aws::SES
3314
3378
  # @return [Array<String>]
3315
3379
  #
3316
3380
  # @!attribute [rw] return_path
3317
- # The email address to which bounces and complaints are to be
3318
- # forwarded when feedback forwarding is enabled. If the message cannot
3319
- # be delivered to the recipient, then an error message will be
3320
- # returned from the recipient's ISP; this message will then be
3321
- # forwarded to the email address specified by the `ReturnPath`
3322
- # parameter. The `ReturnPath` parameter is never overwritten. This
3323
- # email address must be either individually verified with Amazon SES,
3324
- # or from a domain that has been verified with Amazon SES.
3381
+ # The email address that bounces and complaints will be forwarded to
3382
+ # when feedback forwarding is enabled. If the message cannot be
3383
+ # delivered to the recipient, then an error message will be returned
3384
+ # from the recipient's ISP; this message will then be forwarded to
3385
+ # the email address specified by the `ReturnPath` parameter. The
3386
+ # `ReturnPath` parameter is never overwritten. This email address must
3387
+ # be either individually verified with Amazon SES, or from a domain
3388
+ # that has been verified with Amazon SES.
3325
3389
  # @return [String]
3326
3390
  #
3327
3391
  # @!attribute [rw] source_arn
@@ -3447,14 +3511,14 @@ module Aws::SES
3447
3511
  #
3448
3512
  # <note markdown="1"> If you specify the `Source` parameter and have feedback forwarding
3449
3513
  # enabled, then bounces and complaints will be sent to this email
3450
- # address. This takes precedence over any *Return-Path* header that
3451
- # you might include in the raw text of the message.
3514
+ # address. This takes precedence over any Return-Path header that you
3515
+ # might include in the raw text of the message.
3452
3516
  #
3453
3517
  # </note>
3454
3518
  #
3455
3519
  #
3456
3520
  #
3457
- # [1]: http://tools.ietf.org/html/rfc2047
3521
+ # [1]: https://tools.ietf.org/html/rfc2047
3458
3522
  # @return [String]
3459
3523
  #
3460
3524
  # @!attribute [rw] destinations
@@ -3947,11 +4011,9 @@ module Aws::SES
3947
4011
  # Amazon Simple Notification Service (Amazon SNS).
3948
4012
  #
3949
4013
  # For information about setting a stop action in a receipt rule, see the
3950
- # [Amazon SES Developer Guide][1].
3951
- #
3952
- #
3953
- #
3954
- # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-action-stop.html
4014
+ # <i> <a
4015
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-action-stop.html">Amazon
4016
+ # SES Developer Guide</a>.</i>
3955
4017
  #
3956
4018
  # @note When making an API call, you may pass StopAction
3957
4019
  # data as a hash:
@@ -3962,8 +4024,7 @@ module Aws::SES
3962
4024
  # }
3963
4025
  #
3964
4026
  # @!attribute [rw] scope
3965
- # The scope to which the Stop action applies. That is, what is being
3966
- # stopped.
4027
+ # The name of the RuleSet that is being stopped.
3967
4028
  # @return [String]
3968
4029
  #
3969
4030
  # @!attribute [rw] topic_arn
@@ -3986,6 +4047,38 @@ module Aws::SES
3986
4047
  include Aws::Structure
3987
4048
  end
3988
4049
 
4050
+ # A domain that is used to redirect email recipients to an Amazon
4051
+ # SES-operated domain. This domain captures open and click events
4052
+ # generated by Amazon SES emails.
4053
+ #
4054
+ # For more information, see [Configuring Custom Domains to Handle Open
4055
+ # and Click Tracking][1] in the <i> <a
4056
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/Welcome.html">Amazon
4057
+ # SES Developer Guide</a>.</i>
4058
+ #
4059
+ #
4060
+ #
4061
+ # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/configure-custom-open-click-domains.html
4062
+ #
4063
+ # @note When making an API call, you may pass TrackingOptions
4064
+ # data as a hash:
4065
+ #
4066
+ # {
4067
+ # custom_redirect_domain: "CustomRedirectDomain",
4068
+ # }
4069
+ #
4070
+ # @!attribute [rw] custom_redirect_domain
4071
+ # The custom subdomain that will be used to redirect email recipients
4072
+ # to the Amazon SES event tracking domain.
4073
+ # @return [String]
4074
+ #
4075
+ # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/TrackingOptions AWS API Documentation
4076
+ #
4077
+ class TrackingOptions < Struct.new(
4078
+ :custom_redirect_domain)
4079
+ include Aws::Structure
4080
+ end
4081
+
3989
4082
  # Represents a request to update the event destination of a
3990
4083
  # configuration set. Configuration sets enable you to publish email
3991
4084
  # sending events. For information about using configuration sets, see
@@ -4024,7 +4117,8 @@ module Aws::SES
4024
4117
  # }
4025
4118
  #
4026
4119
  # @!attribute [rw] configuration_set_name
4027
- # The name of the configuration set that you want to update.
4120
+ # The name of the configuration set that contains the event
4121
+ # destination that you want to update.
4028
4122
  # @return [String]
4029
4123
  #
4030
4124
  # @!attribute [rw] event_destination
@@ -4046,6 +4140,53 @@ module Aws::SES
4046
4140
  #
4047
4141
  class UpdateConfigurationSetEventDestinationResponse < Aws::EmptyStructure; end
4048
4142
 
4143
+ # Represents a request to update the tracking options for a
4144
+ # configuration set.
4145
+ #
4146
+ # @note When making an API call, you may pass UpdateConfigurationSetTrackingOptionsRequest
4147
+ # data as a hash:
4148
+ #
4149
+ # {
4150
+ # configuration_set_name: "ConfigurationSetName", # required
4151
+ # tracking_options: { # required
4152
+ # custom_redirect_domain: "CustomRedirectDomain",
4153
+ # },
4154
+ # }
4155
+ #
4156
+ # @!attribute [rw] configuration_set_name
4157
+ # The name of the configuration set for which you want to update the
4158
+ # custom tracking domain.
4159
+ # @return [String]
4160
+ #
4161
+ # @!attribute [rw] tracking_options
4162
+ # A domain that is used to redirect email recipients to an Amazon
4163
+ # SES-operated domain. This domain captures open and click events
4164
+ # generated by Amazon SES emails.
4165
+ #
4166
+ # For more information, see [Configuring Custom Domains to Handle Open
4167
+ # and Click Tracking][1] in the <i> <a
4168
+ # href="http://docs.aws.amazon.com/ses/latest/DeveloperGuide/Welcome.html">Amazon
4169
+ # SES Developer Guide</a>.</i>
4170
+ #
4171
+ #
4172
+ #
4173
+ # [1]: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/configure-custom-open-click-domains.html
4174
+ # @return [Types::TrackingOptions]
4175
+ #
4176
+ # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateConfigurationSetTrackingOptionsRequest AWS API Documentation
4177
+ #
4178
+ class UpdateConfigurationSetTrackingOptionsRequest < Struct.new(
4179
+ :configuration_set_name,
4180
+ :tracking_options)
4181
+ include Aws::Structure
4182
+ end
4183
+
4184
+ # An empty element returned on a successful request.
4185
+ #
4186
+ # @see http://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateConfigurationSetTrackingOptionsResponse AWS API Documentation
4187
+ #
4188
+ class UpdateConfigurationSetTrackingOptionsResponse < Aws::EmptyStructure; end
4189
+
4049
4190
  # Represents a request to update a receipt rule. You use receipt rules
4050
4191
  # to receive email with Amazon SES. For more information, see the
4051
4192
  # [Amazon SES Developer Guide][1].
@@ -4107,7 +4248,7 @@ module Aws::SES
4107
4248
  # }
4108
4249
  #
4109
4250
  # @!attribute [rw] rule_set_name
4110
- # The name of the receipt rule set to which the receipt rule belongs.
4251
+ # The name of the receipt rule set that the receipt rule belongs to.
4111
4252
  # @return [String]
4112
4253
  #
4113
4254
  # @!attribute [rw] rule