AWS Cost Explorer
Type ID: costExplorer · Kind: Action · Ports: 1 in, 1 out
Interact with AWS Cost Explorer.
Credentials
AWS Cost Explorer (read-only)
{
"credentials": {
"name": "aws_cost_explorer",
"id": "<credential-id>"
}
}
Resources & operations
- Cost and Usage (
costAndUsage)- Get (
get) - Get cost and usage data
- Get (
Properties
Common
| Property | Key | Type | Required | Default | Possible values | Applies when |
|---|---|---|---|---|---|---|
| Resource | resource | options | Yes | costAndUsage | Cost and Usage (costAndUsage) | - |
| Operation | operation | options | Yes | get | Get (get) | resource = costAndUsage |
Cost and Usage → Get
| Property | Key | Type | Required | Default | Possible values | Applies when |
|---|---|---|---|---|---|---|
| Date Range | dateRange | options | Yes | last7Days | Yesterday (yesterday), Last 7 Days (last7Days), Last 30 Days (last30Days), Month to Date (monthToDate), Last Month (lastMonth), Custom (custom) | resource = costAndUsage, operation = get |
| Start Date (YYYY-MM-DD) | startDate | string | Yes | '' | Start date | resource = costAndUsage, operation = get, dateRange = custom |
| End Date (YYYY-MM-DD) | endDate | string | Yes | '' | Exclusive. E.g., for data up to and including Jan 31, enter Feb 01. | resource = costAndUsage, operation = get, dateRange = custom |
| Granularity | granularity | options | Yes | DAILY | Daily (DAILY), Monthly (MONTHLY) | resource = costAndUsage, operation = get |
| Metric | metric | options | Yes | NetUnblendedCost | Net Unblended Cost (NetUnblendedCost), Net Amortized Cost (NetAmortizedCost), Unblended Cost (UnblendedCost), Blended Cost (BlendedCost), Amortized Cost (AmortizedCost) | resource = costAndUsage, operation = get |
| Group By | groupBy | json | No | [] | Array of up to two { type: "DIMENSION" | "TAG" | "COST_CATEGORY", key: "string" } | resource = costAndUsage, operation = get |
| Services Filter | services | json | No | [] | Array of service names to filter by | resource = costAndUsage, operation = get |
| Account IDs Filter | accountIds | json | No | [] | Array of account IDs to filter by | resource = costAndUsage, operation = get |
| Raw Filter Expression | filterExpression | json | No | '' | Advanced: raw AWS Expression object | resource = costAndUsage, operation = get |
| Output Format | outputFormat | options | Yes | simple | Simple (simple), Raw (raw) | resource = costAndUsage, operation = get |
| Limit | limit | number | No | 100 | Max number of ResultByTime items to fetch | resource = costAndUsage, operation = get |
Notes
- Get output (Simple):
{ success, totalCost, data, items, truncated, truncationReason }. - Get output (Raw):
{ success, GroupDefinitions, ResultsByTime, items, truncated, truncationReason }.