AWS SDK for Go (PILOT)
API Reference

PREVIEW DOCUMENTATION - This is a preview of a new format for the AWS SDK for Go API Reference documentation. For the current AWS SDK for Go API Reference, see https://docs.aws.amazon.com/sdk-for-go/api/.

We welcome your feedback on this new version of the documentation. Send your comments to aws-sdkdocs-feedback@amazon.com.

SES

import "github.com/aws/aws-sdk-go/service/ses"

type SES struct { *client.Client }

SES provides the API operation methods for making requests to Amazon Simple Email Service. See this package's package overview docs for details on the service.

SES methods are safe to use concurrently. It is not safe to modify mutate any of the struct's properties though.

Client

Type: *client.Client

Method

CloneReceiptRuleSet

func (c *SES) CloneReceiptRuleSet(input *CloneReceiptRuleSetInput) (*CloneReceiptRuleSetOutput, error)

CloneReceiptRuleSet API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation CloneReceiptRuleSet for usage and error information.

Returned Error Codes:

  • ErrCodeRuleSetDoesNotExistException "RuleSetDoesNotExist" Indicates that the provided receipt rule set does not exist.

  • ErrCodeAlreadyExistsException "AlreadyExists" Indicates that a resource could not be created because of a naming conflict.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CloneReceiptRuleSet

Example

SES CloneReceiptRuleSet shared00

CloneReceiptRuleSet

The following example creates a receipt rule set by cloning an existing one:

{ svc := ses.New(session.New()) input := &ses.CloneReceiptRuleSetInput{ OriginalRuleSetName: aws.String("RuleSetToClone"), RuleSetName: aws.String("RuleSetToCreate"), } result, err := svc.CloneReceiptRuleSet(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case ses.ErrCodeRuleSetDoesNotExistException: fmt.Println(ses.ErrCodeRuleSetDoesNotExistException, aerr.Error()) case ses.ErrCodeAlreadyExistsException: fmt.Println(ses.ErrCodeAlreadyExistsException, aerr.Error()) case ses.ErrCodeLimitExceededException: fmt.Println(ses.ErrCodeLimitExceededException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CloneReceiptRuleSetRequest

func (c *SES) CloneReceiptRuleSetRequest(input *CloneReceiptRuleSetInput) (req *request.Request, output *CloneReceiptRuleSetOutput)

CloneReceiptRuleSetRequest generates a "aws/request.Request" representing the client's request for the CloneReceiptRuleSet operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CloneReceiptRuleSet for more information on using the CloneReceiptRuleSet API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CloneReceiptRuleSetRequest method. req, resp := client.CloneReceiptRuleSetRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CloneReceiptRuleSet

CloneReceiptRuleSetWithContext

func (c *SES) CloneReceiptRuleSetWithContext(ctx aws.Context, input *CloneReceiptRuleSetInput, opts ...request.Option) (*CloneReceiptRuleSetOutput, error)

CloneReceiptRuleSetWithContext is the same as CloneReceiptRuleSet with the addition of the ability to pass a context and additional request options.

See CloneReceiptRuleSet for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

CreateConfigurationSet

func (c *SES) CreateConfigurationSet(input *CreateConfigurationSetInput) (*CreateConfigurationSetOutput, error)

CreateConfigurationSet API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation CreateConfigurationSet for usage and error information.

Returned Error Codes:

  • ErrCodeConfigurationSetAlreadyExistsException "ConfigurationSetAlreadyExists" Indicates that the configuration set could not be created because of a naming conflict.

  • ErrCodeInvalidConfigurationSetException "InvalidConfigurationSet" Indicates that the configuration set is invalid. See the error message for details.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateConfigurationSet

CreateConfigurationSetEventDestination

func (c *SES) CreateConfigurationSetEventDestination(input *CreateConfigurationSetEventDestinationInput) (*CreateConfigurationSetEventDestinationOutput, error)

CreateConfigurationSetEventDestination API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation CreateConfigurationSetEventDestination for usage and error information.

Returned Error Codes:

  • ErrCodeConfigurationSetDoesNotExistException "ConfigurationSetDoesNotExist" Indicates that the configuration set does not exist.

  • ErrCodeEventDestinationAlreadyExistsException "EventDestinationAlreadyExists" Indicates that the event destination could not be created because of a naming conflict.

  • ErrCodeInvalidCloudWatchDestinationException "InvalidCloudWatchDestination" Indicates that the Amazon CloudWatch destination is invalid. See the error message for details.

  • ErrCodeInvalidFirehoseDestinationException "InvalidFirehoseDestination" Indicates that the Amazon Kinesis Firehose destination is invalid. See the error message for details.

  • ErrCodeInvalidSNSDestinationException "InvalidSNSDestination" Indicates that the Amazon Simple Notification Service (Amazon SNS) destination is invalid. See the error message for details.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateConfigurationSetEventDestination

CreateConfigurationSetEventDestinationRequest

func (c *SES) CreateConfigurationSetEventDestinationRequest(input *CreateConfigurationSetEventDestinationInput) (req *request.Request, output *CreateConfigurationSetEventDestinationOutput)

CreateConfigurationSetEventDestinationRequest generates a "aws/request.Request" representing the client's request for the CreateConfigurationSetEventDestination operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateConfigurationSetEventDestination for more information on using the CreateConfigurationSetEventDestination API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateConfigurationSetEventDestinationRequest method. req, resp := client.CreateConfigurationSetEventDestinationRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateConfigurationSetEventDestination

CreateConfigurationSetEventDestinationWithContext

func (c *SES) CreateConfigurationSetEventDestinationWithContext(ctx aws.Context, input *CreateConfigurationSetEventDestinationInput, opts ...request.Option) (*CreateConfigurationSetEventDestinationOutput, error)

CreateConfigurationSetEventDestinationWithContext is the same as CreateConfigurationSetEventDestination with the addition of the ability to pass a context and additional request options.

See CreateConfigurationSetEventDestination for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

CreateConfigurationSetRequest

func (c *SES) CreateConfigurationSetRequest(input *CreateConfigurationSetInput) (req *request.Request, output *CreateConfigurationSetOutput)

CreateConfigurationSetRequest generates a "aws/request.Request" representing the client's request for the CreateConfigurationSet operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateConfigurationSet for more information on using the CreateConfigurationSet API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateConfigurationSetRequest method. req, resp := client.CreateConfigurationSetRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateConfigurationSet

CreateConfigurationSetTrackingOptions

func (c *SES) CreateConfigurationSetTrackingOptions(input *CreateConfigurationSetTrackingOptionsInput) (*CreateConfigurationSetTrackingOptionsOutput, error)

CreateConfigurationSetTrackingOptions API operation for Amazon Simple Email Service.

Creates an association between a configuration set and a custom domain for 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).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation CreateConfigurationSetTrackingOptions for usage and error information.

Returned Error Codes:

  • ErrCodeConfigurationSetDoesNotExistException "ConfigurationSetDoesNotExist" Indicates that the configuration set does not exist.

  • ErrCodeTrackingOptionsAlreadyExistsException "TrackingOptionsAlreadyExistsException" Indicates that the configuration set you specified already contains a TrackingOptions object.

  • ErrCodeInvalidTrackingOptionsException "InvalidTrackingOptions" Indicates that the custom domain to be used for open and click tracking redirects is invalid. This error appears most often in the following situations:

  • When the tracking domain you specified is not verified in Amazon SES.

  • When the tracking domain you specified is not a valid domain or subdomain.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateConfigurationSetTrackingOptions

CreateConfigurationSetTrackingOptionsRequest

func (c *SES) CreateConfigurationSetTrackingOptionsRequest(input *CreateConfigurationSetTrackingOptionsInput) (req *request.Request, output *CreateConfigurationSetTrackingOptionsOutput)

CreateConfigurationSetTrackingOptionsRequest generates a "aws/request.Request" representing the client's request for the CreateConfigurationSetTrackingOptions operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateConfigurationSetTrackingOptions for more information on using the CreateConfigurationSetTrackingOptions API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateConfigurationSetTrackingOptionsRequest method. req, resp := client.CreateConfigurationSetTrackingOptionsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateConfigurationSetTrackingOptions

CreateConfigurationSetTrackingOptionsWithContext

func (c *SES) CreateConfigurationSetTrackingOptionsWithContext(ctx aws.Context, input *CreateConfigurationSetTrackingOptionsInput, opts ...request.Option) (*CreateConfigurationSetTrackingOptionsOutput, error)

CreateConfigurationSetTrackingOptionsWithContext is the same as CreateConfigurationSetTrackingOptions with the addition of the ability to pass a context and additional request options.

See CreateConfigurationSetTrackingOptions for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

CreateConfigurationSetWithContext

func (c *SES) CreateConfigurationSetWithContext(ctx aws.Context, input *CreateConfigurationSetInput, opts ...request.Option) (*CreateConfigurationSetOutput, error)

CreateConfigurationSetWithContext is the same as CreateConfigurationSet with the addition of the ability to pass a context and additional request options.

See CreateConfigurationSet for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

CreateCustomVerificationEmailTemplate

func (c *SES) CreateCustomVerificationEmailTemplate(input *CreateCustomVerificationEmailTemplateInput) (*CreateCustomVerificationEmailTemplateOutput, error)

CreateCustomVerificationEmailTemplate API operation for Amazon Simple Email Service.

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) in the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation CreateCustomVerificationEmailTemplate for usage and error information.

Returned Error Codes:

  • ErrCodeCustomVerificationEmailTemplateAlreadyExistsException "CustomVerificationEmailTemplateAlreadyExists" Indicates that a custom verification email template with the name you specified already exists.

  • ErrCodeFromEmailAddressNotVerifiedException "FromEmailAddressNotVerified" Indicates that the sender address specified for a custom verification email is not verified, and is therefore not eligible to send the custom verification email.

  • ErrCodeCustomVerificationEmailInvalidContentException "CustomVerificationEmailInvalidContent" Indicates that custom verification email template provided content is invalid.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateCustomVerificationEmailTemplate

CreateCustomVerificationEmailTemplateRequest

func (c *SES) CreateCustomVerificationEmailTemplateRequest(input *CreateCustomVerificationEmailTemplateInput) (req *request.Request, output *CreateCustomVerificationEmailTemplateOutput)

CreateCustomVerificationEmailTemplateRequest generates a "aws/request.Request" representing the client's request for the CreateCustomVerificationEmailTemplate operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateCustomVerificationEmailTemplate for more information on using the CreateCustomVerificationEmailTemplate API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateCustomVerificationEmailTemplateRequest method. req, resp := client.CreateCustomVerificationEmailTemplateRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateCustomVerificationEmailTemplate

CreateCustomVerificationEmailTemplateWithContext

func (c *SES) CreateCustomVerificationEmailTemplateWithContext(ctx aws.Context, input *CreateCustomVerificationEmailTemplateInput, opts ...request.Option) (*CreateCustomVerificationEmailTemplateOutput, error)

CreateCustomVerificationEmailTemplateWithContext is the same as CreateCustomVerificationEmailTemplate with the addition of the ability to pass a context and additional request options.

See CreateCustomVerificationEmailTemplate for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

CreateReceiptFilter

func (c *SES) CreateReceiptFilter(input *CreateReceiptFilterInput) (*CreateReceiptFilterOutput, error)

CreateReceiptFilter API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation CreateReceiptFilter for usage and error information.

Returned Error Codes:

  • ErrCodeAlreadyExistsException "AlreadyExists" Indicates that a resource could not be created because of a naming conflict.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateReceiptFilter

Example

SES CreateReceiptFilter shared00

CreateReceiptFilter

The following example creates a new IP address filter:

{ svc := ses.New(session.New()) input := &ses.CreateReceiptFilterInput{ Filter: &ses.ReceiptFilter{ IpFilter: &ses.ReceiptIpFilter{ Cidr: aws.String("1.2.3.4/24"), Policy: aws.String("Allow"), }, Name: aws.String("MyFilter"), }, } result, err := svc.CreateReceiptFilter(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case ses.ErrCodeLimitExceededException: fmt.Println(ses.ErrCodeLimitExceededException, aerr.Error()) case ses.ErrCodeAlreadyExistsException: fmt.Println(ses.ErrCodeAlreadyExistsException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CreateReceiptFilterRequest

func (c *SES) CreateReceiptFilterRequest(input *CreateReceiptFilterInput) (req *request.Request, output *CreateReceiptFilterOutput)

CreateReceiptFilterRequest generates a "aws/request.Request" representing the client's request for the CreateReceiptFilter operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateReceiptFilter for more information on using the CreateReceiptFilter API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateReceiptFilterRequest method. req, resp := client.CreateReceiptFilterRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateReceiptFilter

CreateReceiptFilterWithContext

func (c *SES) CreateReceiptFilterWithContext(ctx aws.Context, input *CreateReceiptFilterInput, opts ...request.Option) (*CreateReceiptFilterOutput, error)

CreateReceiptFilterWithContext is the same as CreateReceiptFilter with the addition of the ability to pass a context and additional request options.

See CreateReceiptFilter for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

CreateReceiptRule

func (c *SES) CreateReceiptRule(input *CreateReceiptRuleInput) (*CreateReceiptRuleOutput, error)

CreateReceiptRule API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation CreateReceiptRule for usage and error information.

Returned Error Codes:

  • ErrCodeAlreadyExistsException "AlreadyExists" Indicates that a resource could not be created because of a naming conflict.

  • ErrCodeRuleDoesNotExistException "RuleDoesNotExist" Indicates that the provided receipt rule does not exist.

  • ErrCodeRuleSetDoesNotExistException "RuleSetDoesNotExist" Indicates that the provided receipt rule set does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateReceiptRule

Example

SES CreateReceiptRule shared00

CreateReceiptRule

The following example creates a new receipt rule:

{ svc := ses.New(session.New()) input := &ses.CreateReceiptRuleInput{ After: aws.String(""), Rule: &ses.ReceiptRule{ Actions: []*ses.ReceiptAction{ { S3Action: &ses.S3Action{ BucketName: aws.String("MyBucket"), ObjectKeyPrefix: aws.String("email"), }, }, }, Enabled: aws.Bool(true), Name: aws.String("MyRule"), ScanEnabled: aws.Bool(true), TlsPolicy: aws.String("Optional"), }, RuleSetName: aws.String("MyRuleSet"), } result, err := svc.CreateReceiptRule(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case ses.ErrCodeInvalidSnsTopicException: fmt.Println(ses.ErrCodeInvalidSnsTopicException, aerr.Error()) case ses.ErrCodeInvalidS3ConfigurationException: fmt.Println(ses.ErrCodeInvalidS3ConfigurationException, aerr.Error()) case ses.ErrCodeInvalidLambdaFunctionException: fmt.Println(ses.ErrCodeInvalidLambdaFunctionException, aerr.Error()) case ses.ErrCodeAlreadyExistsException: fmt.Println(ses.ErrCodeAlreadyExistsException, aerr.Error()) case ses.ErrCodeRuleDoesNotExistException: fmt.Println(ses.ErrCodeRuleDoesNotExistException, aerr.Error()) case ses.ErrCodeRuleSetDoesNotExistException: fmt.Println(ses.ErrCodeRuleSetDoesNotExistException, aerr.Error()) case ses.ErrCodeLimitExceededException: fmt.Println(ses.ErrCodeLimitExceededException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CreateReceiptRuleRequest

func (c *SES) CreateReceiptRuleRequest(input *CreateReceiptRuleInput) (req *request.Request, output *CreateReceiptRuleOutput)

CreateReceiptRuleRequest generates a "aws/request.Request" representing the client's request for the CreateReceiptRule operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateReceiptRule for more information on using the CreateReceiptRule API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateReceiptRuleRequest method. req, resp := client.CreateReceiptRuleRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateReceiptRule

CreateReceiptRuleSet

func (c *SES) CreateReceiptRuleSet(input *CreateReceiptRuleSetInput) (*CreateReceiptRuleSetOutput, error)

CreateReceiptRuleSet API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation CreateReceiptRuleSet for usage and error information.

Returned Error Codes:

  • ErrCodeAlreadyExistsException "AlreadyExists" Indicates that a resource could not be created because of a naming conflict.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateReceiptRuleSet

Example

SES CreateReceiptRuleSet shared00

CreateReceiptRuleSet

The following example creates an empty receipt rule set:

{ svc := ses.New(session.New()) input := &ses.CreateReceiptRuleSetInput{ RuleSetName: aws.String("MyRuleSet"), } result, err := svc.CreateReceiptRuleSet(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case ses.ErrCodeAlreadyExistsException: fmt.Println(ses.ErrCodeAlreadyExistsException, aerr.Error()) case ses.ErrCodeLimitExceededException: fmt.Println(ses.ErrCodeLimitExceededException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

CreateReceiptRuleSetRequest

func (c *SES) CreateReceiptRuleSetRequest(input *CreateReceiptRuleSetInput) (req *request.Request, output *CreateReceiptRuleSetOutput)

CreateReceiptRuleSetRequest generates a "aws/request.Request" representing the client's request for the CreateReceiptRuleSet operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateReceiptRuleSet for more information on using the CreateReceiptRuleSet API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateReceiptRuleSetRequest method. req, resp := client.CreateReceiptRuleSetRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateReceiptRuleSet

CreateReceiptRuleSetWithContext

func (c *SES) CreateReceiptRuleSetWithContext(ctx aws.Context, input *CreateReceiptRuleSetInput, opts ...request.Option) (*CreateReceiptRuleSetOutput, error)

CreateReceiptRuleSetWithContext is the same as CreateReceiptRuleSet with the addition of the ability to pass a context and additional request options.

See CreateReceiptRuleSet for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

CreateReceiptRuleWithContext

func (c *SES) CreateReceiptRuleWithContext(ctx aws.Context, input *CreateReceiptRuleInput, opts ...request.Option) (*CreateReceiptRuleOutput, error)

CreateReceiptRuleWithContext is the same as CreateReceiptRule with the addition of the ability to pass a context and additional request options.

See CreateReceiptRule for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

CreateTemplate

func (c *SES) CreateTemplate(input *CreateTemplateInput) (*CreateTemplateOutput, error)

CreateTemplate API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation CreateTemplate for usage and error information.

Returned Error Codes:

  • ErrCodeAlreadyExistsException "AlreadyExists" Indicates that a resource could not be created because of a naming conflict.

  • ErrCodeInvalidTemplateException "InvalidTemplate" Indicates that the template that you specified could not be rendered. This issue may occur when a template refers to a partial that does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateTemplate

CreateTemplateRequest

func (c *SES) CreateTemplateRequest(input *CreateTemplateInput) (req *request.Request, output *CreateTemplateOutput)

CreateTemplateRequest generates a "aws/request.Request" representing the client's request for the CreateTemplate operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateTemplate for more information on using the CreateTemplate API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateTemplateRequest method. req, resp := client.CreateTemplateRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateTemplate

CreateTemplateWithContext

func (c *SES) CreateTemplateWithContext(ctx aws.Context, input *CreateTemplateInput, opts ...request.Option) (*CreateTemplateOutput, error)

CreateTemplateWithContext is the same as CreateTemplate with the addition of the ability to pass a context and additional request options.

See CreateTemplate for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteConfigurationSet

func (c *SES) DeleteConfigurationSet(input *DeleteConfigurationSetInput) (*DeleteConfigurationSetOutput, error)

DeleteConfigurationSet API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation DeleteConfigurationSet for usage and error information.

Returned Error Codes:

  • ErrCodeConfigurationSetDoesNotExistException "ConfigurationSetDoesNotExist" Indicates that the configuration set does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteConfigurationSet

DeleteConfigurationSetEventDestination

func (c *SES) DeleteConfigurationSetEventDestination(input *DeleteConfigurationSetEventDestinationInput) (*DeleteConfigurationSetEventDestinationOutput, error)

DeleteConfigurationSetEventDestination API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation DeleteConfigurationSetEventDestination for usage and error information.

Returned Error Codes:

  • ErrCodeConfigurationSetDoesNotExistException "ConfigurationSetDoesNotExist" Indicates that the configuration set does not exist.

  • ErrCodeEventDestinationDoesNotExistException "EventDestinationDoesNotExist" Indicates that the event destination does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteConfigurationSetEventDestination

DeleteConfigurationSetEventDestinationRequest

func (c *SES) DeleteConfigurationSetEventDestinationRequest(input *DeleteConfigurationSetEventDestinationInput) (req *request.Request, output *DeleteConfigurationSetEventDestinationOutput)

DeleteConfigurationSetEventDestinationRequest generates a "aws/request.Request" representing the client's request for the DeleteConfigurationSetEventDestination operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteConfigurationSetEventDestination for more information on using the DeleteConfigurationSetEventDestination API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteConfigurationSetEventDestinationRequest method. req, resp := client.DeleteConfigurationSetEventDestinationRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteConfigurationSetEventDestination

DeleteConfigurationSetEventDestinationWithContext

func (c *SES) DeleteConfigurationSetEventDestinationWithContext(ctx aws.Context, input *DeleteConfigurationSetEventDestinationInput, opts ...request.Option) (*DeleteConfigurationSetEventDestinationOutput, error)

DeleteConfigurationSetEventDestinationWithContext is the same as DeleteConfigurationSetEventDestination with the addition of the ability to pass a context and additional request options.

See DeleteConfigurationSetEventDestination for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteConfigurationSetRequest

func (c *SES) DeleteConfigurationSetRequest(input *DeleteConfigurationSetInput) (req *request.Request, output *DeleteConfigurationSetOutput)

DeleteConfigurationSetRequest generates a "aws/request.Request" representing the client's request for the DeleteConfigurationSet operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteConfigurationSet for more information on using the DeleteConfigurationSet API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteConfigurationSetRequest method. req, resp := client.DeleteConfigurationSetRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteConfigurationSet

DeleteConfigurationSetTrackingOptions

func (c *SES) DeleteConfigurationSetTrackingOptions(input *DeleteConfigurationSetTrackingOptionsInput) (*DeleteConfigurationSetTrackingOptionsOutput, error)

DeleteConfigurationSetTrackingOptions API operation for Amazon Simple Email Service.

Deletes an association between a configuration set and a custom domain for 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).

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.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation DeleteConfigurationSetTrackingOptions for usage and error information.

Returned Error Codes:

  • ErrCodeConfigurationSetDoesNotExistException "ConfigurationSetDoesNotExist" Indicates that the configuration set does not exist.

  • ErrCodeTrackingOptionsDoesNotExistException "TrackingOptionsDoesNotExistException" Indicates that the TrackingOptions object you specified does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteConfigurationSetTrackingOptions

DeleteConfigurationSetTrackingOptionsRequest

func (c *SES) DeleteConfigurationSetTrackingOptionsRequest(input *DeleteConfigurationSetTrackingOptionsInput) (req *request.Request, output *DeleteConfigurationSetTrackingOptionsOutput)

DeleteConfigurationSetTrackingOptionsRequest generates a "aws/request.Request" representing the client's request for the DeleteConfigurationSetTrackingOptions operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteConfigurationSetTrackingOptions for more information on using the DeleteConfigurationSetTrackingOptions API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteConfigurationSetTrackingOptionsRequest method. req, resp := client.DeleteConfigurationSetTrackingOptionsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteConfigurationSetTrackingOptions

DeleteConfigurationSetTrackingOptionsWithContext

func (c *SES) DeleteConfigurationSetTrackingOptionsWithContext(ctx aws.Context, input *DeleteConfigurationSetTrackingOptionsInput, opts ...request.Option) (*DeleteConfigurationSetTrackingOptionsOutput, error)

DeleteConfigurationSetTrackingOptionsWithContext is the same as DeleteConfigurationSetTrackingOptions with the addition of the ability to pass a context and additional request options.

See DeleteConfigurationSetTrackingOptions for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteConfigurationSetWithContext

func (c *SES) DeleteConfigurationSetWithContext(ctx aws.Context, input *DeleteConfigurationSetInput, opts ...request.Option) (*DeleteConfigurationSetOutput, error)

DeleteConfigurationSetWithContext is the same as DeleteConfigurationSet with the addition of the ability to pass a context and additional request options.

See DeleteConfigurationSet for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteCustomVerificationEmailTemplate

func (c *SES) DeleteCustomVerificationEmailTemplate(input *DeleteCustomVerificationEmailTemplateInput) (*DeleteCustomVerificationEmailTemplateOutput, error)

DeleteCustomVerificationEmailTemplate API operation for Amazon Simple Email Service.

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) in the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation DeleteCustomVerificationEmailTemplate for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteCustomVerificationEmailTemplate

DeleteCustomVerificationEmailTemplateRequest

func (c *SES) DeleteCustomVerificationEmailTemplateRequest(input *DeleteCustomVerificationEmailTemplateInput) (req *request.Request, output *DeleteCustomVerificationEmailTemplateOutput)

DeleteCustomVerificationEmailTemplateRequest generates a "aws/request.Request" representing the client's request for the DeleteCustomVerificationEmailTemplate operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteCustomVerificationEmailTemplate for more information on using the DeleteCustomVerificationEmailTemplate API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteCustomVerificationEmailTemplateRequest method. req, resp := client.DeleteCustomVerificationEmailTemplateRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteCustomVerificationEmailTemplate

DeleteCustomVerificationEmailTemplateWithContext

func (c *SES) DeleteCustomVerificationEmailTemplateWithContext(ctx aws.Context, input *DeleteCustomVerificationEmailTemplateInput, opts ...request.Option) (*DeleteCustomVerificationEmailTemplateOutput, error)

DeleteCustomVerificationEmailTemplateWithContext is the same as DeleteCustomVerificationEmailTemplate with the addition of the ability to pass a context and additional request options.

See DeleteCustomVerificationEmailTemplate for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteIdentity

func (c *SES) DeleteIdentity(input *DeleteIdentityInput) (*DeleteIdentityOutput, error)

DeleteIdentity API operation for Amazon Simple Email Service.

Deletes the specified identity (an email address or a domain) from the list of verified identities.

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation DeleteIdentity for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteIdentity

Example

SES DeleteIdentity shared00

DeleteIdentity

The following example deletes an identity from the list of identities that have been submitted for verification with Amazon SES:

{ svc := ses.New(session.New()) input := &ses.DeleteIdentityInput{ Identity: aws.String("user@example.com"), } result, err := svc.DeleteIdentity(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DeleteIdentityPolicy

func (c *SES) DeleteIdentityPolicy(input *DeleteIdentityPolicyInput) (*DeleteIdentityPolicyOutput, error)

DeleteIdentityPolicy API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation DeleteIdentityPolicy for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteIdentityPolicy

Example

SES DeleteIdentityPolicy shared00

DeleteIdentityPolicy

The following example deletes a sending authorization policy for an identity:

{ svc := ses.New(session.New()) input := &ses.DeleteIdentityPolicyInput{ Identity: aws.String("user@example.com"), PolicyName: aws.String("MyPolicy"), } result, err := svc.DeleteIdentityPolicy(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DeleteIdentityPolicyRequest

func (c *SES) DeleteIdentityPolicyRequest(input *DeleteIdentityPolicyInput) (req *request.Request, output *DeleteIdentityPolicyOutput)

DeleteIdentityPolicyRequest generates a "aws/request.Request" representing the client's request for the DeleteIdentityPolicy operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteIdentityPolicy for more information on using the DeleteIdentityPolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteIdentityPolicyRequest method. req, resp := client.DeleteIdentityPolicyRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteIdentityPolicy

DeleteIdentityPolicyWithContext

func (c *SES) DeleteIdentityPolicyWithContext(ctx aws.Context, input *DeleteIdentityPolicyInput, opts ...request.Option) (*DeleteIdentityPolicyOutput, error)

DeleteIdentityPolicyWithContext is the same as DeleteIdentityPolicy with the addition of the ability to pass a context and additional request options.

See DeleteIdentityPolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteIdentityRequest

func (c *SES) DeleteIdentityRequest(input *DeleteIdentityInput) (req *request.Request, output *DeleteIdentityOutput)

DeleteIdentityRequest generates a "aws/request.Request" representing the client's request for the DeleteIdentity operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteIdentity for more information on using the DeleteIdentity API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteIdentityRequest method. req, resp := client.DeleteIdentityRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteIdentity

DeleteIdentityWithContext

func (c *SES) DeleteIdentityWithContext(ctx aws.Context, input *DeleteIdentityInput, opts ...request.Option) (*DeleteIdentityOutput, error)

DeleteIdentityWithContext is the same as DeleteIdentity with the addition of the ability to pass a context and additional request options.

See DeleteIdentity for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteReceiptFilter

func (c *SES) DeleteReceiptFilter(input *DeleteReceiptFilterInput) (*DeleteReceiptFilterOutput, error)

DeleteReceiptFilter API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation DeleteReceiptFilter for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteReceiptFilter

Example

SES DeleteReceiptFilter shared00

DeleteReceiptFilter

The following example deletes an IP address filter:

{ svc := ses.New(session.New()) input := &ses.DeleteReceiptFilterInput{ FilterName: aws.String("MyFilter"), } result, err := svc.DeleteReceiptFilter(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DeleteReceiptFilterRequest

func (c *SES) DeleteReceiptFilterRequest(input *DeleteReceiptFilterInput) (req *request.Request, output *DeleteReceiptFilterOutput)

DeleteReceiptFilterRequest generates a "aws/request.Request" representing the client's request for the DeleteReceiptFilter operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteReceiptFilter for more information on using the DeleteReceiptFilter API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteReceiptFilterRequest method. req, resp := client.DeleteReceiptFilterRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteReceiptFilter

DeleteReceiptFilterWithContext

func (c *SES) DeleteReceiptFilterWithContext(ctx aws.Context, input *DeleteReceiptFilterInput, opts ...request.Option) (*DeleteReceiptFilterOutput, error)

DeleteReceiptFilterWithContext is the same as DeleteReceiptFilter with the addition of the ability to pass a context and additional request options.

See DeleteReceiptFilter for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteReceiptRule

func (c *SES) DeleteReceiptRule(input *DeleteReceiptRuleInput) (*DeleteReceiptRuleOutput, error)

DeleteReceiptRule API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation DeleteReceiptRule for usage and error information.

Returned Error Codes:

  • ErrCodeRuleSetDoesNotExistException "RuleSetDoesNotExist" Indicates that the provided receipt rule set does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteReceiptRule

Example

SES DeleteReceiptRule shared00

DeleteReceiptRule

The following example deletes a receipt rule:

{ svc := ses.New(session.New()) input := &ses.DeleteReceiptRuleInput{ RuleName: aws.String("MyRule"), RuleSetName: aws.String("MyRuleSet"), } result, err := svc.DeleteReceiptRule(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case ses.ErrCodeRuleSetDoesNotExistException: fmt.Println(ses.ErrCodeRuleSetDoesNotExistException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DeleteReceiptRuleRequest

func (c *SES) DeleteReceiptRuleRequest(input *DeleteReceiptRuleInput) (req *request.Request, output *DeleteReceiptRuleOutput)

DeleteReceiptRuleRequest generates a "aws/request.Request" representing the client's request for the DeleteReceiptRule operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteReceiptRule for more information on using the DeleteReceiptRule API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteReceiptRuleRequest method. req, resp := client.DeleteReceiptRuleRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteReceiptRule

DeleteReceiptRuleSet

func (c *SES) DeleteReceiptRuleSet(input *DeleteReceiptRuleSetInput) (*DeleteReceiptRuleSetOutput, error)

DeleteReceiptRuleSet API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation DeleteReceiptRuleSet for usage and error information.

Returned Error Codes:

  • ErrCodeCannotDeleteException "CannotDelete" Indicates that the delete operation could not be completed.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteReceiptRuleSet

Example

SES DeleteReceiptRuleSet shared00

DeleteReceiptRuleSet

The following example deletes a receipt rule set:

{ svc := ses.New(session.New()) input := &ses.DeleteReceiptRuleSetInput{ RuleSetName: aws.String("MyRuleSet"), } result, err := svc.DeleteReceiptRuleSet(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case ses.ErrCodeCannotDeleteException: fmt.Println(ses.ErrCodeCannotDeleteException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DeleteReceiptRuleSetRequest

func (c *SES) DeleteReceiptRuleSetRequest(input *DeleteReceiptRuleSetInput) (req *request.Request, output *DeleteReceiptRuleSetOutput)

DeleteReceiptRuleSetRequest generates a "aws/request.Request" representing the client's request for the DeleteReceiptRuleSet operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteReceiptRuleSet for more information on using the DeleteReceiptRuleSet API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteReceiptRuleSetRequest method. req, resp := client.DeleteReceiptRuleSetRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteReceiptRuleSet

DeleteReceiptRuleSetWithContext

func (c *SES) DeleteReceiptRuleSetWithContext(ctx aws.Context, input *DeleteReceiptRuleSetInput, opts ...request.Option) (*DeleteReceiptRuleSetOutput, error)

DeleteReceiptRuleSetWithContext is the same as DeleteReceiptRuleSet with the addition of the ability to pass a context and additional request options.

See DeleteReceiptRuleSet for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteReceiptRuleWithContext

func (c *SES) DeleteReceiptRuleWithContext(ctx aws.Context, input *DeleteReceiptRuleInput, opts ...request.Option) (*DeleteReceiptRuleOutput, error)

DeleteReceiptRuleWithContext is the same as DeleteReceiptRule with the addition of the ability to pass a context and additional request options.

See DeleteReceiptRule for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteTemplate

func (c *SES) DeleteTemplate(input *DeleteTemplateInput) (*DeleteTemplateOutput, error)

DeleteTemplate API operation for Amazon Simple Email Service.

Deletes an email template.

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation DeleteTemplate for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteTemplate

DeleteTemplateRequest

func (c *SES) DeleteTemplateRequest(input *DeleteTemplateInput) (req *request.Request, output *DeleteTemplateOutput)

DeleteTemplateRequest generates a "aws/request.Request" representing the client's request for the DeleteTemplate operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteTemplate for more information on using the DeleteTemplate API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteTemplateRequest method. req, resp := client.DeleteTemplateRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteTemplate

DeleteTemplateWithContext

func (c *SES) DeleteTemplateWithContext(ctx aws.Context, input *DeleteTemplateInput, opts ...request.Option) (*DeleteTemplateOutput, error)

DeleteTemplateWithContext is the same as DeleteTemplate with the addition of the ability to pass a context and additional request options.

See DeleteTemplate for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteVerifiedEmailAddress

func (c *SES) DeleteVerifiedEmailAddress(input *DeleteVerifiedEmailAddressInput) (*DeleteVerifiedEmailAddressOutput, error)

DeleteVerifiedEmailAddress API operation for Amazon Simple Email Service.

Deprecated. Use the DeleteIdentity operation to delete email addresses and domains.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation DeleteVerifiedEmailAddress for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteVerifiedEmailAddress

Example

SES DeleteVerifiedEmailAddress shared00

DeleteVerifiedEmailAddress

The following example deletes an email address from the list of identities that have been submitted for verification with Amazon SES:

{ svc := ses.New(session.New()) input := &ses.DeleteVerifiedEmailAddressInput{ EmailAddress: aws.String("user@example.com"), } result, err := svc.DeleteVerifiedEmailAddress(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DeleteVerifiedEmailAddressRequest

func (c *SES) DeleteVerifiedEmailAddressRequest(input *DeleteVerifiedEmailAddressInput) (req *request.Request, output *DeleteVerifiedEmailAddressOutput)

DeleteVerifiedEmailAddressRequest generates a "aws/request.Request" representing the client's request for the DeleteVerifiedEmailAddress operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteVerifiedEmailAddress for more information on using the DeleteVerifiedEmailAddress API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteVerifiedEmailAddressRequest method. req, resp := client.DeleteVerifiedEmailAddressRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DeleteVerifiedEmailAddress

DeleteVerifiedEmailAddressWithContext

func (c *SES) DeleteVerifiedEmailAddressWithContext(ctx aws.Context, input *DeleteVerifiedEmailAddressInput, opts ...request.Option) (*DeleteVerifiedEmailAddressOutput, error)

DeleteVerifiedEmailAddressWithContext is the same as DeleteVerifiedEmailAddress with the addition of the ability to pass a context and additional request options.

See DeleteVerifiedEmailAddress for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DescribeActiveReceiptRuleSet

func (c *SES) DescribeActiveReceiptRuleSet(input *DescribeActiveReceiptRuleSetInput) (*DescribeActiveReceiptRuleSetOutput, error)

DescribeActiveReceiptRuleSet API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation DescribeActiveReceiptRuleSet for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DescribeActiveReceiptRuleSet

Example

SES DescribeActiveReceiptRuleSet shared00

DescribeActiveReceiptRuleSet

The following example returns the metadata and receipt rules for the receipt rule set that is currently active:

{ svc := ses.New(session.New()) input := &ses.DescribeActiveReceiptRuleSetInput{} result, err := svc.DescribeActiveReceiptRuleSet(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeActiveReceiptRuleSetRequest

func (c *SES) DescribeActiveReceiptRuleSetRequest(input *DescribeActiveReceiptRuleSetInput) (req *request.Request, output *DescribeActiveReceiptRuleSetOutput)

DescribeActiveReceiptRuleSetRequest generates a "aws/request.Request" representing the client's request for the DescribeActiveReceiptRuleSet operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeActiveReceiptRuleSet for more information on using the DescribeActiveReceiptRuleSet API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeActiveReceiptRuleSetRequest method. req, resp := client.DescribeActiveReceiptRuleSetRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DescribeActiveReceiptRuleSet

DescribeActiveReceiptRuleSetWithContext

func (c *SES) DescribeActiveReceiptRuleSetWithContext(ctx aws.Context, input *DescribeActiveReceiptRuleSetInput, opts ...request.Option) (*DescribeActiveReceiptRuleSetOutput, error)

DescribeActiveReceiptRuleSetWithContext is the same as DescribeActiveReceiptRuleSet with the addition of the ability to pass a context and additional request options.

See DescribeActiveReceiptRuleSet for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DescribeConfigurationSet

func (c *SES) DescribeConfigurationSet(input *DescribeConfigurationSetInput) (*DescribeConfigurationSetOutput, error)

DescribeConfigurationSet API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation DescribeConfigurationSet for usage and error information.

Returned Error Codes:

  • ErrCodeConfigurationSetDoesNotExistException "ConfigurationSetDoesNotExist" Indicates that the configuration set does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DescribeConfigurationSet

DescribeConfigurationSetRequest

func (c *SES) DescribeConfigurationSetRequest(input *DescribeConfigurationSetInput) (req *request.Request, output *DescribeConfigurationSetOutput)

DescribeConfigurationSetRequest generates a "aws/request.Request" representing the client's request for the DescribeConfigurationSet operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeConfigurationSet for more information on using the DescribeConfigurationSet API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeConfigurationSetRequest method. req, resp := client.DescribeConfigurationSetRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DescribeConfigurationSet

DescribeConfigurationSetWithContext

func (c *SES) DescribeConfigurationSetWithContext(ctx aws.Context, input *DescribeConfigurationSetInput, opts ...request.Option) (*DescribeConfigurationSetOutput, error)

DescribeConfigurationSetWithContext is the same as DescribeConfigurationSet with the addition of the ability to pass a context and additional request options.

See DescribeConfigurationSet for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DescribeReceiptRule

func (c *SES) DescribeReceiptRule(input *DescribeReceiptRuleInput) (*DescribeReceiptRuleOutput, error)

DescribeReceiptRule API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation DescribeReceiptRule for usage and error information.

Returned Error Codes:

  • ErrCodeRuleDoesNotExistException "RuleDoesNotExist" Indicates that the provided receipt rule does not exist.

  • ErrCodeRuleSetDoesNotExistException "RuleSetDoesNotExist" Indicates that the provided receipt rule set does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DescribeReceiptRule

Example

SES DescribeReceiptRule shared00

DescribeReceiptRule

The following example returns the details of a receipt rule:

{ svc := ses.New(session.New()) input := &ses.DescribeReceiptRuleInput{ RuleName: aws.String("MyRule"), RuleSetName: aws.String("MyRuleSet"), } result, err := svc.DescribeReceiptRule(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case ses.ErrCodeRuleDoesNotExistException: fmt.Println(ses.ErrCodeRuleDoesNotExistException, aerr.Error()) case ses.ErrCodeRuleSetDoesNotExistException: fmt.Println(ses.ErrCodeRuleSetDoesNotExistException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeReceiptRuleRequest

func (c *SES) DescribeReceiptRuleRequest(input *DescribeReceiptRuleInput) (req *request.Request, output *DescribeReceiptRuleOutput)

DescribeReceiptRuleRequest generates a "aws/request.Request" representing the client's request for the DescribeReceiptRule operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeReceiptRule for more information on using the DescribeReceiptRule API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeReceiptRuleRequest method. req, resp := client.DescribeReceiptRuleRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DescribeReceiptRule

DescribeReceiptRuleSet

func (c *SES) DescribeReceiptRuleSet(input *DescribeReceiptRuleSetInput) (*DescribeReceiptRuleSetOutput, error)

DescribeReceiptRuleSet API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation DescribeReceiptRuleSet for usage and error information.

Returned Error Codes:

  • ErrCodeRuleSetDoesNotExistException "RuleSetDoesNotExist" Indicates that the provided receipt rule set does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DescribeReceiptRuleSet

Example

SES DescribeReceiptRuleSet shared00

DescribeReceiptRuleSet

The following example returns the metadata and receipt rules of a receipt rule set:

{ svc := ses.New(session.New()) input := &ses.DescribeReceiptRuleSetInput{ RuleSetName: aws.String("MyRuleSet"), } result, err := svc.DescribeReceiptRuleSet(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case ses.ErrCodeRuleSetDoesNotExistException: fmt.Println(ses.ErrCodeRuleSetDoesNotExistException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

DescribeReceiptRuleSetRequest

func (c *SES) DescribeReceiptRuleSetRequest(input *DescribeReceiptRuleSetInput) (req *request.Request, output *DescribeReceiptRuleSetOutput)

DescribeReceiptRuleSetRequest generates a "aws/request.Request" representing the client's request for the DescribeReceiptRuleSet operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeReceiptRuleSet for more information on using the DescribeReceiptRuleSet API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeReceiptRuleSetRequest method. req, resp := client.DescribeReceiptRuleSetRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/DescribeReceiptRuleSet

DescribeReceiptRuleSetWithContext

func (c *SES) DescribeReceiptRuleSetWithContext(ctx aws.Context, input *DescribeReceiptRuleSetInput, opts ...request.Option) (*DescribeReceiptRuleSetOutput, error)

DescribeReceiptRuleSetWithContext is the same as DescribeReceiptRuleSet with the addition of the ability to pass a context and additional request options.

See DescribeReceiptRuleSet for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DescribeReceiptRuleWithContext

func (c *SES) DescribeReceiptRuleWithContext(ctx aws.Context, input *DescribeReceiptRuleInput, opts ...request.Option) (*DescribeReceiptRuleOutput, error)

DescribeReceiptRuleWithContext is the same as DescribeReceiptRule with the addition of the ability to pass a context and additional request options.

See DescribeReceiptRule for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetAccountSendingEnabled

func (c *SES) GetAccountSendingEnabled(input *GetAccountSendingEnabledInput) (*GetAccountSendingEnabledOutput, error)

GetAccountSendingEnabled API operation for Amazon Simple Email Service.

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.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation GetAccountSendingEnabled for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetAccountSendingEnabled

Example

SES GetAccountSendingEnabled shared00

GetAccountSendingEnabled

The following example returns if sending status for an account is enabled. (true / false):

{ svc := ses.New(session.New()) input := &ses.GetAccountSendingEnabledInput{} result, err := svc.GetAccountSendingEnabled(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

GetAccountSendingEnabledRequest

func (c *SES) GetAccountSendingEnabledRequest(input *GetAccountSendingEnabledInput) (req *request.Request, output *GetAccountSendingEnabledOutput)

GetAccountSendingEnabledRequest generates a "aws/request.Request" representing the client's request for the GetAccountSendingEnabled operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetAccountSendingEnabled for more information on using the GetAccountSendingEnabled API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetAccountSendingEnabledRequest method. req, resp := client.GetAccountSendingEnabledRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetAccountSendingEnabled

GetAccountSendingEnabledWithContext

func (c *SES) GetAccountSendingEnabledWithContext(ctx aws.Context, input *GetAccountSendingEnabledInput, opts ...request.Option) (*GetAccountSendingEnabledOutput, error)

GetAccountSendingEnabledWithContext is the same as GetAccountSendingEnabled with the addition of the ability to pass a context and additional request options.

See GetAccountSendingEnabled for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetCustomVerificationEmailTemplate

func (c *SES) GetCustomVerificationEmailTemplate(input *GetCustomVerificationEmailTemplateInput) (*GetCustomVerificationEmailTemplateOutput, error)

GetCustomVerificationEmailTemplate API operation for Amazon Simple Email Service.

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) in the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation GetCustomVerificationEmailTemplate for usage and error information.

Returned Error Codes:

  • ErrCodeCustomVerificationEmailTemplateDoesNotExistException "CustomVerificationEmailTemplateDoesNotExist" Indicates that a custom verification email template with the name you specified does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetCustomVerificationEmailTemplate

GetCustomVerificationEmailTemplateRequest

func (c *SES) GetCustomVerificationEmailTemplateRequest(input *GetCustomVerificationEmailTemplateInput) (req *request.Request, output *GetCustomVerificationEmailTemplateOutput)

GetCustomVerificationEmailTemplateRequest generates a "aws/request.Request" representing the client's request for the GetCustomVerificationEmailTemplate operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetCustomVerificationEmailTemplate for more information on using the GetCustomVerificationEmailTemplate API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetCustomVerificationEmailTemplateRequest method. req, resp := client.GetCustomVerificationEmailTemplateRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetCustomVerificationEmailTemplate

GetCustomVerificationEmailTemplateWithContext

func (c *SES) GetCustomVerificationEmailTemplateWithContext(ctx aws.Context, input *GetCustomVerificationEmailTemplateInput, opts ...request.Option) (*GetCustomVerificationEmailTemplateOutput, error)

GetCustomVerificationEmailTemplateWithContext is the same as GetCustomVerificationEmailTemplate with the addition of the ability to pass a context and additional request options.

See GetCustomVerificationEmailTemplate for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetIdentityDkimAttributes

func (c *SES) GetIdentityDkimAttributes(input *GetIdentityDkimAttributesInput) (*GetIdentityDkimAttributesOutput, error)

GetIdentityDkimAttributes API operation for Amazon Simple Email Service.

Returns the current status of Easy DKIM signing for an entity. For domain name identities, this operation also returns the DKIM tokens that are required for Easy DKIM signing, and whether Amazon SES has successfully verified that these tokens have been published.

This operation takes a list of identities as input and returns the following information for each:

  • Whether Easy DKIM signing is enabled or disabled.

  • A set of DKIM tokens that represent the identity. If the identity is an email address, the tokens represent the domain of that address.

  • Whether Amazon SES has successfully verified the DKIM tokens published in the domain's DNS. This information is only returned for domain name identities, not for email addresses.

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

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation GetIdentityDkimAttributes for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetIdentityDkimAttributes

Example

SES GetIdentityDkimAttributes shared00

GetIdentityDkimAttributes

The following example retrieves the Amazon SES Easy DKIM attributes for a list of identities:

{ svc := ses.New(session.New()) input := &ses.GetIdentityDkimAttributesInput{ Identities: []*string{ aws.String("example.com"), aws.String("user@example.com"), }, } result, err := svc.GetIdentityDkimAttributes(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

GetIdentityDkimAttributesRequest

func (c *SES) GetIdentityDkimAttributesRequest(input *GetIdentityDkimAttributesInput) (req *request.Request, output *GetIdentityDkimAttributesOutput)

GetIdentityDkimAttributesRequest generates a "aws/request.Request" representing the client's request for the GetIdentityDkimAttributes operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetIdentityDkimAttributes for more information on using the GetIdentityDkimAttributes API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetIdentityDkimAttributesRequest method. req, resp := client.GetIdentityDkimAttributesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetIdentityDkimAttributes

GetIdentityDkimAttributesWithContext

func (c *SES) GetIdentityDkimAttributesWithContext(ctx aws.Context, input *GetIdentityDkimAttributesInput, opts ...request.Option) (*GetIdentityDkimAttributesOutput, error)

GetIdentityDkimAttributesWithContext is the same as GetIdentityDkimAttributes with the addition of the ability to pass a context and additional request options.

See GetIdentityDkimAttributes for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetIdentityMailFromDomainAttributes

func (c *SES) GetIdentityMailFromDomainAttributes(input *GetIdentityMailFromDomainAttributesInput) (*GetIdentityMailFromDomainAttributesOutput, error)

GetIdentityMailFromDomainAttributes API operation for Amazon Simple Email Service.

Returns the custom MAIL FROM attributes for a list of identities (email addresses : domains).

This operation is throttled at one request per second and can only get custom MAIL FROM attributes for up to 100 identities at a time.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation GetIdentityMailFromDomainAttributes for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetIdentityMailFromDomainAttributes

Example

SES GetIdentityMailFromDomainAttributes shared00

GetIdentityMailFromDomainAttributes

The following example returns the custom MAIL FROM attributes for an identity:

{ svc := ses.New(session.New()) input := &ses.GetIdentityMailFromDomainAttributesInput{ Identities: []*string{ aws.String("example.com"), }, } result, err := svc.GetIdentityMailFromDomainAttributes(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

GetIdentityMailFromDomainAttributesRequest

func (c *SES) GetIdentityMailFromDomainAttributesRequest(input *GetIdentityMailFromDomainAttributesInput) (req *request.Request, output *GetIdentityMailFromDomainAttributesOutput)

GetIdentityMailFromDomainAttributesRequest generates a "aws/request.Request" representing the client's request for the GetIdentityMailFromDomainAttributes operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetIdentityMailFromDomainAttributes for more information on using the GetIdentityMailFromDomainAttributes API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetIdentityMailFromDomainAttributesRequest method. req, resp := client.GetIdentityMailFromDomainAttributesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetIdentityMailFromDomainAttributes

GetIdentityMailFromDomainAttributesWithContext

func (c *SES) GetIdentityMailFromDomainAttributesWithContext(ctx aws.Context, input *GetIdentityMailFromDomainAttributesInput, opts ...request.Option) (*GetIdentityMailFromDomainAttributesOutput, error)

GetIdentityMailFromDomainAttributesWithContext is the same as GetIdentityMailFromDomainAttributes with the addition of the ability to pass a context and additional request options.

See GetIdentityMailFromDomainAttributes for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetIdentityNotificationAttributes

func (c *SES) GetIdentityNotificationAttributes(input *GetIdentityNotificationAttributesInput) (*GetIdentityNotificationAttributesOutput, error)

GetIdentityNotificationAttributes API operation for Amazon Simple Email Service.

Given a list of verified identities (email addresses and/or domains), returns a 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).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation GetIdentityNotificationAttributes for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetIdentityNotificationAttributes

Example

SES GetIdentityNotificationAttributes shared00

GetIdentityNotificationAttributes

The following example returns the notification attributes for an identity:

{ svc := ses.New(session.New()) input := &ses.GetIdentityNotificationAttributesInput{ Identities: []*string{ aws.String("example.com"), }, } result, err := svc.GetIdentityNotificationAttributes(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

GetIdentityNotificationAttributesRequest

func (c *SES) GetIdentityNotificationAttributesRequest(input *GetIdentityNotificationAttributesInput) (req *request.Request, output *GetIdentityNotificationAttributesOutput)

GetIdentityNotificationAttributesRequest generates a "aws/request.Request" representing the client's request for the GetIdentityNotificationAttributes operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetIdentityNotificationAttributes for more information on using the GetIdentityNotificationAttributes API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetIdentityNotificationAttributesRequest method. req, resp := client.GetIdentityNotificationAttributesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetIdentityNotificationAttributes

GetIdentityNotificationAttributesWithContext

func (c *SES) GetIdentityNotificationAttributesWithContext(ctx aws.Context, input *GetIdentityNotificationAttributesInput, opts ...request.Option) (*GetIdentityNotificationAttributesOutput, error)

GetIdentityNotificationAttributesWithContext is the same as GetIdentityNotificationAttributes with the addition of the ability to pass a context and additional request options.

See GetIdentityNotificationAttributes for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetIdentityPolicies

func (c *SES) GetIdentityPolicies(input *GetIdentityPoliciesInput) (*GetIdentityPoliciesOutput, error)

GetIdentityPolicies API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation GetIdentityPolicies for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetIdentityPolicies

Example

SES GetIdentityPolicies shared00

GetIdentityPolicies

The following example returns a sending authorization policy for an identity:

{ svc := ses.New(session.New()) input := &ses.GetIdentityPoliciesInput{ Identity: aws.String("example.com"), PolicyNames: []*string{ aws.String("MyPolicy"), }, } result, err := svc.GetIdentityPolicies(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

GetIdentityPoliciesRequest

func (c *SES) GetIdentityPoliciesRequest(input *GetIdentityPoliciesInput) (req *request.Request, output *GetIdentityPoliciesOutput)

GetIdentityPoliciesRequest generates a "aws/request.Request" representing the client's request for the GetIdentityPolicies operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetIdentityPolicies for more information on using the GetIdentityPolicies API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetIdentityPoliciesRequest method. req, resp := client.GetIdentityPoliciesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetIdentityPolicies

GetIdentityPoliciesWithContext

func (c *SES) GetIdentityPoliciesWithContext(ctx aws.Context, input *GetIdentityPoliciesInput, opts ...request.Option) (*GetIdentityPoliciesOutput, error)

GetIdentityPoliciesWithContext is the same as GetIdentityPolicies with the addition of the ability to pass a context and additional request options.

See GetIdentityPolicies for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetIdentityVerificationAttributes

func (c *SES) GetIdentityVerificationAttributes(input *GetIdentityVerificationAttributesInput) (*GetIdentityVerificationAttributesOutput, error)

GetIdentityVerificationAttributes API operation for Amazon Simple Email Service.

Given a list of identities (email addresses and/or domains), returns the verification status and (for domain identities) the verification token for each identity.

The verification status of an email address is "Pending" until the email address owner clicks the link within the verification email that Amazon 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.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation GetIdentityVerificationAttributes for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetIdentityVerificationAttributes

Example

SES GetIdentityVerificationAttributes shared00

GetIdentityVerificationAttributes

The following example returns the verification status and the verification token for a domain identity:

{ svc := ses.New(session.New()) input := &ses.GetIdentityVerificationAttributesInput{ Identities: []*string{ aws.String("example.com"), }, } result, err := svc.GetIdentityVerificationAttributes(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

GetIdentityVerificationAttributesRequest

func (c *SES) GetIdentityVerificationAttributesRequest(input *GetIdentityVerificationAttributesInput) (req *request.Request, output *GetIdentityVerificationAttributesOutput)

GetIdentityVerificationAttributesRequest generates a "aws/request.Request" representing the client's request for the GetIdentityVerificationAttributes operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetIdentityVerificationAttributes for more information on using the GetIdentityVerificationAttributes API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetIdentityVerificationAttributesRequest method. req, resp := client.GetIdentityVerificationAttributesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetIdentityVerificationAttributes

GetIdentityVerificationAttributesWithContext

func (c *SES) GetIdentityVerificationAttributesWithContext(ctx aws.Context, input *GetIdentityVerificationAttributesInput, opts ...request.Option) (*GetIdentityVerificationAttributesOutput, error)

GetIdentityVerificationAttributesWithContext is the same as GetIdentityVerificationAttributes with the addition of the ability to pass a context and additional request options.

See GetIdentityVerificationAttributes for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetSendQuota

func (c *SES) GetSendQuota(input *GetSendQuotaInput) (*GetSendQuotaOutput, error)

GetSendQuota API operation for Amazon Simple Email Service.

Provides the sending limits for the Amazon SES account.

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation GetSendQuota for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetSendQuota

Example

SES GetSendQuota shared00

GetSendQuota

The following example returns the Amazon SES sending limits for an AWS account:

{ svc := ses.New(session.New()) input := &ses.GetSendQuotaInput{} result, err := svc.GetSendQuota(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

GetSendQuotaRequest

func (c *SES) GetSendQuotaRequest(input *GetSendQuotaInput) (req *request.Request, output *GetSendQuotaOutput)

GetSendQuotaRequest generates a "aws/request.Request" representing the client's request for the GetSendQuota operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetSendQuota for more information on using the GetSendQuota API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetSendQuotaRequest method. req, resp := client.GetSendQuotaRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetSendQuota

GetSendQuotaWithContext

func (c *SES) GetSendQuotaWithContext(ctx aws.Context, input *GetSendQuotaInput, opts ...request.Option) (*GetSendQuotaOutput, error)

GetSendQuotaWithContext is the same as GetSendQuota with the addition of the ability to pass a context and additional request options.

See GetSendQuota for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetSendStatistics

func (c *SES) GetSendStatistics(input *GetSendStatisticsInput) (*GetSendStatisticsOutput, error)

GetSendStatistics API operation for Amazon Simple Email Service.

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.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation GetSendStatistics for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetSendStatistics

Example

SES GetSendStatistics shared00

GetSendStatistics

The following example returns Amazon SES sending statistics:

{ svc := ses.New(session.New()) input := &ses.GetSendStatisticsInput{} result, err := svc.GetSendStatistics(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

GetSendStatisticsRequest

func (c *SES) GetSendStatisticsRequest(input *GetSendStatisticsInput) (req *request.Request, output *GetSendStatisticsOutput)

GetSendStatisticsRequest generates a "aws/request.Request" representing the client's request for the GetSendStatistics operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetSendStatistics for more information on using the GetSendStatistics API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetSendStatisticsRequest method. req, resp := client.GetSendStatisticsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetSendStatistics

GetSendStatisticsWithContext

func (c *SES) GetSendStatisticsWithContext(ctx aws.Context, input *GetSendStatisticsInput, opts ...request.Option) (*GetSendStatisticsOutput, error)

GetSendStatisticsWithContext is the same as GetSendStatistics with the addition of the ability to pass a context and additional request options.

See GetSendStatistics for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetTemplate

func (c *SES) GetTemplate(input *GetTemplateInput) (*GetTemplateOutput, error)

GetTemplate API operation for Amazon Simple Email Service.

Displays the template object (which includes the Subject line, HTML part and text part) for the template you specify.

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation GetTemplate for usage and error information.

Returned Error Codes:

  • ErrCodeTemplateDoesNotExistException "TemplateDoesNotExist" Indicates that the Template object you specified does not exist in your Amazon SES account.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetTemplate

GetTemplateRequest

func (c *SES) GetTemplateRequest(input *GetTemplateInput) (req *request.Request, output *GetTemplateOutput)

GetTemplateRequest generates a "aws/request.Request" representing the client's request for the GetTemplate operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetTemplate for more information on using the GetTemplate API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetTemplateRequest method. req, resp := client.GetTemplateRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/GetTemplate

GetTemplateWithContext

func (c *SES) GetTemplateWithContext(ctx aws.Context, input *GetTemplateInput, opts ...request.Option) (*GetTemplateOutput, error)

GetTemplateWithContext is the same as GetTemplate with the addition of the ability to pass a context and additional request options.

See GetTemplate for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListConfigurationSets

func (c *SES) ListConfigurationSets(input *ListConfigurationSetsInput) (*ListConfigurationSetsOutput, error)

ListConfigurationSets API operation for Amazon Simple Email Service.

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

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation ListConfigurationSets for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ListConfigurationSets

ListConfigurationSetsRequest

func (c *SES) ListConfigurationSetsRequest(input *ListConfigurationSetsInput) (req *request.Request, output *ListConfigurationSetsOutput)

ListConfigurationSetsRequest generates a "aws/request.Request" representing the client's request for the ListConfigurationSets operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListConfigurationSets for more information on using the ListConfigurationSets API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListConfigurationSetsRequest method. req, resp := client.ListConfigurationSetsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ListConfigurationSets

ListConfigurationSetsWithContext

func (c *SES) ListConfigurationSetsWithContext(ctx aws.Context, input *ListConfigurationSetsInput, opts ...request.Option) (*ListConfigurationSetsOutput, error)

ListConfigurationSetsWithContext is the same as ListConfigurationSets with the addition of the ability to pass a context and additional request options.

See ListConfigurationSets for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListCustomVerificationEmailTemplates

func (c *SES) ListCustomVerificationEmailTemplates(input *ListCustomVerificationEmailTemplatesInput) (*ListCustomVerificationEmailTemplatesOutput, error)

ListCustomVerificationEmailTemplates API operation for Amazon Simple Email Service.

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) in the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation ListCustomVerificationEmailTemplates for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ListCustomVerificationEmailTemplates

ListCustomVerificationEmailTemplatesPages

func (c *SES) ListCustomVerificationEmailTemplatesPages(input *ListCustomVerificationEmailTemplatesInput, fn func(*ListCustomVerificationEmailTemplatesOutput, bool) bool) error

ListCustomVerificationEmailTemplatesPages iterates over the pages of a ListCustomVerificationEmailTemplates operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListCustomVerificationEmailTemplates method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a ListCustomVerificationEmailTemplates operation. pageNum := 0 err := client.ListCustomVerificationEmailTemplatesPages(params, func(page *ListCustomVerificationEmailTemplatesOutput, lastPage bool) bool { pageNum++ fmt.Println(page) return pageNum <= 3 })

See Also

For more information about using this API, see AWS API Documentation.

ListCustomVerificationEmailTemplatesPagesWithContext

func (c *SES) ListCustomVerificationEmailTemplatesPagesWithContext(ctx aws.Context, input *ListCustomVerificationEmailTemplatesInput, fn func(*ListCustomVerificationEmailTemplatesOutput, bool) bool, opts ...request.Option) error

ListCustomVerificationEmailTemplatesPagesWithContext same as ListCustomVerificationEmailTemplatesPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListCustomVerificationEmailTemplatesRequest

func (c *SES) ListCustomVerificationEmailTemplatesRequest(input *ListCustomVerificationEmailTemplatesInput) (req *request.Request, output *ListCustomVerificationEmailTemplatesOutput)

ListCustomVerificationEmailTemplatesRequest generates a "aws/request.Request" representing the client's request for the ListCustomVerificationEmailTemplates operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListCustomVerificationEmailTemplates for more information on using the ListCustomVerificationEmailTemplates API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListCustomVerificationEmailTemplatesRequest method. req, resp := client.ListCustomVerificationEmailTemplatesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ListCustomVerificationEmailTemplates

ListCustomVerificationEmailTemplatesWithContext

func (c *SES) ListCustomVerificationEmailTemplatesWithContext(ctx aws.Context, input *ListCustomVerificationEmailTemplatesInput, opts ...request.Option) (*ListCustomVerificationEmailTemplatesOutput, error)

ListCustomVerificationEmailTemplatesWithContext is the same as ListCustomVerificationEmailTemplates with the addition of the ability to pass a context and additional request options.

See ListCustomVerificationEmailTemplates for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListIdentities

func (c *SES) ListIdentities(input *ListIdentitiesInput) (*ListIdentitiesOutput, error)

ListIdentities API operation for Amazon Simple Email Service.

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.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation ListIdentities for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ListIdentities

Example

SES ListIdentities shared00

ListIdentities

The following example lists the email address identities that have been submitted for verification with Amazon SES:

{ svc := ses.New(session.New()) input := &ses.ListIdentitiesInput{ IdentityType: aws.String("EmailAddress"), MaxItems: aws.Int64(123), NextToken: aws.String(""), } result, err := svc.ListIdentities(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ListIdentitiesPages

func (c *SES) ListIdentitiesPages(input *ListIdentitiesInput, fn func(*ListIdentitiesOutput, bool) bool) error

ListIdentitiesPages iterates over the pages of a ListIdentities operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListIdentities method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a ListIdentities operation. pageNum := 0 err := client.ListIdentitiesPages(params, func(page *ListIdentitiesOutput, lastPage bool) bool { pageNum++ fmt.Println(page) return pageNum <= 3 })

See Also

For more information about using this API, see AWS API Documentation.

ListIdentitiesPagesWithContext

func (c *SES) ListIdentitiesPagesWithContext(ctx aws.Context, input *ListIdentitiesInput, fn func(*ListIdentitiesOutput, bool) bool, opts ...request.Option) error

ListIdentitiesPagesWithContext same as ListIdentitiesPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListIdentitiesRequest

func (c *SES) ListIdentitiesRequest(input *ListIdentitiesInput) (req *request.Request, output *ListIdentitiesOutput)

ListIdentitiesRequest generates a "aws/request.Request" representing the client's request for the ListIdentities operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListIdentities for more information on using the ListIdentities API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListIdentitiesRequest method. req, resp := client.ListIdentitiesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ListIdentities

ListIdentitiesWithContext

func (c *SES) ListIdentitiesWithContext(ctx aws.Context, input *ListIdentitiesInput, opts ...request.Option) (*ListIdentitiesOutput, error)

ListIdentitiesWithContext is the same as ListIdentities with the addition of the ability to pass a context and additional request options.

See ListIdentities for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListIdentityPolicies

func (c *SES) ListIdentityPolicies(input *ListIdentityPoliciesInput) (*ListIdentityPoliciesOutput, error)

ListIdentityPolicies API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation ListIdentityPolicies for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ListIdentityPolicies

Example

SES ListIdentityPolicies shared00

ListIdentityPolicies

The following example returns a list of sending authorization policies that are attached to an identity:

{ svc := ses.New(session.New()) input := &ses.ListIdentityPoliciesInput{ Identity: aws.String("example.com"), } result, err := svc.ListIdentityPolicies(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ListIdentityPoliciesRequest

func (c *SES) ListIdentityPoliciesRequest(input *ListIdentityPoliciesInput) (req *request.Request, output *ListIdentityPoliciesOutput)

ListIdentityPoliciesRequest generates a "aws/request.Request" representing the client's request for the ListIdentityPolicies operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListIdentityPolicies for more information on using the ListIdentityPolicies API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListIdentityPoliciesRequest method. req, resp := client.ListIdentityPoliciesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ListIdentityPolicies

ListIdentityPoliciesWithContext

func (c *SES) ListIdentityPoliciesWithContext(ctx aws.Context, input *ListIdentityPoliciesInput, opts ...request.Option) (*ListIdentityPoliciesOutput, error)

ListIdentityPoliciesWithContext is the same as ListIdentityPolicies with the addition of the ability to pass a context and additional request options.

See ListIdentityPolicies for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListReceiptFilters

func (c *SES) ListReceiptFilters(input *ListReceiptFiltersInput) (*ListReceiptFiltersOutput, error)

ListReceiptFilters API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation ListReceiptFilters for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ListReceiptFilters

Example

SES ListReceiptFilters shared00

ListReceiptFilters

The following example lists the IP address filters that are associated with an AWS account:

{ svc := ses.New(session.New()) input := &ses.ListReceiptFiltersInput{} result, err := svc.ListReceiptFilters(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ListReceiptFiltersRequest

func (c *SES) ListReceiptFiltersRequest(input *ListReceiptFiltersInput) (req *request.Request, output *ListReceiptFiltersOutput)

ListReceiptFiltersRequest generates a "aws/request.Request" representing the client's request for the ListReceiptFilters operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListReceiptFilters for more information on using the ListReceiptFilters API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListReceiptFiltersRequest method. req, resp := client.ListReceiptFiltersRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ListReceiptFilters

ListReceiptFiltersWithContext

func (c *SES) ListReceiptFiltersWithContext(ctx aws.Context, input *ListReceiptFiltersInput, opts ...request.Option) (*ListReceiptFiltersOutput, error)

ListReceiptFiltersWithContext is the same as ListReceiptFilters with the addition of the ability to pass a context and additional request options.

See ListReceiptFilters for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListReceiptRuleSets

func (c *SES) ListReceiptRuleSets(input *ListReceiptRuleSetsInput) (*ListReceiptRuleSetsOutput, error)

ListReceiptRuleSets API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation ListReceiptRuleSets for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ListReceiptRuleSets

Example

SES ListReceiptRuleSets shared00

ListReceiptRuleSets

The following example lists the receipt rule sets that exist under an AWS account:

{ svc := ses.New(session.New()) input := &ses.ListReceiptRuleSetsInput{ NextToken: aws.String(""), } result, err := svc.ListReceiptRuleSets(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ListReceiptRuleSetsRequest

func (c *SES) ListReceiptRuleSetsRequest(input *ListReceiptRuleSetsInput) (req *request.Request, output *ListReceiptRuleSetsOutput)

ListReceiptRuleSetsRequest generates a "aws/request.Request" representing the client's request for the ListReceiptRuleSets operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListReceiptRuleSets for more information on using the ListReceiptRuleSets API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListReceiptRuleSetsRequest method. req, resp := client.ListReceiptRuleSetsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ListReceiptRuleSets

ListReceiptRuleSetsWithContext

func (c *SES) ListReceiptRuleSetsWithContext(ctx aws.Context, input *ListReceiptRuleSetsInput, opts ...request.Option) (*ListReceiptRuleSetsOutput, error)

ListReceiptRuleSetsWithContext is the same as ListReceiptRuleSets with the addition of the ability to pass a context and additional request options.

See ListReceiptRuleSets for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListTemplates

func (c *SES) ListTemplates(input *ListTemplatesInput) (*ListTemplatesOutput, error)

ListTemplates API operation for Amazon Simple Email Service.

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.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation ListTemplates for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ListTemplates

ListTemplatesRequest

func (c *SES) ListTemplatesRequest(input *ListTemplatesInput) (req *request.Request, output *ListTemplatesOutput)

ListTemplatesRequest generates a "aws/request.Request" representing the client's request for the ListTemplates operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListTemplates for more information on using the ListTemplates API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListTemplatesRequest method. req, resp := client.ListTemplatesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ListTemplates

ListTemplatesWithContext

func (c *SES) ListTemplatesWithContext(ctx aws.Context, input *ListTemplatesInput, opts ...request.Option) (*ListTemplatesOutput, error)

ListTemplatesWithContext is the same as ListTemplates with the addition of the ability to pass a context and additional request options.

See ListTemplates for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListVerifiedEmailAddresses

func (c *SES) ListVerifiedEmailAddresses(input *ListVerifiedEmailAddressesInput) (*ListVerifiedEmailAddressesOutput, error)

ListVerifiedEmailAddresses API operation for Amazon Simple Email Service.

Deprecated. Use the ListIdentities operation to list the email addresses and domains associated with your account.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation ListVerifiedEmailAddresses for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ListVerifiedEmailAddresses

Example

SES ListVerifiedEmailAddresses shared00

ListVerifiedEmailAddresses

The following example lists all email addresses that have been submitted for verification with Amazon SES:

{ svc := ses.New(session.New()) input := &ses.ListVerifiedEmailAddressesInput{} result, err := svc.ListVerifiedEmailAddresses(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ListVerifiedEmailAddressesRequest

func (c *SES) ListVerifiedEmailAddressesRequest(input *ListVerifiedEmailAddressesInput) (req *request.Request, output *ListVerifiedEmailAddressesOutput)

ListVerifiedEmailAddressesRequest generates a "aws/request.Request" representing the client's request for the ListVerifiedEmailAddresses operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListVerifiedEmailAddresses for more information on using the ListVerifiedEmailAddresses API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListVerifiedEmailAddressesRequest method. req, resp := client.ListVerifiedEmailAddressesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ListVerifiedEmailAddresses

ListVerifiedEmailAddressesWithContext

func (c *SES) ListVerifiedEmailAddressesWithContext(ctx aws.Context, input *ListVerifiedEmailAddressesInput, opts ...request.Option) (*ListVerifiedEmailAddressesOutput, error)

ListVerifiedEmailAddressesWithContext is the same as ListVerifiedEmailAddresses with the addition of the ability to pass a context and additional request options.

See ListVerifiedEmailAddresses for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

PutIdentityPolicy

func (c *SES) PutIdentityPolicy(input *PutIdentityPolicyInput) (*PutIdentityPolicyOutput, error)

PutIdentityPolicy API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation PutIdentityPolicy for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidPolicyException "InvalidPolicy" Indicates that the provided policy is invalid. Check the error stack for more information about what caused the error.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/PutIdentityPolicy

Example

SES PutIdentityPolicy shared00

PutIdentityPolicy

The following example adds a sending authorization policy to an identity:

{ svc := ses.New(session.New()) input := &ses.PutIdentityPolicyInput{ Identity: aws.String("example.com"), Policy: aws.String("{\"Version\":\"2008-10-17\",\"Statement\":[{\"Sid\":\"stmt1469123904194\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789012:root\"},\"Action\":[\"ses:SendEmail\",\"ses:SendRawEmail\"],\"Resource\":\"arn:aws:ses:us-east-1:EXAMPLE65304:identity/example.com\"}]}"), PolicyName: aws.String("MyPolicy"), } result, err := svc.PutIdentityPolicy(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case ses.ErrCodeInvalidPolicyException: fmt.Println(ses.ErrCodeInvalidPolicyException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

PutIdentityPolicyRequest

func (c *SES) PutIdentityPolicyRequest(input *PutIdentityPolicyInput) (req *request.Request, output *PutIdentityPolicyOutput)

PutIdentityPolicyRequest generates a "aws/request.Request" representing the client's request for the PutIdentityPolicy operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutIdentityPolicy for more information on using the PutIdentityPolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the PutIdentityPolicyRequest method. req, resp := client.PutIdentityPolicyRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/PutIdentityPolicy

PutIdentityPolicyWithContext

func (c *SES) PutIdentityPolicyWithContext(ctx aws.Context, input *PutIdentityPolicyInput, opts ...request.Option) (*PutIdentityPolicyOutput, error)

PutIdentityPolicyWithContext is the same as PutIdentityPolicy with the addition of the ability to pass a context and additional request options.

See PutIdentityPolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ReorderReceiptRuleSet

func (c *SES) ReorderReceiptRuleSet(input *ReorderReceiptRuleSetInput) (*ReorderReceiptRuleSetOutput, error)

ReorderReceiptRuleSet API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation ReorderReceiptRuleSet for usage and error information.

Returned Error Codes:

  • ErrCodeRuleSetDoesNotExistException "RuleSetDoesNotExist" Indicates that the provided receipt rule set does not exist.

  • ErrCodeRuleDoesNotExistException "RuleDoesNotExist" Indicates that the provided receipt rule does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ReorderReceiptRuleSet

Example

SES ReorderReceiptRuleSet shared00

ReorderReceiptRuleSet

The following example reorders the receipt rules within a receipt rule set:

{ svc := ses.New(session.New()) input := &ses.ReorderReceiptRuleSetInput{ RuleNames: []*string{ aws.String("MyRule"), aws.String("MyOtherRule"), }, RuleSetName: aws.String("MyRuleSet"), } result, err := svc.ReorderReceiptRuleSet(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case ses.ErrCodeRuleSetDoesNotExistException: fmt.Println(ses.ErrCodeRuleSetDoesNotExistException, aerr.Error()) case ses.ErrCodeRuleDoesNotExistException: fmt.Println(ses.ErrCodeRuleDoesNotExistException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

ReorderReceiptRuleSetRequest

func (c *SES) ReorderReceiptRuleSetRequest(input *ReorderReceiptRuleSetInput) (req *request.Request, output *ReorderReceiptRuleSetOutput)

ReorderReceiptRuleSetRequest generates a "aws/request.Request" representing the client's request for the ReorderReceiptRuleSet operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ReorderReceiptRuleSet for more information on using the ReorderReceiptRuleSet API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ReorderReceiptRuleSetRequest method. req, resp := client.ReorderReceiptRuleSetRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/ReorderReceiptRuleSet

ReorderReceiptRuleSetWithContext

func (c *SES) ReorderReceiptRuleSetWithContext(ctx aws.Context, input *ReorderReceiptRuleSetInput, opts ...request.Option) (*ReorderReceiptRuleSetOutput, error)

ReorderReceiptRuleSetWithContext is the same as ReorderReceiptRuleSet with the addition of the ability to pass a context and additional request options.

See ReorderReceiptRuleSet for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

SendBounce

func (c *SES) SendBounce(input *SendBounceInput) (*SendBounceOutput, error)

SendBounce API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation SendBounce for usage and error information.

Returned Error Codes:

  • ErrCodeMessageRejected "MessageRejected" Indicates that the action failed, and the message could not be sent. Check the error stack for more information about what caused the error.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SendBounce

SendBounceRequest

func (c *SES) SendBounceRequest(input *SendBounceInput) (req *request.Request, output *SendBounceOutput)

SendBounceRequest generates a "aws/request.Request" representing the client's request for the SendBounce operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SendBounce for more information on using the SendBounce API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SendBounceRequest method. req, resp := client.SendBounceRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SendBounce

SendBounceWithContext

func (c *SES) SendBounceWithContext(ctx aws.Context, input *SendBounceInput, opts ...request.Option) (*SendBounceOutput, error)

SendBounceWithContext is the same as SendBounce with the addition of the ability to pass a context and additional request options.

See SendBounce for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

SendBulkTemplatedEmail

func (c *SES) SendBulkTemplatedEmail(input *SendBulkTemplatedEmailInput) (*SendBulkTemplatedEmailOutput, error)

SendBulkTemplatedEmail API operation for Amazon Simple Email Service.

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:

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

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

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation SendBulkTemplatedEmail for usage and error information.

Returned Error Codes:

  • ErrCodeMessageRejected "MessageRejected" Indicates that the action failed, and the message could not be sent. Check the error stack for more information about what caused the error.

  • ErrCodeMailFromDomainNotVerifiedException "MailFromDomainNotVerifiedException" Indicates that the message could not be sent because Amazon SES could not read the MX record required to use the specified MAIL FROM domain. For information about editing the custom MAIL FROM domain settings for an identity, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/mail-from-edit.html).

  • ErrCodeConfigurationSetDoesNotExistException "ConfigurationSetDoesNotExist" Indicates that the configuration set does not exist.

  • ErrCodeTemplateDoesNotExistException "TemplateDoesNotExist" Indicates that the Template object you specified does not exist in your Amazon SES account.

  • ErrCodeConfigurationSetSendingPausedException "ConfigurationSetSendingPausedException" Indicates that email sending is disabled for the configuration set.

You can enable or disable email sending for a configuration set using UpdateConfigurationSetSendingEnabled.
  • ErrCodeAccountSendingPausedException "AccountSendingPausedException" Indicates that email sending is disabled for your entire Amazon SES account.

You can enable or disable email sending for your Amazon SES account using UpdateAccountSendingEnabled.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SendBulkTemplatedEmail

SendBulkTemplatedEmailRequest

func (c *SES) SendBulkTemplatedEmailRequest(input *SendBulkTemplatedEmailInput) (req *request.Request, output *SendBulkTemplatedEmailOutput)

SendBulkTemplatedEmailRequest generates a "aws/request.Request" representing the client's request for the SendBulkTemplatedEmail operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SendBulkTemplatedEmail for more information on using the SendBulkTemplatedEmail API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SendBulkTemplatedEmailRequest method. req, resp := client.SendBulkTemplatedEmailRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SendBulkTemplatedEmail

SendBulkTemplatedEmailWithContext

func (c *SES) SendBulkTemplatedEmailWithContext(ctx aws.Context, input *SendBulkTemplatedEmailInput, opts ...request.Option) (*SendBulkTemplatedEmailOutput, error)

SendBulkTemplatedEmailWithContext is the same as SendBulkTemplatedEmail with the addition of the ability to pass a context and additional request options.

See SendBulkTemplatedEmail for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

SendCustomVerificationEmail

func (c *SES) SendCustomVerificationEmail(input *SendCustomVerificationEmailInput) (*SendCustomVerificationEmailOutput, error)

SendCustomVerificationEmail API operation for Amazon Simple Email Service.

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) in the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation SendCustomVerificationEmail for usage and error information.

Returned Error Codes:

  • ErrCodeMessageRejected "MessageRejected" Indicates that the action failed, and the message could not be sent. Check the error stack for more information about what caused the error.

  • ErrCodeConfigurationSetDoesNotExistException "ConfigurationSetDoesNotExist" Indicates that the configuration set does not exist.

  • ErrCodeCustomVerificationEmailTemplateDoesNotExistException "CustomVerificationEmailTemplateDoesNotExist" Indicates that a custom verification email template with the name you specified does not exist.

  • ErrCodeFromEmailAddressNotVerifiedException "FromEmailAddressNotVerified" Indicates that the sender address specified for a custom verification email is not verified, and is therefore not eligible to send the custom verification email.

  • ErrCodeProductionAccessNotGrantedException "ProductionAccessNotGranted" Indicates that the account has not been granted production access.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SendCustomVerificationEmail

SendCustomVerificationEmailRequest

func (c *SES) SendCustomVerificationEmailRequest(input *SendCustomVerificationEmailInput) (req *request.Request, output *SendCustomVerificationEmailOutput)

SendCustomVerificationEmailRequest generates a "aws/request.Request" representing the client's request for the SendCustomVerificationEmail operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SendCustomVerificationEmail for more information on using the SendCustomVerificationEmail API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SendCustomVerificationEmailRequest method. req, resp := client.SendCustomVerificationEmailRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SendCustomVerificationEmail

SendCustomVerificationEmailWithContext

func (c *SES) SendCustomVerificationEmailWithContext(ctx aws.Context, input *SendCustomVerificationEmailInput, opts ...request.Option) (*SendCustomVerificationEmailOutput, error)

SendCustomVerificationEmailWithContext is the same as SendCustomVerificationEmail with the addition of the ability to pass a context and additional request options.

See SendCustomVerificationEmail for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

SendEmail

func (c *SES) SendEmail(input *SendEmailInput) (*SendEmailOutput, error)

SendEmail API operation for Amazon Simple Email Service.

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:

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

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

  • 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 SendEmail operation several times to send the message to each group.

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) in the Amazon SES Developer Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation SendEmail for usage and error information.

Returned Error Codes:

  • ErrCodeMessageRejected "MessageRejected" Indicates that the action failed, and the message could not be sent. Check the error stack for more information about what caused the error.

  • ErrCodeMailFromDomainNotVerifiedException "MailFromDomainNotVerifiedException" Indicates that the message could not be sent because Amazon SES could not read the MX record required to use the specified MAIL FROM domain. For information about editing the custom MAIL FROM domain settings for an identity, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/mail-from-edit.html).

  • ErrCodeConfigurationSetDoesNotExistException "ConfigurationSetDoesNotExist" Indicates that the configuration set does not exist.

  • ErrCodeConfigurationSetSendingPausedException "ConfigurationSetSendingPausedException" Indicates that email sending is disabled for the configuration set.

You can enable or disable email sending for a configuration set using UpdateConfigurationSetSendingEnabled.
  • ErrCodeAccountSendingPausedException "AccountSendingPausedException" Indicates that email sending is disabled for your entire Amazon SES account.

You can enable or disable email sending for your Amazon SES account using UpdateAccountSendingEnabled.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SendEmail

Example

SES SendEmail shared00

SendEmail

The following example sends a formatted email:

{ svc := ses.New(session.New()) input := &ses.SendEmailInput{ Destination: &ses.Destination{ CcAddresses: []*string{ aws.String("recipient3@example.com"), }, ToAddresses: []*string{ aws.String("recipient1@example.com"), aws.String("recipient2@example.com"), }, }, Message: &ses.Message{ Body: &ses.Body{ Html: &ses.Content{ Charset: aws.String("UTF-8"), Data: aws.String("This message body contains HTML formatting. It can, for example, contain links like this one: <a class=\"ulink\" href=\"http://docs.aws.amazon.com/ses/latest/DeveloperGuide\" target=\"_blank\">Amazon SES Developer Guide</a>."), }, Text: &ses.Content{ Charset: aws.String("UTF-8"), Data: aws.String("This is the message body in text format."), }, }, Subject: &ses.Content{ Charset: aws.String("UTF-8"), Data: aws.String("Test email"), }, }, ReturnPath: aws.String(""), ReturnPathArn: aws.String(""), Source: aws.String("sender@example.com"), SourceArn: aws.String(""), } result, err := svc.SendEmail(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case ses.ErrCodeMessageRejected: fmt.Println(ses.ErrCodeMessageRejected, aerr.Error()) case ses.ErrCodeMailFromDomainNotVerifiedException: fmt.Println(ses.ErrCodeMailFromDomainNotVerifiedException, aerr.Error()) case ses.ErrCodeConfigurationSetDoesNotExistException: fmt.Println(ses.ErrCodeConfigurationSetDoesNotExistException, aerr.Error()) case ses.ErrCodeConfigurationSetSendingPausedException: fmt.Println(ses.ErrCodeConfigurationSetSendingPausedException, aerr.Error()) case ses.ErrCodeAccountSendingPausedException: fmt.Println(ses.ErrCodeAccountSendingPausedException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

SendEmailRequest

func (c *SES) SendEmailRequest(input *SendEmailInput) (req *request.Request, output *SendEmailOutput)

SendEmailRequest generates a "aws/request.Request" representing the client's request for the SendEmail operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SendEmail for more information on using the SendEmail API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SendEmailRequest method. req, resp := client.SendEmailRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SendEmail

SendEmailWithContext

func (c *SES) SendEmailWithContext(ctx aws.Context, input *SendEmailInput, opts ...request.Option) (*SendEmailOutput, error)

SendEmailWithContext is the same as SendEmail with the addition of the ability to pass a context and additional request options.

See SendEmail for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

SendRawEmail

func (c *SES) SendRawEmail(input *SendRawEmailInput) (*SendRawEmailOutput, error)

SendRawEmail API operation for Amazon Simple Email Service.

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 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 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:

(http://docs.aws.amazon.com/ses/latest/DeveloperGuide/mailbox-simulator.html).
  • The maximum message size, including attachments, is 10 MB.

  • Each message has to include at least one recipient address. A recipient address includes any address on the To:, CC:, or BCC: lines.

  • If you send a single message to more than one recipient address, and one of the recipient addresses isn't in a valid format (that is, it's not in the format UserName@[SubDomain.]Domain.TopLevelDomain), Amazon SES rejects the entire message, even if the other addresses are valid.

  • Each message can include up to 50 recipient addresses across the To:, CC:, or BCC: lines. If you need to send a single message to more than 50 recipients, you have to split the list of recipient addresses into groups of less than 50 recipients, and send separate messages to each group.

  • Amazon SES allows you to specify 8-bit Content-Transfer-Encoding for MIME 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) 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 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:

X-SES-SOURCE-ARN

X-SES-FROM-ARN

X-SES-RETURN-PATH-ARN

Do not include these X-headers in the DKIM signature; Amazon SES will remove

them before sending the email.

For most common sending authorization scenarios, we recommend that you specify

the SourceIdentityArn parameter and not the FromIdentityArn or ReturnPathIdentityArn parameters. If you only specify the SourceIdentityArn parameter, Amazon SES will set the From and Return Path addresses to the identity specified in SourceIdentityArn. For more information about sending authorization, see the Using Sending Authorization with Amazon SES (http://docs.aws.amazon.com/ses/latest/DeveloperGuide/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) in the Amazon SES Developer Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation SendRawEmail for usage and error information.

Returned Error Codes:

  • ErrCodeMessageRejected "MessageRejected" Indicates that the action failed, and the message could not be sent. Check the error stack for more information about what caused the error.

  • ErrCodeMailFromDomainNotVerifiedException "MailFromDomainNotVerifiedException" Indicates that the message could not be sent because Amazon SES could not read the MX record required to use the specified MAIL FROM domain. For information about editing the custom MAIL FROM domain settings for an identity, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/mail-from-edit.html).

  • ErrCodeConfigurationSetDoesNotExistException "ConfigurationSetDoesNotExist" Indicates that the configuration set does not exist.

  • ErrCodeConfigurationSetSendingPausedException "ConfigurationSetSendingPausedException" Indicates that email sending is disabled for the configuration set.

You can enable or disable email sending for a configuration set using UpdateConfigurationSetSendingEnabled.
  • ErrCodeAccountSendingPausedException "AccountSendingPausedException" Indicates that email sending is disabled for your entire Amazon SES account.

You can enable or disable email sending for your Amazon SES account using UpdateAccountSendingEnabled.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SendRawEmail

Example

SES SendRawEmail shared00

SendRawEmail

The following example sends an email with an attachment:

{ svc := ses.New(session.New()) input := &ses.SendRawEmailInput{ FromArn: aws.String(""), RawMessage: &ses.RawMessage{ Data: []byte("From: sender@example.com\\nTo: recipient@example.com\\nSubject: Test email (contains an attachment)\\nMIME-Version: 1.0\\nContent-type: Multipart/Mixed; boundary=\"NextPart\"\\n\\n--NextPart\\nContent-Type: text/plain\\n\\nThis is the message body.\\n\\n--NextPart\\nContent-Type: text/plain;\\nContent-Disposition: attachment; filename=\"attachment.txt\"\\n\\nThis is the text in the attachment.\\n\\n--NextPart--"), }, ReturnPathArn: aws.String(""), Source: aws.String(""), SourceArn: aws.String(""), } result, err := svc.SendRawEmail(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case ses.ErrCodeMessageRejected: fmt.Println(ses.ErrCodeMessageRejected, aerr.Error()) case ses.ErrCodeMailFromDomainNotVerifiedException: fmt.Println(ses.ErrCodeMailFromDomainNotVerifiedException, aerr.Error()) case ses.ErrCodeConfigurationSetDoesNotExistException: fmt.Println(ses.ErrCodeConfigurationSetDoesNotExistException, aerr.Error()) case ses.ErrCodeConfigurationSetSendingPausedException: fmt.Println(ses.ErrCodeConfigurationSetSendingPausedException, aerr.Error()) case ses.ErrCodeAccountSendingPausedException: fmt.Println(ses.ErrCodeAccountSendingPausedException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

SendRawEmailRequest

func (c *SES) SendRawEmailRequest(input *SendRawEmailInput) (req *request.Request, output *SendRawEmailOutput)

SendRawEmailRequest generates a "aws/request.Request" representing the client's request for the SendRawEmail operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SendRawEmail for more information on using the SendRawEmail API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SendRawEmailRequest method. req, resp := client.SendRawEmailRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SendRawEmail

SendRawEmailWithContext

func (c *SES) SendRawEmailWithContext(ctx aws.Context, input *SendRawEmailInput, opts ...request.Option) (*SendRawEmailOutput, error)

SendRawEmailWithContext is the same as SendRawEmail with the addition of the ability to pass a context and additional request options.

See SendRawEmail for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

SendTemplatedEmail

func (c *SES) SendTemplatedEmail(input *SendTemplatedEmailInput) (*SendTemplatedEmailOutput, error)

SendTemplatedEmail API operation for Amazon Simple Email Service.

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:

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

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

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

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 SES can't render the email because the template contains errors, it doesn't send the email. Additionally, because it already accepted the message, Amazon SES 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) in the Amazon Simple Email Service Developer Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation SendTemplatedEmail for usage and error information.

Returned Error Codes:

  • ErrCodeMessageRejected "MessageRejected" Indicates that the action failed, and the message could not be sent. Check the error stack for more information about what caused the error.

  • ErrCodeMailFromDomainNotVerifiedException "MailFromDomainNotVerifiedException" Indicates that the message could not be sent because Amazon SES could not read the MX record required to use the specified MAIL FROM domain. For information about editing the custom MAIL FROM domain settings for an identity, see the Amazon SES Developer Guide (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/mail-from-edit.html).

  • ErrCodeConfigurationSetDoesNotExistException "ConfigurationSetDoesNotExist" Indicates that the configuration set does not exist.

  • ErrCodeTemplateDoesNotExistException "TemplateDoesNotExist" Indicates that the Template object you specified does not exist in your Amazon SES account.

  • ErrCodeConfigurationSetSendingPausedException "ConfigurationSetSendingPausedException" Indicates that email sending is disabled for the configuration set.

You can enable or disable email sending for a configuration set using UpdateConfigurationSetSendingEnabled.
  • ErrCodeAccountSendingPausedException "AccountSendingPausedException" Indicates that email sending is disabled for your entire Amazon SES account.

You can enable or disable email sending for your Amazon SES account using UpdateAccountSendingEnabled.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SendTemplatedEmail

SendTemplatedEmailRequest

func (c *SES) SendTemplatedEmailRequest(input *SendTemplatedEmailInput) (req *request.Request, output *SendTemplatedEmailOutput)

SendTemplatedEmailRequest generates a "aws/request.Request" representing the client's request for the SendTemplatedEmail operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SendTemplatedEmail for more information on using the SendTemplatedEmail API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SendTemplatedEmailRequest method. req, resp := client.SendTemplatedEmailRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SendTemplatedEmail

SendTemplatedEmailWithContext

func (c *SES) SendTemplatedEmailWithContext(ctx aws.Context, input *SendTemplatedEmailInput, opts ...request.Option) (*SendTemplatedEmailOutput, error)

SendTemplatedEmailWithContext is the same as SendTemplatedEmail with the addition of the ability to pass a context and additional request options.

See SendTemplatedEmail for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

SetActiveReceiptRuleSet

func (c *SES) SetActiveReceiptRuleSet(input *SetActiveReceiptRuleSetInput) (*SetActiveReceiptRuleSetOutput, error)

SetActiveReceiptRuleSet API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation SetActiveReceiptRuleSet for usage and error information.

Returned Error Codes:

  • ErrCodeRuleSetDoesNotExistException "RuleSetDoesNotExist" Indicates that the provided receipt rule set does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SetActiveReceiptRuleSet

Example

SES SetActiveReceiptRuleSet shared00

SetActiveReceiptRuleSet

The following example sets the active receipt rule set:

{ svc := ses.New(session.New()) input := &ses.SetActiveReceiptRuleSetInput{ RuleSetName: aws.String("RuleSetToActivate"), } result, err := svc.SetActiveReceiptRuleSet(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case ses.ErrCodeRuleSetDoesNotExistException: fmt.Println(ses.ErrCodeRuleSetDoesNotExistException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

SetActiveReceiptRuleSetRequest

func (c *SES) SetActiveReceiptRuleSetRequest(input *SetActiveReceiptRuleSetInput) (req *request.Request, output *SetActiveReceiptRuleSetOutput)

SetActiveReceiptRuleSetRequest generates a "aws/request.Request" representing the client's request for the SetActiveReceiptRuleSet operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SetActiveReceiptRuleSet for more information on using the SetActiveReceiptRuleSet API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SetActiveReceiptRuleSetRequest method. req, resp := client.SetActiveReceiptRuleSetRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SetActiveReceiptRuleSet

SetActiveReceiptRuleSetWithContext

func (c *SES) SetActiveReceiptRuleSetWithContext(ctx aws.Context, input *SetActiveReceiptRuleSetInput, opts ...request.Option) (*SetActiveReceiptRuleSetOutput, error)

SetActiveReceiptRuleSetWithContext is the same as SetActiveReceiptRuleSet with the addition of the ability to pass a context and additional request options.

See SetActiveReceiptRuleSet for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

SetIdentityDkimEnabled

func (c *SES) SetIdentityDkimEnabled(input *SetIdentityDkimEnabledInput) (*SetIdentityDkimEnabledOutput, error)

SetIdentityDkimEnabled API operation for Amazon Simple Email Service.

Enables or disables Easy DKIM signing of email sent from an identity:

  • If Easy DKIM signing is enabled for a domain name identity (such as example.com), then Amazon SES will DKIM-sign all email sent by addresses under that domain name (for example, user@example.com).

  • If Easy DKIM signing is enabled for an email address, then Amazon SES will DKIM-sign all email sent by that email address.

For email addresses (for example, user@example.com), you can only enable Easy DKIM signing if the corresponding domain (in this case, example.com) has been set up for Easy DKIM using the AWS Console or the VerifyDomainDkim operation.

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

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation SetIdentityDkimEnabled for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SetIdentityDkimEnabled

Example

SES SetIdentityDkimEnabled shared00

SetIdentityDkimEnabled

The following example configures Amazon SES to Easy DKIM-sign the email sent from an identity:

{ svc := ses.New(session.New()) input := &ses.SetIdentityDkimEnabledInput{ DkimEnabled: aws.Bool(true), Identity: aws.String("user@example.com"), } result, err := svc.SetIdentityDkimEnabled(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

SetIdentityDkimEnabledRequest

func (c *SES) SetIdentityDkimEnabledRequest(input *SetIdentityDkimEnabledInput) (req *request.Request, output *SetIdentityDkimEnabledOutput)

SetIdentityDkimEnabledRequest generates a "aws/request.Request" representing the client's request for the SetIdentityDkimEnabled operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SetIdentityDkimEnabled for more information on using the SetIdentityDkimEnabled API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SetIdentityDkimEnabledRequest method. req, resp := client.SetIdentityDkimEnabledRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SetIdentityDkimEnabled

SetIdentityDkimEnabledWithContext

func (c *SES) SetIdentityDkimEnabledWithContext(ctx aws.Context, input *SetIdentityDkimEnabledInput, opts ...request.Option) (*SetIdentityDkimEnabledOutput, error)

SetIdentityDkimEnabledWithContext is the same as SetIdentityDkimEnabled with the addition of the ability to pass a context and additional request options.

See SetIdentityDkimEnabled for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

SetIdentityFeedbackForwardingEnabled

func (c *SES) SetIdentityFeedbackForwardingEnabled(input *SetIdentityFeedbackForwardingEnabledInput) (*SetIdentityFeedbackForwardingEnabledOutput, error)

SetIdentityFeedbackForwardingEnabled API operation for Amazon Simple Email Service.

Given an identity (an email address or a domain), enables or disables whether Amazon SES forwards bounce and complaint notifications as email. Feedback forwarding can only be disabled when Amazon Simple Notification Service (Amazon SNS) topics are specified for both bounces and complaints.

Feedback forwarding 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).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation SetIdentityFeedbackForwardingEnabled for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SetIdentityFeedbackForwardingEnabled

Example

SES SetIdentityFeedbackForwardingEnabled shared00

SetIdentityFeedbackForwardingEnabled

The following example configures Amazon SES to forward an identity's bounces and complaints via email:

{ svc := ses.New(session.New()) input := &ses.SetIdentityFeedbackForwardingEnabledInput{ ForwardingEnabled: aws.Bool(true), Identity: aws.String("user@example.com"), } result, err := svc.SetIdentityFeedbackForwardingEnabled(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

SetIdentityFeedbackForwardingEnabledRequest

func (c *SES) SetIdentityFeedbackForwardingEnabledRequest(input *SetIdentityFeedbackForwardingEnabledInput) (req *request.Request, output *SetIdentityFeedbackForwardingEnabledOutput)

SetIdentityFeedbackForwardingEnabledRequest generates a "aws/request.Request" representing the client's request for the SetIdentityFeedbackForwardingEnabled operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SetIdentityFeedbackForwardingEnabled for more information on using the SetIdentityFeedbackForwardingEnabled API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SetIdentityFeedbackForwardingEnabledRequest method. req, resp := client.SetIdentityFeedbackForwardingEnabledRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SetIdentityFeedbackForwardingEnabled

SetIdentityFeedbackForwardingEnabledWithContext

func (c *SES) SetIdentityFeedbackForwardingEnabledWithContext(ctx aws.Context, input *SetIdentityFeedbackForwardingEnabledInput, opts ...request.Option) (*SetIdentityFeedbackForwardingEnabledOutput, error)

SetIdentityFeedbackForwardingEnabledWithContext is the same as SetIdentityFeedbackForwardingEnabled with the addition of the ability to pass a context and additional request options.

See SetIdentityFeedbackForwardingEnabled for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

SetIdentityHeadersInNotificationsEnabled

func (c *SES) SetIdentityHeadersInNotificationsEnabled(input *SetIdentityHeadersInNotificationsEnabledInput) (*SetIdentityHeadersInNotificationsEnabledOutput, error)

SetIdentityHeadersInNotificationsEnabled API operation for Amazon Simple Email Service.

Given an identity (an email address or a domain), sets whether Amazon SES 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).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation SetIdentityHeadersInNotificationsEnabled for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SetIdentityHeadersInNotificationsEnabled

Example

SES SetIdentityHeadersInNotificationsEnabled shared00

SetIdentityHeadersInNotificationsEnabled

The following example configures Amazon SES to include the original email headers in the Amazon SNS bounce notifications for an identity:

{ svc := ses.New(session.New()) input := &ses.SetIdentityHeadersInNotificationsEnabledInput{ Enabled: aws.Bool(true), Identity: aws.String("user@example.com"), NotificationType: aws.String("Bounce"), } result, err := svc.SetIdentityHeadersInNotificationsEnabled(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

SetIdentityHeadersInNotificationsEnabledRequest

func (c *SES) SetIdentityHeadersInNotificationsEnabledRequest(input *SetIdentityHeadersInNotificationsEnabledInput) (req *request.Request, output *SetIdentityHeadersInNotificationsEnabledOutput)

SetIdentityHeadersInNotificationsEnabledRequest generates a "aws/request.Request" representing the client's request for the SetIdentityHeadersInNotificationsEnabled operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SetIdentityHeadersInNotificationsEnabled for more information on using the SetIdentityHeadersInNotificationsEnabled API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SetIdentityHeadersInNotificationsEnabledRequest method. req, resp := client.SetIdentityHeadersInNotificationsEnabledRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SetIdentityHeadersInNotificationsEnabled

SetIdentityHeadersInNotificationsEnabledWithContext

func (c *SES) SetIdentityHeadersInNotificationsEnabledWithContext(ctx aws.Context, input *SetIdentityHeadersInNotificationsEnabledInput, opts ...request.Option) (*SetIdentityHeadersInNotificationsEnabledOutput, error)

SetIdentityHeadersInNotificationsEnabledWithContext is the same as SetIdentityHeadersInNotificationsEnabled with the addition of the ability to pass a context and additional request options.

See SetIdentityHeadersInNotificationsEnabled for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

SetIdentityMailFromDomain

func (c *SES) SetIdentityMailFromDomain(input *SetIdentityMailFromDomainInput) (*SetIdentityMailFromDomainOutput, error)

SetIdentityMailFromDomain API operation for Amazon Simple Email Service.

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

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation SetIdentityMailFromDomain for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SetIdentityMailFromDomain

Example

SES SetIdentityMailFromDomain shared00

SetIdentityMailFromDomain

The following example configures Amazon SES to use a custom MAIL FROM domain for an identity:

{ svc := ses.New(session.New()) input := &ses.SetIdentityMailFromDomainInput{ BehaviorOnMXFailure: aws.String("UseDefaultValue"), Identity: aws.String("user@example.com"), MailFromDomain: aws.String("bounces.example.com"), } result, err := svc.SetIdentityMailFromDomain(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

SetIdentityMailFromDomainRequest

func (c *SES) SetIdentityMailFromDomainRequest(input *SetIdentityMailFromDomainInput) (req *request.Request, output *SetIdentityMailFromDomainOutput)

SetIdentityMailFromDomainRequest generates a "aws/request.Request" representing the client's request for the SetIdentityMailFromDomain operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SetIdentityMailFromDomain for more information on using the SetIdentityMailFromDomain API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SetIdentityMailFromDomainRequest method. req, resp := client.SetIdentityMailFromDomainRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SetIdentityMailFromDomain

SetIdentityMailFromDomainWithContext

func (c *SES) SetIdentityMailFromDomainWithContext(ctx aws.Context, input *SetIdentityMailFromDomainInput, opts ...request.Option) (*SetIdentityMailFromDomainOutput, error)

SetIdentityMailFromDomainWithContext is the same as SetIdentityMailFromDomain with the addition of the ability to pass a context and additional request options.

See SetIdentityMailFromDomain for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

SetIdentityNotificationTopic

func (c *SES) SetIdentityNotificationTopic(input *SetIdentityNotificationTopicInput) (*SetIdentityNotificationTopicOutput, error)

SetIdentityNotificationTopic API operation for Amazon Simple Email Service.

Sets an Amazon Simple Notification Service (Amazon SNS) topic to use when delivering notifications. When you use this operation, you specify a verified identity, such as an email address or domain. When you send an email that uses the chosen identity in the Source field, Amazon SES sends notifications to the 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).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation SetIdentityNotificationTopic for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SetIdentityNotificationTopic

Example

SES SetIdentityNotificationTopic shared00

SetIdentityNotificationTopic

The following example sets the Amazon SNS topic to which Amazon SES will publish bounce, complaint, and/or delivery notifications for emails sent with the specified identity as the Source:

{ svc := ses.New(session.New()) input := &ses.SetIdentityNotificationTopicInput{ Identity: aws.String("user@example.com"), NotificationType: aws.String("Bounce"), SnsTopic: aws.String("arn:aws:sns:us-west-2:111122223333:MyTopic"), } result, err := svc.SetIdentityNotificationTopic(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

SetIdentityNotificationTopicRequest

func (c *SES) SetIdentityNotificationTopicRequest(input *SetIdentityNotificationTopicInput) (req *request.Request, output *SetIdentityNotificationTopicOutput)

SetIdentityNotificationTopicRequest generates a "aws/request.Request" representing the client's request for the SetIdentityNotificationTopic operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SetIdentityNotificationTopic for more information on using the SetIdentityNotificationTopic API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SetIdentityNotificationTopicRequest method. req, resp := client.SetIdentityNotificationTopicRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SetIdentityNotificationTopic

SetIdentityNotificationTopicWithContext

func (c *SES) SetIdentityNotificationTopicWithContext(ctx aws.Context, input *SetIdentityNotificationTopicInput, opts ...request.Option) (*SetIdentityNotificationTopicOutput, error)

SetIdentityNotificationTopicWithContext is the same as SetIdentityNotificationTopic with the addition of the ability to pass a context and additional request options.

See SetIdentityNotificationTopic for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

SetReceiptRulePosition

func (c *SES) SetReceiptRulePosition(input *SetReceiptRulePositionInput) (*SetReceiptRulePositionOutput, error)

SetReceiptRulePosition API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation SetReceiptRulePosition for usage and error information.

Returned Error Codes:

  • ErrCodeRuleSetDoesNotExistException "RuleSetDoesNotExist" Indicates that the provided receipt rule set does not exist.

  • ErrCodeRuleDoesNotExistException "RuleDoesNotExist" Indicates that the provided receipt rule does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SetReceiptRulePosition

Example

SES SetReceiptRulePosition shared00

SetReceiptRulePosition

The following example sets the position of a receipt rule in a receipt rule set:

{ svc := ses.New(session.New()) input := &ses.SetReceiptRulePositionInput{ After: aws.String("PutRuleAfterThisRule"), RuleName: aws.String("RuleToReposition"), RuleSetName: aws.String("MyRuleSet"), } result, err := svc.SetReceiptRulePosition(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case ses.ErrCodeRuleSetDoesNotExistException: fmt.Println(ses.ErrCodeRuleSetDoesNotExistException, aerr.Error()) case ses.ErrCodeRuleDoesNotExistException: fmt.Println(ses.ErrCodeRuleDoesNotExistException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

SetReceiptRulePositionRequest

func (c *SES) SetReceiptRulePositionRequest(input *SetReceiptRulePositionInput) (req *request.Request, output *SetReceiptRulePositionOutput)

SetReceiptRulePositionRequest generates a "aws/request.Request" representing the client's request for the SetReceiptRulePosition operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SetReceiptRulePosition for more information on using the SetReceiptRulePosition API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SetReceiptRulePositionRequest method. req, resp := client.SetReceiptRulePositionRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/SetReceiptRulePosition

SetReceiptRulePositionWithContext

func (c *SES) SetReceiptRulePositionWithContext(ctx aws.Context, input *SetReceiptRulePositionInput, opts ...request.Option) (*SetReceiptRulePositionOutput, error)

SetReceiptRulePositionWithContext is the same as SetReceiptRulePosition with the addition of the ability to pass a context and additional request options.

See SetReceiptRulePosition for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

TestRenderTemplate

func (c *SES) TestRenderTemplate(input *TestRenderTemplateInput) (*TestRenderTemplateOutput, error)

TestRenderTemplate API operation for Amazon Simple Email Service.

Creates a preview of the MIME content of an email when provided with a template and a set of replacement data.

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation TestRenderTemplate for usage and error information.

Returned Error Codes:

  • ErrCodeTemplateDoesNotExistException "TemplateDoesNotExist" Indicates that the Template object you specified does not exist in your Amazon SES account.

  • ErrCodeInvalidRenderingParameterException "InvalidRenderingParameter" Indicates that one or more of the replacement values you provided is invalid. This error may occur when the TemplateData object contains invalid JSON.

  • ErrCodeMissingRenderingAttributeException "MissingRenderingAttribute" Indicates that one or more of the replacement values for the specified template was not specified. Ensure that the TemplateData object contains references to all of the replacement tags in the specified template.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/TestRenderTemplate

TestRenderTemplateRequest

func (c *SES) TestRenderTemplateRequest(input *TestRenderTemplateInput) (req *request.Request, output *TestRenderTemplateOutput)

TestRenderTemplateRequest generates a "aws/request.Request" representing the client's request for the TestRenderTemplate operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See TestRenderTemplate for more information on using the TestRenderTemplate API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the TestRenderTemplateRequest method. req, resp := client.TestRenderTemplateRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/TestRenderTemplate

TestRenderTemplateWithContext

func (c *SES) TestRenderTemplateWithContext(ctx aws.Context, input *TestRenderTemplateInput, opts ...request.Option) (*TestRenderTemplateOutput, error)

TestRenderTemplateWithContext is the same as TestRenderTemplate with the addition of the ability to pass a context and additional request options.

See TestRenderTemplate for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

UpdateAccountSendingEnabled

func (c *SES) UpdateAccountSendingEnabled(input *UpdateAccountSendingEnabledInput) (*UpdateAccountSendingEnabledOutput, error)

UpdateAccountSendingEnabled API operation for Amazon Simple Email Service.

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.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation UpdateAccountSendingEnabled for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateAccountSendingEnabled

Example

SES UpdateAccountSendingEnabled shared00

UpdateAccountSendingEnabled

The following example updated the sending status for this account.

{ svc := ses.New(session.New()) input := &ses.UpdateAccountSendingEnabledInput{ Enabled: aws.Bool(true), } result, err := svc.UpdateAccountSendingEnabled(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

UpdateAccountSendingEnabledRequest

func (c *SES) UpdateAccountSendingEnabledRequest(input *UpdateAccountSendingEnabledInput) (req *request.Request, output *UpdateAccountSendingEnabledOutput)

UpdateAccountSendingEnabledRequest generates a "aws/request.Request" representing the client's request for the UpdateAccountSendingEnabled operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateAccountSendingEnabled for more information on using the UpdateAccountSendingEnabled API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UpdateAccountSendingEnabledRequest method. req, resp := client.UpdateAccountSendingEnabledRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateAccountSendingEnabled

UpdateAccountSendingEnabledWithContext

func (c *SES) UpdateAccountSendingEnabledWithContext(ctx aws.Context, input *UpdateAccountSendingEnabledInput, opts ...request.Option) (*UpdateAccountSendingEnabledOutput, error)

UpdateAccountSendingEnabledWithContext is the same as UpdateAccountSendingEnabled with the addition of the ability to pass a context and additional request options.

See UpdateAccountSendingEnabled for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

UpdateConfigurationSetEventDestination

func (c *SES) UpdateConfigurationSetEventDestination(input *UpdateConfigurationSetEventDestinationInput) (*UpdateConfigurationSetEventDestinationOutput, error)

UpdateConfigurationSetEventDestination API operation for Amazon Simple Email Service.

Updates the event destination of a configuration set. 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 Monitoring Your Amazon SES Sending Activity (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/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 Service (Amazon SNS).

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation UpdateConfigurationSetEventDestination for usage and error information.

Returned Error Codes:

  • ErrCodeConfigurationSetDoesNotExistException "ConfigurationSetDoesNotExist" Indicates that the configuration set does not exist.

  • ErrCodeEventDestinationDoesNotExistException "EventDestinationDoesNotExist" Indicates that the event destination does not exist.

  • ErrCodeInvalidCloudWatchDestinationException "InvalidCloudWatchDestination" Indicates that the Amazon CloudWatch destination is invalid. See the error message for details.

  • ErrCodeInvalidFirehoseDestinationException "InvalidFirehoseDestination" Indicates that the Amazon Kinesis Firehose destination is invalid. See the error message for details.

  • ErrCodeInvalidSNSDestinationException "InvalidSNSDestination" Indicates that the Amazon Simple Notification Service (Amazon SNS) destination is invalid. See the error message for details.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateConfigurationSetEventDestination

UpdateConfigurationSetEventDestinationRequest

func (c *SES) UpdateConfigurationSetEventDestinationRequest(input *UpdateConfigurationSetEventDestinationInput) (req *request.Request, output *UpdateConfigurationSetEventDestinationOutput)

UpdateConfigurationSetEventDestinationRequest generates a "aws/request.Request" representing the client's request for the UpdateConfigurationSetEventDestination operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateConfigurationSetEventDestination for more information on using the UpdateConfigurationSetEventDestination API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UpdateConfigurationSetEventDestinationRequest method. req, resp := client.UpdateConfigurationSetEventDestinationRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateConfigurationSetEventDestination

UpdateConfigurationSetEventDestinationWithContext

func (c *SES) UpdateConfigurationSetEventDestinationWithContext(ctx aws.Context, input *UpdateConfigurationSetEventDestinationInput, opts ...request.Option) (*UpdateConfigurationSetEventDestinationOutput, error)

UpdateConfigurationSetEventDestinationWithContext is the same as UpdateConfigurationSetEventDestination with the addition of the ability to pass a context and additional request options.

See UpdateConfigurationSetEventDestination for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

UpdateConfigurationSetReputationMetricsEnabled

func (c *SES) UpdateConfigurationSetReputationMetricsEnabled(input *UpdateConfigurationSetReputationMetricsEnabledInput) (*UpdateConfigurationSetReputationMetricsEnabledOutput, error)

UpdateConfigurationSetReputationMetricsEnabled API operation for Amazon Simple Email Service.

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.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation UpdateConfigurationSetReputationMetricsEnabled for usage and error information.

Returned Error Codes:

  • ErrCodeConfigurationSetDoesNotExistException "ConfigurationSetDoesNotExist" Indicates that the configuration set does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateConfigurationSetReputationMetricsEnabled

Example

SES UpdateConfigurationSetReputationMetricsEnabled shared00

UpdateConfigurationSetReputationMetricsEnabled

Set the reputationMetricsEnabled flag for a specific configuration set.

{ svc := ses.New(session.New()) input := &ses.UpdateConfigurationSetReputationMetricsEnabledInput{ ConfigurationSetName: aws.String("foo"), Enabled: aws.Bool(true), } result, err := svc.UpdateConfigurationSetReputationMetricsEnabled(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case ses.ErrCodeConfigurationSetDoesNotExistException: fmt.Println(ses.ErrCodeConfigurationSetDoesNotExistException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

UpdateConfigurationSetReputationMetricsEnabledRequest

func (c *SES) UpdateConfigurationSetReputationMetricsEnabledRequest(input *UpdateConfigurationSetReputationMetricsEnabledInput) (req *request.Request, output *UpdateConfigurationSetReputationMetricsEnabledOutput)

UpdateConfigurationSetReputationMetricsEnabledRequest generates a "aws/request.Request" representing the client's request for the UpdateConfigurationSetReputationMetricsEnabled operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateConfigurationSetReputationMetricsEnabled for more information on using the UpdateConfigurationSetReputationMetricsEnabled API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UpdateConfigurationSetReputationMetricsEnabledRequest method. req, resp := client.UpdateConfigurationSetReputationMetricsEnabledRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateConfigurationSetReputationMetricsEnabled

UpdateConfigurationSetReputationMetricsEnabledWithContext

func (c *SES) UpdateConfigurationSetReputationMetricsEnabledWithContext(ctx aws.Context, input *UpdateConfigurationSetReputationMetricsEnabledInput, opts ...request.Option) (*UpdateConfigurationSetReputationMetricsEnabledOutput, error)

UpdateConfigurationSetReputationMetricsEnabledWithContext is the same as UpdateConfigurationSetReputationMetricsEnabled with the addition of the ability to pass a context and additional request options.

See UpdateConfigurationSetReputationMetricsEnabled for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

UpdateConfigurationSetSendingEnabled

func (c *SES) UpdateConfigurationSetSendingEnabled(input *UpdateConfigurationSetSendingEnabledInput) (*UpdateConfigurationSetSendingEnabledOutput, error)

UpdateConfigurationSetSendingEnabled API operation for Amazon Simple Email Service.

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.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation UpdateConfigurationSetSendingEnabled for usage and error information.

Returned Error Codes:

  • ErrCodeConfigurationSetDoesNotExistException "ConfigurationSetDoesNotExist" Indicates that the configuration set does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateConfigurationSetSendingEnabled

Example

SES UpdateConfigurationSetSendingEnabled shared00

UpdateConfigurationSetReputationMetricsEnabled

Set the sending enabled flag for a specific configuration set.

{ svc := ses.New(session.New()) input := &ses.UpdateConfigurationSetSendingEnabledInput{ ConfigurationSetName: aws.String("foo"), Enabled: aws.Bool(true), } result, err := svc.UpdateConfigurationSetSendingEnabled(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case ses.ErrCodeConfigurationSetDoesNotExistException: fmt.Println(ses.ErrCodeConfigurationSetDoesNotExistException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

UpdateConfigurationSetSendingEnabledRequest

func (c *SES) UpdateConfigurationSetSendingEnabledRequest(input *UpdateConfigurationSetSendingEnabledInput) (req *request.Request, output *UpdateConfigurationSetSendingEnabledOutput)

UpdateConfigurationSetSendingEnabledRequest generates a "aws/request.Request" representing the client's request for the UpdateConfigurationSetSendingEnabled operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateConfigurationSetSendingEnabled for more information on using the UpdateConfigurationSetSendingEnabled API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UpdateConfigurationSetSendingEnabledRequest method. req, resp := client.UpdateConfigurationSetSendingEnabledRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateConfigurationSetSendingEnabled

UpdateConfigurationSetSendingEnabledWithContext

func (c *SES) UpdateConfigurationSetSendingEnabledWithContext(ctx aws.Context, input *UpdateConfigurationSetSendingEnabledInput, opts ...request.Option) (*UpdateConfigurationSetSendingEnabledOutput, error)

UpdateConfigurationSetSendingEnabledWithContext is the same as UpdateConfigurationSetSendingEnabled with the addition of the ability to pass a context and additional request options.

See UpdateConfigurationSetSendingEnabled for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

UpdateConfigurationSetTrackingOptions

func (c *SES) UpdateConfigurationSetTrackingOptions(input *UpdateConfigurationSetTrackingOptionsInput) (*UpdateConfigurationSetTrackingOptionsOutput, error)

UpdateConfigurationSetTrackingOptions API operation for Amazon Simple Email Service.

Modifies an association between a configuration set and a custom domain for 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).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation UpdateConfigurationSetTrackingOptions for usage and error information.

Returned Error Codes:

  • ErrCodeConfigurationSetDoesNotExistException "ConfigurationSetDoesNotExist" Indicates that the configuration set does not exist.

  • ErrCodeTrackingOptionsDoesNotExistException "TrackingOptionsDoesNotExistException" Indicates that the TrackingOptions object you specified does not exist.

  • ErrCodeInvalidTrackingOptionsException "InvalidTrackingOptions" Indicates that the custom domain to be used for open and click tracking redirects is invalid. This error appears most often in the following situations:

  • When the tracking domain you specified is not verified in Amazon SES.

  • When the tracking domain you specified is not a valid domain or subdomain.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateConfigurationSetTrackingOptions

UpdateConfigurationSetTrackingOptionsRequest

func (c *SES) UpdateConfigurationSetTrackingOptionsRequest(input *UpdateConfigurationSetTrackingOptionsInput) (req *request.Request, output *UpdateConfigurationSetTrackingOptionsOutput)

UpdateConfigurationSetTrackingOptionsRequest generates a "aws/request.Request" representing the client's request for the UpdateConfigurationSetTrackingOptions operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateConfigurationSetTrackingOptions for more information on using the UpdateConfigurationSetTrackingOptions API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UpdateConfigurationSetTrackingOptionsRequest method. req, resp := client.UpdateConfigurationSetTrackingOptionsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateConfigurationSetTrackingOptions

UpdateConfigurationSetTrackingOptionsWithContext

func (c *SES) UpdateConfigurationSetTrackingOptionsWithContext(ctx aws.Context, input *UpdateConfigurationSetTrackingOptionsInput, opts ...request.Option) (*UpdateConfigurationSetTrackingOptionsOutput, error)

UpdateConfigurationSetTrackingOptionsWithContext is the same as UpdateConfigurationSetTrackingOptions with the addition of the ability to pass a context and additional request options.

See UpdateConfigurationSetTrackingOptions for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

UpdateCustomVerificationEmailTemplate

func (c *SES) UpdateCustomVerificationEmailTemplate(input *UpdateCustomVerificationEmailTemplateInput) (*UpdateCustomVerificationEmailTemplateOutput, error)

UpdateCustomVerificationEmailTemplate API operation for Amazon Simple Email Service.

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) in the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation UpdateCustomVerificationEmailTemplate for usage and error information.

Returned Error Codes:

  • ErrCodeCustomVerificationEmailTemplateDoesNotExistException "CustomVerificationEmailTemplateDoesNotExist" Indicates that a custom verification email template with the name you specified does not exist.

  • ErrCodeFromEmailAddressNotVerifiedException "FromEmailAddressNotVerified" Indicates that the sender address specified for a custom verification email is not verified, and is therefore not eligible to send the custom verification email.

  • ErrCodeCustomVerificationEmailInvalidContentException "CustomVerificationEmailInvalidContent" Indicates that custom verification email template provided content is invalid.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateCustomVerificationEmailTemplate

UpdateCustomVerificationEmailTemplateRequest

func (c *SES) UpdateCustomVerificationEmailTemplateRequest(input *UpdateCustomVerificationEmailTemplateInput) (req *request.Request, output *UpdateCustomVerificationEmailTemplateOutput)

UpdateCustomVerificationEmailTemplateRequest generates a "aws/request.Request" representing the client's request for the UpdateCustomVerificationEmailTemplate operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateCustomVerificationEmailTemplate for more information on using the UpdateCustomVerificationEmailTemplate API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UpdateCustomVerificationEmailTemplateRequest method. req, resp := client.UpdateCustomVerificationEmailTemplateRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateCustomVerificationEmailTemplate

UpdateCustomVerificationEmailTemplateWithContext

func (c *SES) UpdateCustomVerificationEmailTemplateWithContext(ctx aws.Context, input *UpdateCustomVerificationEmailTemplateInput, opts ...request.Option) (*UpdateCustomVerificationEmailTemplateOutput, error)

UpdateCustomVerificationEmailTemplateWithContext is the same as UpdateCustomVerificationEmailTemplate with the addition of the ability to pass a context and additional request options.

See UpdateCustomVerificationEmailTemplate for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

UpdateReceiptRule

func (c *SES) UpdateReceiptRule(input *UpdateReceiptRuleInput) (*UpdateReceiptRuleOutput, error)

UpdateReceiptRule API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation UpdateReceiptRule for usage and error information.

Returned Error Codes:

  • ErrCodeRuleSetDoesNotExistException "RuleSetDoesNotExist" Indicates that the provided receipt rule set does not exist.

  • ErrCodeRuleDoesNotExistException "RuleDoesNotExist" Indicates that the provided receipt rule does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateReceiptRule

Example

SES UpdateReceiptRule shared00

UpdateReceiptRule

The following example updates a receipt rule to use an Amazon S3 action:

{ svc := ses.New(session.New()) input := &ses.UpdateReceiptRuleInput{ Rule: &ses.ReceiptRule{ Actions: []*ses.ReceiptAction{ { S3Action: &ses.S3Action{ BucketName: aws.String("MyBucket"), ObjectKeyPrefix: aws.String("email"), }, }, }, Enabled: aws.Bool(true), Name: aws.String("MyRule"), ScanEnabled: aws.Bool(true), TlsPolicy: aws.String("Optional"), }, RuleSetName: aws.String("MyRuleSet"), } result, err := svc.UpdateReceiptRule(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { case ses.ErrCodeInvalidSnsTopicException: fmt.Println(ses.ErrCodeInvalidSnsTopicException, aerr.Error()) case ses.ErrCodeInvalidS3ConfigurationException: fmt.Println(ses.ErrCodeInvalidS3ConfigurationException, aerr.Error()) case ses.ErrCodeInvalidLambdaFunctionException: fmt.Println(ses.ErrCodeInvalidLambdaFunctionException, aerr.Error()) case ses.ErrCodeRuleSetDoesNotExistException: fmt.Println(ses.ErrCodeRuleSetDoesNotExistException, aerr.Error()) case ses.ErrCodeRuleDoesNotExistException: fmt.Println(ses.ErrCodeRuleDoesNotExistException, aerr.Error()) case ses.ErrCodeLimitExceededException: fmt.Println(ses.ErrCodeLimitExceededException, aerr.Error()) default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

UpdateReceiptRuleRequest

func (c *SES) UpdateReceiptRuleRequest(input *UpdateReceiptRuleInput) (req *request.Request, output *UpdateReceiptRuleOutput)

UpdateReceiptRuleRequest generates a "aws/request.Request" representing the client's request for the UpdateReceiptRule operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateReceiptRule for more information on using the UpdateReceiptRule API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UpdateReceiptRuleRequest method. req, resp := client.UpdateReceiptRuleRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateReceiptRule

UpdateReceiptRuleWithContext

func (c *SES) UpdateReceiptRuleWithContext(ctx aws.Context, input *UpdateReceiptRuleInput, opts ...request.Option) (*UpdateReceiptRuleOutput, error)

UpdateReceiptRuleWithContext is the same as UpdateReceiptRule with the addition of the ability to pass a context and additional request options.

See UpdateReceiptRule for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

UpdateTemplate

func (c *SES) UpdateTemplate(input *UpdateTemplateInput) (*UpdateTemplateOutput, error)

UpdateTemplate API operation for Amazon Simple Email Service.

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

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation UpdateTemplate for usage and error information.

Returned Error Codes:

  • ErrCodeTemplateDoesNotExistException "TemplateDoesNotExist" Indicates that the Template object you specified does not exist in your Amazon SES account.

  • ErrCodeInvalidTemplateException "InvalidTemplate" Indicates that the template that you specified could not be rendered. This issue may occur when a template refers to a partial that does not exist.

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateTemplate

UpdateTemplateRequest

func (c *SES) UpdateTemplateRequest(input *UpdateTemplateInput) (req *request.Request, output *UpdateTemplateOutput)

UpdateTemplateRequest generates a "aws/request.Request" representing the client's request for the UpdateTemplate operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateTemplate for more information on using the UpdateTemplate API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UpdateTemplateRequest method. req, resp := client.UpdateTemplateRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/UpdateTemplate

UpdateTemplateWithContext

func (c *SES) UpdateTemplateWithContext(ctx aws.Context, input *UpdateTemplateInput, opts ...request.Option) (*UpdateTemplateOutput, error)

UpdateTemplateWithContext is the same as UpdateTemplate with the addition of the ability to pass a context and additional request options.

See UpdateTemplate for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

VerifyDomainDkim

func (c *SES) VerifyDomainDkim(input *VerifyDomainDkimInput) (*VerifyDomainDkimOutput, error)

VerifyDomainDkim API operation for Amazon Simple Email Service.

Returns a set of DKIM tokens for a domain. DKIM tokens are character strings that represent your domain's identity. Using these tokens, you will need to create DNS CNAME records that point to DKIM public keys hosted by Amazon SES. Amazon Web Services will eventually detect that you have updated your DNS records; this detection process may take up to 72 hours. Upon successful detection, Amazon SES will be able to DKIM-sign email originating from that domain.

You can execute this operation no more than once per second.

To enable or disable Easy DKIM signing for a domain, use the SetIdentityDkimEnabled operation.

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

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation VerifyDomainDkim for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/VerifyDomainDkim

Example

SES VerifyDomainDkim shared00

VerifyDomainDkim

The following example generates DKIM tokens for a domain that has been verified with Amazon SES:

{ svc := ses.New(session.New()) input := &ses.VerifyDomainDkimInput{ Domain: aws.String("example.com"), } result, err := svc.VerifyDomainDkim(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

VerifyDomainDkimRequest

func (c *SES) VerifyDomainDkimRequest(input *VerifyDomainDkimInput) (req *request.Request, output *VerifyDomainDkimOutput)

VerifyDomainDkimRequest generates a "aws/request.Request" representing the client's request for the VerifyDomainDkim operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See VerifyDomainDkim for more information on using the VerifyDomainDkim API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the VerifyDomainDkimRequest method. req, resp := client.VerifyDomainDkimRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/VerifyDomainDkim

VerifyDomainDkimWithContext

func (c *SES) VerifyDomainDkimWithContext(ctx aws.Context, input *VerifyDomainDkimInput, opts ...request.Option) (*VerifyDomainDkimOutput, error)

VerifyDomainDkimWithContext is the same as VerifyDomainDkim with the addition of the ability to pass a context and additional request options.

See VerifyDomainDkim for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

VerifyDomainIdentity

func (c *SES) VerifyDomainIdentity(input *VerifyDomainIdentityInput) (*VerifyDomainIdentityOutput, error)

VerifyDomainIdentity API operation for Amazon Simple Email Service.

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) in the Amazon SES Developer Guide.

You can execute this operation no more than once per second.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation VerifyDomainIdentity for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/VerifyDomainIdentity

Example

SES VerifyDomainIdentity shared00

VerifyDomainIdentity

The following example starts the domain verification process with Amazon SES:

{ svc := ses.New(session.New()) input := &ses.VerifyDomainIdentityInput{ Domain: aws.String("example.com"), } result, err := svc.VerifyDomainIdentity(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

VerifyDomainIdentityRequest

func (c *SES) VerifyDomainIdentityRequest(input *VerifyDomainIdentityInput) (req *request.Request, output *VerifyDomainIdentityOutput)

VerifyDomainIdentityRequest generates a "aws/request.Request" representing the client's request for the VerifyDomainIdentity operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See VerifyDomainIdentity for more information on using the VerifyDomainIdentity API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the VerifyDomainIdentityRequest method. req, resp := client.VerifyDomainIdentityRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/VerifyDomainIdentity

VerifyDomainIdentityWithContext

func (c *SES) VerifyDomainIdentityWithContext(ctx aws.Context, input *VerifyDomainIdentityInput, opts ...request.Option) (*VerifyDomainIdentityOutput, error)

VerifyDomainIdentityWithContext is the same as VerifyDomainIdentity with the addition of the ability to pass a context and additional request options.

See VerifyDomainIdentity for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

VerifyEmailAddress

func (c *SES) VerifyEmailAddress(input *VerifyEmailAddressInput) (*VerifyEmailAddressOutput, error)

VerifyEmailAddress API operation for Amazon Simple Email Service.

Deprecated. Use the VerifyEmailIdentity operation to verify a new email address.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation VerifyEmailAddress for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/VerifyEmailAddress

Example

SES VerifyEmailAddress shared00

VerifyEmailAddress

The following example starts the email address verification process with Amazon SES:

{ svc := ses.New(session.New()) input := &ses.VerifyEmailAddressInput{ EmailAddress: aws.String("user@example.com"), } result, err := svc.VerifyEmailAddress(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

VerifyEmailAddressRequest

func (c *SES) VerifyEmailAddressRequest(input *VerifyEmailAddressInput) (req *request.Request, output *VerifyEmailAddressOutput)

VerifyEmailAddressRequest generates a "aws/request.Request" representing the client's request for the VerifyEmailAddress operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See VerifyEmailAddress for more information on using the VerifyEmailAddress API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the VerifyEmailAddressRequest method. req, resp := client.VerifyEmailAddressRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/VerifyEmailAddress

VerifyEmailAddressWithContext

func (c *SES) VerifyEmailAddressWithContext(ctx aws.Context, input *VerifyEmailAddressInput, opts ...request.Option) (*VerifyEmailAddressOutput, error)

VerifyEmailAddressWithContext is the same as VerifyEmailAddress with the addition of the ability to pass a context and additional request options.

See VerifyEmailAddress for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

VerifyEmailIdentity

func (c *SES) VerifyEmailIdentity(input *VerifyEmailIdentityInput) (*VerifyEmailIdentityOutput, error)

VerifyEmailIdentity API operation for Amazon Simple Email Service.

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.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon Simple Email Service's API operation VerifyEmailIdentity for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/VerifyEmailIdentity

Example

SES VerifyEmailIdentity shared00

VerifyEmailIdentity

The following example starts the email address verification process with Amazon SES:

{ svc := ses.New(session.New()) input := &ses.VerifyEmailIdentityInput{ EmailAddress: aws.String("user@example.com"), } result, err := svc.VerifyEmailIdentity(input) if err != nil { if aerr, ok := err.(awserr.Error); ok { switch aerr.Code() { default: fmt.Println(aerr.Error()) } } else { fmt.Println(err.Error()) } return } fmt.Println(result) }

VerifyEmailIdentityRequest

func (c *SES) VerifyEmailIdentityRequest(input *VerifyEmailIdentityInput) (req *request.Request, output *VerifyEmailIdentityOutput)

VerifyEmailIdentityRequest generates a "aws/request.Request" representing the client's request for the VerifyEmailIdentity operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See VerifyEmailIdentity for more information on using the VerifyEmailIdentity API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the VerifyEmailIdentityRequest method. req, resp := client.VerifyEmailIdentityRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/VerifyEmailIdentity

VerifyEmailIdentityWithContext

func (c *SES) VerifyEmailIdentityWithContext(ctx aws.Context, input *VerifyEmailIdentityInput, opts ...request.Option) (*VerifyEmailIdentityOutput, error)

VerifyEmailIdentityWithContext is the same as VerifyEmailIdentity with the addition of the ability to pass a context and additional request options.

See VerifyEmailIdentity for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

WaitUntilIdentityExists

func (c *SES) WaitUntilIdentityExists(input *GetIdentityVerificationAttributesInput) error

WaitUntilIdentityExists uses the Amazon SES API operation GetIdentityVerificationAttributes to wait for a condition to be met before returning. If the condition is not met within the max attempt window, an error will be returned.

WaitUntilIdentityExistsWithContext

func (c *SES) WaitUntilIdentityExistsWithContext(ctx aws.Context, input *GetIdentityVerificationAttributesInput, opts ...request.WaiterOption) error

WaitUntilIdentityExistsWithContext is an extended version of WaitUntilIdentityExists. With the support for passing in a context and options to configure the Waiter and the underlying request options.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

On this page: