Actions AWS SES

Cette page fournit une référence pour les actions AWS Simple Email Service (SES) disponibles dans le catalogue des actions d’automatisation des workflows. Utilisez ces actions pour créer, mettre à jour, récupérer, et supprimer des modèles d’e-mails, et pour envoyer des e-mails via Amazon SES.

Prérequis

Pour les prérequis et la configuration des identifiants, consultez Configurer les identifiants AWS.

Créer un modèle

L’identifiant de l’action est aws.ses.createTemplate.

Crée un modèle d’e-mail dans Amazon SES pour l’envoi d’e-mails basés sur un modèle.

Important

Au moins textPart ou htmlPart doit être fourni. SES exige que le modèle contienne un corps de texte dans au moins un format.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir	Type	Description	Exemple
`awsRoleArn`	Chaîne	Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Chaîne	Facultatif. ID de clé d’accès AWS. Passer en tant que secret.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Chaîne	Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Chaîne	Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.	`${{ :secrets:awsSessionToken }}`
`region`	Chaîne	Obligatoire. Région AWS où le modèle sera créé.	`us-east-2`
`templateName`	Chaîne	Obligatoire. Nom du modèle à créer.	`WelcomeEmailTemplate`
`subjectPart`	Chaîne	Obligatoire. Ligne d’objet pour les e-mails envoyés avec ce modèle. Prend en charge les variables de modèle utilisant la syntaxe `{{variableName}}` .	`Welcome to Our Service`
`textPart`	Chaîne	Facultatif. Version en texte brut du corps de l’e-mail. Au moins l’un des éléments `textPart` ou `htmlPart` doit être fourni.	`Hello, welcome aboard.`
`htmlPart`	Chaîne	Facultatif. Version HTML du corps de l'e-mail. Au moins l’un des éléments `textPart` ou `htmlPart` doit être fourni.	`<h1>Hello</h1><p>Welcome aboard.</p>`
`selectors`	List	Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.	`[{"name": "created", "expression": ".success"}]`

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir	Type	Exemple
`response`	Objet	Consultez la référence boto3 create_template . Renvoie un objet vide `{}` en cas de succès.
`success`	Booléen	`true` ou `false`
`errorMessage`	Chaîne	`"An error occurred (AlreadyExistsException) when calling the CreateTemplate operation: Template WelcomeEmailTemplate already exists"`

Sortir

Type

Exemple

response

Objet

Consultez la

référence boto3 create_template

. Renvoie un objet vide

{}

en cas de succès.

success

Booléen

true

false

errorMessage

Chaîne

"An error occurred (AlreadyExistsException) when calling the CreateTemplate operation: Template WelcomeEmailTemplate already exists"

Exemple de workflow

name: create-ses-template
description: 'Create an email template in Amazon SES'
steps:
  - name: createWelcomeTemplate
    type: action
    action: aws.ses.createTemplate
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: us-east-2
      templateName: WelcomeEmailTemplate
      subjectPart: "Welcome to Our Service"
      textPart: "Hello, welcome aboard."
      htmlPart: "<h1>Hello</h1><p>Welcome aboard.</p>"
    next: end

Mettre à jour un modèle

L’identifiant de l’action est aws.ses.updateTemplate.

Met à jour un modèle d’e-mail existant dans Amazon SES. Le modèle doit déjà exister.

Important

Au moins textPart ou htmlPart doit être fourni. SES exige que le modèle contienne un corps de texte dans au moins un format.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir	Type	Description	Exemple
`awsRoleArn`	Chaîne	Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Chaîne	Facultatif. ID de clé d’accès AWS. Passer en tant que secret.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Chaîne	Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Chaîne	Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.	`${{ :secrets:awsSessionToken }}`
`region`	Chaîne	Obligatoire. Région AWS où le modèle existe.	`us-east-2`
`templateName`	Chaîne	Obligatoire. Nom du modèle à mettre à jour. Doit déjà exister.	`WelcomeEmailTemplate`
`subjectPart`	Chaîne	Obligatoire. Ligne d’objet mise à jour. Prend en charge les variables de modèle utilisant la syntaxe `{{variableName}}` .	`Welcome to Our Service (Updated)`
`textPart`	Chaîne	Facultatif. Version en texte brut mise à jour du corps de l'e-mail. Au moins `textPart` ou `htmlPart` doit être fourni.	`Hi, thanks again for signing up.`
`htmlPart`	Chaîne	Facultatif. Version HTML mise à jour du corps de l’e-mail. Au moins `textPart` ou `htmlPart` doit être fourni.	`<h1>Welcome!</h1><p>Thanks again for signing up.</p>`
`selectors`	List	Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.	`[{"name": "updated", "expression": ".success"}]`

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir	Type	Exemple
`response`	Objet	Consultez la référence boto3 update_template . Renvoie un objet vide `{}` en cas de succès.
`success`	Booléen	`true` ou `false`
`errorMessage`	Chaîne	`"An error occurred (TemplateDoesNotExistException) when calling the UpdateTemplate operation: Template (WelcomeEmailTemplate) does not exist"`

Sortir

Type

Exemple

response

Objet

Consultez la

référence boto3 update_template

. Renvoie un objet vide

{}

en cas de succès.

success

Booléen

true

false

errorMessage

Chaîne

"An error occurred (TemplateDoesNotExistException) when calling the UpdateTemplate operation: Template (WelcomeEmailTemplate) does not exist"

Exemple de workflow

name: update-ses-template
description: 'Update an email template in Amazon SES'
steps:
  - name: updateWelcomeTemplate
    type: action
    action: aws.ses.updateTemplate
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: us-east-2
      templateName: WelcomeEmailTemplate
      subjectPart: "Welcome to Our Service (Updated)"
      textPart: "Hi, thanks again for signing up."
      htmlPart: "<h1>Welcome!</h1><p>Thanks again for signing up.</p>"
    next: end

Supprimer un modèle

L’identifiant de l’action est aws.ses.deleteTemplate.

Supprime un modèle d’e-mail d’Amazon SES. Cette action est idempotente : elle réussit même si le modèle nommé n’existe pas.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir	Type	Description	Exemple
`awsRoleArn`	Chaîne	Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Chaîne	Facultatif. ID de clé d’accès AWS. Passer en tant que secret.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Chaîne	Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Chaîne	Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.	`${{ :secrets:awsSessionToken }}`
`region`	Chaîne	Obligatoire. Région AWS où le modèle existe.	`us-east-2`
`templateName`	Chaîne	Obligatoire. Nom du modèle à supprimer.	`WelcomeEmailTemplate`
`selectors`	List	Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.	`[{"name": "deleted", "expression": ".success"}]`

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir	Type	Exemple
`response`	Objet	Consultez la référence boto3 delete_template . Renvoie un objet vide `{}` en cas de succès.
`success`	Booléen	`true` ou `false`
`errorMessage`	Chaîne	`"An error occurred (AccessDenied) when calling the DeleteTemplate operation: User is not authorized to perform ses:DeleteTemplate"`

Sortir

Type

Exemple

response

Objet

Consultez la

référence boto3 delete_template

. Renvoie un objet vide

{}

en cas de succès.

success

Booléen

true

false

errorMessage

Chaîne

"An error occurred (AccessDenied) when calling the DeleteTemplate operation: User is not authorized to perform ses:DeleteTemplate"

Exemple de workflow

name: delete-ses-template
description: 'Delete an email template from Amazon SES'
steps:
  - name: deleteWelcomeTemplate
    type: action
    action: aws.ses.deleteTemplate
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: us-east-2
      templateName: WelcomeEmailTemplate
    next: end

Obtenir un modèle

L’identifiant de l’action est aws.ses.getTemplate.

Récupère un modèle d’e-mail existant depuis Amazon SES, y compris son objet, son corps en texte brut, et son corps HTML.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir	Type	Description	Exemple
`awsRoleArn`	Chaîne	Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Chaîne	Facultatif. ID de clé d’accès AWS. Passer en tant que secret.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Chaîne	Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Chaîne	Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.	`${{ :secrets:awsSessionToken }}`
`region`	Chaîne	Obligatoire. Région AWS où le modèle existe.	`us-east-2`
`templateName`	Chaîne	Obligatoire. Nom du modèle à récupérer.	`WelcomeEmailTemplate`
`selectors`	List	Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.	`[{"name": "template", "expression": ".response.Template"}]`

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir	Type	Exemple
`response`	Objet	Consultez la référence boto3 get_template . Contient un objet `Template` avec `TemplateName` , `SubjectPart` , `TextPart` , et `HtmlPart` .
`success`	Booléen	`true` ou `false`
`errorMessage`	Chaîne	`"An error occurred (TemplateDoesNotExistException) when calling the GetTemplate operation: Template (WelcomeEmailTemplate) does not exist"`

Sortir

Type

Exemple

response

Objet

Consultez la

référence boto3 get_template

. Contient un objet

Template

avec

TemplateName

SubjectPart

TextPart

, et

HtmlPart

success

Booléen

true

false

errorMessage

Chaîne

"An error occurred (TemplateDoesNotExistException) when calling the GetTemplate operation: Template (WelcomeEmailTemplate) does not exist"

Exemple de workflow

name: get-ses-template
description: 'Retrieve an email template from Amazon SES'
steps:
  - name: getWelcomeTemplate
    type: action
    action: aws.ses.getTemplate
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: us-east-2
      templateName: WelcomeEmailTemplate
      selectors:
        - name: template
          expression: ".response.Template"
    next: end

Lister les modèles

L’identifiant de l’action est aws.ses.listTemplates.

Répertorie les modèles d’e-mail présents dans votre compte Amazon SES dans la région actuelle.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir	Type	Description	Exemple
`awsRoleArn`	Chaîne	Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Chaîne	Facultatif. ID de clé d’accès AWS. Passer en tant que secret.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Chaîne	Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Chaîne	Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.	`${{ :secrets:awsSessionToken }}`
`region`	Chaîne	Obligatoire. Région AWS à partir de laquelle lister les modèles.	`us-east-2`
`maxItems`	Entier	Facultatif. Nombre maximal de modèles à renvoyer par page. Doit être compris entre 1 et 100. La valeur par défaut est 10.	`50`
`nextToken`	Chaîne	Facultatif. Jeton de pagination d'une réponse précédente pour récupérer la page de résultats suivante.	`some-pagination-token`
`selectors`	List	Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.	`[{"name": "templates", "expression": ".response.TemplatesMetadata"}]`

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir	Type	Exemple
`response`	Objet	Consultez la référence boto3 list_templates . Contient un éventail `TemplatesMetadata` d’objets avec `Name` et `CreatedTimestamp` , ainsi qu’un `NextToken` pour la pagination.
`success`	Booléen	`true` ou `false`
`errorMessage`	Chaîne	`"An error occurred (AccessDenied) when calling the ListTemplates operation: User is not authorized to perform ses:ListTemplates"`

Sortir

Type

Exemple

response

Objet

Consultez la

référence boto3 list_templates

. Contient un éventail

TemplatesMetadata

d’objets avec

Name

CreatedTimestamp

, ainsi qu’un

NextToken

pour la pagination.

success

Booléen

true

false

errorMessage

Chaîne

"An error occurred (AccessDenied) when calling the ListTemplates operation: User is not authorized to perform ses:ListTemplates"

Exemple de workflow

name: list-ses-templates
description: 'List email templates in Amazon SES'
steps:
  - name: listSesTemplates
    type: action
    action: aws.ses.listTemplates
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: us-east-2
      maxItems: 50
      selectors:
        - name: templates
          expression: ".response.TemplatesMetadata"
    next: end

Envoyer un e-mail

L’identifiant de l’action est aws.ses.sendEmail.

Envoie un e-mail via Amazon SES. L'adresse source doit être une identité SES vérifiée.

Important

Au moins l’un des éléments toAddresses, ccAddresses, ou bccAddresses doit être fourni, et au moins l’un des éléments bodyText, ou bodyHtml doit être fourni. Le nombre total de destinataires dans les trois champs d’adresse ne peut pas dépasser 50. Toutes les adresses e-mail doivent être en ASCII 7 bits ; les domaines Unicode doivent être encodés en Punycode.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir	Type	Description	Exemple
`awsRoleArn`	Chaîne	Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Chaîne	Facultatif. ID de clé d’accès AWS. Passer en tant que secret.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Chaîne	Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Chaîne	Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.	`${{ :secrets:awsSessionToken }}`
`region`	Chaîne	Obligatoire. Région AWS à partir de laquelle envoyer l’e-mail.	`us-east-2`
`source`	Chaîne	Obligatoire. Adresse e-mail de l’expéditeur. Doit être une identité SES vérifiée.	`no-reply@example.com`
`subject`	Chaîne	Obligatoire. Objet de l’e-mail.	`Welcome to Our Service`
`toAddresses`	List	Facultatif. Liste des adresses des destinataires (À). Au moins `toAddresses` , `ccAddresses` , ou `bccAddresses` doit être fourni.	`["recipient@example.com"]`
`ccAddresses`	List	Facultatif. Liste des adresses des destinataires en CC. Au moins l’un des éléments `toAddresses` , `ccAddresses` , ou `bccAddresses` doit être fourni.	`["cc@example.com"]`
`bccAddresses`	List	Facultatif. Liste des adresses des destinataires en CCI. Au moins `toAddresses` , `ccAddresses` , ou `bccAddresses` doit être fourni.	`["bcc@example.com"]`
`bodyText`	Chaîne	Facultatif. Corps de l'e-mail en texte brut. Au moins l’un des éléments `bodyText` ou `bodyHtml` doit être fourni.	`Hi there, thanks for signing up.`
`bodyHtml`	Chaîne	Facultatif. Corps de l’e-mail au format HTML. Au moins l’un des éléments `bodyText` ou `bodyHtml` doit être fourni.	`<h1>Welcome!</h1><p>Thanks for signing up.</p>`
`subjectCharset`	Chaîne	Facultatif. Jeu de caractères pour l’objet. La valeur par défaut est `UTF-8` .	`UTF-8`
`bodyTextCharset`	Chaîne	Facultatif. Jeu de caractères pour le corps en texte brut. La valeur par défaut est `UTF-8` .	`UTF-8`
`bodyHtmlCharset`	Chaîne	Facultatif. Jeu de caractères pour le corps HTML. La valeur par défaut est `UTF-8` .	`UTF-8`
`replyToAddresses`	List	Facultatif. Adresses de réponse.	`["reply-to@example.com"]`
`returnPath`	Chaîne	Facultatif. Adresse e-mail pour la notification de rebond et de plainte.	`bounces@example.com`
`sourceArn`	Chaîne	Facultatif. ARN d’une identité vérifiée à utiliser pour l’autorisation d’envoi.	`arn:aws:ses:us-east-2:123456789012:identity/example.com`
`returnPathArn`	Chaîne	Facultatif. ARN d’une identité vérifiée associée à `returnPath` , pour l’autorisation d’envoi.	`arn:aws:ses:us-east-2:123456789012:identity/example.com`
`configurationSetName`	Chaîne	Facultatif. Nom d’un ensemble de configuration à utiliser pour cet envoi.	`my-configuration-set`
`tags`	List	Facultatif. Tags de message sous forme de liste d’objets `{"Name": "...", "Value": "..."}` .	`[{"Name": "purpose", "Value": "welcome-email"}]`
`selectors`	List	Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.	`[{"name": "messageId", "expression": ".response.MessageId"}]`

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir	Type	Exemple
`response`	Objet	Consultez la référence boto3 send_email . Contient une chaîne `MessageId` en cas de succès.
`success`	Booléen	`true` ou `false`
`errorMessage`	Chaîne	`"An error occurred (MessageRejected) when calling the SendEmail operation: Email address is not verified. The following identities failed the check in region US-EAST-2: sender@example.com"`

Sortir

Type

Exemple

response

Objet

Consultez la

référence boto3 send_email

. Contient une chaîne

MessageId

en cas de succès.

success

Booléen

true

false

errorMessage

Chaîne

"An error occurred (MessageRejected) when calling the SendEmail operation: Email address is not verified. The following identities failed the check in region US-EAST-2: sender@example.com"

Exemple de workflow

name: send-ses-email
description: 'Send an email through Amazon SES'
steps:
  - name: sendWelcomeEmail
    type: action
    action: aws.ses.sendEmail
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: us-east-2
      source: no-reply@example.com
      toAddresses:
        - recipient@example.com
      subject: "Welcome to Our Service"
      bodyText: "Hi there, thanks for signing up."
      bodyHtml: "<h1>Welcome!</h1><p>Thanks for signing up.</p>"
      selectors:
        - name: messageId
          expression: ".response.MessageId"
    next: end

Envoyer un e-mail à partir d’un modèle

L’identifiant de l’action est aws.ses.sendTemplatedEmail.

Envoie un e-mail à l’aide d’un modèle Amazon SES existant, en substituant les valeurs d’espace réservé de templateData dans le modèle. L’adresse source et le template référencé doivent déjà exister.

Important

Au moins toAddresses, ccAddresses, ou bccAddresses doit être fourni. L'omission des trois entraîne une erreur de l'API AWS lors de l'envoi. Le nombre total de destinataires ne peut pas dépasser 50, et templateData ne peut pas dépasser 262 144 caractères.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir	Type	Description	Exemple
`awsRoleArn`	Chaîne	Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Chaîne	Facultatif. ID de clé d’accès AWS. Passer en tant que secret.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Chaîne	Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Chaîne	Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.	`${{ :secrets:awsSessionToken }}`
`region`	Chaîne	Obligatoire. Région AWS à partir de laquelle envoyer l’e-mail.	`us-east-2`
`source`	Chaîne	Obligatoire. Adresse e-mail de l’expéditeur. Doit être une identité SES vérifiée.	`no-reply@example.com`
`template`	Chaîne	Obligatoire. Nom du modèle SES à utiliser. Doit déjà exister.	`WelcomeEmailTemplate`
`templateData`	Chaîne	Obligatoire. Chaîne JSON de paires valeur clé à substituer dans les espaces réservés du modèle. Maximum 262 144 caractères.	`{"name": "Alice"}`
`toAddresses`	List	Facultatif. Liste des adresses des destinataires (À). Au moins `toAddresses` , `ccAddresses` , ou `bccAddresses` doit être fourni.	`["recipient@example.com"]`
`ccAddresses`	List	Facultatif. Liste des adresses des destinataires en CC. Au moins l’un des éléments `toAddresses` , `ccAddresses` , ou `bccAddresses` doit être fourni.	`["cc@example.com"]`
`bccAddresses`	List	Facultatif. Liste des adresses des destinataires en CCI. Au moins `toAddresses` , `ccAddresses` , ou `bccAddresses` doit être fourni.	`["bcc@example.com"]`
`replyToAddresses`	List	Facultatif. Adresses de réponse.	`["reply-to@example.com"]`
`returnPath`	Chaîne	Facultatif. Adresse e-mail pour la notification de rebond et de plainte.	`bounces@example.com`
`sourceArn`	Chaîne	Facultatif. ARN d’une identité vérifiée à utiliser pour l’autorisation d’envoi.	`arn:aws:ses:us-east-2:123456789012:identity/example.com`
`returnPathArn`	Chaîne	Facultatif. ARN d’une identité vérifiée associée à `returnPath` , pour l’autorisation d’envoi.	`arn:aws:ses:us-east-2:123456789012:identity/example.com`
`templateArn`	Chaîne	Facultatif. ARN multi-compte du modèle, comme alternative à `template` .	`arn:aws:ses:us-east-2:123456789012:template/WelcomeEmailTemplate`
`configurationSetName`	Chaîne	Facultatif. Nom d’un ensemble de configuration à utiliser pour cet envoi.	`my-configuration-set`
`tags`	List	Facultatif. Tags de message sous forme de liste d’objets `{"Name": "...", "Value": "..."}` .	`[{"Name": "purpose", "Value": "welcome-email"}]`
`selectors`	List	Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.	`[{"name": "messageId", "expression": ".response.MessageId"}]`

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir	Type	Exemple
`response`	Objet	Consultez la référence boto3 send_templated_email . Contient une chaîne `MessageId` en cas de succès.
`success`	Booléen	`true` ou `false`
`errorMessage`	Chaîne	`"An error occurred (TemplateDoesNotExistException) when calling the SendTemplatedEmail operation: Template (WelcomeEmailTemplate) does not exist"`

Sortir

Type

Exemple

response

Objet

Consultez la

référence boto3 send_templated_email

. Contient une chaîne

MessageId

en cas de succès.

success

Booléen

true

false

errorMessage

Chaîne

"An error occurred (TemplateDoesNotExistException) when calling the SendTemplatedEmail operation: Template (WelcomeEmailTemplate) does not exist"

Exemple de workflow

name: send-ses-templated-email
description: 'Send a templated email through Amazon SES'
steps:
  - name: sendWelcomeTemplatedEmail
    type: action
    action: aws.ses.sendTemplatedEmail
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: us-east-2
      source: no-reply@example.com
      template: WelcomeEmailTemplate
      templateData: '{"name": "Alice"}'
      toAddresses:
        - recipient@example.com
      selectors:
        - name: messageId
          expression: ".response.MessageId"
    next: end

Envoyer des e-mails en masse basés sur des modèles

L’identifiant de l’action est aws.ses.sendBulkTemplatedEmail.

Envoie un e-mail basé sur un modèle à plusieurs destinataires en un seul appel, avec substitution des données du modèle par destinataire. L’adresse source et le template référencé doivent déjà exister.

Important

AWS limite cette action à 50 entrées destinations par appel, avec jusqu’à 50 destinataires (À/Cc/Cci combinés) par destination, et une taille maximale de message généré de 10 Mo. Le dépassement de l’une de ces limites produit une erreur d’API AWS au moment de l’envoi.

Chaque entrée dans destinations accepte les champs suivants :

destination — Obligatoire. Objet avec toAddresses, ccAddresses, et/ou bccAddresses (chacun étant une liste de chaînes).
replacementTemplateData — Facultatif. Chaîne JSON des valeurs d’espace réservé par destinataire. Remplace defaultTemplateData pour ce destinataire.
replacementTags — Facultatif. Liste d’objets {"name": "...", "value": "..."} qui remplacent defaultTags pour ce destinataire.

Le tableau suivant décrit les champs d’entrée pour cette action.

Saisir	Type	Description	Exemple
`awsRoleArn`	Chaîne	Facultatif. ARN du rôle IAM à assumer pour les appels d'API AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Chaîne	Facultatif. ID de clé d’accès AWS. Passer en tant que secret.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Chaîne	Facultatif. Clé d’accès secrète AWS. Passer en tant que secret.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Chaîne	Facultatif. Jeton de session temporaire pour l'authentification STS. Transmettez en tant que secret.	`${{ :secrets:awsSessionToken }}`
`region`	Chaîne	Obligatoire. Région AWS depuis laquelle envoyer les e-mails.	`us-east-2`
`source`	Chaîne	Obligatoire. Adresse e-mail de l’expéditeur. Doit être une identité SES vérifiée.	`no-reply@example.com`
`template`	Chaîne	Obligatoire. Nom du modèle SES à utiliser. Doit déjà exister.	`WelcomeEmailTemplate`
`defaultTemplateData`	Chaîne	Obligatoire. Chaîne JSON des valeurs d’espace réservé de repli utilisées pour toute destination qui ne fournit pas son propre `replacementTemplateData` .	`{"name": "Guest"}`
`destinations`	List	Obligatoire. Liste des objets de destination par destinataire. Chaque entrée nécessite un objet `destination` avec au moins l’un des éléments `toAddresses` , `ccAddresses` , ou `bccAddresses` . Jusqu’à 50 entrées par appel.	`[{"destination": {"toAddresses": ["alice@example.com"]}, "replacementTemplateData": "{\"name\": \"Alice\"}"}]`
`replyToAddresses`	List	Facultatif. Adresses de réponse appliquées à toutes les destinations.	`["support@example.com"]`
`returnPath`	Chaîne	Facultatif. Adresse e-mail pour la notification de rebond et de plainte.	`bounces@example.com`
`sourceArn`	Chaîne	Facultatif. ARN d’une identité vérifiée à utiliser pour l’autorisation d’envoi.	`arn:aws:ses:us-east-2:123456789012:identity/example.com`
`returnPathArn`	Chaîne	Facultatif. ARN d’une identité vérifiée associée à `returnPath` , pour l’autorisation d’envoi.	`arn:aws:ses:us-east-2:123456789012:identity/example.com`
`templateArn`	Chaîne	Facultatif. ARN multi-compte du modèle, comme alternative à `template` .	`arn:aws:ses:us-east-2:123456789012:template/WelcomeEmailTemplate`
`configurationSetName`	Chaîne	Facultatif. Nom d’un ensemble de configuration à utiliser pour cet envoi.	`my-configuration-set`
`defaultTags`	List	Facultatif. Tags de message par défaut appliqués à toutes les destinations sous forme de liste d’objets `{"Name": "...", "Value": "..."}` . Les destinations individuelles peuvent les remplacer par `replacementTags` .	`[{"Name": "campaign", "Value": "welcome-series"}]`
`selectors`	List	Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.	`[{"name": "sendStatuses", "expression": ".response.Status"}]`

Le tableau suivant décrit les champs de sortie pour cette action.

Sortir	Type	Exemple
`response`	Objet	Consultez la référence boto3 send_bulk_templated_email . Contient un éventail `Status` avec une entrée par destination, chacune avec une chaîne `Status` , un `Error` facultatif, et `MessageId` .
`success`	Booléen	`true` ou `false`
`errorMessage`	Chaîne	`"An error occurred (TemplateDoesNotExistException) when calling the SendBulkTemplatedEmail operation: Template (WelcomeEmailTemplate) does not exist"`

Sortir

Type

Exemple

response

Objet

Consultez la

référence boto3 send_bulk_templated_email

. Contient un éventail

Status

avec une entrée par destination, chacune avec une chaîne

Status

, un

Error

facultatif, et

MessageId

success

Booléen

true

false

errorMessage

Chaîne

"An error occurred (TemplateDoesNotExistException) when calling the SendBulkTemplatedEmail operation: Template (WelcomeEmailTemplate) does not exist"

Exemple de workflow

name: send-ses-bulk-templated-email
description: 'Send bulk templated emails through Amazon SES'
steps:
  - name: sendBulkWelcomeEmail
    type: action
    action: aws.ses.sendBulkTemplatedEmail
    version: '1'
    inputs:
      awsRoleArn: "arn:aws:iam::123456789012:role/my-workflow-role"
      region: us-east-2
      source: no-reply@example.com
      template: WelcomeEmailTemplate
      defaultTemplateData: '{"name": "Guest"}'
      destinations:
        - destination:
            toAddresses:
              - alice@example.com
          replacementTemplateData: '{"name": "Alice"}'
        - destination:
            toAddresses:
              - bob@example.com
          replacementTemplateData: '{"name": "Bob"}'
      selectors:
        - name: sendStatuses
          expression: ".response.Status"
    next: end

Cette traduction automatique est fournie pour votre commodité.

Prérequis.css-21sua1{background:none;border:none;width:0;padding:0;}

Créer un modèle

Important

Mettre à jour un modèle

Important

Supprimer un modèle

Obtenir un modèle

Lister les modèles

Envoyer un e-mail

Important

Envoyer un e-mail à partir d’un modèle

Important

Envoyer des e-mails en masse basés sur des modèles

Important

Prérequis