cost_categories
Creates, updates, deletes, gets or lists a cost_categories resource.
Overview
| Name | cost_categories |
| Type | Resource |
| Id | aws.ce.cost_categories |
Fields
The following fields are returned by SELECT queries:
- get_cost_categories
| Name | Datatype | Description |
|---|---|---|
cost_category_names | array | The names of the cost categories. |
cost_category_values | array | The cost category values. If the CostCategoryName key isn't specified in the request, the CostCategoryValues fields aren't returned. |
next_page_token | string | If the number of objects that are still available for retrieval exceeds the quota, Amazon Web Services returns a NextPageToken value in the response. To retrieve the next batch of objects, provide the marker from the prior call in your next request. (pattern: <code>[\S\s]*</code>) |
return_size | integer | The number of objects that are returned. |
total_size | integer | The total number of objects. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_cost_categories | select | region | Retrieves an array of cost category names and values incurred cost. If some cost category names and values are not associated with any cost, they will not be returned by this API. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
region | string | AWS region (default: us-east-1) |
SELECT examples
- get_cost_categories
Retrieves an array of cost category names and values incurred cost. If some cost category names and values are not associated with any cost, they will not be returned by this API.
SELECT
cost_category_names,
cost_category_values,
next_page_token,
return_size,
total_size
FROM aws.ce.cost_categories
WHERE region = '{{ region }}' -- required
;