---
title: "POST /workloadInsights/{scopeId}/topContributorsQueries"
method: POST
path: "/workloadInsights/{scopeId}/topContributorsQueries"
---

# POST /workloadInsights/{scopeId}/topContributorsQueries

`POST /workloadInsights/{scopeId}/topContributorsQueries`

Create a query with the Network Flow Monitor query interface that you can run to return workload insights top contributors. Specify the scope that you want to create a query for.

The call returns a query ID that you can use with [GetQueryResultsWorkloadInsightsTopContributors](https://docs.aws.amazon.com/networkflowmonitor/2.0/APIReference/API_GetQueryResultsWorkloadInsightsTopContributors.html) to run the query and return the top contributors for the workload insights for a scope.

Top contributors in Network Flow Monitor are network flows with the highest values for a specific metric type. Top contributors can be across all workload insights, for a given scope, or for a specific monitor. Use the applicable APIs for the top contributors that you want to be returned.

## Path parameters

- `scopeId` string, required

## Request body

- object
  - `startTime` string, date-time, required — The timestamp that is the date and time that is the beginning of the period that you want to retrieve results for with your query.
  - `endTime` string, date-time, required — The timestamp that is the date and time end of the period that you want to retrieve results for with your query.
  - `metricName` 'TIMEOUTS' | 'RETRANSMISSIONS' | 'DATA_TRANSFERRED', required — The metric that you want to query top contributors for. That is, you can specify this metric to return the top contributor network flows, for this type of metric, for a monitor and (optionally) within a specific category, such as network flows between Availability Zones.
  - `destinationCategory` 'INTRA_AZ' | 'INTER_AZ' | 'INTER_VPC' | 'UNCLASSIFIED' | 'AMAZON_S3' | 'AMAZON_DYNAMODB' | 'INTER_REGION', required — <p>The destination category for a top contributors row. Destination categories can be one of the following: </p> <ul> <li> <p> <code>INTRA_AZ</code>: Top contributor network flows within a single Availability Zone</p> </li> <li> <p> <code>INTER_AZ</code>: Top contributor network flows between Availability Zones</p> </li> <li> <p> <code>INTER_REGION</code>: Top contributor network flows between Regions (to the edge of another Region)</p> </li> <li> <p> <code>INTER_VPC</code>: Top contributor network flows between VPCs</p> </li> <li> <p> <code>AWS_SERVICES</code>: Top contributor network flows to or from Amazon Web Services services</p> </li> <li> <p> <code>UNCLASSIFIED</code>: Top contributor network flows that do not have a bucket classification</p> </li> </ul>
  - `limit` integer — The maximum number of top contributors to return.

## Response `200`

Success

- StartQueryWorkloadInsightsTopContributorsOutput
  - `queryId` string, required — The identifier for the query. A query ID is an internally-generated identifier for a specific query returned from an API call to start a query.

## Other responses

- `480` — ServiceQuotaExceededException
- `481` — ValidationException
- `482` — ThrottlingException
- `483` — AccessDeniedException
- `484` — InternalServerException

---

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