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.
@@ -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