本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 記錄 AWS Elemental MediaConvert API 呼叫 AWS CloudTrail
AWS Elemental MediaConvert 與 整合 AWS CloudTrail，此服務提供使用者、角色或 AWS 服務所採取之操作的記錄。CloudTrail 會將您執行的所有操作 (API 呼叫） 擷取為事件，包括來自 MediaConvert 主控台的操作。事件包含對 MediaConvert 提出請求的相關資訊，包括 IP 地址、提出請求的人員、提出請求的時間、MediaConvert 操作和其他詳細資訊。如需 CloudTrail 事件的詳細資訊，請參閱[什麼是 CloudTrail 事件？](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-concepts.html#cloudtrail-concepts-events)
CloudTrail 可協助您找到的幾個範例包括：當您提交建立任務請求時、誰刪除佇列，或將哪些標籤新增至資源。
如需您可以執行的所有 MediaConvert 操作的完整清單，請參閱 [MediaConvert API 參考](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 主控台的事件[歷史記錄中檢視、搜尋和下載過去 90 天內的事件](https://console.aws.amazon.com/cloudtrailv2/home?region=us-west-2#/events)。如需詳細資訊，請參閱[使用 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 追蹤的詳細資訊，請參閱[使用 CloudTrail 追蹤](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-getting-started.html)。
**CloudTrail Lake 事件資料存放區**
透過 CloudTrail Lake 事件資料存放區，CloudTrail 會提供事件資料的可搜尋存放區。如需詳細資訊，請參閱[使用 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 管理事件代表來自任何來源的單一請求。其中包括請求的來源、提出請求的人員、提出請求的時間、MediaConvert 操作和其他重要詳細資訊的相關資訊。
如需這些事件內容的詳細資訊，請參閱 [CloudTrail 記錄內容](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-record-contents.html)。
**Origin**
事件包括 下的來源 IP 地址`sourceIPAddress`、 下的 AWS 區域`awsRegion`，以及 下的 使用者代理程式 （瀏覽器或用戶端資訊）`userAgent`，以協助您尋找請求的來源。
**Identity**
事件包含身分資訊，位於 下`userIdentity`，可協助您尋找提出請求的人員。您可利用該資訊判斷下列事項：
+ 該請求是使用根使用者還是使用者憑證提出。
+ 請求是否代表 IAM Identity Center 使用者提出。
+ 提出該請求時，是否使用了特定角色或聯合身分使用者的暫時安全憑證。
+ 該請求是否由另一項 AWS 服務服務提出。
如需詳細資訊，包括相關欄位的清單，請參閱 [CloudTrail userIdentity 元素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)。
**時間**
事件包含時間戳記，位於 下`eventTime`。
**MediaConvert 操作**
事件包括 下的 MediaConvert 操作`eventName`。例如，`CreateJob`當您提交新任務或請求新佇列`CreateQueue`時。
**其他重要詳細資訊**
有些事件包含 下 MediaConvert 請求的特定詳細資訊`requestParameters`，以及 下的 MediaConvert 回應`responseElements`。
例如，如果您提交`CreateJob`請求， `requestParameters` 欄位將包含您提交之任務設定的 JSON。如果成功，事件也會包含完整且經過驗證的任務設定 JSON，以及 下的任務 ID`responseElements`。
對於另一個範例，如果您提交`CreateQueue`請求， `requestParameters` 欄位將包含您提交的佇列設定。如果成功，事件也會包含 下的佇列 ARN`responseElements`。
**注意**
MediaConvert 僅支援在 CloudTrail 中記錄管理事件，不支援資料事件。如需這些事件類型及其差異的詳細資訊，請參閱 [CloudTrail 概念](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-concepts.html)。
### 範例事件
下列範例顯示 `CreateJob`、`DeleteQueue`、 和 `TagResource`操作的 CloudTrail `CreateQueue`事件。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"
}
```