本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 Amazon AppConfig 部署事件到 Amazon SQS 扩展程序
<a name="working-with-appconfig-extensions-about-predefined-notification-sqs"></a>

该`Amazon AppConfig deployment events to Amazon SQS`扩展是 Amazon 编写的扩展，可帮助您监控 Amazon AppConfig 配置部署工作流程并对其采取行动。每当部署配置时，该扩展程序都会将消息排入 Amazon Simple Queue Service (Amazon SQS) 队列。将扩展程序与您的一个 Amazon AppConfig 应用程序、环境或配置文件关联后，在每次配置部署开始、 Amazon AppConfig 结束和回滚之后，都会将一条消息排队到队列中。

如果您希望更好地控制哪些操作点发送 Amazon SQS 通知，您可以创建自定义扩展并在 URI 字段中输入 Amazon SQS 队列 Amazon 资源名称（ARN）。有关创建扩展程序的信息，请参阅 [演练：创建自定义扩展 Amazon AppConfig](working-with-appconfig-extensions-creating-custom.md)。

## 使用扩展程序
<a name="working-with-appconfig-extensions-about-predefined-notification-sqs-using"></a>

本节介绍如何使用 `Amazon AppConfig deployment events to Amazon SQS` 扩展程序。

**步骤 1：配置为 Amazon AppConfig 将消息排入队列**  
将 Amazon SQS 策略添加到您的 Amazon SQS 队列，授予 Amazon AppConfig (`appconfig.amazonaws.com`) 发送消息权限 (`sqs:SendMessage`)。有关更多信息，请参阅 [Amazon SQS 策略的基本示例](https://docs.amazonaws.cn/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-basic-examples-of-sqs-policies.html)。

**步骤 2：创建扩展程序关联**  
通过创建扩展关联，将扩展附加到您的一个 Amazon AppConfig 资源。您可以使用 Amazon AppConfig 控制台或 [CreateExtensionAssociation](https://docs.amazonaws.cn/appconfig/2019-10-09/APIReference/API_CreateExtensionAssociation.html)API 操作创建关联。创建关联时，您可以指定 Amazon AppConfig 应用程序、环境或配置文件的 ARN。如果将扩展程序关联到应用程序或环境，则会针对指定应用程序或环境中包含的任何配置文件发送通知。在创建关联时，您必须输入一个 `Here` 参数，该参数包含要使用的 Amazon SQS 队列的 ARN。

创建关联后，在创建或部署指定 Amazon AppConfig 资源的配置时，会 Amazon AppConfig 调用该扩展程序并根据扩展中指定的操作点发送通知。

**注意**  
此扩展程序由以下操作点调用：  
`ON_DEPLOYMENT_START`
`ON_DEPLOYMENT_COMPLETE`
`ON_DEPLOYMENT_ROLLED_BACK`
您无法自定义此扩展程序的操作点。若要调用不同的操作点，可以创建自己的扩展程序。有关更多信息，请参阅 [演练：创建自定义扩展 Amazon AppConfig](working-with-appconfig-extensions-creating-custom.md)。

使用以下过程通过 Amazon Systems Manager 控制台或控制台创建 Amazon AppConfig 扩展关联 Amazon CLI。

**创建扩展程序关联（控制台）**

1. 在 [https://console.aws.amazon.com/systems-manager/appconfig](https://console.amazonaws.cn/systems-manager/appconfig/)/上打开 Amazon Systems Manager 控制台。

1. 在导航窗格中，请选择 **Amazon AppConfig**。

1. 在 **扩展程序** 选项卡上，选择 **添加到资源**。

1. 在**扩展资源详细信息**部分的**资源类型**中，选择一种 Amazon AppConfig 资源类型。根据您选择的资源， Amazon AppConfig 会提示您选择其他资源。

1. 选择**创建与资源的关联**。

以下是调用扩展程序时发送到 Amazon SQS 队列的消息示例。

```
{
   "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"
}
```