本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用查询会话统计信息聚合数据 AWS CLI
<a name="query-session-data"></a>

要跟踪成本、分析资源使用情况或确定哪些用户消耗的资源最多，您可以使用 AWS Command Line Interface (AWS CLI) 查询 Deadline Cloud（De AWS adline Cloud）场的聚合会话统计信息。会话统计 API 提供有关成本、运行时间和使用情况的数据，您可以按队列、队列、实例类型或用户等各种维度对这些数据进行分组。

查询会话统计信息是一个异步过程。首先，启动聚合请求，然后使用聚合 ID 检索结果。

## 启动聚合请求
<a name="query-session-data-start-aggregation"></a>

要启动聚合请求，请运行`start-sessions-statistics-aggregation`命令。以下示例按用户 ID 对特定队列的统计数据进行分组。用您的信息替换{{placeholder}}文本。

```
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`，例如`FLEET_ID``JOB_ID`、、`INSTANCE_TYPE`、或`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`命令以检索结果。用您的信息替换{{placeholder}}文本。

```
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 的更多信息，请参阅 De [adline Cloud API 参考](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/Welcome.html)。

**主题**
+ [在身份存储中使用 userID 检索用户元数据和属性](query-session-data-map-userid.md)