Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1492542448.2 KB

Accepts a structured query language (SQL) SELECT command and an aggregator to query configuration state of Amazon Web Services resources across multiple accounts and regions, performs the corresponding search, and returns resource configurations matching the properties.

For more information about query components, see the Query Components section in the Config Developer Guide.

If you run an aggregation query (i.e., using GROUP BY or using aggregate functions such as COUNT; e.g., SELECT resourceId, COUNT(*) WHERE resourceType = 'AWS::IAM::Role' GROUP BY resourceId) and do not specify the MaxResults or the Limit query parameters, the default page size is set to 500.

If you run a non-aggregation query (i.e., not using GROUP BY or aggregate function; e.g., SELECT * WHERE resourceType = 'AWS::IAM::Role') and do not specify the MaxResults or the Limit query parameters, the default page size is set to 25.

post/#X-Amz-Target=StarlingDoveService.SelectAggregateResourceConfig

Query parameters

Limitstring

Pagination limit

NextTokenstring

Pagination token

Headers

X-Amz-Target'StarlingDoveService.SelectAggregateResourceConfig' required

Request body

Expressionstring required

The SQL query SELECT command.

ConfigurationAggregatorNamestring required

The name of the configuration aggregator.

Limitinteger

The maximum number of query results returned on each page.

MaxResultsinteger

The maximum number of query results returned on each page. Config also allows the Limit request parameter.

NextTokenstring

The nextToken string returned in a previous request that you use to request the next page of results in a paginated response.

Response

Success

ResultsString[]

Returns the results for the SQL query.

NextTokenstring

The nextToken string returned in a previous request that you use to request the next page of results in a paginated response.