終止支援通知：2027 年 3 月 31 日， AWS 將終止對 Amazon WorkSpaces 精簡型客戶端的支援。2027 年 3 月 31 日之後，您將無法再存取 WorkSpaces 精簡型客戶端主控台或 WorkSpaces 精簡型客戶端資源。如需詳細資訊，請參閱 [Amazon WorkSpaces 精簡型客戶端終止支援](https://docs.aws.amazon.com/workspaces-thin-client/latest/ag/workspacesthinclient-end-of-support.html)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 記錄 Amazon WorkSpaces 精簡型客戶端 API 呼叫 AWS CloudTrail
Amazon WorkSpaces 精簡型客戶端與 整合[AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)，這項服務可提供使用者、角色或 所採取動作的記錄 AWS 服務。CloudTrail 會將 WorkSpaces 精簡型客戶端的所有 API 呼叫擷取為事件。擷取的呼叫包括來自 WorkSpaces 精簡型客戶端主控台的呼叫，以及對 WorkSpaces 精簡型客戶端 API 操作發出的程式碼呼叫。您可以使用 CloudTrail 所收集的資訊，判斷對 WorkSpaces 精簡型客戶端提出的請求、提出請求的 IP 地址、提出請求的時間，以及其他詳細資訊。
CloudTrail 會記錄所有 Amazon WorkSpaces 精簡型客戶端動作，並記錄在 [Amazon WorkSpaces 精簡型客戶端 API 參考](https://docs.aws.amazon.com/workspaces-thin-client/latest/api/API_Operations.html)中。例如，對 `CreateEnvironment`、`DeleteDevice` 和 `GetSoftwareSet` 動作發出的呼叫會在 CloudTrail 記錄檔案中產生專案。
每一筆事件或日誌專案都會包含產生請求者的資訊。身分資訊可協助您判斷下列事項：
+ 該請求是使用根使用者還是使用者憑證提出。
+ 請求是否代表 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 中的 WorkSpaces 精簡型客戶端資料事件
[資料事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events)提供有關在資源上執行或在資源中執行的資源操作的資訊 （例如，最終使用者註冊裝置）。這些也稱為資料平面操作。資料事件通常是大量資料的活動。根據預設，CloudTrail 不會記錄資料事件。CloudTrail **事件歷史記錄**不會記錄資料事件。
資料事件需支付額外的費用。如需 CloudTrail 定價的詳細資訊，請參閱 [AWS CloudTrail 定價](https://aws.amazon.com/cloudtrail/pricing/)。
您可以使用 CloudTrail 主控台或 CloudTrail API 操作 AWS CLI，記錄 WorkSpaces 精簡型客戶端資源類型的資料事件。如需如何記錄資料事件的詳細資訊，請參閱 *AWS CloudTrail 使用者指南*中的[使用 AWS 管理主控台 記錄資料事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events-console)和[使用 AWS Command Line Interface記錄資料事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#creating-data-event-selectors-with-the-AWS-CLI)。
下表列出您可以記錄資料事件的 WorkSpaces 精簡型客戶端資源類型。**資料事件類型 (主控台)** 資料行會顯示從 CloudTrail 主控台上的**資料事件類型**清單中選擇的值。**resources.type 值**欄會顯示值，您會在使用 AWS CLI 或 CloudTrail APIs 設定進階事件選取器時指定此`resources.type`值。**記錄到 CloudTrail 的資料 API** 資料行會針對資源類型顯示記錄到 CloudTrail 的 API 呼叫。
| 資料事件類型 (主控台) | resources.type 值 | 記錄到 CloudTrail 的資料 API |
| --- | --- | --- |
| ThinClientDevice | AWS::WorkSpacesThinClient::Device | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/workspaces-thin-client/latest/ag/logging-using-cloudtrail.html) |
您可以設定進階事件選取器來篩選 `eventName`、`readOnly` 和 `resources.ARN` 欄位，以僅記錄對您重要的事件。如需這些欄位的詳細資訊，請參閱AWS CloudTrail API 參考**中的[https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html)。
## CloudTrail 中的 WorkSpaces 精簡型客戶端管理事件
[管理事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events)提供有關在 資源上執行的管理操作的資訊 AWS 帳戶。這些也稱為控制平面操作。根據預設，CloudTrail 記錄管理事件。
Amazon WorkSpaces 精簡型客戶端會將所有 WorkSpaces 精簡型客戶端控制平面操作記錄為管理事件。如需 WorkSpaces 精簡型客戶端記錄到 CloudTrail 的 Amazon WorkSpaces 精簡型客戶端控制平面操作清單，請參閱 [Amazon WorkSpaces 精簡型客戶端 API 參考](https://docs.aws.amazon.com/workspaces-thin-client/latest/api/)。 CloudTrail
## WorkSpaces 精簡型客戶端事件範例
一個事件代表任何來源提出的單一請求，並包含請求 API 操作的相關資訊、操作的日期和時間、請求參數等。CloudTrail 日誌檔案不是公有 API 呼叫的已排序堆疊追蹤，因此事件不會以任何特定順序顯示。
以下範例顯示的 CloudTrail 事件會示範 `RegisterDevice` 操作。
```
{
"eventVersion": "1.10",
"userIdentity": {
"type": "Unknown",
"accountId": "111111111111",
"userName": "DSN: G1X11X11111111XX"
},
"eventTime": "2024-06-19T17:13:44Z",
"eventSource": "thinclient.amazonaws.com",
"eventName": "RegisterDevice",
"awsRegion": "us-west-2",
"sourceIPAddress": "AWS Internal",
"userAgent": "AWS Internal",
"requestParameters": {
"dsn": "G1X11X11111111XX",
"activationCode": "xxx1xxx1",
"model": "AFTGAZL"
},
"responseElements": null,
"requestID": "f626fb2b-a841-4b87-9a9b-685a62024058",
"eventID": "214385d7-9249-4f60-af56-b4c951e0491d",
"readOnly": false,
"resources": [
{
"type": "AWS::ThinClient::Device",
"ARN": "arn:aws:thinclient:us-west-2:111111111111:device/DEVICE_ID"
}
],
"eventType": "AwsApiCall",
"managementEvent": false,
"recipientAccountId": "111111111111",
"eventCategory": "Data"
}
```
以下範例顯示的 CloudTrail 事件會示範 `UpdateDeviceDetails` 操作。
```
{
"eventVersion": "1.10",
"userIdentity": {
"type": "Unknown",
"accountId": "111111111111",
"userName": "DSN: G1X11X11111111XX"
},
"eventTime": "2024-10-21T17:46:27Z",
"eventSource": "thinclient.amazonaws.com",
"eventName": "UpdateDeviceDetails",
"awsRegion": "us-west-2",
"sourceIPAddress": "AWS Internal",
"userAgent": "AWS Internal",
"requestParameters": null,
"responseElements": null,
"requestID": "7d562fcf-a9ce-40da-9e5c-9ef390b8b83c",
"eventID": "f294b614-b00c-45ef-b293-cd389121033a",
"readOnly": false,
"resources": [
{
"type": "AWS::ThinClient::Device",
"ARN": "arn:aws:thinclient:us-west-2:111111111111:device/DEVICE_ID"
}
],
"eventType": "AwsServiceEvent",
"managementEvent": false,
"recipientAccountId": "111111111111",
"serviceEventDetails": {
"settings": {
"network": {
"ethernet": {
"addresses": [
{
"gateway": "gateway",
"localIp": "localIp",
"type": "IPV4"
}
],
"connectionStatus": "NOT_CONNECTED"
},
"networkInterfaceInUse": "ETHERNET",
"wifi": {
"addresses": [
{
"gateway": "gateway",
"localIp": "localIp",
"type": "IPV4"
}
],
"connectionStatus": "NOT_CONNECTED"
}
},
"peripherals": {
"bluetooth": {
"enabledStatus": "ENABLED"
},
"keyboards": [
{
"name": "name",
"type": "USB"
}
],
"mice": [
{
"name": "name",
"type": "BLUETOOTH"
}
],
"sound": {
"microphones": [
{
"name": "name",
"selectionStatus": "SELECTED",
"type": "BUILT_IN"
}
],
"speakers": [
{
"name": "name",
"selectionStatus": "SELECTED",
"type": "BUILT_IN"
}
]
},
"webcams": [
{
"name": "name",
"selectionStatus": "SELECTED",
"type": "USB"
}
]
},
"powerAndSleep": {
"sleepAfter": "FIFTEEN_MINUTES"
}
},
"updatedAt": "2024-10-21T17:46:27.624Z"
},
"eventCategory": "Data"
}
```
如需有關 CloudTrail 記錄內容的資訊，請參閱《AWS CloudTrail 使用者指南》**中的 [CloudTrail record contents](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-record-contents.html)。