Get cost and usage for a month

GET 
/usage/:month

Returns Cost Explorer usage for the month in the path (YYYY-MM). Requires system-settings.view. Future months return GE-1001. latest=yes reads Cost Explorer live and omits LastUpdatedTime. Any other latest value (default no) reads the latest DynamoDB snapshot for that month, or Cost Explorer if none exists.

Request

Responses

200

TimePeriod and EstimatedUsage always unless projection omits them. CurrentUsage and UsageByService from CE or DynamoDB. LastUpdatedTime only when latest is not yes. No properties are required because of projection.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

AUTH-1030 missing system-settings.view. GE-1001 when month is after the current calendar month.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Message is a fixed string. Details is the exception text (including a malformed month path). Forecast failure can still be 200 with EstimatedUsage Amount Unavailable.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers