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

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

`AWS AppConfig deployment events to Amazon EventBridge` 拡張機能は、 AWS AppConfig 設定デプロイワークフローのモニタリングと対応に役立つ AWS 作成済みの拡張機能です。設定がデプロイされるたびに、この拡張機能は EventBridge のデフォルトのイベントバスにイベント通知を送信します。拡張機能をアプリケーション、環境、または設定プロファイルのいずれかに関連付けると、 は設定デプロイの開始、終了、ロールバックのたびにイベント通知をイベントバス AWS AppConfig に送信します AWS AppConfig 。

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

**重要**  
この拡張モジュールは EventBridge のデフォルトイベントバスのみをサポートします。

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

`AWS AppConfig deployment events to Amazon EventBridge` 拡張機能を使用するには、まず拡張機能の関連付けを作成して、拡張機能を AWS AppConfig リソースの 1 つにアタッチします。コンソール AWS AppConfig または [CreateExtensionAssociation](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_CreateExtensionAssociation.html) API アクションを使用して関連付けを作成します。関連付けを作成するときは、 AWS AppConfig アプリケーション、環境、または設定プロファイルの ARN を指定します。エクステンションをアプリケーションまたは環境に関連付けると、指定したアプリケーションまたは環境に含まれるすべての設定プロファイルに対してイベント通知が送信されます。

関連付けを作成した後、指定された 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. **リソースとの関連付けを作成** を選択します。

拡張機能が呼び出されたときに EventBridge に送信されるサンプルイベントを次に示します。

```
{
   "version":"0",
   "id":"c53dbd72-c1a0-2302-9ed6-c076e9128277",
   "detail-type":"On Deployment Complete",
   "source":"aws.appconfig",
   "account":"111122223333",
   "time":"2022-07-09T01:44:15Z",
   "region":"us-east-1",
   "resources":[
      "arn:aws:appconfig:us-east-1:111122223333:extensionassociation/z763ff5"
   ],
   "detail":{
      "InvocationId":"5tfjcig",
       "Parameters":{
         
      },
      "Type":"OnDeploymentComplete",
      "Application":{
         "Id":"ba8toh7",
         "Name":"MyApp"
      },
      "Environment":{
         "Id":"pgil2o7",
         "Name":"MyEnv"
      },
      "ConfigurationProfile":{
         "Id":"ga3tqep",
         "Name":"MyConfigProfile"
      },
      "DeploymentNumber":1,
      "ConfigurationVersion":"1"
   }
}
```