|
Amazon SES - List identities |
Declaration
<AMAWSSES ACTIVITY="list_identities" PROVIDER="session_based" SESSION="text" ACCESSKEY="text" SECRETKEY="text (encrypted)" USERAGENT="text" MAXERRORRETRY="number" SERVICEURL="text" PROXYHOST="text" PROXYPORT="number" PROXYUSER="text" PROXYPWD="text (encrypted)" SIGNMETHOD="text" SIGNVERSION="number" RESULTDATASET="text" />
Description
Retrieves a list containing all of the identities (email addresses and domains) for a specific AWS account, regardless of verification status, and populates a dataset with the results.
Practical Usage
Can be used to retrieve a list of identities in which to loop through with the use of a Loop - Dataset activity. During the loop process, specific activities can be performed one at a time on each identity found on the list. An If activity can be used within a Loop/End Loop process to add further intelligence to the task. For example, you can use the Amazon SES - Verify identity activity to determine which identities are in the list are invalid and use the Amazon SES - Delete identity activity to delete unidentified or invalid identities.
Parameters
Connection
Property | Type | Required | Default | Markup | Description |
---|---|---|---|---|---|
Connection | --- | --- | --- | --- | Indicates
where Amazon Web Service user credentials and preferences should
originate from. This is a design mode parameter used only during
task construction and configuration, thus, comprises no markup.
The available options are:
|
Session | Text | Yes, if Connection is set to Session | SESSession1 | SESSION="SESSession1" | The name of an existing session to attach this activity to. This parameter is active only if the Connection parameter is set to Session. The default session name is SESSession1. |
Access key | Text | Yes, if Connection is set to Host | (Empty) | ACCESSKEY="022QF06E7MXBSH9DHM02" | A 20-character alphanumeric string that uniquely identifies the owner of the AWS service account, similar to a username. This key along with a corresponding secret access key forms a secure information set that AWS uses to confirm a valid user's identity. This parameter is active only if the Connection parameter is set to Host. |
Secret access key | Text | Yes, if Connection is set to Host | (Empty) | SECRETKEY="text (encrypted)" | A 40-character string that serves the role as password to access the AWS service account. This along with an associated access key forms a secure information set that EC2 uses to confirm a valid user's identity. This parameter is active only if the Connection parameter is set to Host. |
User agent | Text | No | Automate | USERAGENT="Automate" | The name of the client or application initiating requests to AWS. The default value is Automate. |
Maximum number of retries on error | Number | No | (Empty) | MAXERRORRETRY="4" | The total amount of times this activity should retry its request to the server before returning an error. Network components can generate errors anytime in the life of a request, thus, implementing retries can increase reliability. |
Service URL | Text | No | (Empty) | SERVICEURL="email.us-east-1.amazonaws.com" | The URL that provides the service endpoint. A complete list of EC2 regions, accompanying endpoints and valid protocols can be found below under Amazon SES Endpoints and Regions |
Proxy host | Text | No | (Empty) | PROXYHOST="proxy.host.com" | The host name (for example, server.domain.com) or IP address (for example, xxx.xxx.xxx.xxx) of the proxy server to use when connecting to AWS. |
Proxy port | Number | No | (Empty) | PROXYPORT="1028" | The port to use to connect to the proxy server. |
Proxy username | Text | No | (Empty) | PROXYUSER="username" | The username to authenticate the connection with the proxy server (if required). |
Proxy password | Text | No | (Empty) | PROXYPWD="text (encrypted)" | The password that should be used to authenticate connection with the proxy server (if required). |
Signature method | Text | No | (Empty) | SIGNMETHOD="HmacSHA256" | The signature method to use for signing the request. This provides a valid hashing algorithm for signature calculation. Valid AWS signature methods are HmacSHA1 and HmacSHA256. |
Signature version | Number | No | (Empty) | SIGNVERSION="2" | The signature version for signing the request. Valid AWS signature versions are 2 and 4. The difference with version 4 is that it allows you to sign your message using a key that is derived from your secret access key rather than using the secret access key itself. |
Identity
Property | Type | Required | Default | Markup | Description |
---|---|---|---|---|---|
Create and populate dataset with identity information | Text | Yes | (Empty) | RESULTDATASET="identitydata" | The name of the dataset to create and populate with information identity names and types. For more details, see Datasets below. |
Additional Notes
Amazon SES Endpoints and Regions
This table contains a complete list of Amazon SES endpoints, along with their corresponding regions and supported protocols.
Endpoint | Region | Protocol |
---|---|---|
email.us-east-1.amazonaws.com | US East (Northern Virginia) Region | HTTPS |
email-smtp.us-east-1.amazonaws.com, port 465 | US East (Northern Virginia) Region | SMTP |
Datasets
A dataset is a multi-column, multi-row object that contains a collection of information gathered during runtime and stored in memory. This activity creates and populates a dataset with the following fields (rows):
Name | Type | Return Value |
---|---|---|
theDataset.Identity | Text | The identity (for example, recipient@domain.com). |
theDataset.Type | Text | The type of identity currently listed. Possible values are "EmailAddress" and "Domain." |
Example
- The sample AML code below can be copied and pasted directly into the Steps Panel of the Task Builder.
- Parameters containing user credentials, files, file paths, and/or other information specific to the task must be customized before the sample code can run successfully.
Description
This sample task populates a dataset with a list of identities. The dataset is looped and within each iteration, the current identity is verified. Once the loop is finished, the session is ended.
<!-- Create AWS SES session "SESVerify". Access key is "AKIAJ25JAKOPAC7GSQ7A". -->
<AMAWSSES ACTIVITY="create_session" SESSION="SESVerify" ACCESSKEY="AKIAJ25JAKOPAC7GSQ7A" SECRETKEY="AM3i6P77pVEBOw=aME" />
<!-- List identity information into automate dataset "IDList". Session is "SESVerify". -->
<AMAWSSES ACTIVITY="list_identities" PROVIDER="session_based" SESSION="SESVerify" RESULTDATSET="IDList" />
<!-- Loop through dataset "IDList". -->
<AMLOOP ACTIVITY="dataset" DATASET="IDList">
<!-- If "%IDList.Type%=EmailAddress", then... -->
<AMIF EXPRESSION="%IDList.Type%=EmailAddress">
<!-- Verify identity "%IDList.Identity%" of type EmailAddress. Session is "SESVerify". -->
<AMAWSSES ACTIVITY="verify_identity" PROVIDER="session_based" SESSION="SESVerify" IDENTITY="%IDList.Identity%" />
<!-- End if. -->
</AMIF>
<!-- End loop. -->
</AMLOOP>
<!-- End AWS SES session "SESVerify". -->
<AMAWSSES ACTIVITY="end_session" SESSION="SESVerify" />