Amazon Simple Email Service

Set the pricing plan for your Amazon SES account. Use this operation to choose a billing plan that packages multiple Amazon SES features at a single rate.

See also: AWS API Documentation

Request Syntax

client.put_account_pricing_attributes(
    Plan='NONE'|'ESSENTIALS'|'PRO'|'ENTERPRISE'
)

type Plan:

string

param Plan:

[REQUIRED]

The pricing plan to apply to your Amazon SES account. Can be one of the following:

• NONE – No pricing plan is applied; billing follows per-feature pricing.

• ESSENTIALS – Baseline Amazon SES capabilities and select premium features.

• PRO – Includes everything in ESSENTIALS, plus additional premium features for growing senders.

• ENTERPRISE – Includes everything in PRO, plus features intended for large-scale senders.

rtype:

dict

returns:

Response Syntax

{}

Response Structure

• (dict) --

  An HTTP 200 response if the request succeeds, or an error response if the request fails.

{'PricingAttributes': {'CurrentPlan': 'NONE | ESSENTIALS | PRO | ENTERPRISE',
                       'NextPlan': 'NONE | ESSENTIALS | PRO | ENTERPRISE'}}

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

See also: AWS API Documentation

Request Syntax

client.get_account()

rtype:

dict

returns:

Response Syntax

{
    'DedicatedIpAutoWarmupEnabled': True|False,
    'EnforcementStatus': 'string',
    'ProductionAccessEnabled': True|False,
    'SendQuota': {
        'Max24HourSend': 123.0,
        'MaxSendRate': 123.0,
        'SentLast24Hours': 123.0
    },
    'SendingEnabled': True|False,
    'SuppressionAttributes': {
        'SuppressedReasons': [
            'BOUNCE'|'COMPLAINT',
        ],
        'ValidationAttributes': {
            'ConditionThreshold': {
                'ConditionThresholdEnabled': 'ENABLED'|'DISABLED',
                'OverallConfidenceThreshold': {
                    'ConfidenceVerdictThreshold': 'MEDIUM'|'HIGH'|'MANAGED'
                }
            }
        }
    },
    'Details': {
        'MailType': 'MARKETING'|'TRANSACTIONAL',
        'WebsiteURL': 'string',
        'ContactLanguage': 'EN'|'JA',
        'UseCaseDescription': 'string',
        'AdditionalContactEmailAddresses': [
            'string',
        ],
        'ReviewDetails': {
            'Status': 'PENDING'|'FAILED'|'GRANTED'|'DENIED',
            'CaseId': 'string'
        }
    },
    'VdmAttributes': {
        'VdmEnabled': 'ENABLED'|'DISABLED',
        'DashboardAttributes': {
            'EngagementMetrics': 'ENABLED'|'DISABLED'
        },
        'GuardianAttributes': {
            'OptimizedSharedDelivery': 'ENABLED'|'DISABLED'
        }
    },
    'PricingAttributes': {
        'CurrentPlan': 'NONE'|'ESSENTIALS'|'PRO'|'ENTERPRISE',
        'NextPlan': 'NONE'|'ESSENTIALS'|'PRO'|'ENTERPRISE'
    }
}

Response Structure

• (dict) --

  A list of details about the email-sending capabilities of your Amazon SES account in the current Amazon Web Services Region.

  • DedicatedIpAutoWarmupEnabled (boolean) --

    Indicates whether or not the automatic warm-up feature is enabled for dedicated IP addresses that are associated with your account.

  • EnforcementStatus (string) --

    The reputation status of your Amazon SES account. The status can be one of the following:

    • HEALTHY – There are no reputation-related issues that currently impact your account.

    • PROBATION – We've identified potential issues with your Amazon SES account. We're placing your account under review while you work on correcting these issues.

    • SHUTDOWN – Your account's ability to send email is currently paused because of an issue with the email sent from your account. When you correct the issue, you can contact us and request that your account's ability to send email is resumed.

  • ProductionAccessEnabled (boolean) --

    Indicates whether or not your account has production access in the current Amazon Web Services 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.

    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.

  • SendQuota (dict) --

    An object that contains information about the per-day and per-second sending limits for your Amazon SES account in the current Amazon Web Services Region.

    • Max24HourSend (float) --

      The maximum number of emails that you can send in the current Amazon Web Services Region over a 24-hour period. A value of -1 signifies an unlimited quota. (This value is also referred to as your sending quota.)

    • MaxSendRate (float) --

      The maximum number of emails that you can send per second in the current Amazon Web Services Region. This value is also called your maximum sending rate or your maximum TPS (transactions per second) rate.

    • SentLast24Hours (float) --

      The number of emails sent from your Amazon SES account in the current Amazon Web Services Region over the past 24 hours.

  • SendingEnabled (boolean) --

    Indicates whether or not email sending is enabled for your Amazon SES account in the current Amazon Web Services Region.

  • SuppressionAttributes (dict) --

    An object that contains information about the email address suppression preferences for your account in the current Amazon Web Services Region.

    • SuppressedReasons (list) --

      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.

      • (string) --

        The reason that the address was added to the suppression list for your account or for a specific tenant. The value can be one of the following:

        • COMPLAINT – Amazon SES added an email address to the suppression list for your account or for a specific tenant because a message sent to that address results in a complaint.

        • BOUNCE – Amazon SES added an email address to the suppression list for your account or for a specific tenant because a message sent to that address results in a hard bounce.

    • ValidationAttributes (dict) --

      Structure containing validation attributes used for suppressing sending to specific destination on account level.

      • ConditionThreshold (dict) --

        Specifies the condition threshold settings for account-level suppression.

        • ConditionThresholdEnabled (string) --

          Indicates whether Auto Validation is enabled for suppression. Set to ENABLED to enable the Auto Validation feature, or set to DISABLED to disable it.

        • OverallConfidenceThreshold (dict) --

          The overall confidence threshold used to determine suppression decisions.

          • ConfidenceVerdictThreshold (string) --

            The confidence level threshold for suppression decisions.

  • Details (dict) --

    An object that defines your account details.

    • MailType (string) --

      The type of email your account is sending. The mail type can be one of the following:

      • MARKETING – Most of your sending traffic is to keep your customers informed of your latest offering.

      • TRANSACTIONAL – Most of your sending traffic is to communicate during a transaction with a customer.

    • WebsiteURL (string) --

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

    • ContactLanguage (string) --

      The language you would prefer for the case. The contact language can be one of ENGLISH or JAPANESE.

    • UseCaseDescription (string) --

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

    • AdditionalContactEmailAddresses (list) --

      Additional email addresses where updates are sent about your account review process.

      • (string) --

    • ReviewDetails (dict) --

      Information about the review of the latest details you submitted.

      • Status (string) --

        The status of the latest review of your account. The status can be one of the following:

        • PENDING – We have received your appeal and are in the process of reviewing it.

        • GRANTED – Your appeal has been reviewed and your production access has been granted.

        • DENIED – Your appeal has been reviewed and your production access has been denied.

        • FAILED – An internal error occurred and we didn't receive your appeal. You can submit your appeal again.

      • CaseId (string) --

        The associated support center case ID (if any).

  • VdmAttributes (dict) --

    The VDM attributes that apply to your Amazon SES account.

    • VdmEnabled (string) --

      Specifies the status of your VDM configuration. Can be one of the following:

      • ENABLED – Amazon SES enables VDM for your account.

      • DISABLED – Amazon SES disables VDM for your account.

    • DashboardAttributes (dict) --

      Specifies additional settings for your VDM configuration as applicable to the Dashboard.

      • EngagementMetrics (string) --

        Specifies the status of your VDM engagement metrics collection. Can be one of the following:

        • ENABLED – Amazon SES enables engagement metrics for your account.

        • DISABLED – Amazon SES disables engagement metrics for your account.

    • GuardianAttributes (dict) --

      Specifies additional settings for your VDM configuration as applicable to the Guardian.

      • OptimizedSharedDelivery (string) --

        Specifies the status of your VDM optimized shared delivery. Can be one of the following:

        • ENABLED – Amazon SES enables optimized shared delivery for your account.

        • DISABLED – Amazon SES disables optimized shared delivery for your account.

  • PricingAttributes (dict) --

    The pricing attributes that apply to your Amazon SES account, including the currently active pricing plan and any scheduled change.

    • CurrentPlan (string) --

      The pricing plan that is currently active on your Amazon SES account.

    • NextPlan (string) --

      The pricing plan that will become active at the start of the next billing cycle, if a scheduled change has been requested. This field is empty when no scheduled change is pending.