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

# 使用 查詢工作階段統計資料彙總資料 AWS CLI
<a name="query-session-data"></a>

若要追蹤成本、分析資源用量，或識別哪些使用者耗用最多資源，您可以使用 AWS Command Line Interface (AWS CLI) 查詢 AWS 截止日期雲端 （截止日期雲端） 陣列的彙總工作階段統計資料。工作階段統計資料 API 提供成本、執行期和用量的資料，您可以依佇列、機群、執行個體類型或使用者等各種維度分組。

查詢工作階段統計資料是非同步程序。首先，您啟動彙總請求，然後使用彙總 ID 擷取結果。

## 啟動彙總請求
<a name="query-session-data-start-aggregation"></a>

若要啟動彙總請求，請執行 `start-sessions-statistics-aggregation`命令。下列範例會依特定佇列的使用者 ID 將統計資料分組。將{{預留位置}}文字取代為您的資訊。

```
aws deadline start-sessions-statistics-aggregation \
    --farm-id {{farm-id}} \
    --resource-ids '{"queueIds":["{{queue-id}}"]}' \
    --start-time {{2025-11-24T10:00:00Z}} \
    --end-time {{2025-11-25T18:00:00Z}} \
    --group-by '["{{USER_ID}}"]' \
    --period {{HOURLY}} \
    --statistics '["{{SUM}}"]' \
    --timezone {{UTC-08:00}} \
    --region {{region-name}}
```

您可以依其他維度將統計資料分組，例如 `QUEUE_ID`、`INSTANCE_TYPE`、、 `FLEET_ID` `JOB_ID`或 `LICENSE_PRODUCT`。如需所有可用參數的詳細資訊，請參閱《 AWS CLI 命令參考》中的 [start-sessions-statistics-aggregation](https://docs.aws.amazon.com/cli/latest/reference/deadline/start-sessions-statistics-aggregation.html)。

回應包含彙總 ID：

```
{
    "aggregationId": "92b35143f2d04641979bc9b777232f38"
}
```

## 擷取結果
<a name="query-session-data-get-results"></a>

使用彙總 ID 執行 `get-sessions-statistics-aggregation`命令以擷取結果。將{{預留位置}}文字取代為您的資訊。

```
aws deadline get-sessions-statistics-aggregation \
    --farm-id {{farm-id}} \
    --aggregation-id {{aggregation-id}} \
    --region {{region-name}}
```

下列範例顯示當您依使用者 ID 將統計資料分組時的回應。`userId` 欄位包含 UUID，您必須映射至使用者名稱以識別使用者：

```
{
    "statistics": [
        {
            "userId": "f9c1f3f0-1031-70dc-4d25-30d7225b04a0",
            "count": 1,
            "costInUsd": {
                "sum": 0.0
            },
            "runtimeInSeconds": {
                "sum": 53.773
            },
            "aggregationStartTime": "2025-11-24T22:00:00Z",
            "aggregationEndTime": "2025-11-24T23:00:00Z"
        }
    ],
    "status": "COMPLETED"
}
```

若要尋找與 相關聯的使用者名稱`userId`，請參閱 [在身分存放區中使用 userID 擷取使用者中繼資料和屬性](query-session-data-map-userid.md)。

如需 API 的詳細資訊，請參閱[截止日期雲端 API 參考](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/Welcome.html)。

**主題**
+ [在身分存放區中使用 userID 擷取使用者中繼資料和屬性](query-session-data-map-userid.md)