gcloud_alpha_compute_project-info_set-usage-bucket (1)
NAME
- gcloud alpha compute project-info set-usage-bucket - set usage reporting bucket for a project
SYNOPSIS
-
gcloud alpha compute project-info set-usage-bucket (--bucket=BUCKET | --no-bucket) [--prefix=PREFIX] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) gcloud alpha compute project-info set-usage-bucket
Setting usage reporting will cause a log of usage per resource to be written to a specified Google Cloud Storage bucket daily.
For example, to write daily logs of the form usage_gce_YYYYMMDD.csv to the bucket my-bucket, run:
-
$ gcloud compute project-info set-usage-bucket \
--bucket=gs://my-bucket
To disable this feature, issue the command:
- $ gcloud compute project-info set-usage-bucket --no-bucket
REQUIRED FLAGS
-
-
Exactly one of these must be specified:
-
- --bucket=BUCKET
-
Name of an existing Google Cloud Storage bucket where the usage report object
should be stored. This can either be the bucket name by itself, such as
my-bucket, or the bucket name with gs:// or
storage.googleapis.com in front of it, such as
gs://my-bucket. The Google Service Account for performing usage reporting
is granted write access to this bucket. The user running this command must be an
owner of the bucket.
To clear the usage bucket, use --no-bucket.
- --no-bucket
-
Unsets the bucket. This disables usage report storage.
-
-
Exactly one of these must be specified:
OPTIONAL FLAGS
-
- --prefix=PREFIX
-
Optional prefix for the name of the usage report object stored in the bucket. If
not supplied, then this defaults to usage. The report is stored as a
CSV file named PREFIX_gce_YYYYMMDD.csv where YYYYMMDD is the day of the usage
according to Pacific Time. The prefix should conform to Google Cloud Storage
object naming conventions. This flag must not be provided when clearing the
usage bucket.
GCLOUD WIDE FLAGS
These flags are available to all commands: --account, --configuration, --flags-file, --flatten, --format, --help, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details.
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 will have to apply for early access and have your projects registered on the API whitelist to use it. To do so, contact Support at cloud.google.com/support These variants are also available:
- $ gcloud compute project-info set-usage-bucket $ gcloud beta compute project-info set-usage-bucket