Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1467438317.3 KB

Lists Amazon GuardDuty usage statistics over the last 30 days for the specified detector ID. For newly enabled detectors or data sources, the cost returned will include only the usage so far under 30 days. This may differ from the cost metrics in the console, which project usage over 30 days to provide a monthly cost estimate. For more information, see <a href="https://docs.aws.amazon.com/guardduty/latest/ug/monitoring_costs.html#usage-calculations">Understanding How Usage Costs are Calculated</a>.

post/detector/{detectorId}/usage/statistics

Path parameters

detectorIdstring required

The ID of the detector that specifies the GuardDuty service whose usage statistics you want to retrieve.

Query parameters

MaxResultsstring

Pagination limit

NextTokenstring

Pagination token

Request body

usageStatisticsType'SUM_BY_ACCOUNT' | 'SUM_BY_DATA_SOURCE' | 'SUM_BY_RESOURCE' | 'TOP_RESOURCES' | 'SUM_BY_FEATURES' required

The type of usage statistics to retrieve.

unitstring

The currency unit you would like to view your usage statistics in. Current valid values are USD.

maxResultsinteger

The maximum number of results to return in the response.

nextTokenstring

A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request to a list action. For subsequent calls, use the NextToken value returned from the previous request to continue listing results after the first page.

Response

Success

NextTokenstring

The pagination parameter to be used on the next list operation to retrieve more items.