Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utilisation des événements AWS AppConfig de déploiement vers l'extension Amazon SQS
<a name="working-with-appconfig-extensions-about-predefined-notification-sqs"></a>

L'`AWS AppConfig deployment events to Amazon SQS`extension est une extension AWS créée qui vous aide à surveiller et à agir sur le flux de travail de déploiement AWS AppConfig de la configuration. L'extension place les messages en file d'attente dans votre file d'attente Amazon Simple Queue Service (Amazon SQS) chaque fois qu'une configuration est déployée. Après avoir associé l'extension à l'une de vos AWS AppConfig applications, environnements ou profils de configuration, AWS AppConfig place un message dans la file d'attente après chaque début, fin et annulation du déploiement de configuration.

Si vous souhaitez mieux contrôler les points d'action qui envoient des notifications Amazon SQS, vous pouvez créer une extension personnalisée et saisir une file d'attente Amazon SQS (ARN) pour le champ URI. Pour plus d'informations sur la création d'une extension, consultez[Procédure pas à pas : création d'extensions personnalisées AWS AppConfig](working-with-appconfig-extensions-creating-custom.md).

## Utilisation de l'extension
<a name="working-with-appconfig-extensions-about-predefined-notification-sqs-using"></a>

Cette section décrit comment utiliser l'`AWS AppConfig deployment events to Amazon SQS`extension.

**Étape 1 : Configuration AWS AppConfig pour mettre les messages en file d'attente**  
Ajoutez une politique Amazon SQS à votre file d'attente Amazon SQS en AWS AppConfig accordant `appconfig.amazonaws.com` () les autorisations d'envoi de message (). `sqs:SendMessage` Pour plus d'informations, consultez les [exemples de base des politiques Amazon SQS.](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-basic-examples-of-sqs-policies.html)

**Étape 2 : créer une association d'extensions**  
Associez l'extension à l'une de vos AWS AppConfig ressources en créant une association d'extensions. Vous créez l'association à l'aide de la AWS AppConfig console ou de l'action [CreateExtensionAssociation](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateExtensionAssociation.html)API. Lorsque vous créez l'association, vous spécifiez l'ARN d'une AWS AppConfig application, d'un environnement ou d'un profil de configuration. Si vous associez l'extension à une application ou à un environnement, une notification est envoyée pour tout profil de configuration contenu dans l'application ou l'environnement spécifié. Lorsque vous créez l'association, vous devez entrer un `Here` paramètre contenant l'ARN de la file d'attente Amazon SQS que vous souhaitez utiliser.

Après avoir créé l'association, lorsqu'une configuration pour la AWS AppConfig ressource spécifiée est créée ou déployée, AWS AppConfig appelle l'extension et envoie des notifications en fonction des points d'action spécifiés dans l'extension.

**Note**  
Cette extension est invoquée par les points d'action suivants :  
`ON_DEPLOYMENT_START`
`ON_DEPLOYMENT_COMPLETE`
`ON_DEPLOYMENT_ROLLED_BACK`
Vous ne pouvez pas personnaliser les points d'action pour cette extension. Pour invoquer différents points d'action, vous pouvez créer votre propre extension. Pour de plus amples informations, veuillez consulter [Procédure pas à pas : création d'extensions personnalisées AWS AppConfig](working-with-appconfig-extensions-creating-custom.md).

Utilisez les procédures suivantes pour créer une association d' AWS AppConfig extension à l'aide de la AWS Systems Manager console ou du AWS CLI.

**Pour créer une association d'extensions (console)**

1. Ouvrez la AWS Systems Manager console à l'adresse [https://console.aws.amazon.com/systems-manager/appconfig/](https://console.aws.amazon.com/systems-manager/appconfig/).

1. Dans le panneau de navigation, sélectionnez **AWS AppConfig**.

1. Dans l'onglet **Extensions**, choisissez **Ajouter à la ressource**.

1. Dans la section **Détails de la ressource d'extension**, pour **Type de ressource**, choisissez un type de AWS AppConfig ressource. En fonction de la ressource que vous choisissez, vous AWS AppConfig invite à choisir d'autres ressources.

1. Choisissez **Créer une association à la ressource**.

Voici un exemple du message envoyé à la file d'attente Amazon SQS lorsque l'extension est invoquée.

```
{
   "InvocationId":"7itcaxp",
   "Parameters":{
      "queueArn":"arn:aws:sqs:us-east-1:111122223333:MySQSQueue"
   },
   "Application":{
      "Id":"1a2b3c4d",
      "Name":MyApp
   },
   "Environment":{
      "Id":"1a2b3c4d",
      "Name":MyEnv
   },
   "ConfigurationProfile":{
      "Id":"1a2b3c4d",
      "Name":"MyConfigProfile"
   },
   "Description":null,
   "DeploymentNumber":"3",
   "ConfigurationVersion":"1",
   "Type":"OnDeploymentComplete"
}
```