--account <ACCOUNT> | Google Cloud Platform user account to use for invocation. Overrides the default *core/account* property value for this command invocation |
--billing-project <BILLING_PROJECT> | The Google Cloud Platform project that will be charged quota for operations performed in gcloud. If you need to operate on one project, but need quota against a different project, you can use this flag to specify the billing project. If both `billing/quota_project` and `--billing-project` are specified, `--billing-project` takes precedence. Run `$ gcloud config set --help` to see more information about `billing/quota_project` |
--clear-container-args | Removes the list of arguments from container declaration.
+
Cannot be used in the same command with `--container-arg` |
--clear-container-command | Removes command from container declaration.
+
Cannot be used in the same command with `--container-command` |
--configuration <CONFIGURATION> | The configuration to use for this command invocation. For more
information on how to use configurations, run:
`gcloud topic configurations`. You can also use the CLOUDSDK_ACTIVE_CONFIG_NAME environment
variable to set the equivalent of this flag for a terminal
session |
--container-arg <CONTAINER_ARG> | Completely replaces the list of arguments with the new list.
Each argument must have a separate --container-arg flag.
Arguments are appended the new list in the order of flags.
+
Cannot be used in the same command with `--clear-container-arg` |
--container-command <CONTAINER_COMMAND> | Sets command in the declaration to the specified value.
Empty string is not allowed.
+
Cannot be used in the same command with `--clear-container-command` |
--container-env <KEY=VALUE, ...> | Update environment variables `KEY` with value `VALUE` passed to
container.
- Sets `KEY` to the specified value.
- Adds `KEY` = `VALUE`, if `KEY` is not yet declared.
- Only the last value of `KEY` is taken when `KEY` is repeated more
than once.
+
Values, declared with `--container-env` flag override those with the
same `KEY` from file, provided in `--container-env-file` |
--container-env-file <CONTAINER_ENV_FILE> | Update environment variables from a file.
Same update rules as for `--container-env` apply.
Values, declared with `--container-env` flag override those with the
same `KEY` from file.
+
File with environment variables declarations in format used by docker
(almost). This means:
- Lines are in format KEY=VALUE
- Values must contain equality signs.
- Variables without values are not supported (this is different from
docker format).
- If # is first non-whitespace character in a line the line is ignored
as a comment |
--container-image <CONTAINER_IMAGE> | Sets container image in the declaration to the specified value.
+
Empty string is not allowed |
--container-mount-disk <CONTAINER_MOUNT_DISK> | Mounts a disk to the container by using mount-path or updates how the volume is
mounted if the same mount path has already been declared. The disk must already
be attached to the instance with a device-name that matches the disk name.
Multiple flags are allowed.
+
*name*::: Name of the disk. Can be omitted if exactly one additional disk is attached to
the instance. The name of the single additional disk will be used by default.
+
*mount-path*::: Path on container to mount to. Mount paths with spaces
and commas (and other special characters) are not supported by this
command.
+
*partition*::: Optional. The partition of the disk to mount. Multiple
partitions of a disk may be mounted.
+
*mode*::: Volume mount mode: `rw` (read/write) or `ro` (read-only).
Defaults to `rw`. Fails if the disk mode is `ro` and volume mount mode
is `rw` |
--container-mount-host-path <host-path=HOSTPATH,mount-path=MOUNTPATH[,mode=MODE]> | Mounts a volume by using host-path.
- Adds a volume, if `mount-path` is not yet declared.
- Replaces a volume, if `mount-path` is declared.
All parameters (`host-path`, `mount-path`, `mode`) are completely
replaced.
+
*host-path*::: Path on host to mount from.
+
*mount-path*::: Path on container to mount to. Mount paths with spaces
and commas (and other special characters) are not supported by this
command.
+
*mode*::: Volume mount mode: rw (read/write) or ro (read-only).
+
Default: rw |
--container-mount-tmpfs <mount-path=MOUNTPATH> | Mounts empty tmpfs into container at MOUNTPATH.
+
*mount-path*::: Path on container to mount to. Mount paths with spaces
and commas (and other special characters) are not supported by this
command |
--container-privileged | Sets permission to run container to the specified value |
--container-restart-policy <POLICY> | Sets container restart policy to the specified value. _POLICY_ must be one of: *never*, *on-failure*, *always* |
--container-stdin | Sets configuration whether to keep container `STDIN` always open to the
specified value |
--container-tty | Sets configuration whether to allocate a pseudo-TTY for the container
to the specified value |
--flags-file <YAML_FILE> | A YAML or JSON file that specifies a *--flag*:*value* dictionary.
Useful for specifying complex flag values with special characters
that work with any command interpreter. Additionally, each
*--flags-file* arg is replaced by its constituent flags. See
$ gcloud topic flags-file for more information |
--flatten <KEY> | Flatten _name_[] output resource slices in _KEY_ into separate records
for each item in each slice. Multiple keys and slices may be specified.
This also flattens keys for *--format* and *--filter*. For example,
*--flatten=abc.def* flattens *abc.def[].ghi* references to
*abc.def.ghi*. A resource record containing *abc.def[]* with N elements
will expand to N records in the flattened output. This flag interacts
with other flags that are applied in this order: *--flatten*,
*--sort-by*, *--filter*, *--limit* |
--format <FORMAT> | Set the format for printing command output resources. The default is a
command-specific human-friendly output format. The supported formats
are: `config`, `csv`, `default`, `diff`, `disable`, `flattened`, `get`, `json`, `list`, `multi`, `none`, `object`, `table`, `text`, `value`, `yaml`. For more details run $ gcloud topic formats |
--help | Display detailed help |
--impersonate-service-account <SERVICE_ACCOUNT_EMAIL> | For this gcloud invocation, all API requests will be made as the given service account instead of the currently selected account. This is done without needing to create, download, and activate a key for the account. In order to perform operations as the service account, your currently selected account must have an IAM role that includes the iam.serviceAccounts.getAccessToken permission for the service account. The roles/iam.serviceAccountTokenCreator role has this permission or you may create a custom role. Overrides the default *auth/impersonate_service_account* property value for this command invocation |
--log-http | Log all HTTP server requests and responses to stderr. Overrides the default *core/log_http* property value for this command invocation |
--project <PROJECT_ID> | The Google Cloud Platform project ID to use for this invocation. If
omitted, then the current project is assumed; the current project can
be listed using `gcloud config list --format='text(core.project)'`
and can be set using `gcloud config set project PROJECTID`.
+
`--project` and its fallback `core/project` property play two roles
in the invocation. It specifies the project of the resource to
operate on. It also specifies the project for API enablement check,
quota, and billing. To specify a different project for quota and
billing, use `--billing-project` or `billing/quota_project` property |
--quiet | Disable all interactive prompts when running gcloud commands. If input
is required, defaults will be used, or an error will be raised.
Overrides the default core/disable_prompts property value for this
command invocation. This is equivalent to setting the environment
variable `CLOUDSDK_CORE_DISABLE_PROMPTS` to 1 |
--remove-container-env <KEY> | Removes environment variables `KEY` from container declaration Does
nothing, if a variable is not present |
--remove-container-mounts <MOUNTPATH[,MOUNTPATH,...]> | Removes volume mounts (`host-path`, `tmpfs`, `disk`) with
`mountPath: MOUNTPATH` from container declaration.
+
Does nothing, if a volume mount is not declared |
--trace-token <TRACE_TOKEN> | Token used to route traces of service requests for investigation of issues. Overrides the default *core/trace_token* property value for this command invocation |
--user-output-enabled | Print user intended output to the console. Overrides the default *core/user_output_enabled* property value for this command invocation. Use *--no-user-output-enabled* to disable |
--verbosity <VERBOSITY> | Override the default verbosity for this command. Overrides the default *core/verbosity* property value for this command invocation. _VERBOSITY_ must be one of: *debug*, *info*, *warning*, *error*, *critical*, *none* |
--zone <ZONE> | Zone of the instance to update. If not specified, the user may be prompted to select a zone. `gcloud` will
attempt to identify the zone by searching for resources in the user's project.
If the zone cannot be determined, the user will then be prompted with all Google
Cloud Platform zones.
+
To avoid prompting when this flag is omitted, the user can set the
``compute/zone'' property:
+
$ gcloud config set compute/zone ZONE
+
A list of zones can be fetched by running:
+
$ gcloud compute zones list
+
To unset the property, run:
+
$ gcloud config unset compute/zone
+
Alternatively, the zone can be stored in the environment variable
``CLOUDSDK_COMPUTE_ZONE'' |