翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# を使用した AWS Elemental MediaConvert API コールのログ記録 AWS CloudTrail
AWS Elemental MediaConvert は、ユーザー AWS CloudTrail、ロール、または サービスによって実行されたオペレーションを記録する AWS サービスと統合されます。CloudTrail は、ユーザーが実行したすべてのオペレーション (API コール) を、MediaConvert コンソールから実行されたものも含めイベントとしてキャプチャします。イベントには、IP アドレス、リクエストの実行者、実行日時、MediaConvert オペレーション、その他詳細など、MediaConvert へのリクエストに関する情報が含まれます。CloudTrail イベントの詳細については、「[What are CloudTrail events?](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-concepts.html#cloudtrail-concepts-events)」を参照してください。
CloudTrail は、ジョブ作成リクエストの送信日時、キューを削除したユーザー、リソースに追加されたタグなどを確認する際に役立ちます。
ユーザーが実行できる MediaConvert オペレーションの完全なリストについては、「[MediaConvert API Reference](https://docs.aws.amazon.com/mediaconvert/latest/apireference/resources.html)」を参照してください。
CloudTrail の詳細については、「[AWS CloudTrail ユーザーガイド](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)」を参照してください。
**Topics**
+ [CloudTrail で MediaConvert に関する情報を検索する](#service-name-info-in-cloudtrail)
+ [MediaConvert の CloudTrail 管理イベントを理解する](#understanding-service-name-entries)
## CloudTrail で MediaConvert に関する情報を検索する
CloudTrail コンソールでは、[[イベント履歴]](https://console.aws.amazon.com/cloudtrailv2/home?region=us-west-2#/events) から過去 90 日間のイベントを閲覧、検索、ダウンロードすることができます。詳細については、「[CloudTrail イベント履歴の操作](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)」を参照してください。
過去 90 日より前の CloudTrail イベントを継続的に記録するには、CloudTrail *証跡* または CloudTrail Lake イベントデータストアを作成する必要があります。
**CloudTrail 証跡**
CloudTrail は、CloudTrail 証跡を使用してイベントのログファイルを Amazon S3 バケットに配信します。さらに、他の AWS サービスを設定して、収集された[イベントデータをさらに分析して対応](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)できます。証跡を作成すると、CloudTrail も[各イベントを Amazon EventBridge に出力します](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html)。CloudTrail 証跡の詳細については、「[Working with CloudTrail trails](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html)」を参照してください。
**CloudTrail Lake イベントデータストア**
CloudTrail は、CloudTrail Lake イベントデータストアを使用して、イベントデータに関する検索可能なストアを提供します。詳細については、「[CloudTrail Lake の使用](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html)」を参照してください。
## MediaConvert の CloudTrail 管理イベントを理解する
[管理イベント](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events)は、 のリソースで実行される管理オペレーションに関する情報を提供します AWS アカウント。これらのイベントは、コントロールプレーンオペレーションまたは MediaConvert オペレーションとも呼ばれます。CloudTrail は、デフォルトですべての管理イベントを記録します。
CloudTrail 管理イベント は、任意の送信元から届く 1 つのリクエストを表します。これには、リクエストの発信元、リクエストの実行者、実行日時、MediaConvert オペレーション、その他の重要な詳細に関する情報が含まれています。
イベントの内容に関する詳細は、「[CloudTrail record contents](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-record-contents.html)」を参照してください。
**オリジン**
イベントには、リクエストの発信元を特定するのに役立つ、`sourceIPAddress` のソース IP アドレス、`awsRegion` の AWS リージョン、`userAgent` のユーザーエージェント (ブラウザまたはクライアント情報) が含まれています。
**アイデンティティ**
イベントには、リクエストを実行したユーザーを特定するのに役立つ `userIdentity` の ID 情報が含まれています。この情報をもとに、以下のことを判断できます。
+ ルートユーザーまたはユーザー認証情報のどちらを使用してリクエストが送信されたか。
+ リクエストが IAM Identity Center ユーザーに代わって行われたかどうか。
+ リクエストがロールまたはフェデレーションユーザーのテンポラリなセキュリティ認証情報を使用して行われたかどうか。
+ リクエストが、別の AWS のサービスによって送信されたかどうか。
関連フィールドのリストなど、その他の詳細については、「[CloudTrail userIdentity element](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)」を参照してください。
**Time**
イベントの `eventTime` にタイムスタンプが含まれます。
**MediaConvert オペレーション**
イベントの `eventName` に MediaConvert オペレーションが含まれます。例えば、新しいジョブを送信するときの `CreateJob` や、新しいキューをリクエストするときの `CreateQueue` などです。
**その他の重要な詳細**
一部のイベントでは、`requestParameters` に MediaConvert リクエストに関する具体的な詳細が含まれ、`responseElements` に MediaConvert のレスポンスが含まれます。
例えば、`CreateJob` リクエストを送信すると、`requestParameters` フィールドには、送信したジョブ設定の JSON が追加されます。成功すると、イベントの `responseElements` に、完全かつ検証済みのジョブ設定 JSON やジョブ ID も追加されます。
別の例では、`CreateQueue` リクエストを送信すると `requestParameters` フィールドに送信したキュー設定が追加されます。成功すると、イベントの `responseElements` にキュー ARN も追加されます。
**注記**
MediaConvert は、CloudTrail における管理イベントの記録のみをサポートしており、データイベントはサポートしていません。詳しいイベントタイプとそれぞれの違いについては、「[CloudTrail concepts](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-concepts.html)」を参照してください。
### イベントの例
以下の例は、`CreateJob`、`CreateQueue`、`DeleteQueue`、`TagResource` の各オペレーションの CloudTrail イベントを示したものです。こちらでは紹介していませんが、CloudTrail は他のすべての [MediaConvert オペレーション](https://docs.aws.amazon.com/mediaconvert/latest/apireference/resources.html)も記録します。
**イベント例: CreateJob**
```
{
"eventVersion": "1.09",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AKIAIOSFODNN7EXAMPLE:example-admin",
"arn": "arn:aws:sts::111122223333:assumed-role/admin/example-admin",
"accountId": "111122223333",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AKIAIOSFODNN7EXAMPLE",
"arn": "arn:aws:iam::111122223333:role/admin",
"accountId": "111122223333",
"userName": "admin"
},
"attributes": {
"creationDate": "2024-04-04T17:30:19Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2024-04-04T17:45:26Z",
"eventSource": "mediaconvert.amazonaws.com",
"eventName": "CreateJob",
"awsRegion": "us-west-2",
"sourceIPAddress": "203.0.113.100",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36",
"requestParameters": {
"settings": {...},
"accelerationSettings": {
"mode": "DISABLED"
},
"role": "arn:aws:iam::111122223333:role/service-role/MediaConvert_Default_Role",
"clientRequestToken": "1712252705233-zyxwvut",
"statusUpdateInterval": "SECONDS_60",
"billingTagsSource": "JOB",
"priority": 0,
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default"
},
"responseElements": {
"job": {
"arn": "arn:aws:mediaconvert:us-west-2:111122223333:jobs/1712252725875-defhgi",
"id": "1712252725875-defhgi",
"createdAt": 1712252726,
"queue": "arn:aws:mediaconvert:us-west-2:111122223333:queues/Default",
"role": "arn:aws:iam::111122223333:role/service-role/MediaConvert_Default_Role",
"settings": {...},
"status": "SUBMITTED",
"timing": {
"submitTime": 1712252726
},
"billingTagsSource": "JOB",
"accelerationSettings": {
"mode": "DISABLED"
},
"statusUpdateInterval": "SECONDS_60",
"priority": 0,
"accelerationStatus": "NOT_APPLICABLE",
"messages": {
"info": [],
"warning": []
},
"clientRequestToken": "1712252705233-abcDEF"
}
},
"requestID": "1234abcd-12ab-34cd-56ef-1234567890ab",
"eventID": "0987dcba-09fe-87dc-65ba-ab0987654321",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "111122223333",
"eventCategory": "Management"
}
```
**イベント例: CreateQueue**
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "AKIAIOSFODNN7EXAMPLE",
"arn": "arn:aws:iam::111122223333:user/testuser",
"accountId": "111122223333",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"userName": "testUser",
"sessionContext": {
"attributes": {
"mfaAuthenticated": "false",
"creationDate": "2018-07-10T14:01:57Z"
}
},
"invokedBy": "signin.amazonaws.com"
},
"eventTime": "2018-07-10T16:49:13Z",
"eventSource": "mediaconvert.amazonaws.com",
"eventName": "CreateQueue",
"awsRegion": "eu-west-1",
"sourceIPAddress": "203.0.113.100",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36",
"requestParameters": {
"name": "QueueName",
"description": "Example queue description.",
"tags": {}
},
"responseElements": {
"queue": {
"arn": "arn:aws:mediaconvert:eu-west-1:111122223333:queues/QueueName",
"createdAt": 1531241353,
"lastUpdated": 1531241353,
"type": "CUSTOM",
"status": "ACTIVE",
"description": "",
"name": "QueueName",
"submittedJobsCount": 0,
"progressingJobsCount": 0
}
},
"requestID": "1234abcd-12ab-34cd-56ef-1234567890ab",
"eventID": "0987dcba-09fe-87dc-65ba-ab0987654321",
"readOnly": false,
"eventType": "AwsApiCall",
"recipientAccountId": "111122223333"
}
```
**イベント例: DeleteQueue**
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "AKIAIOSFODNN7EXAMPLE",
"arn": "arn:aws:iam::111122223333:user/testuser",
"accountId": "111122223333",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"userName": "testuser",
"sessionContext": {
"attributes": {
"mfaAuthenticated": "false",
"creationDate": "2018-07-10T14:01:57Z"
}
},
"invokedBy": "signin.amazonaws.com"
},
"eventTime": "2018-07-10T15:36:29Z",
"eventSource": "mediaconvert.amazonaws.com",
"eventName": "DeleteQueue",
"awsRegion": "eu-west-1",
"sourceIPAddress": "203.0.113.100",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36",
"requestParameters": {
"name": "QueueName"
},
"responseElements": null,
"requestID": "1234abcd-12ab-34cd-56ef-1234567890ab",
"eventID": "0987dcba-09fe-87dc-65ba-ab0987654321",
"readOnly": false,
"eventType": "AwsApiCall",
"recipientAccountId": "111122223333"
}
```
**イベント例: TagResource**
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "AKIAIOSFODNN7EXAMPLE",
"arn": "arn:aws:iam::111122223333:user/testuser",
"accountId": "111122223333",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"userName": "testuser"
},
"eventTime": "2018-07-10T18:44:27Z",
"eventSource": "mediaconvert.amazonaws.com",
"eventName": "TagResource",
"awsRegion": "eu-west-1",
"sourceIPAddress": "203.0.113.100",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36",
"requestParameters": {
"arn": "arn:aws:mediaconvert:eu-west-1:111122223333:queues/ExampleQueue",
"Tags": {
"CostCenter": "Example-Tag"
}
},
"responseElements": null,
"requestID": "1234abcd-12ab-34cd-56ef-1234567890ab",
"eventID": "0987dcba-09fe-87dc-65ba-ab0987654321",
"readOnly": false,
"eventType": "AwsApiCall",
"recipientAccountId": "111122223333"
}
```