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

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

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

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

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

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

**ステップ 1: トピック AWS AppConfig にメッセージを発行するように を設定する**  
Amazon SNS トピックにアクセスコントロールポリシーを追加して AWS AppConfig (`appconfig.amazonaws.com`) パブリッシュアクセス権限 (`sns:Publish`) を付与します。詳細については、「[Amazon SNS アクセスコントロールのケース例](https://docs.aws.amazon.com/sns/latest/dg/sns-access-policy-use-cases.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 SNS トピックの ARN を含む `topicArn` パラメータの値を入力する必要があります。

関連付けを作成した後、指定された 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 SNS トピックに送信されるメッセージのサンプルを次に示します。

```
{
    "Type": "Notification",
    "MessageId": "ae9d702f-9a66-51b3-8586-2b17932a9f28",
    "TopicArn": "arn:aws:sns:us-east-1:111122223333:MySNSTopic",
    "Message": {
        "InvocationId": "7itcaxp",
        "Parameters": {
            "topicArn": "arn:aws:sns:us-east-1:111122223333:MySNSTopic"
        },
        "Application": {
            "Id": "1a2b3c4d",
            "Name": MyApp
        },
        "Environment": {
            "Id": "1a2b3c4d",
            "Name": MyEnv
        },
        "ConfigurationProfile": {
            "Id": "1a2b3c4d",
            "Name": "MyConfigProfile"
        },
        "Description": null,
        "DeploymentNumber": "3",
        "ConfigurationVersion": "1",
        "Type": "OnDeploymentComplete"
    },
    "Timestamp": "2022-06-30T20:26:52.067Z",
    "SignatureVersion": "1",
    "Signature": "<...>",
    "SigningCertURL": "<...>",
    "UnsubscribeURL": "<...>",
    "MessageAttributes": {
        "MessageType": {
            "Type": "String",
            "Value": "OnDeploymentStart"
        }
    }
}
```