mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-08 02:25:19 +00:00
gcloud: Wed Aug 23 10:30:46 UTC 2023
This commit is contained in:
parent
5f3d6bc974
commit
f9edf67fe5
677 changed files with 22815 additions and 975 deletions
72
gcloud/billing/accounts/add-iam-policy-binding
Normal file
72
gcloud/billing/accounts/add-iam-policy-binding
Normal file
|
|
@ -0,0 +1,72 @@
|
|||
NAME
|
||||
gcloud billing accounts add-iam-policy-binding - add an IAM policy binding
|
||||
to a Cloud Billing account
|
||||
|
||||
SYNOPSIS
|
||||
gcloud billing accounts add-iam-policy-binding ACCOUNT --member=PRINCIPAL
|
||||
--role=ROLE [GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
Add an IAM policy binding to the IAM policy of a Cloud Billing account. A
|
||||
binding consists of a member and a role.
|
||||
|
||||
EXAMPLES
|
||||
To add someone@example.com as a Billing Account Administrator for billing
|
||||
account 123456-789876-543210, run:
|
||||
|
||||
$ gcloud billing accounts add-iam-policy-binding \
|
||||
123456-789876-543210 --member='user:someone@example.com' \
|
||||
--role='roles/billing.admin'
|
||||
|
||||
POSITIONAL ARGUMENTS
|
||||
Account resource - Name of the Cloud Billing account for which to add the
|
||||
IAM policy binding. This represents a Cloud resource.
|
||||
|
||||
This must be specified.
|
||||
|
||||
ACCOUNT
|
||||
ID of the account or fully qualified identifier for the account.
|
||||
|
||||
To set the account attribute:
|
||||
▸ provide the argument account on the command line.
|
||||
|
||||
REQUIRED FLAGS
|
||||
--member=PRINCIPAL
|
||||
The principal to add the binding for. Should be of the form
|
||||
user|group|serviceAccount:email or domain:domain.
|
||||
|
||||
Examples: user:test-user@gmail.com, group:admins@example.com,
|
||||
serviceAccount:test123@example.domain.com, or
|
||||
domain:example.domain.com.
|
||||
|
||||
Some resources also accept the following special values:
|
||||
◆ allUsers - Special identifier that represents anyone who is on the
|
||||
internet, with or without a Google account.
|
||||
◆ allAuthenticatedUsers - Special identifier that represents anyone
|
||||
who is authenticated with a Google account or a service account.
|
||||
|
||||
--role=ROLE
|
||||
Role name to assign to the principal. The role name is the complete
|
||||
path of a predefined role, such as roles/logging.viewer, or the role ID
|
||||
for a custom role, such as
|
||||
organizations/{ORGANIZATION_ID}/roles/logging.viewer.
|
||||
|
||||
GCLOUD WIDE FLAGS
|
||||
These flags are available to all commands: --access-token-file, --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 cloudbilling/v1 API. The full documentation for this
|
||||
API can be found at: https://cloud.google.com/billing/docs/apis
|
||||
|
||||
NOTES
|
||||
These variants are also available:
|
||||
|
||||
$ gcloud alpha billing accounts add-iam-policy-binding
|
||||
|
||||
$ gcloud beta billing accounts add-iam-policy-binding
|
||||
|
||||
44
gcloud/billing/accounts/describe
Normal file
44
gcloud/billing/accounts/describe
Normal file
|
|
@ -0,0 +1,44 @@
|
|||
NAME
|
||||
gcloud billing accounts describe - show metadata for a billing account
|
||||
|
||||
SYNOPSIS
|
||||
gcloud billing accounts describe ACCOUNT_ID [GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
This command shows info for a billing account, given its ID.
|
||||
|
||||
This call can fail for the following reasons:
|
||||
|
||||
▪ The account specified does not exist.
|
||||
▪ The active user does not have permission to access the given account.
|
||||
|
||||
EXAMPLES
|
||||
To see details for billing account 0X0X0X-0X0X0X-0X0X0X, run:
|
||||
|
||||
$ gcloud billing accounts describe 0X0X0X-0X0X0X-0X0X0X
|
||||
|
||||
POSITIONAL ARGUMENTS
|
||||
ACCOUNT_ID
|
||||
Specify a billing account ID. Billing account IDs are of the form
|
||||
0X0X0X-0X0X0X-0X0X0X. To see available IDs, run $ gcloud billing
|
||||
accounts list.
|
||||
|
||||
GCLOUD WIDE FLAGS
|
||||
These flags are available to all commands: --access-token-file, --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 cloudbilling/v1 API. The full documentation for this
|
||||
API can be found at: https://cloud.google.com/billing/v1/getting-started
|
||||
|
||||
NOTES
|
||||
These variants are also available:
|
||||
|
||||
$ gcloud alpha billing accounts describe
|
||||
|
||||
$ gcloud beta billing accounts describe
|
||||
|
||||
79
gcloud/billing/accounts/get-iam-policy
Normal file
79
gcloud/billing/accounts/get-iam-policy
Normal file
|
|
@ -0,0 +1,79 @@
|
|||
NAME
|
||||
gcloud billing accounts get-iam-policy - get the IAM policy for a Cloud
|
||||
Billing account
|
||||
|
||||
SYNOPSIS
|
||||
gcloud billing accounts get-iam-policy ACCOUNT [--filter=EXPRESSION]
|
||||
[--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]]
|
||||
[GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
gcloud billing accounts get-iam-policy displays the IAM policy associated
|
||||
with a Cloud Billing account. If formatted as JSON, the output can be
|
||||
edited and used as a policy file for set-iam-policy. The output includes an
|
||||
"etag" field identifying the version emitted and allowing detection of
|
||||
concurrent policy updates; see $ {parent} set-iam-policy for additional
|
||||
details.
|
||||
|
||||
EXAMPLES
|
||||
To print the IAM policy for a given Cloud Billing account, run:
|
||||
|
||||
$ gcloud billing accounts get-iam-policy my-account
|
||||
|
||||
POSITIONAL ARGUMENTS
|
||||
Account resource - The Cloud Billing account for which to display the IAM
|
||||
policy. This represents a Cloud resource.
|
||||
|
||||
This must be specified.
|
||||
|
||||
ACCOUNT
|
||||
ID of the account or fully qualified identifier for the account.
|
||||
|
||||
To set the account attribute:
|
||||
▸ provide the argument account on the command line.
|
||||
|
||||
LIST COMMAND FLAGS
|
||||
--filter=EXPRESSION
|
||||
Apply a Boolean filter EXPRESSION to each resource item to be listed.
|
||||
If the expression evaluates True, then that item is listed. For more
|
||||
details and examples of filter expressions, run $ gcloud topic filters.
|
||||
This flag interacts with other flags that are applied in this order:
|
||||
--flatten, --sort-by, --filter, --limit.
|
||||
|
||||
--limit=LIMIT
|
||||
Maximum number of resources to list. The default is unlimited. This
|
||||
flag interacts with other flags that are applied in this order:
|
||||
--flatten, --sort-by, --filter, --limit.
|
||||
|
||||
--page-size=PAGE_SIZE
|
||||
Some services group resource list output into pages. This flag
|
||||
specifies the maximum number of resources per page. The default is
|
||||
determined by the service if it supports paging, otherwise it is
|
||||
unlimited (no paging). Paging may be applied before or after --filter
|
||||
and --limit depending on the service.
|
||||
|
||||
--sort-by=[FIELD,...]
|
||||
Comma-separated list of resource field key names to sort by. The
|
||||
default order is ascending. Prefix a field with ``~'' for descending
|
||||
order on that field. This flag interacts with other flags that are
|
||||
applied in this order: --flatten, --sort-by, --filter, --limit.
|
||||
|
||||
GCLOUD WIDE FLAGS
|
||||
These flags are available to all commands: --access-token-file, --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 cloudbilling/v1 API. The full documentation for this
|
||||
API can be found at: https://cloud.google.com/billing/docs/apis
|
||||
|
||||
NOTES
|
||||
These variants are also available:
|
||||
|
||||
$ gcloud alpha billing accounts get-iam-policy
|
||||
|
||||
$ gcloud beta billing accounts get-iam-policy
|
||||
|
||||
42
gcloud/billing/accounts/help
Normal file
42
gcloud/billing/accounts/help
Normal file
|
|
@ -0,0 +1,42 @@
|
|||
NAME
|
||||
gcloud billing accounts - manage billing accounts
|
||||
|
||||
SYNOPSIS
|
||||
gcloud billing accounts COMMAND [GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
Manage billing accounts.
|
||||
|
||||
GCLOUD WIDE FLAGS
|
||||
These flags are available to all commands: --help.
|
||||
|
||||
Run $ gcloud help for details.
|
||||
|
||||
COMMANDS
|
||||
COMMAND is one of the following:
|
||||
|
||||
add-iam-policy-binding
|
||||
Add an IAM policy binding to a Cloud Billing account.
|
||||
|
||||
describe
|
||||
Show metadata for a billing account.
|
||||
|
||||
get-iam-policy
|
||||
Get the IAM policy for a Cloud Billing account.
|
||||
|
||||
list
|
||||
List all active billing accounts.
|
||||
|
||||
remove-iam-policy-binding
|
||||
Remove an IAM policy binding from a Cloud Billing account.
|
||||
|
||||
set-iam-policy
|
||||
Set the IAM policy for a Cloud Billing account.
|
||||
|
||||
NOTES
|
||||
These variants are also available:
|
||||
|
||||
$ gcloud alpha billing accounts
|
||||
|
||||
$ gcloud beta billing accounts
|
||||
|
||||
69
gcloud/billing/accounts/list
Normal file
69
gcloud/billing/accounts/list
Normal file
|
|
@ -0,0 +1,69 @@
|
|||
NAME
|
||||
gcloud billing accounts list - list all active billing accounts
|
||||
|
||||
SYNOPSIS
|
||||
gcloud billing accounts list [--filter=EXPRESSION] [--limit=LIMIT]
|
||||
[--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
|
||||
[GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
gcloud billing accounts list lists all billing accounts and subaccounts
|
||||
owned by the currently authenticated user. Subaccounts have a non-empty
|
||||
MASTER_ACCOUNT_ID value.
|
||||
|
||||
EXAMPLES
|
||||
To list only open billing accounts, run:
|
||||
|
||||
$ gcloud billing accounts list --filter=open=true
|
||||
|
||||
LIST COMMAND FLAGS
|
||||
--filter=EXPRESSION
|
||||
Apply a Boolean filter EXPRESSION to each resource item to be listed.
|
||||
If the expression evaluates True, then that item is listed. For more
|
||||
details and examples of filter expressions, run $ gcloud topic filters.
|
||||
This flag interacts with other flags that are applied in this order:
|
||||
--flatten, --sort-by, --filter, --limit.
|
||||
|
||||
--limit=LIMIT
|
||||
Maximum number of resources to list. The default is unlimited. This
|
||||
flag interacts with other flags that are applied in this order:
|
||||
--flatten, --sort-by, --filter, --limit.
|
||||
|
||||
--page-size=PAGE_SIZE
|
||||
Some services group resource list output into pages. This flag
|
||||
specifies the maximum number of resources per page. The default is
|
||||
determined by the service if it supports paging, otherwise it is
|
||||
unlimited (no paging). Paging may be applied before or after --filter
|
||||
and --limit depending on the service.
|
||||
|
||||
--sort-by=[FIELD,...]
|
||||
Comma-separated list of resource field key names to sort by. The
|
||||
default order is ascending. Prefix a field with ``~'' for descending
|
||||
order on that field. This flag interacts with other flags that are
|
||||
applied in this order: --flatten, --sort-by, --filter, --limit.
|
||||
|
||||
--uri
|
||||
Print a list of resource URIs instead of the default output, and change
|
||||
the command output to a list of URIs. If this flag is used with
|
||||
--format, the formatting is applied on this URI list. To display URIs
|
||||
alongside other keys instead, use the uri() transform.
|
||||
|
||||
GCLOUD WIDE FLAGS
|
||||
These flags are available to all commands: --access-token-file, --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 cloudbilling/v1 API. The full documentation for this
|
||||
API can be found at: https://cloud.google.com/billing/v1/getting-started
|
||||
|
||||
NOTES
|
||||
These variants are also available:
|
||||
|
||||
$ gcloud alpha billing accounts list
|
||||
|
||||
$ gcloud beta billing accounts list
|
||||
|
||||
73
gcloud/billing/accounts/remove-iam-policy-binding
Normal file
73
gcloud/billing/accounts/remove-iam-policy-binding
Normal file
|
|
@ -0,0 +1,73 @@
|
|||
NAME
|
||||
gcloud billing accounts remove-iam-policy-binding - remove an IAM policy
|
||||
binding from a Cloud Billing account
|
||||
|
||||
SYNOPSIS
|
||||
gcloud billing accounts remove-iam-policy-binding ACCOUNT
|
||||
--member=PRINCIPAL --role=ROLE [GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
Remove an IAM policy binding to the IAM policy from a Cloud Billing
|
||||
account. A binding consists of a member and a role.
|
||||
|
||||
EXAMPLES
|
||||
To remove someone@example.com as a Billing Account Administrator from
|
||||
billing account 123456-789876-543210, run:
|
||||
|
||||
$ gcloud billing accounts remove-iam-policy-binding \
|
||||
123456-789876-543210 --member='user:someone@example.com' \
|
||||
--role='roles/billing.admin'
|
||||
|
||||
POSITIONAL ARGUMENTS
|
||||
Account resource - Name of the Cloud Billing account for which to remove
|
||||
the IAM policy binding. This represents a Cloud resource.
|
||||
|
||||
This must be specified.
|
||||
|
||||
ACCOUNT
|
||||
ID of the account or fully qualified identifier for the account.
|
||||
|
||||
To set the account attribute:
|
||||
▸ provide the argument account on the command line.
|
||||
|
||||
REQUIRED FLAGS
|
||||
--member=PRINCIPAL
|
||||
The principal to remove the binding for. Should be of the form
|
||||
user|group|serviceAccount:email or domain:domain.
|
||||
|
||||
Examples: user:test-user@gmail.com, group:admins@example.com,
|
||||
serviceAccount:test123@example.domain.com, or
|
||||
domain:example.domain.com.
|
||||
|
||||
Deleted principals have an additional deleted: prefix and a ?uid=UID
|
||||
suffix, where UID is a unique identifier for the principal. Example:
|
||||
deleted:user:test-user@gmail.com?uid=123456789012345678901.
|
||||
|
||||
Some resources also accept the following special values:
|
||||
◆ allUsers - Special identifier that represents anyone who is on the
|
||||
internet, with or without a Google account.
|
||||
◆ allAuthenticatedUsers - Special identifier that represents anyone
|
||||
who is authenticated with a Google account or a service account.
|
||||
|
||||
--role=ROLE
|
||||
The role to remove the principal from.
|
||||
|
||||
GCLOUD WIDE FLAGS
|
||||
These flags are available to all commands: --access-token-file, --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 cloudbilling/v1 API. The full documentation for this
|
||||
API can be found at: https://cloud.google.com/billing/docs/apis
|
||||
|
||||
NOTES
|
||||
These variants are also available:
|
||||
|
||||
$ gcloud alpha billing accounts remove-iam-policy-binding
|
||||
|
||||
$ gcloud beta billing accounts remove-iam-policy-binding
|
||||
|
||||
64
gcloud/billing/accounts/set-iam-policy
Normal file
64
gcloud/billing/accounts/set-iam-policy
Normal file
|
|
@ -0,0 +1,64 @@
|
|||
NAME
|
||||
gcloud billing accounts set-iam-policy - set the IAM policy for a Cloud
|
||||
Billing account
|
||||
|
||||
SYNOPSIS
|
||||
gcloud billing accounts set-iam-policy ACCOUNT POLICY_FILE
|
||||
[GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
gcloud billing accounts set-iam-policy sets the IAM policy for a Cloud
|
||||
Billing account given an account ID and a JSON or YAML file that describes
|
||||
the IAM policy.
|
||||
|
||||
Note: Setting the IAM policy for a Cloud Billing account replaces existing
|
||||
IAM bindings for that account.
|
||||
|
||||
EXAMPLES
|
||||
The following command reads an IAM policy defined in the JSON file
|
||||
policy.json and sets it for a Billing account ID 123456-789876-543210:
|
||||
|
||||
$ gcloud billing accounts set-iam-policy 123456-789876-543210 \
|
||||
policy.json
|
||||
|
||||
See https://cloud.google.com/iam/docs/managing-policies for policy file
|
||||
format and content details.
|
||||
|
||||
POSITIONAL ARGUMENTS
|
||||
Account resource - The Cloud Billing account for which to display the IAM
|
||||
policy. This represents a Cloud resource.
|
||||
|
||||
This must be specified.
|
||||
|
||||
ACCOUNT
|
||||
ID of the account or fully qualified identifier for the account.
|
||||
|
||||
To set the account attribute:
|
||||
▸ provide the argument account on the command line.
|
||||
|
||||
POLICY_FILE
|
||||
Path to a local JSON or YAML formatted file containing a valid policy.
|
||||
|
||||
The output of the get-iam-policy command is a valid file, as is any
|
||||
JSON or YAML file conforming to the structure of a Policy
|
||||
(https://cloud.google.com/iam/reference/rest/v1/Policy).
|
||||
|
||||
GCLOUD WIDE FLAGS
|
||||
These flags are available to all commands: --access-token-file, --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 cloudbilling/v1 API. The full documentation for this
|
||||
API can be found at: https://cloud.google.com/billing/docs/apis
|
||||
|
||||
NOTES
|
||||
These variants are also available:
|
||||
|
||||
$ gcloud alpha billing accounts set-iam-policy
|
||||
|
||||
$ gcloud beta billing accounts set-iam-policy
|
||||
|
||||
|
|
@ -8,14 +8,14 @@ SYNOPSIS
|
|||
[--credit-types-treatment=CREDIT_TYPES_TREATMENT]
|
||||
[--disable-default-iam-recipients]
|
||||
[--filter-credit-types=[FILTER_CREDIT_TYPES,...]]
|
||||
[--filter-labels=FILTER_LABELS]
|
||||
[--filter-labels=[KEY=VALUE,...]]
|
||||
[--filter-projects=[FILTER_PROJECTS,...]]
|
||||
[--filter-services=[FILTER_SERVICES,...]]
|
||||
[--filter-subaccounts=[FILTER_SUBACCOUNTS,...]]
|
||||
[--notifications-rule-monitoring-notification-channels=[NOTIFICATIONS_RULE_MONITORING_NOTIFICATION_CHANNELS,
|
||||
...]]
|
||||
[--notifications-rule-pubsub-topic=NOTIFICATIONS_RULE_PUBSUB_TOPIC]
|
||||
[--threshold-rule=THRESHOLD_RULE]
|
||||
[--threshold-rule=[basis=BASIS],[percent=PERCENT]]
|
||||
[--calendar-period=CALENDAR_PERIOD
|
||||
| [--start-date=START_DATE : --end-date=END_DATE]]
|
||||
[GCLOUD_WIDE_FLAG ...]
|
||||
|
|
@ -84,7 +84,7 @@ OPTIONAL FLAGS
|
|||
specified, then --credit-types-treatment must be
|
||||
include-specified-credits.
|
||||
|
||||
--filter-labels=FILTER_LABELS
|
||||
--filter-labels=[KEY=VALUE,...]
|
||||
Single label and value pair specifying that usage from only this set of
|
||||
labeled resources should be included in the budget. Currently, multiple
|
||||
entries or multiple values per entry are not allowed. If omitted, the
|
||||
|
|
@ -124,7 +124,7 @@ OPTIONAL FLAGS
|
|||
Name of the Cloud Pub/Sub topic where budget related messages will be
|
||||
published, in the form projects/{project_id}/topics/{topic_id}.
|
||||
|
||||
--threshold-rule=THRESHOLD_RULE
|
||||
--threshold-rule=[basis=BASIS],[percent=PERCENT]
|
||||
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
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@ SYNOPSIS
|
|||
[--credit-types-treatment=CREDIT_TYPES_TREATMENT]
|
||||
[--disable-default-iam-recipients] [--display-name=DISPLAY_NAME]
|
||||
[--filter-credit-types=[FILTER_CREDIT_TYPES,...]]
|
||||
[--filter-labels=FILTER_LABELS]
|
||||
[--filter-labels=[KEY=VALUE,...]]
|
||||
[--filter-projects=[FILTER_PROJECTS,...]]
|
||||
[--filter-services=[FILTER_SERVICES,...]]
|
||||
[--filter-subaccounts=[FILTER_SUBACCOUNTS,...]]
|
||||
|
|
@ -17,8 +17,8 @@ SYNOPSIS
|
|||
[--calendar-period=CALENDAR_PERIOD
|
||||
| [--start-date=START_DATE : --end-date=END_DATE]]
|
||||
[--threshold-rules-from-file=THRESHOLD_RULES_FROM_FILE
|
||||
| --add-threshold-rule=ADD_THRESHOLD_RULE --clear-threshold-rules]
|
||||
[GCLOUD_WIDE_FLAG ...]
|
||||
| --add-threshold-rule=[basis=BASIS],[percent=PERCENT]
|
||||
--clear-threshold-rules] [GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
Update a budget.
|
||||
|
|
@ -84,7 +84,7 @@ FLAGS
|
|||
specified, then --credit-types-treatment must be
|
||||
include-specified-credits.
|
||||
|
||||
--filter-labels=FILTER_LABELS
|
||||
--filter-labels=[KEY=VALUE,...]
|
||||
Single label and value pair specifying that usage from only this set of
|
||||
labeled resources should be included in the budget. Currently, multiple
|
||||
entries or multiple values per entry are not allowed. If omitted, the
|
||||
|
|
@ -160,7 +160,7 @@ FLAGS
|
|||
in the file will replace the rules in the budget. This can be used to
|
||||
add or remove specific threshold rules.
|
||||
|
||||
--add-threshold-rule=ADD_THRESHOLD_RULE
|
||||
--add-threshold-rule=[basis=BASIS],[percent=PERCENT]
|
||||
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
|
||||
|
|
|
|||
|
|
@ -10,12 +10,12 @@ DESCRIPTION
|
|||
EXAMPLES
|
||||
To list billing accounts associated with the current user, run:
|
||||
|
||||
$ gcloud beta billing accounts list
|
||||
$ gcloud billing accounts list
|
||||
|
||||
To link one of the billing accounts 0X0X0X-0X0X0X-0X0X0X with a project
|
||||
my-project, run:
|
||||
|
||||
$ gcloud beta billing projects link my-project \
|
||||
$ gcloud billing projects link my-project \
|
||||
--billing-account 0X0X0X-0X0X0X-0X0X0X
|
||||
|
||||
GCLOUD WIDE FLAGS
|
||||
|
|
@ -26,9 +26,15 @@ GCLOUD WIDE FLAGS
|
|||
GROUPS
|
||||
GROUP is one of the following:
|
||||
|
||||
accounts
|
||||
Manage billing accounts.
|
||||
|
||||
budgets
|
||||
Manage the budgets of your billing accounts.
|
||||
|
||||
projects
|
||||
Manage the billing account configuration of your projects.
|
||||
|
||||
NOTES
|
||||
These variants are also available:
|
||||
|
||||
|
|
|
|||
43
gcloud/billing/projects/describe
Normal file
43
gcloud/billing/projects/describe
Normal file
|
|
@ -0,0 +1,43 @@
|
|||
NAME
|
||||
gcloud billing projects describe - show detailed billing information for a
|
||||
project
|
||||
|
||||
SYNOPSIS
|
||||
gcloud billing projects describe PROJECT_ID [GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
This command shows billing info for a project, given its ID.
|
||||
|
||||
This call can fail for the following reasons:
|
||||
|
||||
▪ The project specified does not exist.
|
||||
▪ The active user does not have permission to access the given project.
|
||||
|
||||
EXAMPLES
|
||||
To see detailed billing information for a project my-project, run:
|
||||
|
||||
$ gcloud billing projects describe my-project
|
||||
|
||||
POSITIONAL ARGUMENTS
|
||||
PROJECT_ID
|
||||
Specify a project id.
|
||||
|
||||
GCLOUD WIDE FLAGS
|
||||
These flags are available to all commands: --access-token-file, --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 cloudbilling/v1 API. The full documentation for this
|
||||
API can be found at: https://cloud.google.com/billing/v1/getting-started
|
||||
|
||||
NOTES
|
||||
These variants are also available:
|
||||
|
||||
$ gcloud alpha billing projects describe
|
||||
|
||||
$ gcloud beta billing projects describe
|
||||
|
||||
37
gcloud/billing/projects/help
Normal file
37
gcloud/billing/projects/help
Normal file
|
|
@ -0,0 +1,37 @@
|
|||
NAME
|
||||
gcloud billing projects - manage the billing account configuration of your
|
||||
projects
|
||||
|
||||
SYNOPSIS
|
||||
gcloud billing projects COMMAND [GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
Manage the billing account configuration of your projects.
|
||||
|
||||
GCLOUD WIDE FLAGS
|
||||
These flags are available to all commands: --help.
|
||||
|
||||
Run $ gcloud help for details.
|
||||
|
||||
COMMANDS
|
||||
COMMAND is one of the following:
|
||||
|
||||
describe
|
||||
Show detailed billing information for a project.
|
||||
|
||||
link
|
||||
Link a project with a billing account.
|
||||
|
||||
list
|
||||
List all active projects associated with the specified billing account.
|
||||
|
||||
unlink
|
||||
Unlink the account (if any) linked with a project.
|
||||
|
||||
NOTES
|
||||
These variants are also available:
|
||||
|
||||
$ gcloud alpha billing projects
|
||||
|
||||
$ gcloud beta billing projects
|
||||
|
||||
61
gcloud/billing/projects/link
Normal file
61
gcloud/billing/projects/link
Normal file
|
|
@ -0,0 +1,61 @@
|
|||
NAME
|
||||
gcloud billing projects link - link a project with a billing account
|
||||
|
||||
SYNOPSIS
|
||||
gcloud billing projects link PROJECT_ID --billing-account=ACCOUNT_ID
|
||||
[GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
This command sets or updates the billing account associated with a project.
|
||||
|
||||
Billing is enabled on a project when the project is linked to a valid,
|
||||
active Cloud Billing account. The billing account accrues charges for the
|
||||
usage of resources in all of the linked projects. If the project is already
|
||||
linked to a billing account, this command moves the project to the billing
|
||||
account you specify, updating the billing account that is linked to the
|
||||
project.
|
||||
|
||||
Note that associating a project with a closed billing account has the same
|
||||
effect as disabling billing on the project: any paid resources in use by
|
||||
the project are shut down, and your application stops functioning. Unless
|
||||
you want to disable billing, you should always specify a valid, active
|
||||
Cloud Billing account when you run this command. Learn how to confirm the
|
||||
status of a Cloud Billing account at
|
||||
https://cloud.google.com/billing/docs/how-to/verify-billing-enabled#billing_account_status
|
||||
|
||||
EXAMPLES
|
||||
To link a billing account 0X0X0X-0X0X0X-0X0X0X with a project my-project,
|
||||
run:
|
||||
|
||||
$ gcloud billing projects link my-project \
|
||||
--billing-account=0X0X0X-0X0X0X-0X0X0X
|
||||
|
||||
POSITIONAL ARGUMENTS
|
||||
PROJECT_ID
|
||||
Specify a project id.
|
||||
|
||||
REQUIRED FLAGS
|
||||
--billing-account=ACCOUNT_ID
|
||||
Specify a billing account ID. Billing account IDs are of the form
|
||||
0X0X0X-0X0X0X-0X0X0X. To see available IDs, run $ gcloud billing
|
||||
accounts list.
|
||||
|
||||
GCLOUD WIDE FLAGS
|
||||
These flags are available to all commands: --access-token-file, --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 cloudbilling/v1 API. The full documentation for this
|
||||
API can be found at: https://cloud.google.com/billing/v1/getting-started
|
||||
|
||||
NOTES
|
||||
These variants are also available:
|
||||
|
||||
$ gcloud alpha billing projects link
|
||||
|
||||
$ gcloud beta billing projects link
|
||||
|
||||
65
gcloud/billing/projects/list
Normal file
65
gcloud/billing/projects/list
Normal file
|
|
@ -0,0 +1,65 @@
|
|||
NAME
|
||||
gcloud billing projects list - list all active projects associated with the
|
||||
specified billing account
|
||||
|
||||
SYNOPSIS
|
||||
gcloud billing projects list --billing-account=ACCOUNT_ID
|
||||
[--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE]
|
||||
[--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
gcloud billing projects list ACCOUNT_ID -- lists all active projects, for
|
||||
the specified billing account id.
|
||||
|
||||
EXAMPLES
|
||||
To list projects linked to billing account 0X0X0X-0X0X0X-0X0X0X, run:
|
||||
|
||||
$ gcloud billing projects list --billing-account=0X0X0X-0X0X0X-0X0X0X
|
||||
|
||||
REQUIRED FLAGS
|
||||
--billing-account=ACCOUNT_ID
|
||||
Specify a billing account ID. Billing account IDs are of the form
|
||||
0X0X0X-0X0X0X-0X0X0X. To see available IDs, run $ gcloud billing
|
||||
accounts list.
|
||||
|
||||
LIST COMMAND FLAGS
|
||||
--filter=EXPRESSION
|
||||
Apply a Boolean filter EXPRESSION to each resource item to be listed.
|
||||
If the expression evaluates True, then that item is listed. For more
|
||||
details and examples of filter expressions, run $ gcloud topic filters.
|
||||
This flag interacts with other flags that are applied in this order:
|
||||
--flatten, --sort-by, --filter, --limit.
|
||||
|
||||
--limit=LIMIT
|
||||
Maximum number of resources to list. The default is unlimited. This
|
||||
flag interacts with other flags that are applied in this order:
|
||||
--flatten, --sort-by, --filter, --limit.
|
||||
|
||||
--page-size=PAGE_SIZE
|
||||
Some services group resource list output into pages. This flag
|
||||
specifies the maximum number of resources per page. The default is
|
||||
determined by the service if it supports paging, otherwise it is
|
||||
unlimited (no paging). Paging may be applied before or after --filter
|
||||
and --limit depending on the service.
|
||||
|
||||
--sort-by=[FIELD,...]
|
||||
Comma-separated list of resource field key names to sort by. The
|
||||
default order is ascending. Prefix a field with ``~'' for descending
|
||||
order on that field. This flag interacts with other flags that are
|
||||
applied in this order: --flatten, --sort-by, --filter, --limit.
|
||||
|
||||
GCLOUD WIDE FLAGS
|
||||
These flags are available to all commands: --access-token-file, --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.
|
||||
|
||||
NOTES
|
||||
These variants are also available:
|
||||
|
||||
$ gcloud alpha billing projects list
|
||||
|
||||
$ gcloud beta billing projects list
|
||||
|
||||
45
gcloud/billing/projects/unlink
Normal file
45
gcloud/billing/projects/unlink
Normal file
|
|
@ -0,0 +1,45 @@
|
|||
NAME
|
||||
gcloud billing projects unlink - unlink the account (if any) linked with a
|
||||
project
|
||||
|
||||
SYNOPSIS
|
||||
gcloud billing projects unlink PROJECT_ID [GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
This command unlinks a project from its associated billing account. This
|
||||
action disables billing on the project. Any billable resources and services
|
||||
in use in your project are stopped, and your application stops functioning.
|
||||
Any costs accrued prior to disabling billing on the project are charged to
|
||||
the previously associated billing account.
|
||||
|
||||
Note: To link a project to a different billing account, use the billing
|
||||
projects link command. You do not need to unlink the project first.
|
||||
|
||||
EXAMPLES
|
||||
To unlink the project my-project from its linked billing account, run:
|
||||
|
||||
$ gcloud billing projects unlink my-project
|
||||
|
||||
POSITIONAL ARGUMENTS
|
||||
PROJECT_ID
|
||||
Specify a project id.
|
||||
|
||||
GCLOUD WIDE FLAGS
|
||||
These flags are available to all commands: --access-token-file, --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 cloudbilling/v1 API. The full documentation for this
|
||||
API can be found at: https://cloud.google.com/billing/v1/getting-started
|
||||
|
||||
NOTES
|
||||
These variants are also available:
|
||||
|
||||
$ gcloud alpha billing projects unlink
|
||||
|
||||
$ gcloud beta billing projects unlink
|
||||
|
||||
Loading…
Add table
Add a link
Reference in a new issue