透過 記錄 AWS CodeStar API 呼叫AWS CloudTrail - AWS CodeStar

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

透過 記錄 AWS CodeStar API 呼叫AWS CloudTrail

AWS CodeStar 與AWS CloudTrail,該服務會提供記錄使用者、角色或AWS服務。CloudTrail 會將 AWS CodeStar 的所有 API 呼叫當作事件。該呼叫的捕獲包括從 AWS CodeStar 主控台進行的呼叫,以及針對 AWS CodeStar API 操作的程式碼呼叫。如果您建立追蹤記錄,就可以持續傳送 CloudTrail 事件至 S3 儲存儲體,包括 AWS CodeStar 的事件。即使您未設定追蹤,依然可以透過 CloudTrail 主控台中的 Event history (事件歷史記錄) 檢視最新事件。您可利用 CloudTrail 所收集的資訊來判斷向 AWS CodeStar 發出的請求,以及發出請求的 IP 地址、何人提出請求、何時提出請求,以及其他詳細資訊。

若要進一步了解 CloudTrail,請參閱 AWS CloudTrail 使用者指南

CloudTrail 中的 AWS CodeStar 資訊

當您建立帳戶時,系統即會在 AWS 帳戶中啟用 CloudTrail。當 AWS CodeStar 中發生活動時,該活動會與其他AWS中的服務事件事件歷史記錄。您可以檢視、搜尋和下載 AWS 帳戶的最新事件。如需詳細資訊,請參閱使用 CloudTrail 事件歷史記錄檢視事件

若要持續記錄AWS賬户(包括 AWS CodeStar 的事件),請建立追蹤記錄。根據預設,當您在主控台建立追蹤記錄時,追蹤記錄會套用到所有 AWS 區域。該追蹤會記錄來自 AWS 分割區中所有區域的事件,並將日誌檔案交付到您指定的 S3 儲存貯體。您可設定其他 AWS 服務,進一步分析和處理 CloudTrail 記錄中所收集的事件資料。如需詳細資訊,請參閱下列內容:

CloudTrail 會記錄 AWS CodeStar 動作,並記錄在AWS CodeStar API 參考。例如,對 DescribeProjectUpdateProject 以及 AssociateTeamMember 動作發出的呼叫會在 CloudTrail 日誌檔案中產生項目。

每一筆事件或日誌項目都會包含產生請求者的資訊。身分資訊可協助您判斷下列事項:

  • 該請求是否透過根或 AWS Identity and Access Management (IAM) 使用者憑證來提出。

  • 提出該要求時,是否使用了特定角色或聯合身分使用者的暫時安全憑證。

  • 該請求是否由另一項 AWS 服務提出。

如需詳細資訊,請參閱 CloudTrail userIdentity 元素

了解 AWS CodeStar 日誌檔項目

CloudTrail 日誌檔包含一或多個日誌項目。一個事件為任何來源提出的單一請求,並包含請求動作、請求的日期和時間、請求參數等資訊。CloudTrail 日誌檔並非依公有 API 呼叫的堆疊追蹤排序,因此不會以任何特定順序出現。

以下範例顯 CloudTrail 的是展示CreateProject操作在 AWS CodeStar 中調用:

{ "eventVersion": "1.05", "userIdentity": { "type": "AssumedRole", "principalId": "AROAJLIN2OF3UBEXAMPLE:role-name", "arn": "arn:aws:sts::account-ID:assumed-role/role-name/role-session-name", "accountId": "account-ID", "accessKeyId": "ASIAJ44LFQS5XEXAMPLE", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2017-06-04T23:56:57Z" }, "sessionIssuer": { "type": "Role", "principalId": "AROAJLIN2OF3UBEXAMPLE", "arn": "arn:aws:iam::account-ID:role/service-role/role-name", "accountId": "account-ID", "userName": "role-name" } }, "invokedBy": "codestar.amazonaws.com" }, "eventTime": "2017-06-04T23:56:57Z", "eventSource": "codestar.amazonaws.com", "eventName": "CreateProject", "awsRegion": "region-ID", "sourceIPAddress": "codestar.amazonaws.com", "userAgent": "codestar.amazonaws.com", "requestParameters": { "clientRequestToken": "arn:aws:cloudformation:region-ID:account-ID:stack/stack-name/additional-ID", "id": "project-ID", "stackId": "arn:aws:cloudformation:region-ID:account-ID:stack/stack-name/additional-ID", "description": "AWS CodeStar created project", "name": "project-name", "projectTemplateId": "arn:aws:codestar:region-ID::project-template/project-template-name" }, "responseElements": { "projectTemplateId": "arn:aws:codestar:region-ID::project-template/project-template-name", "arn": "arn:aws:codestar:us-east-1:account-ID:project/project-ID", "clientRequestToken": "arn:aws:cloudformation:region-ID:account-ID:stack/stack-name/additional-ID", "id": "project-ID" }, "requestID": "7d7556d0-4981-11e7-a3bc-dd5daEXAMPLE", "eventID": "6b0d6e28-7a1e-4a73-981b-c8fdbEXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "account-ID" }