Cloud Cost API
Warning: The Cloud Cost API cannot be used until you have enabled Cloud Cost via Helm. See Kubecost's Cloud Cost Explorer doc for instructions.
Intro to Cloud Cost API
The Cloud Cost API provides multiple endpoints to obtain accurate cost information from your cloud service providers (CSPs), including data available from cloud billing reports (such as AWS' Cost and Usage Report (CUR)).
There are three distinct endpoints for using the Cloud Cost API. The default endpoint for querying Cloud Costs should be /model/cloudCost/view.
Cloud Cost View API
Using the Cloud Cost View API
GET http://<your-kubecost-address>/model/cloudCost/view
Samples full granularity of cloud costs from cloud billing report (ex. AWS' Cost and Usage Report).
| Name | Required | Type | Description |
|---|---|---|---|
| window | true | string | Window of the query. Only accepts daily intervals, example window=3d. |
| costMetric | false | string | Determines which cloud cost metric type will be returned. Acceptable values are AmortizedNetCost, InvoicedCost, ListCost, and NetCost. Default is AmortizedNetCost. |
| aggregate | false | string | Field by which to aggregate the results. Accepts: invoiceEntityID, accountID, provider, service, and label:<name>. Supports multi-aggregation using comma-separated lists. Example: aggregate=accountID,service |
| filterInvoiceEntityIDs | false | string | Filter for account |
| filterAccountIDs | false | string | GCP only, filter for projectID |
| filterProviders | false | string | Filter for cloud service provider |
| filterProvidersID | false | string | Filter for resource-level ID given by CSP |
| filterServices | false | string | Filter for cloud service |
| filterCategories | false | string | Filter based on object type |
| filterLabels | false | string | Filter for a specific label. Does not support filtering for multiple labels at once. |
| Code | Description | Example |
|---|---|---|
| 200 | OK |
|
The endpoint /model/cloudCost/top will use all parameters of /model/cloudCost/view listed above, except for CostMetric. This is because /top samples full granularity from your cloud billing reports and will return information for all four accepted metric types (see below for more information on these types).
The endpoint /view contains all parameters for /model/CloudCost/aggregate, and if your /view query parameters are in a subset of /aggregate, your payload will be pulled from /aggregate instead (this payload will return a larger amount of information than /view). Otherwise, your /view query will pull from /top.
Cloud Cost Aggregate API
Using the Cloud Cost Aggregate API
GET http://<your-kubecost-address>/model/cloudCost/aggregate
Query cloud cost aggregate data.
| Name | Required | Type | Description |
|---|---|---|---|
| window | true | string | Window of the query. Accepts all standard Kubecost window formats (See our doc on using the window parameter). |
| aggregate | false | string | Field by which to aggregate the results. Accepts: invoiceEntityID, accountID, provider, service, and label:<name>. Supports multi-aggregation using comma-separated lists. Example: aggregate=accountID,service |
| filterInvoiceEntityIDs | false | string | Filter for account |
| filterAccountIDs | false | string | GCP only, filter for projectID |
| filterProviders | false | string | Filter for cloud service provider |
| filterServices | false | string | Filter for cloud service |
| filterLabel | false | string | Filter for a specific label. Does not support filtering for multiple labels at once. |
| Code | Description | Example |
|---|---|---|
| 200 | OK |
|
Using the CostMetric parameter
Warning: Using the endpoint
/model/cloudCost/top will accept all parameters of model/cloudCost/view except for MetricCost. CostMetric values are based on and calculated following standard FinOps dimensions and metrics. The four available metrics supported by the Cloud Cost API are:
| CostMetric value | Description |
|---|---|
| NetCost | Costs inclusive of discounts and credits. Will also include one-time and recurring charges. |
| AmortizedNetCost | NetCost with removed cash upfront fees and amortized |
| ListCost | CSP pricing without any discounts |
| InvoicedCost | Pricing based on usage during billing period |
Providing a value for CostMetric is optional, but it will default to AmortizedNetCost if not otherwise provided.
Understanding kubernetesPercent
Each CostMetric also has a kubernetesPercent value. Unaggregated, this value will be 0 or 1. When you aggregate, kubernetesPercent is determined by multiplying the costMetric cost by its kubernetesPercent and aggregating that value as kubernetesCost for that costMetric. That kubernetesCost is then divided by the aggregated total costs to determine the new kubernetesPercent. Since this process results in unique values for each costMetric, this value is included as part of the cost metric.
Examples
Request
http://<your-kubecost-address>/model/cloudCost/aggregate?window=3d&aggregate=service&filterProviders=AWS
Response
{
"code": 200,
"data": {
"sets": [
{
"cloudCosts": {
"5hnnev4d0v7mapf09j0v8of0o2": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "5hnnev4d0v7mapf09j0v8of0o2"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 8.207999999999997,
"kubernetesPercent": 0
},
"netCost": {
"cost": 8.207999999999997,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 8.207999999999997,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 8.207999999999997,
"kubernetesPercent": 0
}
},
"AWSBackup": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AWSBackup",
"labels": {
"name": "khand-dev"
}
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 4e-10,
"kubernetesPercent": 0
},
"netCost": {
"cost": 4e-10,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 4e-10,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 4e-10,
"kubernetesPercent": 0
}
},
"AWSCloudTrail": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AWSCloudTrail"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 4.9206699999999985,
"kubernetesPercent": 0
},
"netCost": {
"cost": 4.9206699999999985,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 4.9206699999999985,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 4.9206699999999985,
"kubernetesPercent": 0
}
},
"AWSCostExplorer": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AWSCostExplorer"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 0.26426064520000003,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0.26426064520000003,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0.26426064520000003,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0.26426064520000003,
"kubernetesPercent": 0
}
},
"AWSELB": {
"properties": {
"provider": "AWS",
"invoiceEntityID": "297945954695",
"service": "AWSELB"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 43.00682560389998,
"kubernetesPercent": 0.8073338296107909
},
"netCost": {
"cost": 43.00682560389998,
"kubernetesPercent": 0.8073338296107909
},
"amortizedNetCost": {
"cost": 43.00682560389998,
"kubernetesPercent": 0.8073338296107909
},
"invoicedCost": {
"cost": 43.00682560389998,
"kubernetesPercent": 0.8073338296107909
}
},
"AWSGlue": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AWSGlue"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 0.43269115999999996,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0.43269115999999996,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0.43269115999999996,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0.43269115999999996,
"kubernetesPercent": 0
}
},
"AWSLambda": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AWSLambda"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 0,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0,
"kubernetesPercent": 0
}
},
"AWSQueueService": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AWSQueueService"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 0,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0,
"kubernetesPercent": 0
}
},
"AmazonAthena": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonAthena"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 0.10061275,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0.10061275,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0.10061275,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0.10061275,
"kubernetesPercent": 0
}
},
"AmazonCloudWatch": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonCloudWatch"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 0.21150513669999998,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0.21150513669999998,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0.21150513669999998,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0.21150513669999998,
"kubernetesPercent": 0
}
},
"AmazonEC2": {
"properties": {
"provider": "AWS",
"invoiceEntityID": "297945954695",
"service": "AmazonEC2"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 337.4926118030998,
"kubernetesPercent": 0.6543833295809984
},
"netCost": {
"cost": 337.4926118030998,
"kubernetesPercent": 0.6543833295809984
},
"amortizedNetCost": {
"cost": 337.4926118030998,
"kubernetesPercent": 0.6543833295809984
},
"invoicedCost": {
"cost": 337.4926118030998,
"kubernetesPercent": 0.6543833295809984
}
},
"AmazonECR": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonECR"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 0.00018308879999999998,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0.00018308879999999998,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0.00018308879999999998,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0.00018308879999999998,
"kubernetesPercent": 0
}
},
"AmazonECRPublic": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonECRPublic"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 0,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0,
"kubernetesPercent": 0
}
},
"AmazonEFS": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonEFS"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 6.123e-07,
"kubernetesPercent": 0
},
"netCost": {
"cost": 6.123e-07,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 6.123e-07,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 6.123e-07,
"kubernetesPercent": 0
}
},
"AmazonEKS": {
"properties": {
"provider": "AWS",
"invoiceEntityID": "297945954695",
"service": "AmazonEKS"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 43.19999999999999,
"kubernetesPercent": 1
},
"netCost": {
"cost": 43.19999999999999,
"kubernetesPercent": 1
},
"amortizedNetCost": {
"cost": 43.19999999999999,
"kubernetesPercent": 1
},
"invoicedCost": {
"cost": 43.19999999999999,
"kubernetesPercent": 1
}
},
"AmazonFSx": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonFSx"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 5.6010275086000005,
"kubernetesPercent": 0
},
"netCost": {
"cost": 5.6010275086000005,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 5.6010275086000005,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 5.6010275086000005,
"kubernetesPercent": 0
}
},
"AmazonPrometheus": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonPrometheus"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 5.03357787,
"kubernetesPercent": 0
},
"netCost": {
"cost": 5.03357787,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 5.03357787,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 5.03357787,
"kubernetesPercent": 0
}
},
"AmazonQuickSight": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonQuickSight"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 0.8000000064000001,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0.8000000064000001,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0.8000000064000001,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0.8000000064000001,
"kubernetesPercent": 0
}
},
"AmazonRoute53": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonRoute53"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 0.0005856,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0.0005856,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0.0005856,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0.0005856,
"kubernetesPercent": 0
}
},
"AmazonS3": {
"properties": {
"provider": "AWS",
"invoiceEntityID": "297945954695",
"service": "AmazonS3"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 45.7935617916,
"kubernetesPercent": 0
},
"netCost": {
"cost": 45.7935617916,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 45.7935617916,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 45.7935617916,
"kubernetesPercent": 0
}
},
"AmazonSNS": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonSNS"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 0,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0,
"kubernetesPercent": 0
}
},
"AmazonVPC": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonVPC"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 2.8800000000000017,
"kubernetesPercent": 0
},
"netCost": {
"cost": 2.8800000000000017,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 2.8800000000000017,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 2.8800000000000017,
"kubernetesPercent": 0
}
},
"awskms": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "awskms"
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"listCost": {
"cost": 0.23333333520000016,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0.23333333520000016,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0.23333333520000016,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0.23333333520000016,
"kubernetesPercent": 0
}
}
},
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-01T00:00:00Z"
},
"aggregationProperties": [
"service"
]
},
{
"cloudCosts": {
"5hnnev4d0v7mapf09j0v8of0o2": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "5hnnev4d0v7mapf09j0v8of0o2"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 7.865999999999996,
"kubernetesPercent": 0
},
"netCost": {
"cost": 7.865999999999996,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 7.865999999999996,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 7.865999999999996,
"kubernetesPercent": 0
}
},
"AWSCloudTrail": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AWSCloudTrail"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 6.373088000000007,
"kubernetesPercent": 0
},
"netCost": {
"cost": 6.373088000000007,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 6.373088000000007,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 6.373088000000007,
"kubernetesPercent": 0
}
},
"AWSCostExplorer": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AWSCostExplorer"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 0.24415709680000003,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0.24415709680000003,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0.24415709680000003,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0.24415709680000003,
"kubernetesPercent": 0
}
},
"AWSELB": {
"properties": {
"provider": "AWS",
"invoiceEntityID": "297945954695",
"service": "AWSELB"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 41.16003439479998,
"kubernetesPercent": 0.8082905243733983
},
"netCost": {
"cost": 41.16003439479998,
"kubernetesPercent": 0.8082905243733983
},
"amortizedNetCost": {
"cost": 41.16003439479998,
"kubernetesPercent": 0.8082905243733983
},
"invoicedCost": {
"cost": 41.16003439479998,
"kubernetesPercent": 0.8082905243733983
}
},
"AWSGlue": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AWSGlue"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 0.5083949200000001,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0.5083949200000001,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0.5083949200000001,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0.5083949200000001,
"kubernetesPercent": 0
}
},
"AWSLambda": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AWSLambda"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 0,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0,
"kubernetesPercent": 0
}
},
"AWSQueueService": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AWSQueueService"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 0,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0,
"kubernetesPercent": 0
}
},
"AmazonAthena": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonAthena"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 10.695624500000003,
"kubernetesPercent": 0
},
"netCost": {
"cost": 10.695624500000003,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 10.695624500000003,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 10.695624500000003,
"kubernetesPercent": 0
}
},
"AmazonCloudWatch": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonCloudWatch"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 0.0148635813,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0.0148635813,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0.0148635813,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0.0148635813,
"kubernetesPercent": 0
}
},
"AmazonEC2": {
"properties": {
"provider": "AWS",
"invoiceEntityID": "297945954695",
"service": "AmazonEC2"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 309.4241635897003,
"kubernetesPercent": 0.6593596481215193
},
"netCost": {
"cost": 309.4241635897003,
"kubernetesPercent": 0.6593596481215193
},
"amortizedNetCost": {
"cost": 309.4241635897003,
"kubernetesPercent": 0.6593596481215193
},
"invoicedCost": {
"cost": 309.4241635897003,
"kubernetesPercent": 0.6593596481215193
}
},
"AmazonECR": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonECR"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 0.00014835589999999998,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0.00014835589999999998,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0.00014835589999999998,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0.00014835589999999998,
"kubernetesPercent": 0
}
},
"AmazonECRPublic": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonECRPublic"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 0,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0,
"kubernetesPercent": 0
}
},
"AmazonEFS": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonEFS"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 5.681000000000001e-07,
"kubernetesPercent": 0
},
"netCost": {
"cost": 5.681000000000001e-07,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 5.681000000000001e-07,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 5.681000000000001e-07,
"kubernetesPercent": 0
}
},
"AmazonEKS": {
"properties": {
"provider": "AWS",
"invoiceEntityID": "297945954695",
"service": "AmazonEKS"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 39.6,
"kubernetesPercent": 1
},
"netCost": {
"cost": 39.6,
"kubernetesPercent": 1
},
"amortizedNetCost": {
"cost": 39.6,
"kubernetesPercent": 1
},
"invoicedCost": {
"cost": 39.6,
"kubernetesPercent": 1
}
},
"AmazonFSx": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonFSx"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 4.968756381500007,
"kubernetesPercent": 0
},
"netCost": {
"cost": 4.968756381500007,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 4.968756381500007,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 4.968756381500007,
"kubernetesPercent": 0
}
},
"AmazonPrometheus": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonPrometheus"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 1.04940423,
"kubernetesPercent": 0
},
"netCost": {
"cost": 1.04940423,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 1.04940423,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 1.04940423,
"kubernetesPercent": 0
}
},
"AmazonQuickSight": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonQuickSight"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 0.7419354719999997,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0.7419354719999997,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0.7419354719999997,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0.7419354719999997,
"kubernetesPercent": 0
}
},
"AmazonRoute53": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonRoute53"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 1.5010184,
"kubernetesPercent": 0
},
"netCost": {
"cost": 1.5010184,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 1.5010184,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 1.5010184,
"kubernetesPercent": 0
}
},
"AmazonS3": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonS3"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 35.486366779799866,
"kubernetesPercent": 0
},
"netCost": {
"cost": 35.486366779799866,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 35.486366779799866,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 35.486366779799866,
"kubernetesPercent": 0
}
},
"AmazonSNS": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonSNS"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 0,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0,
"kubernetesPercent": 0
}
},
"AmazonVPC": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonVPC"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 2.849999999999996,
"kubernetesPercent": 0
},
"netCost": {
"cost": 2.849999999999996,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 2.849999999999996,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 2.849999999999996,
"kubernetesPercent": 0
}
},
"AmazonWorkSpaces": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "AmazonWorkSpaces"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 38,
"kubernetesPercent": 0
},
"netCost": {
"cost": 38,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 38,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 38,
"kubernetesPercent": 0
}
},
"awskms": {
"properties": {
"provider": "AWS",
"accountID": "297945954695",
"invoiceEntityID": "297945954695",
"service": "awskms"
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"listCost": {
"cost": 0.2163978459999994,
"kubernetesPercent": 0
},
"netCost": {
"cost": 0.2163978459999994,
"kubernetesPercent": 0
},
"amortizedNetCost": {
"cost": 0.2163978459999994,
"kubernetesPercent": 0
},
"invoicedCost": {
"cost": 0.2163978459999994,
"kubernetesPercent": 0
}
}
},
"window": {
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z"
},
"aggregationProperties": [
"service"
]
},
{
"cloudCosts": {},
"window": {
"start": "2023-05-02T00:00:00Z",
"end": "2023-05-03T00:00:00Z"
},
"aggregationProperties": [
"service"
]
}
],
"window": {
"start": "2023-04-30T00:00:00Z",
"end": "2023-05-03T00:00:00Z"
}
}
}
Query for cloud net costs within the past two days, aggregated by accounts, filtered only for Amazon EC2 costs
Request
http://<your-kubecost-address>/model/cloudCost/view?window=2d&filterServices=AmazonEC2&aggregate=invoiceEntityID
Response
{
"code": 200,
"data": {
"graphData": [
{
"start": "2023-05-01T00:00:00Z",
"end": "2023-05-02T00:00:00Z",
"items": [
{
"name": "297945954695",
"value": 309.4241635897003
}
]
},
{
"start": "2023-05-02T00:00:00Z",
"end": "2023-05-03T00:00:00Z",
"items": []
}
],
"tableTotal": {
"name": "Totals",
"kubernetesPercent": 0.6593596481215193,
"cost": 309.4241635897003
},
"tableRows": [
{
"name": "297945954695",
"kubernetesPercent": 0.6593596481215193,
"cost": 309.4241635897003
}
]
}