Skip to main content
API resource reference for BillingAccountBinding, part of the Billing service. To create or change one, see Changing resources; to inspect, see Reading resources.
This resource is part of the v1alpha1 API and is subject to change. Fields and behavior may change in future releases.

Identity

Groupbilling.miloapis.com
Versionv1alpha1
KindBillingAccountBinding
ScopeProject

Overview

A BillingAccountBinding connects a Project to a billing account so that the Project’s resource consumption is charged to that account. Creating a binding establishes billing responsibility for the Project; the platform tracks which account is currently responsible and when that responsibility took effect. All fields in the spec are immutable once the binding is created. To move a Project to a different billing account, create a new binding — the previous one moves to the Superseded phase.

Spec fields

FieldTypeRequiredDescription
spec.billingAccountRefObjectYesReferences the billing account to bind.
spec.billingAccountRef.namestringYesName of the BillingAccount.
spec.projectRefObjectYesReferences the project to bind to the billing account.
spec.projectRef.namestringYesName of the project.

Status fields (read-only)

FieldTypeDescription
status.phasestringCurrent lifecycle phase of the binding. One of Active or Superseded.
status.billingResponsibilityObjectTracks when billing responsibility was established for this binding.
status.billingResponsibility.currentAccountstringName of the currently responsible billing account.
status.billingResponsibility.establishedAtstringTime when billing responsibility was established.
status.conditions[]ObjectLatest available observations of the binding’s state.
status.observedGenerationintegerMost recent generation observed by the controller.

Usage

apiVersion: billing.miloapis.com/v1alpha1
kind: BillingAccountBinding
metadata:
  name: my-project-billing
spec:
  billingAccountRef:
    name: acme-billing-account
  projectRef:
    name: my-project
datumctl apply -f billingaccountbinding.yaml --project my-project
datumctl get billingaccountbindings --project my-project
datumctl describe billingaccountbindings my-project-billing --project my-project
Run datumctl explain billingaccountbindings --recursive to see the full, live field tree for this resource.
Last modified on July 2, 2026