gcloud alpha billing budgets create

NAME
gcloud alpha billing budgets create - create a budget
SYNOPSIS
gcloud alpha billing budgets create --billing-account=BILLING_ACCOUNT --display-name=DISPLAY_NAME (--budget-amount=BUDGET_AMOUNT     | --last-period-amount) [--all-updates-rule-pubsub-topic=ALL_UPDATES_RULE_PUBSUB_TOPIC] [--credit-types-treatment=CREDIT_TYPES_TREATMENT] [--filter-projects=[FILTER_PROJECTS,…]] [--filter-services=[FILTER_SERVICES,…]] [--threshold-rule=THRESHOLD_RULE] [GCLOUD_WIDE_FLAG]
DESCRIPTION
(ALPHA) Create a budget.
REQUIRED FLAGS
Billing account resource - Billing account under which to create the budget. This represents a Cloud resource. This must be specified.
--billing-account=BILLING_ACCOUNT
ID of the billing-account or fully qualified identifier for the billing-account.
--display-name=DISPLAY_NAME
User data for display name in UI. Must be less than or equal to 60 characters.
Exactly one of these must be specified:
--budget-amount=BUDGET_AMOUNT
Specify the amount of the budget. If a currency type is included, it must be the currency associated with the billing account. If excluded, the currency used will be the currency associated with the billing account.
--last-period-amount
Use the amount of last period's budget.
OPTIONAL FLAGS
--all-updates-rule-pubsub-topic=ALL_UPDATES_RULE_PUBSUB_TOPIC
The name of the Cloud Pub/Sub topic where budget related messages will be published, in the form projects/{project_id}/topics/{topic_id}.
--credit-types-treatment=CREDIT_TYPES_TREATMENT
Whether to include all credit types include when calculating the actual spend against the budget. If this is not specified, then all credit types are used in the calculation. CREDIT_TYPES_TREATMENT must be one of: credit-types-treatment-unspecified, exclude-all-credits, include-all-credits.
--filter-projects=[FILTER_PROJECTS,…]
A set of projects in the form projects/{project_id}, specifying that usage from only this set of projects should be included in the budget. If omitted, all projects will be included.
--filter-services=[FILTER_SERVICES,…]
A set of services of the form services/{service_id}, specifying that usage from only this set of services should be included in the budget. If omitted, the report will include usage for all services. The service names are available through the Catalog API: https://cloud.google.com/billing/v1/how-tos/catalog-api.
--threshold-rule=THRESHOLD_RULE
Rule that triggers alerts (notifications of thresholds being crossed) when spend exceeds the specified percentages of the budget. This flag can be repeated to provide multiple thresholds above which an alert is sent.
percent
Integer between 0 and 100 above which an alert is sent.
basis
type of basis used to determine if spend has passed the threshold. Must be one of: 'current-spend' or 'forecasted-spend'. Behavior defaults to 'current-spend' if not set.
GCLOUD WIDE FLAGS
These flags are available to all commands: --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

API REFERENCE
This command uses the billingbudgets/v1beta1 API. The full documentation for this API can be found at: https://cloud.google.com/billing/docs/how-to/budget-api-overview
EXAMPLES
To create a budget with the display name 'BUDGET1' in the amount of 100.75 in the default currency ('USD'), to receive notifications when 50% of the current budget or 75% of the forecasted budget is spent in the account '123', run:
  $ gcloud alpha billing budgets create --billing-account=123 \
      --display-name="BUDGET1" --budget-amount=100.75USD \
      --threshold-rule=percent=50 \
      --threshold-rule=percent=75,basis=forecasted-spend
NOTES
This command is currently in ALPHA and may change without notice. If this command fails with API permission errors despite specifying the right project, you may be trying to access an API with an invitation-only early access whitelist.