Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Interrogation de données agrégées sur les statistiques de session à l'aide du AWS CLI
<a name="query-session-data"></a>

Pour suivre les coûts, analyser l'utilisation des ressources ou identifier les utilisateurs qui consomment le plus de ressources, vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour consulter les statistiques de session agrégées de vos fermes AWS Deadline Cloud (Deadline Cloud). L'API de statistiques de session fournit des données sur les coûts, le temps d'exécution et l'utilisation que vous pouvez regrouper selon différentes dimensions telles que la file d'attente, le parc, le type d'instance ou l'utilisateur.

L'interrogation des statistiques de session est un processus asynchrone. Tout d'abord, vous lancez une demande d'agrégation, puis vous récupérez les résultats à l'aide de l'ID d'agrégation.

## Lancer une demande d'agrégation
<a name="query-session-data-start-aggregation"></a>

Pour démarrer une demande d'agrégation, exécutez la `start-sessions-statistics-aggregation` commande. L'exemple suivant regroupe les statistiques par ID utilisateur pour une file d'attente spécifique. Remplacez le {{placeholder}} texte par vos informations.

```
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}}
```

Vous pouvez regrouper les statistiques selon d'autres dimensions telles que `QUEUE_ID``FLEET_ID`,`JOB_ID`,`INSTANCE_TYPE`, ou`LICENSE_PRODUCT`. Pour plus d'informations sur tous les paramètres disponibles, consultez [start-sessions-statistics-aggregation](https://docs.aws.amazon.com/cli/latest/reference/deadline/start-sessions-statistics-aggregation.html)la référence des AWS CLI commandes.

La réponse contient un identifiant d'agrégation :

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

## Récupération des résultats
<a name="query-session-data-get-results"></a>

Exécutez la `get-sessions-statistics-aggregation` commande avec l'ID d'agrégation pour récupérer les résultats. Remplacez le {{placeholder}} texte par vos informations.

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

L'exemple suivant montre une réponse lorsque vous regroupez les statistiques par ID utilisateur. Le `userId` champ contient un UUID que vous devez associer à un nom d'utilisateur pour identifier l'utilisateur :

```
{
    "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"
}
```

Pour trouver le nom d'utilisateur associé à un`userId`, consultez[Récupération des métadonnées et des attributs utilisateur à l'aide de l'ID utilisateur dans un magasin d'identités](query-session-data-map-userid.md).

Pour plus d'informations sur l'API, consultez le document de [référence de l'API Deadline Cloud](https://docs.aws.amazon.com/deadline-cloud/latest/APIReference/Welcome.html).

**Rubriques**
+ [Récupération des métadonnées et des attributs utilisateur à l'aide de l'ID utilisateur dans un magasin d'identités](query-session-data-map-userid.md)