imjasonh/gcloud-help
1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-18 06:47:12 +00:00
Code Activity

gcloud: Wed Apr 8 12:08:12 UTC 2026

Browse source
This commit is contained in:
Automated 2026-04-08 12:08:12 +00:00
parent 89a3bc9276
commit 5b03e16435
766 changed files with 29847 additions and 8950 deletions
Download patch file Download diff file Expand all files Collapse all files

44
gcloud/beta/run/deploy
View file

@ -7,7 +7,7 @@ SYNOPSIS
[--clear-vpc-connector] [--concurrency=CONCURRENCY]
[--container=CONTAINER] [--[no-]cpu-boost] [--[no-]cpu-throttling]
[--[no-]default-url] [--[no-]deploy-health-check]
[--description=DESCRIPTION]
[--description=DESCRIPTION] [--endpoint-mode=ENDPOINT_MODE]
[--execution-environment=EXECUTION_ENVIRONMENT] [--gpu-type=GPU_TYPE]
[--[no-]gpu-zonal-redundancy] [--[no-]iap]
[--ingress=INGRESS; default="all"] [--[no-]invoker-iam-check]
@ -35,7 +35,7 @@ SYNOPSIS
--readiness-probe=[KEY=VALUE,...]
--remove-volume-mount=[MOUNT_PATH,...]
--startup-probe=[KEY=VALUE,...]
--[no-]use-http2 --base-image=BASE_IMAGE
--[no-]use-http2 --workdir=WORKDIR --base-image=BASE_IMAGE
| --clear-base-image --build-env-vars-file=FILE_PATH
| --clear-build-env-vars | --set-build-env-vars=[KEY=VALUE,...]
| --remove-build-env-vars=[KEY,...]
@ -166,6 +166,24 @@ FLAGS
--description=DESCRIPTION
Provides an optional, human-readable description of the service.
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--execution-environment=EXECUTION_ENVIRONMENT
Selects the execution environment where the application will run.
EXECUTION_ENVIRONMENT must be one of:
@ -383,6 +401,17 @@ FLAGS
multi-container services, specify the mount-path parameter under the
--add-volume-mount flag.
ephemeral-disk: A volume that stores data on a temporary disk. With
this type of volume, data is not shared between instances and all data
will be lost when the instance it is on is terminated. Additional keys:
◆ mount-path: (optional) The path at which the volume should be
mounted. The mount-path parameter is only supported for single
container services which do not make use of the --container flag. For
multi-container services, specify the mount-path parameter under the
--add-volume-mount flag.
◆ size: (optional) A quantity representing the amount of disk space
allocated to this volume, such as "10Gi" or "100G".
in-memory: An ephemeral volume that stores data in the instance's
memory. With this type of volume, data is not shared between instances
and all data will be lost when the instance it is on is terminated.
@ -524,6 +553,11 @@ FLAGS
Whether to use HTTP/2 for connections to the service. Use --use-http2
to enable and --no-use-http2 to disable.
--workdir=WORKDIR
Working directory of the container process. If not specified, the
container image's default working directory is used. To reset this
field to its default, pass an empty string.
At most one of these can be specified:
--base-image=BASE_IMAGE
@ -806,6 +840,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

27
gcloud/beta/run/jobs/add-iam-policy-binding
View file

@ -4,7 +4,8 @@ NAME
SYNOPSIS
gcloud beta run jobs add-iam-policy-binding JOB --member=PRINCIPAL
--role=ROLE [--region=REGION] [GCLOUD_WIDE_FLAG ...]
--role=ROLE [--endpoint-mode=ENDPOINT_MODE] [--region=REGION]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) Add an IAM policy binding to the IAM policy of a Cloud Run job. One
@ -69,6 +70,24 @@ REQUIRED FLAGS
organizations/{ORGANIZATION_ID}/roles/logging.viewer.
OPTIONAL FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -85,6 +104,12 @@ API REFERENCE
This command uses the run/v1 API. The full documentation for this API can
be found at: https://cloud.google.com/run/
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

50
gcloud/beta/run/jobs/create
View file

@ -4,10 +4,10 @@ NAME
SYNOPSIS
gcloud beta run jobs create [JOB] [--binary-authorization=POLICY]
[--breakglass=JUSTIFICATION] [--container=CONTAINER]
[--gpu-type=GPU_TYPE] [--[no-]gpu-zonal-redundancy] [--key=KEY]
[--labels=[KEY=VALUE,...]] [--max-retries=MAX_RETRIES]
[--parallelism=PARALLELISM] [--region=REGION]
[--service-account=SERVICE_ACCOUNT]
[--endpoint-mode=ENDPOINT_MODE] [--gpu-type=GPU_TYPE]
[--[no-]gpu-zonal-redundancy] [--key=KEY] [--labels=[KEY=VALUE,...]]
[--max-retries=MAX_RETRIES] [--parallelism=PARALLELISM]
[--region=REGION] [--service-account=SERVICE_ACCOUNT]
[--set-cloudsql-instances=[CLOUDSQL-INSTANCES,...]]
[--task-timeout=TASK_TIMEOUT] [--tasks=TASKS; default=1]
[--vpc-connector=VPC_CONNECTOR] [--vpc-egress=VPC_EGRESS]
@ -17,7 +17,7 @@ SYNOPSIS
--args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...]
--cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --image=IMAGE
--memory=MEMORY --remove-volume-mount=[MOUNT_PATH,...]
--startup-probe=[KEY=VALUE,...] --clear-env-vars
--startup-probe=[KEY=VALUE,...] --workdir=WORKDIR --clear-env-vars
| --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...]
| --remove-env-vars=[KEY,...]
--update-env-vars=[KEY=VALUE,...] --clear-secrets
@ -80,6 +80,24 @@ FLAGS
Flags that are not container-specific must be specified before
--container.
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--gpu-type=GPU_TYPE
The GPU type to use.
@ -179,6 +197,17 @@ FLAGS
multi-container services, specify the mount-path parameter under the
--add-volume-mount flag.
ephemeral-disk: A volume that stores data on a temporary disk. With
this type of volume, data is not shared between instances and all data
will be lost when the instance it is on is terminated. Additional keys:
◆ mount-path: (optional) The path at which the volume should be
mounted. The mount-path parameter is only supported for single
container services which do not make use of the --container flag. For
multi-container services, specify the mount-path parameter under the
--add-volume-mount flag.
◆ size: (optional) A quantity representing the amount of disk space
allocated to this volume, such as "10Gi" or "100G".
in-memory: An ephemeral volume that stores data in the instance's
memory. With this type of volume, data is not shared between instances
and all data will be lost when the instance it is on is terminated.
@ -277,6 +306,11 @@ FLAGS
$ --startup-probe=""
--workdir=WORKDIR
Working directory of the container process. If not specified, the
container image's default working directory is used. To reset this
field to its default, pass an empty string.
At most one of these can be specified:
--clear-env-vars
@ -387,6 +421,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

27
gcloud/beta/run/jobs/delete
View file

@ -2,7 +2,8 @@ NAME
gcloud beta run jobs delete - delete a job
SYNOPSIS
gcloud beta run jobs delete JOB [--[no-]async] [--region=REGION]
gcloud beta run jobs delete JOB [--[no-]async]
[--endpoint-mode=ENDPOINT_MODE] [--region=REGION]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
@ -38,6 +39,24 @@ FLAGS
complete. Defaults to --no-async. Use --async to enable and --no-async
to disable.
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -50,6 +69,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

50
gcloud/beta/run/jobs/deploy
View file

@ -4,10 +4,10 @@ NAME
SYNOPSIS
gcloud beta run jobs deploy [JOB] [--binary-authorization=POLICY]
[--breakglass=JUSTIFICATION] [--container=CONTAINER]
[--gpu-type=GPU_TYPE] [--[no-]gpu-zonal-redundancy] [--key=KEY]
[--labels=[KEY=VALUE,...]] [--max-retries=MAX_RETRIES]
[--parallelism=PARALLELISM] [--region=REGION]
[--remove-containers=[CONTAINER,...]]
[--endpoint-mode=ENDPOINT_MODE] [--gpu-type=GPU_TYPE]
[--[no-]gpu-zonal-redundancy] [--key=KEY] [--labels=[KEY=VALUE,...]]
[--max-retries=MAX_RETRIES] [--parallelism=PARALLELISM]
[--region=REGION] [--remove-containers=[CONTAINER,...]]
[--service-account=SERVICE_ACCOUNT]
[--set-cloudsql-instances=[CLOUDSQL-INSTANCES,...]]
[--task-timeout=TASK_TIMEOUT] [--tasks=TASKS; default=1]
@ -18,7 +18,7 @@ SYNOPSIS
--args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...]
--cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --memory=MEMORY
--remove-volume-mount=[MOUNT_PATH,...]
--startup-probe=[KEY=VALUE,...] --clear-env-vars
--startup-probe=[KEY=VALUE,...] --workdir=WORKDIR --clear-env-vars
| --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...]
| --remove-env-vars=[KEY,...]
--update-env-vars=[KEY=VALUE,...] --clear-secrets
@ -82,6 +82,24 @@ FLAGS
Flags that are not container-specific must be specified before
--container.
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--gpu-type=GPU_TYPE
The GPU type to use.
@ -184,6 +202,17 @@ FLAGS
multi-container services, specify the mount-path parameter under the
--add-volume-mount flag.
ephemeral-disk: A volume that stores data on a temporary disk. With
this type of volume, data is not shared between instances and all data
will be lost when the instance it is on is terminated. Additional keys:
◆ mount-path: (optional) The path at which the volume should be
mounted. The mount-path parameter is only supported for single
container services which do not make use of the --container flag. For
multi-container services, specify the mount-path parameter under the
--add-volume-mount flag.
◆ size: (optional) A quantity representing the amount of disk space
allocated to this volume, such as "10Gi" or "100G".
in-memory: An ephemeral volume that stores data in the instance's
memory. With this type of volume, data is not shared between instances
and all data will be lost when the instance it is on is terminated.
@ -279,6 +308,11 @@ FLAGS
$ --startup-probe=""
--workdir=WORKDIR
Working directory of the container process. If not specified, the
container image's default working directory is used. To reset this
field to its default, pass an empty string.
At most one of these can be specified:
--clear-env-vars
@ -423,6 +457,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

27
gcloud/beta/run/jobs/describe
View file

@ -2,7 +2,8 @@ NAME
gcloud beta run jobs describe - obtain details about jobs
SYNOPSIS
gcloud beta run jobs describe JOB [--region=REGION] [GCLOUD_WIDE_FLAG ...]
gcloud beta run jobs describe JOB [--endpoint-mode=ENDPOINT_MODE]
[--region=REGION] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) Obtain details about jobs.
@ -32,6 +33,24 @@ POSITIONAL ARGUMENTS
▸ provide the argument JOB on the command line.
FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -44,6 +63,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

27
gcloud/beta/run/jobs/execute
View file

@ -3,7 +3,8 @@ NAME
SYNOPSIS
gcloud beta run jobs execute [JOB] [--container=CONTAINER]
[--region=REGION] [--task-timeout=TASK_TIMEOUT] [--tasks=TASKS]
[--endpoint-mode=ENDPOINT_MODE] [--region=REGION]
[--task-timeout=TASK_TIMEOUT] [--tasks=TASKS]
[--args=[ARG,...] --update-env-vars=[KEY=VALUE,...]] [--async | --wait]
[GCLOUD_WIDE_FLAG ...]
@ -43,6 +44,24 @@ FLAGS
Flags that are not container-specific must be specified before
--container.
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -96,6 +115,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

27
gcloud/beta/run/jobs/executions/cancel
View file

@ -3,7 +3,8 @@ NAME
SYNOPSIS
gcloud beta run jobs executions cancel EXECUTION [--[no-]async]
[--region=REGION] [GCLOUD_WIDE_FLAG ...]
[--endpoint-mode=ENDPOINT_MODE] [--region=REGION]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) Cancel an execution.
@ -38,6 +39,24 @@ FLAGS
complete. Defaults to --no-async. Use --async to enable and --no-async
to disable.
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -50,6 +69,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

27
gcloud/beta/run/jobs/executions/delete
View file

@ -3,7 +3,8 @@ NAME
SYNOPSIS
gcloud beta run jobs executions delete EXECUTION [--[no-]async]
[--region=REGION] [GCLOUD_WIDE_FLAG ...]
[--endpoint-mode=ENDPOINT_MODE] [--region=REGION]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) Delete an execution.
@ -38,6 +39,24 @@ FLAGS
complete. Defaults to --no-async. Use --async to enable and --no-async
to disable.
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -50,6 +69,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

27
gcloud/beta/run/jobs/executions/describe
View file

@ -2,7 +2,8 @@ NAME
gcloud beta run jobs executions describe - obtain details about executions
SYNOPSIS
gcloud beta run jobs executions describe EXECUTION [--region=REGION]
gcloud beta run jobs executions describe EXECUTION
[--endpoint-mode=ENDPOINT_MODE] [--region=REGION]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
@ -33,6 +34,24 @@ POSITIONAL ARGUMENTS
▸ provide the argument EXECUTION on the command line.
FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -45,6 +64,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

31
gcloud/beta/run/jobs/executions/list
View file

@ -2,9 +2,10 @@ NAME
gcloud beta run jobs executions list - list executions
SYNOPSIS
gcloud beta run jobs executions list [--job=JOB] [--region=REGION]
[--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE]
[--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...]
gcloud beta run jobs executions list [--endpoint-mode=ENDPOINT_MODE]
[--job=JOB] [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT]
[--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) List executions.
@ -15,6 +16,24 @@ EXAMPLES
$ gcloud beta run jobs executions list
FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--job=JOB
Limit matched resources to the given job.
@ -62,6 +81,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

30
gcloud/beta/run/jobs/get-iam-policy
View file

@ -3,9 +3,9 @@ NAME
job
SYNOPSIS
gcloud beta run jobs get-iam-policy JOB [--region=REGION]
[--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE]
[--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...]
gcloud beta run jobs get-iam-policy JOB [--endpoint-mode=ENDPOINT_MODE]
[--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT]
[--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) This command gets the IAM policy for a job. If formatted as JSON,
@ -46,6 +46,24 @@ POSITIONAL ARGUMENTS
▸ provide the argument job on the command line.
FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -88,6 +106,12 @@ API REFERENCE
This command uses the run/v1 API. The full documentation for this API can
be found at: https://cloud.google.com/run/
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

30
gcloud/beta/run/jobs/list
View file

@ -2,9 +2,9 @@ NAME
gcloud beta run jobs list - list jobs
SYNOPSIS
gcloud beta run jobs list [--region=REGION] [--filter=EXPRESSION]
[--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
[GCLOUD_WIDE_FLAG ...]
gcloud beta run jobs list [--endpoint-mode=ENDPOINT_MODE] [--region=REGION]
[--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE]
[--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) List jobs.
@ -15,6 +15,24 @@ EXAMPLES
$ gcloud beta run jobs list
FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -59,6 +77,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

27
gcloud/beta/run/jobs/remove-iam-policy-binding
View file

@ -4,7 +4,8 @@ NAME
SYNOPSIS
gcloud beta run jobs remove-iam-policy-binding JOB --member=PRINCIPAL
--role=ROLE [--region=REGION] [GCLOUD_WIDE_FLAG ...]
--role=ROLE [--endpoint-mode=ENDPOINT_MODE] [--region=REGION]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) Remove an IAM policy binding from the IAM policy of a job. One
@ -71,6 +72,24 @@ REQUIRED FLAGS
The role to remove the principal from.
OPTIONAL FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -87,6 +106,12 @@ API REFERENCE
This command uses the run/v1 API. The full documentation for this API can
be found at: https://cloud.google.com/run/
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

28
gcloud/beta/run/jobs/replace
View file

@ -3,8 +3,8 @@ NAME
specification
SYNOPSIS
gcloud beta run jobs replace FILE [--async] [--region=REGION]
[GCLOUD_WIDE_FLAG ...]
gcloud beta run jobs replace FILE [--async] [--endpoint-mode=ENDPOINT_MODE]
[--region=REGION] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) Creates or replaces a job from a YAML job specification.
@ -24,6 +24,24 @@ FLAGS
Return immediately, without waiting for the operation in progress to
complete.
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -36,6 +54,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

27
gcloud/beta/run/jobs/set-iam-policy
View file

@ -2,7 +2,8 @@ NAME
gcloud beta run jobs set-iam-policy - set the IAM policy for a job
SYNOPSIS
gcloud beta run jobs set-iam-policy JOB POLICY_FILE [--region=REGION]
gcloud beta run jobs set-iam-policy JOB POLICY_FILE
[--endpoint-mode=ENDPOINT_MODE] [--region=REGION]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
@ -58,6 +59,24 @@ POSITIONAL ARGUMENTS
(https://cloud.google.com/iam/reference/rest/v1/Policy).
FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -74,6 +93,12 @@ API REFERENCE
This command uses the run/v1 API. The full documentation for this API can
be found at: https://cloud.google.com/run/
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

45
gcloud/beta/run/jobs/update
View file

@ -3,7 +3,8 @@ NAME
SYNOPSIS
gcloud beta run jobs update [JOB] [--breakglass=JUSTIFICATION]
[--clear-vpc-connector] [--container=CONTAINER] [--gpu-type=GPU_TYPE]
[--clear-vpc-connector] [--container=CONTAINER]
[--endpoint-mode=ENDPOINT_MODE] [--gpu-type=GPU_TYPE]
[--[no-]gpu-zonal-redundancy] [--key=KEY] [--max-retries=MAX_RETRIES]
[--parallelism=PARALLELISM] [--region=REGION]
[--remove-containers=[CONTAINER,...]]
@ -20,7 +21,7 @@ SYNOPSIS
--args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...]
--cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --image=IMAGE
--memory=MEMORY --remove-volume-mount=[MOUNT_PATH,...]
--startup-probe=[KEY=VALUE,...] --clear-env-vars
--startup-probe=[KEY=VALUE,...] --workdir=WORKDIR --clear-env-vars
| --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...]
| --remove-env-vars=[KEY,...]
--update-env-vars=[KEY=VALUE,...] --clear-secrets
@ -81,6 +82,24 @@ FLAGS
Flags that are not container-specific must be specified before
--container.
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--gpu-type=GPU_TYPE
The GPU type to use.
@ -195,6 +214,17 @@ FLAGS
multi-container services, specify the mount-path parameter under the
--add-volume-mount flag.
ephemeral-disk: A volume that stores data on a temporary disk. With
this type of volume, data is not shared between instances and all data
will be lost when the instance it is on is terminated. Additional keys:
◆ mount-path: (optional) The path at which the volume should be
mounted. The mount-path parameter is only supported for single
container services which do not make use of the --container flag. For
multi-container services, specify the mount-path parameter under the
--add-volume-mount flag.
◆ size: (optional) A quantity representing the amount of disk space
allocated to this volume, such as "10Gi" or "100G".
in-memory: An ephemeral volume that stores data in the instance's
memory. With this type of volume, data is not shared between instances
and all data will be lost when the instance it is on is terminated.
@ -294,6 +324,11 @@ FLAGS
$ --startup-probe=""
--workdir=WORKDIR
Working directory of the container process. If not specified, the
container image's default working directory is used. To reset this
field to its default, pass an empty string.
At most one of these can be specified:
--clear-env-vars
@ -457,6 +492,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

8
gcloud/beta/run/multi-region-services/update
View file

@ -36,7 +36,8 @@ SYNOPSIS
--liveness-probe=[KEY=VALUE,...] --memory=MEMORY --port=PORT
--readiness-probe=[KEY=VALUE,...]
--remove-volume-mount=[MOUNT_PATH,...]
--startup-probe=[KEY=VALUE,...] --[no-]use-http2 --clear-env-vars
--startup-probe=[KEY=VALUE,...]
--[no-]use-http2 --workdir=WORKDIR --clear-env-vars
| --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...]
| --remove-env-vars=[KEY,...]
--update-env-vars=[KEY=VALUE,...] --clear-secrets
@ -456,6 +457,11 @@ FLAGS
Whether to use HTTP/2 for connections to the service. Use --use-http2
to enable and --no-use-http2 to disable.
--workdir=WORKDIR
Working directory of the container process. If not specified, the
container image's default working directory is used. To reset this
field to its default, pass an empty string.
At most one of these can be specified:
--clear-env-vars

27
gcloud/beta/run/revisions/delete
View file

@ -3,7 +3,8 @@ NAME
SYNOPSIS
gcloud beta run revisions delete (REVISION : --namespace=NAMESPACE)
[--[no-]async] [--region=REGION] [GCLOUD_WIDE_FLAG ...]
[--[no-]async] [--endpoint-mode=ENDPOINT_MODE] [--region=REGION]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) Delete a revision.
@ -48,6 +49,24 @@ FLAGS
complete. Defaults to --no-async. Use --async to enable and --no-async
to disable.
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -60,6 +79,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

27
gcloud/beta/run/revisions/describe
View file

@ -3,7 +3,8 @@ NAME
SYNOPSIS
gcloud beta run revisions describe (REVISION : --namespace=NAMESPACE)
[--region=REGION] [GCLOUD_WIDE_FLAG ...]
[--endpoint-mode=ENDPOINT_MODE] [--region=REGION]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) Obtain details about revisions.
@ -44,6 +45,24 @@ POSITIONAL ARGUMENTS
▸ set the property core/project.
FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -56,6 +75,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

31
gcloud/beta/run/revisions/list
View file

@ -2,9 +2,10 @@ NAME
gcloud beta run revisions list - list available revisions
SYNOPSIS
gcloud beta run revisions list [--region=REGION] [--service=SERVICE]
[--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE]
[--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...]
gcloud beta run revisions list [--endpoint-mode=ENDPOINT_MODE]
[--region=REGION] [--service=SERVICE] [--filter=EXPRESSION]
[--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) List available revisions.
@ -15,6 +16,24 @@ EXAMPLES
$ gcloud beta run revisions list --service=foo
FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -62,6 +81,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

26
gcloud/beta/run/services/add-iam-policy-binding
View file

@ -4,7 +4,7 @@ NAME
SYNOPSIS
gcloud beta run services add-iam-policy-binding SERVICE --member=PRINCIPAL
--role=ROLE [--region=REGION]
--role=ROLE [--endpoint-mode=ENDPOINT_MODE] [--region=REGION]
[--condition=[KEY=VALUE,...] | --condition-from-file=PATH_TO_FILE]
[GCLOUD_WIDE_FLAG ...]
@ -72,6 +72,24 @@ REQUIRED FLAGS
organizations/{ORGANIZATION_ID}/roles/logging.viewer.
OPTIONAL FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -126,6 +144,12 @@ API REFERENCE
This command uses the run/v1 API. The full documentation for this API can
be found at: https://cloud.google.com/run/
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

27
gcloud/beta/run/services/delete
View file

@ -3,7 +3,8 @@ NAME
SYNOPSIS
gcloud beta run services delete (SERVICE : --namespace=NAMESPACE)
[--[no-]async] [--region=REGION] [GCLOUD_WIDE_FLAG ...]
[--[no-]async] [--endpoint-mode=ENDPOINT_MODE] [--region=REGION]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) Delete a service.
@ -48,6 +49,24 @@ FLAGS
complete. Defaults to --no-async. Use --async to enable and --no-async
to disable.
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -60,6 +79,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

27
gcloud/beta/run/services/describe
View file

@ -3,7 +3,8 @@ NAME
SYNOPSIS
gcloud beta run services describe (SERVICE : --namespace=NAMESPACE)
[--region=REGION] [GCLOUD_WIDE_FLAG ...]
[--endpoint-mode=ENDPOINT_MODE] [--region=REGION]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) Obtain details about a given service.
@ -52,6 +53,24 @@ POSITIONAL ARGUMENTS
▸ set the property core/project.
FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -64,6 +83,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

31
gcloud/beta/run/services/get-iam-policy
View file

@ -3,9 +3,10 @@ NAME
Run service
SYNOPSIS
gcloud beta run services get-iam-policy SERVICE [--region=REGION]
[--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE]
[--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...]
gcloud beta run services get-iam-policy SERVICE
[--endpoint-mode=ENDPOINT_MODE] [--region=REGION] [--filter=EXPRESSION]
[--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) This command gets the IAM policy for a service. If formatted as
@ -47,6 +48,24 @@ POSITIONAL ARGUMENTS
▸ provide the argument service on the command line.
FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -89,6 +108,12 @@ API REFERENCE
This command uses the run/v1 API. The full documentation for this API can
be found at: https://cloud.google.com/run/
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

29
gcloud/beta/run/services/list
View file

@ -2,8 +2,9 @@ NAME
gcloud beta run services list - list available services
SYNOPSIS
gcloud beta run services list [--region=REGION] [--filter=EXPRESSION]
[--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
gcloud beta run services list [--endpoint-mode=ENDPOINT_MODE]
[--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT]
[--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
@ -15,6 +16,24 @@ EXAMPLES
$ gcloud beta run services list
FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -59,6 +78,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

39
gcloud/beta/run/services/proxy
View file

@ -4,19 +4,12 @@ NAME
SYNOPSIS
gcloud beta run services proxy (SERVICE : --namespace=NAMESPACE)
[--port=PORT] [--region=REGION] [--tag=TAG] [--token=TOKEN]
[GCLOUD_WIDE_FLAG ...]
[--endpoint-mode=ENDPOINT_MODE] [--port=PORT] [--region=REGION]
[--tag=TAG] [--token=TOKEN] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) Runs a server on localhost that proxies requests to the specified
Cloud Run Service with credentials attached.
You can use this to test services protected with IAM authentication.
The Cloud Run service must be reachable from the machine running this
command. For example, if the Cloud Run Service is configured to only allow
internal ingress, this command will not work from outside the service's VPC
network.
(BETA) Proxy a service to localhost authenticating as the active account or
with the specified token.
EXAMPLES
To proxy the service 'my-service' at localhost port 8080:
@ -57,6 +50,24 @@ POSITIONAL ARGUMENTS
▸ set the property core/project.
FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--port=PORT
Local port number to expose the proxied service. If not specified, it
will be set to 8080.
@ -86,6 +97,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

27
gcloud/beta/run/services/remove-iam-policy-binding
View file

@ -4,7 +4,8 @@ NAME
SYNOPSIS
gcloud beta run services remove-iam-policy-binding SERVICE
--member=PRINCIPAL --role=ROLE [--region=REGION]
--member=PRINCIPAL --role=ROLE [--endpoint-mode=ENDPOINT_MODE]
[--region=REGION]
[--all | --condition=[KEY=VALUE,...]
| --condition-from-file=PATH_TO_FILE] [GCLOUD_WIDE_FLAG ...]
@ -73,6 +74,24 @@ REQUIRED FLAGS
The role to remove the principal from.
OPTIONAL FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -131,6 +150,12 @@ API REFERENCE
This command uses the run/v1 API. The full documentation for this API can
be found at: https://cloud.google.com/run/
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

27
gcloud/beta/run/services/replace
View file

@ -4,7 +4,8 @@ NAME
SYNOPSIS
gcloud beta run services replace FILE [--async] [--dry-run]
[--region=REGION] [GCLOUD_WIDE_FLAG ...]
[--endpoint-mode=ENDPOINT_MODE] [--region=REGION]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) Creates or replaces a service from a YAML service specification.
@ -28,6 +29,24 @@ FLAGS
If set to true, only validates the configuration. The configuration
will not be applied.
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -40,6 +59,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

27
gcloud/beta/run/services/set-iam-policy
View file

@ -3,7 +3,8 @@ NAME
SYNOPSIS
gcloud beta run services set-iam-policy SERVICE POLICY_FILE
[--region=REGION] [GCLOUD_WIDE_FLAG ...]
[--endpoint-mode=ENDPOINT_MODE] [--region=REGION]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) This command replaces the existing IAM policy for a service, given a
@ -58,6 +59,24 @@ POSITIONAL ARGUMENTS
(https://cloud.google.com/iam/reference/rest/v1/Policy).
FLAGS
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -74,6 +93,12 @@ API REFERENCE
This command uses the run/v1 API. The full documentation for this API can
be found at: https://cloud.google.com/run/
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

45
gcloud/beta/run/services/update
View file

@ -7,7 +7,7 @@ SYNOPSIS
[--breakglass=JUSTIFICATION] [--clear-vpc-connector]
[--concurrency=CONCURRENCY] [--container=CONTAINER] [--[no-]cpu-boost]
[--[no-]cpu-throttling] [--[no-]default-url]
[--[no-]deploy-health-check]
[--[no-]deploy-health-check] [--endpoint-mode=ENDPOINT_MODE]
[--execution-environment=EXECUTION_ENVIRONMENT] [--gpu-type=GPU_TYPE]
[--[no-]gpu-zonal-redundancy] [--[no-]iap]
[--ingress=INGRESS; default="all"] [--[no-]invoker-iam-check]
@ -34,7 +34,8 @@ SYNOPSIS
--liveness-probe=[KEY=VALUE,...] --memory=MEMORY --port=PORT
--readiness-probe=[KEY=VALUE,...]
--remove-volume-mount=[MOUNT_PATH,...]
--startup-probe=[KEY=VALUE,...] --[no-]use-http2 --clear-env-vars
--startup-probe=[KEY=VALUE,...]
--[no-]use-http2 --workdir=WORKDIR --clear-env-vars
| --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...]
| --remove-env-vars=[KEY,...]
--update-env-vars=[KEY=VALUE,...] --clear-secrets
@ -140,6 +141,24 @@ FLAGS
default when unspecified. Use --deploy-health-check to enable and
--no-deploy-health-check to disable.
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--execution-environment=EXECUTION_ENVIRONMENT
Selects the execution environment where the application will run.
EXECUTION_ENVIRONMENT must be one of:
@ -353,6 +372,17 @@ FLAGS
multi-container services, specify the mount-path parameter under the
--add-volume-mount flag.
ephemeral-disk: A volume that stores data on a temporary disk. With
this type of volume, data is not shared between instances and all data
will be lost when the instance it is on is terminated. Additional keys:
◆ mount-path: (optional) The path at which the volume should be
mounted. The mount-path parameter is only supported for single
container services which do not make use of the --container flag. For
multi-container services, specify the mount-path parameter under the
--add-volume-mount flag.
◆ size: (optional) A quantity representing the amount of disk space
allocated to this volume, such as "10Gi" or "100G".
in-memory: An ephemeral volume that stores data in the instance's
memory. With this type of volume, data is not shared between instances
and all data will be lost when the instance it is on is terminated.
@ -497,6 +527,11 @@ FLAGS
Whether to use HTTP/2 for connections to the service. Use --use-http2
to enable and --no-use-http2 to disable.
--workdir=WORKDIR
Working directory of the container process. If not specified, the
container image's default working directory is used. To reset this
field to its default, pass an empty string.
At most one of these can be specified:
--clear-env-vars
@ -672,6 +707,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

26
gcloud/beta/run/services/update-traffic
View file

@ -4,7 +4,7 @@ NAME
SYNOPSIS
gcloud beta run services update-traffic [[SERVICE] --namespace=NAMESPACE]
[--async] [--region=REGION]
[--async] [--endpoint-mode=ENDPOINT_MODE] [--region=REGION]
[--clear-tags | --set-tags=[TAG=REVISION,...]
| --remove-tags=[TAG,...] --update-tags=[TAG=REVISION,...]]
[--to-latest | --to-revisions=[REVISION-NAME=PERCENTAGE,...]
@ -73,6 +73,24 @@ FLAGS
Return immediately, without waiting for the operation in progress to
complete.
--endpoint-mode=ENDPOINT_MODE
Specifies endpoint mode for a given command. Regional endpoints provide
enhanced data residency and reliability by ensuring your request is
handled entirely within the specified Google Cloud region. This differs
from global endpoints, which may process parts of the request outside
the target region. Overrides the default regional/endpoint_mode
property value for this command invocation. ENDPOINT_MODE must be one
of:
global
(Default) Use global rather than regional endpoints.
regional
Only use regional endpoints. An error will be raised if a regional
endpoint is not available for a given command.
regional-preferred
Use regional endpoints when available, otherwise use global
endpoints. Recommended for most users.
--region=REGION
Region in which the resource can be found. Alternatively, set the
property [run/region].
@ -162,6 +180,12 @@ GCLOUD WIDE FLAGS
Run $ gcloud help for details.
REGIONAL ENDPOINTS
This command supports regional endpoints. To use regional endpoints for
this command, use the --endpoint-mode=regional-preferred flag. To use
regional endpoints by default, run $ gcloud config set
regional/endpoint_mode regional-preferred.
NOTES
This command is currently in beta and might change without notice. These
variants are also available:

22
gcloud/beta/run/worker-pools/deploy
View file

@ -19,9 +19,9 @@ SYNOPSIS
[--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...]
--args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...]
--cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --memory=MEMORY
--remove-volume-mount=[MOUNT_PATH,...] --clear-env-vars
| --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...]
| --remove-env-vars=[KEY,...]
--remove-volume-mount=[MOUNT_PATH,...]
--workdir=WORKDIR --clear-env-vars | --env-vars-file=FILE_PATH
| --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...]
--update-env-vars=[KEY=VALUE,...] --clear-secrets
| --set-secrets=[KEY=VALUE,...] | --remove-secrets=[KEY,...]
--update-secrets=[KEY=VALUE,...] --image=IMAGE | --source=SOURCE]
@ -216,6 +216,17 @@ FLAGS
multi-container services, specify the mount-path parameter under the
--add-volume-mount flag.
ephemeral-disk: A volume that stores data on a temporary disk. With
this type of volume, data is not shared between instances and all data
will be lost when the instance it is on is terminated. Additional keys:
◆ mount-path: (optional) The path at which the volume should be
mounted. The mount-path parameter is only supported for single
container services which do not make use of the --container flag. For
multi-container services, specify the mount-path parameter under the
--add-volume-mount flag.
◆ size: (optional) A quantity representing the amount of disk space
allocated to this volume, such as "10Gi" or "100G".
in-memory: An ephemeral volume that stores data in the instance's
memory. With this type of volume, data is not shared between instances
and all data will be lost when the instance it is on is terminated.
@ -293,6 +304,11 @@ FLAGS
Removes the volume mounted at the specified path from the current
container.
--workdir=WORKDIR
Working directory of the container process. If not specified, the
container image's default working directory is used. To reset this
field to its default, pass an empty string.
At most one of these can be specified:
--clear-env-vars

23
gcloud/beta/run/worker-pools/update
View file

@ -19,10 +19,9 @@ SYNOPSIS
[--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...]
--args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...]
--cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --image=IMAGE
--memory=MEMORY
--remove-volume-mount=[MOUNT_PATH,...] --clear-env-vars
| --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...]
| --remove-env-vars=[KEY,...]
--memory=MEMORY --remove-volume-mount=[MOUNT_PATH,...]
--workdir=WORKDIR --clear-env-vars | --env-vars-file=FILE_PATH
| --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...]
--update-env-vars=[KEY=VALUE,...] --clear-secrets
| --set-secrets=[KEY=VALUE,...]
| --remove-secrets=[KEY,...] --update-secrets=[KEY=VALUE,...]]
@ -212,6 +211,17 @@ FLAGS
multi-container services, specify the mount-path parameter under the
--add-volume-mount flag.
ephemeral-disk: A volume that stores data on a temporary disk. With
this type of volume, data is not shared between instances and all data
will be lost when the instance it is on is terminated. Additional keys:
◆ mount-path: (optional) The path at which the volume should be
mounted. The mount-path parameter is only supported for single
container services which do not make use of the --container flag. For
multi-container services, specify the mount-path parameter under the
--add-volume-mount flag.
◆ size: (optional) A quantity representing the amount of disk space
allocated to this volume, such as "10Gi" or "100G".
in-memory: An ephemeral volume that stores data in the instance's
memory. With this type of volume, data is not shared between instances
and all data will be lost when the instance it is on is terminated.
@ -293,6 +303,11 @@ FLAGS
Removes the volume mounted at the specified path from the current
container.
--workdir=WORKDIR
Working directory of the container process. If not specified, the
container image's default working directory is used. To reset this
field to its default, pass an empty string.
At most one of these can be specified:
--clear-env-vars