You are viewing documentation for version 1 of the AWS SDK for Ruby. Version 2 documentation can be found here.

Class: AWS::SimpleEmailService::Client

Inherits:
Core::QueryClient show all
Defined in:
lib/aws/simple_email_service/client.rb

Overview

Client class for Amazon Simple E-mail Service (SES).

Direct Known Subclasses

V20101201

Defined Under Namespace

Classes: V20101201

Constant Summary

API_VERSION =
'2010-12-01'
REGION_US_E1 =
'email.us-east-1.amazonaws.com'

Instance Attribute Summary

Attributes inherited from Core::Client

#config

Instance Method Summary collapse

Methods inherited from Core::Client

#initialize, #log_warning, #operations, #with_http_handler, #with_options

Constructor Details

This class inherits a constructor from AWS::Core::Client

Instance Method Details

#delete_identity(options = {}) ⇒ Core::Response

Calls the DeleteIdentity API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :identity - required - (String) The identity to be removed from the list of identities for the AWS Account.

Returns:

#delete_verified_email_address(options = {}) ⇒ Core::Response

Calls the DeleteVerifiedEmailAddress API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :email_address - required - (String) An email address to be removed from the list of verified addresses.

Returns:

#get_identity_dkim_attributes(options = {}) ⇒ Core::Response

Calls the GetIdentityDkimAttributes API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :identities - required - (Array<) A list of one or more verified identities - email addresses, domains, or both.

Returns:

  • (Core::Response)

    The #data method of the response object returns a hash with the following structure:

    • :dkim_attributes - (Hash<String,Hash>)
      • :dkim_enabled - (Boolean)
      • :dkim_verification_status - (String)
      • :dkim_tokens - (Array)

#get_identity_notification_attributes(options = {}) ⇒ Core::Response

Calls the GetIdentityNotificationAttributes API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :identities - required - (Array<) A list of one or more identities.

Returns:

  • (Core::Response)

    The #data method of the response object returns a hash with the following structure:

    • :notification_attributes - (Hash<String,Hash>)
      • :bounce_topic - (String)
      • :complaint_topic - (String)
      • :delivery_topic - (String)
      • :forwarding_enabled - (Boolean)

#get_identity_verification_attributes(options = {}) ⇒ Core::Response

Calls the GetIdentityVerificationAttributes API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :identities - required - (Array<) A list of identities.

Returns:

  • (Core::Response)

    The #data method of the response object returns a hash with the following structure:

    • :verification_attributes - (Hash<String,Hash>)
      • :verification_status - (String)
      • :verification_token - (String)

#get_send_quota(options = {}) ⇒ Core::Response

Calls the GetSendQuota API operation.

Parameters:

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

Returns:

  • (Core::Response)

    The #data method of the response object returns a hash with the following structure:

    • :max_24_hour_send - (Numeric)
    • :max_send_rate - (Numeric)
    • :sent_last_24_hours - (Numeric)

#get_send_statistics(options = {}) ⇒ Core::Response

Calls the GetSendStatistics API operation.

Parameters:

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

Returns:

  • (Core::Response)

    The #data method of the response object returns a hash with the following structure:

    • :send_data_points - (Array)
      • :timestamp - (Time)
      • :delivery_attempts - (Integer)
      • :bounces - (Integer)
      • :complaints - (Integer)
      • :rejects - (Integer)

#list_identities(options = {}) ⇒ Core::Response

Calls the ListIdentities API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :identity_type - (String) The type of the identities to list. Possible values are "EmailAddress" and "Domain". If this parameter is omitted, then all identities will be listed. Valid values include:
      • EmailAddress
      • Domain
    • :next_token - (String) The token to use for pagination.
    • :max_items - (Integer) The maximum number of identities per page. Possible values are 1-100 inclusive.

Returns:

  • (Core::Response)

    The #data method of the response object returns a hash with the following structure:

    • :identities - (Array)
    • :next_token - (String)

#list_verified_email_addresses(options = {}) ⇒ Core::Response

Calls the ListVerifiedEmailAddresses API operation.

Parameters:

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

Returns:

  • (Core::Response)

    The #data method of the response object returns a hash with the following structure:

    • :verified_email_addresses - (Array)

#send_email(options = {}) ⇒ Core::Response

Calls the SendEmail API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :source - required - (String) The identity's email address. By default, the string must be 7-bit ASCII. If the text must contain any other characters, then you must use MIME encoded-word syntax (RFC 2047) instead of a literal string. MIME encoded-word syntax uses the following form: =?charset?encoding?encoded-text?=. For more information, see RFC 2047.
    • :destination - required - (Hash) The destination for this email, composed of To:, CC:, and BCC: fields.
      • :to_addresses - (Array<) The To: field(s) of the message.
      • :cc_addresses - (Array<) The CC: field(s) of the message.
      • :bcc_addresses - (Array<) The BCC: field(s) of the message.
    • :message - required - (Hash) The message to be sent.
      • :subject - required - (Hash) The subject of the message: A short summary of the content, which will appear in the recipient's inbox.
        • :data - required - (String) The textual data of the content.
        • :charset - (String) The character set of the content.
      • :body - required - (Hash) The message body.
        • :text - (Hash) The content of the message, in text format. Use this for text-based email clients, or clients on high-latency networks (such as mobile devices).
          • :data - required - (String) The textual data of the content.
          • :charset - (String) The character set of the content.
        • :html - (Hash) The content of the message, in HTML format. Use this for email clients that can process HTML. You can include clickable links, formatted text, and much more in an HTML message.
          • :data - required - (String) The textual data of the content.
          • :charset - (String) The character set of the content.
    • :reply_to_addresses - (Array<) The reply-to email address(es) for the message. If the recipient replies to the message, each reply-to address will receive the reply.
    • :return_path - (String) The email address to which bounces and complaints are to be forwarded when feedback forwarding is enabled. If the message cannot be delivered to the recipient, then an error message will be returned from the recipient's ISP; this message will then be forwarded to the email address specified by the ReturnPath parameter.

Returns:

  • (Core::Response)

    The #data method of the response object returns a hash with the following structure:

    • :message_id - (String)

#send_raw_email(options = {}) ⇒ Core::Response

Calls the SendRawEmail API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :source - (String) The identity's email address. By default, the string must be 7-bit ASCII. If the text must contain any other characters, then you must use MIME encoded-word syntax (RFC 2047) instead of a literal string. MIME encoded-word syntax uses the following form: =?charset?encoding?encoded-text?=. For more information, see RFC 2047. If you specify the Source parameter and have feedback forwarding enabled, then bounces and complaints will be sent to this email address. This takes precedence over any Return-Path header that you might include in the raw text of the message.
    • :destinations - (Array<) A list of destinations for the message, consisting of To:, CC:, and BCC: addresses.
    • :raw_message - required - (Hash) The raw text of the message. The client is responsible for ensuring the following: Message must contain a header and a body, separated by a blank line. All required header fields must be present. Each part of a multipart MIME message must be formatted properly. MIME content types must be among those supported by Amazon SES. For more information, go to the Amazon SES Developer Guide. Content must be base64-encoded, if MIME requires it.
      • :data - required - (String) The raw data of the message. The client must ensure that the message format complies with Internet email standards regarding email header fields, MIME types, MIME encoding, and base64 encoding (if necessary). The To:, CC:, and BCC: headers in the raw message can contain a group list. For more information, go to the Amazon SES Developer Guide.

Returns:

  • (Core::Response)

    The #data method of the response object returns a hash with the following structure:

    • :message_id - (String)

#set_identity_dkim_enabled(options = {}) ⇒ Core::Response

Calls the SetIdentityDkimEnabled API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :identity - required - (String) The identity for which DKIM signing should be enabled or disabled.
    • :dkim_enabled - required - (Boolean) Sets whether DKIM signing is enabled for an identity. Set to true to enable DKIM signing for this identity; false to disable it.

Returns:

#set_identity_feedback_forwarding_enabled(options = {}) ⇒ Core::Response

Calls the SetIdentityFeedbackForwardingEnabled API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :identity - required - (String) The identity for which to set bounce and complaint notification forwarding. Examples: user@example.com, example.com.
    • :forwarding_enabled - required - (Boolean) Sets whether Amazon SES will forward bounce and complaint notifications as email. true specifies that Amazon SES will forward bounce and complaint notifications as email, in addition to any Amazon SNS topic publishing otherwise specified. false specifies that Amazon SES will publish bounce and complaint notifications only through Amazon SNS. This value can only be set to false when Amazon SNS topics are set for both Bounce and Complaint notification types.

Returns:

#set_identity_notification_topic(options = {}) ⇒ Core::Response

Calls the SetIdentityNotificationTopic API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :identity - required - (String) The identity for which the Amazon SNS topic will be set. Examples: user@example.com, example.com.
    • :notification_type - required - (String) The type of notifications that will be published to the specified Amazon SNS topic. Valid values include:
      • Bounce
      • Complaint
      • Delivery
    • :sns_topic - (String) The Amazon Resource Name (ARN) of the Amazon SNS topic. If the parameter is omitted from the request or a null value is passed, SnsTopic is cleared and publishing is disabled.

Returns:

#verify_domain_dkim(options = {}) ⇒ Core::Response

Calls the VerifyDomainDkim API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :domain - required - (String) The name of the domain to be verified for Easy DKIM signing.

Returns:

  • (Core::Response)

    The #data method of the response object returns a hash with the following structure:

    • :dkim_tokens - (Array)

#verify_domain_identity(options = {}) ⇒ Core::Response

Calls the VerifyDomainIdentity API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :domain - required - (String) The domain to be verified.

Returns:

  • (Core::Response)

    The #data method of the response object returns a hash with the following structure:

    • :verification_token - (String)

#verify_email_address(options = {}) ⇒ Core::Response

Calls the VerifyEmailAddress API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :email_address - required - (String) The email address to be verified.

Returns:

#verify_email_identity(options = {}) ⇒ Core::Response

Calls the VerifyEmailIdentity API operation.

Parameters:

  • options (Hash) (defaults to: {})
    • :email_address - required - (String) The email address to be verified.

Returns: