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

# 通知ルールの作成
<a name="notification-rule-create"></a>

通知ルールを使用して、リポジトリでプルリクエストが作成されたときなど、重要な変更をユーザーに通知できます。通知ルールは、イベントと、通知の送信に使用される Amazon SNS トピックの両方を指定します。詳細については、「[通知とは](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/welcome.html)」を参照してください。



**注記**  
この機能は、ヨーロッパ (ミラノ) リージョンでは使用できません。そのリージョンで使用可能なエクスペリエンスでの通知の設定方法については、「[リポジトリ通知の設定](https://github.com/awsdocs/aws-codecommit-user-guide/blob/master/doc_source/how-to-repository-email-create.2.md)」を参照してください。

コンソールまたは を使用して AWS CLI 、通知ルールを作成できます AWS CodeCommit。<a name="notification-rule-create-console"></a>

# 通知ルールを作成するには (コンソール)
<a name="notification-rule-create-console"></a>

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/codecommit/](https://console.aws.amazon.com/codecommit/) で CodeCommit コンソールを開きます。

1. [**リポジトリ**] を選択し、通知ルールを追加するリポジトリを選択します。

1. レポジトリページで、[**Notify (通知)**]、[**Create notification rule (通知ルールの作成)**] の順に選択します。レポジトリの [**Settings (設定)**] ページに移動し、[**Create notification rule (通知ルールの作成)**] を選択することもできます。

1. [**通知名**] に、ルールの名前を入力します。

1. Amazon EventBridge に提供された情報のみを通知に含める場合は、**[Detail type (詳細タイプ)]** で **[Basic (基本)]** を選択します。Amazon EventBridge に提供される情報に加えて、CodeCommit または通知マネージャから提供される場合がある情報も含める場合は、**[Full (完全)]** を選択します。

   詳細については、「[通知の内容とセキュリティについて](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/security.html#security-notifications)」を参照してください。

1.  [**Events that trigger notifications (通知をトリガーするイベント)**] で、通知を送信するイベントを選択します。詳細については、「[ リポジトリでの通知ルールのイベント](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/concepts.html#events-ref-repositories)」を参照してください。

1. [**Targets (ターゲット)**] で、次のいずれかの操作を行います。
   + 通知で使用するリソースを設定済みである場合は、**[ターゲットタイプを選択]** で、**[チャットアプリケーションの Amazon Q Developer (Slack)]** または **[SNS トピック]** を選択します。**[ターゲットを選択]** で、クライアントの名前 (チャットアプリケーションの Amazon Q Developer で設定した Slack クライアントの場合) または Amazon SNS トピックの Amazon リソースネーム (ARN) (通知に必要なポリシーが設定済みである Amazon SNS トピックの場合) を選択します。
   + 通知で使用するリソースを設定していない場合は、[**Create target**]、[**SNS topic**] の順に選択します。**codestar-notifications-** の後にトピックの名前を指定し、[**Create**] を選択します。
**注記**  
通知ルールの作成の一環として Amazon SNS トピックを作成すると、トピックへのイベント発行を通知機能に許可するポリシーが適用されます。通知ルール用に作成したトピックを使用すると、このリソースに関する通知を受信するユーザーのみをサブスクライブできます。
通知ルールの作成の一環としてチャットアプリケーションの Amazon Q Developer クライアントを作成することはできません。チャットアプリケーションの Amazon Q Developer (Slack) を選択すると、チャットアプリケーションで Amazon Q Developer でクライアントを設定するように指示するボタンが表示されます。このオプションを選択すると、チャットアプリケーションの Amazon Q Developer コンソールが開きます。詳細については、[「通知とチャットアプリケーションの Amazon Q Developer との統合の設定](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notifications-chatbot.html)」を参照してください。
既存の Amazon SNS トピックをターゲットとして使用する場合は、このトピック用の他のすべてのポリシーに加えて、AWS CodeStar Notifications に必要なポリシーを追加する必要があります。詳細については、「[通知用の Amazon SNS トピックを設定する](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/set-up-sns.html)」および「[通知の内容とセキュリティについて](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/security.html#security-notifications)」を参照してください。

1. ルールの作成を終了するには、[**Submit (送信)**] を選択します。

1. 通知を受け取るには、そのルールの Amazon SNS トピックにユーザーをサブスクライブする必要があります。詳細については、「[ターゲットである Amazon SNS トピックへのユーザーのサブスクライブ](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/subscribe-users-sns.html)」を参照してください。また、通知と Amazon Q Developer in chat applications を統合して、Amazon Chime チャットルームに通知を送信することもできます。詳細については、「[通知とチャットアプリケーションの Amazon Q Developer との統合の設定](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notifications-chatbot.html)」を参照してください。<a name="notification-rule-create-cli"></a>

# 通知ルールを作成するには (AWS CLI)
<a name="notification-rule-create-cli"></a>

1. ターミナルまたはコマンドプロンプトで、**create-notification rule** コマンドを実行して、JSON スケルトンを生成します。

   ```
   aws codestar-notifications create-notification-rule --generate-cli-skeleton > rule.json
   ```

   ファイルには任意の名前を付けることができます。この例では、ファイルの名前を *rule.json* とします。

1. プレーンテキストエディタで JSON ファイルを開き、これを編集してルールに必要なリソース、イベントタイプ、ターゲットを含めます。次の例は、ID *123456789012* の AWS アカウントの *MyDemoRepo* という名前のリポジトリ**MyNotificationRule**に という名前の通知ルールを示しています。ブランチとタグが作成されると、完全な詳細タイプの通知は、*MyNotificationTopic* という Amazon SNS トピックに送信されます。

   ```
   {
       "Name": "MyNotificationRule",
       "EventTypeIds": [
           "codecommit-repository-branches-and-tags-created"
       ],
       "Resource": "arn:aws:codecommit:us-east-1:123456789012:MyDemoRepo",
       "Targets": [
           {
               "TargetType": "SNS",
               "TargetAddress": "arn:aws:sns:us-east-1:123456789012:MyNotificationTopic"
           }
       ],
       "Status": "ENABLED",
       "DetailType": "FULL"
   }
   ```

   ファイルを保存します。

1. 先ほど編集したファイルを使用して、ターミナルまたはコマンドラインで、**create-notification-rule** コマンドを再度実行し、通知ルールを作成します。

   ```
   aws codestar-notifications create-notification-rule --cli-input-json  file://rule.json
   ```

1. 成功すると、コマンドは次のような通知ルールの ARN を返します。

   ```
   {
       "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
   }
   ```