本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 將 AWS AppConfig 部署事件用於 Amazon EventBridge 延伸模組
<a name="working-with-appconfig-extensions-about-predefined-notification-eventbridge"></a>

`AWS AppConfig deployment events to Amazon EventBridge` 延伸模組是 AWS 撰寫的延伸模組，可協助您監控 AWS AppConfig 組態部署工作流程並對其採取行動。延伸項目會在部署組態時，將事件通知傳送至 EventBridge 預設事件匯流排。將延伸項目關聯至其中一個 AWS AppConfig 應用程式、環境或組態設定檔後， 會在每次組態部署開始、結束和復原後，將事件通知 AWS AppConfig 傳送至事件匯流排。

如果您想要進一步控制哪些動作點傳送 EventBridge 通知，您可以建立自訂延伸，並為 URI 欄位輸入 EventBridge 預設事件匯流排 Amazon Resource Name (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 資源。您可以使用 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：//[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"
   }
}
```