翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS Elemental MediaTailor API コールの記録
AWS Elemental MediaTailor は AWS CloudTrail、MediaTailor のユーザー、ロール、または のサービスによって実行されたアクションを記録する AWS サービスである と統合されています。CloudTrail は、MediaTailor のすべての API コールをイベントとしてキャプチャします。キャプチャされたコールには、MediaTailor コンソールからのコールと、MediaTailor API オペレーションへのコードコールが含まれます。証跡を作成する場合は、Amazon S3 バケットへの CloudTrail イベント (MediaTailor のイベントを含む) の継続的な配信を有効にすることができます。証跡を設定しない場合でも、CloudTrail コンソールの **[イベント履歴]** で最新のイベントを表示できます。CloudTrail が収集した情報を使用して、MediaTailor に対して行われたリクエスト、リクエスト元の IP アドレス、リクエスト者、リクエスト日時、および追加の詳細情報を確認できます。
CloudTrail の詳細については、[AWS CloudTrail ユーザーガイド](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)を参照してください。
## AWS Elemental MediaTailor CloudTrail の情報
CloudTrail は、 AWS アカウントの作成時にアカウントで有効になります。アクティビティが発生すると AWS Elemental MediaTailor、そのアクティビティはイベント**履歴**の他の AWS サービスイベントとともに CloudTrail イベントに記録されます。 AWS アカウントで最近のイベントを表示、検索、ダウンロードできます。詳細については、「[CloudTrail Event 履歴でのイベントの表示](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)」を参照してください。
のイベントなど、 AWS アカウントのイベントの継続的な記録については AWS Elemental MediaTailor、証跡を作成します。*証跡*により、CloudTrail はログファイルを Amazon S3 バケットに配信できます。デフォルトでは、コンソールで証跡を作成すると、証跡はすべての AWS リージョンに適用されます。証跡は、 AWS パーティション内のすべてのリージョンからのイベントをログに記録し、指定した Amazon S3 バケットにログファイルを配信します。さらに、CloudTrail ログで収集されたイベントデータをさらに分析して処理するように他の AWS サービスを設定できます。詳細については次を参照してください:
+ [AWS アカウントの証跡の作成](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [AWS CloudTrail ログとの サービス統合](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ 「[CloudTrail の Amazon SNS 通知の設定](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)」
+ [複数のリージョンから CloudTrail ログファイルを受け取る](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)および[複数のアカウントから CloudTrail ログファイルを受け取る](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
すべての AWS Elemental MediaTailor アクションは CloudTrail によってログに記録され、[AWS Elemental MediaTailor API リファレンス](https://docs.aws.amazon.com/mediatailor/latest/apireference/Welcome.html)に記載されています。例えば、`PutPlaybackConfiguration` と `ListPlaybackConfigurations` オペレーションへのコールは、CloudTrail ログファイルにエントリを生成します。
各イベントまたはログエントリには、誰がリクエストを生成したかという情報が含まれます。アイデンティティ情報は、以下を判別するのに役立ちます。
+ リクエストがルートユーザーまたは AWS Identity and Access Management (IAM) 認証情報を使用して行われたかどうか
+ リクエストの送信に使用された一時的なセキュリティ認証情報に、ロールとフェデレーテッドユーザーのどちらが使用されたか
+ リクエストが別の AWS サービスによって行われたかどうか
詳細については、[CloudTrail userIdentity 要素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)を参照してください。
## AWS Elemental MediaTailor ログファイルエントリについて
「トレイル」は、指定した Amazon S3 バケットにイベントをログファイルとして配信するように設定できます。CloudTrail のログファイルは、単一か複数のログエントリを含みます。イベントは、任意の出典からの単一のリクエストを表し、リクエストされたアクション、アクションの日時、リクエストパラメータなどに関する情報が含まれます。CloudTrail ログファイルは、パブリック API 呼び出しの順序付けられたスタックトレースではないため、特定の順序では表示されません。
以下は、`PutPlaybackConfiguration` アクションを示す CloudTrail ログエントリの例です。
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "AIDAEXAMPLE",
"arn": "arn:aws:iam::111122223333:user/testuser",
"accountId": "111122223333",
"accessKeyId": "AIDAEXAMPLE",
"userName": "testuser"
},
"eventTime": "2018-12-28T22:53:46Z",
"eventSource": "mediatailor.amazonaws.com",
"eventName": "PutPlaybackConfiguration",
"awsRegion": "us-west-2",
"sourceIPAddress": "1.2.3.4",
"userAgent": "PostmanRuntime/7.4.0",
"requestParameters": {
"VideoContentSourceUrl": "http://examplevideo.com",
"Name": "examplename",
"AdDecisionServerUrl": "http://exampleads.com"
},
"responseElements": {
"SessionInitializationEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/session/AKIAIOSFODNN7EXAMPLE/examplename/",
"DashConfiguration": {
"ManifestEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/dash/AKIAIOSFODNN7EXAMPLE/examplename/",
"MpdLocation": "EMT_DEFAULT"
},
"AdDecisionServerUrl": "http://exampleads.com",
"CdnConfiguration": {},
"PlaybackEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com",
"HlsConfiguration": {
"ManifestEndpointPrefix": "https://777788889999.mediatailor.us-east-1.amazonaws.com/v1/master/AKIAIOSFODNN7EXAMPLE/examplename/"
},
"VideoContentSourceUrl": "http://examplevideo.com",
"Name": "examplename"
},
"requestID": "1a2b3c4d-1234-5678-1234-1a2b3c4d5e6f",
"eventID": "987abc65-1a2b-3c4d-5d6e-987abc654def",
"readOnly": false,
"eventType": "AwsApiCall",
"recipientAccountId": "111122223333"
}
```
以下は、`GetPlaybackConfiguration` アクションを示す CloudTrail ログエントリの例です。
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "AIDAEXAMPLE",
"arn": "arn:aws:iam::111122223333:user/testuser",
"accountId": "111122223333",
"accessKeyId": "AIDAEXAMPLE",
"userName": "testuser"
},
"eventTime": "2018-12-28T22:52:37Z",
"eventSource": "mediatailor.amazonaws.com",
"eventName": "GetPlaybackConfiguration",
"awsRegion": "us-west-2",
"sourceIPAddress": "1.2.3.4",
"userAgent": "PostmanRuntime/7.4.0",
"requestParameters": {
"Name": "examplename"
},
"responseElements": null,
"requestID": "0z1y2x3w-0123-4567-9876-6q7r8s9t0u1v",
"eventID": "888ddd77-3322-eeww-uuii-abc123jkl343",
"readOnly": true,
"eventType": "AwsApiCall",
"recipientAccountId": "111122223333"
}
```