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

# 彙總事件的 CloudTrail 記錄內容
<a name="cloudtrail-event-reference-aggregated-events"></a>

AWS CloudTrail 彙總事件記錄包含的欄位與其 JSON 承載中的其他 CloudTrail 事件不同。彙總事件包含下列欄位：

**`eventVersion`**  
彙總事件的版本。  
**來自：**1.0  
**選用：**False

**`accountId`**  
收到此事件的帳戶 ID。  
**來自：**1.0  
**選用：**False

**`eventId`**  
CloudTrail 產生的 GUID，可唯一識別每個彙總事件。您可以使用這個值來識別單一事件。例如，您可以使用此 ID 做為主索引鍵，從可搜尋的資料庫中擷取日誌資料。  
**來自：**1.0  
**選用：**False

**`eventCategory`**  
識別事件的類別。對於彙總的事件，此值一律為 `Aggregated`。當您依類別查詢事件時，請使用此欄位進行篩選。  
**來自：**1.0  
**選用：**False

**`eventType`**  
識別彙總事件的類型。對於彙總的事件，此值為 `AwsAggregatedEvent`。  
**來自：**1.0  
**選用：**False

**`awsRegion`**  
彙總到此記錄中 AWS 區域 的原子 CloudTrail 事件的 ，例如 `ap-northeast-1`。這通常是進行服務 API 呼叫的區域。  
**來自：**1.0  
**選用：**False

**`eventSource`**  
記錄基礎事件 AWS 的服務。  
**來自：**1.0  
**選用：**False

**`timeWindow`**  
將原子 CloudTrail 事件彙總到此彙總事件記錄中的時間間隔。`timeWindow` 欄位包含視窗開始時間、視窗結束時間和視窗大小等詳細資訊。  
**來自：**1.0  
**選用：**False    
**`windowStart`**  
彙總視窗的開頭，包含國際時間 (UTC)，以 ISO-8601 格式表示。  
**來自：**1.0  
**選用：**False  
**`windowEnd`**  
彙總視窗的結尾，以 UTC 表示，以 ISO-8601 格式表示。  
**來自：**1.0  
**選用：**False  
**`windowSize`**  
彙總視窗的持續時間。差異`windowEnd − windowStart`應對應至 `windowSize`。以 ISO-8601 格式`windowSize`表示。  
**來自：**1.0  
**選用：**False

**`summary`**  
基礎原子事件的彙總摘要，依主要維度 （例如 `resourceARN`或 `userIdentity`) 分組`eventName`，並選擇性地依其他維度 （例如 `userAgent`、`sourceIpAddress`、) 細分`errorCodes`。  
**來自：**1.0  
**選用：**False  
摘要包含下列欄位：    
**`primaryDimension`**  
此 的主要彙總維度`AwsAggregatedEvent`。這是彙總資料的主要檢視。例如，在`API_ACTIVITY`彙總範本中，主要維度為 `eventName`；在`RESOURCE_ACCESS`範本中，其為 `resourceARN`；在`USER_ACTIONS`範本中，其為 `userIdentity`。  
**來自：**1.0  
**選用：**False  
**`details`**  
提供彙總原子事件詳細資訊的其他維度。每個詳細資訊物件可能會根據彙總範本提供相同基礎事件的額外檢視，例如 `userIdentity`、、 `eventName` `resourceARN``userAgent`和 `sourceIpAddress` 。  
**來自：**1.0  
**選用：**False  
每個詳細資訊都提供下列資訊：    
**`dimension`**  
用於將彙總事件分組的維度名稱。常見值包括：  
+ `eventName`
+ `resourceARN`
+ `userIdentity`
+ `userAgent`
+ `sourceIpAddress`
**來自：**1.0  
**選用：**False  
**`statistics`**  
此維度的統計資料清單，其中每個項目代表一個儲存貯體 （例如，一個事件名稱或一個資源 ARN) 及其彙總值。  
**來自：**1.0  
**選用：**False  
統計資料中的每個項目都包含下列資訊：    
**`name`**  
關聯維度內此統計資料的儲存貯體識別符或索引鍵。  
**`value`**  
指定維度中指定名稱的彙總數值。  
**`aggregationType`**  
套用至此維度運算`statistics.value`的彙總類型。允許的值：  
+ `Count` – 事件數量。
**來自：**1.0  
**選用：**False

**`addendum`**  
承載有關延遲交付或更新現有 AggregatedEvent 的中繼資料。  
**來自：**1.0  
**選用：**False    
**`reason`**  
`AwsAggregatedEvent` 延遲、更新或以其他方式補充 的原因。常見值可以包括 （非詳盡）：  
+ `DELIVERY_DELAY` – 彙總資料的交付延遲 （例如網路問題或大量）。
+ `UPDATED_DATA` – 已重新計算或更正彙總的資料。
+ `SERVICE_OUTAGE` – 基礎服務中斷會影響事件可用性。
**來自：**1.0  
**選用：**True

## 彙總事件範例
<a name="example-aggregated-event"></a>

以下是 CloudTrail 彙總事件 () 的範例`AwsAggregatedEvent`。在此範例中，CloudTrail 會在 `us-east-1` 區域的`cloudtrail-data.amazonaws.com`五分鐘時段內彙總對 的`PutAuditEvents`呼叫。摘要區塊會顯示主要彙總維度 (`eventName`)，並在時段內發生 30 次`PutAuditEvents`呼叫。詳細資訊項目會進一步依 `resourceARN`、`userAgent`、 `userIdentity`和 細分這些呼叫`sourceIpAddress`，以顯示活動如何分散到資源、委託人和用戶端。

```
{  
    "eventVersion": "1.0",  
    "accountId": "111122223333",  
    "eventId": "4da798a8-1db6-4d17-8b51-4c33df06b56d",  
    "eventCategory": "Aggregated",  
    "eventType": "AwsAggregatedEvent",  
    "awsRegion": "us-east-1",  
    "eventSource": "cloudtrail-data.amazonaws.com",  
    "timeWindow":  
    {  
        "windowStart": "2025-10-30 23:45:00",  
        "windowEnd": "2025-10-30 23:50:00",  
        "windowSize": "PT5M"  
    },  
    "summary":  
    {  
        "primaryDimension":  
        {  
            "dimension": "eventName",  
            "statistics":  
            [  
                {  
                    "name": "PutAuditEvents",  
                    "value": 30  
                }  
            ],  
            "aggregationType": "Count"  
        },  
        "details":  
        [  
            {  
                "dimension": "resourceARN",  
                "statistics":  
                [  
                    {  
                        "name": "arn:aws:cloudtrail:us-east-1:111122223333:channel/1234abcd-12ab-34cd-56ef-1234567890ab",  
                        "value": 20  
                    },  
                    {  
                        "name": "arn:aws:cloudtrail:us-east-1:111122223333:channel/6789abcd-12ab-34cd-56ef-6789012345ab",  
                        "value": 10  
                    }  
                ],  
                "aggregationType": "Count"  
            },  
            {  
                "dimension": "userIdentity",  
                "statistics":  
                [  
                    {  
                        "name": "AWSAccount:111122223333",  
                        "value": 20  
                    },  
                    {  
                        "name": "AWSService:AWS Internal",  
                        "value": 10  
                    }  
                ],  
                "aggregationType": "Count"  
            },  
            {  
                "dimension": "userAgent",  
                "statistics":  
                [  
                    {  
                        "name": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Firefox/102.0",  
                        "value": 20  
                    },  
                    {  
                        "name": "AWS Internal",  
                        "value":10  
                    }  
                ],  
                "aggregationType": "Count"  
            },  
            {  
                "dimension": "sourceIpAddress",  
                "statistics":  
                [  
                    {  
                        "name": "1.2.3.4",  
                        "value": 20  
                    },  
                    {  
                        "name": "AWS Internal",  
                        "value": 10  
                    }  
                ],  
                "aggregationType": "Count"  
            }  
        ]  
    }  
}
```