Learn R Programming

paws (version 0.4.0)

ses: Amazon Simple Email Service

Description

This document contains reference information for the Amazon Simple Email Service (Amazon SES) API, version 2010-12-01. This document is best used in conjunction with the Amazon SES Developer Guide.

For a list of Amazon SES endpoints to use in service requests, see Regions and Amazon SES in the Amazon SES Developer Guide.

This documentation contains reference information related to the following:

Usage

ses(config = list(), credentials = list(), endpoint = NULL, region = NULL)

Value

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Arguments

config

Optional configuration of credentials, endpoint, and/or region.

  • credentials:

    • creds:

      • access_key_id: AWS access key ID

      • secret_access_key: AWS secret access key

      • session_token: AWS temporary session token

    • profile: The name of a profile to use. If not given, then the default profile is used.

    • anonymous: Set anonymous credentials.

    • endpoint: The complete URL to use for the constructed client.

    • region: The AWS Region used in instantiating the client.

  • close_connection: Immediately close all HTTP connections.

  • timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.

  • s3_force_path_style: Set this to true to force the request to use path-style addressing, i.e. http://s3.amazonaws.com/BUCKET/KEY.

  • sts_regional_endpoint: Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html

credentials

Optional credentials shorthand for the config parameter

  • creds:

    • access_key_id: AWS access key ID

    • secret_access_key: AWS secret access key

    • session_token: AWS temporary session token

  • profile: The name of a profile to use. If not given, then the default profile is used.

  • anonymous: Set anonymous credentials.

endpoint

Optional shorthand for complete URL to use for the constructed client.

region

Optional shorthand for AWS Region used in instantiating the client.

Service syntax

svc <- ses(
  config = list(
    credentials = list(
      creds = list(
        access_key_id = "string",
        secret_access_key = "string",
        session_token = "string"
      ),
      profile = "string",
      anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
      access_key_id = "string",
      secret_access_key = "string",
      session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

clone_receipt_rule_setCreates a receipt rule set by cloning an existing one
create_configuration_setCreates a configuration set
create_configuration_set_event_destinationCreates a configuration set event destination
create_configuration_set_tracking_optionsCreates an association between a configuration set and a custom domain for open and click event tracking
create_custom_verification_email_templateCreates a new custom verification email template
create_receipt_filterCreates a new IP address filter
create_receipt_ruleCreates a receipt rule
create_receipt_rule_setCreates an empty receipt rule set
create_templateCreates an email template
delete_configuration_setDeletes a configuration set
delete_configuration_set_event_destinationDeletes a configuration set event destination
delete_configuration_set_tracking_optionsDeletes an association between a configuration set and a custom domain for open and click event tracking
delete_custom_verification_email_templateDeletes an existing custom verification email template
delete_identityDeletes the specified identity (an email address or a domain) from the list of verified identities
delete_identity_policyDeletes the specified sending authorization policy for the given identity (an email address or a domain)
delete_receipt_filterDeletes the specified IP address filter
delete_receipt_ruleDeletes the specified receipt rule
delete_receipt_rule_setDeletes the specified receipt rule set and all of the receipt rules it contains
delete_templateDeletes an email template
delete_verified_email_addressDeprecated
describe_active_receipt_rule_setReturns the metadata and receipt rules for the receipt rule set that is currently active
describe_configuration_setReturns the details of the specified configuration set
describe_receipt_ruleReturns the details of the specified receipt rule
describe_receipt_rule_setReturns the details of the specified receipt rule set
get_account_sending_enabledReturns the email sending status of the Amazon SES account for the current Region
get_custom_verification_email_templateReturns the custom email verification template for the template name you specify
get_identity_dkim_attributesReturns the current status of Easy DKIM signing for an entity
get_identity_mail_from_domain_attributesReturns the custom MAIL FROM attributes for a list of identities (email addresses : domains)
get_identity_notification_attributesGiven a list of verified identities (email addresses and/or domains), returns a structure describing identity notification attributes
get_identity_policiesReturns the requested sending authorization policies for the given identity (an email address or a domain)
get_identity_verification_attributesGiven a list of identities (email addresses and/or domains), returns the verification status and (for domain identities) the verification token for each identity
get_send_quotaProvides the sending limits for the Amazon SES account
get_send_statisticsProvides sending statistics for the current Amazon Web Services Region
get_templateDisplays the template object (which includes the Subject line, HTML part and text part) for the template you specify
list_configuration_setsProvides a list of the configuration sets associated with your Amazon SES account in the current Amazon Web Services Region
list_custom_verification_email_templatesLists the existing custom verification email templates for your account in the current Amazon Web Services Region
list_identitiesReturns a list containing all of the identities (email addresses and domains) for your Amazon Web Services account in the current Amazon Web Services Region, regardless of verification status
list_identity_policiesReturns a list of sending authorization policies that are attached to the given identity (an email address or a domain)
list_receipt_filtersLists the IP address filters associated with your Amazon Web Services account in the current Amazon Web Services Region
list_receipt_rule_setsLists the receipt rule sets that exist under your Amazon Web Services account in the current Amazon Web Services Region
list_templatesLists the email templates present in your Amazon SES account in the current Amazon Web Services Region
list_verified_email_addressesDeprecated
put_configuration_set_delivery_optionsAdds or updates the delivery options for a configuration set
put_identity_policyAdds or updates a sending authorization policy for the specified identity (an email address or a domain)
reorder_receipt_rule_setReorders the receipt rules within a receipt rule set
send_bounceGenerates and sends a bounce message to the sender of an email you received through Amazon SES
send_bulk_templated_emailComposes an email message to multiple destinations
send_custom_verification_emailAdds an email address to the list of identities for your Amazon SES account in the current Amazon Web Services Region and attempts to verify it
send_emailComposes an email message and immediately queues it for sending
send_raw_emailComposes an email message and immediately queues it for sending
send_templated_emailComposes an email message using an email template and immediately queues it for sending
set_active_receipt_rule_setSets the specified receipt rule set as the active receipt rule set
set_identity_dkim_enabledEnables or disables Easy DKIM signing of email sent from an identity
set_identity_feedback_forwarding_enabledGiven an identity (an email address or a domain), enables or disables whether Amazon SES forwards bounce and complaint notifications as email
set_identity_headers_in_notifications_enabledGiven an identity (an email address or a domain), sets whether Amazon SES includes the original email headers in the Amazon Simple Notification Service (Amazon SNS) notifications of a specified type
set_identity_mail_from_domainEnables or disables the custom MAIL FROM domain setup for a verified identity (an email address or a domain)
set_identity_notification_topicSets an Amazon Simple Notification Service (Amazon SNS) topic to use when delivering notifications
set_receipt_rule_positionSets the position of the specified receipt rule in the receipt rule set
test_render_templateCreates a preview of the MIME content of an email when provided with a template and a set of replacement data
update_account_sending_enabledEnables or disables email sending across your entire Amazon SES account in the current Amazon Web Services Region
update_configuration_set_event_destinationUpdates the event destination of a configuration set
update_configuration_set_reputation_metrics_enabledEnables or disables the publishing of reputation metrics for emails sent using a specific configuration set in a given Amazon Web Services Region
update_configuration_set_sending_enabledEnables or disables email sending for messages sent using a specific configuration set in a given Amazon Web Services Region
update_configuration_set_tracking_optionsModifies an association between a configuration set and a custom domain for open and click event tracking
update_custom_verification_email_templateUpdates an existing custom verification email template
update_receipt_ruleUpdates a receipt rule
update_templateUpdates an email template
verify_domain_dkimReturns a set of DKIM tokens for a domain identity
verify_domain_identityAdds a domain to the list of identities for your Amazon SES account in the current Amazon Web Services Region and attempts to verify it
verify_email_addressDeprecated
verify_email_identityAdds an email address to the list of identities for your Amazon SES account in the current Amazon Web Services Region and attempts to verify it

Examples

Run this code
if (FALSE) {
svc <- ses()
# The following example creates a receipt rule set by cloning an existing
# one:
svc$clone_receipt_rule_set(
  OriginalRuleSetName = "RuleSetToClone",
  RuleSetName = "RuleSetToCreate"
)
}

Run the code above in your browser using DataLab