本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 CloudTrail 記錄 WorkSpaces API 呼叫
<a name="cloudtrail_logging"></a>

WorkSpaces API 已與 整合 AWS CloudTrail，此服務提供使用者、角色或 WorkSpaces 中 AWS 服務所採取之動作的記錄。CloudTrail 會將 WorkSpaces 的 API 呼叫擷取為事件。擷取的呼叫包括來自 WorkSpaces 主控台的呼叫，以及對 WorkSpaces API 操作的程式碼呼叫。如果您建立線索，則可以將 CloudTrail 事件持續交付至 Amazon S3 儲存貯體，包括 WorkSpaces 的事件。即使您未設定追蹤，依然可以透過 CloudTrail 主控台中的**事件歷史記錄**檢視最新事件。您可以利用 CloudTrail 所收集的資訊來判斷向 WorkSpaces 發出的請求，以及發出請求的 IP 地址、人員、時間和其他詳細資訊。

若要進一步了解 CloudTrail，包括如何設定及啟用，請參閱[《AWS CloudTrail 使用者指南》](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。

## CloudTrail 中的 WorkSpaces 資訊
<a name="service-name-info-in-cloudtrail"></a>

當您建立 AWS 帳戶時，會在您的帳戶上啟用 CloudTrail。當 WorkSpaces 中發生支援的事件活動時，該活動會與**事件歷史記錄**中的其他服務 AWS 事件一起記錄在 CloudTrail 事件中。例如，建立、重建或終止 WorkSpaces 的呼叫會在 CloudTrail 日誌檔案中產生項目。如需詳細資訊，請參閱[動作](https://docs.aws.amazon.com//workspaces/latest/api/API_Operations.html)。

您可以在 AWS 帳戶中檢視、搜尋和下載最近的事件。如需詳細資訊，請參閱《使用 CloudTrail 事件歷史記錄檢視事件》[https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)。

若要持續記錄您 AWS 帳戶中的事件，包括 WorkSpaces 的事件，請建立追蹤。*線索*能讓 CloudTrail 將日誌檔案交付至 Amazon S3 儲存貯體。根據預設，當您在主控台中建立線索時，線索會套用至所有 AWS 區域。線索會記錄 AWS 分割區中所有區域的事件，並將日誌檔案交付至您指定的 Amazon S3 儲存貯體。此外，您可以設定其他 AWS 服務，以進一步分析和處理 CloudTrail 日誌中所收集的事件資料。如需詳細資訊，請參閱下列內容：
+ [建立追蹤的概觀](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [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/getting_notifications_top_level.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)

## 範例：WorkSpaces 日誌檔案項目
<a name="understanding-service-name-entries"></a>

追蹤是一種組態，能讓事件以日誌檔案的形式交付到您指定的 Amazon S3 儲存貯體。CloudTrail 日誌檔案包含一或多個日誌專案。一個事件為任何來源提出的單一請求，並包含請求動作、請求的日期和時間、請求參數等資訊。CloudTrail 日誌檔並非依公有 API 呼叫的堆疊追蹤排序，因此不會以任何特定順序出現。

日誌項目會修訂任何敏感資訊，例如密碼、身分驗證字符、檔案註解和檔案內容。

以下顯示 WorkSpaces 的 CloudTrail 日誌項目範例。

```
{
  "Records" : [
    {
      "eventVersion" : "1.02",
      "userIdentity" :
      {
        "type" : "IAMUser",
        "principalId" : "{{user_id}}",
        "arn" : "{{user_arn}}",
        "accountId" : "{{account_id}}",
        "accessKeyId" : "{{access_key_id}}",
        "userName" : "{{username}}"
      },
      "eventTime" : "{{event_time}}",
      "eventSource" : "workspaces.amazonaws.com",
      "eventName" : "DescribeWorkspaces",
      "awsRegion" : "{{region}}",
      "sourceIPAddress" : "{{IP_address}}",
      "userAgent" : "{{user_agent}}",
      "requestParameters" :
      {
        "requestContext" :
        {
          "awsAccountId" : "{{account_id}}"
        }
      },
      "responseElements" : null,
      "requestID" : "{{request_id}}",
      "eventID" : "{{event_id}}",
      "eventType" : "AwsApiCall",
      "recipientAccountId" : "{{account_id}}"
    }
  ]
}
```