翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# を使用したセッション統計の集計データのクエリ AWS CLI
<a name="query-session-data"></a>

コストを追跡したり、リソースの使用状況を分析したり、どのユーザーが最も多くリソースを消費しているかを特定したりするには、 AWS Command Line Interface (AWS CLI) を使用して AWS Deadline Cloud (Deadline Cloud) ファームの集約セッション統計をクエリできます。セッション統計 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`、`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` コマンドを実行して、結果を取得します。{{プレースホルダー}}テキストを自分の情報に置き換えます。

```
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`、「」を参照してください[ID ストアで userID を使用してユーザーメタデータと属性を取得する](query-session-data-map-userid.md)。

API の詳細については、[「Deadline Cloud API リファレンス](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/Welcome.html)」を参照してください。

**トピック**
+ [ID ストアで userID を使用してユーザーメタデータと属性を取得する](query-session-data-map-userid.md)