Skip to main content

sub_accounts

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

Overview

Namesub_accounts
TypeResource
Idgoogle.cloudbilling.sub_accounts

Fields

NameDatatypeDescription
namestringOutput 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.
displayNamestringThe display name given to the billing account, such as My Billing Account. This name is displayed in the Google Cloud Console.
masterBillingAccountstringIf 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.
openbooleanOutput 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.
parentstringOutput 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

NameAccessible byRequired ParamsDescription
listSELECTbillingAccountsIdLists the billing accounts that the current authenticated user has permission to view.
createINSERTbillingAccountsIdThis 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.

SELECT examples

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

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

INSERT example

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

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