billing_accounts

Creates, updates, deletes, gets or lists a billing_accounts resource.

Overview

Name	billing_accounts
Type	Resource
Id	google.cloudbilling.billing_accounts

Fields

Name	Datatype	Description
name	string	Output only. The resource name of the billing account. The resource name has the form billingAccounts/{billing_account_id}. For example, billingAccounts/012345-567890-ABCDEF would be the resource name for billing account 012345-567890-ABCDEF.
displayName	string	The display name given to the billing account, such as My Billing Account. This name is displayed in the Google Cloud Console.
masterBillingAccount	string	If this account is a subaccount, then this will be the resource name of the parent billing account that it is being resold through. Otherwise this will be empty.
open	boolean	Output only. True if the billing account is open, and will therefore be charged for any usage on associated projects. False if the billing account is closed, and therefore projects associated with it are unable to use paid services.
parent	string	Output only. The billing account's parent resource identifier. Use the MoveBillingAccount method to update the account's parent resource if it is a organization. Format: - organizations/{organization_id}, for example, organizations/12345678 - billingAccounts/{billing_account_id}, for example, billingAccounts/012345-567890-ABCDEF

Methods

Name	Accessible by	Required Params	Description
get	SELECT	billingAccountsId	Gets information about a billing account. The current authenticated user must be a viewer of the billing account.
list	SELECT	organizationsId	Lists the billing accounts that the current authenticated user has permission to view.
create	INSERT	organizationsId	This method creates billing subaccounts. Google Cloud resellers should use the Channel Services APIs, accounts.customers.create and accounts.customers.entitlements.create. When creating a subaccount, the current authenticated user must have the billing.accounts.update IAM permission on the parent account, which is typically given to billing account administrators. This method will return an error if the parent account has not been provisioned for subaccounts.
patch	UPDATE	billingAccountsId	Updates a billing account's fields. Currently the only field that can be edited is display_name. The current authenticated user must have the billing.accounts.update IAM permission, which is typically given to the administrator of the billing account.
move	EXEC	billingAccountsId, organizationsId	Changes which parent organization a billing account belongs to.

SELECT examples

Lists the billing accounts that the current authenticated user has permission to view.

SELECT
name,
displayName,
masterBillingAccount,
open,
parent
FROM google.cloudbilling.billing_accounts
WHERE organizationsId = '{{ organizationsId }}';

INSERT example

Use the following StackQL query and manifest file to create a new billing_accounts resource.

All Properties

/*+ create */
INSERT INTO google.cloudbilling.billing_accounts (
organizationsId,
displayName,
masterBillingAccount
)
SELECT 
'{{ organizationsId }}',
'{{ displayName }}',
'{{ masterBillingAccount }}'
;

Manifest

- name: your_resource_model_name
  props:
    - name: name
      value: string
    - name: open
      value: boolean
    - name: displayName
      value: string
    - name: masterBillingAccount
      value: string
    - name: parent
      value: string

UPDATE example

Updates a billing_accounts resource.

/*+ update */
UPDATE google.cloudbilling.billing_accounts
SET 
displayName = '{{ displayName }}',
masterBillingAccount = '{{ masterBillingAccount }}'
WHERE 
billingAccountsId = '{{ billingAccountsId }}';