本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 使用 記錄 Step Functions API 呼叫 AWS CloudTrail AWS Step Functions 已與 整合[AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)，此服務提供使用者、角色或 所採取動作的記錄 AWS 服務。CloudTrail 會將 Step Functions 的所有 API 呼叫擷取為事件。擷取的呼叫包括來自 Step Functions 主控台的呼叫，以及對 Step Functions API 操作的程式碼呼叫。您可以使用 CloudTrail 所收集的資訊，判斷對 Step Functions 提出的請求、提出請求的 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-data-events-with-cloudtrail.html#logging-data-events)提供在資源上或在資源中執行的資源操作的相關資訊 (例如，讀取或寫入 Amazon S3 物件)。這些也稱為資料平面操作。資料事件通常是大量資料的活動。根據預設，CloudTrail 不會記錄資料事件。CloudTrail **事件歷史記錄**不會記錄資料事件。 資料事件需支付額外的費用。如需 CloudTrail 定價的詳細資訊，請參閱 [AWS CloudTrail 定價](https://aws.amazon.com/cloudtrail/pricing/)。 您可以使用 CloudTrail 主控台 AWS CLI或 CloudTrail API 操作，記錄 Step Functions 資源類型的資料事件。如需如何記錄資料事件的詳細資訊，請參閱《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)。 下表列出您可以記錄資料事件的 Step Functions 資源類型。**資料事件類型**欄顯示從 CloudTrail 主控台上的**資料事件類型**清單中選擇的值。**resources.type 值**欄會顯示值，您會在使用 AWS CLI 或 CloudTrail APIs 設定進階事件選取器時指定此`resources.type`值。**記錄到 CloudTrail 的資料 API** 資料行會針對資源類型顯示記錄到 CloudTrail 的 API 呼叫。 您可以設定進階事件選取器來篩選 `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)。 | 資料事件類型 | resources.type 值 | 記錄到 CloudTrail 的資料 API | | --- | --- | --- | | Step Functions 狀態機器 | AWS::StepFunctions::StateMachine | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/step-functions/latest/dg/procedure-cloud-trail.html) | | Step Functions 活動 | AWS::StepFunctions::Activity | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/step-functions/latest/dg/procedure-cloud-trail.html) | ## CloudTrail 中的管理事件 [管理事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events)提供有關在 資源上執行的管理操作的資訊 AWS 帳戶。這些也稱為控制平面操作。根據預設，CloudTrail 記錄管理事件。 **State Machine (狀態機器)** + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateStateMachine.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateStateMachine.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachines.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachines.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachine.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachine.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachine.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachine.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachine.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_ValidateStateMachineDefinition.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ValidateStateMachineDefinition.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_TestState.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_TestState.html) **狀態機器別名** + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateStateMachineAlias.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateStateMachineAlias.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachineAliases.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachineAliases.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachineAlias.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachineAlias.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachineAlias.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateStateMachineAlias.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineAlias.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineAlias.html) **狀態機器版本** + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachineVersions.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListStateMachineVersions.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_PublishStateMachineVersion.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_PublishStateMachineVersion.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineVersion.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteStateMachineVersion.html) **執行** + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartSyncExecution.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartSyncExecution.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_RedriveExecution.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_RedriveExecution.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListExecutions.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListExecutions.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeExecution.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeExecution.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_GetExecutionHistory.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_GetExecutionHistory.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachineForExecution.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeStateMachineForExecution.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_StopExecution.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StopExecution.html) **活動** + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateActivity.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_CreateActivity.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListActivities.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListActivities.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeActivity.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeActivity.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteActivity.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DeleteActivity.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_GetActivityTask.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_GetActivityTask.html) **任務字符** + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_SendTaskSuccess.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_SendTaskSuccess.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_SendTaskHeartbeat.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_SendTaskHeartbeat.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_SendTaskFailure.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_SendTaskFailure.html) **MapRun** + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListMapRuns.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListMapRuns.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeMapRun.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeMapRun.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateMapRun.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UpdateMapRun.html) **Tags** (標籤) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListTagsForResource.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListTagsForResource.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_TagResource.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_TagResource.html) + [https://docs.aws.amazon.com/step-functions/latest/apireference/API_UntagResource.html](https://docs.aws.amazon.com/step-functions/latest/apireference/API_UntagResource.html) ## 事件範例 一個事件代表任何來源提出的單一請求，並包含請求 API 操作的相關資訊、操作的日期和時間、請求參數等。CloudTrail 日誌檔案不是公有 API 呼叫的已排序堆疊追蹤，因此事件不會以任何特定順序顯示。 下列範例顯示示範 的 CloudTrail **資料事件**`InvokeHTTPEndpoint`。 ``` { "eventVersion": "1.09", "userIdentity": { "accountId": "account-id", "invokedBy": "states.amazonaws.com" }, "eventTime": "2024-05-01T01:23:45Z", "eventSource": "states.amazonaws.com", "eventName": "InvokeHTTPEndpoint", "awsRegion": "us-east-1", "sourceIPAddress": "states.amazonaws.com", "userAgent": "states.amazonaws.com", "requestParameters": null, "responseElements": null, "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLEaaaaa", "readOnly": false, "resources": [ { "accountId": "account-id", "type": "AWS::StepFunctions::StateMachine", "ARN": "arn:aws:states:region:account-id:stateMachine:ExampleStateMachine" } ], "eventType": "AwsServiceEvent", "managementEvent": false, "recipientAccountId": "account-id", "serviceEventDetails": { "httpMethod": "GET", "httpEndpoint": "https://example.com" }, "eventCategory": "Data" } ``` 下列範例顯示示範 `CreateStateMachine`操作的 CloudTrail **管理事件**。 ``` { "eventVersion": "1.08", "userIdentity": { "type": "IAMUser", "principalId": "AIDAJYDLDBVBI4EXAMPLE", "arn": "arn:aws:iam::account-id:user/test-user", "accountId": "account-id", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "userName": "test-user" }, "eventTime": "2024-05-01T01:23:45Z", "eventSource": "states.amazonaws.com", "eventName": "CreateStateMachine", "awsRegion": "region", "sourceIPAddress": "AWS Internal", "userAgent": "AWS Internal", "requestParameters": { "name": "MyStateMachine", "definition": "HIDDEN_DUE_TO_SECURITY_REASONS", "roleArn": "arn:aws:iam::account-id:role/MyStateMachineRole", "type": "STANDARD", "loggingConfiguration": { "level": "OFF", "includeExecutionData": false }, "tags": [], "tracingConfiguration": { "enabled": false }, "publish": false }, "responseElements": { "stateMachineArn": "arn:aws:states:region:account-id:stateMachine:MyStateMachine", "creationDate": "May 1, 2024 1:23:45 AM" }, "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLEaaaaa", "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "readOnly": false, "eventType": "AwsApiCall", "managementEvent": true, "recipientAccountId": "account-id", "eventCategory": "Management" } ``` 如需有關 CloudTrail 記錄內容的資訊，請參閱《AWS CloudTrail 使用者指南》**中的 [CloudTrail record contents](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-record-contents.html)。