Total aggregated cloud carbon footprint usage

get/sustainability-insight-ctr/v1beta1/cloud-usage-totals

Returns the total carbon footprint over a defined time frame and supports filtering by cloud entities.

OData 4.0 Documentation
Securitybearer
Request
query Parameters
end-time
required
string

End of the aggregate's time range in ISO8601 format.

Examples:
end-time=2024-01-29T08:00:00Z
filter
string

Limit the cloud entities operated on by this endpoint, returning only the subset of entities that match the filter. The filter grammar is a subset of OData 4.0 supporting "eq", "in", and "and" operators only.

Cloud entities can be filtered by:

  • entityId
  • serviceProvider
  • serviceName
  • serviceRegion
  • serviceAccount
  • name
Examples:
filter=serviceProvider eq 'AWS'
filter=serviceRegion in ('EMEA', 'AMERICAS')
start-time
required
string

Start of the query's time range in ISO8601 format.

Examples:
start-time=2024-01-28T08:00:00Z
Responses
200

OK

400

Bad Request. Incorrect Input.

401

Unauthorized

429

Exceeded the allowed rate limit.

500

Unexpected Server Error

Request samples 
Response samples 
application/json
{
  • "items": [
    ],
  • "count": 10
}