翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
の Amazon SNS通知の設定 CloudTrail
が新しいログファイルを Amazon S3 バケットに CloudTrail 発行すると、通知を受け取ることができます。Amazon Simple Notification Service (Amazon ) を使用して通知を管理しますSNS。
通知はオプションです。通知が必要な場合は、新しいログファイルが送信されるたびに Amazon SNSトピックに更新情報を送信する CloudTrail ように を設定します。これらの通知を受け取るには、Amazon SNS を使用してトピックをサブスクライブします。サブスクライバーは、Amazon Simple Queue Service (Amazon SQS) キューに更新を送信できます。これにより、これらの通知をプログラムで処理できます。
通知を送信する CloudTrail ように を設定する
CloudTrail コンソールでは、証跡を作成または更新するときにSNS通知配信オプションを有効にすることで、Amazon SNSトピックを使用するように証跡を設定できます。新しいトピックを使用することを選択した場合、 は Amazon SNSトピック CloudTrail を作成し、適切なポリシーをアタッチして、 がそのトピックに発行するアクセス許可 CloudTrail を持つようにします。
では AWS CLI、 --sns-topic-name
パラメータの値を指定することで、Amazon SNSトピックを使用するように証跡を作成または更新できます。
SNS トピック名を作成する場合、その名前は次の要件を満たしている必要があります。
-
1 ~ 256 文字
-
大文字と小文字ASCII、数字、アンダースコア、またはハイフンを含む
すべてのリージョンに適用される証跡の通知を設定すると、すべてのリージョンからの通知が、指定した Amazon SNSトピックに送信されます。リージョン固有の証跡が 1 つ以上ある場合は、リージョンごとに個別のトピックを作成し、各トピックを個別にサブスクライブする必要があります。
通知を受信するには、 が CloudTrail 使用する Amazon SNSトピックにサブスクライブします。これは、Amazon SNSコンソールまたは Amazon SNS CLI コマンドを使用して行います。詳細については、「Amazon Simple Notification Service デベロッパーガイド」の「Amazon SNSトピックへのサブスクライブ」を参照してください。
注記
CloudTrail は、ログファイルが Amazon S3 バケットに書き込まれると通知を送信します。アクティブなアカウントでは、大量の通知が生成されることがあります。E メールまたは でサブスクライブするとSMS、大量のメッセージを受信できます。通知をプログラムで処理できる Amazon Simple Queue Service (Amazon SQS) を使用してサブスクライブすることをお勧めします。詳細については、「Amazon Simple Queue Service デベロッパーガイド」の「Amazon SQSキューを Amazon SNSトピックにサブスクライブする (コンソール)」を参照してください。
Amazon SNS通知は、 Message
フィールドを含む JSON オブジェクトで構成されます。Message
フィールドには、次の例のように、ログファイルへのフルパスがリストされます。
{ "s3Bucket": "amzn-s3-demo-bucket","s3ObjectKey": ["AWSLogs/123456789012/CloudTrail/us-east-2/2013/12/13/123456789012_CloudTrail_us-west-2_20131213T1920Z_LnPgDQnpkSKEsppV.json.gz"] }
Amazon S3 バケットに複数のログファイルが配信された場合は、次の例のように、複数のログが通知に含まれている可能性があります。
{ "s3Bucket": "amzn-s3-demo-bucket", "s3ObjectKey": [ "AWSLogs/123456789012/CloudTrail/us-east-2/2016/08/11/123456789012_CloudTrail_us-east-2_20160811T2215Z_kpaMYavMQA9Ahp7L.json.gz", "AWSLogs/123456789012/CloudTrail/us-east-2/2016/08/11/123456789012_CloudTrail_us-east-2_20160811T2210Z_zqDkyQv3TK8ZdLr0.json.gz", "AWSLogs/123456789012/CloudTrail/us-east-2/2016/08/11/123456789012_CloudTrail_us-east-2_20160811T2205Z_jaMVRa6JfdLCJYHP.json.gz" ] }
E メールで通知を受け取る場合、E メールの本文は、Message
フィールドの内容で構成されます。JSON 構造の詳細については、「Amazon Simple Notification Service デベロッパーガイド」の「Amazon SQSキューへのファンアウト」を参照してください。 Message
フィールドのみが CloudTrail 情報を表示します。他のフィールドには、Amazon SNSサービスからの情報が含まれています。
を使用して証跡を作成する場合は CloudTrail API、 CreateTrail
または UpdateTrail
オペレーションを使用して通知を送信する既存の Amazon CloudTrail SNSトピックを指定できます。トピックが存在し、 が通知を送信 CloudTrail できるアクセス許可を持っていることを確認する必要があります。「CloudTrail の Amazon SNS トピックポリシー」を参照してください。
追加リソース
Amazon SNSトピックとトピックへのサブスクライブの詳細については、Amazon Simple Notification Service デベロッパーガイドを参照してください。