---
title: "POST /2023-10-12/farms/{farmId}/sessions-statistics-aggregation"
method: POST
path: "/2023-10-12/farms/{farmId}/sessions-statistics-aggregation"
---

# POST /2023-10-12/farms/{farmId}/sessions-statistics-aggregation

`POST /2023-10-12/farms/{farmId}/sessions-statistics-aggregation`

Starts an asynchronous request for getting aggregated statistics about queues and farms. Get the statistics using the <code>GetSessionsStatisticsAggregation</code> operation. You can only have one running aggregation for your Deadline Cloud farm. Call the <code>GetSessionsStatisticsAggregation</code> operation and check the <code>status</code> field to see if an aggregation is running. Statistics are available for 1 hour after you call the <code>StartSessionsStatisticsAggregation</code> operation.

## Path parameters

- `farmId` string, required

## Request body

- object
  - `resourceIds` object, required — Specifies the fleet IDs or queue IDs to return statistics. You can specify only fleet IDs or queue IDS, not both.
    - `queueIds` QueueId[] — One to 10 queue IDs that specify the queues to return statistics for. If you specify the <code>queueIds</code> field, you can't specify the <code>fleetIds</code> field.
    - `fleetIds` FleetId[] — One to 10 fleet IDs that specify the fleets to return statistics for. If you specify the <code>fleetIds</code> field, you can't specify the <code>queueIds</code> field.
  - `startTime` string, date-time, required — The Linux timestamp of the date and time that the statistics start.
  - `endTime` string, date-time, required — The Linux timestamp of the date and time that the statistics end.
  - `timezone` string — The timezone to use for the statistics. Use UTC notation such as "UTC+8."
  - `period` 'HOURLY' | 'DAILY' | 'WEEKLY' | 'MONTHLY' — The period to aggregate the statistics.
  - `groupBy` UsageGroupByField[], required — The field to use to group the statistics.
  - `statistics` UsageStatistic[], required — One to four statistics to return.

## Response `200`

Success

- StartSessionsStatisticsAggregationResponse
  - `aggregationId` string, required — A unique identifier for the aggregated statistics. Use this identifier with the <code>GetAggregatedStatisticsForSessions</code> operation to return the statistics.

## Other responses

- `480` — AccessDeniedException
- `481` — InternalServerErrorException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException
- `484` — ValidationException

---

[API](https://skmtc.net/aws/apis/deadline.md) · [All operations](https://skmtc.net/aws/apis/deadline/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/deadline/versions/259a7ebfefa8/schema)