1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-16 20:36:39 +00:00

gcloud: Wed Nov 13 10:04:10 UTC 2024

This commit is contained in:
Automated 2024-11-13 10:04:10 +00:00
parent 7da5872e5c
commit a63704a3af
252 changed files with 4821 additions and 807 deletions

View file

@ -0,0 +1,91 @@
NAME
gcloud colab runtime-templates add-iam-policy-binding - add an IAM policy
binding to a Colab Enterprise runtime template
SYNOPSIS
gcloud colab runtime-templates add-iam-policy-binding
(RUNTIME_TEMPLATE : --region=REGION) --member=PRINCIPAL --role=ROLE
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Add an IAM policy binding to a Colab Enterprise runtime template.
EXAMPLES
To set someone@example.com to have the roles/aiplatform.notebookRuntimeUser
role for a runtime template with id my-runtime-template in region
us-central1, run:
$ gcloud colab runtime-templates add-iam-policy-binding \
my-runtime-template --region=us-central1 \
--member=user:someone@example.com \
--role=roles/aiplatform.notebookRuntimeUser
POSITIONAL ARGUMENTS
Runtime template resource - Unique name of the runtime template to add IAM
policy binding to. This was optionally provided by setting
--runtime-template-id in the create runtime-template command, or was
system-generated if unspecified. The arguments in this group can be used
to specify the attributes of this resource. (NOTE) Some attributes are not
given arguments in this group but can be set in other ways.
To set the project attribute:
◆ provide the argument runtime_template on the command line with a
fully specified name;
◆ provide the argument --project on the command line;
◆ set the property core/project.
This must be specified.
RUNTIME_TEMPLATE
ID of the runtime template or fully qualified identifier for the
runtime template.
To set the name attribute:
▸ provide the argument runtime_template on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--region=REGION
Cloud region for the runtime template.
To set the region attribute:
▸ provide the argument runtime_template on the command line with a
fully specified name;
▸ provide the argument --region on the command line;
▸ set the property colab/region.
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.
NOTES
This variant is also available:
$ gcloud beta colab runtime-templates add-iam-policy-binding

View file

@ -0,0 +1,228 @@
NAME
gcloud colab runtime-templates create - create a runtime template
SYNOPSIS
gcloud colab runtime-templates create --display-name=DISPLAY_NAME [--async]
[--region=REGION] [--runtime-template-id=RUNTIME_TEMPLATE_ID]
[--description=DESCRIPTION --no-enable-euc --enable-secure-boot
--idle-shutdown-timeout=IDLE_SHUTDOWN_TIMEOUT; default="3h"
--labels=[KEY=VALUE,...] --network-tags=[TAGS,...]
--accelerator-count=ACCELERATOR_COUNT
--accelerator-type=ACCELERATOR_TYPE --machine-type=MACHINE_TYPE;
default="e2-standard-4" --disk-size-gb=DISK_SIZE_GB; default=100
--disk-type=DISK_TYPE; default="PD_STANDARD" [--kms-key=KMS_KEY
: --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION
--kms-project=KMS_PROJECT] --no-enable-internet-access
--network=NETWORK [--subnetwork=SUBNETWORK
: --subnetwork-region=SUBNETWORK_REGION]] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Create a Colab Enterprise runtime template, a VM configuration for your
notebook runtimes.
EXAMPLES
To create a runtime template in region 'us-central1' with the display name
'my-runtime-template', run:
$ gcloud colab runtime-templates create --region=us-central1 \
--display-name=my-runtime-template
To create a runtime template for a VM with machine type n1-standard-2 and
one NVIDIA_TESLA_V100 accelerator, run:
$ gcloud colab runtime-templates create \
--machine-type=n1-standard-2 \
--accelerator-type=NVIDIA_TESLA_V100 --accelerator-count=1 \
--region=us-central1 --display-name=my-runtime-template
To create a runtime template that disables end user credential access, run:
$ gcloud colab runtime-templates create --no-enable-euc \
--region=us-central1 --display-name=my-runtime-template
REQUIRED FLAGS
--display-name=DISPLAY_NAME
The display name of the runtime template.
OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to
complete.
Region resource - Cloud region to create runtime template. Please see
https://cloud.google.com/colab/docs/locations for a list of supported
regions. This represents a Cloud resource. (NOTE) Some attributes are not
given arguments in this group but can be set in other ways.
To set the project attribute:
◆ provide the argument --region on the command line with a fully
specified name;
◆ set the property colab/region with a fully specified name;
◆ provide the argument --project on the command line;
◆ set the property core/project.
--region=REGION
ID of the region or fully qualified identifier for the region.
To set the region attribute:
▸ provide the argument --region on the command line;
▸ set the property colab/region.
--runtime-template-id=RUNTIME_TEMPLATE_ID
The id of the runtime template. If not specified, a random id will be
generated.
Configuration of the runtime template
--description=DESCRIPTION
The description of the runtime template.
--enable-euc
Enable end user credential access for the runtime. Enabled by
default, use --no-enable-euc to disable.
--enable-secure-boot
Enables secure boot for the runtime. Disabled by default.
--idle-shutdown-timeout=IDLE_SHUTDOWN_TIMEOUT; default="3h"
The duration after which the runtime is automatically shut down. An
input of 0s disables the idle shutdown feature, and a valid range is
[10m, 24h]. See '$ gcloud topic datetimes' for details on formatting
the input duration.
--labels=[KEY=VALUE,...]
Add labels to identify and group the runtime template.
--network-tags=[TAGS,...]
Applies the given Compute Engine tags to the runtime.
The machine configuration of the runtime provisioned from this template.
--accelerator-count=ACCELERATOR_COUNT
The number of accelerators used by the runtime.
--accelerator-type=ACCELERATOR_TYPE
The type of hardware accelerator used by the runtime. If specified,
--accelerator-count must also be specified. ACCELERATOR_TYPE must
be one of: NVIDIA_TESLA_V100, NVIDIA_TESLA_T4, NVIDIA_TESLA_A100,
NVIDIA_A100_80GB, NVIDIA_L4.
--machine-type=MACHINE_TYPE; default="e2-standard-4"
The Compute Engine machine type selected for the runtime.
The configuration for the data disk of the runtime provisioned from this
template.
--disk-size-gb=DISK_SIZE_GB; default=100
The disk size of the runtime in GB. If specified, the --disk-type
must also be specified. The minimum size is 10GB and the maximum is
65536GB.
--disk-type=DISK_TYPE; default="PD_STANDARD"
The type of the persistent disk. DISK_TYPE must be one of:
PD_STANDARD, PD_SSD, PD_BALANCED, PD_EXTREME.
Key resource - The Cloud KMS encryption key (customer-managed encryption
key) used to protect the runtime. The key must be in the same region as
the runtime. If not specified, Google-managed encryption keys will be
used. The arguments in this group can be used to specify the attributes
of this resource.
--kms-key=KMS_KEY
ID of the key or fully qualified identifier for the key.
To set the kms-key attribute:
▫ provide the argument --kms-key on the command line.
This flag argument must be specified if any of the other arguments
in this group are specified.
--kms-keyring=KMS_KEYRING
KMS keyring id of the key.
To set the kms-keyring attribute:
▫ provide the argument --kms-key on the command line with a fully
specified name;
▫ provide the argument --kms-keyring on the command line.
--kms-location=KMS_LOCATION
Cloud location for the key.
To set the kms-location attribute:
▫ provide the argument --kms-key on the command line with a fully
specified name;
▫ provide the argument --kms-location on the command line.
--kms-project=KMS_PROJECT
Cloud project id for the key.
To set the kms-project attribute:
▫ provide the argument --kms-key on the command line with a fully
specified name;
▫ provide the argument --kms-project on the command line.
The network configuration for the runtime.
--enable-internet-access
Enable public internet access for the runtime. Enabled by default,
use --no-enable-internet-access to disable.
Network resource - The name of the VPC that this runtime is in. This
represents a Cloud resource. (NOTE) Some attributes are not given
arguments in this group but can be set in other ways.
To set the project attribute:
▫ provide the argument --network on the command line with a fully
specified name;
▫ provide the argument --project on the command line;
▫ set the property core/project.
--network=NETWORK
ID of the network or fully qualified identifier for the network.
To set the network attribute:
◇ provide the argument --network on the command line.
Subnetwork resource - The name of the subnetwork that this runtime is
in. The arguments in this group can be used to specify the attributes
of this resource. (NOTE) Some attributes are not given arguments in
this group but can be set in other ways.
To set the project attribute:
▫ provide the argument --subnetwork on the command line with a
fully specified name;
▫ provide the argument --project on the command line;
▫ set the property core/project.
--subnetwork=SUBNETWORK
ID of the subnetwork or fully qualified identifier for the
subnetwork.
To set the subnetwork attribute:
◇ provide the argument --subnetwork on the command line.
This flag argument must be specified if any of the other
arguments in this group are specified.
--subnetwork-region=SUBNETWORK_REGION
Google Cloud region of this subnetwork
https://cloud.google.com/compute/docs/regions-zones/#locations.
To set the subnetwork-region attribute:
◇ provide the argument --subnetwork on the command line with a
fully specified name;
◇ provide the argument --subnetwork-region on the command line.
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
This variant is also available:
$ gcloud beta colab runtime-templates create

View file

@ -0,0 +1,70 @@
NAME
gcloud colab runtime-templates delete - delete a runtime template
SYNOPSIS
gcloud colab runtime-templates delete (RUNTIME_TEMPLATE : --region=REGION)
[--async] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Delete a Colab Enterprise notebook runtime template.
EXAMPLES
To delete a runtime template with id 'my-runtime-template' in region
'us-central1', run:
$ gcloud colab runtime-templates delete my-runtime-template \
--region=us-central1
POSITIONAL ARGUMENTS
Runtime template resource - Unique name of the runtime template to delete.
This was optionally provided by setting --runtime-template-id in the
create runtime-template command, or was system-generated if unspecified.
The arguments in this group can be used to specify the attributes of this
resource. (NOTE) Some attributes are not given arguments in this group but
can be set in other ways.
To set the project attribute:
◆ provide the argument runtime_template on the command line with a
fully specified name;
◆ provide the argument --project on the command line;
◆ set the property core/project.
This must be specified.
RUNTIME_TEMPLATE
ID of the runtime template or fully qualified identifier for the
runtime template.
To set the name attribute:
▸ provide the argument runtime_template on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--region=REGION
Cloud region for the runtime template.
To set the region attribute:
▸ provide the argument runtime_template on the command line with a
fully specified name;
▸ provide the argument --region on the command line;
▸ set the property colab/region.
FLAGS
--async
Return immediately, without waiting for the operation in progress to
complete.
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
This variant is also available:
$ gcloud beta colab runtime-templates delete

View file

@ -0,0 +1,65 @@
NAME
gcloud colab runtime-templates describe - describe a runtime template
SYNOPSIS
gcloud colab runtime-templates describe
(RUNTIME_TEMPLATE : --region=REGION) [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Describe a Colab Enterprise notebook runtime template.
EXAMPLES
To describe a runtime template with id 'my-runtime-template' in region
'us-central1', run:
$ gcloud colab runtime-templates describe my-runtime-template \
--region=us-central1
POSITIONAL ARGUMENTS
Runtime template resource - Unique name of the runtime template to
describe. This was optionally provided by setting --runtime-template-id in
the create runtime-template command, or was system-generated if
unspecified. The arguments in this group can be used to specify the
attributes of this resource. (NOTE) Some attributes are not given
arguments in this group but can be set in other ways.
To set the project attribute:
◆ provide the argument runtime_template on the command line with a
fully specified name;
◆ provide the argument --project on the command line;
◆ set the property core/project.
This must be specified.
RUNTIME_TEMPLATE
ID of the runtime template or fully qualified identifier for the
runtime template.
To set the name attribute:
▸ provide the argument runtime_template on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--region=REGION
Cloud region for the runtime template.
To set the region attribute:
▸ provide the argument runtime_template on the command line with a
fully specified name;
▸ provide the argument --region on the command line;
▸ set the property colab/region.
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
This variant is also available:
$ gcloud beta colab runtime-templates describe

View file

@ -0,0 +1,96 @@
NAME
gcloud colab runtime-templates get-iam-policy - get IAM policy for a Colab
Enterprise runtime template
SYNOPSIS
gcloud colab runtime-templates get-iam-policy
(RUNTIME_TEMPLATE : --region=REGION) [--filter=EXPRESSION]
[--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Get the IAM policy for a Colab Enterprise runtime template.
EXAMPLES
To get the IAM policy for a runtime template with id my-runtime-template in
region us-central1, run:
$ gcloud colab runtime-templates get-iam-policy \
my-runtime-template --location=us-central1 \
--member=user:someone@example.com \
--role=roles/aiplatform.notebookRuntimeUser
POSITIONAL ARGUMENTS
Runtime template resource - Unique name of the runtime template to get IAM
policy for. This was optionally provided by setting --runtime-template-id
in the create runtime-template command, or was system-generated if
unspecified. The arguments in this group can be used to specify the
attributes of this resource. (NOTE) Some attributes are not given
arguments in this group but can be set in other ways.
To set the project attribute:
◆ provide the argument runtime_template on the command line with a
fully specified name;
◆ provide the argument --project on the command line;
◆ set the property core/project.
This must be specified.
RUNTIME_TEMPLATE
ID of the runtime template or fully qualified identifier for the
runtime template.
To set the name attribute:
▸ provide the argument runtime_template on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--region=REGION
Cloud region for the runtime template.
To set the region attribute:
▸ provide the argument runtime_template on the command line with a
fully specified name;
▸ provide the argument --region on the command line;
▸ set the property colab/region.
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
This variant is also available:
$ gcloud beta colab runtime-templates get-iam-policy

View file

@ -0,0 +1,48 @@
NAME
gcloud colab runtime-templates - manage Colab Enterprise runtime templates
SYNOPSIS
gcloud colab runtime-templates COMMAND [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
For more information about runtime templates, see
https://cloud.google.com/colab/docs/runtimes#runtime-templates
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 Colab Enterprise runtime template.
create
Create a runtime template.
delete
Delete a runtime template.
describe
Describe a runtime template.
get-iam-policy
Get IAM policy for a Colab Enterprise runtime template.
list
List your runtime templates.
remove-iam-policy-binding
Remove an IAM policy binding from a Colab Enterprise runtime template.
set-iam-policy
Set IAM policy for a Colab Enterprise runtime template as defined in a
JSON or YAML file.
NOTES
This variant is also available:
$ gcloud beta colab runtime-templates

View file

@ -0,0 +1,83 @@
NAME
gcloud colab runtime-templates list - list your runtime templates
SYNOPSIS
gcloud colab runtime-templates list [--region=REGION] [--filter=EXPRESSION]
[--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
List your project's Colab Enterprise notebook runtime templates in a given
region.
EXAMPLES
To list your runtime templates in region 'us-central1', run:
$ gcloud colab runtime-templates list --region=us-central1
FLAGS
Region resource - Cloud region for which to list all runtime templates.
Please see https://cloud.google.com/colab/docs/locations for a list of
supported regions. This represents a Cloud resource. (NOTE) Some
attributes are not given arguments in this group but can be set in other
ways.
To set the project attribute:
◆ provide the argument --region on the command line with a fully
specified name;
◆ set the property colab/region with a fully specified name;
◆ provide the argument --project on the command line;
◆ set the property core/project.
--region=REGION
ID of the region or fully qualified identifier for the region.
To set the region attribute:
▸ provide the argument --region on the command line;
▸ set the property colab/region.
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.
NOTES
This variant is also available:
$ gcloud beta colab runtime-templates list

View file

@ -0,0 +1,92 @@
NAME
gcloud colab runtime-templates remove-iam-policy-binding - remove an IAM
policy binding from a Colab Enterprise runtime template
SYNOPSIS
gcloud colab runtime-templates remove-iam-policy-binding
(RUNTIME_TEMPLATE : --region=REGION) --member=PRINCIPAL --role=ROLE
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Remove an IAM policy binding from a Colab Enterprise runtime template.
EXAMPLES
To remove an IAM policy binding of roles/aiplatform.notebookRuntimeUser for
someone@example.com, from the runtime template with id my-runtime-template
in region us-central1, run:
$ gcloud colab runtime-templates remove-iam-policy-binding \
my-runtime-template --region=us-central1 \
--member=user:someone@example.com \
--role=roles/aiplatform.notebookRuntimeUser
POSITIONAL ARGUMENTS
Runtime template resource - Unique name of the runtime template to remove
IAM policy from. This was optionally provided by setting
--runtime-template-id in the create runtime-template command, or was
system-generated if unspecified. The arguments in this group can be used
to specify the attributes of this resource. (NOTE) Some attributes are not
given arguments in this group but can be set in other ways.
To set the project attribute:
◆ provide the argument runtime_template on the command line with a
fully specified name;
◆ provide the argument --project on the command line;
◆ set the property core/project.
This must be specified.
RUNTIME_TEMPLATE
ID of the runtime template or fully qualified identifier for the
runtime template.
To set the name attribute:
▸ provide the argument runtime_template on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--region=REGION
Cloud region for the runtime template.
To set the region attribute:
▸ provide the argument runtime_template on the command line with a
fully specified name;
▸ provide the argument --region on the command line;
▸ set the property colab/region.
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.
NOTES
This variant is also available:
$ gcloud beta colab runtime-templates remove-iam-policy-binding

View file

@ -0,0 +1,77 @@
NAME
gcloud colab runtime-templates set-iam-policy - set IAM policy for a Colab
Enterprise runtime template as defined in a JSON or YAML file
SYNOPSIS
gcloud colab runtime-templates set-iam-policy
(RUNTIME_TEMPLATE : --region=REGION) POLICY_FILE [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Set the IAM policy for a Colab Enterprise runtime template as defined in a
JSON or YAML file.
See https://cloud.google.com/iam/docs/managing-policies for details of the
policy file format and contents.
EXAMPLES
To set the IAM policy for a runtime template with id my-runtime-template in
region us-central1 to the policy defined in policy.json, run:
$ gcloud colab runtime-templates set-iam-policy \
my-runtime-template policy.json --region=us-central1
POSITIONAL ARGUMENTS
Runtime template resource - Unique name of the runtime template to set IAM
policy for. This was optionally provided by setting --runtime-template-id
in the create runtime-template command, or was system-generated if
unspecified. The arguments in this group can be used to specify the
attributes of this resource. (NOTE) Some attributes are not given
arguments in this group but can be set in other ways.
To set the project attribute:
◆ provide the argument runtime_template on the command line with a
fully specified name;
◆ provide the argument --project on the command line;
◆ set the property core/project.
This must be specified.
RUNTIME_TEMPLATE
ID of the runtime template or fully qualified identifier for the
runtime template.
To set the name attribute:
▸ provide the argument runtime_template on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--region=REGION
Cloud region for the runtime template.
To set the region attribute:
▸ provide the argument runtime_template on the command line with a
fully specified name;
▸ provide the argument --region on the command line;
▸ set the property colab/region.
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.
NOTES
This variant is also available:
$ gcloud beta colab runtime-templates set-iam-policy