本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 記錄受管整合 API 呼叫 AWS CloudTrail
受管整合與 整合[AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)，此服務提供由使用者、角色或 所採取動作的記錄 AWS 服務。CloudTrail 會將受管整合的所有 API 呼叫擷取為事件。擷取的呼叫包括從受管整合主控台的呼叫，以及對受管整合 API 操作的程式碼呼叫。您可以使用 CloudTrail 所收集的資訊，判斷對受管整合提出的請求、提出請求的 IP 地址、提出請求的時間，以及其他詳細資訊。
每一筆事件或日誌專案都會包含產生請求者的資訊。身分資訊可協助您判斷下列事項：
+ 該請求是使用根使用者還是使用者憑證提出。
+ 請求是否代表 IAM Identity Center 使用者提出。
+ 提出該請求時，是否使用了特定角色或聯合身分使用者的暫時安全憑證。
+ 該請求是否由另一項 AWS 服務服務提出。
當您建立帳戶 AWS 帳戶 時CloudTrail 會在 中處於作用中狀態，而且您會自動存取 CloudTrail **事件歷史記錄**。CloudTrail **事件歷史記錄**為 AWS 區域中過去 90 天記錄的管理事件，提供可檢視、可搜尋、可下載且不可變的記錄。如需詳細資訊，請參閱「AWS CloudTrail 使用者指南」**中的[使用 CloudTrail 事件歷史記錄](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)。檢視**事件歷史記錄**不會產生 CloudTrail 費用。
如需 AWS 帳戶 過去 90 天內持續記錄的事件，請建立線索或 [CloudTrail Lake](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html) 事件資料存放區。
**CloudTrail 追蹤**
*線索*能讓 CloudTrail 將日誌檔案交付至 Amazon S3 儲存貯體。使用 建立的所有線索 AWS 管理主控台 都是多區域。您可以使用 AWS CLI建立單一或多區域追蹤。建議您建立多區域追蹤，因為您擷取 AWS 區域 帳戶中所有 的活動。如果您建立單一區域追蹤，您只能檢視追蹤 AWS 區域中記錄的事件。如需追蹤的詳細資訊，請參閱《AWS CloudTrail 使用者指南》**中的[為您的 AWS 帳戶建立追蹤](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)和[為組織建立追蹤](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-trail-organization.html)。
您可以透過建立追蹤，免費將持續管理事件的一個複本從 CloudTrail 傳遞至您的 Amazon S3 儲存貯體，但這樣做會產生 Amazon S3 儲存費用。如需 CloudTrail 定價的詳細資訊，請參閱 [AWS CloudTrail 定價](https://aws.amazon.com/cloudtrail/pricing/)。如需 Amazon S3 定價的相關資訊，請參閱 [Amazon S3 定價](https://aws.amazon.com/s3/pricing/)。
**CloudTrail Lake 事件資料存放區**
*CloudTrail Lake* 讓您能夠對事件執行 SQL 型查詢。CloudTrail Lake 會將分列式 JSON 格式的現有事件轉換為 [Apache ORC](https://orc.apache.org/) 格式。ORC 是一種單欄式儲存格式，針對快速擷取資料進行了最佳化。系統會將事件彙總到*事件資料存放區*中，事件資料存放區是事件的不可變集合，其依據為您透過套用[進階事件選取器](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-concepts.html#adv-event-selectors)選取的條件。套用於事件資料存放區的選取器控制哪些事件持續存在並可供您查詢。如需 CloudTrail Lake 的詳細資訊，請參閱*AWS CloudTrail 《 使用者指南*》中的[使用 AWS CloudTrail Lake](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html)。
CloudTrail Lake 事件資料存放區和查詢會產生費用。建立事件資料存放區時，您可以選擇要用於事件資料存放區的[定價選項](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-manage-costs.html#cloudtrail-lake-manage-costs-pricing-option)。此定價選項將決定擷取和儲存事件的成本，以及事件資料存放區的預設和最長保留期。如需 CloudTrail 定價的詳細資訊，請參閱 [AWS CloudTrail 定價](https://aws.amazon.com/cloudtrail/pricing/)。
## CloudTrail 中的管理事件
[管理事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events)提供有關在 資源上執行的管理操作的資訊 AWS 帳戶。這些也稱為控制平面操作。根據預設，CloudTrail 記錄管理事件。
受管整合會將下列受管整合控制平面操作記錄到 CloudTrail 做為*管理事件*。
+ `CreateCloudConnector`
+ `UpdateCloudConnector`
+ `GetCloudConnector`
+ `DeleteCloudConnector`
+ `ListCloudConnectors`
+ `CreateConnectorDestination`
+ `UpdateConnectorDestination`
+ `GetConnectorDestination`
+ `DeleteConnectorDestination`
+ `ListConnectorDestinations`
+ `CreateAccountAssociation`
+ `UpdateAccountAssociation`
+ `GetAccountAssociation`
+ `DeleteAccountAssociation`
+ `ListAccountAssociations`
+ `StartAccountAssociationRefresh`
+ `ListManagedThingAccountAssociations`
+ `RegisterAccountAssociation`
+ `DeregisterAccountAssociation`
+ `SendConnectorEvent`
+ `ListDeviceDiscoveries`
+ `ListDiscoveredDevices`
## 事件範例
一個事件代表任何來源提出的單一請求，並包含請求 API 操作的相關資訊、操作的日期和時間、請求參數等。CloudTrail 日誌檔案不是公有 API 呼叫的已排序堆疊追蹤，因此事件不會以任何特定順序顯示。
下列範例顯示示範成功 `CreateCloudConnector` API 操作的 CloudTrail 事件。
**使用 `CreateCloudConnector` API 操作成功執行 CloudTrail 事件。**
```
{
"eventVersion": "1.09",
"userIdentity": {
"type": "AssumedRole",
"principalId": "EXAMPLE",
"arn": "arn:aws:sts::111122223333:assumed-role/Admin/EXAMPLE",
"accountId": "111122223333",
"accessKeyId": "EXAMPLEKYSBQSCGRIC",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AROAZOZQFKYSFZVB2J2GN",
"arn": "arn:aws:iam::111122223333:role/Admin",
"accountId": "111122223333",
"userName": "Admin"
},
"attributes": {
"creationDate": "2025-06-05T18:26:16Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2025-06-05T18:30:40Z",
"eventSource": "iotmanagedintegrations.amazonaws.com",
"eventName": "CreateCloudConnector",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.0",
"userAgent": "PostmanRuntime/7.44.0",
"requestParameters": {
"EndpointType": "LAMBDA",
"Description": "Manual testing for C2C CT Validation",
"ClientToken": "abc7460",
"EndpointConfig": {
"lambda": {
"arn": "arn:aws:lambda:us-east-1:111122223333:function:LightweightMockConnector7460"
}
},
"Name": "EdenManualTestCloudConnector"
},
"responseElements": {
"X-Frame-Options": "DENY",
"Access-Control-Expose-Headers": "Content-Length,Content-Type,X-Amzn-Errortype,X-Amzn-Requestid",
"Strict-Transport-Security": "max-age:47304000; includeSubDomains",
"Cache-Control": "no-store, no-cache",
"X-Content-Type-Options": "nosniff",
"Content-Security-Policy": "upgrade-insecure-requests; default-src 'none'; object-src 'none'; frame-ancestors 'none'; base-uri 'none'",
"Pragma": "no-cache",
"Id": "f7e633e719404c4a933596b4d0cc276e",
"Arn": "arn:aws:iotmanagedintegrations:us-east-1:111122223333:cloud-connector/EXAMPLE404c4a933596b4d0cc276e"
},
"requestID": "c0071fd1-b8e0-400a-bcc0-EXAMPLE9e4",
"eventID": "95b318ea-2f63-4183-9c22-EXAMPLE3e",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "111122223333",
"eventCategory": "Management"
}
```
下列範例顯示示範成功 `ListDiscoveredDevices` API 操作的 CloudTrail 事件。
**使用 `ListDiscoveredDevices` API 操作成功執行 CloudTrail 事件。**
```
{
"eventVersion": "1.09",
"userIdentity": {
"type": "AssumedRole",
"principalId": "EZAMPLE",
"arn": "arn:aws:sts::444455556666:assumed-role/Admin/EXAMPLE",
"accountId": "444455556666",
"accessKeyId": "EXAMPLERJ26PYMH",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "EXAMPLE",
"arn": "arn:aws:iam::444455556666:role/Admin",
"accountId": "444455556666",
"userName": "Admin"
},
"attributes": {
"creationDate": "2025-06-10T23:37:31Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2025-06-10T23:38:07Z",
"eventSource": "iotmanagedintegrations.amazonaws.com",
"eventName": "ListDiscoveredDevices",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.0",
"userAgent": "EXAMPLE-runtime/2.4.0",
"requestParameters": {
"Identifier": "EXAMPLE4f268483a17d8060f014"
},
"responseElements": null,
"requestID": "27ae1f61-e2e6-43e4-bf17-EXAMPLEa568",
"eventID": "34734e81-76a8-49a4-9641-EXAMPLE28ed",
"readOnly": true,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "444455556666",
"eventCategory": "Management"
}
```
如需有關 CloudTrail 記錄內容的資訊，請參閱《AWS CloudTrail 使用者指南》**中的 [CloudTrail record contents](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-record-contents.html)。