Cost Explorer

3 resource kinds. Generated from the operator's CRD schemas.

API Group: aws.konfig.io/v1alpha1

CECostCategory # CLOUD CONTROL · AWS::CE::CostCategory

CECostCategory manages AWS::CE::CostCategory through the AWS Cloud Control API.

kubectl get cecostcategories · example on GitHub

Example

# CECostCategory — Cost Explorer
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/costexplorer.html#cecostcategory
apiVersion: aws.konfig.io/v1alpha1
kind: CECostCategory
metadata:
  name: example-cecostcategory
  namespace: default
spec:
  defaultValue: example
  name: example-cecostcategory
  providerRef:
    name: example-cecostcategory
    region: us-east-1
  ruleVersion: CostCategoryExpression.v1
  rules: example
  splitChargeRules: example
  tags:
  - key: example
    value: example

Spec

Field	Type	Required	Description
`defaultValue`	string	—	The default value for the cost category
`name`	string	yes	Create-only in AWS: changing it requires replacing the resource.
`providerRef`	object	—	ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
`providerRef.name`	string	yes	Name of a cluster-scoped AWSProvider.
`providerRef.region`	string	—	Region overrides the provider's region for this resource only.
`ruleVersion`	enum	yes	Allowed: `CostCategoryExpression.v1`
`rules`	string	yes	JSON array format of Expression in Billing and Cost Management API
`splitChargeRules`	string	—	Json array format of CostCategorySplitChargeRule in Billing and Cost Management API
`tags`	array<object>	—	Tags to assign to the cost category.
`tags[].key`	string	yes
`tags[].value`	string	yes

Status

Field	Type	Required	Description
`arn`	string	—	Cost category ARN Read-only: reported by AWS after creation.
`attempt`	integer	—	Attempt counts failed create/delete requests; it salts the Cloud Control idempotency token so a retry is not served the cached failure.
`awsProvider`	object	—	AWSProvider confirms the account and region this resource was reconciled against.
`awsProvider.accountId`	string	—	AccountID the resource lives in.
`awsProvider.name`	string	—	Name of the AWSProvider used; empty when the operator's own credentials were used.
`awsProvider.region`	string	—	Region the resource lives in (empty for global services).
`conditions`	array<object>	—	Conditions describe the current state of the resource.
`conditions[].lastTransitionTime`	string	yes	lastTransitionTime is the last time the condition transitioned from one status to another.
`conditions[].message`	string	yes	message is a human readable message indicating details about the transition.
`conditions[].observedGeneration`	integer	—	observedGeneration represents the .metadata.generation that the condition was set based upon.
`conditions[].reason`	string	yes	reason contains a programmatic identifier indicating the reason for the condition's last transition.
`conditions[].status`	enum	yes	status of the condition, one of True, False, Unknown. Allowed: `True, False, Unknown`
`conditions[].type`	string	yes	type of condition in CamelCase or in foo.example.com/CamelCase.
`effectiveStart`	string	—	Read-only: reported by AWS after creation.
`identifier`	string	—	Identifier is the Cloud Control primary identifier of the resource.
`lastSyncTime`	string	—
`observedGeneration`	integer	—
`operation`	string	—	Operation is the in-flight operation (CREATE, UPDATE, DELETE).
`operationStatus`	string	—	OperationStatus is the last reported operation status.
`requestToken`	string	—	RequestToken tracks an in-flight asynchronous operation.

CostAnomalyMonitor # GA

CostAnomalyMonitor is the Schema for managing Cost Explorer anomaly monitors.

kubectl get costanomalymonitors · example on GitHub

Example

# CostAnomalyMonitor — Cost Explorer
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/costexplorer.html#costanomalymonitor
apiVersion: aws.konfig.io/v1alpha1
kind: CostAnomalyMonitor
metadata:
  name: example-costanomalymonitor
  namespace: default
spec:
  monitorDimension: SERVICE
  monitorName: example-costanomalymonitor
  monitorType: DIMENSIONAL
  providerRef:
    name: example-costanomalymonitor
    region: us-east-1

Spec

Field	Type	Required	Description
`monitorDimension`	enum	—	MonitorDimension is the dimension to evaluate for DIMENSIONAL monitors. Allowed: `SERVICE`
`monitorName`	string	yes	MonitorName is the name of the monitor.
`monitorType`	enum	yes	MonitorType is DIMENSIONAL or CUSTOM. Allowed: `DIMENSIONAL, CUSTOM`
`providerRef`	object	—	ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
`providerRef.name`	string	yes	Name of a cluster-scoped AWSProvider.
`providerRef.region`	string	—	Region overrides the provider's region for this resource only.

Status

Field	Type	Required	Description
`arn`	string	—	ARN is the ARN of the anomaly monitor.
`awsProvider`	object	—	AWSProvider confirms the account and region this resource was reconciled against.
`awsProvider.accountId`	string	—	AccountID the resource lives in.
`awsProvider.name`	string	—	Name of the AWSProvider used; empty when the operator's own credentials were used.
`awsProvider.region`	string	—	Region the resource lives in (empty for global services).
`conditions`	array<object>	—	Conditions describe the current state of the resource.
`conditions[].lastTransitionTime`	string	yes	lastTransitionTime is the last time the condition transitioned from one status to another.
`conditions[].message`	string	yes	message is a human readable message indicating details about the transition.
`conditions[].observedGeneration`	integer	—	observedGeneration represents the .metadata.generation that the condition was set based upon.
`conditions[].reason`	string	yes	reason contains a programmatic identifier indicating the reason for the condition's last transition.
`conditions[].status`	enum	yes	status of the condition, one of True, False, Unknown. Allowed: `True, False, Unknown`
`conditions[].type`	string	yes	type of condition in CamelCase or in foo.example.com/CamelCase.
`lastSyncTime`	string	—	LastSyncTime is when the resource was last successfully reconciled.
`observedGeneration`	integer	—	ObservedGeneration is the most recent .metadata.generation reconciled.

CostAnomalySubscription # GA

CostAnomalySubscription is the Schema for managing Cost Explorer anomaly subscriptions.

kubectl get costanomalysubscriptions · example on GitHub

Example

# CostAnomalySubscription — Cost Explorer
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/costexplorer.html#costanomalysubscription
apiVersion: aws.konfig.io/v1alpha1
kind: CostAnomalySubscription
metadata:
  name: example-costanomalysubscription
  namespace: default
spec:
  frequency: DAILY
  monitorRefs:
  - name: example-monitorrefs
  providerRef:
    name: example-costanomalysubscription
    region: us-east-1
  subscribers:
  - address: example
    type: EMAIL
  subscriptionName: example-costanomalysubscription
  threshold: '100'

Spec

Field	Type	Required	Description
`frequency`	enum	yes	Frequency is how often notifications are sent. Allowed: `DAILY, IMMEDIATE, WEEKLY`
`monitorRefs`	array<object>	yes	MonitorRefs references the anomaly monitors this subscription alerts on.
`monitorRefs[].arn`	string	—	ARN is a direct Cost Explorer anomaly monitor ARN, bypassing CR lookup.
`monitorRefs[].name`	string	—	Name of a CostAnomalyMonitor CR in the same namespace.
`providerRef`	object	—	ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
`providerRef.name`	string	yes	Name of a cluster-scoped AWSProvider.
`providerRef.region`	string	—	Region overrides the provider's region for this resource only.
`subscribers`	array<object>	yes	Subscribers to notify about anomalies.
`subscribers[].address`	string	yes	Address is the email address or SNS topic ARN to notify.
`subscribers[].type`	enum	yes	Type is the delivery channel. Allowed: `EMAIL, SNS`
`subscriptionName`	string	yes	SubscriptionName is the name of the subscription.
`threshold`	string	yes	Threshold is the absolute dollar impact an anomaly must exceed to trigger a notification, as a numeric string (e.g.

Status

Field	Type	Required	Description
`arn`	string	—	ARN is the ARN of the anomaly subscription.
`awsProvider`	object	—	AWSProvider confirms the account and region this resource was reconciled against.
`awsProvider.accountId`	string	—	AccountID the resource lives in.
`awsProvider.name`	string	—	Name of the AWSProvider used; empty when the operator's own credentials were used.
`awsProvider.region`	string	—	Region the resource lives in (empty for global services).
`conditions`	array<object>	—	Conditions describe the current state of the resource.
`conditions[].lastTransitionTime`	string	yes	lastTransitionTime is the last time the condition transitioned from one status to another.
`conditions[].message`	string	yes	message is a human readable message indicating details about the transition.
`conditions[].observedGeneration`	integer	—	observedGeneration represents the .metadata.generation that the condition was set based upon.
`conditions[].reason`	string	yes	reason contains a programmatic identifier indicating the reason for the condition's last transition.
`conditions[].status`	enum	yes	status of the condition, one of True, False, Unknown. Allowed: `True, False, Unknown`
`conditions[].type`	string	yes	type of condition in CamelCase or in foo.example.com/CamelCase.
`lastSyncTime`	string	—	LastSyncTime is when the resource was last successfully reconciled.
`observedGeneration`	integer	—	ObservedGeneration is the most recent .metadata.generation reconciled.