Class: Aws::SESV2::Client

Inherits:
Seahorse::Client::Base show all
Includes:
ClientStubs
Defined in:
gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb

Overview

An API client for SESV2. To construct a client, you need to configure a :region and :credentials.

client = Aws::SESV2::Client.new(
  region: region_name,
  credentials: credentials,
  # ...
)

For details on configuring region and credentials see the developer guide.

See #initialize for a full list of supported configuration options.

Instance Attribute Summary

Attributes inherited from Seahorse::Client::Base

#config, #handlers

API Operations collapse

Instance Method Summary collapse

Methods included from ClientStubs

#api_requests, #stub_data, #stub_responses

Methods inherited from Seahorse::Client::Base

add_plugin, api, clear_plugins, define, new, #operation_names, plugins, remove_plugin, set_api, set_plugins

Methods included from Seahorse::Client::HandlerBuilder

#handle, #handle_request, #handle_response

Constructor Details

#initialize(options) ⇒ Client

Returns a new instance of Client.

Parameters:

  • options (Hash)

Options Hash (options):

  • :credentials (required, Aws::CredentialProvider)

    Your AWS credentials. This can be an instance of any one of the following classes:

    • Aws::Credentials - Used for configuring static, non-refreshing credentials.

    • Aws::SharedCredentials - Used for loading static credentials from a shared file, such as ~/.aws/config.

    • Aws::AssumeRoleCredentials - Used when you need to assume a role.

    • Aws::AssumeRoleWebIdentityCredentials - Used when you need to assume a role after providing credentials via the web.

    • Aws::SSOCredentials - Used for loading credentials from AWS SSO using an access token generated from aws login.

    • Aws::ProcessCredentials - Used for loading credentials from a process that outputs to stdout.

    • Aws::InstanceProfileCredentials - Used for loading credentials from an EC2 IMDS on an EC2 instance.

    • Aws::ECSCredentials - Used for loading credentials from instances running in ECS.

    • Aws::CognitoIdentityCredentials - Used for loading credentials from the Cognito Identity service.

    When :credentials are not configured directly, the following locations will be searched for credentials:

    • Aws.config[:credentials]
    • The :access_key_id, :secret_access_key, and :session_token options.
    • ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
    • ~/.aws/credentials
    • ~/.aws/config
    • EC2/ECS IMDS instance profile - When used by default, the timeouts are very aggressive. Construct and pass an instance of Aws::InstanceProfileCredentails or Aws::ECSCredentials to enable retries and extended timeouts.
  • :region (required, String)

    The AWS region to connect to. The configured :region is used to determine the service :endpoint. When not passed, a default :region is searched for in the following locations:

    • Aws.config[:region]
    • ENV['AWS_REGION']
    • ENV['AMAZON_REGION']
    • ENV['AWS_DEFAULT_REGION']
    • ~/.aws/credentials
    • ~/.aws/config
  • :access_key_id (String)
  • :active_endpoint_cache (Boolean) — default: false

    When set to true, a thread polling for endpoints will be running in the background every 60 secs (default). Defaults to false.

  • :adaptive_retry_wait_to_fill (Boolean) — default: true

    Used only in adaptive retry mode. When true, the request will sleep until there is sufficent client side capacity to retry the request. When false, the request will raise a RetryCapacityNotAvailableError and will not retry instead of sleeping.

  • :client_side_monitoring (Boolean) — default: false

    When true, client-side metrics will be collected for all API requests from this client.

  • :client_side_monitoring_client_id (String) — default: ""

    Allows you to provide an identifier for this client which will be attached to all generated client side metrics. Defaults to an empty string.

  • :client_side_monitoring_host (String) — default: "127.0.0.1"

    Allows you to specify the DNS hostname or IPv4 or IPv6 address that the client side monitoring agent is running on, where client metrics will be published via UDP.

  • :client_side_monitoring_port (Integer) — default: 31000

    Required for publishing client metrics. The port that the client side monitoring agent is running on, where client metrics will be published via UDP.

  • :client_side_monitoring_publisher (Aws::ClientSideMonitoring::Publisher) — default: Aws::ClientSideMonitoring::Publisher

    Allows you to provide a custom client-side monitoring publisher class. By default, will use the Client Side Monitoring Agent Publisher.

  • :convert_params (Boolean) — default: true

    When true, an attempt is made to coerce request parameters into the required types.

  • :correct_clock_skew (Boolean) — default: true

    Used only in standard and adaptive retry modes. Specifies whether to apply a clock skew correction and retry requests with skewed client clocks.

  • :disable_host_prefix_injection (Boolean) — default: false

    Set to true to disable SDK automatically adding host prefix to default service endpoint when available.

  • :endpoint (String)

    The client endpoint is normally constructed from the :region option. You should only configure an :endpoint when connecting to test or custom endpoints. This should be a valid HTTP(S) URI.

  • :endpoint_cache_max_entries (Integer) — default: 1000

    Used for the maximum size limit of the LRU cache storing endpoints data for endpoint discovery enabled operations. Defaults to 1000.

  • :endpoint_cache_max_threads (Integer) — default: 10

    Used for the maximum threads in use for polling endpoints to be cached, defaults to 10.

  • :endpoint_cache_poll_interval (Integer) — default: 60

    When :endpoint_discovery and :active_endpoint_cache is enabled, Use this option to config the time interval in seconds for making requests fetching endpoints information. Defaults to 60 sec.

  • :endpoint_discovery (Boolean) — default: false

    When set to true, endpoint discovery will be enabled for operations when available.

  • :log_formatter (Aws::Log::Formatter) — default: Aws::Log::Formatter.default

    The log formatter.

  • :log_level (Symbol) — default: :info

    The log level to send messages to the :logger at.

  • :logger (Logger)

    The Logger instance to send log messages to. If this option is not set, logging will be disabled.

  • :max_attempts (Integer) — default: 3

    An integer representing the maximum number attempts that will be made for a single request, including the initial attempt. For example, setting this value to 5 will result in a request being retried up to 4 times. Used in standard and adaptive retry modes.

  • :profile (String) — default: "default"

    Used when loading credentials from the shared credentials file at HOME/.aws/credentials. When not specified, 'default' is used.

  • :retry_backoff (Proc)

    A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay. This option is only used in the legacy retry mode.

  • :retry_base_delay (Float) — default: 0.3

    The base delay in seconds used by the default backoff function. This option is only used in the legacy retry mode.

  • :retry_jitter (Symbol) — default: :none

    A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number. This option is only used in the legacy retry mode.

    @see https://www.awsarchitectureblog.com/2015/03/backoff.html

  • :retry_limit (Integer) — default: 3

    The maximum number of times to retry failed requests. Only ~ 500 level server errors and certain ~ 400 level client errors are retried. Generally, these are throttling errors, data checksum errors, networking errors, timeout errors, auth errors, endpoint discovery, and errors from expired credentials. This option is only used in the legacy retry mode.

  • :retry_max_delay (Integer) — default: 0

    The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function. This option is only used in the legacy retry mode.

  • :retry_mode (String) — default: "legacy"

    Specifies which retry algorithm to use. Values are:

    • legacy - The pre-existing retry behavior. This is default value if no retry mode is provided.

    • standard - A standardized set of retry rules across the AWS SDKs. This includes support for retry quotas, which limit the number of unsuccessful retries a client can make.

    • adaptive - An experimental retry mode that includes all the functionality of standard mode along with automatic client side throttling. This is a provisional mode that may change behavior in the future.

  • :secret_access_key (String)
  • :session_token (String)
  • :stub_responses (Boolean) — default: false

    Causes the client to return stubbed responses. By default fake responses are generated and returned. You can specify the response data to return or errors to raise by calling ClientStubs#stub_responses. See ClientStubs for more information.

    Please note When response stubbing is enabled, no HTTP requests are made, and retries are disabled.

  • :validate_params (Boolean) — default: true

    When true, request parameters are validated before sending the request.

  • :http_proxy (URI::HTTP, String)

    A proxy to send requests through. Formatted like 'http://proxy.com:123'.

  • :http_open_timeout (Float) — default: 15

    The number of seconds to wait when opening a HTTP session before raising a Timeout::Error.

  • :http_read_timeout (Integer) — default: 60

    The default number of seconds to wait for response data. This value can safely be set per-request on the session.

  • :http_idle_timeout (Float) — default: 5

    The number of seconds a connection is allowed to sit idle before it is considered stale. Stale connections are closed and removed from the pool before making a request.

  • :http_continue_timeout (Float) — default: 1

    The number of seconds to wait for a 100-continue response before sending the request body. This option has no effect unless the request has "Expect" header set to "100-continue". Defaults to nil which disables this behaviour. This value can safely be set per request on the session.

  • :http_wire_trace (Boolean) — default: false

    When true, HTTP debug output will be sent to the :logger.

  • :ssl_verify_peer (Boolean) — default: true

    When true, SSL peer certificates are verified when establishing a connection.

  • :ssl_ca_bundle (String)

    Full path to the SSL certificate authority bundle file that should be used when verifying peer certificates. If you do not pass :ssl_ca_bundle or :ssl_ca_directory the the system default will be used if available.

  • :ssl_ca_directory (String)

    Full path of the directory that contains the unbundled SSL certificate authority files for verifying peer certificates. If you do not pass :ssl_ca_bundle or :ssl_ca_directory the the system default will be used if available.



324
325
326
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 324

def initialize(*args)
  super
end

Instance Method Details

#create_configuration_set(params = {}) ⇒ Struct

Create a configuration set. Configuration sets are groups of rules that you can apply to the emails that you send. You apply a configuration set to an email by specifying the name of the configuration set when you call the Amazon SES API v2. When you apply a configuration set to an email, all of the rules in that configuration set are applied to the email.

Examples:

Request syntax with placeholder values


resp = client.create_configuration_set({
  configuration_set_name: "ConfigurationSetName", # required
  tracking_options: {
    custom_redirect_domain: "CustomRedirectDomain", # required
  },
  delivery_options: {
    tls_policy: "REQUIRE", # accepts REQUIRE, OPTIONAL
    sending_pool_name: "PoolName",
  },
  reputation_options: {
    reputation_metrics_enabled: false,
    last_fresh_start: Time.now,
  },
  sending_options: {
    sending_enabled: false,
  },
  tags: [
    {
      key: "TagKey", # required
      value: "TagValue", # required
    },
  ],
  suppression_options: {
    suppressed_reasons: ["BOUNCE"], # accepts BOUNCE, COMPLAINT
  },
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    The name of the configuration set.

  • :tracking_options (Types::TrackingOptions)

    An object that defines the open and click tracking options for emails that you send using the configuration set.

  • :delivery_options (Types::DeliveryOptions)

    An object that defines the dedicated IP pool that is used to send emails that you send using the configuration set.

  • :reputation_options (Types::ReputationOptions)

    An object that defines whether or not Amazon SES collects reputation metrics for the emails that you send that use the configuration set.

  • :sending_options (Types::SendingOptions)

    An object that defines whether or not Amazon SES can send email that you send using the configuration set.

  • :tags (Array<Types::Tag>)

    An array of objects that define the tags (keys and values) that you want to associate with the configuration set.

  • :suppression_options (Types::SuppressionOptions)

    An object that contains information about the suppression list preferences for your account.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



399
400
401
402
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 399

def create_configuration_set(params = {}, options = {})
  req = build_request(:create_configuration_set, params)
  req.send_request(options)
end

#create_configuration_set_event_destination(params = {}) ⇒ Struct

Create an event destination. Events include message sends, deliveries, opens, clicks, bounces, and complaints. Event destinations are places that you can send information about these events to. For example, you can send event data to Amazon SNS to receive notifications when you receive bounces or complaints, or you can use Amazon Kinesis Data Firehose to stream data to Amazon S3 for long-term storage.

A single configuration set can include more than one event destination.

Examples:

Request syntax with placeholder values


resp = client.create_configuration_set_event_destination({
  configuration_set_name: "ConfigurationSetName", # required
  event_destination_name: "EventDestinationName", # required
  event_destination: { # required
    enabled: false,
    matching_event_types: ["SEND"], # accepts SEND, REJECT, BOUNCE, COMPLAINT, DELIVERY, OPEN, CLICK, RENDERING_FAILURE, DELIVERY_DELAY
    kinesis_firehose_destination: {
      iam_role_arn: "AmazonResourceName", # required
      delivery_stream_arn: "AmazonResourceName", # required
    },
    cloud_watch_destination: {
      dimension_configurations: [ # required
        {
          dimension_name: "DimensionName", # required
          dimension_value_source: "MESSAGE_TAG", # required, accepts MESSAGE_TAG, EMAIL_HEADER, LINK_TAG
          default_dimension_value: "DefaultDimensionValue", # required
        },
      ],
    },
    sns_destination: {
      topic_arn: "AmazonResourceName", # required
    },
    pinpoint_destination: {
      application_arn: "AmazonResourceName",
    },
  },
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    The name of the configuration set that you want to add an event destination to.

  • :event_destination_name (required, String)

    A name that identifies the event destination within the configuration set.

  • :event_destination (required, Types::EventDestinationDefinition)

    An object that defines the event destination.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



462
463
464
465
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 462

def create_configuration_set_event_destination(params = {}, options = {})
  req = build_request(:create_configuration_set_event_destination, params)
  req.send_request(options)
end

#create_custom_verification_email_template(params = {}) ⇒ Struct

Creates a new custom verification email template.

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer Guide.

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

Examples:

Request syntax with placeholder values


resp = client.create_custom_verification_email_template({
  template_name: "EmailTemplateName", # required
  from_email_address: "EmailAddress", # required
  template_subject: "EmailTemplateSubject", # required
  template_content: "TemplateContent", # required
  success_redirection_url: "SuccessRedirectionURL", # required
  failure_redirection_url: "FailureRedirectionURL", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :template_name (required, String)

    The name of the custom verification email template.

  • :from_email_address (required, String)

    The email address that the custom verification email is sent from.

  • :template_subject (required, String)

    The subject line of the custom verification email.

  • :template_content (required, String)

    The content of the custom verification email. The total size of the email must be less than 10 MB. The message body may contain HTML, with some limitations. For more information, see Custom Verification Email Frequently Asked Questions in the Amazon SES Developer Guide.

  • :success_redirection_url (required, String)

    The URL that the recipient of the verification email is sent to if his or her address is successfully verified.

  • :failure_redirection_url (required, String)

    The URL that the recipient of the verification email is sent to if his or her address is not successfully verified.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



523
524
525
526
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 523

def create_custom_verification_email_template(params = {}, options = {})
  req = build_request(:create_custom_verification_email_template, params)
  req.send_request(options)
end

#create_dedicated_ip_pool(params = {}) ⇒ Struct

Create a new pool of dedicated IP addresses. A pool can include one or more dedicated IP addresses that are associated with your AWS account. You can associate a pool with a configuration set. When you send an email that uses that configuration set, the message is sent from one of the addresses in the associated pool.

Examples:

Request syntax with placeholder values


resp = client.create_dedicated_ip_pool({
  pool_name: "PoolName", # required
  tags: [
    {
      key: "TagKey", # required
      value: "TagValue", # required
    },
  ],
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :pool_name (required, String)

    The name of the dedicated IP pool.

  • :tags (Array<Types::Tag>)

    An object that defines the tags (keys and values) that you want to associate with the pool.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



559
560
561
562
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 559

def create_dedicated_ip_pool(params = {}, options = {})
  req = build_request(:create_dedicated_ip_pool, params)
  req.send_request(options)
end

#create_deliverability_test_report(params = {}) ⇒ Types::CreateDeliverabilityTestReportResponse

Create a new predictive inbox placement test. Predictive inbox placement tests can help you predict how your messages will be handled by various email providers around the world. When you perform a predictive inbox placement test, you provide a sample message that contains the content that you plan to send to your customers. Amazon SES then sends that message to special email addresses spread across several major email providers. After about 24 hours, the test is complete, and you can use the GetDeliverabilityTestReport operation to view the results of the test.

Examples:

Request syntax with placeholder values


resp = client.create_deliverability_test_report({
  report_name: "ReportName",
  from_email_address: "EmailAddress", # required
  content: { # required
    simple: {
      subject: { # required
        data: "MessageData", # required
        charset: "Charset",
      },
      body: { # required
        text: {
          data: "MessageData", # required
          charset: "Charset",
        },
        html: {
          data: "MessageData", # required
          charset: "Charset",
        },
      },
    },
    raw: {
      data: "data", # required
    },
    template: {
      template_name: "EmailTemplateName",
      template_arn: "AmazonResourceName",
      template_data: "EmailTemplateData",
    },
  },
  tags: [
    {
      key: "TagKey", # required
      value: "TagValue", # required
    },
  ],
})

Response structure


resp.report_id #=> String
resp.deliverability_test_status #=> String, one of "IN_PROGRESS", "COMPLETED"

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :report_name (String)

    A unique name that helps you to identify the predictive inbox placement test when you retrieve the results.

  • :from_email_address (required, String)

    The email address that the predictive inbox placement test email was sent from.

  • :content (required, Types::EmailContent)

    The HTML body of the message that you sent when you performed the predictive inbox placement test.

  • :tags (Array<Types::Tag>)

    An array of objects that define the tags (keys and values) that you want to associate with the predictive inbox placement test.

Returns:

See Also:



643
644
645
646
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 643

def create_deliverability_test_report(params = {}, options = {})
  req = build_request(:create_deliverability_test_report, params)
  req.send_request(options)
end

#create_email_identity(params = {}) ⇒ Types::CreateEmailIdentityResponse

Starts the process of verifying an email identity. An identity is an email address or domain that you use when you send email. Before you can use an identity to send email, you first have to verify it. By verifying an identity, you demonstrate that you're the owner of the identity, and that you've given Amazon SES API v2 permission to send email from the identity.

When you verify an email address, Amazon SES sends an email to the address. Your email address is verified as soon as you follow the link in the verification email.

When you verify a domain without specifying the DkimSigningAttributes object, this operation provides a set of DKIM tokens. You can convert these tokens into CNAME records, which you then add to the DNS configuration for your domain. Your domain is verified when Amazon SES detects these records in the DNS configuration for your domain. This verification method is known as Easy DKIM.

Alternatively, you can perform the verification process by providing your own public-private key pair. This verification method is known as Bring Your Own DKIM (BYODKIM). To use BYODKIM, your call to the CreateEmailIdentity operation has to include the DkimSigningAttributes object. When you specify this object, you provide a selector (a component of the DNS record name that identifies the public key that you want to use for DKIM authentication) and a private key.

Examples:

Request syntax with placeholder values


resp = client.create_email_identity({
  email_identity: "Identity", # required
  tags: [
    {
      key: "TagKey", # required
      value: "TagValue", # required
    },
  ],
  dkim_signing_attributes: {
    domain_signing_selector: "Selector", # required
    domain_signing_private_key: "PrivateKey", # required
  },
})

Response structure


resp.identity_type #=> String, one of "EMAIL_ADDRESS", "DOMAIN", "MANAGED_DOMAIN"
resp.verified_for_sending_status #=> Boolean
resp.dkim_attributes.signing_enabled #=> Boolean
resp.dkim_attributes.status #=> String, one of "PENDING", "SUCCESS", "FAILED", "TEMPORARY_FAILURE", "NOT_STARTED"
resp.dkim_attributes.tokens #=> Array
resp.dkim_attributes.tokens[0] #=> String
resp.dkim_attributes.signing_attributes_origin #=> String, one of "AWS_SES", "EXTERNAL"

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :email_identity (required, String)

    The email address or domain that you want to verify.

  • :tags (Array<Types::Tag>)

    An array of objects that define the tags (keys and values) that you want to associate with the email identity.

  • :dkim_signing_attributes (Types::DkimSigningAttributes)

    If your request includes this object, Amazon SES configures the identity to use Bring Your Own DKIM (BYODKIM) for DKIM authentication purposes, as opposed to the default method, Easy DKIM.

    You can only specify this object if the email identity is a domain, as opposed to an address.

Returns:

See Also:



735
736
737
738
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 735

def create_email_identity(params = {}, options = {})
  req = build_request(:create_email_identity, params)
  req.send_request(options)
end

#create_email_identity_policy(params = {}) ⇒ Struct

Creates the specified sending authorization policy for the given 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.

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

Examples:

Request syntax with placeholder values


resp = client.create_email_identity_policy({
  email_identity: "Identity", # required
  policy_name: "PolicyName", # required
  policy: "Policy", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :email_identity (required, String)

    The email identity for which you want to create a policy.

  • :policy_name (required, String)

    The name of the policy.

    The policy name cannot exceed 64 characters and can only include alphanumeric characters, dashes, and underscores.

  • :policy (required, String)

    The text of the policy in JSON format. The policy cannot exceed 4 KB.

    For information about the syntax of sending authorization policies, see the Amazon SES Developer Guide.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



791
792
793
794
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 791

def create_email_identity_policy(params = {}, options = {})
  req = build_request(:create_email_identity_policy, params)
  req.send_request(options)
end

#create_email_template(params = {}) ⇒ Struct

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.

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

Examples:

Request syntax with placeholder values


resp = client.create_email_template({
  template_name: "EmailTemplateName", # required
  template_content: { # required
    subject: "EmailTemplateSubject",
    text: "EmailTemplateText",
    html: "EmailTemplateHtml",
  },
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :template_name (required, String)

    The name of the template you want to create.

  • :template_content (required, Types::EmailTemplateContent)

    The content of the email template, composed of a subject line, an HTML part, and a text-only part.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



831
832
833
834
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 831

def create_email_template(params = {}, options = {})
  req = build_request(:create_email_template, params)
  req.send_request(options)
end

#create_import_job(params = {}) ⇒ Types::CreateImportJobResponse

Creates an import job for a data destination.

Examples:

Request syntax with placeholder values


resp = client.create_import_job({
  import_destination: { # required
    suppression_list_destination: { # required
      suppression_list_import_action: "DELETE", # required, accepts DELETE, PUT
    },
  },
  import_data_source: { # required
    s3_url: "S3Url", # required
    data_format: "CSV", # required, accepts CSV, JSON
  },
})

Response structure


resp.job_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

Returns:

See Also:



870
871
872
873
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 870

def create_import_job(params = {}, options = {})
  req = build_request(:create_import_job, params)
  req.send_request(options)
end

#delete_configuration_set(params = {}) ⇒ Struct

Delete an existing configuration set.

Configuration sets are groups of rules that you can apply to the emails you send. You apply a configuration set to an email by including a reference to the configuration set in the headers of the email. When you apply a configuration set to an email, all of the rules in that configuration set are applied to the email.

Examples:

Request syntax with placeholder values


resp = client.delete_configuration_set({
  configuration_set_name: "ConfigurationSetName", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    The name of the configuration set that you want to delete.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



898
899
900
901
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 898

def delete_configuration_set(params = {}, options = {})
  req = build_request(:delete_configuration_set, params)
  req.send_request(options)
end

#delete_configuration_set_event_destination(params = {}) ⇒ Struct

Delete an event destination.

Events include message sends, deliveries, opens, clicks, bounces, and complaints. Event destinations are places that you can send information about these events to. For example, you can send event data to Amazon SNS to receive notifications when you receive bounces or complaints, or you can use Amazon Kinesis Data Firehose to stream data to Amazon S3 for long-term storage.

Examples:

Request syntax with placeholder values


resp = client.delete_configuration_set_event_destination({
  configuration_set_name: "ConfigurationSetName", # required
  event_destination_name: "EventDestinationName", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    The name of the configuration set that contains the event destination that you want to delete.

  • :event_destination_name (required, String)

    The name of the event destination that you want to delete.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



932
933
934
935
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 932

def delete_configuration_set_event_destination(params = {}, options = {})
  req = build_request(:delete_configuration_set_event_destination, params)
  req.send_request(options)
end

#delete_custom_verification_email_template(params = {}) ⇒ Struct

Deletes an existing custom verification email template.

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer Guide.

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

Examples:

Request syntax with placeholder values


resp = client.delete_custom_verification_email_template({
  template_name: "EmailTemplateName", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :template_name (required, String)

    The name of the custom verification email template that you want to delete.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



965
966
967
968
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 965

def delete_custom_verification_email_template(params = {}, options = {})
  req = build_request(:delete_custom_verification_email_template, params)
  req.send_request(options)
end

#delete_dedicated_ip_pool(params = {}) ⇒ Struct

Delete a dedicated IP pool.

Examples:

Request syntax with placeholder values


resp = client.delete_dedicated_ip_pool({
  pool_name: "PoolName", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :pool_name (required, String)

    The name of the dedicated IP pool that you want to delete.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



987
988
989
990
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 987

def delete_dedicated_ip_pool(params = {}, options = {})
  req = build_request(:delete_dedicated_ip_pool, params)
  req.send_request(options)
end

#delete_email_identity(params = {}) ⇒ Struct

Deletes an email identity. An identity can be either an email address or a domain name.

Examples:

Request syntax with placeholder values


resp = client.delete_email_identity({
  email_identity: "Identity", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :email_identity (required, String)

    The identity (that is, the email address or domain) that you want to delete.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



1011
1012
1013
1014
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1011

def delete_email_identity(params = {}, options = {})
  req = build_request(:delete_email_identity, params)
  req.send_request(options)
end

#delete_email_identity_policy(params = {}) ⇒ Struct

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.

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

Examples:

Request syntax with placeholder values


resp = client.delete_email_identity_policy({
  email_identity: "Identity", # required
  policy_name: "PolicyName", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :email_identity (required, String)

    The email identity for which you want to delete a policy.

  • :policy_name (required, String)

    The name of the policy.

    The policy name cannot exceed 64 characters and can only include alphanumeric characters, dashes, and underscores.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



1057
1058
1059
1060
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1057

def delete_email_identity_policy(params = {}, options = {})
  req = build_request(:delete_email_identity_policy, params)
  req.send_request(options)
end

#delete_email_template(params = {}) ⇒ Struct

Deletes an email template.

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

Examples:

Request syntax with placeholder values


resp = client.delete_email_template({
  template_name: "EmailTemplateName", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :template_name (required, String)

    The name of the template to be deleted.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



1081
1082
1083
1084
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1081

def delete_email_template(params = {}, options = {})
  req = build_request(:delete_email_template, params)
  req.send_request(options)
end

#delete_suppressed_destination(params = {}) ⇒ Struct

Removes an email address from the suppression list for your account.

Examples:

Request syntax with placeholder values


resp = client.delete_suppressed_destination({
  email_address: "EmailAddress", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :email_address (required, String)

    The suppressed email destination to remove from the account suppression list.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



1104
1105
1106
1107
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1104

def delete_suppressed_destination(params = {}, options = {})
  req = build_request(:delete_suppressed_destination, params)
  req.send_request(options)
end

#get_account(params = {}) ⇒ Types::GetAccountResponse

Obtain information about the email-sending status and capabilities of your Amazon SES account in the current AWS Region.

Examples:

Response structure


resp.dedicated_ip_auto_warmup_enabled #=> Boolean
resp.enforcement_status #=> String
resp.production_access_enabled #=> Boolean
resp.send_quota.max_24_hour_send #=> Float
resp.send_quota.max_send_rate #=> Float
resp.send_quota.sent_last_24_hours #=> Float
resp.sending_enabled #=> Boolean
resp.suppression_attributes.suppressed_reasons #=> Array
resp.suppression_attributes.suppressed_reasons[0] #=> String, one of "BOUNCE", "COMPLAINT"
resp.details.mail_type #=> String, one of "MARKETING", "TRANSACTIONAL"
resp.details.website_url #=> String
resp.details.contact_language #=> String, one of "EN", "JA"
resp.details.use_case_description #=> String
resp.details.additional_contact_email_addresses #=> Array
resp.details.additional_contact_email_addresses[0] #=> String
resp.details.review_details.status #=> String, one of "PENDING", "FAILED", "GRANTED", "DENIED"
resp.details.review_details.case_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Returns:

See Also:



1146
1147
1148
1149
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1146

def (params = {}, options = {})
  req = build_request(:get_account, params)
  req.send_request(options)
end

#get_blacklist_reports(params = {}) ⇒ Types::GetBlacklistReportsResponse

Retrieve a list of the blacklists that your dedicated IP addresses appear on.

Examples:

Request syntax with placeholder values


resp = client.get_blacklist_reports({
  blacklist_item_names: ["BlacklistItemName"], # required
})

Response structure


resp.blacklist_report #=> Hash
resp.blacklist_report["BlacklistItemName"] #=> Array
resp.blacklist_report["BlacklistItemName"][0].rbl_name #=> String
resp.blacklist_report["BlacklistItemName"][0].listing_time #=> Time
resp.blacklist_report["BlacklistItemName"][0].description #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :blacklist_item_names (required, Array<String>)

    A list of IP addresses that you want to retrieve blacklist information about. You can only specify the dedicated IP addresses that you use to send email using Amazon SES or Amazon Pinpoint.

Returns:

See Also:



1181
1182
1183
1184
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1181

def get_blacklist_reports(params = {}, options = {})
  req = build_request(:get_blacklist_reports, params)
  req.send_request(options)
end

#get_configuration_set(params = {}) ⇒ Types::GetConfigurationSetResponse

Get information about an existing configuration set, including the dedicated IP pool that it's associated with, whether or not it's enabled for sending email, and more.

Configuration sets are groups of rules that you can apply to the emails you send. You apply a configuration set to an email by including a reference to the configuration set in the headers of the email. When you apply a configuration set to an email, all of the rules in that configuration set are applied to the email.

Examples:

Request syntax with placeholder values


resp = client.get_configuration_set({
  configuration_set_name: "ConfigurationSetName", # required
})

Response structure


resp.configuration_set_name #=> String
resp.tracking_options.custom_redirect_domain #=> String
resp.delivery_options.tls_policy #=> String, one of "REQUIRE", "OPTIONAL"
resp.delivery_options.sending_pool_name #=> String
resp.reputation_options.reputation_metrics_enabled #=> Boolean
resp.reputation_options.last_fresh_start #=> Time
resp.sending_options.sending_enabled #=> Boolean
resp.tags #=> Array
resp.tags[0].key #=> String
resp.tags[0].value #=> String
resp.suppression_options.suppressed_reasons #=> Array
resp.suppression_options.suppressed_reasons[0] #=> String, one of "BOUNCE", "COMPLAINT"

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    The name of the configuration set that you want to obtain more information about.

Returns:

See Also:



1235
1236
1237
1238
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1235

def get_configuration_set(params = {}, options = {})
  req = build_request(:get_configuration_set, params)
  req.send_request(options)
end

#get_configuration_set_event_destinations(params = {}) ⇒ Types::GetConfigurationSetEventDestinationsResponse

Retrieve a list of event destinations that are associated with a configuration set.

Events include message sends, deliveries, opens, clicks, bounces, and complaints. Event destinations are places that you can send information about these events to. For example, you can send event data to Amazon SNS to receive notifications when you receive bounces or complaints, or you can use Amazon Kinesis Data Firehose to stream data to Amazon S3 for long-term storage.

Examples:

Request syntax with placeholder values


resp = client.get_configuration_set_event_destinations({
  configuration_set_name: "ConfigurationSetName", # required
})

Response structure


resp.event_destinations #=> Array
resp.event_destinations[0].name #=> String
resp.event_destinations[0].enabled #=> Boolean
resp.event_destinations[0].matching_event_types #=> Array
resp.event_destinations[0].matching_event_types[0] #=> String, one of "SEND", "REJECT", "BOUNCE", "COMPLAINT", "DELIVERY", "OPEN", "CLICK", "RENDERING_FAILURE", "DELIVERY_DELAY"
resp.event_destinations[0].kinesis_firehose_destination.iam_role_arn #=> String
resp.event_destinations[0].kinesis_firehose_destination.delivery_stream_arn #=> String
resp.event_destinations[0].cloud_watch_destination.dimension_configurations #=> Array
resp.event_destinations[0].cloud_watch_destination.dimension_configurations[0].dimension_name #=> String
resp.event_destinations[0].cloud_watch_destination.dimension_configurations[0].dimension_value_source #=> String, one of "MESSAGE_TAG", "EMAIL_HEADER", "LINK_TAG"
resp.event_destinations[0].cloud_watch_destination.dimension_configurations[0].default_dimension_value #=> String
resp.event_destinations[0].sns_destination.topic_arn #=> String
resp.event_destinations[0].pinpoint_destination.application_arn #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    The name of the configuration set that contains the event destination.

Returns:

See Also:



1283
1284
1285
1286
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1283

def get_configuration_set_event_destinations(params = {}, options = {})
  req = build_request(:get_configuration_set_event_destinations, params)
  req.send_request(options)
end

#get_custom_verification_email_template(params = {}) ⇒ Types::GetCustomVerificationEmailTemplateResponse

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

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

Examples:

Request syntax with placeholder values


resp = client.get_custom_verification_email_template({
  template_name: "EmailTemplateName", # required
})

Response structure


resp.template_name #=> String
resp.from_email_address #=> String
resp.template_subject #=> String
resp.template_content #=> String
resp.success_redirection_url #=> String
resp.failure_redirection_url #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :template_name (required, String)

    The name of the custom verification email template that you want to retrieve.

Returns:

See Also:



1333
1334
1335
1336
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1333

def get_custom_verification_email_template(params = {}, options = {})
  req = build_request(:get_custom_verification_email_template, params)
  req.send_request(options)
end

#get_dedicated_ip(params = {}) ⇒ Types::GetDedicatedIpResponse

Get information about a dedicated IP address, including the name of the dedicated IP pool that it's associated with, as well information about the automatic warm-up process for the address.

Examples:

Request syntax with placeholder values


resp = client.get_dedicated_ip({
  ip: "Ip", # required
})

Response structure


resp.dedicated_ip.ip #=> String
resp.dedicated_ip.warmup_status #=> String, one of "IN_PROGRESS", "DONE"
resp.dedicated_ip.warmup_percentage #=> Integer
resp.dedicated_ip.pool_name #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :ip (required, String)

    The IP address that you want to obtain more information about. The value you specify has to be a dedicated IP address that's assocaited with your AWS account.

Returns:

See Also:



1368
1369
1370
1371
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1368

def get_dedicated_ip(params = {}, options = {})
  req = build_request(:get_dedicated_ip, params)
  req.send_request(options)
end

#get_dedicated_ips(params = {}) ⇒ Types::GetDedicatedIpsResponse

List the dedicated IP addresses that are associated with your AWS account.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.get_dedicated_ips({
  pool_name: "PoolName",
  next_token: "NextToken",
  page_size: 1,
})

Response structure


resp.dedicated_ips #=> Array
resp.dedicated_ips[0].ip #=> String
resp.dedicated_ips[0].warmup_status #=> String, one of "IN_PROGRESS", "DONE"
resp.dedicated_ips[0].warmup_percentage #=> Integer
resp.dedicated_ips[0].pool_name #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :pool_name (String)

    The name of the IP pool that the dedicated IP address is associated with.

  • :next_token (String)

    A token returned from a previous call to GetDedicatedIps to indicate the position of the dedicated IP pool in the list of IP pools.

  • :page_size (Integer)

    The number of results to show in a single call to GetDedicatedIpsRequest. If the number of results is larger than the number you specified in this parameter, then the response includes a NextToken element, which you can use to obtain additional results.

Returns:

See Also:



1418
1419
1420
1421
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1418

def get_dedicated_ips(params = {}, options = {})
  req = build_request(:get_dedicated_ips, params)
  req.send_request(options)
end

#get_deliverability_dashboard_options(params = {}) ⇒ Types::GetDeliverabilityDashboardOptionsResponse

Retrieve information about the status of the Deliverability dashboard for your account. When the Deliverability dashboard is enabled, you gain access to reputation, deliverability, and other metrics for the domains that you use to send email. You also gain the ability to perform predictive inbox placement tests.

When you use the Deliverability dashboard, you pay a monthly subscription charge, in addition to any other fees that you accrue by using Amazon SES and other AWS services. For more information about the features and cost of a Deliverability dashboard subscription, see Amazon SES Pricing.

Examples:

Response structure


resp.dashboard_enabled #=> Boolean
resp.subscription_expiry_date #=> Time
resp. #=> String, one of "ACTIVE", "PENDING_EXPIRATION", "DISABLED"
resp.active_subscribed_domains #=> Array
resp.active_subscribed_domains[0].domain #=> String
resp.active_subscribed_domains[0].subscription_start_date #=> Time
resp.active_subscribed_domains[0].inbox_placement_tracking_option.global #=> Boolean
resp.active_subscribed_domains[0].inbox_placement_tracking_option.tracked_isps #=> Array
resp.active_subscribed_domains[0].inbox_placement_tracking_option.tracked_isps[0] #=> String
resp.pending_expiration_subscribed_domains #=> Array
resp.pending_expiration_subscribed_domains[0].domain #=> String
resp.pending_expiration_subscribed_domains[0].subscription_start_date #=> Time
resp.pending_expiration_subscribed_domains[0].inbox_placement_tracking_option.global #=> Boolean
resp.pending_expiration_subscribed_domains[0].inbox_placement_tracking_option.tracked_isps #=> Array
resp.pending_expiration_subscribed_domains[0].inbox_placement_tracking_option.tracked_isps[0] #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Returns:

See Also:



1469
1470
1471
1472
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1469

def get_deliverability_dashboard_options(params = {}, options = {})
  req = build_request(:get_deliverability_dashboard_options, params)
  req.send_request(options)
end

#get_deliverability_test_report(params = {}) ⇒ Types::GetDeliverabilityTestReportResponse

Retrieve the results of a predictive inbox placement test.

Examples:

Request syntax with placeholder values


resp = client.get_deliverability_test_report({
  report_id: "ReportId", # required
})

Response structure


resp.deliverability_test_report.report_id #=> String
resp.deliverability_test_report.report_name #=> String
resp.deliverability_test_report.subject #=> String
resp.deliverability_test_report.from_email_address #=> String
resp.deliverability_test_report.create_date #=> Time
resp.deliverability_test_report.deliverability_test_status #=> String, one of "IN_PROGRESS", "COMPLETED"
resp.overall_placement.inbox_percentage #=> Float
resp.overall_placement.spam_percentage #=> Float
resp.overall_placement.missing_percentage #=> Float
resp.overall_placement.spf_percentage #=> Float
resp.overall_placement.dkim_percentage #=> Float
resp.isp_placements #=> Array
resp.isp_placements[0].isp_name #=> String
resp.isp_placements[0].placement_statistics.inbox_percentage #=> Float
resp.isp_placements[0].placement_statistics.spam_percentage #=> Float
resp.isp_placements[0].placement_statistics.missing_percentage #=> Float
resp.isp_placements[0].placement_statistics.spf_percentage #=> Float
resp.isp_placements[0].placement_statistics.dkim_percentage #=> Float
resp.message #=> String
resp.tags #=> Array
resp.tags[0].key #=> String
resp.tags[0].value #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :report_id (required, String)

    A unique string that identifies the predictive inbox placement test.

Returns:

See Also:



1522
1523
1524
1525
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1522

def get_deliverability_test_report(params = {}, options = {})
  req = build_request(:get_deliverability_test_report, params)
  req.send_request(options)
end

#get_domain_deliverability_campaign(params = {}) ⇒ Types::GetDomainDeliverabilityCampaignResponse

Retrieve all the deliverability data for a specific campaign. This data is available for a campaign only if the campaign sent email by using a domain that the Deliverability dashboard is enabled for.

Examples:

Request syntax with placeholder values


resp = client.get_domain_deliverability_campaign({
  campaign_id: "CampaignId", # required
})

Response structure


resp.domain_deliverability_campaign.campaign_id #=> String
resp.domain_deliverability_campaign.image_url #=> String
resp.domain_deliverability_campaign.subject #=> String
resp.domain_deliverability_campaign.from_address #=> String
resp.domain_deliverability_campaign.sending_ips #=> Array
resp.domain_deliverability_campaign.sending_ips[0] #=> String
resp.domain_deliverability_campaign.first_seen_date_time #=> Time
resp.domain_deliverability_campaign.last_seen_date_time #=> Time
resp.domain_deliverability_campaign.inbox_count #=> Integer
resp.domain_deliverability_campaign.spam_count #=> Integer
resp.domain_deliverability_campaign.read_rate #=> Float
resp.domain_deliverability_campaign.delete_rate #=> Float
resp.domain_deliverability_campaign.read_delete_rate #=> Float
resp.domain_deliverability_campaign.projected_volume #=> Integer
resp.domain_deliverability_campaign.esps #=> Array
resp.domain_deliverability_campaign.esps[0] #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :campaign_id (required, String)

    The unique identifier for the campaign. The Deliverability dashboard automatically generates and assigns this identifier to a campaign.

Returns:

See Also:



1568
1569
1570
1571
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1568

def get_domain_deliverability_campaign(params = {}, options = {})
  req = build_request(:get_domain_deliverability_campaign, params)
  req.send_request(options)
end

#get_domain_statistics_report(params = {}) ⇒ Types::GetDomainStatisticsReportResponse

Retrieve inbox placement and engagement rates for the domains that you use to send email.

Examples:

Request syntax with placeholder values


resp = client.get_domain_statistics_report({
  domain: "Identity", # required
  start_date: Time.now, # required
  end_date: Time.now, # required
})

Response structure


resp.overall_volume.volume_statistics.inbox_raw_count #=> Integer
resp.overall_volume.volume_statistics.spam_raw_count #=> Integer
resp.overall_volume.volume_statistics.projected_inbox #=> Integer
resp.overall_volume.volume_statistics.projected_spam #=> Integer
resp.overall_volume.read_rate_percent #=> Float
resp.overall_volume.domain_isp_placements #=> Array
resp.overall_volume.domain_isp_placements[0].isp_name #=> String
resp.overall_volume.domain_isp_placements[0].inbox_raw_count #=> Integer
resp.overall_volume.domain_isp_placements[0].spam_raw_count #=> Integer
resp.overall_volume.domain_isp_placements[0].inbox_percentage #=> Float
resp.overall_volume.domain_isp_placements[0].spam_percentage #=> Float
resp.daily_volumes #=> Array
resp.daily_volumes[0].start_date #=> Time
resp.daily_volumes[0].volume_statistics.inbox_raw_count #=> Integer
resp.daily_volumes[0].volume_statistics.spam_raw_count #=> Integer
resp.daily_volumes[0].volume_statistics.projected_inbox #=> Integer
resp.daily_volumes[0].volume_statistics.projected_spam #=> Integer
resp.daily_volumes[0].domain_isp_placements #=> Array
resp.daily_volumes[0].domain_isp_placements[0].isp_name #=> String
resp.daily_volumes[0].domain_isp_placements[0].inbox_raw_count #=> Integer
resp.daily_volumes[0].domain_isp_placements[0].spam_raw_count #=> Integer
resp.daily_volumes[0].domain_isp_placements[0].inbox_percentage #=> Float
resp.daily_volumes[0].domain_isp_placements[0].spam_percentage #=> Float

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :domain (required, String)

    The domain that you want to obtain deliverability metrics for.

  • :start_date (required, Time, DateTime, Date, Integer, String)

    The first day (in Unix time) that you want to obtain domain deliverability metrics for.

  • :end_date (required, Time, DateTime, Date, Integer, String)

    The last day (in Unix time) that you want to obtain domain deliverability metrics for. The EndDate that you specify has to be less than or equal to 30 days after the StartDate.

Returns:

See Also:



1631
1632
1633
1634
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1631

def get_domain_statistics_report(params = {}, options = {})
  req = build_request(:get_domain_statistics_report, params)
  req.send_request(options)
end

#get_email_identity(params = {}) ⇒ Types::GetEmailIdentityResponse

Provides information about a specific identity, including the identity's verification status, sending authorization policies, its DKIM authentication status, and its custom Mail-From settings.

Examples:

Request syntax with placeholder values


resp = client.get_email_identity({
  email_identity: "Identity", # required
})

Response structure


resp.identity_type #=> String, one of "EMAIL_ADDRESS", "DOMAIN", "MANAGED_DOMAIN"
resp.feedback_forwarding_status #=> Boolean
resp.verified_for_sending_status #=> Boolean
resp.dkim_attributes.signing_enabled #=> Boolean
resp.dkim_attributes.status #=> String, one of "PENDING", "SUCCESS", "FAILED", "TEMPORARY_FAILURE", "NOT_STARTED"
resp.dkim_attributes.tokens #=> Array
resp.dkim_attributes.tokens[0] #=> String
resp.dkim_attributes.signing_attributes_origin #=> String, one of "AWS_SES", "EXTERNAL"
resp.mail_from_attributes.mail_from_domain #=> String
resp.mail_from_attributes.mail_from_domain_status #=> String, one of "PENDING", "SUCCESS", "FAILED", "TEMPORARY_FAILURE"
resp.mail_from_attributes.behavior_on_mx_failure #=> String, one of "USE_DEFAULT_VALUE", "REJECT_MESSAGE"
resp.policies #=> Hash
resp.policies["PolicyName"] #=> String
resp.tags #=> Array
resp.tags[0].key #=> String
resp.tags[0].value #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :email_identity (required, String)

    The email identity that you want to retrieve details for.

Returns:

See Also:



1682
1683
1684
1685
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1682

def get_email_identity(params = {}, options = {})
  req = build_request(:get_email_identity, params)
  req.send_request(options)
end

#get_email_identity_policies(params = {}) ⇒ Types::GetEmailIdentityPoliciesResponse

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.

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

Examples:

Request syntax with placeholder values


resp = client.get_email_identity_policies({
  email_identity: "Identity", # required
})

Response structure


resp.policies #=> Hash
resp.policies["PolicyName"] #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :email_identity (required, String)

    The email identity that you want to retrieve policies for.

Returns:

See Also:



1729
1730
1731
1732
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1729

def get_email_identity_policies(params = {}, options = {})
  req = build_request(:get_email_identity_policies, params)
  req.send_request(options)
end

#get_email_template(params = {}) ⇒ Types::GetEmailTemplateResponse

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.

Examples:

Request syntax with placeholder values


resp = client.get_email_template({
  template_name: "EmailTemplateName", # required
})

Response structure


resp.template_name #=> String
resp.template_content.subject #=> String
resp.template_content.text #=> String
resp.template_content.html #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :template_name (required, String)

    The name of the template you want to retrieve.

Returns:

See Also:



1764
1765
1766
1767
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1764

def get_email_template(params = {}, options = {})
  req = build_request(:get_email_template, params)
  req.send_request(options)
end

#get_import_job(params = {}) ⇒ Types::GetImportJobResponse

Provides information about an import job.

Examples:

Request syntax with placeholder values


resp = client.get_import_job({
  job_id: "JobId", # required
})

Response structure


resp.job_id #=> String
resp.import_destination.suppression_list_destination.suppression_list_import_action #=> String, one of "DELETE", "PUT"
resp.import_data_source.s3_url #=> String
resp.import_data_source.data_format #=> String, one of "CSV", "JSON"
resp.failure_info.failed_records_s3_url #=> String
resp.failure_info.error_message #=> String
resp.job_status #=> String, one of "CREATED", "PROCESSING", "COMPLETED", "FAILED"
resp.created_timestamp #=> Time
resp.completed_timestamp #=> Time
resp.processed_records_count #=> Integer
resp.failed_records_count #=> Integer

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :job_id (required, String)

    The ID of the import job.

Returns:

See Also:



1810
1811
1812
1813
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1810

def get_import_job(params = {}, options = {})
  req = build_request(:get_import_job, params)
  req.send_request(options)
end

#get_suppressed_destination(params = {}) ⇒ Types::GetSuppressedDestinationResponse

Retrieves information about a specific email address that's on the suppression list for your account.

Examples:

Request syntax with placeholder values


resp = client.get_suppressed_destination({
  email_address: "EmailAddress", # required
})

Response structure


resp.suppressed_destination.email_address #=> String
resp.suppressed_destination.reason #=> String, one of "BOUNCE", "COMPLAINT"
resp.suppressed_destination.last_update_time #=> Time
resp.suppressed_destination.attributes.message_id #=> String
resp.suppressed_destination.attributes.feedback_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :email_address (required, String)

    The email address that's on the account suppression list.

Returns:

See Also:



1843
1844
1845
1846
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1843

def get_suppressed_destination(params = {}, options = {})
  req = build_request(:get_suppressed_destination, params)
  req.send_request(options)
end

#list_configuration_sets(params = {}) ⇒ Types::ListConfigurationSetsResponse

List all of the configuration sets associated with your account in the current region.

Configuration sets are groups of rules that you can apply to the emails you send. You apply a configuration set to an email by including a reference to the configuration set in the headers of the email. When you apply a configuration set to an email, all of the rules in that configuration set are applied to the email.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_configuration_sets({
  next_token: "NextToken",
  page_size: 1,
})

Response structure


resp.configuration_sets #=> Array
resp.configuration_sets[0] #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :next_token (String)

    A token returned from a previous call to ListConfigurationSets to indicate the position in the list of configuration sets.

  • :page_size (Integer)

    The number of results to show in a single call to ListConfigurationSets. If the number of results is larger than the number you specified in this parameter, then the response includes a NextToken element, which you can use to obtain additional results.

Returns:

See Also:



1891
1892
1893
1894
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1891

def list_configuration_sets(params = {}, options = {})
  req = build_request(:list_configuration_sets, params)
  req.send_request(options)
end

#list_custom_verification_email_templates(params = {}) ⇒ Types::ListCustomVerificationEmailTemplatesResponse

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

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

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_custom_verification_email_templates({
  next_token: "NextToken",
  page_size: 1,
})

Response structure


resp.custom_verification_email_templates #=> Array
resp.custom_verification_email_templates[0].template_name #=> String
resp.custom_verification_email_templates[0].from_email_address #=> String
resp.custom_verification_email_templates[0].template_subject #=> String
resp.custom_verification_email_templates[0].success_redirection_url #=> String
resp.custom_verification_email_templates[0].failure_redirection_url #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :next_token (String)

    A token returned from a previous call to ListCustomVerificationEmailTemplates to indicate the position in the list of custom verification email templates.

  • :page_size (Integer)

    The number of results to show in a single call to ListCustomVerificationEmailTemplates. If the number of results is larger than the number you specified in this parameter, then the response includes a NextToken element, which you can use to obtain additional results.

    The value you specify has to be at least 1, and can be no more than 50.

Returns:

See Also:



1952
1953
1954
1955
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1952

def list_custom_verification_email_templates(params = {}, options = {})
  req = build_request(:list_custom_verification_email_templates, params)
  req.send_request(options)
end

#list_dedicated_ip_pools(params = {}) ⇒ Types::ListDedicatedIpPoolsResponse

List all of the dedicated IP pools that exist in your AWS account in the current Region.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_dedicated_ip_pools({
  next_token: "NextToken",
  page_size: 1,
})

Response structure


resp.dedicated_ip_pools #=> Array
resp.dedicated_ip_pools[0] #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :next_token (String)

    A token returned from a previous call to ListDedicatedIpPools to indicate the position in the list of dedicated IP pools.

  • :page_size (Integer)

    The number of results to show in a single call to ListDedicatedIpPools. If the number of results is larger than the number you specified in this parameter, then the response includes a NextToken element, which you can use to obtain additional results.

Returns:

See Also:



1994
1995
1996
1997
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 1994

def list_dedicated_ip_pools(params = {}, options = {})
  req = build_request(:list_dedicated_ip_pools, params)
  req.send_request(options)
end

#list_deliverability_test_reports(params = {}) ⇒ Types::ListDeliverabilityTestReportsResponse

Show a list of the predictive inbox placement tests that you've performed, regardless of their statuses. For predictive inbox placement tests that are complete, you can use the GetDeliverabilityTestReport operation to view the results.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_deliverability_test_reports({
  next_token: "NextToken",
  page_size: 1,
})

Response structure


resp.deliverability_test_reports #=> Array
resp.deliverability_test_reports[0].report_id #=> String
resp.deliverability_test_reports[0].report_name #=> String
resp.deliverability_test_reports[0].subject #=> String
resp.deliverability_test_reports[0].from_email_address #=> String
resp.deliverability_test_reports[0].create_date #=> Time
resp.deliverability_test_reports[0].deliverability_test_status #=> String, one of "IN_PROGRESS", "COMPLETED"
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :next_token (String)

    A token returned from a previous call to ListDeliverabilityTestReports to indicate the position in the list of predictive inbox placement tests.

  • :page_size (Integer)

    The number of results to show in a single call to ListDeliverabilityTestReports. If the number of results is larger than the number you specified in this parameter, then the response includes a NextToken element, which you can use to obtain additional results.

    The value you specify has to be at least 0, and can be no more than 1000.

Returns:

See Also:



2048
2049
2050
2051
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2048

def list_deliverability_test_reports(params = {}, options = {})
  req = build_request(:list_deliverability_test_reports, params)
  req.send_request(options)
end

#list_domain_deliverability_campaigns(params = {}) ⇒ Types::ListDomainDeliverabilityCampaignsResponse

Retrieve deliverability data for all the campaigns that used a specific domain to send email during a specified time range. This data is available for a domain only if you enabled the Deliverability dashboard for the domain.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_domain_deliverability_campaigns({
  start_date: Time.now, # required
  end_date: Time.now, # required
  subscribed_domain: "Domain", # required
  next_token: "NextToken",
  page_size: 1,
})

Response structure


resp.domain_deliverability_campaigns #=> Array
resp.domain_deliverability_campaigns[0].campaign_id #=> String
resp.domain_deliverability_campaigns[0].image_url #=> String
resp.domain_deliverability_campaigns[0].subject #=> String
resp.domain_deliverability_campaigns[0].from_address #=> String
resp.domain_deliverability_campaigns[0].sending_ips #=> Array
resp.domain_deliverability_campaigns[0].sending_ips[0] #=> String
resp.domain_deliverability_campaigns[0].first_seen_date_time #=> Time
resp.domain_deliverability_campaigns[0].last_seen_date_time #=> Time
resp.domain_deliverability_campaigns[0].inbox_count #=> Integer
resp.domain_deliverability_campaigns[0].spam_count #=> Integer
resp.domain_deliverability_campaigns[0].read_rate #=> Float
resp.domain_deliverability_campaigns[0].delete_rate #=> Float
resp.domain_deliverability_campaigns[0].read_delete_rate #=> Float
resp.domain_deliverability_campaigns[0].projected_volume #=> Integer
resp.domain_deliverability_campaigns[0].esps #=> Array
resp.domain_deliverability_campaigns[0].esps[0] #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :start_date (required, Time, DateTime, Date, Integer, String)

    The first day, in Unix time format, that you want to obtain deliverability data for.

  • :end_date (required, Time, DateTime, Date, Integer, String)

    The last day, in Unix time format, that you want to obtain deliverability data for. This value has to be less than or equal to 30 days after the value of the StartDate parameter.

  • :subscribed_domain (required, String)

    The domain to obtain deliverability data for.

  • :next_token (String)

    A token that’s returned from a previous call to the ListDomainDeliverabilityCampaigns operation. This token indicates the position of a campaign in the list of campaigns.

  • :page_size (Integer)

    The maximum number of results to include in response to a single call to the ListDomainDeliverabilityCampaigns operation. If the number of results is larger than the number that you specify in this parameter, the response includes a NextToken element, which you can use to obtain additional results.

Returns:

See Also:



2124
2125
2126
2127
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2124

def list_domain_deliverability_campaigns(params = {}, options = {})
  req = build_request(:list_domain_deliverability_campaigns, params)
  req.send_request(options)
end

#list_email_identities(params = {}) ⇒ Types::ListEmailIdentitiesResponse

Returns a list of all of the email identities that are associated with your AWS account. An identity can be either an email address or a domain. This operation returns identities that are verified as well as those that aren't. This operation returns identities that are associated with Amazon SES and Amazon Pinpoint.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_email_identities({
  next_token: "NextToken",
  page_size: 1,
})

Response structure


resp.email_identities #=> Array
resp.email_identities[0].identity_type #=> String, one of "EMAIL_ADDRESS", "DOMAIN", "MANAGED_DOMAIN"
resp.email_identities[0].identity_name #=> String
resp.email_identities[0].sending_enabled #=> Boolean
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :next_token (String)

    A token returned from a previous call to ListEmailIdentities to indicate the position in the list of identities.

  • :page_size (Integer)

    The number of results to show in a single call to ListEmailIdentities. If the number of results is larger than the number you specified in this parameter, then the response includes a NextToken element, which you can use to obtain additional results.

    The value you specify has to be at least 0, and can be no more than 1000.

Returns:

See Also:



2174
2175
2176
2177
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2174

def list_email_identities(params = {}, options = {})
  req = build_request(:list_email_identities, params)
  req.send_request(options)
end

#list_email_templates(params = {}) ⇒ Types::ListEmailTemplatesResponse

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.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_email_templates({
  next_token: "NextToken",
  page_size: 1,
})

Response structure


resp. #=> Array
resp.[0].template_name #=> String
resp.[0].created_timestamp #=> Time
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :next_token (String)

    A token returned from a previous call to ListEmailTemplates to indicate the position in the list of email templates.

  • :page_size (Integer)

    The number of results to show in a single call to ListEmailTemplates. If the number of results is larger than the number you specified in this parameter, then the response includes a NextToken element, which you can use to obtain additional results.

    The value you specify has to be at least 1, and can be no more than 10.

Returns:

See Also:



2222
2223
2224
2225
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2222

def list_email_templates(params = {}, options = {})
  req = build_request(:list_email_templates, params)
  req.send_request(options)
end

#list_import_jobs(params = {}) ⇒ Types::ListImportJobsResponse

Lists all of the import jobs.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_import_jobs({
  import_destination_type: "SUPPRESSION_LIST", # accepts SUPPRESSION_LIST
  next_token: "NextToken",
  page_size: 1,
})

Response structure


resp.import_jobs #=> Array
resp.import_jobs[0].job_id #=> String
resp.import_jobs[0].import_destination.suppression_list_destination.suppression_list_import_action #=> String, one of "DELETE", "PUT"
resp.import_jobs[0].job_status #=> String, one of "CREATED", "PROCESSING", "COMPLETED", "FAILED"
resp.import_jobs[0].created_timestamp #=> Time
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :import_destination_type (String)

    The destination of the import job, which can be used to list import jobs that have a certain ImportDestinationType.

  • :next_token (String)

    A string token indicating that there might be additional import jobs available to be listed. Copy this token to a subsequent call to ListImportJobs with the same parameters to retrieve the next page of import jobs.

  • :page_size (Integer)

    Maximum number of import jobs to return at once. Use this parameter to paginate results. If additional import jobs exist beyond the specified limit, the NextToken element is sent in the response. Use the NextToken value in subsequent requests to retrieve additional addresses.

Returns:

See Also:



2274
2275
2276
2277
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2274

def list_import_jobs(params = {}, options = {})
  req = build_request(:list_import_jobs, params)
  req.send_request(options)
end

#list_suppressed_destinations(params = {}) ⇒ Types::ListSuppressedDestinationsResponse

Retrieves a list of email addresses that are on the suppression list for your account.

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_suppressed_destinations({
  reasons: ["BOUNCE"], # accepts BOUNCE, COMPLAINT
  start_date: Time.now,
  end_date: Time.now,
  next_token: "NextToken",
  page_size: 1,
})

Response structure


resp.suppressed_destination_summaries #=> Array
resp.suppressed_destination_summaries[0].email_address #=> String
resp.suppressed_destination_summaries[0].reason #=> String, one of "BOUNCE", "COMPLAINT"
resp.suppressed_destination_summaries[0].last_update_time #=> Time
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :reasons (Array<String>)

    The factors that caused the email address to be added to .

  • :start_date (Time, DateTime, Date, Integer, String)

    Used to filter the list of suppressed email destinations so that it only includes addresses that were added to the list after a specific date. The date that you specify should be in Unix time format.

  • :end_date (Time, DateTime, Date, Integer, String)

    Used to filter the list of suppressed email destinations so that it only includes addresses that were added to the list before a specific date. The date that you specify should be in Unix time format.

  • :next_token (String)

    A token returned from a previous call to ListSuppressedDestinations to indicate the position in the list of suppressed email addresses.

  • :page_size (Integer)

    The number of results to show in a single call to ListSuppressedDestinations. If the number of results is larger than the number you specified in this parameter, then the response includes a NextToken element, which you can use to obtain additional results.

Returns:

See Also:



2334
2335
2336
2337
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2334

def list_suppressed_destinations(params = {}, options = {})
  req = build_request(:list_suppressed_destinations, params)
  req.send_request(options)
end

#list_tags_for_resource(params = {}) ⇒ Types::ListTagsForResourceResponse

Retrieve a list of the tags (keys and values) that are associated with a specified resource. A tag is a label that you optionally define and associate with a resource. Each tag consists of a required tag key and an optional associated tag value. A tag key is a general label that acts as a category for more specific tag values. A tag value acts as a descriptor within a tag key.

Examples:

Request syntax with placeholder values


resp = client.list_tags_for_resource({
  resource_arn: "AmazonResourceName", # required
})

Response structure


resp.tags #=> Array
resp.tags[0].key #=> String
resp.tags[0].value #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :resource_arn (required, String)

    The Amazon Resource Name (ARN) of the resource that you want to retrieve tag information for.

Returns:

See Also:



2370
2371
2372
2373
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2370

def list_tags_for_resource(params = {}, options = {})
  req = build_request(:list_tags_for_resource, params)
  req.send_request(options)
end

#put_account_dedicated_ip_warmup_attributes(params = {}) ⇒ Struct

Enable or disable the automatic warm-up feature for dedicated IP addresses.

Examples:

Request syntax with placeholder values


resp = client.({
  auto_warmup_enabled: false,
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :auto_warmup_enabled (Boolean)

    Enables or disables the automatic warm-up feature for dedicated IP addresses that are associated with your Amazon SES account in the current AWS Region. Set to true to enable the automatic warm-up feature, or set to false to disable it.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2396
2397
2398
2399
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2396

def (params = {}, options = {})
  req = build_request(:put_account_dedicated_ip_warmup_attributes, params)
  req.send_request(options)
end

#put_account_details(params = {}) ⇒ Struct

Update your Amazon SES account details.

Examples:

Request syntax with placeholder values


resp = client.({
  mail_type: "MARKETING", # required, accepts MARKETING, TRANSACTIONAL
  website_url: "WebsiteURL", # required
  contact_language: "EN", # accepts EN, JA
  use_case_description: "UseCaseDescription", # required
  additional_contact_email_addresses: ["AdditionalContactEmailAddress"],
  production_access_enabled: false,
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :mail_type (required, String)

    The type of email your account will send.

  • :website_url (required, String)

    The URL of your website. This information helps us better understand the type of content that you plan to send.

  • :contact_language (String)

    The language you would prefer to be contacted with.

  • :use_case_description (required, String)

    A description of the types of email that you plan to send.

  • :additional_contact_email_addresses (Array<String>)

    Additional email addresses that you would like to be notified regarding Amazon SES matters.

  • :production_access_enabled (Boolean)

    Indicates whether or not your account should have production access in the current AWS Region.

    If the value is false, then your account is in the sandbox. When your account is in the sandbox, you can only send email to verified identities. Additionally, the maximum number of emails you can send in a 24-hour period (your sending quota) is 200, and the maximum number of emails you can send per second (your maximum sending rate) is 1.

    If the value is true, then your account has production access. When your account has production access, you can send email to any address. The sending quota and maximum sending rate for your account vary based on your specific use case.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2452
2453
2454
2455
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2452

def (params = {}, options = {})
  req = build_request(:put_account_details, params)
  req.send_request(options)
end

#put_account_sending_attributes(params = {}) ⇒ Struct

Enable or disable the ability of your account to send email.

Examples:

Request syntax with placeholder values


resp = client.({
  sending_enabled: false,
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :sending_enabled (Boolean)

    Enables or disables your account's ability to send email. Set to true to enable email sending, or set to false to disable email sending.

    If AWS paused your account's ability to send email, you can't use this operation to resume your account's ability to send email.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2481
2482
2483
2484
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2481

def (params = {}, options = {})
  req = build_request(:put_account_sending_attributes, params)
  req.send_request(options)
end

#put_account_suppression_attributes(params = {}) ⇒ Struct

Change the settings for the account-level suppression list.

Examples:

Request syntax with placeholder values


resp = client.({
  suppressed_reasons: ["BOUNCE"], # accepts BOUNCE, COMPLAINT
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :suppressed_reasons (Array<String>)

    A list that contains the reasons that email addresses will be automatically added to the suppression list for your account. This list can contain any or all of the following:

    • COMPLAINT – Amazon SES adds an email address to the suppression list for your account when a message sent to that address results in a complaint.

    • BOUNCE – Amazon SES adds an email address to the suppression list for your account when a message sent to that address results in a hard bounce.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2513
2514
2515
2516
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2513

def (params = {}, options = {})
  req = build_request(:put_account_suppression_attributes, params)
  req.send_request(options)
end

#put_configuration_set_delivery_options(params = {}) ⇒ Struct

Associate a configuration set with a dedicated IP pool. You can use dedicated IP pools to create groups of dedicated IP addresses for sending specific types of email.

Examples:

Request syntax with placeholder values


resp = client.put_configuration_set_delivery_options({
  configuration_set_name: "ConfigurationSetName", # required
  tls_policy: "REQUIRE", # accepts REQUIRE, OPTIONAL
  sending_pool_name: "SendingPoolName",
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    The name of the configuration set that you want to associate with a dedicated IP pool.

  • :tls_policy (String)

    Specifies whether messages that use the configuration set are required to use Transport Layer Security (TLS). If the value is Require, messages are only delivered if a TLS connection can be established. If the value is Optional, messages can be delivered in plain text if a TLS connection can't be established.

  • :sending_pool_name (String)

    The name of the dedicated IP pool that you want to associate with the configuration set.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2551
2552
2553
2554
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2551

def put_configuration_set_delivery_options(params = {}, options = {})
  req = build_request(:put_configuration_set_delivery_options, params)
  req.send_request(options)
end

#put_configuration_set_reputation_options(params = {}) ⇒ Struct

Enable or disable collection of reputation metrics for emails that you send using a particular configuration set in a specific AWS Region.

Examples:

Request syntax with placeholder values


resp = client.put_configuration_set_reputation_options({
  configuration_set_name: "ConfigurationSetName", # required
  reputation_metrics_enabled: false,
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    The name of the configuration set that you want to enable or disable reputation metric tracking for.

  • :reputation_metrics_enabled (Boolean)

    If true, tracking of reputation metrics is enabled for the configuration set. If false, tracking of reputation metrics is disabled for the configuration set.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2581
2582
2583
2584
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2581

def put_configuration_set_reputation_options(params = {}, options = {})
  req = build_request(:put_configuration_set_reputation_options, params)
  req.send_request(options)
end

#put_configuration_set_sending_options(params = {}) ⇒ Struct

Enable or disable email sending for messages that use a particular configuration set in a specific AWS Region.

Examples:

Request syntax with placeholder values


resp = client.put_configuration_set_sending_options({
  configuration_set_name: "ConfigurationSetName", # required
  sending_enabled: false,
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    The name of the configuration set that you want to enable or disable email sending for.

  • :sending_enabled (Boolean)

    If true, email sending is enabled for the configuration set. If false, email sending is disabled for the configuration set.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2610
2611
2612
2613
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2610

def put_configuration_set_sending_options(params = {}, options = {})
  req = build_request(:put_configuration_set_sending_options, params)
  req.send_request(options)
end

#put_configuration_set_suppression_options(params = {}) ⇒ Struct

Specify the account suppression list preferences for a configuration set.

Examples:

Request syntax with placeholder values


resp = client.put_configuration_set_suppression_options({
  configuration_set_name: "ConfigurationSetName", # required
  suppressed_reasons: ["BOUNCE"], # accepts BOUNCE, COMPLAINT
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    The name of the configuration set that you want to change the suppression list preferences for.

  • :suppressed_reasons (Array<String>)

    A list that contains the reasons that email addresses are automatically added to the suppression list for your account. This list can contain any or all of the following:

    • COMPLAINT – Amazon SES adds an email address to the suppression list for your account when a message sent to that address results in a complaint.

    • BOUNCE – Amazon SES adds an email address to the suppression list for your account when a message sent to that address results in a hard bounce.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2648
2649
2650
2651
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2648

def put_configuration_set_suppression_options(params = {}, options = {})
  req = build_request(:put_configuration_set_suppression_options, params)
  req.send_request(options)
end

#put_configuration_set_tracking_options(params = {}) ⇒ Struct

Specify a custom domain to use for open and click tracking elements in email that you send.

Examples:

Request syntax with placeholder values


resp = client.put_configuration_set_tracking_options({
  configuration_set_name: "ConfigurationSetName", # required
  custom_redirect_domain: "CustomRedirectDomain",
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    The name of the configuration set that you want to add a custom tracking domain to.

  • :custom_redirect_domain (String)

    The domain that you want to use to track open and click events.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2676
2677
2678
2679
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2676

def put_configuration_set_tracking_options(params = {}, options = {})
  req = build_request(:put_configuration_set_tracking_options, params)
  req.send_request(options)
end

#put_dedicated_ip_in_pool(params = {}) ⇒ Struct

Move a dedicated IP address to an existing dedicated IP pool.

The dedicated IP address that you specify must already exist, and must be associated with your AWS account.

The dedicated IP pool you specify must already exist. You can create a new pool by using the CreateDedicatedIpPool operation.

Examples:

Request syntax with placeholder values


resp = client.put_dedicated_ip_in_pool({
  ip: "Ip", # required
  destination_pool_name: "PoolName", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :ip (required, String)

    The IP address that you want to move to the dedicated IP pool. The value you specify has to be a dedicated IP address that's associated with your AWS account.

  • :destination_pool_name (required, String)

    The name of the IP pool that you want to add the dedicated IP address to. You have to specify an IP pool that already exists.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2713
2714
2715
2716
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2713

def put_dedicated_ip_in_pool(params = {}, options = {})
  req = build_request(:put_dedicated_ip_in_pool, params)
  req.send_request(options)
end

#put_dedicated_ip_warmup_attributes(params = {}) ⇒ Struct

Returns an empty response.

Examples:

Request syntax with placeholder values


resp = client.put_dedicated_ip_warmup_attributes({
  ip: "Ip", # required
  warmup_percentage: 1, # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :ip (required, String)

    The dedicated IP address that you want to update the warm-up attributes for.

  • :warmup_percentage (required, Integer)

    The warm-up percentage that you want to associate with the dedicated IP address.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2739
2740
2741
2742
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2739

def put_dedicated_ip_warmup_attributes(params = {}, options = {})
  req = build_request(:put_dedicated_ip_warmup_attributes, params)
  req.send_request(options)
end

#put_deliverability_dashboard_option(params = {}) ⇒ Struct

Enable or disable the Deliverability dashboard. When you enable the Deliverability dashboard, you gain access to reputation, deliverability, and other metrics for the domains that you use to send email. You also gain the ability to perform predictive inbox placement tests.

When you use the Deliverability dashboard, you pay a monthly subscription charge, in addition to any other fees that you accrue by using Amazon SES and other AWS services. For more information about the features and cost of a Deliverability dashboard subscription, see Amazon SES Pricing.

Examples:

Request syntax with placeholder values


resp = client.put_deliverability_dashboard_option({
  dashboard_enabled: false, # required
  subscribed_domains: [
    {
      domain: "Domain",
      subscription_start_date: Time.now,
      inbox_placement_tracking_option: {
        global: false,
        tracked_isps: ["IspName"],
      },
    },
  ],
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :dashboard_enabled (required, Boolean)

    Specifies whether to enable the Deliverability dashboard. To enable the dashboard, set this value to true.

  • :subscribed_domains (Array<Types::DomainDeliverabilityTrackingOption>)

    An array of objects, one for each verified domain that you use to send email and enabled the Deliverability dashboard for.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2790
2791
2792
2793
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2790

def put_deliverability_dashboard_option(params = {}, options = {})
  req = build_request(:put_deliverability_dashboard_option, params)
  req.send_request(options)
end

#put_email_identity_dkim_attributes(params = {}) ⇒ Struct

Used to enable or disable DKIM authentication for an email identity.

Examples:

Request syntax with placeholder values


resp = client.put_email_identity_dkim_attributes({
  email_identity: "Identity", # required
  signing_enabled: false,
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :email_identity (required, String)

    The email identity that you want to change the DKIM settings for.

  • :signing_enabled (Boolean)

    Sets the DKIM signing configuration for the identity.

    When you set this value true, then the messages that are sent from the identity are signed using DKIM. If you set this value to false, your messages are sent without DKIM signing.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2820
2821
2822
2823
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2820

def put_email_identity_dkim_attributes(params = {}, options = {})
  req = build_request(:put_email_identity_dkim_attributes, params)
  req.send_request(options)
end

#put_email_identity_dkim_signing_attributes(params = {}) ⇒ Types::PutEmailIdentityDkimSigningAttributesResponse

Used to configure or change the DKIM authentication settings for an email domain identity. You can use this operation to do any of the following:

  • Update the signing attributes for an identity that uses Bring Your Own DKIM (BYODKIM).

  • Change from using no DKIM authentication to using Easy DKIM.

  • Change from using no DKIM authentication to using BYODKIM.

  • Change from using Easy DKIM to using BYODKIM.

  • Change from using BYODKIM to using Easy DKIM.

Examples:

Request syntax with placeholder values


resp = client.put_email_identity_dkim_signing_attributes({
  email_identity: "Identity", # required
  signing_attributes_origin: "AWS_SES", # required, accepts AWS_SES, EXTERNAL
  signing_attributes: {
    domain_signing_selector: "Selector", # required
    domain_signing_private_key: "PrivateKey", # required
  },
})

Response structure


resp.dkim_status #=> String, one of "PENDING", "SUCCESS", "FAILED", "TEMPORARY_FAILURE", "NOT_STARTED"
resp.dkim_tokens #=> Array
resp.dkim_tokens[0] #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :email_identity (required, String)

    The email identity that you want to configure DKIM for.

  • :signing_attributes_origin (required, String)

    The method that you want to use to configure DKIM for the identity. There are two possible values:

    • AWS_SES – Configure DKIM for the identity by using Easy DKIM.

    • EXTERNAL – Configure DKIM for the identity by using Bring Your Own DKIM (BYODKIM).

  • :signing_attributes (Types::DkimSigningAttributes)

    An object that contains information about the private key and selector that you want to use to configure DKIM for the identity. This object is only required if you want to configure Bring Your Own DKIM (BYODKIM) for the identity.

Returns:

See Also:



2888
2889
2890
2891
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2888

def put_email_identity_dkim_signing_attributes(params = {}, options = {})
  req = build_request(:put_email_identity_dkim_signing_attributes, params)
  req.send_request(options)
end

#put_email_identity_feedback_attributes(params = {}) ⇒ Struct

Used to enable or disable feedback forwarding for an identity. This setting determines what happens when an identity is used to send an email that results in a bounce or complaint event.

If the value is true, you receive email notifications when bounce or complaint events occur. These notifications are sent to the address that you specified in the Return-Path header of the original email.

You're required to have a method of tracking bounces and complaints. If you haven't set up another mechanism for receiving bounce or complaint notifications (for example, by setting up an event destination), you receive an email notification when these events occur (even if this setting is disabled).

Examples:

Request syntax with placeholder values


resp = client.put_email_identity_feedback_attributes({
  email_identity: "Identity", # required
  email_forwarding_enabled: false,
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :email_identity (required, String)

    The email identity that you want to configure bounce and complaint feedback forwarding for.

  • :email_forwarding_enabled (Boolean)

    Sets the feedback forwarding configuration for the identity.

    If the value is true, you receive email notifications when bounce or complaint events occur. These notifications are sent to the address that you specified in the Return-Path header of the original email.

    You're required to have a method of tracking bounces and complaints. If you haven't set up another mechanism for receiving bounce or complaint notifications (for example, by setting up an event destination), you receive an email notification when these events occur (even if this setting is disabled).

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2937
2938
2939
2940
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2937

def put_email_identity_feedback_attributes(params = {}, options = {})
  req = build_request(:put_email_identity_feedback_attributes, params)
  req.send_request(options)
end

#put_email_identity_mail_from_attributes(params = {}) ⇒ Struct

Used to enable or disable the custom Mail-From domain configuration for an email identity.

Examples:

Request syntax with placeholder values


resp = client.put_email_identity_mail_from_attributes({
  email_identity: "Identity", # required
  mail_from_domain: "MailFromDomainName",
  behavior_on_mx_failure: "USE_DEFAULT_VALUE", # accepts USE_DEFAULT_VALUE, REJECT_MESSAGE
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :email_identity (required, String)

    The verified email identity that you want to set up the custom MAIL FROM domain for.

  • :mail_from_domain (String)

    The custom MAIL FROM domain that you want the verified identity to use. The MAIL FROM domain must meet the following criteria:

    • It has to be a subdomain of the verified identity.

    • It can't be used to receive email.

    • It can't be used in a "From" address if the MAIL FROM domain is a destination for feedback forwarding emails.

  • :behavior_on_mx_failure (String)

    The action that you want to take if the required MX record isn't found when you send an email. When you set this value to UseDefaultValue, the mail is sent using amazonses.com as the MAIL FROM domain. When you set this value to RejectMessage, the Amazon SES API v2 returns a MailFromDomainNotVerified error, and doesn't attempt to deliver the email.

    These behaviors are taken when the custom MAIL FROM domain configuration is in the Pending, Failed, and TemporaryFailure states.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2986
2987
2988
2989
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 2986

def put_email_identity_mail_from_attributes(params = {}, options = {})
  req = build_request(:put_email_identity_mail_from_attributes, params)
  req.send_request(options)
end

#put_suppressed_destination(params = {}) ⇒ Struct

Adds an email address to the suppression list for your account.

Examples:

Request syntax with placeholder values


resp = client.put_suppressed_destination({
  email_address: "EmailAddress", # required
  reason: "BOUNCE", # required, accepts BOUNCE, COMPLAINT
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :email_address (required, String)

    The email address that should be added to the suppression list for your account.

  • :reason (required, String)

    The factors that should cause the email address to be added to the suppression list for your account.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3014
3015
3016
3017
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 3014

def put_suppressed_destination(params = {}, options = {})
  req = build_request(:put_suppressed_destination, params)
  req.send_request(options)
end

#send_bulk_email(params = {}) ⇒ Types::SendBulkEmailResponse

Composes an email message to multiple destinations.

Examples:

Request syntax with placeholder values


resp = client.send_bulk_email({
  from_email_address: "EmailAddress",
  from_email_address_identity_arn: "AmazonResourceName",
  reply_to_addresses: ["EmailAddress"],
  feedback_forwarding_email_address: "EmailAddress",
  feedback_forwarding_email_address_identity_arn: "AmazonResourceName",
  default_email_tags: [
    {
      name: "MessageTagName", # required
      value: "MessageTagValue", # required
    },
  ],
  default_content: { # required
    template: {
      template_name: "EmailTemplateName",
      template_arn: "AmazonResourceName",
      template_data: "EmailTemplateData",
    },
  },
  bulk_email_entries: [ # required
    {
      destination: { # required
        to_addresses: ["EmailAddress"],
        cc_addresses: ["EmailAddress"],
        bcc_addresses: ["EmailAddress"],
      },
      replacement_tags: [
        {
          name: "MessageTagName", # required
          value: "MessageTagValue", # required
        },
      ],
      replacement_email_content: {
        replacement_template: {
          replacement_template_data: "EmailTemplateData",
        },
      },
    },
  ],
  configuration_set_name: "ConfigurationSetName",
})

Response structure


resp.bulk_email_entry_results #=> Array
resp.bulk_email_entry_results[0].status #=> String, one of "SUCCESS", "MESSAGE_REJECTED", "MAIL_FROM_DOMAIN_NOT_VERIFIED", "CONFIGURATION_SET_NOT_FOUND", "TEMPLATE_NOT_FOUND", "ACCOUNT_SUSPENDED", "ACCOUNT_THROTTLED", "ACCOUNT_DAILY_QUOTA_EXCEEDED", "INVALID_SENDING_POOL_NAME", "ACCOUNT_SENDING_PAUSED", "CONFIGURATION_SET_SENDING_PAUSED", "INVALID_PARAMETER", "TRANSIENT_FAILURE", "FAILED"
resp.bulk_email_entry_results[0].error #=> String
resp.bulk_email_entry_results[0].message_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :from_email_address (String)

    The email address that you want to use as the "From" address for the email. The address that you specify has to be verified.

  • :from_email_address_identity_arn (String)

    This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to use the email address specified in the FromEmailAddress parameter.

    For example, if the owner of example.com (which has ARN arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a policy to it that authorizes you to use sender@example.com, then you would specify the FromEmailAddressIdentityArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com, and the FromEmailAddress to be sender@example.com.

    For more information about sending authorization, see the Amazon SES Developer Guide.

  • :reply_to_addresses (Array<String>)

    The "Reply-to" email addresses for the message. When the recipient replies to the message, each Reply-to address receives the reply.

  • :feedback_forwarding_email_address (String)

    The address that you want bounce and complaint notifications to be sent to.

  • :feedback_forwarding_email_address_identity_arn (String)

    This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to use the email address specified in the FeedbackForwardingEmailAddress parameter.

    For example, if the owner of example.com (which has ARN arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a policy to it that authorizes you to use feedback@example.com, then you would specify the FeedbackForwardingEmailAddressIdentityArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com, and the FeedbackForwardingEmailAddress to be feedback@example.com.

    For more information about sending authorization, see the Amazon SES Developer Guide.

  • :default_email_tags (Array<Types::MessageTag>)

    A list of tags, in the form of name/value pairs, to apply to an email that you send using the SendEmail operation. Tags correspond to characteristics of the email that you define, so that you can publish email sending events.

  • :default_content (required, Types::BulkEmailContent)

    An object that contains the body of the message. You can specify a template message.

  • :bulk_email_entries (required, Array<Types::BulkEmailEntry>)

    The list of bulk email entry objects.

  • :configuration_set_name (String)

    The name of the configuration set that you want to use when sending the email.

Returns:

See Also:



3149
3150
3151
3152
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 3149

def send_bulk_email(params = {}, options = {})
  req = build_request(:send_bulk_email, params)
  req.send_request(options)
end

#send_custom_verification_email(params = {}) ⇒ Types::SendCustomVerificationEmailResponse

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

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

Examples:

Request syntax with placeholder values


resp = client.send_custom_verification_email({
  email_address: "EmailAddress", # required
  template_name: "EmailTemplateName", # required
  configuration_set_name: "ConfigurationSetName",
})

Response structure


resp.message_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :email_address (required, String)

    The email address to verify.

  • :template_name (required, String)

    The name of the custom verification email template to use when sending the verification email.

  • :configuration_set_name (String)

    Name of a configuration set to use when sending the verification email.

Returns:

See Also:



3201
3202
3203
3204
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 3201

def send_custom_verification_email(params = {}, options = {})
  req = build_request(:send_custom_verification_email, params)
  req.send_request(options)
end

#send_email(params = {}) ⇒ Types::SendEmailResponse

Sends an email message. You can use the Amazon SES API v2 to send two types of messages:

  • Simple – A standard email message. When you create this type of message, you specify the sender, the recipient, and the message body, and Amazon SES assembles the message for you.

  • Raw – A raw, MIME-formatted email message. When you send this type of email, you have to specify all of the message headers, as well as the message body. You can use this message type to send messages that contain attachments. The message that you specify has to be a valid MIME message.

  • Templated – A message that contains personalization tags. When you send this type of email, Amazon SES API v2 automatically replaces the tags with values that you specify.

Examples:

Request syntax with placeholder values


resp = client.send_email({
  from_email_address: "EmailAddress",
  from_email_address_identity_arn: "AmazonResourceName",
  destination: {
    to_addresses: ["EmailAddress"],
    cc_addresses: ["EmailAddress"],
    bcc_addresses: ["EmailAddress"],
  },
  reply_to_addresses: ["EmailAddress"],
  feedback_forwarding_email_address: "EmailAddress",
  feedback_forwarding_email_address_identity_arn: "AmazonResourceName",
  content: { # required
    simple: {
      subject: { # required
        data: "MessageData", # required
        charset: "Charset",
      },
      body: { # required
        text: {
          data: "MessageData", # required
          charset: "Charset",
        },
        html: {
          data: "MessageData", # required
          charset: "Charset",
        },
      },
    },
    raw: {
      data: "data", # required
    },
    template: {
      template_name: "EmailTemplateName",
      template_arn: "AmazonResourceName",
      template_data: "EmailTemplateData",
    },
  },
  email_tags: [
    {
      name: "MessageTagName", # required
      value: "MessageTagValue", # required
    },
  ],
  configuration_set_name: "ConfigurationSetName",
})

Response structure


resp.message_id #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :from_email_address (String)

    The email address that you want to use as the "From" address for the email. The address that you specify has to be verified.

  • :from_email_address_identity_arn (String)

    This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to use the email address specified in the FromEmailAddress parameter.

    For example, if the owner of example.com (which has ARN arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a policy to it that authorizes you to use sender@example.com, then you would specify the FromEmailAddressIdentityArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com, and the FromEmailAddress to be sender@example.com.

    For more information about sending authorization, see the Amazon SES Developer Guide.

    For Raw emails, the FromEmailAddressIdentityArn value overrides the X-SES-SOURCE-ARN and X-SES-FROM-ARN headers specified in raw email message content.

  • :destination (Types::Destination)

    An object that contains the recipients of the email message.

  • :reply_to_addresses (Array<String>)

    The "Reply-to" email addresses for the message. When the recipient replies to the message, each Reply-to address receives the reply.

  • :feedback_forwarding_email_address (String)

    The address that you want bounce and complaint notifications to be sent to.

  • :feedback_forwarding_email_address_identity_arn (String)

    This parameter is used only for sending authorization. It is the ARN of the identity that is associated with the sending authorization policy that permits you to use the email address specified in the FeedbackForwardingEmailAddress parameter.

    For example, if the owner of example.com (which has ARN arn:aws:ses:us-east-1:123456789012:identity/example.com) attaches a policy to it that authorizes you to use feedback@example.com, then you would specify the FeedbackForwardingEmailAddressIdentityArn to be arn:aws:ses:us-east-1:123456789012:identity/example.com, and the FeedbackForwardingEmailAddress to be feedback@example.com.

    For more information about sending authorization, see the Amazon SES Developer Guide.

  • :content (required, Types::EmailContent)

    An object that contains the body of the message. You can send either a Simple message Raw message or a template Message.

  • :email_tags (Array<Types::MessageTag>)

    A list of tags, in the form of name/value pairs, to apply to an email that you send using the SendEmail operation. Tags correspond to characteristics of the email that you define, so that you can publish email sending events.

  • :configuration_set_name (String)

    The name of the configuration set that you want to use when sending the email.

Returns:

See Also:



3356
3357
3358
3359
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 3356

def send_email(params = {}, options = {})
  req = build_request(:send_email, params)
  req.send_request(options)
end

#tag_resource(params = {}) ⇒ Struct

Add one or more tags (keys and values) to a specified resource. A tag is a label that you optionally define and associate with a resource. Tags can help you categorize and manage resources in different ways, such as by purpose, owner, environment, or other criteria. A resource can have as many as 50 tags.

Each tag consists of a required tag key and an associated tag value, both of which you define. A tag key is a general label that acts as a category for more specific tag values. A tag value acts as a descriptor within a tag key.

Examples:

Request syntax with placeholder values


resp = client.tag_resource({
  resource_arn: "AmazonResourceName", # required
  tags: [ # required
    {
      key: "TagKey", # required
      value: "TagValue", # required
    },
  ],
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :resource_arn (required, String)

    The Amazon Resource Name (ARN) of the resource that you want to add one or more tags to.

  • :tags (required, Array<Types::Tag>)

    A list of the tags that you want to add to the resource. A tag consists of a required tag key (Key) and an associated tag value (Value). The maximum length of a tag key is 128 characters. The maximum length of a tag value is 256 characters.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3400
3401
3402
3403
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 3400

def tag_resource(params = {}, options = {})
  req = build_request(:tag_resource, params)
  req.send_request(options)
end

#test_render_email_template(params = {}) ⇒ Types::TestRenderEmailTemplateResponse

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.

Examples:

Request syntax with placeholder values


resp = client.test_render_email_template({
  template_name: "EmailTemplateName", # required
  template_data: "EmailTemplateData", # required
})

Response structure


resp.rendered_template #=> String

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :template_name (required, String)

    The name of the template that you want to render.

  • :template_data (required, String)

    A list of replacement values to apply to the template. This parameter is a JSON object, typically consisting of key-value pairs in which the keys correspond to replacement tags in the email template.

Returns:

See Also:



3437
3438
3439
3440
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 3437

def test_render_email_template(params = {}, options = {})
  req = build_request(:test_render_email_template, params)
  req.send_request(options)
end

#untag_resource(params = {}) ⇒ Struct

Remove one or more tags (keys and values) from a specified resource.

Examples:

Request syntax with placeholder values


resp = client.untag_resource({
  resource_arn: "AmazonResourceName", # required
  tag_keys: ["TagKey"], # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :resource_arn (required, String)

    The Amazon Resource Name (ARN) of the resource that you want to remove one or more tags from.

  • :tag_keys (required, Array<String>)

    The tags (tag keys) that you want to remove from the resource. When you specify a tag key, the action removes both that key and its associated tag value.

    To remove more than one tag from the resource, append the TagKeys parameter and argument for each additional tag to remove, separated by an ampersand. For example: /v2/email/tags?ResourceArn=ResourceArn&TagKeys=Key1&TagKeys=Key2

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3471
3472
3473
3474
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 3471

def untag_resource(params = {}, options = {})
  req = build_request(:untag_resource, params)
  req.send_request(options)
end

#update_configuration_set_event_destination(params = {}) ⇒ Struct

Update the configuration of an event destination for a configuration set.

Events include message sends, deliveries, opens, clicks, bounces, and complaints. Event destinations are places that you can send information about these events to. For example, you can send event data to Amazon SNS to receive notifications when you receive bounces or complaints, or you can use Amazon Kinesis Data Firehose to stream data to Amazon S3 for long-term storage.

Examples:

Request syntax with placeholder values


resp = client.update_configuration_set_event_destination({
  configuration_set_name: "ConfigurationSetName", # required
  event_destination_name: "EventDestinationName", # required
  event_destination: { # required
    enabled: false,
    matching_event_types: ["SEND"], # accepts SEND, REJECT, BOUNCE, COMPLAINT, DELIVERY, OPEN, CLICK, RENDERING_FAILURE, DELIVERY_DELAY
    kinesis_firehose_destination: {
      iam_role_arn: "AmazonResourceName", # required
      delivery_stream_arn: "AmazonResourceName", # required
    },
    cloud_watch_destination: {
      dimension_configurations: [ # required
        {
          dimension_name: "DimensionName", # required
          dimension_value_source: "MESSAGE_TAG", # required, accepts MESSAGE_TAG, EMAIL_HEADER, LINK_TAG
          default_dimension_value: "DefaultDimensionValue", # required
        },
      ],
    },
    sns_destination: {
      topic_arn: "AmazonResourceName", # required
    },
    pinpoint_destination: {
      application_arn: "AmazonResourceName",
    },
  },
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :configuration_set_name (required, String)

    The name of the configuration set that contains the event destination that you want to modify.

  • :event_destination_name (required, String)

    The name of the event destination that you want to modify.

  • :event_destination (required, Types::EventDestinationDefinition)

    An object that defines the event destination.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3532
3533
3534
3535
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 3532

def update_configuration_set_event_destination(params = {}, options = {})
  req = build_request(:update_configuration_set_event_destination, params)
  req.send_request(options)
end

#update_custom_verification_email_template(params = {}) ⇒ Struct

Updates an existing custom verification email template.

For more information about custom verification email templates, see Using Custom Verification Email Templates in the Amazon SES Developer Guide.

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

Examples:

Request syntax with placeholder values


resp = client.update_custom_verification_email_template({
  template_name: "EmailTemplateName", # required
  from_email_address: "EmailAddress", # required
  template_subject: "EmailTemplateSubject", # required
  template_content: "TemplateContent", # required
  success_redirection_url: "SuccessRedirectionURL", # required
  failure_redirection_url: "FailureRedirectionURL", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :template_name (required, String)

    The name of the custom verification email template that you want to update.

  • :from_email_address (required, String)

    The email address that the custom verification email is sent from.

  • :template_subject (required, String)

    The subject line of the custom verification email.

  • :template_content (required, String)

    The content of the custom verification email. The total size of the email must be less than 10 MB. The message body may contain HTML, with some limitations. For more information, see Custom Verification Email Frequently Asked Questions in the Amazon SES Developer Guide.

  • :success_redirection_url (required, String)

    The URL that the recipient of the verification email is sent to if his or her address is successfully verified.

  • :failure_redirection_url (required, String)

    The URL that the recipient of the verification email is sent to if his or her address is not successfully verified.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3594
3595
3596
3597
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 3594

def update_custom_verification_email_template(params = {}, options = {})
  req = build_request(:update_custom_verification_email_template, params)
  req.send_request(options)
end

#update_email_identity_policy(params = {}) ⇒ Struct

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

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

Examples:

Request syntax with placeholder values


resp = client.update_email_identity_policy({
  email_identity: "Identity", # required
  policy_name: "PolicyName", # required
  policy: "Policy", # required
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :email_identity (required, String)

    The email identity for which you want to update policy.

  • :policy_name (required, String)

    The name of the policy.

    The policy name cannot exceed 64 characters and can only include alphanumeric characters, dashes, and underscores.

  • :policy (required, String)

    The text of the policy in JSON format. The policy cannot exceed 4 KB.

    For information about the syntax of sending authorization policies, see the Amazon SES Developer Guide.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3651
3652
3653
3654
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 3651

def update_email_identity_policy(params = {}, options = {})
  req = build_request(:update_email_identity_policy, params)
  req.send_request(options)
end

#update_email_template(params = {}) ⇒ Struct

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.

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

Examples:

Request syntax with placeholder values


resp = client.update_email_template({
  template_name: "EmailTemplateName", # required
  template_content: { # required
    subject: "EmailTemplateSubject",
    text: "EmailTemplateText",
    html: "EmailTemplateHtml",
  },
})

Parameters:

  • params (Hash) (defaults to: {})

    ({})

Options Hash (params):

  • :template_name (required, String)

    The name of the template you want to update.

  • :template_content (required, Types::EmailTemplateContent)

    The content of the email template, composed of a subject line, an HTML part, and a text-only part.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



3691
3692
3693
3694
# File 'gems/aws-sdk-sesv2/lib/aws-sdk-sesv2/client.rb', line 3691

def update_email_template(params = {}, options = {})
  req = build_request(:update_email_template, params)
  req.send_request(options)
end