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

# 使用 記錄採購系統 API 呼叫 AWS CloudTrail
<a name="buyer-cloudtrail-logging"></a>

AWS Marketplace 已與 整合 AWS CloudTrail，此服務提供使用者、角色或 AWS 服務 所採取動作的記錄 AWS Marketplace。CloudTrail 會將 的 API 呼叫擷取 AWS Marketplace 為事件。擷取的呼叫包括來自 AWS Marketplace 主控台的呼叫，以及對 AWS Marketplace API 操作的程式碼呼叫。若您建立追蹤，便可將 CloudTrail 事件持續交付至 Amazon S3 儲存貯體，包括 的事件。即使您未設定追蹤，依然可以透過 CloudTrail 主控台中的 **Event history (事件歷史記錄)** 檢視最新事件。如需詳細資訊，請參閱 [ CloudTrail 使用者指南。](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)

## 開立 CloudTrail 事件的發票
<a name="buyer-cloudtrail-invoicing-events"></a>

下表顯示與採購系統整合搭配使用之開立發票動作的 CloudTrail 事件。這些 CloudTrail 事件使用 `invoicing.amazonaws.com`做為事件來源。


**開立 CloudTrail 事件的發票**  

| 事件名稱 | 定義 | 
| --- | --- | 
| CreateProcurementPortalPreference | 記錄採購入口網站偏好設定的建立。 | 
| GetProcurementPortalPreference | 記錄採購入口網站偏好設定的擷取。 | 
| ListProcurementPortalPreferences | 記錄採購入口網站偏好設定的擷取和清單。 | 

## AWS Marketplace 中的資訊 AWS CloudTrail
<a name="buyer-cloudtrail-info"></a>

當您建立帳戶 AWS 帳戶 時，您的 上會啟用 CloudTrail。在 中發生支援的事件活動時 AWS Marketplace，該活動會與**事件歷史記錄**中的其他 AWS 服務 事件一起記錄在 CloudTrail 事件中。您可以在 中檢視、搜尋和下載最近的事件 AWS 帳戶。如需詳細資訊，請參閱《[CloudTrail 使用者指南》中的使用 CloudTrail 事件歷史記錄檢視](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)事件。 *CloudTrail *

如需您 AWS 帳戶帳戶中正在進行事件的記錄 (包含 AWS Marketplace的事件)，請建立追蹤。線索能讓 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)

每一筆事件或日誌項目都會包含產生請求者的資訊。身分資訊可協助您判斷下列事項：
+ 是否使用根登入資料或 AWS Identity and Access Management 使用者登入資料提出請求。
+ 是否使用角色或聯合身分使用者的臨時安全登入資料提出請求。
+ 該請求是否由另一項 AWS 服務服務提出。

如需詳細資訊，請參閱《[CloudTrail 使用者指南》中的 CloudTrail userIdentity 元素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)。 *CloudTrail *

## CloudTrail 日誌項目範例
<a name="buyer-cloudtrail-log-entry-examples"></a>

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

以下範例顯示的是展示 `CreateProcurementPortalPreference` 動作的 CloudTrail 日誌項目。

```
{
    "eventVersion": "1.11",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "AROAEXAMPLEID:ExampleUser",
        "arn": "arn:aws:sts::111122223333:assumed-role/Admin/ExampleUser",
        "accountId": "111122223333",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "sessionContext": {
            "sessionIssuer": {
                "type": "Role",
                "principalId": "AROAEXAMPLEID",
                "arn": "arn:aws:iam::111122223333:role/Admin",
                "accountId": "111122223333",
                "userName": "Admin"
            },
            "attributes": {
                "creationDate": "2026-03-16T15:44:15Z",
                "mfaAuthenticated": "false"
            }
        },
        "inScopeOf": {}
    },
    "eventTime": "2026-03-16T15:45:27Z",
    "eventSource": "invoicing.amazonaws.com",
    "eventName": "CreateProcurementPortalPreference",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "192.0.2.1",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:148.0) Gecko/20100101 Firefox/148.0",
    "requestParameters": {
        "ProcurementPortalName": "COUPA",
        "BuyerDomain": "NetworkID",
        "BuyerIdentifier": "da1307f028f21a95876634f3afaf23a8",
        "SupplierDomain": "NetworkID",
        "SupplierIdentifier": "da1307f028f21a95876634f3afaf23a8",
        "EinvoiceDeliveryEnabled": true,
        "PurchaseOrderRetrievalEnabled": false,
        "Contacts": "HIDDEN_DUE_TO_SECURITY_REASONS",
        "Selector": {
            "InvoiceUnitArns": [],
            "SellerOfRecords": []
        },
        "ProcurementPortalSharedSecret": "HIDDEN_DUE_TO_SECURITY_REASONS",
        "ProcurementPortalInstanceEndpoint": "https://example.com",
        "EinvoiceDeliveryPreference": {
            "EinvoiceDeliveryDocumentTypes": [
                "AWS_MARKETPLACE_INVOICE"
            ],
            "Protocol": "CXML",
            "PurchaseOrderDataSources": [
                {
                    "EinvoiceDeliveryDocumentType": "AWS_MARKETPLACE_INVOICE",
                    "PurchaseOrderDataSourceType": "ASSOCIATED_PURCHASE_ORDER_REQUIRED"
                }
            ],
            "ConnectionTestingMethod": "PROD_ENV_DOLLAR_TEST",
            "EinvoiceDeliveryActivationDate": 1773619200,
            "EinvoiceDeliveryAttachmentTypes": []
        },
        "ClientToken": "c333a7e9-17d6-4f58-a4a1-EXAMPLE"
    },
    "responseElements": {
        "ProcurementPortalPreferenceArn": "arn:aws:invoicing::111122223333:procurement-portal-preference/090d2e03-EXAMPLE"
    },
    "requestID": "935ec8a3-b9dd-4309-b975-EXAMPLE",
    "eventID": "b15c33a2-36a3-4b0a-b2e4-EXAMPLE",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "111122223333",
    "eventCategory": "Management",
    "tlsDetails": {
        "clientProvidedHostHeader": "invoicing.us-east-1.api.aws"
    },
    "sessionCredentialFromConsole": "true"
}
```