翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon SQS 拡張機能への AWS AppConfig デプロイイベントの使用
<a name="working-with-appconfig-extensions-about-predefined-notification-sqs"></a>

`AWS AppConfig deployment events to Amazon SQS` 拡張機能は、 AWS AppConfig 設定デプロイワークフローのモニタリングと対応に役立つ AWS 作成済みの拡張機能です。設定がデプロイされるたびに、拡張機能は Amazon Simple Queue Service (Amazon SQS) キューにメッセージをエンキューします。拡張機能を AWS AppConfig アプリケーション、環境、または設定プロファイルのいずれかに関連付けると、 は設定デプロイの開始、終了、ロールバックのたびにメッセージをキューに AWS AppConfig キューに入れます。

Amazon SQS 通知を送信するアクションポイントをより細かく制御したい場合は、カスタムエクステンションを作成し、URI フィールドに Amazon SQS キューの Amazon リソースネーム (ARN) を入力できます。拡張機能の作成の詳細については、「[チュートリアル: カスタム AWS AppConfig 拡張機能の作成](working-with-appconfig-extensions-creating-custom.md)」を参照してください。

## 拡張機能の使用
<a name="working-with-appconfig-extensions-about-predefined-notification-sqs-using"></a>

このセクションでは、 `AWS AppConfig deployment events to Amazon SQS` 拡張機能を使用する方法について説明します。

**ステップ 1: メッセージをキューに入れる AWS AppConfig ように を設定する**  
Amazon SQS キューに Amazon SQS ポリシーを追加して、 AWS AppConfig (`appconfig.amazonaws.com`) メッセージの送信権限 (`sqs:SendMessage`) を付与します。詳細については、「[Basic examples of Amazon SQS policies](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-basic-examples-of-sqs-policies.html)」を参照してください。

**ステップ 2: 拡張機能の作成**  
拡張機能の関連付けを作成して、いずれかの AWS AppConfig リソースに拡張機能をアタッチします。関連付けを作成するには、 AWS AppConfig コンソールまたは [CreateExtensionAssociation](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateExtensionAssociation.html) API アクションを使用します。関連付けを作成するときは、 AWS AppConfig アプリケーション、環境、または設定プロファイルの ARN を指定します。エクステンションをアプリケーションまたは環境に関連付けると、指定したアプリケーションまたは環境に含まれるすべての設定プロファイルに通知が送信されます。関連付けを作成するときは、使用する Amazon SQS キューの ARN を含む `Here` パラメータを入力する必要があります。

関連付けを作成した後、指定された AWS AppConfig リソースの設定が作成またはデプロイされると、 は拡張機能を AWS AppConfig 呼び出し、拡張機能で指定されたアクションポイントに従って通知を送信します。

**注記**  
このエクステンションは、以下のアクションポイントによって呼び出されます。  
`ON_DEPLOYMENT_START`
`ON_DEPLOYMENT_COMPLETE`
`ON_DEPLOYMENT_ROLLED_BACK`
この拡張機能の使用、カスタマイズはできません。さまざまなアクションポイントを呼び出すための、独自のエクステンションを作成できます。詳細については、「[チュートリアル: カスタム AWS AppConfig 拡張機能の作成](working-with-appconfig-extensions-creating-custom.md)」を参照してください。

 AWS Systems Manager コンソールまたは を使用して AWS AppConfig 拡張機能の関連付けを作成するには、次の手順に従います AWS CLI。

**拡張機能の関連付けを作成します (コンソール)**

1. [https://console.aws.amazon.com/systems-manager/appconfig/](https://console.aws.amazon.com/systems-manager/appconfig/) で AWS Systems Manager コンソールを開きます。

1. ナビゲーションペインで、**AWS AppConfig** を選択します。

1. **エクステンション**タブで**リソースに追加**を選択します。

1. **「拡張リソースの詳細**」セクションの**「リソースタイプ**」で、 AWS AppConfig 「リソースタイプ」を選択します。選択したリソースに応じて、 は他のリソースを選択するように AWS 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"
}
```