From ee425d0c8dcd5325609c0958e389730ef4b7031c Mon Sep 17 00:00:00 2001 From: AWS SDK for Go v2 automation user Date: Fri, 11 Aug 2023 18:16:13 +0000 Subject: [PATCH] Regenerated Clients --- .../24100316f9464614826d88f75c7013ac.json | 8 + .../491130b7786f4f0ba52f4a9a421cd13c.json | 8 + .../653f339173344943a3a927b78a23bb04.json | 8 + .../680277e06cfd4410ba22efdb3b7b4a59.json | 8 + .../93251c6379d041e09538038efbb52ac9.json | 8 + .../9585347fbd78434297fb130ef08fc20e.json | 8 + service/amplifybackend/endpoints_test.go | 184 +++++-- service/configservice/types/enums.go | 70 +++ service/ec2/types/enums.go | 30 ++ .../api_op_StartDashboardSnapshotJob.go | 11 +- service/quicksight/deserializers.go | 187 +++++++ service/quicksight/serializers.go | 81 +++ service/quicksight/types/enums.go | 64 ++- service/quicksight/types/types.go | 65 ++- service/quicksight/validators.go | 76 +++ service/ses/api_op_CloneReceiptRuleSet.go | 13 +- service/ses/api_op_CreateConfigurationSet.go | 4 +- ..._CreateConfigurationSetEventDestination.go | 19 +- ...p_CreateConfigurationSetTrackingOptions.go | 4 +- ...p_CreateCustomVerificationEmailTemplate.go | 4 +- service/ses/api_op_CreateReceiptFilter.go | 4 +- service/ses/api_op_CreateReceiptRule.go | 11 +- service/ses/api_op_CreateReceiptRuleSet.go | 13 +- service/ses/api_op_CreateTemplate.go | 10 +- service/ses/api_op_DeleteConfigurationSet.go | 4 +- ..._DeleteConfigurationSetEventDestination.go | 4 +- ...p_DeleteConfigurationSetTrackingOptions.go | 11 +- ...p_DeleteCustomVerificationEmailTemplate.go | 4 +- service/ses/api_op_DeleteIdentity.go | 3 +- service/ses/api_op_DeleteIdentityPolicy.go | 18 +- service/ses/api_op_DeleteReceiptFilter.go | 4 +- service/ses/api_op_DeleteReceiptRule.go | 4 +- service/ses/api_op_DeleteReceiptRuleSet.go | 4 +- service/ses/api_op_DeleteTemplate.go | 2 +- .../ses/api_op_DeleteVerifiedEmailAddress.go | 2 +- .../api_op_DescribeActiveReceiptRuleSet.go | 4 +- .../ses/api_op_DescribeConfigurationSet.go | 6 +- service/ses/api_op_DescribeReceiptRule.go | 4 +- service/ses/api_op_DescribeReceiptRuleSet.go | 4 +- .../ses/api_op_GetAccountSendingEnabled.go | 6 +- ...i_op_GetCustomVerificationEmailTemplate.go | 4 +- .../ses/api_op_GetIdentityDkimAttributes.go | 4 +- ..._op_GetIdentityMailFromDomainAttributes.go | 2 +- ...pi_op_GetIdentityNotificationAttributes.go | 4 +- service/ses/api_op_GetIdentityPolicies.go | 16 +- ...pi_op_GetIdentityVerificationAttributes.go | 22 +- service/ses/api_op_GetSendStatistics.go | 8 +- service/ses/api_op_GetTemplate.go | 6 +- service/ses/api_op_ListConfigurationSets.go | 27 +- ...op_ListCustomVerificationEmailTemplates.go | 14 +- service/ses/api_op_ListIdentities.go | 22 +- service/ses/api_op_ListIdentityPolicies.go | 18 +- service/ses/api_op_ListReceiptFilters.go | 14 +- service/ses/api_op_ListReceiptRuleSets.go | 18 +- service/ses/api_op_ListTemplates.go | 13 +- .../ses/api_op_ListVerifiedEmailAddresses.go | 4 +- ...i_op_PutConfigurationSetDeliveryOptions.go | 3 +- service/ses/api_op_PutIdentityPolicy.go | 14 +- service/ses/api_op_ReorderReceiptRuleSet.go | 11 +- service/ses/api_op_SendBounce.go | 14 +- service/ses/api_op_SendBulkTemplatedEmail.go | 71 +-- .../ses/api_op_SendCustomVerificationEmail.go | 11 +- service/ses/api_op_SendEmail.go | 61 ++- service/ses/api_op_SendRawEmail.go | 62 +-- service/ses/api_op_SendTemplatedEmail.go | 62 +-- service/ses/api_op_SetActiveReceiptRuleSet.go | 8 +- service/ses/api_op_SetIdentityDkimEnabled.go | 4 +- ...op_SetIdentityFeedbackForwardingEnabled.go | 16 +- ...etIdentityHeadersInNotificationsEnabled.go | 8 +- .../ses/api_op_SetIdentityMailFromDomain.go | 35 +- .../api_op_SetIdentityNotificationTopic.go | 23 +- service/ses/api_op_SetReceiptRulePosition.go | 4 +- service/ses/api_op_TestRenderTemplate.go | 2 +- .../ses/api_op_UpdateAccountSendingEnabled.go | 12 +- ..._UpdateConfigurationSetEventDestination.go | 10 +- ...onfigurationSetReputationMetricsEnabled.go | 13 +- ...op_UpdateConfigurationSetSendingEnabled.go | 12 +- ...p_UpdateConfigurationSetTrackingOptions.go | 7 +- ...p_UpdateCustomVerificationEmailTemplate.go | 6 +- service/ses/api_op_UpdateReceiptRule.go | 4 +- service/ses/api_op_UpdateTemplate.go | 8 +- service/ses/api_op_VerifyDomainDkim.go | 8 +- service/ses/api_op_VerifyDomainIdentity.go | 11 +- service/ses/api_op_VerifyEmailAddress.go | 2 +- service/ses/api_op_VerifyEmailIdentity.go | 8 +- service/ses/doc.go | 6 +- service/ses/endpoints_test.go | 196 ++++++-- service/ses/types/errors.go | 15 +- service/ses/types/types.go | 472 ++++++++++-------- .../api_op_RespondDecisionTaskCompleted.go | 16 + service/swf/deserializers.go | 23 + service/swf/serializers.go | 12 + service/swf/types/enums.go | 4 +- service/swf/types/types.go | 11 + service/swf/validators.go | 5 + .../internal/endpoints/endpoints.go | 3 + 96 files changed, 1680 insertions(+), 771 deletions(-) create mode 100644 .changelog/24100316f9464614826d88f75c7013ac.json create mode 100644 .changelog/491130b7786f4f0ba52f4a9a421cd13c.json create mode 100644 .changelog/653f339173344943a3a927b78a23bb04.json create mode 100644 .changelog/680277e06cfd4410ba22efdb3b7b4a59.json create mode 100644 .changelog/93251c6379d041e09538038efbb52ac9.json create mode 100644 .changelog/9585347fbd78434297fb130ef08fc20e.json diff --git a/.changelog/24100316f9464614826d88f75c7013ac.json b/.changelog/24100316f9464614826d88f75c7013ac.json new file mode 100644 index 00000000000..be0dc3acb27 --- /dev/null +++ b/.changelog/24100316f9464614826d88f75c7013ac.json @@ -0,0 +1,8 @@ +{ + "id": "24100316-f946-4614-826d-88f75c7013ac", + "type": "feature", + "description": "New Authentication method for Account subscription - IAM Identity Center. Hierarchy layout support, default column width support and related style properties for pivot table visuals. Non-additive topic field aggregations for Topic API", + "modules": [ + "service/quicksight" + ] +} \ No newline at end of file diff --git a/.changelog/491130b7786f4f0ba52f4a9a421cd13c.json b/.changelog/491130b7786f4f0ba52f4a9a421cd13c.json new file mode 100644 index 00000000000..d8cd69208fe --- /dev/null +++ b/.changelog/491130b7786f4f0ba52f4a9a421cd13c.json @@ -0,0 +1,8 @@ +{ + "id": "491130b7-786f-4f0b-a52f-4a9a421cd13c", + "type": "feature", + "description": "This release adds new API parameters to override workflow task list for workflow executions.", + "modules": [ + "service/swf" + ] +} \ No newline at end of file diff --git a/.changelog/653f339173344943a3a927b78a23bb04.json b/.changelog/653f339173344943a3a927b78a23bb04.json new file mode 100644 index 00000000000..c4eceda8306 --- /dev/null +++ b/.changelog/653f339173344943a3a927b78a23bb04.json @@ -0,0 +1,8 @@ +{ + "id": "653f3391-7334-4943-a3a9-27b78a23bb04", + "type": "feature", + "description": "Adds sensitive trait to required input shapes.", + "modules": [ + "service/amplifybackend" + ] +} \ No newline at end of file diff --git a/.changelog/680277e06cfd4410ba22efdb3b7b4a59.json b/.changelog/680277e06cfd4410ba22efdb3b7b4a59.json new file mode 100644 index 00000000000..6ab683660e8 --- /dev/null +++ b/.changelog/680277e06cfd4410ba22efdb3b7b4a59.json @@ -0,0 +1,8 @@ +{ + "id": "680277e0-6cfd-4410-ba22-efdb3b7b4a59", + "type": "feature", + "description": "Amazon EC2 P5 instances, powered by the latest NVIDIA H100 Tensor Core GPUs, deliver the highest performance in EC2 for deep learning (DL) and HPC applications. M7i-flex and M7i instances are next-generation general purpose instances powered by custom 4th Generation Intel Xeon Scalable processors.", + "modules": [ + "service/ec2" + ] +} \ No newline at end of file diff --git a/.changelog/93251c6379d041e09538038efbb52ac9.json b/.changelog/93251c6379d041e09538038efbb52ac9.json new file mode 100644 index 00000000000..e9c937fec8e --- /dev/null +++ b/.changelog/93251c6379d041e09538038efbb52ac9.json @@ -0,0 +1,8 @@ +{ + "id": "93251c63-79d0-41e0-9538-038efbb52ac9", + "type": "documentation", + "description": "Doc only updates to include: 1) Clarified which part of an email address where it's okay to have Punycode when it contains non-ASCII characters for the SendRawEmail action and other actions where this is applicable. 2) Updated S3Action description with new MB max bucket size from 30 to 40.", + "modules": [ + "service/ses" + ] +} \ No newline at end of file diff --git a/.changelog/9585347fbd78434297fb130ef08fc20e.json b/.changelog/9585347fbd78434297fb130ef08fc20e.json new file mode 100644 index 00000000000..326cd3e847d --- /dev/null +++ b/.changelog/9585347fbd78434297fb130ef08fc20e.json @@ -0,0 +1,8 @@ +{ + "id": "9585347f-bd78-4342-97fb-130ef08fc20e", + "type": "feature", + "description": "Updated ResourceType enum with new resource types onboarded by AWS Config in July 2023.", + "modules": [ + "service/configservice" + ] +} \ No newline at end of file diff --git a/service/amplifybackend/endpoints_test.go b/service/amplifybackend/endpoints_test.go index d3e471711fa..e13a49755d6 100644 --- a/service/amplifybackend/endpoints_test.go +++ b/service/amplifybackend/endpoints_test.go @@ -18,8 +18,8 @@ import ( func TestEndpointCase0(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("ap-northeast-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -57,8 +57,8 @@ func TestEndpointCase0(t *testing.T) { func TestEndpointCase1(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("ap-northeast-2"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -96,8 +96,8 @@ func TestEndpointCase1(t *testing.T) { func TestEndpointCase2(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("ap-south-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -135,8 +135,8 @@ func TestEndpointCase2(t *testing.T) { func TestEndpointCase3(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("ap-southeast-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -174,8 +174,8 @@ func TestEndpointCase3(t *testing.T) { func TestEndpointCase4(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("ap-southeast-2"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -213,8 +213,8 @@ func TestEndpointCase4(t *testing.T) { func TestEndpointCase5(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("ca-central-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -252,8 +252,8 @@ func TestEndpointCase5(t *testing.T) { func TestEndpointCase6(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("eu-central-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -291,8 +291,8 @@ func TestEndpointCase6(t *testing.T) { func TestEndpointCase7(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("eu-north-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -330,8 +330,8 @@ func TestEndpointCase7(t *testing.T) { func TestEndpointCase8(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("eu-west-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -369,8 +369,8 @@ func TestEndpointCase8(t *testing.T) { func TestEndpointCase9(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("eu-west-2"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -408,8 +408,8 @@ func TestEndpointCase9(t *testing.T) { func TestEndpointCase10(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("eu-west-3"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -447,8 +447,8 @@ func TestEndpointCase10(t *testing.T) { func TestEndpointCase11(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("me-south-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -486,8 +486,8 @@ func TestEndpointCase11(t *testing.T) { func TestEndpointCase12(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("sa-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -525,8 +525,8 @@ func TestEndpointCase12(t *testing.T) { func TestEndpointCase13(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -564,8 +564,8 @@ func TestEndpointCase13(t *testing.T) { func TestEndpointCase14(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-east-2"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -603,8 +603,8 @@ func TestEndpointCase14(t *testing.T) { func TestEndpointCase15(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-west-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -642,8 +642,8 @@ func TestEndpointCase15(t *testing.T) { func TestEndpointCase16(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-west-2"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -681,8 +681,8 @@ func TestEndpointCase16(t *testing.T) { func TestEndpointCase17(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-east-1"), - UseDualStack: ptr.Bool(true), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(true), } resolver := NewDefaultEndpointResolverV2() @@ -720,8 +720,8 @@ func TestEndpointCase17(t *testing.T) { func TestEndpointCase18(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -759,8 +759,8 @@ func TestEndpointCase18(t *testing.T) { func TestEndpointCase19(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-east-1"), - UseDualStack: ptr.Bool(true), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(true), } resolver := NewDefaultEndpointResolverV2() @@ -798,8 +798,8 @@ func TestEndpointCase19(t *testing.T) { func TestEndpointCase20(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("cn-north-1"), - UseDualStack: ptr.Bool(true), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(true), } resolver := NewDefaultEndpointResolverV2() @@ -837,8 +837,8 @@ func TestEndpointCase20(t *testing.T) { func TestEndpointCase21(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("cn-north-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -876,8 +876,8 @@ func TestEndpointCase21(t *testing.T) { func TestEndpointCase22(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("cn-north-1"), - UseDualStack: ptr.Bool(true), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(true), } resolver := NewDefaultEndpointResolverV2() @@ -915,8 +915,8 @@ func TestEndpointCase22(t *testing.T) { func TestEndpointCase23(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("cn-north-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -954,8 +954,8 @@ func TestEndpointCase23(t *testing.T) { func TestEndpointCase24(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-gov-east-1"), - UseDualStack: ptr.Bool(true), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(true), } resolver := NewDefaultEndpointResolverV2() @@ -993,8 +993,8 @@ func TestEndpointCase24(t *testing.T) { func TestEndpointCase25(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-gov-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -1032,8 +1032,8 @@ func TestEndpointCase25(t *testing.T) { func TestEndpointCase26(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-gov-east-1"), - UseDualStack: ptr.Bool(true), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(true), } resolver := NewDefaultEndpointResolverV2() @@ -1071,8 +1071,8 @@ func TestEndpointCase26(t *testing.T) { func TestEndpointCase27(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-gov-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -1106,12 +1106,32 @@ func TestEndpointCase27(t *testing.T) { } } -// For region us-iso-east-1 with FIPS enabled and DualStack disabled +// For region us-iso-east-1 with FIPS enabled and DualStack enabled func TestEndpointCase28(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-iso-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(true), + } + + resolver := NewDefaultEndpointResolverV2() + result, err := resolver.ResolveEndpoint(context.Background(), params) + _, _ = result, err + + if err == nil { + t.Fatalf("expect error, got none") + } + if e, a := "FIPS and DualStack are enabled, but this partition does not support one or both", err.Error(); !strings.Contains(a, e) { + t.Errorf("expect %v error in %v", e, a) + } +} + +// For region us-iso-east-1 with FIPS enabled and DualStack disabled +func TestEndpointCase29(t *testing.T) { + var params = EndpointParameters{ + Region: ptr.String("us-iso-east-1"), + UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -1145,12 +1165,32 @@ func TestEndpointCase28(t *testing.T) { } } +// For region us-iso-east-1 with FIPS disabled and DualStack enabled +func TestEndpointCase30(t *testing.T) { + var params = EndpointParameters{ + Region: ptr.String("us-iso-east-1"), + UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(true), + } + + resolver := NewDefaultEndpointResolverV2() + result, err := resolver.ResolveEndpoint(context.Background(), params) + _, _ = result, err + + if err == nil { + t.Fatalf("expect error, got none") + } + if e, a := "DualStack is enabled but this partition does not support DualStack", err.Error(); !strings.Contains(a, e) { + t.Errorf("expect %v error in %v", e, a) + } +} + // For region us-iso-east-1 with FIPS disabled and DualStack disabled -func TestEndpointCase29(t *testing.T) { +func TestEndpointCase31(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-iso-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -1184,12 +1224,32 @@ func TestEndpointCase29(t *testing.T) { } } +// For region us-isob-east-1 with FIPS enabled and DualStack enabled +func TestEndpointCase32(t *testing.T) { + var params = EndpointParameters{ + Region: ptr.String("us-isob-east-1"), + UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(true), + } + + resolver := NewDefaultEndpointResolverV2() + result, err := resolver.ResolveEndpoint(context.Background(), params) + _, _ = result, err + + if err == nil { + t.Fatalf("expect error, got none") + } + if e, a := "FIPS and DualStack are enabled, but this partition does not support one or both", err.Error(); !strings.Contains(a, e) { + t.Errorf("expect %v error in %v", e, a) + } +} + // For region us-isob-east-1 with FIPS enabled and DualStack disabled -func TestEndpointCase30(t *testing.T) { +func TestEndpointCase33(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-isob-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -1223,12 +1283,32 @@ func TestEndpointCase30(t *testing.T) { } } +// For region us-isob-east-1 with FIPS disabled and DualStack enabled +func TestEndpointCase34(t *testing.T) { + var params = EndpointParameters{ + Region: ptr.String("us-isob-east-1"), + UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(true), + } + + resolver := NewDefaultEndpointResolverV2() + result, err := resolver.ResolveEndpoint(context.Background(), params) + _, _ = result, err + + if err == nil { + t.Fatalf("expect error, got none") + } + if e, a := "DualStack is enabled but this partition does not support DualStack", err.Error(); !strings.Contains(a, e) { + t.Errorf("expect %v error in %v", e, a) + } +} + // For region us-isob-east-1 with FIPS disabled and DualStack disabled -func TestEndpointCase31(t *testing.T) { +func TestEndpointCase35(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-isob-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -1263,11 +1343,11 @@ func TestEndpointCase31(t *testing.T) { } // For custom endpoint with region set and fips disabled and dualstack disabled -func TestEndpointCase32(t *testing.T) { +func TestEndpointCase36(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), Endpoint: ptr.String("https://example.com"), } @@ -1303,10 +1383,10 @@ func TestEndpointCase32(t *testing.T) { } // For custom endpoint with region not set and fips disabled and dualstack disabled -func TestEndpointCase33(t *testing.T) { +func TestEndpointCase37(t *testing.T) { var params = EndpointParameters{ - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), Endpoint: ptr.String("https://example.com"), } @@ -1342,11 +1422,11 @@ func TestEndpointCase33(t *testing.T) { } // For custom endpoint with fips enabled and dualstack disabled -func TestEndpointCase34(t *testing.T) { +func TestEndpointCase38(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(false), Endpoint: ptr.String("https://example.com"), } @@ -1363,11 +1443,11 @@ func TestEndpointCase34(t *testing.T) { } // For custom endpoint with fips disabled and dualstack enabled -func TestEndpointCase35(t *testing.T) { +func TestEndpointCase39(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-east-1"), - UseDualStack: ptr.Bool(true), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(true), Endpoint: ptr.String("https://example.com"), } @@ -1382,3 +1462,19 @@ func TestEndpointCase35(t *testing.T) { t.Errorf("expect %v error in %v", e, a) } } + +// Missing region +func TestEndpointCase40(t *testing.T) { + var params = EndpointParameters{} + + resolver := NewDefaultEndpointResolverV2() + result, err := resolver.ResolveEndpoint(context.Background(), params) + _, _ = result, err + + if err == nil { + t.Fatalf("expect error, got none") + } + if e, a := "Invalid Configuration: Missing Region", err.Error(); !strings.Contains(a, e) { + t.Errorf("expect %v error in %v", e, a) + } +} diff --git a/service/configservice/types/enums.go b/service/configservice/types/enums.go index 5b0180a8438..296b7ecdbdd 100644 --- a/service/configservice/types/enums.go +++ b/service/configservice/types/enums.go @@ -976,6 +976,41 @@ const ( ResourceTypeTransferAgreement ResourceType = "AWS::Transfer::Agreement" ResourceTypeTransferConnector ResourceType = "AWS::Transfer::Connector" ResourceTypeKinesisFirehoseDeliveryStream ResourceType = "AWS::KinesisFirehose::DeliveryStream" + ResourceTypeAmplifyBranch ResourceType = "AWS::Amplify::Branch" + ResourceTypeAppIntegrationsEventIntegration ResourceType = "AWS::AppIntegrations::EventIntegration" + ResourceTypeAppMeshRoute ResourceType = "AWS::AppMesh::Route" + ResourceTypeAthenaPreparedStatement ResourceType = "AWS::Athena::PreparedStatement" + ResourceTypeEC2IPAMScope ResourceType = "AWS::EC2::IPAMScope" + ResourceTypeEvidentlyLaunch ResourceType = "AWS::Evidently::Launch" + ResourceTypeForecastDatasetGroup ResourceType = "AWS::Forecast::DatasetGroup" + ResourceTypeGreengrassV2ComponentVersion ResourceType = "AWS::GreengrassV2::ComponentVersion" + ResourceTypeGroundStationMissionProfile ResourceType = "AWS::GroundStation::MissionProfile" + ResourceTypeMediaConnectFlowEntitlement ResourceType = "AWS::MediaConnect::FlowEntitlement" + ResourceTypeMediaConnectFlowVpcInterface ResourceType = "AWS::MediaConnect::FlowVpcInterface" + ResourceTypeMediaTailorPlaybackConfiguration ResourceType = "AWS::MediaTailor::PlaybackConfiguration" + ResourceTypeMSKConfiguration ResourceType = "AWS::MSK::Configuration" + ResourceTypePersonalizeDataset ResourceType = "AWS::Personalize::Dataset" + ResourceTypePersonalizeSchema ResourceType = "AWS::Personalize::Schema" + ResourceTypePersonalizeSolution ResourceType = "AWS::Personalize::Solution" + ResourceTypePinpointEmailTemplate ResourceType = "AWS::Pinpoint::EmailTemplate" + ResourceTypePinpointEventStream ResourceType = "AWS::Pinpoint::EventStream" + ResourceTypeResilienceHubApp ResourceType = "AWS::ResilienceHub::App" + ResourceTypeACMPCACertificateAuthority ResourceType = "AWS::ACMPCA::CertificateAuthority" + ResourceTypeAppConfigHostedConfigurationVersion ResourceType = "AWS::AppConfig::HostedConfigurationVersion" + ResourceTypeAppMeshVirtualGateway ResourceType = "AWS::AppMesh::VirtualGateway" + ResourceTypeAppMeshVirtualRouter ResourceType = "AWS::AppMesh::VirtualRouter" + ResourceTypeAppRunnerService ResourceType = "AWS::AppRunner::Service" + ResourceTypeCustomerProfilesObjectType ResourceType = "AWS::CustomerProfiles::ObjectType" + ResourceTypeDMSEndpoint ResourceType = "AWS::DMS::Endpoint" + ResourceTypeEC2CapacityReservation ResourceType = "AWS::EC2::CapacityReservation" + ResourceTypeEC2ClientVpnEndpoint ResourceType = "AWS::EC2::ClientVpnEndpoint" + ResourceTypeKendraIndex ResourceType = "AWS::Kendra::Index" + ResourceTypeKinesisVideoStream ResourceType = "AWS::KinesisVideo::Stream" + ResourceTypeLogsDestination ResourceType = "AWS::Logs::Destination" + ResourceTypePinpointEmailChannel ResourceType = "AWS::Pinpoint::EmailChannel" + ResourceTypeS3AccessPoint ResourceType = "AWS::S3::AccessPoint" + ResourceTypeNetworkManagerCustomerGatewayAssociation ResourceType = "AWS::NetworkManager::CustomerGatewayAssociation" + ResourceTypeNetworkManagerLinkAssociation ResourceType = "AWS::NetworkManager::LinkAssociation" ) // Values returns all known values for ResourceType. Note that this can be @@ -1301,6 +1336,41 @@ func (ResourceType) Values() []ResourceType { "AWS::Transfer::Agreement", "AWS::Transfer::Connector", "AWS::KinesisFirehose::DeliveryStream", + "AWS::Amplify::Branch", + "AWS::AppIntegrations::EventIntegration", + "AWS::AppMesh::Route", + "AWS::Athena::PreparedStatement", + "AWS::EC2::IPAMScope", + "AWS::Evidently::Launch", + "AWS::Forecast::DatasetGroup", + "AWS::GreengrassV2::ComponentVersion", + "AWS::GroundStation::MissionProfile", + "AWS::MediaConnect::FlowEntitlement", + "AWS::MediaConnect::FlowVpcInterface", + "AWS::MediaTailor::PlaybackConfiguration", + "AWS::MSK::Configuration", + "AWS::Personalize::Dataset", + "AWS::Personalize::Schema", + "AWS::Personalize::Solution", + "AWS::Pinpoint::EmailTemplate", + "AWS::Pinpoint::EventStream", + "AWS::ResilienceHub::App", + "AWS::ACMPCA::CertificateAuthority", + "AWS::AppConfig::HostedConfigurationVersion", + "AWS::AppMesh::VirtualGateway", + "AWS::AppMesh::VirtualRouter", + "AWS::AppRunner::Service", + "AWS::CustomerProfiles::ObjectType", + "AWS::DMS::Endpoint", + "AWS::EC2::CapacityReservation", + "AWS::EC2::ClientVpnEndpoint", + "AWS::Kendra::Index", + "AWS::KinesisVideo::Stream", + "AWS::Logs::Destination", + "AWS::Pinpoint::EmailChannel", + "AWS::S3::AccessPoint", + "AWS::NetworkManager::CustomerGatewayAssociation", + "AWS::NetworkManager::LinkAssociation", } } diff --git a/service/ec2/types/enums.go b/service/ec2/types/enums.go index fa5ba6e15d8..b0e4c9c994d 100644 --- a/service/ec2/types/enums.go +++ b/service/ec2/types/enums.go @@ -3453,6 +3453,21 @@ const ( InstanceTypeC7gn8xlarge InstanceType = "c7gn.8xlarge" InstanceTypeC7gn12xlarge InstanceType = "c7gn.12xlarge" InstanceTypeC7gn16xlarge InstanceType = "c7gn.16xlarge" + InstanceTypeP548xlarge InstanceType = "p5.48xlarge" + InstanceTypeM7iLarge InstanceType = "m7i.large" + InstanceTypeM7iXlarge InstanceType = "m7i.xlarge" + InstanceTypeM7i2xlarge InstanceType = "m7i.2xlarge" + InstanceTypeM7i4xlarge InstanceType = "m7i.4xlarge" + InstanceTypeM7i8xlarge InstanceType = "m7i.8xlarge" + InstanceTypeM7i12xlarge InstanceType = "m7i.12xlarge" + InstanceTypeM7i16xlarge InstanceType = "m7i.16xlarge" + InstanceTypeM7i24xlarge InstanceType = "m7i.24xlarge" + InstanceTypeM7i48xlarge InstanceType = "m7i.48xlarge" + InstanceTypeM7iFlexLarge InstanceType = "m7i-flex.large" + InstanceTypeM7iFlexXlarge InstanceType = "m7i-flex.xlarge" + InstanceTypeM7iFlex2xlarge InstanceType = "m7i-flex.2xlarge" + InstanceTypeM7iFlex4xlarge InstanceType = "m7i-flex.4xlarge" + InstanceTypeM7iFlex8xlarge InstanceType = "m7i-flex.8xlarge" ) // Values returns all known values for InstanceType. Note that this can be @@ -4125,6 +4140,21 @@ func (InstanceType) Values() []InstanceType { "c7gn.8xlarge", "c7gn.12xlarge", "c7gn.16xlarge", + "p5.48xlarge", + "m7i.large", + "m7i.xlarge", + "m7i.2xlarge", + "m7i.4xlarge", + "m7i.8xlarge", + "m7i.12xlarge", + "m7i.16xlarge", + "m7i.24xlarge", + "m7i.48xlarge", + "m7i-flex.large", + "m7i-flex.xlarge", + "m7i-flex.2xlarge", + "m7i-flex.4xlarge", + "m7i-flex.8xlarge", } } diff --git a/service/quicksight/api_op_StartDashboardSnapshotJob.go b/service/quicksight/api_op_StartDashboardSnapshotJob.go index cea2798ac22..b100bd68651 100644 --- a/service/quicksight/api_op_StartDashboardSnapshotJob.go +++ b/service/quicksight/api_op_StartDashboardSnapshotJob.go @@ -17,10 +17,13 @@ import ( ) // Starts an asynchronous job that generates a dashboard snapshot. You can request -// up to one paginated PDF and up to five CSVs per API call. Poll job descriptions -// with a DescribeDashboardSnapshotJob API call. Once the job succeeds, use the -// DescribeDashboardSnapshotJobResult API to obtain the download URIs that the job -// generates. +// one of the following format configurations per API call. +// - 1 paginated PDF +// - 5 CSVs +// +// Poll job descriptions with a DescribeDashboardSnapshotJob API call. Once the +// job succeeds, use the DescribeDashboardSnapshotJobResult API to obtain the +// download URIs that the job generates. func (c *Client) StartDashboardSnapshotJob(ctx context.Context, params *StartDashboardSnapshotJobInput, optFns ...func(*Options)) (*StartDashboardSnapshotJobOutput, error) { if params == nil { params = &StartDashboardSnapshotJobInput{} diff --git a/service/quicksight/deserializers.go b/service/quicksight/deserializers.go index ef7e64f8ae3..1359a1518cf 100644 --- a/service/quicksight/deserializers.go +++ b/service/quicksight/deserializers.go @@ -33135,6 +33135,15 @@ func awsRestjson1_deserializeDocumentAccountInfo(v **types.AccountInfo, value in sv.Edition = types.Edition(jtv) } + case "IAMIdentityCenterInstanceArn": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected String to be of type string, got %T instead", value) + } + sv.IAMIdentityCenterInstanceArn = ptr.String(jtv) + } + case "NotificationEmail": if value != nil { jtv, ok := value.(string) @@ -63760,6 +63769,15 @@ func awsRestjson1_deserializeDocumentPivotTableOptions(v **types.PivotTableOptio sv.ColumnNamesVisibility = types.Visibility(jtv) } + case "DefaultCellWidth": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected PixelLength to be of type string, got %T instead", value) + } + sv.DefaultCellWidth = ptr.String(jtv) + } + case "MetricPlacement": if value != nil { jtv, ok := value.(string) @@ -63784,6 +63802,20 @@ func awsRestjson1_deserializeDocumentPivotTableOptions(v **types.PivotTableOptio return err } + case "RowsLabelOptions": + if err := awsRestjson1_deserializeDocumentPivotTableRowsLabelOptions(&sv.RowsLabelOptions, value); err != nil { + return err + } + + case "RowsLayout": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected PivotTableRowsLayout to be of type string, got %T instead", value) + } + sv.RowsLayout = types.PivotTableRowsLayout(jtv) + } + case "SingleMetricVisibility": if value != nil { jtv, ok := value.(string) @@ -63860,6 +63892,55 @@ func awsRestjson1_deserializeDocumentPivotTablePaginatedReportOptions(v **types. return nil } +func awsRestjson1_deserializeDocumentPivotTableRowsLabelOptions(v **types.PivotTableRowsLabelOptions, value interface{}) error { + if v == nil { + return fmt.Errorf("unexpected nil of type %T", v) + } + if value == nil { + return nil + } + + shape, ok := value.(map[string]interface{}) + if !ok { + return fmt.Errorf("unexpected JSON type %v", value) + } + + var sv *types.PivotTableRowsLabelOptions + if *v == nil { + sv = &types.PivotTableRowsLabelOptions{} + } else { + sv = *v + } + + for key, value := range shape { + switch key { + case "CustomLabel": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected PivotTableRowsLabelText to be of type string, got %T instead", value) + } + sv.CustomLabel = ptr.String(jtv) + } + + case "Visibility": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected Visibility to be of type string, got %T instead", value) + } + sv.Visibility = types.Visibility(jtv) + } + + default: + _, _ = key, value + + } + } + *v = sv + return nil +} + func awsRestjson1_deserializeDocumentPivotTableSortBy(v **types.PivotTableSortBy, value interface{}) error { if v == nil { return fmt.Errorf("unexpected nil of type %T", v) @@ -66710,6 +66791,15 @@ func awsRestjson1_deserializeDocumentRowAlternateColorOptions(v **types.RowAlter sv.Status = types.WidgetStatus(jtv) } + case "UsePrimaryBackgroundColor": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected WidgetStatus to be of type string, got %T instead", value) + } + sv.UsePrimaryBackgroundColor = types.WidgetStatus(jtv) + } + default: _, _ = key, value @@ -71861,6 +71951,11 @@ func awsRestjson1_deserializeDocumentSubtotalOptions(v **types.SubtotalOptions, return err } + case "StyleTargets": + if err := awsRestjson1_deserializeDocumentTableStyleTargetList(&sv.StyleTargets, value); err != nil { + return err + } + case "TotalCellStyle": if err := awsRestjson1_deserializeDocumentTableCellStyle(&sv.TotalCellStyle, value); err != nil { return err @@ -73142,6 +73237,80 @@ func awsRestjson1_deserializeDocumentTableSortConfiguration(v **types.TableSortC return nil } +func awsRestjson1_deserializeDocumentTableStyleTarget(v **types.TableStyleTarget, value interface{}) error { + if v == nil { + return fmt.Errorf("unexpected nil of type %T", v) + } + if value == nil { + return nil + } + + shape, ok := value.(map[string]interface{}) + if !ok { + return fmt.Errorf("unexpected JSON type %v", value) + } + + var sv *types.TableStyleTarget + if *v == nil { + sv = &types.TableStyleTarget{} + } else { + sv = *v + } + + for key, value := range shape { + switch key { + case "CellType": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected StyledCellType to be of type string, got %T instead", value) + } + sv.CellType = types.StyledCellType(jtv) + } + + default: + _, _ = key, value + + } + } + *v = sv + return nil +} + +func awsRestjson1_deserializeDocumentTableStyleTargetList(v *[]types.TableStyleTarget, value interface{}) error { + if v == nil { + return fmt.Errorf("unexpected nil of type %T", v) + } + if value == nil { + return nil + } + + shape, ok := value.([]interface{}) + if !ok { + return fmt.Errorf("unexpected JSON type %v", value) + } + + var cv []types.TableStyleTarget + if *v == nil { + cv = []types.TableStyleTarget{} + } else { + cv = *v + } + + for _, value := range shape { + var col types.TableStyleTarget + destAddr := &col + if err := awsRestjson1_deserializeDocumentTableStyleTarget(&destAddr, value); err != nil { + return err + } + col = *destAddr + cv = append(cv, col) + + } + *v = cv + return nil +} + func awsRestjson1_deserializeDocumentTableUnaggregatedFieldWells(v **types.TableUnaggregatedFieldWells, value interface{}) error { if v == nil { return fmt.Errorf("unexpected nil of type %T", v) @@ -76203,6 +76372,15 @@ func awsRestjson1_deserializeDocumentTopicCalculatedField(v **types.TopicCalcula sv.NeverAggregateInFilter = jtv } + case "NonAdditive": + if value != nil { + jtv, ok := value.(bool) + if !ok { + return fmt.Errorf("expected NullableBoolean to be of type *bool, got %T instead", value) + } + sv.NonAdditive = ptr.Bool(jtv) + } + case "NotAllowedAggregations": if err := awsRestjson1_deserializeDocumentAuthorSpecifiedAggregations(&sv.NotAllowedAggregations, value); err != nil { return err @@ -76501,6 +76679,15 @@ func awsRestjson1_deserializeDocumentTopicColumn(v **types.TopicColumn, value in sv.NeverAggregateInFilter = jtv } + case "NonAdditive": + if value != nil { + jtv, ok := value.(bool) + if !ok { + return fmt.Errorf("expected NullableBoolean to be of type *bool, got %T instead", value) + } + sv.NonAdditive = ptr.Bool(jtv) + } + case "NotAllowedAggregations": if err := awsRestjson1_deserializeDocumentAuthorSpecifiedAggregations(&sv.NotAllowedAggregations, value); err != nil { return err diff --git a/service/quicksight/serializers.go b/service/quicksight/serializers.go index 3d279c66d8d..139ba6360b6 100644 --- a/service/quicksight/serializers.go +++ b/service/quicksight/serializers.go @@ -27976,6 +27976,11 @@ func awsRestjson1_serializeDocumentPivotTableOptions(v *types.PivotTableOptions, ok.String(string(v.ColumnNamesVisibility)) } + if v.DefaultCellWidth != nil { + ok := object.Key("DefaultCellWidth") + ok.String(*v.DefaultCellWidth) + } + if len(v.MetricPlacement) > 0 { ok := object.Key("MetricPlacement") ok.String(string(v.MetricPlacement)) @@ -28002,6 +28007,18 @@ func awsRestjson1_serializeDocumentPivotTableOptions(v *types.PivotTableOptions, } } + if v.RowsLabelOptions != nil { + ok := object.Key("RowsLabelOptions") + if err := awsRestjson1_serializeDocumentPivotTableRowsLabelOptions(v.RowsLabelOptions, ok); err != nil { + return err + } + } + + if len(v.RowsLayout) > 0 { + ok := object.Key("RowsLayout") + ok.String(string(v.RowsLayout)) + } + if len(v.SingleMetricVisibility) > 0 { ok := object.Key("SingleMetricVisibility") ok.String(string(v.SingleMetricVisibility)) @@ -28032,6 +28049,23 @@ func awsRestjson1_serializeDocumentPivotTablePaginatedReportOptions(v *types.Piv return nil } +func awsRestjson1_serializeDocumentPivotTableRowsLabelOptions(v *types.PivotTableRowsLabelOptions, value smithyjson.Value) error { + object := value.Object() + defer object.Close() + + if v.CustomLabel != nil { + ok := object.Key("CustomLabel") + ok.String(*v.CustomLabel) + } + + if len(v.Visibility) > 0 { + ok := object.Key("Visibility") + ok.String(string(v.Visibility)) + } + + return nil +} + func awsRestjson1_serializeDocumentPivotTableSortBy(v *types.PivotTableSortBy, value smithyjson.Value) error { object := value.Object() defer object.Close() @@ -29353,6 +29387,11 @@ func awsRestjson1_serializeDocumentRowAlternateColorOptions(v *types.RowAlternat ok.String(string(v.Status)) } + if len(v.UsePrimaryBackgroundColor) > 0 { + ok := object.Key("UsePrimaryBackgroundColor") + ok.String(string(v.UsePrimaryBackgroundColor)) + } + return nil } @@ -31399,6 +31438,13 @@ func awsRestjson1_serializeDocumentSubtotalOptions(v *types.SubtotalOptions, val } } + if v.StyleTargets != nil { + ok := object.Key("StyleTargets") + if err := awsRestjson1_serializeDocumentTableStyleTargetList(v.StyleTargets, ok); err != nil { + return err + } + } + if v.TotalCellStyle != nil { ok := object.Key("TotalCellStyle") if err := awsRestjson1_serializeDocumentTableCellStyle(v.TotalCellStyle, ok); err != nil { @@ -32024,6 +32070,31 @@ func awsRestjson1_serializeDocumentTableSortConfiguration(v *types.TableSortConf return nil } +func awsRestjson1_serializeDocumentTableStyleTarget(v *types.TableStyleTarget, value smithyjson.Value) error { + object := value.Object() + defer object.Close() + + if len(v.CellType) > 0 { + ok := object.Key("CellType") + ok.String(string(v.CellType)) + } + + return nil +} + +func awsRestjson1_serializeDocumentTableStyleTargetList(v []types.TableStyleTarget, value smithyjson.Value) error { + array := value.Array() + defer array.Close() + + for i := range v { + av := array.Value() + if err := awsRestjson1_serializeDocumentTableStyleTarget(&v[i], av); err != nil { + return err + } + } + return nil +} + func awsRestjson1_serializeDocumentTableUnaggregatedFieldWells(v *types.TableUnaggregatedFieldWells, value smithyjson.Value) error { object := value.Object() defer object.Close() @@ -32940,6 +33011,11 @@ func awsRestjson1_serializeDocumentTopicCalculatedField(v *types.TopicCalculated ok.Boolean(v.NeverAggregateInFilter) } + if v.NonAdditive != nil { + ok := object.Key("NonAdditive") + ok.Boolean(*v.NonAdditive) + } + if v.NotAllowedAggregations != nil { ok := object.Key("NotAllowedAggregations") if err := awsRestjson1_serializeDocumentAuthorSpecifiedAggregations(v.NotAllowedAggregations, ok); err != nil { @@ -33107,6 +33183,11 @@ func awsRestjson1_serializeDocumentTopicColumn(v *types.TopicColumn, value smith ok.Boolean(v.NeverAggregateInFilter) } + if v.NonAdditive != nil { + ok := object.Key("NonAdditive") + ok.Boolean(*v.NonAdditive) + } + if v.NotAllowedAggregations != nil { ok := object.Key("NotAllowedAggregations") if err := awsRestjson1_serializeDocumentAuthorSpecifiedAggregations(v.NotAllowedAggregations, ok); err != nil { diff --git a/service/quicksight/types/enums.go b/service/quicksight/types/enums.go index e431500431c..3c4cad20d53 100644 --- a/service/quicksight/types/enums.go +++ b/service/quicksight/types/enums.go @@ -388,9 +388,10 @@ type AuthenticationMethodOption string // Enum values for AuthenticationMethodOption const ( - AuthenticationMethodOptionIamAndQuicksight AuthenticationMethodOption = "IAM_AND_QUICKSIGHT" - AuthenticationMethodOptionIamOnly AuthenticationMethodOption = "IAM_ONLY" - AuthenticationMethodOptionActiveDirectory AuthenticationMethodOption = "ACTIVE_DIRECTORY" + AuthenticationMethodOptionIamAndQuicksight AuthenticationMethodOption = "IAM_AND_QUICKSIGHT" + AuthenticationMethodOptionIamOnly AuthenticationMethodOption = "IAM_ONLY" + AuthenticationMethodOptionActiveDirectory AuthenticationMethodOption = "ACTIVE_DIRECTORY" + AuthenticationMethodOptionIamIdentityCenter AuthenticationMethodOption = "IAM_IDENTITY_CENTER" ) // Values returns all known values for AuthenticationMethodOption. Note that this @@ -401,6 +402,7 @@ func (AuthenticationMethodOption) Values() []AuthenticationMethodOption { "IAM_AND_QUICKSIGHT", "IAM_ONLY", "ACTIVE_DIRECTORY", + "IAM_IDENTITY_CENTER", } } @@ -1307,6 +1309,11 @@ const ( DefaultAggregationCount DefaultAggregation = "COUNT" DefaultAggregationDistinctCount DefaultAggregation = "DISTINCT_COUNT" DefaultAggregationAverage DefaultAggregation = "AVERAGE" + DefaultAggregationMedian DefaultAggregation = "MEDIAN" + DefaultAggregationStdev DefaultAggregation = "STDEV" + DefaultAggregationStdevp DefaultAggregation = "STDEVP" + DefaultAggregationVar DefaultAggregation = "VAR" + DefaultAggregationVarp DefaultAggregation = "VARP" ) // Values returns all known values for DefaultAggregation. Note that this can be @@ -1320,6 +1327,11 @@ func (DefaultAggregation) Values() []DefaultAggregation { "COUNT", "DISTINCT_COUNT", "AVERAGE", + "MEDIAN", + "STDEV", + "STDEVP", + "VAR", + "VARP", } } @@ -1888,8 +1900,9 @@ type IdentityType string // Enum values for IdentityType const ( - IdentityTypeIam IdentityType = "IAM" - IdentityTypeQuicksight IdentityType = "QUICKSIGHT" + IdentityTypeIam IdentityType = "IAM" + IdentityTypeQuicksight IdentityType = "QUICKSIGHT" + IdentityTypeIamIdentityCenter IdentityType = "IAM_IDENTITY_CENTER" ) // Values returns all known values for IdentityType. Note that this can be @@ -1899,6 +1912,7 @@ func (IdentityType) Values() []IdentityType { return []IdentityType{ "IAM", "QUICKSIGHT", + "IAM_IDENTITY_CENTER", } } @@ -2811,6 +2825,24 @@ func (PivotTableMetricPlacement) Values() []PivotTableMetricPlacement { } } +type PivotTableRowsLayout string + +// Enum values for PivotTableRowsLayout +const ( + PivotTableRowsLayoutTabular PivotTableRowsLayout = "TABULAR" + PivotTableRowsLayoutHierarchy PivotTableRowsLayout = "HIERARCHY" +) + +// Values returns all known values for PivotTableRowsLayout. Note that this can be +// expanded in the future, and so it is only as up to date as the client. The +// ordering of this slice is not guaranteed to be stable across updates. +func (PivotTableRowsLayout) Values() []PivotTableRowsLayout { + return []PivotTableRowsLayout{ + "TABULAR", + "HIERARCHY", + } +} + type PivotTableSubtotalLevel string // Enum values for PivotTableSubtotalLevel @@ -3509,6 +3541,26 @@ func (Status) Values() []Status { } } +type StyledCellType string + +// Enum values for StyledCellType +const ( + StyledCellTypeTotal StyledCellType = "TOTAL" + StyledCellTypeMetricHeader StyledCellType = "METRIC_HEADER" + StyledCellTypeValue StyledCellType = "VALUE" +) + +// Values returns all known values for StyledCellType. Note that this can be +// expanded in the future, and so it is only as up to date as the client. The +// ordering of this slice is not guaranteed to be stable across updates. +func (StyledCellType) Values() []StyledCellType { + return []StyledCellType{ + "TOTAL", + "METRIC_HEADER", + "VALUE", + } +} + type TableBorderStyle string // Enum values for TableBorderStyle @@ -4020,6 +4072,7 @@ const ( VerticalTextAlignmentTop VerticalTextAlignment = "TOP" VerticalTextAlignmentMiddle VerticalTextAlignment = "MIDDLE" VerticalTextAlignmentBottom VerticalTextAlignment = "BOTTOM" + VerticalTextAlignmentAuto VerticalTextAlignment = "AUTO" ) // Values returns all known values for VerticalTextAlignment. Note that this can @@ -4030,6 +4083,7 @@ func (VerticalTextAlignment) Values() []VerticalTextAlignment { "TOP", "MIDDLE", "BOTTOM", + "AUTO", } } diff --git a/service/quicksight/types/types.go b/service/quicksight/types/types.go index d359fbbe96c..278b8b73647 100644 --- a/service/quicksight/types/types.go +++ b/service/quicksight/types/types.go @@ -44,6 +44,9 @@ type AccountInfo struct { // The edition of your Amazon QuickSight account. Edition Edition + // The Amazon Resource Name (ARN) for the IAM Identity Center instance. + IAMIdentityCenterInstanceArn *string + // The email address that will be used for Amazon QuickSight to send notifications // regarding your Amazon Web Services account or Amazon QuickSight subscription. NotificationEmail *string @@ -9002,6 +9005,9 @@ type PivotTableOptions struct { // The visibility of the column names. ColumnNamesVisibility Visibility + // The default cell width of the pivot table. + DefaultCellWidth *string + // The metric placement (row, column) options. MetricPlacement PivotTableMetricPlacement @@ -9014,6 +9020,17 @@ type PivotTableOptions struct { // The table cell style of the row headers. RowHeaderStyle *TableCellStyle + // The options for the label that is located above the row headers. This option is + // only applicable when RowsLayout is set to HIERARCHY . + RowsLabelOptions *PivotTableRowsLabelOptions + + // The layout for the row dimension headers of a pivot table. Choose one of the + // following options. + // - TABULAR : (Default) Each row field is displayed in a separate column. + // - HIERARCHY : All row fields are displayed in a single column. Indentation is + // used to differentiate row headers of different fields. + RowsLayout PivotTableRowsLayout + // The visibility of the single metric options. SingleMetricVisibility Visibility @@ -9035,6 +9052,19 @@ type PivotTablePaginatedReportOptions struct { noSmithyDocumentSerde } +// The options for the label thta is located above the row headers. This option is +// only applicable when RowsLayout is set to HIERARCHY . +type PivotTableRowsLabelOptions struct { + + // The custom label string for the rows label. + CustomLabel *string + + // The visibility of the rows label. + Visibility Visibility + + noSmithyDocumentSerde +} + // The sort by field for the field sort options. type PivotTableSortBy struct { @@ -9949,6 +9979,9 @@ type RowAlternateColorOptions struct { // Determines the widget status. Status WidgetStatus + // The primary background color options for alternate rows. + UsePrimaryBackgroundColor WidgetStatus + noSmithyDocumentSerde } @@ -10950,7 +10983,7 @@ type SnapshotDestinationConfiguration struct { // generate. This information is provided by you when you start a new snapshot job. type SnapshotFile struct { - // The format of the snapshot file to be generated. You can choose between CSV and + // The format of the snapshot file to be generated. You can choose between CSV or // PDF . // // This member is required. @@ -10993,14 +11026,14 @@ type SnapshotFileSheetSelection struct { SelectionScope SnapshotFileSheetSelectionScope // The sheet ID of the dashboard to generate the snapshot artifact from. This - // value is required for CSV or PDF format types. + // value is required for CSV and PDF format types. // // This member is required. SheetId *string - // A structure that lists the IDs of the visuals in the selected sheet. Supported - // visual types are table, pivot table visuals. This value is required if you are - // generating a CSV. This value supports a maximum of 1 visual ID. + // A list of visual IDs that are located in the selected sheet. This structure + // supports tables and pivot tables. This structure is required if you are + // generating a CSV. You can add a maximum of 1 visual ID to this structure. VisualIds []string noSmithyDocumentSerde @@ -11340,6 +11373,9 @@ type SubtotalOptions struct { // The cell styling options for the subtotals of header cells. MetricHeaderCellStyle *TableCellStyle + // The style targets options for subtotals. + StyleTargets []TableStyleTarget + // The cell styling options for the subtotal cells. TotalCellStyle *TableCellStyle @@ -11695,6 +11731,17 @@ type TableSortConfiguration struct { noSmithyDocumentSerde } +// The table style target. +type TableStyleTarget struct { + + // The cell type of the table style target. + // + // This member is required. + CellType StyledCellType + + noSmithyDocumentSerde +} + // The unaggregated field well for the table. type TableUnaggregatedFieldWells struct { @@ -12585,6 +12632,9 @@ type TopicCalculatedField struct { // filters. NeverAggregateInFilter bool + // The non additive for the table style target. + NonAdditive *bool + // The list of aggregation types that are not allowed for the calculated field. // Valid values for this structure are COUNT , DISTINCT_COUNT , MIN , MAX , MEDIAN // , SUM , AVERAGE , STDEV , STDEVP , VAR , VARP , and PERCENTILE . @@ -12646,8 +12696,6 @@ type TopicColumn struct { ColumnName *string // The type of aggregation that is performed on the column data when it's queried. - // Valid values for this structure are SUM , MAX , MIN , COUNT , DISTINCT_COUNT , - // and AVERAGE . Aggregation DefaultAggregation // The list of aggregation types that are allowed for the column. Valid values for @@ -12689,6 +12737,9 @@ type TopicColumn struct { // used in a filter context. NeverAggregateInFilter bool + // The non additive value for the column. + NonAdditive *bool + // The list of aggregation types that are not allowed for the column. Valid values // for this structure are COUNT , DISTINCT_COUNT , MIN , MAX , MEDIAN , SUM , // AVERAGE , STDEV , STDEVP , VAR , VARP , and PERCENTILE . diff --git a/service/quicksight/validators.go b/service/quicksight/validators.go index 26d4ff20895..3ac50d4c333 100644 --- a/service/quicksight/validators.go +++ b/service/quicksight/validators.go @@ -12020,6 +12020,11 @@ func validatePivotTableConfiguration(v *types.PivotTableConfiguration) error { invalidParams.AddNested("SortConfiguration", err.(smithy.InvalidParamsError)) } } + if v.TotalOptions != nil { + if err := validatePivotTableTotalOptions(v.TotalOptions); err != nil { + invalidParams.AddNested("TotalOptions", err.(smithy.InvalidParamsError)) + } + } if v.FieldOptions != nil { if err := validatePivotTableFieldOptions(v.FieldOptions); err != nil { invalidParams.AddNested("FieldOptions", err.(smithy.InvalidParamsError)) @@ -12258,6 +12263,28 @@ func validatePivotTableSortConfiguration(v *types.PivotTableSortConfiguration) e } } +func validatePivotTableTotalOptions(v *types.PivotTableTotalOptions) error { + if v == nil { + return nil + } + invalidParams := smithy.InvalidParamsError{Context: "PivotTableTotalOptions"} + if v.RowSubtotalOptions != nil { + if err := validateSubtotalOptions(v.RowSubtotalOptions); err != nil { + invalidParams.AddNested("RowSubtotalOptions", err.(smithy.InvalidParamsError)) + } + } + if v.ColumnSubtotalOptions != nil { + if err := validateSubtotalOptions(v.ColumnSubtotalOptions); err != nil { + invalidParams.AddNested("ColumnSubtotalOptions", err.(smithy.InvalidParamsError)) + } + } + if invalidParams.Len() > 0 { + return invalidParams + } else { + return nil + } +} + func validatePivotTableVisual(v *types.PivotTableVisual) error { if v == nil { return nil @@ -14367,6 +14394,23 @@ func validateStringParameterList(v []types.StringParameter) error { } } +func validateSubtotalOptions(v *types.SubtotalOptions) error { + if v == nil { + return nil + } + invalidParams := smithy.InvalidParamsError{Context: "SubtotalOptions"} + if v.StyleTargets != nil { + if err := validateTableStyleTargetList(v.StyleTargets); err != nil { + invalidParams.AddNested("StyleTargets", err.(smithy.InvalidParamsError)) + } + } + if invalidParams.Len() > 0 { + return invalidParams + } else { + return nil + } +} + func validateTableAggregatedFieldWells(v *types.TableAggregatedFieldWells) error { if v == nil { return nil @@ -14722,6 +14766,38 @@ func validateTableSortConfiguration(v *types.TableSortConfiguration) error { } } +func validateTableStyleTarget(v *types.TableStyleTarget) error { + if v == nil { + return nil + } + invalidParams := smithy.InvalidParamsError{Context: "TableStyleTarget"} + if len(v.CellType) == 0 { + invalidParams.Add(smithy.NewErrParamRequired("CellType")) + } + if invalidParams.Len() > 0 { + return invalidParams + } else { + return nil + } +} + +func validateTableStyleTargetList(v []types.TableStyleTarget) error { + if v == nil { + return nil + } + invalidParams := smithy.InvalidParamsError{Context: "TableStyleTargetList"} + for i := range v { + if err := validateTableStyleTarget(&v[i]); err != nil { + invalidParams.AddNested(fmt.Sprintf("[%d]", i), err.(smithy.InvalidParamsError)) + } + } + if invalidParams.Len() > 0 { + return invalidParams + } else { + return nil + } +} + func validateTableUnaggregatedFieldWells(v *types.TableUnaggregatedFieldWells) error { if v == nil { return nil diff --git a/service/ses/api_op_CloneReceiptRuleSet.go b/service/ses/api_op_CloneReceiptRuleSet.go index 1a412e61170..205cc97db4b 100644 --- a/service/ses/api_op_CloneReceiptRuleSet.go +++ b/service/ses/api_op_CloneReceiptRuleSet.go @@ -18,7 +18,7 @@ import ( // Creates a receipt rule set by cloning an existing one. All receipt rules and // configurations are copied to the new receipt rule set and are completely // independent of the source rule set. For information about setting up rule sets, -// see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rule-set.html) +// see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html#receiving-email-concepts-rules) // . You can execute this operation no more than once per second. func (c *Client) CloneReceiptRuleSet(ctx context.Context, params *CloneReceiptRuleSetInput, optFns ...func(*Options)) (*CloneReceiptRuleSetOutput, error) { if params == nil { @@ -37,7 +37,7 @@ func (c *Client) CloneReceiptRuleSet(ctx context.Context, params *CloneReceiptRu // Represents a request to create a receipt rule set by cloning an existing one. // You use receipt rule sets to receive email with Amazon SES. For more -// information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-concepts.html) +// information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html) // . type CloneReceiptRuleSetInput struct { @@ -46,11 +46,12 @@ type CloneReceiptRuleSetInput struct { // This member is required. OriginalRuleSetName *string - // The name of the rule set to create. The name must: - // - This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), - // underscores (_), or dashes (-). + // The name of the rule set to create. The name must meet the following + // requirements: + // - Contain only ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), or + // dashes (-). // - Start and end with a letter or number. - // - Contain less than 64 characters. + // - Contain 64 characters or fewer. // // This member is required. RuleSetName *string diff --git a/service/ses/api_op_CreateConfigurationSet.go b/service/ses/api_op_CreateConfigurationSet.go index 89678f7a07d..1e461ea7fc5 100644 --- a/service/ses/api_op_CreateConfigurationSet.go +++ b/service/ses/api_op_CreateConfigurationSet.go @@ -18,7 +18,7 @@ import ( // Creates a configuration set. Configuration sets enable you to publish email // sending events. For information about using configuration sets, see the Amazon -// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . You can execute this operation no more than once per second. func (c *Client) CreateConfigurationSet(ctx context.Context, params *CreateConfigurationSetInput, optFns ...func(*Options)) (*CreateConfigurationSetOutput, error) { if params == nil { @@ -37,7 +37,7 @@ func (c *Client) CreateConfigurationSet(ctx context.Context, params *CreateConfi // Represents a request to create a configuration set. Configuration sets enable // you to publish email sending events. For information about using configuration -// sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . type CreateConfigurationSetInput struct { diff --git a/service/ses/api_op_CreateConfigurationSetEventDestination.go b/service/ses/api_op_CreateConfigurationSetEventDestination.go index 0e813b6f1e8..6b9fb7e792a 100644 --- a/service/ses/api_op_CreateConfigurationSetEventDestination.go +++ b/service/ses/api_op_CreateConfigurationSetEventDestination.go @@ -19,10 +19,10 @@ import ( // Creates a configuration set event destination. When you create or update an // event destination, you must provide one, and only one, destination. The // destination can be CloudWatch, Amazon Kinesis Firehose, or Amazon Simple -// Notification Service (Amazon SNS). An event destination is the AWS service to -// which Amazon SES publishes the email sending events associated with a -// configuration set. For information about using configuration sets, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// Notification Service (Amazon SNS). An event destination is the Amazon Web +// Services service to which Amazon SES publishes the email sending events +// associated with a configuration set. For information about using configuration +// sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . You can execute this operation no more than once per second. func (c *Client) CreateConfigurationSetEventDestination(ctx context.Context, params *CreateConfigurationSetEventDestinationInput, optFns ...func(*Options)) (*CreateConfigurationSetEventDestinationOutput, error) { if params == nil { @@ -41,9 +41,10 @@ func (c *Client) CreateConfigurationSetEventDestination(ctx context.Context, par // Represents a request to create a configuration set event destination. A // configuration set event destination, which can be either Amazon CloudWatch or -// Amazon Kinesis Firehose, describes an AWS service in which Amazon SES publishes -// the email sending events associated with a configuration set. For information -// about using configuration sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// Amazon Kinesis Firehose, describes an Amazon Web Services service in which +// Amazon SES publishes the email sending events associated with a configuration +// set. For information about using configuration sets, see the Amazon SES +// Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . type CreateConfigurationSetEventDestinationInput struct { @@ -53,8 +54,8 @@ type CreateConfigurationSetEventDestinationInput struct { // This member is required. ConfigurationSetName *string - // An object that describes the AWS service that email sending event information - // will be published to. + // An object that describes the Amazon Web Services service that email sending + // event where information is published. // // This member is required. EventDestination *types.EventDestination diff --git a/service/ses/api_op_CreateConfigurationSetTrackingOptions.go b/service/ses/api_op_CreateConfigurationSetTrackingOptions.go index 91fbe16220c..cb1c6172588 100644 --- a/service/ses/api_op_CreateConfigurationSetTrackingOptions.go +++ b/service/ses/api_op_CreateConfigurationSetTrackingOptions.go @@ -20,7 +20,7 @@ import ( // and click event tracking. By default, images and links used for tracking open // and click events are hosted on domains operated by Amazon SES. You can configure // a subdomain of your own to handle these events. For information about using -// custom domains, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/configure-custom-open-click-domains.html) +// custom domains, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/configure-custom-open-click-domains.html) // . func (c *Client) CreateConfigurationSetTrackingOptions(ctx context.Context, params *CreateConfigurationSetTrackingOptionsInput, optFns ...func(*Options)) (*CreateConfigurationSetTrackingOptionsOutput, error) { if params == nil { @@ -50,7 +50,7 @@ type CreateConfigurationSetTrackingOptionsInput struct { // A domain that is used to redirect email recipients to an Amazon SES-operated // domain. This domain captures open and click events generated by Amazon SES // emails. For more information, see Configuring Custom Domains to Handle Open and - // Click Tracking (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/configure-custom-open-click-domains.html) + // Click Tracking (https://docs.aws.amazon.com/ses/latest/dg/configure-custom-open-click-domains.html) // in the Amazon SES Developer Guide. // // This member is required. diff --git a/service/ses/api_op_CreateCustomVerificationEmailTemplate.go b/service/ses/api_op_CreateCustomVerificationEmailTemplate.go index 8f3ec6c9574..a74b382e82a 100644 --- a/service/ses/api_op_CreateCustomVerificationEmailTemplate.go +++ b/service/ses/api_op_CreateCustomVerificationEmailTemplate.go @@ -17,7 +17,7 @@ import ( // Creates a new custom verification email template. For more information about // custom verification email templates, see Using Custom Verification Email -// Templates (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/custom-verification-emails.html) +// Templates (https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#send-email-verify-address-custom) // in the Amazon SES Developer Guide. You can execute this operation no more than // once per second. func (c *Client) CreateCustomVerificationEmailTemplate(ctx context.Context, params *CreateCustomVerificationEmailTemplateInput, optFns ...func(*Options)) (*CreateCustomVerificationEmailTemplateOutput, error) { @@ -57,7 +57,7 @@ type CreateCustomVerificationEmailTemplateInput struct { // The content of the custom verification email. The total size of the email must // be less than 10 MB. The message body may contain HTML, with some limitations. - // For more information, see Custom Verification Email Frequently Asked Questions (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/custom-verification-emails.html#custom-verification-emails-faq) + // For more information, see Custom Verification Email Frequently Asked Questions (https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#send-email-verify-address-custom) // in the Amazon SES Developer Guide. // // This member is required. diff --git a/service/ses/api_op_CreateReceiptFilter.go b/service/ses/api_op_CreateReceiptFilter.go index 67e082bd51e..c850cf3bb6a 100644 --- a/service/ses/api_op_CreateReceiptFilter.go +++ b/service/ses/api_op_CreateReceiptFilter.go @@ -17,7 +17,7 @@ import ( ) // Creates a new IP address filter. For information about setting up IP address -// filters, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-ip-filters.html) +// filters, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-ip-filtering-console-walkthrough.html) // . You can execute this operation no more than once per second. func (c *Client) CreateReceiptFilter(ctx context.Context, params *CreateReceiptFilterInput, optFns ...func(*Options)) (*CreateReceiptFilterOutput, error) { if params == nil { @@ -36,7 +36,7 @@ func (c *Client) CreateReceiptFilter(ctx context.Context, params *CreateReceiptF // Represents a request to create a new IP address filter. You use IP address // filters when you receive email with Amazon SES. For more information, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-concepts.html) +// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html) // . type CreateReceiptFilterInput struct { diff --git a/service/ses/api_op_CreateReceiptRule.go b/service/ses/api_op_CreateReceiptRule.go index 41acdde62c3..32fd06f9c86 100644 --- a/service/ses/api_op_CreateReceiptRule.go +++ b/service/ses/api_op_CreateReceiptRule.go @@ -17,7 +17,7 @@ import ( ) // Creates a receipt rule. For information about setting up receipt rules, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rules.html) +// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-receipt-rules-console-walkthrough.html) // . You can execute this operation no more than once per second. func (c *Client) CreateReceiptRule(ctx context.Context, params *CreateReceiptRuleInput, optFns ...func(*Options)) (*CreateReceiptRuleOutput, error) { if params == nil { @@ -35,7 +35,7 @@ func (c *Client) CreateReceiptRule(ctx context.Context, params *CreateReceiptRul } // Represents a request to create a receipt rule. You use receipt rules to receive -// email with Amazon SES. For more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-concepts.html) +// email with Amazon SES. For more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html) // . type CreateReceiptRuleInput struct { @@ -45,14 +45,13 @@ type CreateReceiptRuleInput struct { // This member is required. Rule *types.ReceiptRule - // The name of the rule set that the receipt rule will be added to. + // The name of the rule set where the receipt rule is added. // // This member is required. RuleSetName *string - // The name of an existing rule after which the new rule will be placed. If this - // parameter is null, the new rule will be inserted at the beginning of the rule - // list. + // The name of an existing rule after which the new rule is placed. If this + // parameter is null, the new rule is inserted at the beginning of the rule list. After *string noSmithyDocumentSerde diff --git a/service/ses/api_op_CreateReceiptRuleSet.go b/service/ses/api_op_CreateReceiptRuleSet.go index 53be43691df..01afb06296f 100644 --- a/service/ses/api_op_CreateReceiptRuleSet.go +++ b/service/ses/api_op_CreateReceiptRuleSet.go @@ -16,7 +16,7 @@ import ( ) // Creates an empty receipt rule set. For information about setting up receipt -// rule sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rule-set.html) +// rule sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html#receiving-email-concepts-rules) // . You can execute this operation no more than once per second. func (c *Client) CreateReceiptRuleSet(ctx context.Context, params *CreateReceiptRuleSetInput, optFns ...func(*Options)) (*CreateReceiptRuleSetOutput, error) { if params == nil { @@ -35,15 +35,16 @@ func (c *Client) CreateReceiptRuleSet(ctx context.Context, params *CreateReceipt // Represents a request to create an empty receipt rule set. You use receipt rule // sets to receive email with Amazon SES. For more information, see the Amazon SES -// Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-concepts.html) +// Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html) // . type CreateReceiptRuleSetInput struct { - // The name of the rule set to create. The name must: - // - This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), - // underscores (_), or dashes (-). + // The name of the rule set to create. The name must meet the following + // requirements: + // - Contain only ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), or + // dashes (-). // - Start and end with a letter or number. - // - Contain less than 64 characters. + // - Contain 64 characters or fewer. // // This member is required. RuleSetName *string diff --git a/service/ses/api_op_CreateTemplate.go b/service/ses/api_op_CreateTemplate.go index 68142813096..0c92aed07d3 100644 --- a/service/ses/api_op_CreateTemplate.go +++ b/service/ses/api_op_CreateTemplate.go @@ -17,8 +17,8 @@ import ( ) // Creates an email template. Email templates enable you to send personalized -// email to one or more destinations in a single API operation. For more -// information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-personalized-email-api.html) +// email to one or more destinations in a single operation. For more information, +// see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/send-personalized-email-api.html) // . You can execute this operation no more than once per second. func (c *Client) CreateTemplate(ctx context.Context, params *CreateTemplateInput, optFns ...func(*Options)) (*CreateTemplateOutput, error) { if params == nil { @@ -36,12 +36,12 @@ func (c *Client) CreateTemplate(ctx context.Context, params *CreateTemplateInput } // Represents a request to create an email template. For more information, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-personalized-email-api.html) +// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/send-personalized-email-api.html) // . type CreateTemplateInput struct { - // The content of the email, composed of a subject line, an HTML part, and a - // text-only part. + // The content of the email, composed of a subject line and either an HTML part or + // a text-only part. // // This member is required. Template *types.Template diff --git a/service/ses/api_op_DeleteConfigurationSet.go b/service/ses/api_op_DeleteConfigurationSet.go index 8fddd2daf74..f523585fcf1 100644 --- a/service/ses/api_op_DeleteConfigurationSet.go +++ b/service/ses/api_op_DeleteConfigurationSet.go @@ -17,7 +17,7 @@ import ( // Deletes a configuration set. Configuration sets enable you to publish email // sending events. For information about using configuration sets, see the Amazon -// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . You can execute this operation no more than once per second. func (c *Client) DeleteConfigurationSet(ctx context.Context, params *DeleteConfigurationSetInput, optFns ...func(*Options)) (*DeleteConfigurationSetOutput, error) { if params == nil { @@ -36,7 +36,7 @@ func (c *Client) DeleteConfigurationSet(ctx context.Context, params *DeleteConfi // Represents a request to delete a configuration set. Configuration sets enable // you to publish email sending events. For information about using configuration -// sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . type DeleteConfigurationSetInput struct { diff --git a/service/ses/api_op_DeleteConfigurationSetEventDestination.go b/service/ses/api_op_DeleteConfigurationSetEventDestination.go index 1ec154bf6e6..cd936ddbb66 100644 --- a/service/ses/api_op_DeleteConfigurationSetEventDestination.go +++ b/service/ses/api_op_DeleteConfigurationSetEventDestination.go @@ -18,7 +18,7 @@ import ( // Deletes a configuration set event destination. Configuration set event // destinations are associated with configuration sets, which enable you to publish // email sending events. For information about using configuration sets, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . You can execute this operation no more than once per second. func (c *Client) DeleteConfigurationSetEventDestination(ctx context.Context, params *DeleteConfigurationSetEventDestinationInput, optFns ...func(*Options)) (*DeleteConfigurationSetEventDestinationOutput, error) { if params == nil { @@ -38,7 +38,7 @@ func (c *Client) DeleteConfigurationSetEventDestination(ctx context.Context, par // Represents a request to delete a configuration set event destination. // Configuration set event destinations are associated with configuration sets, // which enable you to publish email sending events. For information about using -// configuration sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// configuration sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . type DeleteConfigurationSetEventDestinationInput struct { diff --git a/service/ses/api_op_DeleteConfigurationSetTrackingOptions.go b/service/ses/api_op_DeleteConfigurationSetTrackingOptions.go index a5038299410..1c5d306ab0a 100644 --- a/service/ses/api_op_DeleteConfigurationSetTrackingOptions.go +++ b/service/ses/api_op_DeleteConfigurationSetTrackingOptions.go @@ -19,10 +19,10 @@ import ( // and click event tracking. By default, images and links used for tracking open // and click events are hosted on domains operated by Amazon SES. You can configure // a subdomain of your own to handle these events. For information about using -// custom domains, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/configure-custom-open-click-domains.html) -// . Deleting this kind of association will result in emails sent using the -// specified configuration set to capture open and click events using the standard, -// Amazon SES-operated domains. +// custom domains, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/configure-custom-open-click-domains.html) +// . Deleting this kind of association results in emails sent using the specified +// configuration set to capture open and click events using the standard, Amazon +// SES-operated domains. func (c *Client) DeleteConfigurationSetTrackingOptions(ctx context.Context, params *DeleteConfigurationSetTrackingOptionsInput, optFns ...func(*Options)) (*DeleteConfigurationSetTrackingOptionsOutput, error) { if params == nil { params = &DeleteConfigurationSetTrackingOptionsInput{} @@ -42,8 +42,7 @@ func (c *Client) DeleteConfigurationSetTrackingOptions(ctx context.Context, para // configuration set. type DeleteConfigurationSetTrackingOptionsInput struct { - // The name of the configuration set from which you want to delete the tracking - // options. + // The name of the configuration set. // // This member is required. ConfigurationSetName *string diff --git a/service/ses/api_op_DeleteCustomVerificationEmailTemplate.go b/service/ses/api_op_DeleteCustomVerificationEmailTemplate.go index 4abea39a4ec..8df9de01643 100644 --- a/service/ses/api_op_DeleteCustomVerificationEmailTemplate.go +++ b/service/ses/api_op_DeleteCustomVerificationEmailTemplate.go @@ -17,7 +17,7 @@ import ( // Deletes an existing custom verification email template. For more information // about custom verification email templates, see Using Custom Verification Email -// Templates (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/custom-verification-emails.html) +// Templates (https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#send-email-verify-address-custom) // in the Amazon SES Developer Guide. You can execute this operation no more than // once per second. func (c *Client) DeleteCustomVerificationEmailTemplate(ctx context.Context, params *DeleteCustomVerificationEmailTemplateInput, optFns ...func(*Options)) (*DeleteCustomVerificationEmailTemplateOutput, error) { @@ -38,7 +38,7 @@ func (c *Client) DeleteCustomVerificationEmailTemplate(ctx context.Context, para // Represents a request to delete an existing custom verification email template. type DeleteCustomVerificationEmailTemplateInput struct { - // The name of the custom verification email template that you want to delete. + // The name of the custom verification email template to delete. // // This member is required. TemplateName *string diff --git a/service/ses/api_op_DeleteIdentity.go b/service/ses/api_op_DeleteIdentity.go index 46a1865f4b9..b8cfd58a35f 100644 --- a/service/ses/api_op_DeleteIdentity.go +++ b/service/ses/api_op_DeleteIdentity.go @@ -37,7 +37,8 @@ func (c *Client) DeleteIdentity(ctx context.Context, params *DeleteIdentityInput // address or domain). type DeleteIdentityInput struct { - // The identity to be removed from the list of identities for the AWS Account. + // The identity to be removed from the list of identities for the Amazon Web + // Services account. // // This member is required. Identity *string diff --git a/service/ses/api_op_DeleteIdentityPolicy.go b/service/ses/api_op_DeleteIdentityPolicy.go index b823ef52848..bfe633b1535 100644 --- a/service/ses/api_op_DeleteIdentityPolicy.go +++ b/service/ses/api_op_DeleteIdentityPolicy.go @@ -16,12 +16,12 @@ import ( ) // Deletes the specified sending authorization policy for the given identity (an -// email address or a domain). This API returns successfully even if a policy with -// the specified name does not exist. This API is for the identity owner only. If -// you have not verified the identity, this API will return an error. Sending +// email address or a domain). This operation returns successfully even if a policy +// with the specified name does not exist. This operation is for the identity owner +// only. If you have not verified the identity, it returns an error. Sending // authorization is a feature that enables an identity owner to authorize other // senders to use its identities. For information about using sending -// authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) +// authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . You can execute this operation no more than once per second. func (c *Client) DeleteIdentityPolicy(ctx context.Context, params *DeleteIdentityPolicyInput, optFns ...func(*Options)) (*DeleteIdentityPolicyOutput, error) { if params == nil { @@ -41,15 +41,15 @@ func (c *Client) DeleteIdentityPolicy(ctx context.Context, params *DeleteIdentit // Represents a request to delete a sending authorization policy for an identity. // Sending authorization is an Amazon SES feature that enables you to authorize // other senders to use your identities. For information, see the Amazon SES -// Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) +// Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . type DeleteIdentityPolicyInput struct { - // The identity that is associated with the policy that you want to delete. You - // can specify the identity by using its name or by using its Amazon Resource Name - // (ARN). Examples: user@example.com , example.com , + // The identity that is associated with the policy to delete. You can specify the + // identity by using its name or by using its Amazon Resource Name (ARN). Examples: + // user@example.com , example.com , // arn:aws:ses:us-east-1:123456789012:identity/example.com . To successfully call - // this API, you must own the identity. + // this operation, you must own the identity. // // This member is required. Identity *string diff --git a/service/ses/api_op_DeleteReceiptFilter.go b/service/ses/api_op_DeleteReceiptFilter.go index 9c980069e39..91790a270a5 100644 --- a/service/ses/api_op_DeleteReceiptFilter.go +++ b/service/ses/api_op_DeleteReceiptFilter.go @@ -16,7 +16,7 @@ import ( ) // Deletes the specified IP address filter. For information about managing IP -// address filters, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-ip-filters.html) +// address filters, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-ip-filtering-console-walkthrough.html) // . You can execute this operation no more than once per second. func (c *Client) DeleteReceiptFilter(ctx context.Context, params *DeleteReceiptFilterInput, optFns ...func(*Options)) (*DeleteReceiptFilterOutput, error) { if params == nil { @@ -35,7 +35,7 @@ func (c *Client) DeleteReceiptFilter(ctx context.Context, params *DeleteReceiptF // Represents a request to delete an IP address filter. You use IP address filters // when you receive email with Amazon SES. For more information, see the Amazon -// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-concepts.html) +// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html) // . type DeleteReceiptFilterInput struct { diff --git a/service/ses/api_op_DeleteReceiptRule.go b/service/ses/api_op_DeleteReceiptRule.go index a2dc28596d6..81448a19a89 100644 --- a/service/ses/api_op_DeleteReceiptRule.go +++ b/service/ses/api_op_DeleteReceiptRule.go @@ -16,7 +16,7 @@ import ( ) // Deletes the specified receipt rule. For information about managing receipt -// rules, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rules.html) +// rules, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-receipt-rules-console-walkthrough.html) // . You can execute this operation no more than once per second. func (c *Client) DeleteReceiptRule(ctx context.Context, params *DeleteReceiptRuleInput, optFns ...func(*Options)) (*DeleteReceiptRuleOutput, error) { if params == nil { @@ -34,7 +34,7 @@ func (c *Client) DeleteReceiptRule(ctx context.Context, params *DeleteReceiptRul } // Represents a request to delete a receipt rule. You use receipt rules to receive -// email with Amazon SES. For more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-concepts.html) +// email with Amazon SES. For more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html) // . type DeleteReceiptRuleInput struct { diff --git a/service/ses/api_op_DeleteReceiptRuleSet.go b/service/ses/api_op_DeleteReceiptRuleSet.go index 520f3c8baa4..154d1e87306 100644 --- a/service/ses/api_op_DeleteReceiptRuleSet.go +++ b/service/ses/api_op_DeleteReceiptRuleSet.go @@ -17,7 +17,7 @@ import ( // Deletes the specified receipt rule set and all of the receipt rules it // contains. The currently active rule set cannot be deleted. For information about -// managing receipt rule sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rule-sets.html) +// managing receipt rule sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-receipt-rules-console-walkthrough.html) // . You can execute this operation no more than once per second. func (c *Client) DeleteReceiptRuleSet(ctx context.Context, params *DeleteReceiptRuleSetInput, optFns ...func(*Options)) (*DeleteReceiptRuleSetOutput, error) { if params == nil { @@ -36,7 +36,7 @@ func (c *Client) DeleteReceiptRuleSet(ctx context.Context, params *DeleteReceipt // Represents a request to delete a receipt rule set and all of the receipt rules // it contains. You use receipt rule sets to receive email with Amazon SES. For -// more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-concepts.html) +// more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html) // . type DeleteReceiptRuleSetInput struct { diff --git a/service/ses/api_op_DeleteTemplate.go b/service/ses/api_op_DeleteTemplate.go index d61f4cd6ce8..ef752f0c64d 100644 --- a/service/ses/api_op_DeleteTemplate.go +++ b/service/ses/api_op_DeleteTemplate.go @@ -33,7 +33,7 @@ func (c *Client) DeleteTemplate(ctx context.Context, params *DeleteTemplateInput } // Represents a request to delete an email template. For more information, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-personalized-email-api.html) +// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/send-personalized-email-api.html) // . type DeleteTemplateInput struct { diff --git a/service/ses/api_op_DeleteVerifiedEmailAddress.go b/service/ses/api_op_DeleteVerifiedEmailAddress.go index 7f6c6710405..6084d063f19 100644 --- a/service/ses/api_op_DeleteVerifiedEmailAddress.go +++ b/service/ses/api_op_DeleteVerifiedEmailAddress.go @@ -33,7 +33,7 @@ func (c *Client) DeleteVerifiedEmailAddress(ctx context.Context, params *DeleteV } // Represents a request to delete an email address from the list of email -// addresses you have attempted to verify under your AWS account. +// addresses you have attempted to verify under your Amazon Web Services account. type DeleteVerifiedEmailAddressInput struct { // An email address to be removed from the list of verified addresses. diff --git a/service/ses/api_op_DescribeActiveReceiptRuleSet.go b/service/ses/api_op_DescribeActiveReceiptRuleSet.go index e78748fb251..fe4c64b1c64 100644 --- a/service/ses/api_op_DescribeActiveReceiptRuleSet.go +++ b/service/ses/api_op_DescribeActiveReceiptRuleSet.go @@ -18,7 +18,7 @@ import ( // Returns the metadata and receipt rules for the receipt rule set that is // currently active. For information about setting up receipt rule sets, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rule-set.html) +// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html#receiving-email-concepts-rules) // . You can execute this operation no more than once per second. func (c *Client) DescribeActiveReceiptRuleSet(ctx context.Context, params *DescribeActiveReceiptRuleSetInput, optFns ...func(*Options)) (*DescribeActiveReceiptRuleSetOutput, error) { if params == nil { @@ -37,7 +37,7 @@ func (c *Client) DescribeActiveReceiptRuleSet(ctx context.Context, params *Descr // Represents a request to return the metadata and receipt rules for the receipt // rule set that is currently active. You use receipt rule sets to receive email -// with Amazon SES. For more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-concepts.html) +// with Amazon SES. For more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html) // . type DescribeActiveReceiptRuleSetInput struct { noSmithyDocumentSerde diff --git a/service/ses/api_op_DescribeConfigurationSet.go b/service/ses/api_op_DescribeConfigurationSet.go index d03b4157e5c..e934bac10d5 100644 --- a/service/ses/api_op_DescribeConfigurationSet.go +++ b/service/ses/api_op_DescribeConfigurationSet.go @@ -17,7 +17,7 @@ import ( ) // Returns the details of the specified configuration set. For information about -// using configuration sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// using configuration sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . You can execute this operation no more than once per second. func (c *Client) DescribeConfigurationSet(ctx context.Context, params *DescribeConfigurationSetInput, optFns ...func(*Options)) (*DescribeConfigurationSetOutput, error) { if params == nil { @@ -36,7 +36,7 @@ func (c *Client) DescribeConfigurationSet(ctx context.Context, params *DescribeC // Represents a request to return the details of a configuration set. // Configuration sets enable you to publish email sending events. For information -// about using configuration sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// about using configuration sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . type DescribeConfigurationSetInput struct { @@ -53,7 +53,7 @@ type DescribeConfigurationSetInput struct { // Represents the details of a configuration set. Configuration sets enable you to // publish email sending events. For information about using configuration sets, -// see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . type DescribeConfigurationSetOutput struct { diff --git a/service/ses/api_op_DescribeReceiptRule.go b/service/ses/api_op_DescribeReceiptRule.go index 22312cbc334..aaf07b060a1 100644 --- a/service/ses/api_op_DescribeReceiptRule.go +++ b/service/ses/api_op_DescribeReceiptRule.go @@ -17,7 +17,7 @@ import ( ) // Returns the details of the specified receipt rule. For information about -// setting up receipt rules, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rules.html) +// setting up receipt rules, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-receipt-rules-console-walkthrough.html) // . You can execute this operation no more than once per second. func (c *Client) DescribeReceiptRule(ctx context.Context, params *DescribeReceiptRuleInput, optFns ...func(*Options)) (*DescribeReceiptRuleOutput, error) { if params == nil { @@ -36,7 +36,7 @@ func (c *Client) DescribeReceiptRule(ctx context.Context, params *DescribeReceip // Represents a request to return the details of a receipt rule. You use receipt // rules to receive email with Amazon SES. For more information, see the Amazon -// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-concepts.html) +// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html) // . type DescribeReceiptRuleInput struct { diff --git a/service/ses/api_op_DescribeReceiptRuleSet.go b/service/ses/api_op_DescribeReceiptRuleSet.go index 7a1a7f4e96d..2e5c6edc180 100644 --- a/service/ses/api_op_DescribeReceiptRuleSet.go +++ b/service/ses/api_op_DescribeReceiptRuleSet.go @@ -17,7 +17,7 @@ import ( ) // Returns the details of the specified receipt rule set. For information about -// managing receipt rule sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rule-sets.html) +// managing receipt rule sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-receipt-rules-console-walkthrough.html) // . You can execute this operation no more than once per second. func (c *Client) DescribeReceiptRuleSet(ctx context.Context, params *DescribeReceiptRuleSetInput, optFns ...func(*Options)) (*DescribeReceiptRuleSetOutput, error) { if params == nil { @@ -36,7 +36,7 @@ func (c *Client) DescribeReceiptRuleSet(ctx context.Context, params *DescribeRec // Represents a request to return the details of a receipt rule set. You use // receipt rule sets to receive email with Amazon SES. For more information, see -// the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-concepts.html) +// the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html) // . type DescribeReceiptRuleSetInput struct { diff --git a/service/ses/api_op_GetAccountSendingEnabled.go b/service/ses/api_op_GetAccountSendingEnabled.go index b83f1bfa9d0..e8cc4ee484a 100644 --- a/service/ses/api_op_GetAccountSendingEnabled.go +++ b/service/ses/api_op_GetAccountSendingEnabled.go @@ -16,7 +16,7 @@ import ( ) // Returns the email sending status of the Amazon SES account for the current -// region. You can execute this operation no more than once per second. +// Region. You can execute this operation no more than once per second. func (c *Client) GetAccountSendingEnabled(ctx context.Context, params *GetAccountSendingEnabledInput, optFns ...func(*Options)) (*GetAccountSendingEnabledOutput, error) { if params == nil { params = &GetAccountSendingEnabledInput{} @@ -37,11 +37,11 @@ type GetAccountSendingEnabledInput struct { } // Represents a request to return the email sending status for your Amazon SES -// account in the current AWS Region. +// account in the current Amazon Web Services Region. type GetAccountSendingEnabledOutput struct { // Describes whether email sending is enabled or disabled for your Amazon SES - // account in the current AWS Region. + // account in the current Amazon Web Services Region. Enabled bool // Metadata pertaining to the operation's result. diff --git a/service/ses/api_op_GetCustomVerificationEmailTemplate.go b/service/ses/api_op_GetCustomVerificationEmailTemplate.go index 56df3f56b29..c7f3431f916 100644 --- a/service/ses/api_op_GetCustomVerificationEmailTemplate.go +++ b/service/ses/api_op_GetCustomVerificationEmailTemplate.go @@ -17,7 +17,7 @@ import ( // Returns the custom email verification template for the template name you // specify. For more information about custom verification email templates, see -// Using Custom Verification Email Templates (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/custom-verification-emails.html) +// Using Custom Verification Email Templates (https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#send-email-verify-address-custom) // in the Amazon SES Developer Guide. You can execute this operation no more than // once per second. func (c *Client) GetCustomVerificationEmailTemplate(ctx context.Context, params *GetCustomVerificationEmailTemplateInput, optFns ...func(*Options)) (*GetCustomVerificationEmailTemplateOutput, error) { @@ -38,7 +38,7 @@ func (c *Client) GetCustomVerificationEmailTemplate(ctx context.Context, params // Represents a request to retrieve an existing custom verification email template. type GetCustomVerificationEmailTemplateInput struct { - // The name of the custom verification email template that you want to retrieve. + // The name of the custom verification email template to retrieve. // // This member is required. TemplateName *string diff --git a/service/ses/api_op_GetIdentityDkimAttributes.go b/service/ses/api_op_GetIdentityDkimAttributes.go index 912807083d9..091cdc3e2d6 100644 --- a/service/ses/api_op_GetIdentityDkimAttributes.go +++ b/service/ses/api_op_GetIdentityDkimAttributes.go @@ -30,7 +30,7 @@ import ( // // This operation is throttled at one request per second and can only get DKIM // attributes for up to 100 identities at a time. For more information about -// creating DNS records using DKIM tokens, go to the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim-dns-records.html) +// creating DNS records using DKIM tokens, go to the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/send-email-authentication-dkim-easy-managing.html) // . func (c *Client) GetIdentityDkimAttributes(ctx context.Context, params *GetIdentityDkimAttributesInput, optFns ...func(*Options)) (*GetIdentityDkimAttributesOutput, error) { if params == nil { @@ -51,7 +51,7 @@ func (c *Client) GetIdentityDkimAttributes(ctx context.Context, params *GetIdent // identity. For domain identities, this request also returns the DKIM tokens that // are required for Easy DKIM signing, and whether Amazon SES successfully verified // that these tokens were published. For more information about Easy DKIM, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html) +// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/send-email-authentication-dkim-easy.html) // . type GetIdentityDkimAttributesInput struct { diff --git a/service/ses/api_op_GetIdentityMailFromDomainAttributes.go b/service/ses/api_op_GetIdentityMailFromDomainAttributes.go index a6d9e909e10..7b09113d2b4 100644 --- a/service/ses/api_op_GetIdentityMailFromDomainAttributes.go +++ b/service/ses/api_op_GetIdentityMailFromDomainAttributes.go @@ -36,7 +36,7 @@ func (c *Client) GetIdentityMailFromDomainAttributes(ctx context.Context, params // Represents a request to return the Amazon SES custom MAIL FROM attributes for a // list of identities. For information about using a custom MAIL FROM domain, see -// the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/mail-from.html) +// the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/mail-from.html) // . type GetIdentityMailFromDomainAttributesInput struct { diff --git a/service/ses/api_op_GetIdentityNotificationAttributes.go b/service/ses/api_op_GetIdentityNotificationAttributes.go index f88f6f7a228..ca2100a8a95 100644 --- a/service/ses/api_op_GetIdentityNotificationAttributes.go +++ b/service/ses/api_op_GetIdentityNotificationAttributes.go @@ -20,7 +20,7 @@ import ( // structure describing identity notification attributes. This operation is // throttled at one request per second and can only get notification attributes for // up to 100 identities at a time. For more information about using notifications -// with Amazon SES, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/notifications.html) +// with Amazon SES, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity-using-notifications.html) // . func (c *Client) GetIdentityNotificationAttributes(ctx context.Context, params *GetIdentityNotificationAttributesInput, optFns ...func(*Options)) (*GetIdentityNotificationAttributesOutput, error) { if params == nil { @@ -39,7 +39,7 @@ func (c *Client) GetIdentityNotificationAttributes(ctx context.Context, params * // Represents a request to return the notification attributes for a list of // identities you verified with Amazon SES. For information about Amazon SES -// notifications, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/notifications.html) +// notifications, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity-using-notifications.html) // . type GetIdentityNotificationAttributesInput struct { diff --git a/service/ses/api_op_GetIdentityPolicies.go b/service/ses/api_op_GetIdentityPolicies.go index 8f157246a84..355a5688526 100644 --- a/service/ses/api_op_GetIdentityPolicies.go +++ b/service/ses/api_op_GetIdentityPolicies.go @@ -18,10 +18,10 @@ import ( // Returns the requested sending authorization policies for the given identity (an // email address or a domain). The policies are returned as a map of policy names // to policy contents. You can retrieve a maximum of 20 policies at a time. This -// API is for the identity owner only. If you have not verified the identity, this -// API will return an error. Sending authorization is a feature that enables an -// identity owner to authorize other senders to use its identities. For information -// about using sending authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) +// operation is for the identity owner only. If you have not verified the identity, +// it returns an error. Sending authorization is a feature that enables an identity +// owner to authorize other senders to use its identities. For information about +// using sending authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . You can execute this operation no more than once per second. func (c *Client) GetIdentityPolicies(ctx context.Context, params *GetIdentityPoliciesInput, optFns ...func(*Options)) (*GetIdentityPoliciesOutput, error) { if params == nil { @@ -41,15 +41,15 @@ func (c *Client) GetIdentityPolicies(ctx context.Context, params *GetIdentityPol // Represents a request to return the requested sending authorization policies for // an identity. Sending authorization is an Amazon SES feature that enables you to // authorize other senders to use your identities. For information, see the Amazon -// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) +// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . type GetIdentityPoliciesInput struct { - // The identity for which the policies will be retrieved. You can specify an - // identity by using its name or by using its Amazon Resource Name (ARN). Examples: + // The identity for which the policies are retrieved. You can specify an identity + // by using its name or by using its Amazon Resource Name (ARN). Examples: // user@example.com , example.com , // arn:aws:ses:us-east-1:123456789012:identity/example.com . To successfully call - // this API, you must own the identity. + // this operation, you must own the identity. // // This member is required. Identity *string diff --git a/service/ses/api_op_GetIdentityVerificationAttributes.go b/service/ses/api_op_GetIdentityVerificationAttributes.go index 6784bfb04e7..b505871caed 100644 --- a/service/ses/api_op_GetIdentityVerificationAttributes.go +++ b/service/ses/api_op_GetIdentityVerificationAttributes.go @@ -27,16 +27,16 @@ import ( // SES sent to that address. If the email address owner clicks the link within 24 // hours, the verification status of the email address changes to "Success". If the // link is not clicked within 24 hours, the verification status changes to -// "Failed." In that case, if you still want to verify the email address, you must -// restart the verification process from the beginning. For domain identities, the -// domain's verification status is "Pending" as Amazon SES searches for the -// required TXT record in the DNS settings of the domain. When Amazon SES detects -// the record, the domain's verification status changes to "Success". If Amazon SES -// is unable to detect the record within 72 hours, the domain's verification status -// changes to "Failed." In that case, if you still want to verify the domain, you -// must restart the verification process from the beginning. This operation is -// throttled at one request per second and can only get verification attributes for -// up to 100 identities at a time. +// "Failed." In that case, to verify the email address, you must restart the +// verification process from the beginning. For domain identities, the domain's +// verification status is "Pending" as Amazon SES searches for the required TXT +// record in the DNS settings of the domain. When Amazon SES detects the record, +// the domain's verification status changes to "Success". If Amazon SES is unable +// to detect the record within 72 hours, the domain's verification status changes +// to "Failed." In that case, to verify the domain, you must restart the +// verification process from the beginning. This operation is throttled at one +// request per second and can only get verification attributes for up to 100 +// identities at a time. func (c *Client) GetIdentityVerificationAttributes(ctx context.Context, params *GetIdentityVerificationAttributesInput, optFns ...func(*Options)) (*GetIdentityVerificationAttributesOutput, error) { if params == nil { params = &GetIdentityVerificationAttributesInput{} @@ -55,7 +55,7 @@ func (c *Client) GetIdentityVerificationAttributes(ctx context.Context, params * // Represents a request to return the Amazon SES verification status of a list of // identities. For domain identities, this request also returns the verification // token. For information about verifying identities with Amazon SES, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-addresses-and-domains.html) +// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html) // . type GetIdentityVerificationAttributesInput struct { diff --git a/service/ses/api_op_GetSendStatistics.go b/service/ses/api_op_GetSendStatistics.go index c3f689fab4b..c524b4ed0ae 100644 --- a/service/ses/api_op_GetSendStatistics.go +++ b/service/ses/api_op_GetSendStatistics.go @@ -16,10 +16,10 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// Provides sending statistics for the current AWS Region. The result is a list of -// data points, representing the last two weeks of sending activity. Each data -// point in the list contains statistics for a 15-minute period of time. You can -// execute this operation no more than once per second. +// Provides sending statistics for the current Amazon Web Services Region. The +// result is a list of data points, representing the last two weeks of sending +// activity. Each data point in the list contains statistics for a 15-minute period +// of time. You can execute this operation no more than once per second. func (c *Client) GetSendStatistics(ctx context.Context, params *GetSendStatisticsInput, optFns ...func(*Options)) (*GetSendStatisticsOutput, error) { if params == nil { params = &GetSendStatisticsInput{} diff --git a/service/ses/api_op_GetTemplate.go b/service/ses/api_op_GetTemplate.go index c9a4d6cf8e8..676c3e87b43 100644 --- a/service/ses/api_op_GetTemplate.go +++ b/service/ses/api_op_GetTemplate.go @@ -36,7 +36,7 @@ func (c *Client) GetTemplate(ctx context.Context, params *GetTemplateInput, optF type GetTemplateInput struct { - // The name of the template you want to retrieve. + // The name of the template to retrieve. // // This member is required. TemplateName *string @@ -46,8 +46,8 @@ type GetTemplateInput struct { type GetTemplateOutput struct { - // The content of the email, composed of a subject line, an HTML part, and a - // text-only part. + // The content of the email, composed of a subject line and either an HTML part or + // a text-only part. Template *types.Template // Metadata pertaining to the operation's result. diff --git a/service/ses/api_op_ListConfigurationSets.go b/service/ses/api_op_ListConfigurationSets.go index 34b2f382745..0c378f57f9d 100644 --- a/service/ses/api_op_ListConfigurationSets.go +++ b/service/ses/api_op_ListConfigurationSets.go @@ -17,14 +17,14 @@ import ( ) // Provides a list of the configuration sets associated with your Amazon SES -// account in the current AWS Region. For information about using configuration -// sets, see Monitoring Your Amazon SES Sending Activity (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// account in the current Amazon Web Services Region. For information about using +// configuration sets, see Monitoring Your Amazon SES Sending Activity (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // in the Amazon SES Developer Guide. You can execute this operation no more than -// once per second. This operation will return up to 1,000 configuration sets each -// time it is run. If your Amazon SES account has more than 1,000 configuration -// sets, this operation will also return a NextToken element. You can then execute -// the ListConfigurationSets operation again, passing the NextToken parameter and -// the value of the NextToken element to retrieve additional results. +// once per second. This operation returns up to 1,000 configuration sets each time +// it is run. If your Amazon SES account has more than 1,000 configuration sets, +// this operation also returns NextToken . You can then execute the +// ListConfigurationSets operation again, passing the NextToken parameter and the +// value of the NextToken element to retrieve additional results. func (c *Client) ListConfigurationSets(ctx context.Context, params *ListConfigurationSetsInput, optFns ...func(*Options)) (*ListConfigurationSetsOutput, error) { if params == nil { params = &ListConfigurationSetsInput{} @@ -40,9 +40,10 @@ func (c *Client) ListConfigurationSets(ctx context.Context, params *ListConfigur return out, nil } -// Represents a request to list the configuration sets associated with your AWS -// account. Configuration sets enable you to publish email sending events. For -// information about using configuration sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// Represents a request to list the configuration sets associated with your Amazon +// Web Services account. Configuration sets enable you to publish email sending +// events. For information about using configuration sets, see the Amazon SES +// Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . type ListConfigurationSetsInput struct { @@ -56,9 +57,9 @@ type ListConfigurationSetsInput struct { noSmithyDocumentSerde } -// A list of configuration sets associated with your AWS account. Configuration -// sets enable you to publish email sending events. For information about using -// configuration sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// A list of configuration sets associated with your Amazon Web Services account. +// Configuration sets enable you to publish email sending events. For information +// about using configuration sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . type ListConfigurationSetsOutput struct { diff --git a/service/ses/api_op_ListCustomVerificationEmailTemplates.go b/service/ses/api_op_ListCustomVerificationEmailTemplates.go index 61de2659ea8..711da2d402f 100644 --- a/service/ses/api_op_ListCustomVerificationEmailTemplates.go +++ b/service/ses/api_op_ListCustomVerificationEmailTemplates.go @@ -17,8 +17,8 @@ import ( ) // Lists the existing custom verification email templates for your account in the -// current AWS Region. For more information about custom verification email -// templates, see Using Custom Verification Email Templates (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/custom-verification-emails.html) +// current Amazon Web Services Region. For more information about custom +// verification email templates, see Using Custom Verification Email Templates (https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#send-email-verify-address-custom) // in the Amazon SES Developer Guide. You can execute this operation no more than // once per second. func (c *Client) ListCustomVerificationEmailTemplates(ctx context.Context, params *ListCustomVerificationEmailTemplatesInput, optFns ...func(*Options)) (*ListCustomVerificationEmailTemplatesOutput, error) { @@ -38,14 +38,14 @@ func (c *Client) ListCustomVerificationEmailTemplates(ctx context.Context, param // Represents a request to list the existing custom verification email templates // for your account. For more information about custom verification email -// templates, see Using Custom Verification Email Templates (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/custom-verification-emails.html) +// templates, see Using Custom Verification Email Templates (https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#send-email-verify-address-custom) // in the Amazon SES Developer Guide. type ListCustomVerificationEmailTemplatesInput struct { // The maximum number of custom verification email templates to return. This value // must be at least 1 and less than or equal to 50. If you do not specify a value, - // or if you specify a value less than 1 or greater than 50, the operation will - // return up to 50 results. + // or if you specify a value less than 1 or greater than 50, the operation returns + // up to 50 results. MaxResults *int32 // An array the contains the name and creation time stamp for each template in @@ -157,8 +157,8 @@ var _ ListCustomVerificationEmailTemplatesAPIClient = (*Client)(nil) type ListCustomVerificationEmailTemplatesPaginatorOptions struct { // The maximum number of custom verification email templates to return. This value // must be at least 1 and less than or equal to 50. If you do not specify a value, - // or if you specify a value less than 1 or greater than 50, the operation will - // return up to 50 results. + // or if you specify a value less than 1 or greater than 50, the operation returns + // up to 50 results. Limit int32 // Set to true if pagination should stop if the service returns a pagination token diff --git a/service/ses/api_op_ListIdentities.go b/service/ses/api_op_ListIdentities.go index aa6e9ef5f99..b7d57c85bf3 100644 --- a/service/ses/api_op_ListIdentities.go +++ b/service/ses/api_op_ListIdentities.go @@ -17,8 +17,16 @@ import ( ) // Returns a list containing all of the identities (email addresses and domains) -// for your AWS account in the current AWS Region, regardless of verification -// status. You can execute this operation no more than once per second. +// for your Amazon Web Services account in the current Amazon Web Services Region, +// regardless of verification status. You can execute this operation no more than +// once per second. It's recommended that for successive pagination calls of this +// API, you continue to the use the same parameter/value pairs as used in the +// original call, e.g., if you used IdentityType=Domain in the the original call +// and received a NextToken in the response, you should continue providing the +// IdentityType=Domain parameter for further NextToken calls; however, if you +// didn't provide the IdentityType parameter in the original call, then continue +// to not provide it for successive pagination calls. Using this protocol will +// ensure consistent results. func (c *Client) ListIdentities(ctx context.Context, params *ListIdentitiesInput, optFns ...func(*Options)) (*ListIdentitiesOutput, error) { if params == nil { params = &ListIdentitiesInput{} @@ -35,12 +43,12 @@ func (c *Client) ListIdentities(ctx context.Context, params *ListIdentitiesInput } // Represents a request to return a list of all identities (email addresses and -// domains) that you have attempted to verify under your AWS account, regardless of -// verification status. +// domains) that you have attempted to verify under your Amazon Web Services +// account, regardless of verification status. type ListIdentitiesInput struct { // The type of the identities to list. Possible values are "EmailAddress" and - // "Domain". If this parameter is omitted, then all identities will be listed. + // "Domain". If this parameter is omitted, then all identities are listed. IdentityType types.IdentityType // The maximum number of identities per page. Possible values are 1-1000 inclusive. @@ -52,8 +60,8 @@ type ListIdentitiesInput struct { noSmithyDocumentSerde } -// A list of all identities that you have attempted to verify under your AWS -// account, regardless of verification status. +// A list of all identities that you have attempted to verify under your Amazon +// Web Services account, regardless of verification status. type ListIdentitiesOutput struct { // A list of identities. diff --git a/service/ses/api_op_ListIdentityPolicies.go b/service/ses/api_op_ListIdentityPolicies.go index d381103ad61..fffc070fecb 100644 --- a/service/ses/api_op_ListIdentityPolicies.go +++ b/service/ses/api_op_ListIdentityPolicies.go @@ -16,12 +16,12 @@ import ( ) // Returns a list of sending authorization policies that are attached to the given -// identity (an email address or a domain). This API returns only a list. If you -// want the actual policy content, you can use GetIdentityPolicies . This API is -// for the identity owner only. If you have not verified the identity, this API -// will return an error. Sending authorization is a feature that enables an -// identity owner to authorize other senders to use its identities. For information -// about using sending authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) +// identity (an email address or a domain). This operation returns only a list. To +// get the actual policy content, use GetIdentityPolicies . This operation is for +// the identity owner only. If you have not verified the identity, it returns an +// error. Sending authorization is a feature that enables an identity owner to +// authorize other senders to use its identities. For information about using +// sending authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . You can execute this operation no more than once per second. func (c *Client) ListIdentityPolicies(ctx context.Context, params *ListIdentityPoliciesInput, optFns ...func(*Options)) (*ListIdentityPoliciesOutput, error) { if params == nil { @@ -41,15 +41,15 @@ func (c *Client) ListIdentityPolicies(ctx context.Context, params *ListIdentityP // Represents a request to return a list of sending authorization policies that // are attached to an identity. Sending authorization is an Amazon SES feature that // enables you to authorize other senders to use your identities. For information, -// see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) +// see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . type ListIdentityPoliciesInput struct { - // The identity that is associated with the policy for which the policies will be + // The identity that is associated with the policy for which the policies are // listed. You can specify an identity by using its name or by using its Amazon // Resource Name (ARN). Examples: user@example.com , example.com , // arn:aws:ses:us-east-1:123456789012:identity/example.com . To successfully call - // this API, you must own the identity. + // this operation, you must own the identity. // // This member is required. Identity *string diff --git a/service/ses/api_op_ListReceiptFilters.go b/service/ses/api_op_ListReceiptFilters.go index 74b5e9d9a01..b04602ceaf4 100644 --- a/service/ses/api_op_ListReceiptFilters.go +++ b/service/ses/api_op_ListReceiptFilters.go @@ -16,9 +16,9 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// Lists the IP address filters associated with your AWS account in the current -// AWS Region. For information about managing IP address filters, see the Amazon -// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-ip-filters.html) +// Lists the IP address filters associated with your Amazon Web Services account +// in the current Amazon Web Services Region. For information about managing IP +// address filters, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-ip-filtering-console-walkthrough.html) // . You can execute this operation no more than once per second. func (c *Client) ListReceiptFilters(ctx context.Context, params *ListReceiptFiltersInput, optFns ...func(*Options)) (*ListReceiptFiltersOutput, error) { if params == nil { @@ -35,15 +35,15 @@ func (c *Client) ListReceiptFilters(ctx context.Context, params *ListReceiptFilt return out, nil } -// Represents a request to list the IP address filters that exist under your AWS -// account. You use IP address filters when you receive email with Amazon SES. For -// more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-concepts.html) +// Represents a request to list the IP address filters that exist under your +// Amazon Web Services account. You use IP address filters when you receive email +// with Amazon SES. For more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html) // . type ListReceiptFiltersInput struct { noSmithyDocumentSerde } -// A list of IP address filters that exist under your AWS account. +// A list of IP address filters that exist under your Amazon Web Services account. type ListReceiptFiltersOutput struct { // A list of IP address filter data structures, which each consist of a name, an diff --git a/service/ses/api_op_ListReceiptRuleSets.go b/service/ses/api_op_ListReceiptRuleSets.go index 40d5a832291..b169baa6a4e 100644 --- a/service/ses/api_op_ListReceiptRuleSets.go +++ b/service/ses/api_op_ListReceiptRuleSets.go @@ -16,11 +16,11 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// Lists the receipt rule sets that exist under your AWS account in the current -// AWS Region. If there are additional receipt rule sets to be retrieved, you will -// receive a NextToken that you can provide to the next call to ListReceiptRuleSets -// to retrieve the additional entries. For information about managing receipt rule -// sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rule-sets.html) +// Lists the receipt rule sets that exist under your Amazon Web Services account +// in the current Amazon Web Services Region. If there are additional receipt rule +// sets to be retrieved, you receive a NextToken that you can provide to the next +// call to ListReceiptRuleSets to retrieve the additional entries. For information +// about managing receipt rule sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-receipt-rules-console-walkthrough.html) // . You can execute this operation no more than once per second. func (c *Client) ListReceiptRuleSets(ctx context.Context, params *ListReceiptRuleSetsInput, optFns ...func(*Options)) (*ListReceiptRuleSetsOutput, error) { if params == nil { @@ -37,9 +37,9 @@ func (c *Client) ListReceiptRuleSets(ctx context.Context, params *ListReceiptRul return out, nil } -// Represents a request to list the receipt rule sets that exist under your AWS -// account. You use receipt rule sets to receive email with Amazon SES. For more -// information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-concepts.html) +// Represents a request to list the receipt rule sets that exist under your Amazon +// Web Services account. You use receipt rule sets to receive email with Amazon +// SES. For more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html) // . type ListReceiptRuleSetsInput struct { @@ -50,7 +50,7 @@ type ListReceiptRuleSetsInput struct { noSmithyDocumentSerde } -// A list of receipt rule sets that exist under your AWS account. +// A list of receipt rule sets that exist under your Amazon Web Services account. type ListReceiptRuleSetsOutput struct { // A token indicating that there are additional receipt rule sets available to be diff --git a/service/ses/api_op_ListTemplates.go b/service/ses/api_op_ListTemplates.go index a9cb110d5ce..1880d71f9af 100644 --- a/service/ses/api_op_ListTemplates.go +++ b/service/ses/api_op_ListTemplates.go @@ -16,8 +16,9 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// Lists the email templates present in your Amazon SES account in the current AWS -// Region. You can execute this operation no more than once per second. +// Lists the email templates present in your Amazon SES account in the current +// Amazon Web Services Region. You can execute this operation no more than once per +// second. func (c *Client) ListTemplates(ctx context.Context, params *ListTemplatesInput, optFns ...func(*Options)) (*ListTemplatesOutput, error) { if params == nil { params = &ListTemplatesInput{} @@ -36,9 +37,9 @@ func (c *Client) ListTemplates(ctx context.Context, params *ListTemplatesInput, type ListTemplatesInput struct { // The maximum number of templates to return. This value must be at least 1 and - // less than or equal to 10. If you do not specify a value, or if you specify a - // value less than 1 or greater than 10, the operation will return up to 10 - // results. + // less than or equal to 100. If more than 100 items are requested, the page size + // will automatically set to 100. If you do not specify a value, 10 is the default + // page size. MaxItems *int32 // A token returned from a previous call to ListTemplates to indicate the position @@ -52,7 +53,7 @@ type ListTemplatesOutput struct { // A token indicating that there are additional email templates available to be // listed. Pass this token to a subsequent call to ListTemplates to retrieve the - // next 50 email templates. + // next set of email templates within your page size. NextToken *string // An array the contains the name and creation time stamp for each template in diff --git a/service/ses/api_op_ListVerifiedEmailAddresses.go b/service/ses/api_op_ListVerifiedEmailAddresses.go index 7c707bb341d..b36f6b8a862 100644 --- a/service/ses/api_op_ListVerifiedEmailAddresses.go +++ b/service/ses/api_op_ListVerifiedEmailAddresses.go @@ -36,8 +36,8 @@ type ListVerifiedEmailAddressesInput struct { noSmithyDocumentSerde } -// A list of email addresses that you have verified with Amazon SES under your AWS -// account. +// A list of email addresses that you have verified with Amazon SES under your +// Amazon Web Services account. type ListVerifiedEmailAddressesOutput struct { // A list of email addresses that have been verified. diff --git a/service/ses/api_op_PutConfigurationSetDeliveryOptions.go b/service/ses/api_op_PutConfigurationSetDeliveryOptions.go index bc04f7fd755..da7882ac10b 100644 --- a/service/ses/api_op_PutConfigurationSetDeliveryOptions.go +++ b/service/ses/api_op_PutConfigurationSetDeliveryOptions.go @@ -35,8 +35,7 @@ func (c *Client) PutConfigurationSetDeliveryOptions(ctx context.Context, params // A request to modify the delivery options for a configuration set. type PutConfigurationSetDeliveryOptionsInput struct { - // The name of the configuration set that you want to specify the delivery options - // for. + // The name of the configuration set. // // This member is required. ConfigurationSetName *string diff --git a/service/ses/api_op_PutIdentityPolicy.go b/service/ses/api_op_PutIdentityPolicy.go index 05644617fd2..c1ee99018ae 100644 --- a/service/ses/api_op_PutIdentityPolicy.go +++ b/service/ses/api_op_PutIdentityPolicy.go @@ -16,11 +16,11 @@ import ( ) // Adds or updates a sending authorization policy for the specified identity (an -// email address or a domain). This API is for the identity owner only. If you have -// not verified the identity, this API will return an error. Sending authorization +// email address or a domain). This operation is for the identity owner only. If +// you have not verified the identity, it returns an error. Sending authorization // is a feature that enables an identity owner to authorize other senders to use // its identities. For information about using sending authorization, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) +// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . You can execute this operation no more than once per second. func (c *Client) PutIdentityPolicy(ctx context.Context, params *PutIdentityPolicyInput, optFns ...func(*Options)) (*PutIdentityPolicyOutput, error) { if params == nil { @@ -40,22 +40,22 @@ func (c *Client) PutIdentityPolicy(ctx context.Context, params *PutIdentityPolic // Represents a request to add or update a sending authorization policy for an // identity. Sending authorization is an Amazon SES feature that enables you to // authorize other senders to use your identities. For information, see the Amazon -// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) +// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . type PutIdentityPolicyInput struct { - // The identity that the policy will apply to. You can specify an identity by + // The identity to which that the policy applies. You can specify an identity by // using its name or by using its Amazon Resource Name (ARN). Examples: // user@example.com , example.com , // arn:aws:ses:us-east-1:123456789012:identity/example.com . To successfully call - // this API, you must own the identity. + // this operation, you must own the identity. // // This member is required. Identity *string // The text of the policy in JSON format. The policy cannot exceed 4 KB. For // information about the syntax of sending authorization policies, see the Amazon - // SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization-policies.html) + // SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization-policies.html) // . // // This member is required. diff --git a/service/ses/api_op_ReorderReceiptRuleSet.go b/service/ses/api_op_ReorderReceiptRuleSet.go index 87ea4ac4236..04848675b15 100644 --- a/service/ses/api_op_ReorderReceiptRuleSet.go +++ b/service/ses/api_op_ReorderReceiptRuleSet.go @@ -16,9 +16,9 @@ import ( ) // Reorders the receipt rules within a receipt rule set. All of the rules in the -// rule set must be represented in this request. That is, this API will return an -// error if the reorder request doesn't explicitly position all of the rules. For -// information about managing receipt rule sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rule-sets.html) +// rule set must be represented in this request. That is, it is error if the +// reorder request doesn't explicitly position all of the rules. For information +// about managing receipt rule sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-receipt-rules-console-walkthrough.html) // . You can execute this operation no more than once per second. func (c *Client) ReorderReceiptRuleSet(ctx context.Context, params *ReorderReceiptRuleSetInput, optFns ...func(*Options)) (*ReorderReceiptRuleSetOutput, error) { if params == nil { @@ -37,12 +37,11 @@ func (c *Client) ReorderReceiptRuleSet(ctx context.Context, params *ReorderRecei // Represents a request to reorder the receipt rules within a receipt rule set. // You use receipt rule sets to receive email with Amazon SES. For more -// information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-concepts.html) +// information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html) // . type ReorderReceiptRuleSetInput struct { - // A list of the specified receipt rule set's receipt rules in the order that you - // want to put them. + // The specified receipt rule set's receipt rules, in order. // // This member is required. RuleNames []string diff --git a/service/ses/api_op_SendBounce.go b/service/ses/api_op_SendBounce.go index 3af70e3b3d6..e62aeaa0aa5 100644 --- a/service/ses/api_op_SendBounce.go +++ b/service/ses/api_op_SendBounce.go @@ -17,10 +17,10 @@ import ( ) // Generates and sends a bounce message to the sender of an email you received -// through Amazon SES. You can only use this API on an email up to 24 hours after -// you receive it. You cannot use this API to send generic bounces for mail that -// was not received by Amazon SES. For information about receiving email through -// Amazon SES, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email.html) +// through Amazon SES. You can only use this operation on an email up to 24 hours +// after you receive it. You cannot use this operation to send generic bounces for +// mail that was not received by Amazon SES. For information about receiving email +// through Amazon SES, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email.html) // . You can execute this operation no more than once per second. func (c *Client) SendBounce(ctx context.Context, params *SendBounceInput, optFns ...func(*Options)) (*SendBounceOutput, error) { if params == nil { @@ -62,16 +62,16 @@ type SendBounceInput struct { // This parameter is used only for sending authorization. It is the ARN of the // identity that is associated with the sending authorization policy that permits // you to use the address in the "From" header of the bounce. For more information - // about sending authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) + // about sending authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . BounceSenderArn *string // Human-readable text for the bounce message to explain the failure. If not - // specified, the text will be auto-generated based on the bounced recipient + // specified, the text is auto-generated based on the bounced recipient // information. Explanation *string - // Message-related DSN fields. If not specified, Amazon SES will choose the values. + // Message-related DSN fields. If not specified, Amazon SES chooses the values. MessageDsn *types.MessageDsn noSmithyDocumentSerde diff --git a/service/ses/api_op_SendBulkTemplatedEmail.go b/service/ses/api_op_SendBulkTemplatedEmail.go index db2b893619e..78c06beedbe 100644 --- a/service/ses/api_op_SendBulkTemplatedEmail.go +++ b/service/ses/api_op_SendBulkTemplatedEmail.go @@ -17,29 +17,29 @@ import ( ) // Composes an email message to multiple destinations. The message body is created -// using an email template. In order to send email using the SendBulkTemplatedEmail -// operation, your call to the API must meet the following requirements: +// using an email template. To send email using this operation, your call must meet +// the following requirements: // - The call must refer to an existing email template. You can create email -// templates using the CreateTemplate operation. +// templates using CreateTemplate . // - The message must be sent from a verified email address or domain. -// - If your account is still in the Amazon SES sandbox, you may only send to +// - If your account is still in the Amazon SES sandbox, you may send only to // verified addresses or domains, or to email addresses associated with the Amazon // SES Mailbox Simulator. For more information, see Verifying Email Addresses -// and Domains (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-addresses-and-domains.html) +// and Domains (https://docs.aws.amazon.com/ses/latest/dg/verify-addresses-and-domains.html) // in the Amazon SES Developer Guide. // - The maximum message size is 10 MB. // - Each Destination parameter must include at least one recipient email // address. The recipient address can be a To: address, a CC: address, or a BCC: // address. If a recipient email address is invalid (that is, it is not in the -// format UserName@[SubDomain.]Domain.TopLevelDomain), the entire message will be +// format UserName@[SubDomain.]Domain.TopLevelDomain), the entire message is // rejected, even if the message contains other recipients that are valid. // - The message may not include more than 50 recipients, across the To:, CC: // and BCC: fields. If you need to send an email message to a larger audience, you // can divide your recipient list into groups of 50 or fewer, and then call the // SendBulkTemplatedEmail operation several times to send the message to each // group. -// - The number of destinations you can contact in a single call to the API may -// be limited by your account's maximum sending rate. +// - The number of destinations you can contact in a single call can be limited +// by your account's maximum sending rate. func (c *Client) SendBulkTemplatedEmail(ctx context.Context, params *SendBulkTemplatedEmailInput, optFns ...func(*Options)) (*SendBulkTemplatedEmailOutput, error) { if params == nil { params = &SendBulkTemplatedEmailInput{} @@ -56,13 +56,13 @@ func (c *Client) SendBulkTemplatedEmail(ctx context.Context, params *SendBulkTem } // Represents a request to send a templated email to multiple destinations using -// Amazon SES. For more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-personalized-email-api.html) +// Amazon SES. For more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/send-personalized-email-api.html) // . type SendBulkTemplatedEmailInput struct { - // One or more Destination objects. All of the recipients in a Destination will - // receive the same version of the email. You can specify up to 50 Destination - // objects within a Destinations array. + // One or more Destination objects. All of the recipients in a Destination receive + // the same version of the email. You can specify up to 50 Destination objects + // within a Destinations array. // // This member is required. Destinations []types.BulkEmailDestination @@ -70,21 +70,21 @@ type SendBulkTemplatedEmailInput struct { // The email address that is sending the email. This email address must be either // individually verified with Amazon SES, or from a domain that has been verified // with Amazon SES. For information about verifying identities, see the Amazon SES - // Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-addresses-and-domains.html) + // Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html) // . If you are sending on behalf of another user and have been permitted to do so // by a sending authorization policy, then you must also specify the SourceArn // parameter. For more information about sending authorization, see the Amazon SES - // Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) + // Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . Amazon SES does not support the SMTPUTF8 extension, as described in RFC6531 (https://tools.ietf.org/html/rfc6531) - // . For this reason, the local part of a source email address (the part of the - // email address that precedes the @ sign) may only contain 7-bit ASCII characters (https://en.wikipedia.org/wiki/Email_address#Local-part) - // . If the domain part of an address (the part after the @ sign) contains - // non-ASCII characters, they must be encoded using Punycode, as described in - // RFC3492 (https://tools.ietf.org/html/rfc3492.html) . The sender name (also known - // as the friendly name) may contain non-ASCII characters. These characters must be - // encoded using MIME encoded-word syntax, as described in RFC 2047 (https://tools.ietf.org/html/rfc2047) - // . MIME encoded-word syntax uses the following form: - // =?charset?encoding?encoded-text?= . + // . For this reason, the email address string must be 7-bit ASCII. If you want to + // send to or from email addresses that contain Unicode characters in the domain + // part of an address, you must encode the domain using Punycode. Punycode is not + // permitted in the local part of the email address (the part before the @ sign) + // nor in the "friendly from" name. If you want to use Unicode characters in the + // "friendly from" name, you must encode the "friendly from" name using MIME + // encoded-word syntax, as described in Sending raw email using the Amazon SES API (https://docs.aws.amazon.com/ses/latest/dg/send-email-raw.html) + // . For more information about Punycode, see RFC 3492 (http://tools.ietf.org/html/rfc3492) + // . // // This member is required. Source *string @@ -110,16 +110,16 @@ type SendBulkTemplatedEmailInput struct { DefaultTemplateData *string // The reply-to email address(es) for the message. If the recipient replies to the - // message, each reply-to address will receive the reply. + // message, each reply-to address receives the reply. ReplyToAddresses []string - // The email address that bounces and complaints will be forwarded to when - // feedback forwarding is enabled. If the message cannot be delivered to the - // recipient, then an error message will be returned from the recipient's ISP; this - // message will then be forwarded to the email address specified by the ReturnPath - // parameter. The ReturnPath parameter is never overwritten. This email address - // must be either individually verified with Amazon SES, or from a domain that has - // been verified with Amazon SES. + // The email address that bounces and complaints are forwarded to when feedback + // forwarding is enabled. If the message cannot be delivered to the recipient, then + // an error message is returned from the recipient's ISP; this message is forwarded + // to the email address specified by the ReturnPath parameter. The ReturnPath + // parameter is never overwritten. This email address must be either individually + // verified with Amazon SES, or from a domain that has been verified with Amazon + // SES. ReturnPath *string // This parameter is used only for sending authorization. It is the ARN of the @@ -130,7 +130,7 @@ type SendBulkTemplatedEmailInput struct { // it that authorizes you to use feedback@example.com , then you would specify the // ReturnPathArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com , // and the ReturnPath to be feedback@example.com . For more information about - // sending authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) + // sending authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . ReturnPathArn *string @@ -142,7 +142,7 @@ type SendBulkTemplatedEmailInput struct { // it that authorizes you to send from user@example.com , then you would specify // the SourceArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com , // and the Source to be user@example.com . For more information about sending - // authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) + // authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . SourceArn *string @@ -154,7 +154,10 @@ type SendBulkTemplatedEmailInput struct { type SendBulkTemplatedEmailOutput struct { - // The unique message identifier returned from the SendBulkTemplatedEmail action. + // One object per intended recipient. Check each response object and retry any + // messages with a failure status. (Note that order of responses will be respective + // to order of destinations in the request.)Receipt rules enable you to specify + // which actions // // This member is required. Status []types.BulkEmailDestinationStatus diff --git a/service/ses/api_op_SendCustomVerificationEmail.go b/service/ses/api_op_SendCustomVerificationEmail.go index b2374ba0b83..80bcef92a16 100644 --- a/service/ses/api_op_SendCustomVerificationEmail.go +++ b/service/ses/api_op_SendCustomVerificationEmail.go @@ -16,11 +16,12 @@ import ( ) // Adds an email address to the list of identities for your Amazon SES account in -// the current AWS Region and attempts to verify it. As a result of executing this -// operation, a customized verification email is sent to the specified address. To -// use this operation, you must first create a custom verification email template. -// For more information about creating and using custom verification email -// templates, see Using Custom Verification Email Templates (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/custom-verification-emails.html) +// the current Amazon Web Services Region and attempts to verify it. As a result of +// executing this operation, a customized verification email is sent to the +// specified address. To use this operation, you must first create a custom +// verification email template. For more information about creating and using +// custom verification email templates, see Using Custom Verification Email +// Templates (https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#send-email-verify-address-custom) // in the Amazon SES Developer Guide. You can execute this operation no more than // once per second. func (c *Client) SendCustomVerificationEmail(ctx context.Context, params *SendCustomVerificationEmailInput, optFns ...func(*Options)) (*SendCustomVerificationEmailOutput, error) { diff --git a/service/ses/api_op_SendEmail.go b/service/ses/api_op_SendEmail.go index e54e13a9f99..3f9d72cfa73 100644 --- a/service/ses/api_op_SendEmail.go +++ b/service/ses/api_op_SendEmail.go @@ -16,23 +16,22 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// Composes an email message and immediately queues it for sending. In order to -// send email using the SendEmail operation, your message must meet the following -// requirements: +// Composes an email message and immediately queues it for sending. To send email +// using this operation, your message must meet the following requirements: // - The message must be sent from a verified email address or domain. If you -// attempt to send email using a non-verified address or domain, the operation will -// result in an "Email address not verified" error. +// attempt to send email using a non-verified address or domain, the operation +// results in an "Email address not verified" error. // - If your account is still in the Amazon SES sandbox, you may only send to // verified addresses or domains, or to email addresses associated with the Amazon // SES Mailbox Simulator. For more information, see Verifying Email Addresses -// and Domains (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-addresses-and-domains.html) +// and Domains (https://docs.aws.amazon.com/ses/latest/dg/verify-addresses-and-domains.html) // in the Amazon SES Developer Guide. // - The maximum message size is 10 MB. // - The message must include at least one recipient email address. The // recipient address can be a To: address, a CC: address, or a BCC: address. If a // recipient email address is invalid (that is, it is not in the format -// UserName@[SubDomain.]Domain.TopLevelDomain), the entire message will be -// rejected, even if the message contains other recipients that are valid. +// UserName@[SubDomain.]Domain.TopLevelDomain), the entire message is rejected, +// even if the message contains other recipients that are valid. // - The message may not include more than 50 recipients, across the To:, CC: // and BCC: fields. If you need to send an email message to a larger audience, you // can divide your recipient list into groups of 50 or fewer, and then call the @@ -42,7 +41,7 @@ import ( // recipient in the To:, CC: and BCC: fields) is counted against the maximum number // of emails you can send in a 24-hour period (your sending quota). For more // information about sending quotas in Amazon SES, see Managing Your Amazon SES -// Sending Limits (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/manage-sending-limits.html) +// Sending Limits (https://docs.aws.amazon.com/ses/latest/dg/manage-sending-quotas.html) // in the Amazon SES Developer Guide. func (c *Client) SendEmail(ctx context.Context, params *SendEmailInput, optFns ...func(*Options)) (*SendEmailOutput, error) { if params == nil { @@ -60,7 +59,7 @@ func (c *Client) SendEmail(ctx context.Context, params *SendEmailInput, optFns . } // Represents a request to send a single formatted email using Amazon SES. For -// more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-formatted.html) +// more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/send-email-formatted.html) // . type SendEmailInput struct { @@ -77,21 +76,21 @@ type SendEmailInput struct { // The email address that is sending the email. This email address must be either // individually verified with Amazon SES, or from a domain that has been verified // with Amazon SES. For information about verifying identities, see the Amazon SES - // Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-addresses-and-domains.html) + // Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html) // . If you are sending on behalf of another user and have been permitted to do so // by a sending authorization policy, then you must also specify the SourceArn // parameter. For more information about sending authorization, see the Amazon SES - // Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) + // Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . Amazon SES does not support the SMTPUTF8 extension, as described in RFC6531 (https://tools.ietf.org/html/rfc6531) - // . For this reason, the local part of a source email address (the part of the - // email address that precedes the @ sign) may only contain 7-bit ASCII characters (https://en.wikipedia.org/wiki/Email_address#Local-part) - // . If the domain part of an address (the part after the @ sign) contains - // non-ASCII characters, they must be encoded using Punycode, as described in - // RFC3492 (https://tools.ietf.org/html/rfc3492.html) . The sender name (also known - // as the friendly name) may contain non-ASCII characters. These characters must be - // encoded using MIME encoded-word syntax, as described in RFC 2047 (https://tools.ietf.org/html/rfc2047) - // . MIME encoded-word syntax uses the following form: - // =?charset?encoding?encoded-text?= . + // . For this reason, the email address string must be 7-bit ASCII. If you want to + // send to or from email addresses that contain Unicode characters in the domain + // part of an address, you must encode the domain using Punycode. Punycode is not + // permitted in the local part of the email address (the part before the @ sign) + // nor in the "friendly from" name. If you want to use Unicode characters in the + // "friendly from" name, you must encode the "friendly from" name using MIME + // encoded-word syntax, as described in Sending raw email using the Amazon SES API (https://docs.aws.amazon.com/ses/latest/dg/send-email-raw.html) + // . For more information about Punycode, see RFC 3492 (http://tools.ietf.org/html/rfc3492) + // . // // This member is required. Source *string @@ -100,16 +99,16 @@ type SendEmailInput struct { ConfigurationSetName *string // The reply-to email address(es) for the message. If the recipient replies to the - // message, each reply-to address will receive the reply. + // message, each reply-to address receives the reply. ReplyToAddresses []string - // The email address that bounces and complaints will be forwarded to when - // feedback forwarding is enabled. If the message cannot be delivered to the - // recipient, then an error message will be returned from the recipient's ISP; this - // message will then be forwarded to the email address specified by the ReturnPath - // parameter. The ReturnPath parameter is never overwritten. This email address - // must be either individually verified with Amazon SES, or from a domain that has - // been verified with Amazon SES. + // The email address that bounces and complaints are forwarded to when feedback + // forwarding is enabled. If the message cannot be delivered to the recipient, then + // an error message is returned from the recipient's ISP; this message is forwarded + // to the email address specified by the ReturnPath parameter. The ReturnPath + // parameter is never overwritten. This email address must be either individually + // verified with Amazon SES, or from a domain that has been verified with Amazon + // SES. ReturnPath *string // This parameter is used only for sending authorization. It is the ARN of the @@ -120,7 +119,7 @@ type SendEmailInput struct { // it that authorizes you to use feedback@example.com , then you would specify the // ReturnPathArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com , // and the ReturnPath to be feedback@example.com . For more information about - // sending authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) + // sending authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . ReturnPathArn *string @@ -132,7 +131,7 @@ type SendEmailInput struct { // it that authorizes you to send from user@example.com , then you would specify // the SourceArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com , // and the Source to be user@example.com . For more information about sending - // authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) + // authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . SourceArn *string diff --git a/service/ses/api_op_SendRawEmail.go b/service/ses/api_op_SendRawEmail.go index b3327ea4c81..91eaf913c08 100644 --- a/service/ses/api_op_SendRawEmail.go +++ b/service/ses/api_op_SendRawEmail.go @@ -17,18 +17,18 @@ import ( ) // Composes an email message and immediately queues it for sending. This operation -// is more flexible than the SendEmail API operation. When you use the SendRawEmail +// is more flexible than the SendEmail operation. When you use the SendRawEmail // operation, you can specify the headers of the message as well as its content. -// This flexibility is useful, for example, when you want to send a multipart MIME +// This flexibility is useful, for example, when you need to send a multipart MIME // email (such a message that contains both a text and an HTML version). You can // also use this operation to send messages that include attachments. The // SendRawEmail operation has the following requirements: -// - You can only send email from verified email addresses or domains (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-addresses-and-domains.html) +// - You can only send email from verified email addresses or domains (https://docs.aws.amazon.com/ses/latest/dg/verify-addresses-and-domains.html) // . If you try to send email from an address that isn't verified, the operation // results in an "Email address not verified" error. -// - If your account is still in the Amazon SES sandbox (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/request-production-access.html) +// - If your account is still in the Amazon SES sandbox (https://docs.aws.amazon.com/ses/latest/dg/request-production-access.html) // , you can only send email to other verified addresses in your account, or to -// addresses that are associated with the Amazon SES mailbox simulator (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/mailbox-simulator.html) +// addresses that are associated with the Amazon SES mailbox simulator (https://docs.aws.amazon.com/ses/latest/dg/send-an-email-from-console.html) // . // - The maximum message size, including attachments, is 10 MB. // - Each message has to include at least one recipient address. A recipient @@ -45,33 +45,33 @@ import ( // message parts. However, if Amazon SES has to modify the contents of your message // (for example, if you use open and click tracking), 8-bit content isn't // preserved. For this reason, we highly recommend that you encode all content that -// isn't 7-bit ASCII. For more information, see MIME Encoding (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-raw.html#send-email-mime-encoding) +// isn't 7-bit ASCII. For more information, see MIME Encoding (https://docs.aws.amazon.com/ses/latest/dg/send-email-raw.html#send-email-mime-encoding) // in the Amazon SES Developer Guide. // // Additionally, keep the following considerations in mind when using the // SendRawEmail operation: // - Although you can customize the message headers when using the SendRawEmail -// operation, Amazon SES will automatically apply its own Message-ID and Date -// headers; if you passed these headers when creating the message, they will be +// operation, Amazon SES automatically applies its own Message-ID and Date +// headers; if you passed these headers when creating the message, they are // overwritten by the values that Amazon SES provides. // - If you are using sending authorization to send on behalf of another user, // SendRawEmail enables you to specify the cross-account identity for the email's // Source, From, and Return-Path parameters in one of two ways: you can pass -// optional parameters SourceArn , FromArn , and/or ReturnPathArn to the API, or -// you can include the following X-headers in the header of your raw email: +// optional parameters SourceArn , FromArn , and/or ReturnPathArn , or you can +// include the following X-headers in the header of your raw email: // - X-SES-SOURCE-ARN // - X-SES-FROM-ARN // - X-SES-RETURN-PATH-ARN Don't include these X-headers in the DKIM signature. // Amazon SES removes these before it sends the email. If you only specify the // SourceIdentityArn parameter, Amazon SES sets the From and Return-Path // addresses to the same identity that you specified. For more information about -// sending authorization, see the Using Sending Authorization with Amazon SES (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) +// sending authorization, see the Using Sending Authorization with Amazon SES (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // in the Amazon SES Developer Guide. // - For every message that you send, the total number of recipients (including // each recipient in the To:, CC: and BCC: fields) is counted against the maximum // number of emails you can send in a 24-hour period (your sending quota). For more // information about sending quotas in Amazon SES, see Managing Your Amazon SES -// Sending Limits (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/manage-sending-limits.html) +// Sending Limits (https://docs.aws.amazon.com/ses/latest/dg/manage-sending-quotas.html) // in the Amazon SES Developer Guide. func (c *Client) SendRawEmail(ctx context.Context, params *SendRawEmailInput, optFns ...func(*Options)) (*SendRawEmailOutput, error) { if params == nil { @@ -89,7 +89,7 @@ func (c *Client) SendRawEmail(ctx context.Context, params *SendRawEmailInput, op } // Represents a request to send a single raw email using Amazon SES. For more -// information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-raw.html) +// information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/send-email-raw.html) // . type SendRawEmailInput struct { @@ -98,12 +98,12 @@ type SendRawEmailInput struct { // - All of the required header fields must be present in the message. // - Each part of a multipart MIME message must be formatted properly. // - Attachments must be of a content type that Amazon SES supports. For a list - // on unsupported content types, see Unsupported Attachment Types (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/mime-types.html) + // on unsupported content types, see Unsupported Attachment Types (https://docs.aws.amazon.com/ses/latest/dg/mime-types.html) // in the Amazon SES Developer Guide. // - The entire message must be base64-encoded. // - If any of the MIME parts in your message contain content that is outside of // the 7-bit ASCII character range, we highly recommend that you encode that - // content. For more information, see Sending Raw Email (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-raw.html) + // content. For more information, see Sending Raw Email (https://docs.aws.amazon.com/ses/latest/dg/send-email-raw.html) // in the Amazon SES Developer Guide. // - Per RFC 5321 (https://tools.ietf.org/html/rfc5321#section-4.5.3.1.6) , the // maximum length of each line of text, including the , must not exceed 1,000 @@ -127,7 +127,7 @@ type SendRawEmailInput struct { // raw message of the email. If you use both the FromArn parameter and the // corresponding X-header, Amazon SES uses the value of the FromArn parameter. For // information about when to use this parameter, see the description of - // SendRawEmail in this guide, or see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization-delegate-sender-tasks-email.html) + // SendRawEmail in this guide, or see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization-delegate-sender-tasks-email.html) // . FromArn *string @@ -143,26 +143,26 @@ type SendRawEmailInput struct { // If you use both the ReturnPathArn parameter and the corresponding X-header, // Amazon SES uses the value of the ReturnPathArn parameter. For information about // when to use this parameter, see the description of SendRawEmail in this guide, - // or see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization-delegate-sender-tasks-email.html) + // or see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization-delegate-sender-tasks-email.html) // . ReturnPathArn *string // The identity's email address. If you do not provide a value for this parameter, // you must specify a "From" address in the raw text of the message. (You can also // specify both.) Amazon SES does not support the SMTPUTF8 extension, as described - // in RFC6531 (https://tools.ietf.org/html/rfc6531) . For this reason, the local - // part of a source email address (the part of the email address that precedes the - // @ sign) may only contain 7-bit ASCII characters (https://en.wikipedia.org/wiki/Email_address#Local-part) - // . If the domain part of an address (the part after the @ sign) contains - // non-ASCII characters, they must be encoded using Punycode, as described in - // RFC3492 (https://tools.ietf.org/html/rfc3492.html) . The sender name (also known - // as the friendly name) may contain non-ASCII characters. These characters must be - // encoded using MIME encoded-word syntax, as described in RFC 2047 (https://tools.ietf.org/html/rfc2047) - // . MIME encoded-word syntax uses the following form: - // =?charset?encoding?encoded-text?= . If you specify the Source parameter and - // have feedback forwarding enabled, then bounces and complaints will be sent to - // this email address. This takes precedence over any Return-Path header that you - // might include in the raw text of the message. + // in RFC6531 (https://tools.ietf.org/html/rfc6531) . For this reason, the email + // address string must be 7-bit ASCII. If you want to send to or from email + // addresses that contain Unicode characters in the domain part of an address, you + // must encode the domain using Punycode. Punycode is not permitted in the local + // part of the email address (the part before the @ sign) nor in the "friendly + // from" name. If you want to use Unicode characters in the "friendly from" name, + // you must encode the "friendly from" name using MIME encoded-word syntax, as + // described in Sending raw email using the Amazon SES API (https://docs.aws.amazon.com/ses/latest/dg/send-email-raw.html) + // . For more information about Punycode, see RFC 3492 (http://tools.ietf.org/html/rfc3492) + // . If you specify the Source parameter and have feedback forwarding enabled, + // then bounces and complaints are sent to this email address. This takes + // precedence over any Return-Path header that you might include in the raw text of + // the message. Source *string // This parameter is used only for sending authorization. It is the ARN of the @@ -177,7 +177,7 @@ type SendRawEmailInput struct { // both the SourceArn parameter and the corresponding X-header, Amazon SES uses // the value of the SourceArn parameter. For information about when to use this // parameter, see the description of SendRawEmail in this guide, or see the Amazon - // SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization-delegate-sender-tasks-email.html) + // SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization-delegate-sender-tasks-email.html) // . SourceArn *string diff --git a/service/ses/api_op_SendTemplatedEmail.go b/service/ses/api_op_SendTemplatedEmail.go index da0abef4eb7..6338a653298 100644 --- a/service/ses/api_op_SendTemplatedEmail.go +++ b/service/ses/api_op_SendTemplatedEmail.go @@ -17,26 +17,26 @@ import ( ) // Composes an email message using an email template and immediately queues it for -// sending. In order to send email using the SendTemplatedEmail operation, your -// call to the API must meet the following requirements: +// sending. To send email using this operation, your call must meet the following +// requirements: // - The call must refer to an existing email template. You can create email // templates using the CreateTemplate operation. // - The message must be sent from a verified email address or domain. // - If your account is still in the Amazon SES sandbox, you may only send to // verified addresses or domains, or to email addresses associated with the Amazon // SES Mailbox Simulator. For more information, see Verifying Email Addresses -// and Domains (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-addresses-and-domains.html) +// and Domains (https://docs.aws.amazon.com/ses/latest/dg/verify-addresses-and-domains.html) // in the Amazon SES Developer Guide. // - The maximum message size is 10 MB. // - Calls to the SendTemplatedEmail operation may only include one Destination -// parameter. A destination is a set of recipients who will receive the same -// version of the email. The Destination parameter can include up to 50 -// recipients, across the To:, CC: and BCC: fields. +// parameter. A destination is a set of recipients that receives the same version +// of the email. The Destination parameter can include up to 50 recipients, +// across the To:, CC: and BCC: fields. // - The Destination parameter must include at least one recipient email address. // The recipient address can be a To: address, a CC: address, or a BCC: address. If // a recipient email address is invalid (that is, it is not in the format -// UserName@[SubDomain.]Domain.TopLevelDomain), the entire message will be -// rejected, even if the message contains other recipients that are valid. +// UserName@[SubDomain.]Domain.TopLevelDomain), the entire message is rejected, +// even if the message contains other recipients that are valid. // // If your call to the SendTemplatedEmail operation includes all of the required // parameters, Amazon SES accepts it and returns a Message ID. However, if Amazon @@ -45,7 +45,7 @@ import ( // doesn't return a message stating that it was unable to send the email. For these // reasons, we highly recommend that you set up Amazon SES to send you // notifications when Rendering Failure events occur. For more information, see -// Sending Personalized Email Using the Amazon SES API (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-personalized-email-api.html) +// Sending Personalized Email Using the Amazon SES API (https://docs.aws.amazon.com/ses/latest/dg/send-personalized-email-api.html) // in the Amazon Simple Email Service Developer Guide. func (c *Client) SendTemplatedEmail(ctx context.Context, params *SendTemplatedEmailInput, optFns ...func(*Options)) (*SendTemplatedEmailOutput, error) { if params == nil { @@ -63,7 +63,7 @@ func (c *Client) SendTemplatedEmail(ctx context.Context, params *SendTemplatedEm } // Represents a request to send a templated email using Amazon SES. For more -// information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-personalized-email-api.html) +// information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/send-personalized-email-api.html) // . type SendTemplatedEmailInput struct { @@ -76,21 +76,21 @@ type SendTemplatedEmailInput struct { // The email address that is sending the email. This email address must be either // individually verified with Amazon SES, or from a domain that has been verified // with Amazon SES. For information about verifying identities, see the Amazon SES - // Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-addresses-and-domains.html) + // Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html) // . If you are sending on behalf of another user and have been permitted to do so // by a sending authorization policy, then you must also specify the SourceArn // parameter. For more information about sending authorization, see the Amazon SES - // Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) + // Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . Amazon SES does not support the SMTPUTF8 extension, as described in RFC6531 (https://tools.ietf.org/html/rfc6531) - // . For this reason, the local part of a source email address (the part of the - // email address that precedes the @ sign) may only contain 7-bit ASCII characters (https://en.wikipedia.org/wiki/Email_address#Local-part) - // . If the domain part of an address (the part after the @ sign) contains - // non-ASCII characters, they must be encoded using Punycode, as described in - // RFC3492 (https://tools.ietf.org/html/rfc3492.html) . The sender name (also known - // as the friendly name) may contain non-ASCII characters. These characters must be - // encoded using MIME encoded-word syntax, as described in RFC 2047 (https://tools.ietf.org/html/rfc2047) - // . MIME encoded-word syntax uses the following form: - // =?charset?encoding?encoded-text?= . + // . for this reason, The email address string must be 7-bit ASCII. If you want to + // send to or from email addresses that contain Unicode characters in the domain + // part of an address, you must encode the domain using Punycode. Punycode is not + // permitted in the local part of the email address (the part before the @ sign) + // nor in the "friendly from" name. If you want to use Unicode characters in the + // "friendly from" name, you must encode the "friendly from" name using MIME + // encoded-word syntax, as described in Sending raw email using the Amazon SES API (https://docs.aws.amazon.com/ses/latest/dg/send-email-raw.html) + // . For more information about Punycode, see RFC 3492 (http://tools.ietf.org/html/rfc3492) + // . // // This member is required. Source *string @@ -112,16 +112,16 @@ type SendTemplatedEmailInput struct { ConfigurationSetName *string // The reply-to email address(es) for the message. If the recipient replies to the - // message, each reply-to address will receive the reply. + // message, each reply-to address receives the reply. ReplyToAddresses []string - // The email address that bounces and complaints will be forwarded to when - // feedback forwarding is enabled. If the message cannot be delivered to the - // recipient, then an error message will be returned from the recipient's ISP; this - // message will then be forwarded to the email address specified by the ReturnPath - // parameter. The ReturnPath parameter is never overwritten. This email address - // must be either individually verified with Amazon SES, or from a domain that has - // been verified with Amazon SES. + // The email address that bounces and complaints are forwarded to when feedback + // forwarding is enabled. If the message cannot be delivered to the recipient, then + // an error message is returned from the recipient's ISP; this message is forwarded + // to the email address specified by the ReturnPath parameter. The ReturnPath + // parameter is never overwritten. This email address must be either individually + // verified with Amazon SES, or from a domain that has been verified with Amazon + // SES. ReturnPath *string // This parameter is used only for sending authorization. It is the ARN of the @@ -132,7 +132,7 @@ type SendTemplatedEmailInput struct { // it that authorizes you to use feedback@example.com , then you would specify the // ReturnPathArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com , // and the ReturnPath to be feedback@example.com . For more information about - // sending authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) + // sending authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . ReturnPathArn *string @@ -144,7 +144,7 @@ type SendTemplatedEmailInput struct { // it that authorizes you to send from user@example.com , then you would specify // the SourceArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com , // and the Source to be user@example.com . For more information about sending - // authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) + // authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . SourceArn *string diff --git a/service/ses/api_op_SetActiveReceiptRuleSet.go b/service/ses/api_op_SetActiveReceiptRuleSet.go index 2d647da0d1a..0a76595f59c 100644 --- a/service/ses/api_op_SetActiveReceiptRuleSet.go +++ b/service/ses/api_op_SetActiveReceiptRuleSet.go @@ -16,9 +16,9 @@ import ( ) // Sets the specified receipt rule set as the active receipt rule set. To disable -// your email-receiving through Amazon SES completely, you can call this API with -// RuleSetName set to null. For information about managing receipt rule sets, see -// the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rule-sets.html) +// your email-receiving through Amazon SES completely, you can call this operation +// with RuleSetName set to null. For information about managing receipt rule sets, +// see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-receipt-rules-console-walkthrough.html) // . You can execute this operation no more than once per second. func (c *Client) SetActiveReceiptRuleSet(ctx context.Context, params *SetActiveReceiptRuleSetInput, optFns ...func(*Options)) (*SetActiveReceiptRuleSetOutput, error) { if params == nil { @@ -37,7 +37,7 @@ func (c *Client) SetActiveReceiptRuleSet(ctx context.Context, params *SetActiveR // Represents a request to set a receipt rule set as the active receipt rule set. // You use receipt rule sets to receive email with Amazon SES. For more -// information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-concepts.html) +// information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html) // . type SetActiveReceiptRuleSetInput struct { diff --git a/service/ses/api_op_SetIdentityDkimEnabled.go b/service/ses/api_op_SetIdentityDkimEnabled.go index 590e3e2ffad..f4f92e58bab 100644 --- a/service/ses/api_op_SetIdentityDkimEnabled.go +++ b/service/ses/api_op_SetIdentityDkimEnabled.go @@ -25,7 +25,7 @@ import ( // an identity at any time after you start the verification process for the // identity, even if the verification process isn't complete. You can execute this // operation no more than once per second. For more information about Easy DKIM -// signing, go to the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html) +// signing, go to the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/send-email-authentication-dkim-easy.html) // . func (c *Client) SetIdentityDkimEnabled(ctx context.Context, params *SetIdentityDkimEnabledInput, optFns ...func(*Options)) (*SetIdentityDkimEnabledOutput, error) { if params == nil { @@ -44,7 +44,7 @@ func (c *Client) SetIdentityDkimEnabled(ctx context.Context, params *SetIdentity // Represents a request to enable or disable Amazon SES Easy DKIM signing for an // identity. For more information about setting up Easy DKIM, see the Amazon SES -// Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html) +// Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/send-email-authentication-dkim-easy.html) // . type SetIdentityDkimEnabledInput struct { diff --git a/service/ses/api_op_SetIdentityFeedbackForwardingEnabled.go b/service/ses/api_op_SetIdentityFeedbackForwardingEnabled.go index 8d236e757df..30591561b63 100644 --- a/service/ses/api_op_SetIdentityFeedbackForwardingEnabled.go +++ b/service/ses/api_op_SetIdentityFeedbackForwardingEnabled.go @@ -22,7 +22,7 @@ import ( // does not apply to delivery notifications. Delivery notifications are only // available through Amazon SNS. You can execute this operation no more than once // per second. For more information about using notifications with Amazon SES, see -// the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/notifications.html) +// the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity-using-notifications.html) // . func (c *Client) SetIdentityFeedbackForwardingEnabled(ctx context.Context, params *SetIdentityFeedbackForwardingEnabledInput, optFns ...func(*Options)) (*SetIdentityFeedbackForwardingEnabledOutput, error) { if params == nil { @@ -41,16 +41,16 @@ func (c *Client) SetIdentityFeedbackForwardingEnabled(ctx context.Context, param // Represents a request to enable or disable whether Amazon SES forwards you // bounce and complaint notifications through email. For information about email -// feedback forwarding, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/notifications-via-email.html) +// feedback forwarding, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity-using-notifications-email.html) // . type SetIdentityFeedbackForwardingEnabledInput struct { - // Sets whether Amazon SES will forward bounce and complaint notifications as - // email. true specifies that Amazon SES will forward bounce and complaint - // notifications as email, in addition to any Amazon SNS topic publishing otherwise - // specified. false specifies that Amazon SES will publish bounce and complaint - // notifications only through Amazon SNS. This value can only be set to false when - // Amazon SNS topics are set for both Bounce and Complaint notification types. + // Sets whether Amazon SES forwards bounce and complaint notifications as email. + // true specifies that Amazon SES forwards bounce and complaint notifications as + // email, in addition to any Amazon SNS topic publishing otherwise specified. false + // specifies that Amazon SES publishes bounce and complaint notifications only + // through Amazon SNS. This value can only be set to false when Amazon SNS topics + // are set for both Bounce and Complaint notification types. // // This member is required. ForwardingEnabled bool diff --git a/service/ses/api_op_SetIdentityHeadersInNotificationsEnabled.go b/service/ses/api_op_SetIdentityHeadersInNotificationsEnabled.go index 19a7582d264..215d43fde28 100644 --- a/service/ses/api_op_SetIdentityHeadersInNotificationsEnabled.go +++ b/service/ses/api_op_SetIdentityHeadersInNotificationsEnabled.go @@ -20,7 +20,7 @@ import ( // includes the original email headers in the Amazon Simple Notification Service // (Amazon SNS) notifications of a specified type. You can execute this operation // no more than once per second. For more information about using notifications -// with Amazon SES, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/notifications.html) +// with Amazon SES, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity-using-notifications.html) // . func (c *Client) SetIdentityHeadersInNotificationsEnabled(ctx context.Context, params *SetIdentityHeadersInNotificationsEnabledInput, optFns ...func(*Options)) (*SetIdentityHeadersInNotificationsEnabledOutput, error) { if params == nil { @@ -39,14 +39,14 @@ func (c *Client) SetIdentityHeadersInNotificationsEnabled(ctx context.Context, p // Represents a request to set whether Amazon SES includes the original email // headers in the Amazon SNS notifications of a specified type. For information -// about notifications, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/notifications-via-sns.html) +// about notifications, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity-using-notifications-sns.html) // . type SetIdentityHeadersInNotificationsEnabledInput struct { // Sets whether Amazon SES includes the original email headers in Amazon SNS // notifications of the specified notification type. A value of true specifies - // that Amazon SES will include headers in notifications, and a value of false - // specifies that Amazon SES will not include headers in notifications. This value + // that Amazon SES includes headers in notifications, and a value of false + // specifies that Amazon SES does not include headers in notifications. This value // can only be set when NotificationType is already set to use a particular Amazon // SNS topic. // diff --git a/service/ses/api_op_SetIdentityMailFromDomain.go b/service/ses/api_op_SetIdentityMailFromDomain.go index a4806bd441f..14384e8326d 100644 --- a/service/ses/api_op_SetIdentityMailFromDomain.go +++ b/service/ses/api_op_SetIdentityMailFromDomain.go @@ -18,11 +18,11 @@ import ( // Enables or disables the custom MAIL FROM domain setup for a verified identity // (an email address or a domain). To send emails using the specified MAIL FROM -// domain, you must add an MX record to your MAIL FROM domain's DNS settings. If -// you want your emails to pass Sender Policy Framework (SPF) checks, you must also +// domain, you must add an MX record to your MAIL FROM domain's DNS settings. To +// ensure that your emails pass Sender Policy Framework (SPF) checks, you must also // add or update an SPF record. For more information, see the Amazon SES Developer -// Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/mail-from-set.html) -// . You can execute this operation no more than once per second. +// Guide (https://docs.aws.amazon.com/ses/latest/dg/mail-from.html) . You can +// execute this operation no more than once per second. func (c *Client) SetIdentityMailFromDomain(ctx context.Context, params *SetIdentityMailFromDomainInput, optFns ...func(*Options)) (*SetIdentityMailFromDomainOutput, error) { if params == nil { params = &SetIdentityMailFromDomainInput{} @@ -40,29 +40,28 @@ func (c *Client) SetIdentityMailFromDomain(ctx context.Context, params *SetIdent // Represents a request to enable or disable the Amazon SES custom MAIL FROM // domain setup for a verified identity. For information about using a custom MAIL -// FROM domain, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/mail-from.html) +// FROM domain, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/mail-from.html) // . type SetIdentityMailFromDomainInput struct { - // The verified identity for which you want to enable or disable the specified - // custom MAIL FROM domain. + // The verified identity. // // This member is required. Identity *string - // The action that you want Amazon SES to take if it cannot successfully read the - // required MX record when you send an email. If you choose UseDefaultValue , - // Amazon SES will use amazonses.com (or a subdomain of that) as the MAIL FROM - // domain. If you choose RejectMessage , Amazon SES will return a - // MailFromDomainNotVerified error and not send the email. The action specified in - // BehaviorOnMXFailure is taken when the custom MAIL FROM domain setup is in the - // Pending , Failed , and TemporaryFailure states. + // The action for Amazon SES to take if it cannot successfully read the required + // MX record when you send an email. If you choose UseDefaultValue , Amazon SES + // uses amazonses.com (or a subdomain of that) as the MAIL FROM domain. If you + // choose RejectMessage , Amazon SES returns a MailFromDomainNotVerified error and + // not send the email. The action specified in BehaviorOnMXFailure is taken when + // the custom MAIL FROM domain setup is in the Pending , Failed , and + // TemporaryFailure states. BehaviorOnMXFailure types.BehaviorOnMXFailure - // The custom MAIL FROM domain that you want the verified identity to use. The - // MAIL FROM domain must 1) be a subdomain of the verified identity, 2) not be used - // in a "From" address if the MAIL FROM domain is the destination of email feedback - // forwarding (for more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/mail-from.html) + // The custom MAIL FROM domain for the verified identity to use. The MAIL FROM + // domain must 1) be a subdomain of the verified identity, 2) not be used in a + // "From" address if the MAIL FROM domain is the destination of email feedback + // forwarding (for more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/mail-from.html) // ), and 3) not be used to receive emails. A value of null disables the custom // MAIL FROM setting for the identity. MailFromDomain *string diff --git a/service/ses/api_op_SetIdentityNotificationTopic.go b/service/ses/api_op_SetIdentityNotificationTopic.go index 8b98fc99a1b..3d6494f9179 100644 --- a/service/ses/api_op_SetIdentityNotificationTopic.go +++ b/service/ses/api_op_SetIdentityNotificationTopic.go @@ -23,7 +23,7 @@ import ( // topic you specified. You can send bounce, complaint, or delivery notifications // (or any combination of the three) to the Amazon SNS topic that you specify. You // can execute this operation no more than once per second. For more information -// about feedback notification, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/notifications.html) +// about feedback notification, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity-using-notifications.html) // . func (c *Client) SetIdentityNotificationTopic(ctx context.Context, params *SetIdentityNotificationTopicInput, optFns ...func(*Options)) (*SetIdentityNotificationTopicOutput, error) { if params == nil { @@ -40,24 +40,23 @@ func (c *Client) SetIdentityNotificationTopic(ctx context.Context, params *SetId return out, nil } -// Represents a request to specify the Amazon SNS topic to which Amazon SES will -// publish bounce, complaint, or delivery notifications for emails sent with that -// identity as the Source. For information about Amazon SES notifications, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/notifications-via-sns.html) +// Represents a request to specify the Amazon SNS topic to which Amazon SES +// publishes bounce, complaint, or delivery notifications for emails sent with that +// identity as the source. For information about Amazon SES notifications, see the +// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity-using-notifications-sns.html) // . type SetIdentityNotificationTopicInput struct { - // The identity (email address or domain) that you want to set the Amazon SNS - // topic for. You can only specify a verified identity for this parameter. You can - // specify an identity by using its name or by using its Amazon Resource Name - // (ARN). The following examples are all valid identities: sender@example.com , - // example.com , arn:aws:ses:us-east-1:123456789012:identity/example.com . + // The identity (email address or domain) for the Amazon SNS topic. You can only + // specify a verified identity for this parameter. You can specify an identity by + // using its name or by using its Amazon Resource Name (ARN). The following + // examples are all valid identities: sender@example.com , example.com , + // arn:aws:ses:us-east-1:123456789012:identity/example.com . // // This member is required. Identity *string - // The type of notifications that will be published to the specified Amazon SNS - // topic. + // The type of notifications that are published to the specified Amazon SNS topic. // // This member is required. NotificationType types.NotificationType diff --git a/service/ses/api_op_SetReceiptRulePosition.go b/service/ses/api_op_SetReceiptRulePosition.go index 4559fdb2932..35df1ce9166 100644 --- a/service/ses/api_op_SetReceiptRulePosition.go +++ b/service/ses/api_op_SetReceiptRulePosition.go @@ -16,7 +16,7 @@ import ( ) // Sets the position of the specified receipt rule in the receipt rule set. For -// information about managing receipt rules, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rules.html) +// information about managing receipt rules, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-receipt-rules-console-walkthrough.html) // . You can execute this operation no more than once per second. func (c *Client) SetReceiptRulePosition(ctx context.Context, params *SetReceiptRulePositionInput, optFns ...func(*Options)) (*SetReceiptRulePositionOutput, error) { if params == nil { @@ -35,7 +35,7 @@ func (c *Client) SetReceiptRulePosition(ctx context.Context, params *SetReceiptR // Represents a request to set the position of a receipt rule in a receipt rule // set. You use receipt rule sets to receive email with Amazon SES. For more -// information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-concepts.html) +// information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html) // . type SetReceiptRulePositionInput struct { diff --git a/service/ses/api_op_TestRenderTemplate.go b/service/ses/api_op_TestRenderTemplate.go index a29b94520cf..7127dfb7196 100644 --- a/service/ses/api_op_TestRenderTemplate.go +++ b/service/ses/api_op_TestRenderTemplate.go @@ -42,7 +42,7 @@ type TestRenderTemplateInput struct { // This member is required. TemplateData *string - // The name of the template that you want to render. + // The name of the template to render. // // This member is required. TemplateName *string diff --git a/service/ses/api_op_UpdateAccountSendingEnabled.go b/service/ses/api_op_UpdateAccountSendingEnabled.go index 8f45bc96cc8..ab8913cf12c 100644 --- a/service/ses/api_op_UpdateAccountSendingEnabled.go +++ b/service/ses/api_op_UpdateAccountSendingEnabled.go @@ -16,11 +16,11 @@ import ( ) // Enables or disables email sending across your entire Amazon SES account in the -// current AWS Region. You can use this operation in conjunction with Amazon -// CloudWatch alarms to temporarily pause email sending across your Amazon SES -// account in a given AWS Region when reputation metrics (such as your bounce or -// complaint rates) reach certain thresholds. You can execute this operation no -// more than once per second. +// current Amazon Web Services Region. You can use this operation in conjunction +// with Amazon CloudWatch alarms to temporarily pause email sending across your +// Amazon SES account in a given Amazon Web Services Region when reputation metrics +// (such as your bounce or complaint rates) reach certain thresholds. You can +// execute this operation no more than once per second. func (c *Client) UpdateAccountSendingEnabled(ctx context.Context, params *UpdateAccountSendingEnabledInput, optFns ...func(*Options)) (*UpdateAccountSendingEnabledOutput, error) { if params == nil { params = &UpdateAccountSendingEnabledInput{} @@ -41,7 +41,7 @@ func (c *Client) UpdateAccountSendingEnabled(ctx context.Context, params *Update type UpdateAccountSendingEnabledInput struct { // Describes whether email sending is enabled or disabled for your Amazon SES - // account in the current AWS Region. + // account in the current Amazon Web Services Region. Enabled bool noSmithyDocumentSerde diff --git a/service/ses/api_op_UpdateConfigurationSetEventDestination.go b/service/ses/api_op_UpdateConfigurationSetEventDestination.go index 53aac99bf6b..81d252389cb 100644 --- a/service/ses/api_op_UpdateConfigurationSetEventDestination.go +++ b/service/ses/api_op_UpdateConfigurationSetEventDestination.go @@ -20,7 +20,7 @@ import ( // associated with configuration sets, which enable you to publish email sending // events to Amazon CloudWatch, Amazon Kinesis Firehose, or Amazon Simple // Notification Service (Amazon SNS). For information about using configuration -// sets, see Monitoring Your Amazon SES Sending Activity (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// sets, see Monitoring Your Amazon SES Sending Activity (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // in the Amazon SES Developer Guide. When you create or update an event // destination, you must provide one, and only one, destination. The destination // can be Amazon CloudWatch, Amazon Kinesis Firehose, or Amazon Simple Notification @@ -43,18 +43,16 @@ func (c *Client) UpdateConfigurationSetEventDestination(ctx context.Context, par // Represents a request to update the event destination of a configuration set. // Configuration sets enable you to publish email sending events. For information -// about using configuration sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// about using configuration sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . type UpdateConfigurationSetEventDestinationInput struct { - // The name of the configuration set that contains the event destination that you - // want to update. + // The name of the configuration set that contains the event destination. // // This member is required. ConfigurationSetName *string - // The event destination object that you want to apply to the specified - // configuration set. + // The event destination object. // // This member is required. EventDestination *types.EventDestination diff --git a/service/ses/api_op_UpdateConfigurationSetReputationMetricsEnabled.go b/service/ses/api_op_UpdateConfigurationSetReputationMetricsEnabled.go index 9636e0e5137..255b9a5bfb0 100644 --- a/service/ses/api_op_UpdateConfigurationSetReputationMetricsEnabled.go +++ b/service/ses/api_op_UpdateConfigurationSetReputationMetricsEnabled.go @@ -16,10 +16,11 @@ import ( ) // Enables or disables the publishing of reputation metrics for emails sent using -// a specific configuration set in a given AWS Region. Reputation metrics include -// bounce and complaint rates. These metrics are published to Amazon CloudWatch. By -// using CloudWatch, you can create alarms when bounce or complaint rates exceed -// certain thresholds. You can execute this operation no more than once per second. +// a specific configuration set in a given Amazon Web Services Region. Reputation +// metrics include bounce and complaint rates. These metrics are published to +// Amazon CloudWatch. By using CloudWatch, you can create alarms when bounce or +// complaint rates exceed certain thresholds. You can execute this operation no +// more than once per second. func (c *Client) UpdateConfigurationSetReputationMetricsEnabled(ctx context.Context, params *UpdateConfigurationSetReputationMetricsEnabledInput, optFns ...func(*Options)) (*UpdateConfigurationSetReputationMetricsEnabledOutput, error) { if params == nil { params = &UpdateConfigurationSetReputationMetricsEnabledInput{} @@ -39,12 +40,12 @@ func (c *Client) UpdateConfigurationSetReputationMetricsEnabled(ctx context.Cont // configuration set. type UpdateConfigurationSetReputationMetricsEnabledInput struct { - // The name of the configuration set that you want to update. + // The name of the configuration set to update. // // This member is required. ConfigurationSetName *string - // Describes whether or not Amazon SES will publish reputation metrics for the + // Describes whether or not Amazon SES publishes reputation metrics for the // configuration set, such as bounce and complaint rates, to Amazon CloudWatch. // // This member is required. diff --git a/service/ses/api_op_UpdateConfigurationSetSendingEnabled.go b/service/ses/api_op_UpdateConfigurationSetSendingEnabled.go index a1f06506c3f..bb8e32357fa 100644 --- a/service/ses/api_op_UpdateConfigurationSetSendingEnabled.go +++ b/service/ses/api_op_UpdateConfigurationSetSendingEnabled.go @@ -16,11 +16,11 @@ import ( ) // Enables or disables email sending for messages sent using a specific -// configuration set in a given AWS Region. You can use this operation in -// conjunction with Amazon CloudWatch alarms to temporarily pause email sending for -// a configuration set when the reputation metrics for that configuration set (such -// as your bounce on complaint rate) exceed certain thresholds. You can execute -// this operation no more than once per second. +// configuration set in a given Amazon Web Services Region. You can use this +// operation in conjunction with Amazon CloudWatch alarms to temporarily pause +// email sending for a configuration set when the reputation metrics for that +// configuration set (such as your bounce on complaint rate) exceed certain +// thresholds. You can execute this operation no more than once per second. func (c *Client) UpdateConfigurationSetSendingEnabled(ctx context.Context, params *UpdateConfigurationSetSendingEnabledInput, optFns ...func(*Options)) (*UpdateConfigurationSetSendingEnabledOutput, error) { if params == nil { params = &UpdateConfigurationSetSendingEnabledInput{} @@ -40,7 +40,7 @@ func (c *Client) UpdateConfigurationSetSendingEnabled(ctx context.Context, param // specific configuration set. type UpdateConfigurationSetSendingEnabledInput struct { - // The name of the configuration set that you want to update. + // The name of the configuration set to update. // // This member is required. ConfigurationSetName *string diff --git a/service/ses/api_op_UpdateConfigurationSetTrackingOptions.go b/service/ses/api_op_UpdateConfigurationSetTrackingOptions.go index bd0702577a0..f3854f56466 100644 --- a/service/ses/api_op_UpdateConfigurationSetTrackingOptions.go +++ b/service/ses/api_op_UpdateConfigurationSetTrackingOptions.go @@ -20,7 +20,7 @@ import ( // open and click event tracking. By default, images and links used for tracking // open and click events are hosted on domains operated by Amazon SES. You can // configure a subdomain of your own to handle these events. For information about -// using custom domains, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/configure-custom-open-click-domains.html) +// using custom domains, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/configure-custom-open-click-domains.html) // . func (c *Client) UpdateConfigurationSetTrackingOptions(ctx context.Context, params *UpdateConfigurationSetTrackingOptionsInput, optFns ...func(*Options)) (*UpdateConfigurationSetTrackingOptionsOutput, error) { if params == nil { @@ -40,8 +40,7 @@ func (c *Client) UpdateConfigurationSetTrackingOptions(ctx context.Context, para // Represents a request to update the tracking options for a configuration set. type UpdateConfigurationSetTrackingOptionsInput struct { - // The name of the configuration set for which you want to update the custom - // tracking domain. + // The name of the configuration set. // // This member is required. ConfigurationSetName *string @@ -49,7 +48,7 @@ type UpdateConfigurationSetTrackingOptionsInput struct { // A domain that is used to redirect email recipients to an Amazon SES-operated // domain. This domain captures open and click events generated by Amazon SES // emails. For more information, see Configuring Custom Domains to Handle Open and - // Click Tracking (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/configure-custom-open-click-domains.html) + // Click Tracking (https://docs.aws.amazon.com/ses/latest/dg/configure-custom-open-click-domains.html) // in the Amazon SES Developer Guide. // // This member is required. diff --git a/service/ses/api_op_UpdateCustomVerificationEmailTemplate.go b/service/ses/api_op_UpdateCustomVerificationEmailTemplate.go index ddc43eb9f05..c4c6aea2094 100644 --- a/service/ses/api_op_UpdateCustomVerificationEmailTemplate.go +++ b/service/ses/api_op_UpdateCustomVerificationEmailTemplate.go @@ -17,7 +17,7 @@ import ( // Updates an existing custom verification email template. For more information // about custom verification email templates, see Using Custom Verification Email -// Templates (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/custom-verification-emails.html) +// Templates (https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#send-email-verify-address-custom) // in the Amazon SES Developer Guide. You can execute this operation no more than // once per second. func (c *Client) UpdateCustomVerificationEmailTemplate(ctx context.Context, params *UpdateCustomVerificationEmailTemplateInput, optFns ...func(*Options)) (*UpdateCustomVerificationEmailTemplateOutput, error) { @@ -38,7 +38,7 @@ func (c *Client) UpdateCustomVerificationEmailTemplate(ctx context.Context, para // Represents a request to update an existing custom verification email template. type UpdateCustomVerificationEmailTemplateInput struct { - // The name of the custom verification email template that you want to update. + // The name of the custom verification email template to update. // // This member is required. TemplateName *string @@ -56,7 +56,7 @@ type UpdateCustomVerificationEmailTemplateInput struct { // The content of the custom verification email. The total size of the email must // be less than 10 MB. The message body may contain HTML, with some limitations. - // For more information, see Custom Verification Email Frequently Asked Questions (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/custom-verification-emails.html#custom-verification-emails-faq) + // For more information, see Custom Verification Email Frequently Asked Questions (https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#send-email-verify-address-custom) // in the Amazon SES Developer Guide. TemplateContent *string diff --git a/service/ses/api_op_UpdateReceiptRule.go b/service/ses/api_op_UpdateReceiptRule.go index 360222344f9..ecd49a75872 100644 --- a/service/ses/api_op_UpdateReceiptRule.go +++ b/service/ses/api_op_UpdateReceiptRule.go @@ -17,7 +17,7 @@ import ( ) // Updates a receipt rule. For information about managing receipt rules, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-managing-receipt-rules.html) +// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-receipt-rules-console-walkthrough.html) // . You can execute this operation no more than once per second. func (c *Client) UpdateReceiptRule(ctx context.Context, params *UpdateReceiptRuleInput, optFns ...func(*Options)) (*UpdateReceiptRuleOutput, error) { if params == nil { @@ -35,7 +35,7 @@ func (c *Client) UpdateReceiptRule(ctx context.Context, params *UpdateReceiptRul } // Represents a request to update a receipt rule. You use receipt rules to receive -// email with Amazon SES. For more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-concepts.html) +// email with Amazon SES. For more information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html) // . type UpdateReceiptRuleInput struct { diff --git a/service/ses/api_op_UpdateTemplate.go b/service/ses/api_op_UpdateTemplate.go index eb2fb900b1c..ad7e717b6cb 100644 --- a/service/ses/api_op_UpdateTemplate.go +++ b/service/ses/api_op_UpdateTemplate.go @@ -17,8 +17,8 @@ import ( ) // Updates an email template. Email templates enable you to send personalized -// email to one or more destinations in a single API operation. For more -// information, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-personalized-email-api.html) +// email to one or more destinations in a single operation. For more information, +// see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/send-personalized-email-api.html) // . You can execute this operation no more than once per second. func (c *Client) UpdateTemplate(ctx context.Context, params *UpdateTemplateInput, optFns ...func(*Options)) (*UpdateTemplateOutput, error) { if params == nil { @@ -37,8 +37,8 @@ func (c *Client) UpdateTemplate(ctx context.Context, params *UpdateTemplateInput type UpdateTemplateInput struct { - // The content of the email, composed of a subject line, an HTML part, and a - // text-only part. + // The content of the email, composed of a subject line and either an HTML part or + // a text-only part. // // This member is required. Template *types.Template diff --git a/service/ses/api_op_VerifyDomainDkim.go b/service/ses/api_op_VerifyDomainDkim.go index ba5501f1feb..09ed35835e3 100644 --- a/service/ses/api_op_VerifyDomainDkim.go +++ b/service/ses/api_op_VerifyDomainDkim.go @@ -20,8 +20,8 @@ import ( // identities that are associated with your account. This is true even if you // haven't already associated the domain with your account by using the // VerifyDomainIdentity operation. However, you can't send email from the domain -// until you either successfully verify it (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-domains.html) -// or you successfully set up DKIM for it (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html) +// until you either successfully verify it (https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#verify-domain-procedure) +// or you successfully set up DKIM for it (https://docs.aws.amazon.com/ses/latest/dg/send-email-authentication-dkim-easy.html) // . You use the tokens that are generated by this operation to create CNAME // records. When Amazon SES detects that you've added these records to the DNS // configuration for a domain, you can start sending email from that domain. You @@ -54,7 +54,7 @@ func (c *Client) VerifyDomainDkim(ctx context.Context, params *VerifyDomainDkimI // Represents a request to generate the CNAME records needed to set up Easy DKIM // with Amazon SES. For more information about setting up Easy DKIM, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html) +// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/send-email-authentication-dkim-easy.html) // . type VerifyDomainDkimInput struct { @@ -78,7 +78,7 @@ type VerifyDomainDkimOutput struct { // up to 72 hours. After successful detection, Amazon SES is able to DKIM-sign // email originating from that domain. (This only applies to domain identities, not // email address identities.) For more information about creating DNS records using - // DKIM tokens, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html) + // DKIM tokens, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/send-email-authentication-dkim-easy.html) // . // // This member is required. diff --git a/service/ses/api_op_VerifyDomainIdentity.go b/service/ses/api_op_VerifyDomainIdentity.go index 269ab50c647..91888d85473 100644 --- a/service/ses/api_op_VerifyDomainIdentity.go +++ b/service/ses/api_op_VerifyDomainIdentity.go @@ -16,8 +16,8 @@ import ( ) // Adds a domain to the list of identities for your Amazon SES account in the -// current AWS Region and attempts to verify it. For more information about -// verifying domains, see Verifying Email Addresses and Domains (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-addresses-and-domains.html) +// current Amazon Web Services Region and attempts to verify it. For more +// information about verifying domains, see Verifying Email Addresses and Domains (https://docs.aws.amazon.com/ses/latest/dg/verify-addresses-and-domains.html) // in the Amazon SES Developer Guide. You can execute this operation no more than // once per second. func (c *Client) VerifyDomainIdentity(ctx context.Context, params *VerifyDomainIdentityInput, optFns ...func(*Options)) (*VerifyDomainIdentityOutput, error) { @@ -38,7 +38,7 @@ func (c *Client) VerifyDomainIdentity(ctx context.Context, params *VerifyDomainI // Represents a request to begin Amazon SES domain verification and to generate // the TXT records that you must publish to the DNS server of your domain to // complete the verification. For information about domain verification, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-domains.html) +// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#verify-domain-procedure) // . type VerifyDomainIdentityInput struct { @@ -59,8 +59,9 @@ type VerifyDomainIdentityOutput struct { // the domain's verification status is "Pending". When Amazon SES detects the // record, the domain's verification status changes to "Success". If Amazon SES is // unable to detect the record within 72 hours, the domain's verification status - // changes to "Failed." In that case, if you still want to verify the domain, you - // must restart the verification process from the beginning. + // changes to "Failed." In that case, to verify the domain, you must restart the + // verification process from the beginning. The domain's verification status also + // changes to "Success" when it is DKIM verified. // // This member is required. VerificationToken *string diff --git a/service/ses/api_op_VerifyEmailAddress.go b/service/ses/api_op_VerifyEmailAddress.go index cb729f0b177..a358d46810f 100644 --- a/service/ses/api_op_VerifyEmailAddress.go +++ b/service/ses/api_op_VerifyEmailAddress.go @@ -32,7 +32,7 @@ func (c *Client) VerifyEmailAddress(ctx context.Context, params *VerifyEmailAddr } // Represents a request to begin email address verification with Amazon SES. For -// information about email address verification, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-email-addresses.html) +// information about email address verification, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#verify-email-addresses-procedure) // . type VerifyEmailAddressInput struct { diff --git a/service/ses/api_op_VerifyEmailIdentity.go b/service/ses/api_op_VerifyEmailIdentity.go index d0f56727e9d..d2c6cf23fc5 100644 --- a/service/ses/api_op_VerifyEmailIdentity.go +++ b/service/ses/api_op_VerifyEmailIdentity.go @@ -16,9 +16,9 @@ import ( ) // Adds an email address to the list of identities for your Amazon SES account in -// the current AWS region and attempts to verify it. As a result of executing this -// operation, a verification email is sent to the specified address. You can -// execute this operation no more than once per second. +// the current Amazon Web Services Region and attempts to verify it. As a result of +// executing this operation, a verification email is sent to the specified address. +// You can execute this operation no more than once per second. func (c *Client) VerifyEmailIdentity(ctx context.Context, params *VerifyEmailIdentityInput, optFns ...func(*Options)) (*VerifyEmailIdentityOutput, error) { if params == nil { params = &VerifyEmailIdentityInput{} @@ -35,7 +35,7 @@ func (c *Client) VerifyEmailIdentity(ctx context.Context, params *VerifyEmailIde } // Represents a request to begin email address verification with Amazon SES. For -// information about email address verification, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-email-addresses.html) +// information about email address verification, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#verify-email-addresses-procedure) // . type VerifyEmailIdentityInput struct { diff --git a/service/ses/doc.go b/service/ses/doc.go index d24d6af9024..9c58986b8f1 100644 --- a/service/ses/doc.go +++ b/service/ses/doc.go @@ -10,5 +10,9 @@ // . For a list of Amazon SES endpoints to use in service requests, see Regions // and Amazon SES (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/regions.html) // in the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/Welcome.html) -// . +// . This documentation contains reference information related to the following: +// - Amazon SES API Actions (https://docs.aws.amazon.com/ses/latest/APIReference/API_Operations.html) +// - Amazon SES API Data Types (https://docs.aws.amazon.com/ses/latest/APIReference/API_Types.html) +// - Common Parameters (https://docs.aws.amazon.com/ses/latest/APIReference/CommonParameters.html) +// - Common Errors (https://docs.aws.amazon.com/ses/latest/APIReference/CommonErrors.html) package ses diff --git a/service/ses/endpoints_test.go b/service/ses/endpoints_test.go index 8bdcaefc5a9..14256baa4bf 100644 --- a/service/ses/endpoints_test.go +++ b/service/ses/endpoints_test.go @@ -18,8 +18,8 @@ import ( func TestEndpointCase0(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("af-south-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -57,8 +57,8 @@ func TestEndpointCase0(t *testing.T) { func TestEndpointCase1(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("ap-northeast-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -96,8 +96,8 @@ func TestEndpointCase1(t *testing.T) { func TestEndpointCase2(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("ap-northeast-2"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -135,8 +135,8 @@ func TestEndpointCase2(t *testing.T) { func TestEndpointCase3(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("ap-northeast-3"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -174,8 +174,8 @@ func TestEndpointCase3(t *testing.T) { func TestEndpointCase4(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("ap-south-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -213,8 +213,8 @@ func TestEndpointCase4(t *testing.T) { func TestEndpointCase5(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("ap-southeast-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -252,8 +252,8 @@ func TestEndpointCase5(t *testing.T) { func TestEndpointCase6(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("ap-southeast-2"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -291,8 +291,8 @@ func TestEndpointCase6(t *testing.T) { func TestEndpointCase7(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("ca-central-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -330,8 +330,8 @@ func TestEndpointCase7(t *testing.T) { func TestEndpointCase8(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("eu-central-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -369,8 +369,8 @@ func TestEndpointCase8(t *testing.T) { func TestEndpointCase9(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("eu-north-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -408,8 +408,8 @@ func TestEndpointCase9(t *testing.T) { func TestEndpointCase10(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("eu-south-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -447,8 +447,8 @@ func TestEndpointCase10(t *testing.T) { func TestEndpointCase11(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("eu-west-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -486,8 +486,8 @@ func TestEndpointCase11(t *testing.T) { func TestEndpointCase12(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("eu-west-2"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -525,8 +525,8 @@ func TestEndpointCase12(t *testing.T) { func TestEndpointCase13(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("eu-west-3"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -564,8 +564,8 @@ func TestEndpointCase13(t *testing.T) { func TestEndpointCase14(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("me-south-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -603,8 +603,8 @@ func TestEndpointCase14(t *testing.T) { func TestEndpointCase15(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("sa-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -642,8 +642,8 @@ func TestEndpointCase15(t *testing.T) { func TestEndpointCase16(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -681,8 +681,8 @@ func TestEndpointCase16(t *testing.T) { func TestEndpointCase17(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -720,8 +720,8 @@ func TestEndpointCase17(t *testing.T) { func TestEndpointCase18(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-east-2"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -759,8 +759,8 @@ func TestEndpointCase18(t *testing.T) { func TestEndpointCase19(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-west-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -798,8 +798,8 @@ func TestEndpointCase19(t *testing.T) { func TestEndpointCase20(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-west-2"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -837,8 +837,8 @@ func TestEndpointCase20(t *testing.T) { func TestEndpointCase21(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-west-2"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -876,8 +876,8 @@ func TestEndpointCase21(t *testing.T) { func TestEndpointCase22(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-east-1"), - UseDualStack: ptr.Bool(true), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(true), } resolver := NewDefaultEndpointResolverV2() @@ -915,8 +915,8 @@ func TestEndpointCase22(t *testing.T) { func TestEndpointCase23(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-east-1"), - UseDualStack: ptr.Bool(true), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(true), } resolver := NewDefaultEndpointResolverV2() @@ -954,8 +954,8 @@ func TestEndpointCase23(t *testing.T) { func TestEndpointCase24(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("cn-north-1"), - UseDualStack: ptr.Bool(true), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(true), } resolver := NewDefaultEndpointResolverV2() @@ -993,8 +993,8 @@ func TestEndpointCase24(t *testing.T) { func TestEndpointCase25(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("cn-north-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -1032,8 +1032,8 @@ func TestEndpointCase25(t *testing.T) { func TestEndpointCase26(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("cn-north-1"), - UseDualStack: ptr.Bool(true), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(true), } resolver := NewDefaultEndpointResolverV2() @@ -1071,8 +1071,8 @@ func TestEndpointCase26(t *testing.T) { func TestEndpointCase27(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("cn-north-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -1110,8 +1110,8 @@ func TestEndpointCase27(t *testing.T) { func TestEndpointCase28(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-gov-west-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -1149,8 +1149,8 @@ func TestEndpointCase28(t *testing.T) { func TestEndpointCase29(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-gov-west-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -1188,8 +1188,8 @@ func TestEndpointCase29(t *testing.T) { func TestEndpointCase30(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-gov-east-1"), - UseDualStack: ptr.Bool(true), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(true), } resolver := NewDefaultEndpointResolverV2() @@ -1227,8 +1227,8 @@ func TestEndpointCase30(t *testing.T) { func TestEndpointCase31(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-gov-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -1266,8 +1266,8 @@ func TestEndpointCase31(t *testing.T) { func TestEndpointCase32(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-gov-east-1"), - UseDualStack: ptr.Bool(true), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(true), } resolver := NewDefaultEndpointResolverV2() @@ -1305,8 +1305,8 @@ func TestEndpointCase32(t *testing.T) { func TestEndpointCase33(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-gov-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -1340,12 +1340,32 @@ func TestEndpointCase33(t *testing.T) { } } -// For region us-iso-east-1 with FIPS enabled and DualStack disabled +// For region us-iso-east-1 with FIPS enabled and DualStack enabled func TestEndpointCase34(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-iso-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(true), + } + + resolver := NewDefaultEndpointResolverV2() + result, err := resolver.ResolveEndpoint(context.Background(), params) + _, _ = result, err + + if err == nil { + t.Fatalf("expect error, got none") + } + if e, a := "FIPS and DualStack are enabled, but this partition does not support one or both", err.Error(); !strings.Contains(a, e) { + t.Errorf("expect %v error in %v", e, a) + } +} + +// For region us-iso-east-1 with FIPS enabled and DualStack disabled +func TestEndpointCase35(t *testing.T) { + var params = EndpointParameters{ + Region: ptr.String("us-iso-east-1"), + UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -1379,12 +1399,32 @@ func TestEndpointCase34(t *testing.T) { } } +// For region us-iso-east-1 with FIPS disabled and DualStack enabled +func TestEndpointCase36(t *testing.T) { + var params = EndpointParameters{ + Region: ptr.String("us-iso-east-1"), + UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(true), + } + + resolver := NewDefaultEndpointResolverV2() + result, err := resolver.ResolveEndpoint(context.Background(), params) + _, _ = result, err + + if err == nil { + t.Fatalf("expect error, got none") + } + if e, a := "DualStack is enabled but this partition does not support DualStack", err.Error(); !strings.Contains(a, e) { + t.Errorf("expect %v error in %v", e, a) + } +} + // For region us-iso-east-1 with FIPS disabled and DualStack disabled -func TestEndpointCase35(t *testing.T) { +func TestEndpointCase37(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-iso-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -1418,12 +1458,32 @@ func TestEndpointCase35(t *testing.T) { } } +// For region us-isob-east-1 with FIPS enabled and DualStack enabled +func TestEndpointCase38(t *testing.T) { + var params = EndpointParameters{ + Region: ptr.String("us-isob-east-1"), + UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(true), + } + + resolver := NewDefaultEndpointResolverV2() + result, err := resolver.ResolveEndpoint(context.Background(), params) + _, _ = result, err + + if err == nil { + t.Fatalf("expect error, got none") + } + if e, a := "FIPS and DualStack are enabled, but this partition does not support one or both", err.Error(); !strings.Contains(a, e) { + t.Errorf("expect %v error in %v", e, a) + } +} + // For region us-isob-east-1 with FIPS enabled and DualStack disabled -func TestEndpointCase36(t *testing.T) { +func TestEndpointCase39(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-isob-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -1457,12 +1517,32 @@ func TestEndpointCase36(t *testing.T) { } } +// For region us-isob-east-1 with FIPS disabled and DualStack enabled +func TestEndpointCase40(t *testing.T) { + var params = EndpointParameters{ + Region: ptr.String("us-isob-east-1"), + UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(true), + } + + resolver := NewDefaultEndpointResolverV2() + result, err := resolver.ResolveEndpoint(context.Background(), params) + _, _ = result, err + + if err == nil { + t.Fatalf("expect error, got none") + } + if e, a := "DualStack is enabled but this partition does not support DualStack", err.Error(); !strings.Contains(a, e) { + t.Errorf("expect %v error in %v", e, a) + } +} + // For region us-isob-east-1 with FIPS disabled and DualStack disabled -func TestEndpointCase37(t *testing.T) { +func TestEndpointCase41(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-isob-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), } resolver := NewDefaultEndpointResolverV2() @@ -1497,11 +1577,11 @@ func TestEndpointCase37(t *testing.T) { } // For custom endpoint with region set and fips disabled and dualstack disabled -func TestEndpointCase38(t *testing.T) { +func TestEndpointCase42(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), Endpoint: ptr.String("https://example.com"), } @@ -1537,10 +1617,10 @@ func TestEndpointCase38(t *testing.T) { } // For custom endpoint with region not set and fips disabled and dualstack disabled -func TestEndpointCase39(t *testing.T) { +func TestEndpointCase43(t *testing.T) { var params = EndpointParameters{ - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(false), Endpoint: ptr.String("https://example.com"), } @@ -1576,11 +1656,11 @@ func TestEndpointCase39(t *testing.T) { } // For custom endpoint with fips enabled and dualstack disabled -func TestEndpointCase40(t *testing.T) { +func TestEndpointCase44(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-east-1"), - UseDualStack: ptr.Bool(false), UseFIPS: ptr.Bool(true), + UseDualStack: ptr.Bool(false), Endpoint: ptr.String("https://example.com"), } @@ -1597,11 +1677,11 @@ func TestEndpointCase40(t *testing.T) { } // For custom endpoint with fips disabled and dualstack enabled -func TestEndpointCase41(t *testing.T) { +func TestEndpointCase45(t *testing.T) { var params = EndpointParameters{ Region: ptr.String("us-east-1"), - UseDualStack: ptr.Bool(true), UseFIPS: ptr.Bool(false), + UseDualStack: ptr.Bool(true), Endpoint: ptr.String("https://example.com"), } @@ -1616,3 +1696,19 @@ func TestEndpointCase41(t *testing.T) { t.Errorf("expect %v error in %v", e, a) } } + +// Missing region +func TestEndpointCase46(t *testing.T) { + var params = EndpointParameters{} + + resolver := NewDefaultEndpointResolverV2() + result, err := resolver.ResolveEndpoint(context.Background(), params) + _, _ = result, err + + if err == nil { + t.Fatalf("expect error, got none") + } + if e, a := "Invalid Configuration: Missing Region", err.Error(); !strings.Contains(a, e) { + t.Errorf("expect %v error in %v", e, a) + } +} diff --git a/service/ses/types/errors.go b/service/ses/types/errors.go index ba48f4ce243..f3158800915 100644 --- a/service/ses/types/errors.go +++ b/service/ses/types/errors.go @@ -486,9 +486,10 @@ func (e *InvalidFirehoseDestinationException) ErrorFault() smithy.ErrorFault { return smithy.FaultClient } -// Indicates that the provided AWS Lambda function is invalid, or that Amazon SES -// could not execute the provided function, possibly due to permissions issues. For -// information about giving permissions, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-permissions.html) +// Indicates that the provided Amazon Web Services Lambda function is invalid, or +// that Amazon SES could not execute the provided function, possibly due to +// permissions issues. For information about giving permissions, see the Amazon +// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-permissions.html) // . type InvalidLambdaFunctionException struct { Message *string @@ -575,10 +576,10 @@ func (e *InvalidRenderingParameterException) ErrorFault() smithy.ErrorFault { return smithy.FaultClient } -// Indicates that the provided Amazon S3 bucket or AWS KMS encryption key is -// invalid, or that Amazon SES could not publish to the bucket, possibly due to -// permissions issues. For information about giving permissions, see the Amazon -// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-permissions.html) +// Indicates that the provided Amazon S3 bucket or Amazon Web Services KMS +// encryption key is invalid, or that Amazon SES could not publish to the bucket, +// possibly due to permissions issues. For information about giving permissions, +// see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-permissions.html) // . type InvalidS3ConfigurationException struct { Message *string diff --git a/service/ses/types/types.go b/service/ses/types/types.go index 8b4f317f160..f500a9ce833 100644 --- a/service/ses/types/types.go +++ b/service/ses/types/types.go @@ -9,18 +9,19 @@ import ( // When included in a receipt rule, this action adds a header to the received // email. For information about adding a header using a receipt rule, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-action-add-header.html) +// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-action-add-header.html) // . type AddHeaderAction struct { - // The name of the header to add. Must be between 1 and 50 characters, inclusive, - // and consist of alphanumeric (a-z, A-Z, 0-9) characters and dashes only. + // The name of the header to add to the incoming message. The name must contain at + // least one character, and can contain up to 50 characters. It consists of + // alphanumeric (a–z, A–Z, 0–9) characters and dashes. // // This member is required. HeaderName *string - // Must be less than 2048 characters, and must not contain newline characters - // ("\r" or "\n"). + // The content to include in the header. This value can contain up to 2048 + // characters. It can't contain newline ( \n ) or carriage return ( \r ) characters. // // This member is required. HeaderValue *string @@ -49,7 +50,7 @@ type Body struct { // returning a bounce response to the sender and, optionally, publishes a // notification to Amazon Simple Notification Service (Amazon SNS). For information // about sending a bounce message in response to a received email, see the Amazon -// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-action-bounce.html) +// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-action-bounce.html) // . type BounceAction struct { @@ -59,7 +60,7 @@ type BounceAction struct { Message *string // The email address of the sender of the bounced email. This is the address from - // which the bounce message will be sent. + // which the bounce message is sent. // // This member is required. Sender *string @@ -75,9 +76,9 @@ type BounceAction struct { StatusCode *string // The Amazon Resource Name (ARN) of the Amazon SNS topic to notify when the - // bounce action is taken. An example of an Amazon SNS topic ARN is - // arn:aws:sns:us-west-2:123456789012:MyTopic . For more information about Amazon - // SNS topics, see the Amazon SNS Developer Guide (https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) + // bounce action is taken. You can find the ARN of a topic by using the ListTopics (https://docs.aws.amazon.com/sns/latest/api/API_ListTopics.html) + // operation in Amazon SNS. For more information about Amazon SNS topics, see the + // Amazon SNS Developer Guide (https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) // . TopicArn *string @@ -87,7 +88,7 @@ type BounceAction struct { // Recipient-related information to include in the Delivery Status Notification // (DSN) when an email that Amazon SES receives on your behalf bounces. For // information about receiving email through Amazon SES, see the Amazon SES -// Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email.html) +// Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email.html) // . type BouncedRecipientInfo struct { @@ -103,7 +104,7 @@ type BouncedRecipientInfo struct { // This parameter is used only for sending authorization. It is the ARN of the // identity that is associated with the sending authorization policy that permits // you to receive email for the recipient of the bounced email. For more - // information about sending authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-authorization.html) + // information about sending authorization, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/sending-authorization.html) // . RecipientArn *string @@ -121,12 +122,16 @@ type BulkEmailDestination struct { // Represents the destination of the message, consisting of To:, CC:, and BCC: // fields. Amazon SES does not support the SMTPUTF8 extension, as described in - // RFC6531 (https://tools.ietf.org/html/rfc6531) . For this reason, the local part - // of a destination email address (the part of the email address that precedes the - // @ sign) may only contain 7-bit ASCII characters (https://en.wikipedia.org/wiki/Email_address#Local-part) - // . If the domain part of an address (the part after the @ sign) contains - // non-ASCII characters, they must be encoded using Punycode, as described in - // RFC3492 (https://tools.ietf.org/html/rfc3492.html) . + // RFC6531 (https://tools.ietf.org/html/rfc6531) . For this reason, the email + // address string must be 7-bit ASCII. If you want to send to or from email + // addresses that contain Unicode characters in the domain part of an address, you + // must encode the domain using Punycode. Punycode is not permitted in the local + // part of the email address (the part before the @ sign) nor in the "friendly + // from" name. If you want to use Unicode characters in the "friendly from" name, + // you must encode the "friendly from" name using MIME encoded-word syntax, as + // described in Sending raw email using the Amazon SES API (https://docs.aws.amazon.com/ses/latest/dg/send-email-raw.html) + // . For more information about Punycode, see RFC 3492 (http://tools.ietf.org/html/rfc3492) + // . // // This member is required. Destination *Destination @@ -157,8 +162,8 @@ type BulkEmailDestinationStatus struct { // The status of a message sent using the SendBulkTemplatedEmail operation. // Possible values for this parameter include: - // - Success : Amazon SES accepted the message, and will attempt to deliver it to - // the recipients. + // - Success : Amazon SES accepted the message, and attempts to deliver it to the + // recipients. // - MessageRejected : The message was rejected because it contained a virus. // - MailFromDomainNotVerified : The sender's email address or domain was not // verified. @@ -193,7 +198,7 @@ type BulkEmailDestinationStatus struct { // which email sending events are published. Event destinations, such as Amazon // CloudWatch, are associated with configuration sets, which enable you to publish // email sending events. For information about using configuration sets, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . type CloudWatchDestination struct { @@ -208,34 +213,34 @@ type CloudWatchDestination struct { // Contains the dimension configuration to use when you publish email sending // events to Amazon CloudWatch. For information about publishing email sending -// events to Amazon CloudWatch, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// events to Amazon CloudWatch, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . type CloudWatchDimensionConfiguration struct { // The default value of the dimension that is published to Amazon CloudWatch if // you do not provide the value of the dimension when you send an email. The - // default value must: - // - This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), - // underscores (_), or dashes (-). - // - Contain less than 256 characters. + // default value must meet the following requirements: + // - Contain only ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), + // dashes (-), at signs (@), or periods (.). + // - Contain 256 characters or fewer. // // This member is required. DefaultDimensionValue *string // The name of an Amazon CloudWatch dimension associated with an email sending - // metric. The name must: - // - This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), - // underscores (_), or dashes (-). - // - Contain less than 256 characters. + // metric. The name must meet the following requirements: + // - Contain only ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), + // dashes (-), or colons (:). + // - Contain 256 characters or fewer. // // This member is required. DimensionName *string // The place where Amazon SES finds the value of a dimension to publish to Amazon - // CloudWatch. If you want Amazon SES to use the message tags that you specify - // using an X-SES-MESSAGE-TAGS header or a parameter to the SendEmail / SendRawEmail - // API, choose messageTag . If you want Amazon SES to use your own email headers, - // choose emailHeader . + // CloudWatch. To use the message tags that you specify using an X-SES-MESSAGE-TAGS + // header or a parameter to the SendEmail / SendRawEmail API, specify messageTag . + // To use your own email headers, specify emailHeader . To put a custom tag on any + // link included in your email, specify linkTag . // // This member is required. DimensionValueSource DimensionValueSource @@ -246,9 +251,8 @@ type CloudWatchDimensionConfiguration struct { // The name of the configuration set. Configuration sets let you create groups of // rules that you can apply to the emails you send using Amazon SES. For more // information about using configuration sets, see Using Amazon SES Configuration -// Sets (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/using-configuration-sets.html) -// in the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/) -// . +// Sets (https://docs.aws.amazon.com/ses/latest/dg/using-configuration-sets.html) +// in the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/) . type ConfigurationSet struct { // The name of the configuration set. The name must meet the following @@ -319,12 +323,16 @@ type DeliveryOptions struct { // Represents the destination of the message, consisting of To:, CC:, and BCC: // fields. Amazon SES does not support the SMTPUTF8 extension, as described in -// RFC6531 (https://tools.ietf.org/html/rfc6531) . For this reason, the local part -// of a destination email address (the part of the email address that precedes the -// @ sign) may only contain 7-bit ASCII characters (https://en.wikipedia.org/wiki/Email_address#Local-part) -// . If the domain part of an address (the part after the @ sign) contains -// non-ASCII characters, they must be encoded using Punycode, as described in -// RFC3492 (https://tools.ietf.org/html/rfc3492.html) . +// RFC6531 (https://tools.ietf.org/html/rfc6531) . For this reason, the email +// address string must be 7-bit ASCII. If you want to send to or from email +// addresses that contain Unicode characters in the domain part of an address, you +// must encode the domain using Punycode. Punycode is not permitted in the local +// part of the email address (the part before the @ sign) nor in the "friendly +// from" name. If you want to use Unicode characters in the "friendly from" name, +// you must encode the "friendly from" name using MIME encoded-word syntax, as +// described in Sending raw email using the Amazon SES API (https://docs.aws.amazon.com/ses/latest/dg/send-email-raw.html) +// . For more information about Punycode, see RFC 3492 (http://tools.ietf.org/html/rfc3492) +// . type Destination struct { // The recipients to place on the BCC: line of the message. @@ -339,26 +347,40 @@ type Destination struct { noSmithyDocumentSerde } -// Contains information about the event destination that the specified email -// sending events will be published to. When you create or update an event -// destination, you must provide one, and only one, destination. The destination -// can be Amazon CloudWatch, Amazon Kinesis Firehose or Amazon Simple Notification -// Service (Amazon SNS). Event destinations are associated with configuration sets, -// which enable you to publish email sending events to Amazon CloudWatch, Amazon -// Kinesis Firehose, or Amazon Simple Notification Service (Amazon SNS). For -// information about using configuration sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// Contains information about an event destination. When you create or update an +// event destination, you must provide one, and only one, destination. The +// destination can be Amazon CloudWatch, Amazon Kinesis Firehose or Amazon Simple +// Notification Service (Amazon SNS). Event destinations are associated with +// configuration sets, which enable you to publish email sending events to Amazon +// CloudWatch, Amazon Kinesis Firehose, or Amazon Simple Notification Service +// (Amazon SNS). For information about using configuration sets, see the Amazon +// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . type EventDestination struct { // The type of email sending events to publish to the event destination. + // - send - The call was successful and Amazon SES is attempting to deliver the + // email. + // - reject - Amazon SES determined that the email contained a virus and rejected + // it. + // - bounce - The recipient's mail server permanently rejected the email. This + // corresponds to a hard bounce. + // - complaint - The recipient marked the email as spam. + // - delivery - Amazon SES successfully delivered the email to the recipient's + // mail server. + // - open - The recipient received the email and opened it in their email client. + // - click - The recipient clicked one or more links in the email. + // - renderingFailure - Amazon SES did not send the email because of a template + // rendering issue. // // This member is required. MatchingEventTypes []EventType - // The name of the event destination. The name must: - // - This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), - // underscores (_), or dashes (-). - // - Contain less than 64 characters. + // The name of the event destination. The name must meet the following + // requirements: + // - Contain only ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), or + // dashes (-). + // - Contain 64 characters or fewer. // // This member is required. Name *string @@ -386,7 +408,7 @@ type EventDestination struct { // Additional X-headers to include in the Delivery Status Notification (DSN) when // an email that Amazon SES receives on your behalf bounces. For information about -// receiving email through Amazon SES, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email.html) +// receiving email through Amazon SES, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email.html) // . type ExtensionField struct { @@ -396,8 +418,8 @@ type ExtensionField struct { // This member is required. Name *string - // The value of the header to add. Must be less than 2048 characters, and must not - // contain newline characters ("\r" or "\n"). + // The value of the header to add. Must contain 2048 characters or fewer, and must + // not contain newline characters ("\r" or "\n"). // // This member is required. Value *string @@ -428,7 +450,7 @@ type IdentityDkimAttributes struct { // After successful detection, Amazon SES is able to DKIM-sign email originating // from that domain. (This only applies to domain identities, not email address // identities.) For more information about creating DNS records using DKIM tokens, - // see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/easy-dkim.html) + // see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/send-email-authentication-dkim-easy.html) // . DkimTokens []string @@ -474,49 +496,49 @@ type IdentityMailFromDomainAttributes struct { // forwarding is enabled for bounce and complaint notifications. type IdentityNotificationAttributes struct { - // The Amazon Resource Name (ARN) of the Amazon SNS topic where Amazon SES will - // publish bounce notifications. + // The Amazon Resource Name (ARN) of the Amazon SNS topic where Amazon SES + // publishes bounce notifications. // // This member is required. BounceTopic *string - // The Amazon Resource Name (ARN) of the Amazon SNS topic where Amazon SES will - // publish complaint notifications. + // The Amazon Resource Name (ARN) of the Amazon SNS topic where Amazon SES + // publishes complaint notifications. // // This member is required. ComplaintTopic *string - // The Amazon Resource Name (ARN) of the Amazon SNS topic where Amazon SES will - // publish delivery notifications. + // The Amazon Resource Name (ARN) of the Amazon SNS topic where Amazon SES + // publishes delivery notifications. // // This member is required. DeliveryTopic *string - // Describes whether Amazon SES will forward bounce and complaint notifications as - // email. true indicates that Amazon SES will forward bounce and complaint + // Describes whether Amazon SES forwards bounce and complaint notifications as + // email. true indicates that Amazon SES forwards bounce and complaint // notifications as email, while false indicates that bounce and complaint - // notifications will be published only to the specified bounce and complaint - // Amazon SNS topics. + // notifications are published only to the specified bounce and complaint Amazon + // SNS topics. // // This member is required. ForwardingEnabled bool // Describes whether Amazon SES includes the original email headers in Amazon SNS - // notifications of type Bounce . A value of true specifies that Amazon SES will - // include headers in bounce notifications, and a value of false specifies that - // Amazon SES will not include headers in bounce notifications. + // notifications of type Bounce . A value of true specifies that Amazon SES + // includes headers in bounce notifications, and a value of false specifies that + // Amazon SES does not include headers in bounce notifications. HeadersInBounceNotificationsEnabled bool // Describes whether Amazon SES includes the original email headers in Amazon SNS // notifications of type Complaint . A value of true specifies that Amazon SES - // will include headers in complaint notifications, and a value of false specifies - // that Amazon SES will not include headers in complaint notifications. + // includes headers in complaint notifications, and a value of false specifies + // that Amazon SES does not include headers in complaint notifications. HeadersInComplaintNotificationsEnabled bool // Describes whether Amazon SES includes the original email headers in Amazon SNS - // notifications of type Delivery . A value of true specifies that Amazon SES will - // include headers in delivery notifications, and a value of false specifies that - // Amazon SES will not include headers in delivery notifications. + // notifications of type Delivery . A value of true specifies that Amazon SES + // includes headers in delivery notifications, and a value of false specifies that + // Amazon SES does not include headers in delivery notifications. HeadersInDeliveryNotificationsEnabled bool noSmithyDocumentSerde @@ -541,7 +563,7 @@ type IdentityVerificationAttributes struct { // Kinesis Firehose event destination. Event destinations, such as Amazon Kinesis // Firehose, are associated with configuration sets, which enable you to publish // email sending events. For information about using configuration sets, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . type KinesisFirehoseDestination struct { @@ -560,40 +582,42 @@ type KinesisFirehoseDestination struct { noSmithyDocumentSerde } -// When included in a receipt rule, this action calls an AWS Lambda function and, -// optionally, publishes a notification to Amazon Simple Notification Service -// (Amazon SNS). To enable Amazon SES to call your AWS Lambda function or to -// publish to an Amazon SNS topic of another account, Amazon SES must have -// permission to access those resources. For information about giving permissions, -// see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-permissions.html) -// . For information about using AWS Lambda actions in receipt rules, see the -// Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-action-lambda.html) +// When included in a receipt rule, this action calls an Amazon Web Services +// Lambda function and, optionally, publishes a notification to Amazon Simple +// Notification Service (Amazon SNS). To enable Amazon SES to call your Amazon Web +// Services Lambda function or to publish to an Amazon SNS topic of another +// account, Amazon SES must have permission to access those resources. For +// information about giving permissions, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-permissions.html) +// . For information about using Amazon Web Services Lambda actions in receipt +// rules, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-action-lambda.html) // . type LambdaAction struct { - // The Amazon Resource Name (ARN) of the AWS Lambda function. An example of an AWS - // Lambda function ARN is arn:aws:lambda:us-west-2:account-id:function:MyFunction . - // For more information about AWS Lambda, see the AWS Lambda Developer Guide (https://docs.aws.amazon.com/lambda/latest/dg/welcome.html) - // . + // The Amazon Resource Name (ARN) of the Amazon Web Services Lambda function. An + // example of an Amazon Web Services Lambda function ARN is + // arn:aws:lambda:us-west-2:account-id:function:MyFunction . For more information + // about Amazon Web Services Lambda, see the Amazon Web Services Lambda Developer + // Guide (https://docs.aws.amazon.com/lambda/latest/dg/welcome.html) . // // This member is required. FunctionArn *string - // The invocation type of the AWS Lambda function. An invocation type of - // RequestResponse means that the execution of the function will immediately result - // in a response, and a value of Event means that the function will be invoked - // asynchronously. The default value is Event . For information about AWS Lambda - // invocation types, see the AWS Lambda Developer Guide (https://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html) - // . There is a 30-second timeout on RequestResponse invocations. You should use - // Event invocation in most cases. Use RequestResponse only when you want to make - // a mail flow decision, such as whether to stop the receipt rule or the receipt - // rule set. + // The invocation type of the Amazon Web Services Lambda function. An invocation + // type of RequestResponse means that the execution of the function immediately + // results in a response, and a value of Event means that the function is invoked + // asynchronously. The default value is Event . For information about Amazon Web + // Services Lambda invocation types, see the Amazon Web Services Lambda Developer + // Guide (https://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html) . There is + // a 30-second timeout on RequestResponse invocations. You should use Event + // invocation in most cases. Use RequestResponse only to make a mail flow + // decision, such as whether to stop the receipt rule or the receipt rule set. InvocationType InvocationType // The Amazon Resource Name (ARN) of the Amazon SNS topic to notify when the - // Lambda action is taken. An example of an Amazon SNS topic ARN is - // arn:aws:sns:us-west-2:123456789012:MyTopic . For more information about Amazon - // SNS topics, see the Amazon SNS Developer Guide (https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) + // Lambda action is executed. You can find the ARN of a topic by using the + // ListTopics (https://docs.aws.amazon.com/sns/latest/api/API_ListTopics.html) + // operation in Amazon SNS. For more information about Amazon SNS topics, see the + // Amazon SNS Developer Guide (https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) // . TopicArn *string @@ -608,8 +632,8 @@ type Message struct { // This member is required. Body *Body - // The subject of the message: A short summary of the content, which will appear - // in the recipient's inbox. + // The subject of the message: A short summary of the content, which appears in + // the recipient's inbox. // // This member is required. Subject *Content @@ -620,7 +644,7 @@ type Message struct { // Message-related information to include in the Delivery Status Notification // (DSN) when an email that Amazon SES receives on your behalf bounces. For // information about receiving email through Amazon SES, see the Amazon SES -// Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email.html) +// Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email.html) // . type MessageDsn struct { @@ -644,22 +668,22 @@ type MessageDsn struct { // Contains the name and value of a tag that you can provide to SendEmail or // SendRawEmail to apply to an email. Message tags, which you use with // configuration sets, enable you to publish email sending events. For information -// about using configuration sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// about using configuration sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . type MessageTag struct { - // The name of the tag. The name must: - // - This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), - // underscores (_), or dashes (-). - // - Contain less than 256 characters. + // The name of the tag. The name must meet the following requirements: + // - Contain only ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), or + // dashes (-). + // - Contain 256 characters or fewer. // // This member is required. Name *string - // The value of the tag. The value must: - // - This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), - // underscores (_), or dashes (-). - // - Contain less than 256 characters. + // The value of the tag. The value must meet the following requirements: + // - Contain only ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), or + // dashes (-). + // - Contain 256 characters or fewer. // // This member is required. Value *string @@ -672,16 +696,16 @@ type RawMessage struct { // The raw data of the message. This data needs to base64-encoded if you are // accessing Amazon SES directly through the HTTPS interface. If you are accessing - // Amazon SES using an AWS SDK, the SDK takes care of the base 64-encoding for you. - // In all cases, the client must ensure that the message format complies with - // Internet email standards regarding email header fields, MIME types, and MIME - // encoding. The To:, CC:, and BCC: headers in the raw message can contain a group - // list. If you are using SendRawEmail with sending authorization, you can include - // X-headers in the raw message to specify the "Source," "From," and "Return-Path" - // addresses. For more information, see the documentation for SendRawEmail . Do not - // include these X-headers in the DKIM signature, because they are removed by - // Amazon SES before sending the email. For more information, go to the Amazon SES - // Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-raw.html) + // Amazon SES using an Amazon Web Services SDK, the SDK takes care of the base + // 64-encoding for you. In all cases, the client must ensure that the message + // format complies with Internet email standards regarding email header fields, + // MIME types, and MIME encoding. The To:, CC:, and BCC: headers in the raw message + // can contain a group list. If you are using SendRawEmail with sending + // authorization, you can include X-headers in the raw message to specify the + // "Source," "From," and "Return-Path" addresses. For more information, see the + // documentation for SendRawEmail . Do not include these X-headers in the DKIM + // signature, because they are removed by Amazon SES before sending the email. For + // more information, go to the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/send-email-raw.html) // . // // This member is required. @@ -693,7 +717,7 @@ type RawMessage struct { // An action that Amazon SES can take when it receives an email on behalf of one // or more email addresses or domains that you own. An instance of this data type // can represent only one action. For information about setting up receipt rules, -// see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rules.html) +// see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-receipt-rules-console-walkthrough.html) // . type ReceiptAction struct { @@ -705,8 +729,8 @@ type ReceiptAction struct { // (Amazon SNS). BounceAction *BounceAction - // Calls an AWS Lambda function, and optionally, publishes a notification to - // Amazon SNS. + // Calls an Amazon Web Services Lambda function, and optionally, publishes a + // notification to Amazon SNS. LambdaAction *LambdaAction // Saves the received message to an Amazon Simple Storage Service (Amazon S3) @@ -729,7 +753,7 @@ type ReceiptAction struct { // A receipt IP address filter enables you to specify whether to accept or reject // mail originating from an IP address or range of IP addresses. For information -// about setting up IP address filters, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-ip-filters.html) +// about setting up IP address filters, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-ip-filtering-console-walkthrough.html) // . type ReceiptFilter struct { @@ -739,11 +763,12 @@ type ReceiptFilter struct { // This member is required. IpFilter *ReceiptIpFilter - // The name of the IP address filter. The name must: - // - This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), - // underscores (_), or dashes (-). + // The name of the IP address filter. The name must meet the following + // requirements: + // - Contain only ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), or + // dashes (-). // - Start and end with a letter or number. - // - Contain less than 64 characters. + // - Contain 64 characters or fewer. // // This member is required. Name *string @@ -753,14 +778,14 @@ type ReceiptFilter struct { // A receipt IP address filter enables you to specify whether to accept or reject // mail originating from an IP address or range of IP addresses. For information -// about setting up IP address filters, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-ip-filters.html) +// about setting up IP address filters, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-ip-filtering-console-walkthrough.html) // . type ReceiptIpFilter struct { - // A single IP address or a range of IP addresses that you want to block or allow, - // specified in Classless Inter-Domain Routing (CIDR) notation. An example of a - // single email address is 10.0.0.1. An example of a range of IP addresses is - // 10.0.0.1/24. For more information about CIDR notation, see RFC 2317 (https://tools.ietf.org/html/rfc2317) + // A single IP address or a range of IP addresses to block or allow, specified in + // Classless Inter-Domain Routing (CIDR) notation. An example of a single email + // address is 10.0.0.1. An example of a range of IP addresses is 10.0.0.1/24. For + // more information about CIDR notation, see RFC 2317 (https://tools.ietf.org/html/rfc2317) // . // // This member is required. @@ -781,15 +806,15 @@ type ReceiptIpFilter struct { // applies to. If the email addresses or domains match at least one recipient // address of the message, Amazon SES executes all of the receipt rule's actions on // the message. For information about setting up receipt rules, see the Amazon SES -// Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rules.html) +// Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-receipt-rules-console-walkthrough.html) // . type ReceiptRule struct { - // The name of the receipt rule. The name must: - // - This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), - // underscores (_), or dashes (-). + // The name of the receipt rule. The name must meet the following requirements: + // - Contain only ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), + // dashes (-), or periods (.). // - Start and end with a letter or number. - // - Contain less than 64 characters. + // - Contain 64 characters or fewer. // // This member is required. Name *string @@ -802,8 +827,8 @@ type ReceiptRule struct { Enabled bool // The recipient domains and email addresses that the receipt rule applies to. If - // this field is not specified, this rule will match all recipients under all - // verified domains. + // this field is not specified, this rule matches all recipients on all verified + // domains. Recipients []string // If true , then messages that this receipt rule applies to are scanned for spam @@ -812,8 +837,8 @@ type ReceiptRule struct { // Specifies whether Amazon SES should require that incoming email is delivered // over a connection encrypted with Transport Layer Security (TLS). If this - // parameter is set to Require , Amazon SES will bounce emails that are not - // received over TLS. The default is Optional . + // parameter is set to Require , Amazon SES bounces emails that are not received + // over TLS. The default is Optional . TlsPolicy TlsPolicy noSmithyDocumentSerde @@ -822,18 +847,19 @@ type ReceiptRule struct { // Information about a receipt rule set. A receipt rule set is a collection of // rules that specify what Amazon SES should do with mail it receives on behalf of // your account's verified domains. For information about setting up receipt rule -// sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-receipt-rule-set.html) +// sets, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-concepts.html#receiving-email-concepts-rules) // . type ReceiptRuleSetMetadata struct { // The date and time the receipt rule set was created. CreatedTimestamp *time.Time - // The name of the receipt rule set. The name must: - // - This value can only contain ASCII letters (a-z, A-Z), numbers (0-9), - // underscores (_), or dashes (-). + // The name of the receipt rule set. The name must meet the following + // requirements: + // - Contain only ASCII letters (a-z, A-Z), numbers (0-9), underscores (_), or + // dashes (-). // - Start and end with a letter or number. - // - Contain less than 64 characters. + // - Contain 64 characters or fewer. Name *string noSmithyDocumentSerde @@ -842,7 +868,7 @@ type ReceiptRuleSetMetadata struct { // Recipient-related information to include in the Delivery Status Notification // (DSN) when an email that Amazon SES receives on your behalf bounces. For // information about receiving email through Amazon SES, see the Amazon SES -// Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email.html) +// Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email.html) // . type RecipientDsnFields struct { @@ -869,11 +895,10 @@ type RecipientDsnFields struct { // The email address that the message was ultimately delivered to. This // corresponds to the Final-Recipient in the DSN. If not specified, FinalRecipient - // will be set to the Recipient specified in the BouncedRecipientInfo structure. - // Either FinalRecipient or the recipient in BouncedRecipientInfo must be a - // recipient of the original bounced message. Do not prepend the FinalRecipient - // email address with rfc 822; , as described in RFC 3798 (https://tools.ietf.org/html/rfc3798) - // . + // is set to the Recipient specified in the BouncedRecipientInfo structure. Either + // FinalRecipient or the recipient in BouncedRecipientInfo must be a recipient of + // the original bounced message. Do not prepend the FinalRecipient email address + // with rfc 822; , as described in RFC 3798 (https://tools.ietf.org/html/rfc3798) . FinalRecipient *string // The time the final delivery attempt was made, in RFC 822 (https://www.ietf.org/rfc/rfc0822.txt) @@ -908,8 +933,8 @@ type ReputationOptions struct { ReputationMetricsEnabled bool // Describes whether email sending is enabled or disabled for the configuration - // set. If the value is true , then Amazon SES will send emails that use the - // configuration set. If the value is false , Amazon SES will not send emails that + // set. If the value is true , then Amazon SES sends emails that use the + // configuration set. If the value is false , Amazon SES does not send emails that // use the configuration set. The default value is true . You can change this // setting using UpdateConfigurationSetSendingEnabled . SendingEnabled bool @@ -920,48 +945,50 @@ type ReputationOptions struct { // When included in a receipt rule, this action saves the received message to an // Amazon Simple Storage Service (Amazon S3) bucket and, optionally, publishes a // notification to Amazon Simple Notification Service (Amazon SNS). To enable -// Amazon SES to write emails to your Amazon S3 bucket, use an AWS KMS key to -// encrypt your emails, or publish to an Amazon SNS topic of another account, -// Amazon SES must have permission to access those resources. For information about -// giving permissions, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-permissions.html) +// Amazon SES to write emails to your Amazon S3 bucket, use an Amazon Web Services +// KMS key to encrypt your emails, or publish to an Amazon SNS topic of another +// account, Amazon SES must have permission to access those resources. For +// information about granting permissions, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-permissions.html) // . When you save your emails to an Amazon S3 bucket, the maximum email size -// (including headers) is 30 MB. Emails larger than that will bounce. For -// information about specifying Amazon S3 actions in receipt rules, see the Amazon -// SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-action-s3.html) +// (including headers) is 40 MB. Emails larger than that bounces. For information +// about specifying Amazon S3 actions in receipt rules, see the Amazon SES +// Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-action-s3.html) // . type S3Action struct { - // The name of the Amazon S3 bucket that incoming email will be saved to. + // The name of the Amazon S3 bucket for incoming email. // // This member is required. BucketName *string // The customer master key that Amazon SES should use to encrypt your emails // before saving them to the Amazon S3 bucket. You can use the default master key - // or a custom master key you created in AWS KMS as follows: + // or a custom master key that you created in Amazon Web Services KMS as follows: // - To use the default master key, provide an ARN in the form of // arn:aws:kms:REGION:ACCOUNT-ID-WITHOUT-HYPHENS:alias/aws/ses . For example, if - // your AWS account ID is 123456789012 and you want to use the default master key - // in the US West (Oregon) region, the ARN of the default master key would be - // arn:aws:kms:us-west-2:123456789012:alias/aws/ses . If you use the default - // master key, you don't need to perform any extra steps to give Amazon SES + // your Amazon Web Services account ID is 123456789012 and you want to use the + // default master key in the US West (Oregon) Region, the ARN of the default master + // key would be arn:aws:kms:us-west-2:123456789012:alias/aws/ses . If you use the + // default master key, you don't need to perform any extra steps to give Amazon SES // permission to use the key. - // - To use a custom master key you created in AWS KMS, provide the ARN of the - // master key and ensure that you add a statement to your key's policy to give - // Amazon SES permission to use it. For more information about giving permissions, - // see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-permissions.html) + // - To use a custom master key that you created in Amazon Web Services KMS, + // provide the ARN of the master key and ensure that you add a statement to your + // key's policy to give Amazon SES permission to use it. For more information about + // giving permissions, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-permissions.html) // . - // For more information about key policies, see the AWS KMS Developer Guide (https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html) - // . If you do not specify a master key, Amazon SES will not encrypt your emails. + // For more information about key policies, see the Amazon Web Services KMS + // Developer Guide (https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html) + // . If you do not specify a master key, Amazon SES does not encrypt your emails. // Your mail is encrypted by Amazon SES using the Amazon S3 encryption client // before the mail is submitted to Amazon S3 for storage. It is not encrypted using // Amazon S3 server-side encryption. This means that you must use the Amazon S3 // encryption client to decrypt the email after retrieving it from Amazon S3, as - // the service has no access to use your AWS KMS keys for decryption. This - // encryption client is currently available with the AWS SDK for Java (http://aws.amazon.com/sdk-for-java/) - // and AWS SDK for Ruby (http://aws.amazon.com/sdk-for-ruby/) only. For more - // information about client-side encryption using AWS KMS master keys, see the - // Amazon S3 Developer Guide (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingClientSideEncryption.html) + // the service has no access to use your Amazon Web Services KMS keys for + // decryption. This encryption client is currently available with the Amazon Web + // Services SDK for Java (http://aws.amazon.com/sdk-for-java/) and Amazon Web + // Services SDK for Ruby (http://aws.amazon.com/sdk-for-ruby/) only. For more + // information about client-side encryption using Amazon Web Services KMS master + // keys, see the Amazon S3 Developer Guide (https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingClientSideEncryption.html) // . KmsKeyArn *string @@ -971,9 +998,9 @@ type S3Action struct { ObjectKeyPrefix *string // The ARN of the Amazon SNS topic to notify when the message is saved to the - // Amazon S3 bucket. An example of an Amazon SNS topic ARN is - // arn:aws:sns:us-west-2:123456789012:MyTopic . For more information about Amazon - // SNS topics, see the Amazon SNS Developer Guide (https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) + // Amazon S3 bucket. You can find the ARN of a topic by using the ListTopics (https://docs.aws.amazon.com/sns/latest/api/API_ListTopics.html) + // operation in Amazon SNS. For more information about Amazon SNS topics, see the + // Amazon SNS Developer Guide (https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) // . TopicArn *string @@ -1010,17 +1037,18 @@ type SendDataPoint struct { // need to do anything to give Amazon SES permission to publish emails to it. // However, if you don't own the Amazon SNS topic, you need to attach a policy to // the topic to give Amazon SES permissions to access it. For information about -// giving permissions, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-permissions.html) +// giving permissions, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-permissions.html) // . You can only publish emails that are 150 KB or less (including the header) to -// Amazon SNS. Larger emails will bounce. If you anticipate emails larger than 150 -// KB, use the S3 action instead. For information about using a receipt rule to -// publish an Amazon SNS notification, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-action-sns.html) +// Amazon SNS. Larger emails bounce. If you anticipate emails larger than 150 KB, +// use the S3 action instead. For information about using a receipt rule to publish +// an Amazon SNS notification, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-action-sns.html) // . type SNSAction struct { - // The Amazon Resource Name (ARN) of the Amazon SNS topic to notify. An example of - // an Amazon SNS topic ARN is arn:aws:sns:us-west-2:123456789012:MyTopic . For more - // information about Amazon SNS topics, see the Amazon SNS Developer Guide (https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) + // The Amazon Resource Name (ARN) of the Amazon SNS topic to notify. You can find + // the ARN of a topic by using the ListTopics (https://docs.aws.amazon.com/sns/latest/api/API_ListTopics.html) + // operation in Amazon SNS. For more information about Amazon SNS topics, see the + // Amazon SNS Developer Guide (https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) // . // // This member is required. @@ -1039,14 +1067,14 @@ type SNSAction struct { // (Amazon SNS) event destination. Event destinations, such as Amazon SNS, are // associated with configuration sets, which enable you to publish email sending // events. For information about using configuration sets, see the Amazon SES -// Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-sending-activity.html) +// Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity.html) // . type SNSDestination struct { - // The ARN of the Amazon SNS topic that email sending events will be published to. - // An example of an Amazon SNS topic ARN is - // arn:aws:sns:us-west-2:123456789012:MyTopic . For more information about Amazon - // SNS topics, see the Amazon SNS Developer Guide (https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) + // The ARN of the Amazon SNS topic for email sending events. You can find the ARN + // of a topic by using the ListTopics (https://docs.aws.amazon.com/sns/latest/api/API_ListTopics.html) + // Amazon SNS operation. For more information about Amazon SNS topics, see the + // Amazon SNS Developer Guide (https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) // . // // This member is required. @@ -1058,7 +1086,7 @@ type SNSDestination struct { // When included in a receipt rule, this action terminates the evaluation of the // receipt rule set and, optionally, publishes a notification to Amazon Simple // Notification Service (Amazon SNS). For information about setting a stop action -// in a receipt rule, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-action-stop.html) +// in a receipt rule, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-action-stop.html) // . type StopAction struct { @@ -1068,21 +1096,21 @@ type StopAction struct { Scope StopScope // The Amazon Resource Name (ARN) of the Amazon SNS topic to notify when the stop - // action is taken. An example of an Amazon SNS topic ARN is - // arn:aws:sns:us-west-2:123456789012:MyTopic . For more information about Amazon - // SNS topics, see the Amazon SNS Developer Guide (https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) + // action is taken. You can find the ARN of a topic by using the ListTopics (https://docs.aws.amazon.com/sns/latest/api/API_ListTopics.html) + // Amazon SNS operation. For more information about Amazon SNS topics, see the + // Amazon SNS Developer Guide (https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) // . TopicArn *string noSmithyDocumentSerde } -// The content of the email, composed of a subject line, an HTML part, and a -// text-only part. +// The content of the email, composed of a subject line and either an HTML part or +// a text-only part. type Template struct { - // The name of the template. You will refer to this name when you send email using - // the SendTemplatedEmail or SendBulkTemplatedEmail operations. + // The name of the template. You use this name when you send email using the + // SendTemplatedEmail or SendBulkTemplatedEmail operations. // // This member is required. TemplateName *string @@ -1093,8 +1121,8 @@ type Template struct { // The subject line of the email. SubjectPart *string - // The email body that will be visible to recipients whose email clients do not - // display HTML. + // The email body that is visible to recipients whose email clients do not display + // HTML content. TextPart *string noSmithyDocumentSerde @@ -1115,12 +1143,12 @@ type TemplateMetadata struct { // A domain that is used to redirect email recipients to an Amazon SES-operated // domain. This domain captures open and click events generated by Amazon SES // emails. For more information, see Configuring Custom Domains to Handle Open and -// Click Tracking (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/configure-custom-open-click-domains.html) +// Click Tracking (https://docs.aws.amazon.com/ses/latest/dg/configure-custom-open-click-domains.html) // in the Amazon SES Developer Guide. type TrackingOptions struct { - // The custom subdomain that will be used to redirect email recipients to the - // Amazon SES event tracking domain. + // The custom subdomain that is used to redirect email recipients to the Amazon + // SES event tracking domain. CustomRedirectDomain *string noSmithyDocumentSerde @@ -1128,26 +1156,28 @@ type TrackingOptions struct { // When included in a receipt rule, this action calls Amazon WorkMail and, // optionally, publishes a notification to Amazon Simple Notification Service -// (Amazon SNS). You will typically not use this action directly because Amazon +// (Amazon SNS). It usually isn't necessary to set this up manually, because Amazon // WorkMail adds the rule automatically during its setup procedure. For information -// using a receipt rule to call Amazon WorkMail, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/receiving-email-action-workmail.html) +// using a receipt rule to call Amazon WorkMail, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/dg/receiving-email-action-workmail.html) // . type WorkmailAction struct { - // The ARN of the Amazon WorkMail organization. An example of an Amazon WorkMail - // organization ARN is - // arn:aws:workmail:us-west-2:123456789012:organization/m-68755160c4cb4e29a2b2f8fb58f359d7 - // . For information about Amazon WorkMail organizations, see the Amazon WorkMail - // Administrator Guide (https://docs.aws.amazon.com/workmail/latest/adminguide/organizations_overview.html) + // The Amazon Resource Name (ARN) of the Amazon WorkMail organization. Amazon + // WorkMail ARNs use the following format: arn:aws:workmail:::organization/ You + // can find the ID of your organization by using the ListOrganizations (https://docs.aws.amazon.com/workmail/latest/APIReference/API_ListOrganizations.html) + // operation in Amazon WorkMail. Amazon WorkMail organization IDs begin with " m- + // ", followed by a string of alphanumeric characters. For information about Amazon + // WorkMail organizations, see the Amazon WorkMail Administrator Guide (https://docs.aws.amazon.com/workmail/latest/adminguide/organizations_overview.html) // . // // This member is required. OrganizationArn *string // The Amazon Resource Name (ARN) of the Amazon SNS topic to notify when the - // WorkMail action is called. An example of an Amazon SNS topic ARN is - // arn:aws:sns:us-west-2:123456789012:MyTopic . For more information about Amazon - // SNS topics, see the Amazon SNS Developer Guide (https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) + // WorkMail action is called. You can find the ARN of a topic by using the + // ListTopics (https://docs.aws.amazon.com/sns/latest/api/API_ListTopics.html) + // operation in Amazon SNS. For more information about Amazon SNS topics, see the + // Amazon SNS Developer Guide (https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) // . TopicArn *string diff --git a/service/swf/api_op_RespondDecisionTaskCompleted.go b/service/swf/api_op_RespondDecisionTaskCompleted.go index 8cf07736060..95f4c9bb552 100644 --- a/service/swf/api_op_RespondDecisionTaskCompleted.go +++ b/service/swf/api_op_RespondDecisionTaskCompleted.go @@ -62,6 +62,22 @@ type RespondDecisionTaskCompletedInput struct { // User defined context to add to workflow execution. ExecutionContext *string + // The task list to use for the future decision tasks of this workflow execution. + // This list overrides the original task list you specified while starting the + // workflow execution. + TaskList *types.TaskList + + // Specifies a timeout (in seconds) for the task list override. When this + // parameter is missing, the task list override is permanent. This parameter makes + // it possible to temporarily override the task list. If a decision task scheduled + // on the override task list is not started within the timeout, the decision task + // will time out. Amazon SWF will revert the override and schedule a new decision + // task to the original task list. If a decision task scheduled on the override + // task list is started within the timeout, but not completed within the + // start-to-close timeout, Amazon SWF will also revert the override and schedule a + // new decision task to the original task list. + TaskListScheduleToStartTimeout *string + noSmithyDocumentSerde } diff --git a/service/swf/deserializers.go b/service/swf/deserializers.go index 18545d898f5..504ee40e1ba 100644 --- a/service/swf/deserializers.go +++ b/service/swf/deserializers.go @@ -5744,6 +5744,20 @@ func awsAwsjson10_deserializeDocumentDecisionTaskCompletedEventAttributes(v **ty sv.StartedEventId = i64 } + case "taskList": + if err := awsAwsjson10_deserializeDocumentTaskList(&sv.TaskList, value); err != nil { + return err + } + + case "taskListScheduleToStartTimeout": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected DurationInSecondsOptional to be of type string, got %T instead", value) + } + sv.TaskListScheduleToStartTimeout = ptr.String(jtv) + } + default: _, _ = key, value @@ -5775,6 +5789,15 @@ func awsAwsjson10_deserializeDocumentDecisionTaskScheduledEventAttributes(v **ty for key, value := range shape { switch key { + case "scheduleToStartTimeout": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected DurationInSecondsOptional to be of type string, got %T instead", value) + } + sv.ScheduleToStartTimeout = ptr.String(jtv) + } + case "startToCloseTimeout": if value != nil { jtv, ok := value.(string) diff --git a/service/swf/serializers.go b/service/swf/serializers.go index 465b87a1181..aeb647444a9 100644 --- a/service/swf/serializers.go +++ b/service/swf/serializers.go @@ -3574,6 +3574,18 @@ func awsAwsjson10_serializeOpDocumentRespondDecisionTaskCompletedInput(v *Respon ok.String(*v.ExecutionContext) } + if v.TaskList != nil { + ok := object.Key("taskList") + if err := awsAwsjson10_serializeDocumentTaskList(v.TaskList, ok); err != nil { + return err + } + } + + if v.TaskListScheduleToStartTimeout != nil { + ok := object.Key("taskListScheduleToStartTimeout") + ok.String(*v.TaskListScheduleToStartTimeout) + } + if v.TaskToken != nil { ok := object.Key("taskToken") ok.String(*v.TaskToken) diff --git a/service/swf/types/enums.go b/service/swf/types/enums.go index 1b21a0a57a2..700494d446c 100644 --- a/service/swf/types/enums.go +++ b/service/swf/types/enums.go @@ -163,7 +163,8 @@ type DecisionTaskTimeoutType string // Enum values for DecisionTaskTimeoutType const ( - DecisionTaskTimeoutTypeStartToClose DecisionTaskTimeoutType = "START_TO_CLOSE" + DecisionTaskTimeoutTypeStartToClose DecisionTaskTimeoutType = "START_TO_CLOSE" + DecisionTaskTimeoutTypeScheduleToStart DecisionTaskTimeoutType = "SCHEDULE_TO_START" ) // Values returns all known values for DecisionTaskTimeoutType. Note that this can @@ -172,6 +173,7 @@ const ( func (DecisionTaskTimeoutType) Values() []DecisionTaskTimeoutType { return []DecisionTaskTimeoutType{ "START_TO_CLOSE", + "SCHEDULE_TO_START", } } diff --git a/service/swf/types/types.go b/service/swf/types/types.go index d68691a7b35..f3a7020c97c 100644 --- a/service/swf/types/types.go +++ b/service/swf/types/types.go @@ -973,6 +973,13 @@ type DecisionTaskCompletedEventAttributes struct { // User defined context for the workflow execution. ExecutionContext *string + // Represents a task list. + TaskList *TaskList + + // The maximum amount of time the decision task can wait to be assigned to a + // worker. + TaskListScheduleToStartTimeout *string + noSmithyDocumentSerde } @@ -984,6 +991,10 @@ type DecisionTaskScheduledEventAttributes struct { // This member is required. TaskList *TaskList + // The maximum amount of time the decision task can wait to be assigned to a + // worker. + ScheduleToStartTimeout *string + // The maximum duration for this decision task. The task is considered timed out // if it doesn't completed within this duration. The duration is specified in // seconds, an integer greater than or equal to 0 . You can use NONE to specify diff --git a/service/swf/validators.go b/service/swf/validators.go index 85bba3602fc..af5a27e7d15 100644 --- a/service/swf/validators.go +++ b/service/swf/validators.go @@ -1987,6 +1987,11 @@ func validateOpRespondDecisionTaskCompletedInput(v *RespondDecisionTaskCompleted invalidParams.AddNested("Decisions", err.(smithy.InvalidParamsError)) } } + if v.TaskList != nil { + if err := validateTaskList(v.TaskList); err != nil { + invalidParams.AddNested("TaskList", err.(smithy.InvalidParamsError)) + } + } if invalidParams.Len() > 0 { return invalidParams } else { diff --git a/service/vpclattice/internal/endpoints/endpoints.go b/service/vpclattice/internal/endpoints/endpoints.go index 77db3758762..a1cae4b533b 100644 --- a/service/vpclattice/internal/endpoints/endpoints.go +++ b/service/vpclattice/internal/endpoints/endpoints.go @@ -148,6 +148,9 @@ var defaultPartitions = endpoints.Partitions{ endpoints.EndpointKey{ Region: "ap-southeast-2", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "ca-central-1", + }: endpoints.Endpoint{}, endpoints.EndpointKey{ Region: "eu-west-1", }: endpoints.Endpoint{},