翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
イベントメタデータフィールドリファレンス
次のフィールドは、イベントバスに配信されるすべてのイベントに表示され、イベントのメタデータ を構成します。
{
"version": "0",
"id": "UUID
",
"detail-type (ディテールタイプ)": "event name
",
"ソース": "event source
",
"アカウント": "ARN
",
"時系": "timestamp
",
"region": "region
",
"リソース": [
"ARN
"
],
"detail": {
JSON object
}
}
- version
-
デフォルトでは、これはすべてのイベントで 0(ゼロ)に設定されます。
- id
-
すべてのイベントに対して生成されるバージョン UUID 4。
id
を使用すると、ルールからターゲットに移動するときのイベントをトレースできます。 - detail-type (ディテールタイプ)
-
[source] フィールドと組み合わせて、[detail] フィールドに表示されるフィールドと値を識別します。
によって配信されるイベントは CloudTrail 、 の値
AWS API Call via CloudTrail
として を持ちますdetail-type
。 - ソース
-
イベントを発生させたサービスを識別します。 AWS サービスからのイベントはすべて、「AWS」で始まります。顧客から発生したイベントは、「aws」で始まらない限り、このフィールドに値があります。Java パッケージ名のスタイルには逆ドメイン名の文字列を使用することをお勧めします。
AWS サービスの の正しい値を見つけるには、「条件キーテーブル
source
」を参照し、リストからサービスを選択し、サービスプレフィックス を探します。例えば、Amazon のsource
値は CloudFront ですaws.cloudfront
。 - アカウント
-
AWS アカウントを識別する 12 桁の番号。
- 時系
-
イベントを発生したサービスによって指定できるイベントのタイムスタンプ。イベントが時間間隔にまたがる場合、サービスは開始時間をレポートできるため、この値は、イベントが受け取られるより前の時間になることがあります。
- region
-
イベントが発生した AWS リージョンを識別します。
- リソース
-
イベントに関係するリソースARNsを識別する を含むJSON配列。イベントを生成するサービスは、これらの を含めるかどうかを決定しますARNs。例えば、Amazon EC2インスタンスの状態変更には Amazon EC2インスタンス が含まれARNs、Auto Scaling イベントにはインスタンスと Auto Scaling グループの両方ARNsが含まれますが、 を使用したAPI呼び出し AWS CloudTrail にはリソース は含まれませんARNs。
- detail
-
イベントに関する情報を含むJSONオブジェクト。このフィールドの内容は、イベントを生成するサービスによって決まります。
"{}"
とすることができます。AWS API コールイベントには、約 50 個のフィールドが深さの複数のレベルにネストされた詳細オブジェクトがあります。
注記
PutEvents は JSON 形式のデータを受け入れます。JSON 数値 (整数) データ型の場合、最小値は -9,223,372,036,854,775,808、最大値は 9,223,372,036,854,775,807 です。
例: Amazon EC2インスタンスの状態変更通知
Amazon の次のイベントは、Amazon EC2インスタンスが終了している EventBridge ことを示します。
{
"version": "0",
"id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718",
"detail-type": "EC2 Instance State-change Notification",
"source": "aws.ec2",
"account": "111122223333",
"time": "2017-12-22T18:43:48Z",
"region": "us-west-1",
"resources": [
"arn:aws:ec2:us-west-1:123456789012:instance/i-1234567890abcdef0"
],
"detail": {
"instance-id": " i-1234567890abcdef0",
"state": "terminated"
}
}
有効なカスタムイベントに必要な最小限の情報
カスタムイベントを作成する場合、次のフィールドが含まれている必要があります。
detail
detail-type
source
{
"detail-type": "event name
",
"source": "event source
",
"detail": {
}
}