From 5bf6fb3fc0a65105c23c4228b71b718f0684589d Mon Sep 17 00:00:00 2001 From: Automated Date: Sat, 17 Feb 2024 10:15:37 +0000 Subject: [PATCH] gcloud: Sat Feb 17 10:15:37 UTC 2024 --- gcloud/_version | 8 +- gcloud/alpha/auth/application-default/login | 10 +- gcloud/alpha/bms/os-images/describe | 4 +- gcloud/alpha/metastore/services/restore | 29 ++- gcloud/alpha/notebooks/instances/create | 179 +++++++------- gcloud/alpha/run/deploy | 7 +- gcloud/alpha/run/jobs/deploy | 232 ++++++++++-------- gcloud/alpha/run/jobs/update | 219 +++++++++-------- gcloud/alpha/run/services/update | 9 +- gcloud/alpha/source-manager/help | 34 +++ .../instances/add-iam-policy-binding | 97 ++++++++ gcloud/alpha/source-manager/instances/create | 94 +++++++ gcloud/alpha/source-manager/instances/delete | 84 +++++++ .../alpha/source-manager/instances/describe | 70 ++++++ .../source-manager/instances/get-iam-policy | 97 ++++++++ gcloud/alpha/source-manager/instances/help | 51 ++++ gcloud/alpha/source-manager/instances/list | 90 +++++++ .../instances/remove-iam-policy-binding | 98 ++++++++ .../source-manager/instances/set-iam-policy | 77 ++++++ gcloud/alpha/source-manager/locations/help | 29 +++ gcloud/alpha/source-manager/locations/list | 71 ++++++ .../alpha/source-manager/operations/describe | 70 ++++++ gcloud/alpha/source-manager/operations/help | 32 +++ gcloud/alpha/source-manager/operations/list | 90 +++++++ gcloud/alpha/workstations/clusters/list | 12 +- gcloud/alpha/workstations/configs/create | 12 +- gcloud/alpha/workstations/configs/list | 26 +- gcloud/alpha/workstations/configs/update | 13 +- gcloud/alpha/workstations/list | 35 +-- gcloud/alpha/workstations/list-usable | 33 +-- gcloud/alpha/workstations/ssh | 2 +- gcloud/alpha/workstations/start | 2 +- gcloud/alpha/workstations/start-tcp-tunnel | 2 +- gcloud/alpha/workstations/stop | 2 +- gcloud/auth/application-default/login | 10 +- gcloud/beta/auth/application-default/login | 10 +- .../interconnects/attachments/partner/create | 11 +- .../interconnects/attachments/partner/update | 12 +- gcloud/beta/metastore/services/restore | 29 ++- gcloud/beta/notebooks/instances/create | 179 +++++++------- gcloud/beta/run/deploy | 9 +- gcloud/beta/run/jobs/deploy | 2 +- gcloud/beta/run/jobs/update | 2 +- gcloud/beta/run/services/update | 12 +- gcloud/beta/source-manager/help | 32 +++ .../instances/add-iam-policy-binding | 95 +++++++ gcloud/beta/source-manager/instances/create | 92 +++++++ gcloud/beta/source-manager/instances/delete | 82 +++++++ gcloud/beta/source-manager/instances/describe | 68 +++++ .../source-manager/instances/get-iam-policy | 95 +++++++ gcloud/beta/source-manager/instances/help | 49 ++++ gcloud/beta/source-manager/instances/list | 88 +++++++ .../instances/remove-iam-policy-binding | 96 ++++++++ .../source-manager/instances/set-iam-policy | 75 ++++++ gcloud/beta/source-manager/locations/help | 27 ++ gcloud/beta/source-manager/locations/list | 69 ++++++ .../beta/source-manager/operations/describe | 68 +++++ gcloud/beta/source-manager/operations/help | 30 +++ gcloud/beta/source-manager/operations/list | 88 +++++++ gcloud/beta/workstations/clusters/list | 12 +- gcloud/beta/workstations/configs/create | 12 +- gcloud/beta/workstations/configs/list | 21 +- gcloud/beta/workstations/configs/update | 13 +- gcloud/beta/workstations/list | 35 +-- gcloud/beta/workstations/list-usable | 33 +-- gcloud/beta/workstations/ssh | 2 +- gcloud/beta/workstations/start | 2 +- gcloud/beta/workstations/start-tcp-tunnel | 2 +- gcloud/beta/workstations/stop | 2 +- gcloud/bms/os-images/describe | 60 +++++ gcloud/bms/os-images/help | 3 + gcloud/compute/tpus/tpu-vm/create | 10 +- gcloud/notebooks/instances/create | 179 +++++++------- gcloud/run/services/update | 2 + gcloud/workstations/clusters/list | 12 +- gcloud/workstations/configs/create | 12 +- gcloud/workstations/configs/list | 21 +- gcloud/workstations/configs/update | 13 +- gcloud/workstations/list | 35 +-- gcloud/workstations/list-usable | 33 +-- gcloud/workstations/ssh | 2 +- gcloud/workstations/start | 2 +- gcloud/workstations/start-tcp-tunnel | 2 +- gcloud/workstations/stop | 2 +- 84 files changed, 3111 insertions(+), 661 deletions(-) create mode 100644 gcloud/alpha/source-manager/help create mode 100644 gcloud/alpha/source-manager/instances/add-iam-policy-binding create mode 100644 gcloud/alpha/source-manager/instances/create create mode 100644 gcloud/alpha/source-manager/instances/delete create mode 100644 gcloud/alpha/source-manager/instances/describe create mode 100644 gcloud/alpha/source-manager/instances/get-iam-policy create mode 100644 gcloud/alpha/source-manager/instances/help create mode 100644 gcloud/alpha/source-manager/instances/list create mode 100644 gcloud/alpha/source-manager/instances/remove-iam-policy-binding create mode 100644 gcloud/alpha/source-manager/instances/set-iam-policy create mode 100644 gcloud/alpha/source-manager/locations/help create mode 100644 gcloud/alpha/source-manager/locations/list create mode 100644 gcloud/alpha/source-manager/operations/describe create mode 100644 gcloud/alpha/source-manager/operations/help create mode 100644 gcloud/alpha/source-manager/operations/list create mode 100644 gcloud/beta/source-manager/help create mode 100644 gcloud/beta/source-manager/instances/add-iam-policy-binding create mode 100644 gcloud/beta/source-manager/instances/create create mode 100644 gcloud/beta/source-manager/instances/delete create mode 100644 gcloud/beta/source-manager/instances/describe create mode 100644 gcloud/beta/source-manager/instances/get-iam-policy create mode 100644 gcloud/beta/source-manager/instances/help create mode 100644 gcloud/beta/source-manager/instances/list create mode 100644 gcloud/beta/source-manager/instances/remove-iam-policy-binding create mode 100644 gcloud/beta/source-manager/instances/set-iam-policy create mode 100644 gcloud/beta/source-manager/locations/help create mode 100644 gcloud/beta/source-manager/locations/list create mode 100644 gcloud/beta/source-manager/operations/describe create mode 100644 gcloud/beta/source-manager/operations/help create mode 100644 gcloud/beta/source-manager/operations/list create mode 100644 gcloud/bms/os-images/describe diff --git a/gcloud/_version b/gcloud/_version index 51cb33f77..b701fcb7a 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 463.0.0 -alpha 2024.02.02 -beta 2024.02.02 +Google Cloud SDK 464.0.0 +alpha 2024.02.09 +beta 2024.02.09 bq 2.0.101 bundled-python3-unix 3.11.7 -core 2024.02.02 +core 2024.02.09 gcloud-crc32c 1.0.0 gsutil 5.27 diff --git a/gcloud/alpha/auth/application-default/login b/gcloud/alpha/auth/application-default/login index 31dab5b41..c06f198c6 100644 --- a/gcloud/alpha/auth/application-default/login +++ b/gcloud/alpha/auth/application-default/login @@ -3,7 +3,7 @@ NAME to use for Application Default Credentials SYNOPSIS - gcloud alpha auth application-default login [--no-browser] + gcloud alpha auth application-default login [ACCOUNT] [--no-browser] [--client-id-file=CLIENT_ID_FILE] [--disable-quota-project] [--no-launch-browser] [--login-config=LOGIN_CONFIG] [--scopes=SCOPE,[SCOPE,...]] [GCLOUD_WIDE_FLAG ...] @@ -43,6 +43,14 @@ EXAMPLES $ gcloud alpha auth application-default login \ --client-id-file=clientid.json +POSITIONAL ARGUMENTS + [ACCOUNT] + User account used for authorization. When the account specified has + valid credentials in the local credential store these credentials will + be re-used. Otherwise new ones will be fetched and replace any stored + credential. This caching behavior is only available for user + credentials. + FLAGS --no-browser If you want to authorize the client libraries on a machine that doesn't diff --git a/gcloud/alpha/bms/os-images/describe b/gcloud/alpha/bms/os-images/describe index 2189eac33..51ac68cc4 100644 --- a/gcloud/alpha/bms/os-images/describe +++ b/gcloud/alpha/bms/os-images/describe @@ -58,5 +58,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud bms os-images describe diff --git a/gcloud/alpha/metastore/services/restore b/gcloud/alpha/metastore/services/restore index 1c8638194..bfa6ec5f5 100644 --- a/gcloud/alpha/metastore/services/restore +++ b/gcloud/alpha/metastore/services/restore @@ -4,12 +4,13 @@ NAME SYNOPSIS gcloud alpha metastore services restore (SERVICE : --location=LOCATION) - --backup=BACKUP [--async] + (--backup=BACKUP | --backup-location=BACKUP_LOCATION) [--async] [--restore-type=RESTORE_TYPE; default="metadata-only"] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Restore a Dataproc Metastore service from the given backup. + (ALPHA) Restore a Dataproc Metastore service from the given backup or + backup-location If run asynchronously with --async, exits after printing an operation name that can be used to poll the status of the creation via: @@ -23,6 +24,12 @@ EXAMPLES $ gcloud alpha metastore services restore my-service \ --backup=my-backup --restore-type=full + To restore a Dataproc Metastore service with the name my-service from the + backup-location gs://gcs_bucket with a FULL restore type, run: + + $ gcloud alpha metastore services restore my-service \ + --backup-location=gs://gcs_bucket --restore-type=full + POSITIONAL ARGUMENTS Service resource - Arguments and flags that specify the Dataproc Metastore service you want to restore. The arguments in this group can be used to @@ -58,10 +65,20 @@ POSITIONAL ARGUMENTS ▸ set the property metastore/location. REQUIRED FLAGS - --backup=BACKUP - The backup resource to restore from. This can be the backup's ID, - fully-qualified URL, or relative name in the form - projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}. + The backup resource or the location of the backup artifacts to store from. + + Exactly one of these must be specified: + + --backup=BACKUP + The backup resource to restore from. This can be the backup's ID, + fully-qualified URL, or relative name in the form + projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}. + + --backup-location=BACKUP_LOCATION + The location of the backup artifacts to restore from. This should be + a Cloud Storage URI, contains backup avro files under "avro/", + backup_metastore.json and service.json, in the form + gs://. OPTIONAL FLAGS --async diff --git a/gcloud/alpha/notebooks/instances/create b/gcloud/alpha/notebooks/instances/create index 156f0abbe..d23468662 100644 --- a/gcloud/alpha/notebooks/instances/create +++ b/gcloud/alpha/notebooks/instances/create @@ -3,23 +3,24 @@ NAME SYNOPSIS gcloud alpha notebooks instances create (INSTANCE : --location=LOCATION) - ([--container-repository=CONTAINER_REPOSITORY - : --container-tag=CONTAINER_TAG] | [--environment=ENVIRONMENT - : --environment-location=ENVIRONMENT_LOCATION] - | [(--vm-image-family=VM_IMAGE_FAMILY; default="common-cpu" - | --vm-image-name=VM_IMAGE_NAME) - : --vm-image-project=VM_IMAGE_PROJECT; - default="deeplearning-platform-release"]) [--async] - [--instance-owners=INSTANCE_OWNERS] [--labels=[KEY=VALUE,...]] + [--async] [--instance-owners=INSTANCE_OWNERS] + [--labels=[KEY=VALUE,...]] [--machine-type=MACHINE_TYPE; default="n1-standard-1"] [--metadata=[KEY=VALUE,...]] [--post-startup-script=POST_STARTUP_SCRIPT] [--service-account=SERVICE_ACCOUNT] [--no-shielded-integrity-monitoring] [--shielded-secure-boot] - [--no-shielded-vtpm] + [--no-shielded-vtpm] [--tags=[TAGS,...]] [--accelerator-core-count=ACCELERATOR_CORE_COUNT --accelerator-type=ACCELERATOR_TYPE] [--boot-disk-size=BOOT_DISK_SIZE --boot-disk-type=BOOT_DISK_TYPE] + [[--container-repository=CONTAINER_REPOSITORY + : --container-tag=CONTAINER_TAG] | [--environment=ENVIRONMENT + : --environment-location=ENVIRONMENT_LOCATION] + | --vm-image-project=VM_IMAGE_PROJECT; + default="deeplearning-platform-release" + --vm-image-family=VM_IMAGE_FAMILY; default="common-cpu" + | --vm-image-name=VM_IMAGE_NAME] [--custom-gpu-driver-path=CUSTOM_GPU_DRIVER_PATH --install-gpu-driver] [--data-disk-size=DATA_DISK_SIZE --data-disk-type=DATA_DISK_TYPE --no-remove-data-disk] @@ -101,8 +102,86 @@ POSITIONAL ARGUMENTS ▸ provide the argument --location on the command line; ▸ set the property notebooks/location. -REQUIRED FLAGS - Exactly one of these must be specified: +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --instance-owners=INSTANCE_OWNERS + The owners of this instance after creation. Format:alias@example.com. + Currently supports one owner only.If not specified, all of the service + account users of the VM instance's service account can use the + instance. + + --labels=[KEY=VALUE,...] + Labels to apply to this instance. These can be later modified by the + setLabels method. + + --machine-type=MACHINE_TYPE; default="n1-standard-1" + The Compute Engine machine type + (https://cloud.google.com/sdk/gcloud/reference/compute/machine-types) + of this instance. + + --metadata=[KEY=VALUE,...] + Custom metadata to apply to this instance. + + For example, to specify a Cloud Storage bucket for automatic backup, + you can use the gcs-data-bucket metadata tag. Format: + "--metadata=gcs-data-bucket=BUCKET". + + --post-startup-script=POST_STARTUP_SCRIPT + Path to a Bash script that automatically runs after a notebook instance + fully boots up. The path must be a URL or Cloud Storage path + (gs://path-to-file/file-name). + + --service-account=SERVICE_ACCOUNT + The service account on this instance, giving access to other Google + Cloud services. You can use any service account within the same + project, but you must have the service account user permission to use + the instance. If not specified, the Compute Engine default service + account is used. + + --shielded-integrity-monitoring + Enable monitoring of the boot integrity of the instance. Enabled by + default, use --no-shielded-integrity-monitoring to disable. + + --shielded-secure-boot + Boot instance with secure boot enabled. Disabled by default. + + --shielded-vtpm + Boot instance with TPM (Trusted Platform Module) enabled. Enabled by + default, use --no-shielded-vtpm to disable. + + --tags=[TAGS,...] + Tags to apply to this instance. + + The hardware accelerator used on this instance. If you use accelerators, + make sure that your configuration has enough vCPUs and memory to support + the `machine_type` you have selected. + + --accelerator-core-count=ACCELERATOR_CORE_COUNT + Count of cores of this accelerator. + + --accelerator-type=ACCELERATOR_TYPE + Type of this accelerator. ACCELERATOR_TYPE must be one of: + NVIDIA_TESLA_A100, NVIDIA_TESLA_K80, NVIDIA_TESLA_P100, + NVIDIA_TESLA_V100, NVIDIA_TESLA_P4, NVIDIA_TESLA_T4, + NVIDIA_TESLA_T4_VWS, NVIDIA_TESLA_P100_VWS, NVIDIA_TESLA_P4_VWS, + TPU_V2, TPU_V3. + + Boot disk configurations. + + --boot-disk-size=BOOT_DISK_SIZE + Size of boot disk in GB attached to this instance, up to a maximum of + 64000 GB (64 TB). The minimum recommended value is 100 GB. If not + specified, this defaults to 100. + + --boot-disk-type=BOOT_DISK_TYPE + Type of boot disk attached to this instance, defaults to standard + persistent disk (PD_STANDARD). BOOT_DISK_TYPE must be one of: + PD_STANDARD, PD_SSD, PD_BALANCED, PD_EXTREME. + + At most one of these can be specified: --container-repository=CONTAINER_REPOSITORY The path to the container image repository. For example: @@ -155,7 +234,7 @@ REQUIRED FLAGS The ID of the Google Cloud project that this VM image belongs to. Format: projects/{project_id}. - Exactly one of these must be specified: + At most one of these can be specified: --vm-image-family=VM_IMAGE_FAMILY; default="common-cpu" Use this VM image family to find the image; the newest image in @@ -164,82 +243,6 @@ REQUIRED FLAGS --vm-image-name=VM_IMAGE_NAME Use this VM image name to find the image. -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --instance-owners=INSTANCE_OWNERS - The owners of this instance after creation. Format:alias@example.com. - Currently supports one owner only.If not specified, all of the service - account users of the VM instance's service account can use the - instance. - - --labels=[KEY=VALUE,...] - Labels to apply to this instance. These can be later modified by the - setLabels method. - - --machine-type=MACHINE_TYPE; default="n1-standard-1" - The Compute Engine machine type - (https://cloud.google.com/sdk/gcloud/reference/compute/machine-types) - of this instance. - - --metadata=[KEY=VALUE,...] - Custom metadata to apply to this instance. - - For example, to specify a Cloud Storage bucket for automatic backup, - you can use the gcs-data-bucket metadata tag. Format: - "--metadata=gcs-data-bucket=BUCKET". - - --post-startup-script=POST_STARTUP_SCRIPT - Path to a Bash script that automatically runs after a notebook instance - fully boots up. The path must be a URL or Cloud Storage path - (gs://path-to-file/file-name). - - --service-account=SERVICE_ACCOUNT - The service account on this instance, giving access to other Google - Cloud services. You can use any service account within the same - project, but you must have the service account user permission to use - the instance. If not specified, the Compute Engine default service - account is used. - - --shielded-integrity-monitoring - Enable monitoring of the boot integrity of the instance. Enabled by - default, use --no-shielded-integrity-monitoring to disable. - - --shielded-secure-boot - Boot instance with secure boot enabled. Disabled by default. - - --shielded-vtpm - Boot instance with TPM (Trusted Platform Module) enabled. Enabled by - default, use --no-shielded-vtpm to disable. - - The hardware accelerator used on this instance. If you use accelerators, - make sure that your configuration has enough vCPUs and memory to support - the `machine_type` you have selected. - - --accelerator-core-count=ACCELERATOR_CORE_COUNT - Count of cores of this accelerator. - - --accelerator-type=ACCELERATOR_TYPE - Type of this accelerator. ACCELERATOR_TYPE must be one of: - NVIDIA_TESLA_A100, NVIDIA_TESLA_K80, NVIDIA_TESLA_P100, - NVIDIA_TESLA_V100, NVIDIA_TESLA_P4, NVIDIA_TESLA_T4, - NVIDIA_TESLA_T4_VWS, NVIDIA_TESLA_P100_VWS, NVIDIA_TESLA_P4_VWS, - TPU_V2, TPU_V3. - - Boot disk configurations. - - --boot-disk-size=BOOT_DISK_SIZE - Size of boot disk in GB attached to this instance, up to a maximum of - 64000 GB (64 TB). The minimum recommended value is 100 GB. If not - specified, this defaults to 100. - - --boot-disk-type=BOOT_DISK_TYPE - Type of boot disk attached to this instance, defaults to standard - persistent disk (PD_STANDARD). BOOT_DISK_TYPE must be one of: - PD_STANDARD, PD_SSD, PD_BALANCED, PD_EXTREME. - GPU driver configurations. --custom-gpu-driver-path=CUSTOM_GPU_DRIVER_PATH diff --git a/gcloud/alpha/run/deploy b/gcloud/alpha/run/deploy index c0fb0e55b..1b7a15133 100644 --- a/gcloud/alpha/run/deploy +++ b/gcloud/alpha/run/deploy @@ -437,8 +437,9 @@ FLAGS --no-cpu-throttling to disable. --[no-]default-url - toggles the default url for a run service. Use --default-url to - enable and --no-default-url to disable. + Toggles the default url for a run service. This is enabled by default + if not specified. Use --default-url to enable and --no-default-url to + disable. --[no-]deploy-health-check Schedules a single instance of the Revision and waits for it to start @@ -550,7 +551,7 @@ FLAGS --add-volume=[KEY=VALUE,...] Adds a volume to the Cloud Run resource. To add more than one volume, - specify this flag mulitple times. Volumes must have a name and type + specify this flag multiple times. Volumes must have a name and type key. Only certain values are supported for type. Depending on the provided type, other keys will be required. The following types are supported with the specified additional keys: diff --git a/gcloud/alpha/run/jobs/deploy b/gcloud/alpha/run/jobs/deploy index ebdf129b6..87310edcb 100644 --- a/gcloud/alpha/run/jobs/deploy +++ b/gcloud/alpha/run/jobs/deploy @@ -2,28 +2,30 @@ NAME gcloud alpha run jobs deploy - create or update a Cloud Run job SYNOPSIS - gcloud alpha run jobs deploy [JOB] [--args=[ARG,...]] - [--binary-authorization=POLICY] [--breakglass=JUSTIFICATION] - [--command=[COMMAND,...]] [--cpu=CPU] [--key=KEY] + gcloud alpha run jobs deploy [JOB] [--binary-authorization=POLICY] + [--breakglass=JUSTIFICATION] [--container=CONTAINER] [--key=KEY] [--labels=[KEY=VALUE,...]] [--max-retries=MAX_RETRIES] - [--memory=MEMORY] [--parallelism=PARALLELISM] [--region=REGION] + [--parallelism=PARALLELISM] [--region=REGION] + [--remove-containers=[CONTAINER,...]] [--service-account=SERVICE_ACCOUNT] [--set-cloudsql-instances=[CLOUDSQL-INSTANCES,...]] - [--set-secrets=[KEY=SECRET_NAME:SECRET_VERSION,...]] [--task-timeout=TASK_TIMEOUT] [--tasks=TASKS; default=1] [--vpc-connector=VPC_CONNECTOR] [--vpc-egress=VPC_EGRESS] [--add-volume=[KEY=VALUE,...] --clear-volumes --remove-volume=[VOLUME,...]] [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] - --clear-volume-mounts --remove-volume-mount=[MOUNT_PATH,...]] + --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] + --cpu=CPU --memory=MEMORY + --remove-volume-mount=[MOUNT_PATH,...] --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] [--async | --execute-now --wait] - [--clear-env-vars | --env-vars-file=FILE_PATH - | --set-env-vars=[KEY=VALUE,...] - | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...]] [--clear-network | --network=NETWORK --subnet=SUBNET --clear-network-tags - | --network-tags=[TAG,...]] [--image=IMAGE | --source=SOURCE] - [GCLOUD_WIDE_FLAG ...] + | --network-tags=[TAG,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Creates or updates a Cloud Run job. @@ -61,12 +63,6 @@ POSITIONAL ARGUMENTS ▸ specify the job name from an interactive prompt. FLAGS - --args=[ARG,...] - Comma-separated arguments passed to the command run by the container - image. If not specified and no '--command' is provided, the container - image's default Cmd is used. Otherwise, if not specified, no arguments - are passed. To reset this field to its default, pass an empty string. - --binary-authorization=POLICY Binary Authorization policy to check against. This must be set to "default". @@ -78,17 +74,9 @@ FLAGS more information. Next update or deploy command will automatically clear existing breakglass justification. - --command=[COMMAND,...] - Entrypoint for the container image. If not specified, the container - image's default Entrypoint is run. To reset this field to its default, - pass an empty string. - - --cpu=CPU - Set a CPU limit in Kubernetes cpu units. - - Cloud Run (fully managed) supports values 1, 2 and 4. For Cloud Run - (fully managed), 4 cpus also requires a minimum 2Gi --memory value. - Examples 2, 2.0, 2000m + --container=CONTAINER + Specifies a container by name. Flags following --container will apply + to the specified container. --key=KEY CMEK key reference to encrypt the container with. @@ -101,9 +89,6 @@ FLAGS being failed permanently. This applies per-task, not per-job. If set to 0, tasks will only run once and never be retried on failure. - --memory=MEMORY - Set a memory limit. Ex: 1024Mi, 4Gi. - --parallelism=PARALLELISM Number of tasks that may run concurrently. Must be less than or equal to the number of tasks. Set to 0 to unset. @@ -112,6 +97,9 @@ FLAGS Region in which the resource can be found. Alternatively, set the property [run/region]. + --remove-containers=[CONTAINER,...] + List of containers to remove. + --service-account=SERVICE_ACCOUNT Service account associated with the revision of the service. The service account represents the identity of the running revision, and @@ -123,13 +111,6 @@ FLAGS project and region as your Cloud Run resource; otherwise specify :: for the instance. - --set-secrets=[KEY=SECRET_NAME:SECRET_VERSION,...] - Specify secrets to provide as environment variables. For example: - '--set-secrets=ENV=mysecret:latest,OTHER_ENV=othersecret:1' will create - an environment variable named ENV whose value is the latest version of - secret 'mysecret' and an environment variable OTHER_ENV whose value is - version of 1 of secret 'othersecret'. - --task-timeout=TASK_TIMEOUT Set the maximum time (deadline) a job task attempt can run for. In the case of retries, this deadline applies to each attempt of a task. If @@ -170,7 +151,7 @@ FLAGS --add-volume=[KEY=VALUE,...] Adds a volume to the Cloud Run resource. To add more than one volume, - specify this flag mulitple times. Volumes must have a name and type + specify this flag multiple times. Volumes must have a name and type key. Only certain values are supported for type. Depending on the provided type, other keys will be required. The following types are supported with the specified additional keys: @@ -217,18 +198,124 @@ FLAGS --remove-volume=[VOLUME,...] Removes volumes from the Cloud Run resource. - --add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] - Adds a mount to the current container. Must contain the keys - volume=NAME and mount-path=/PATH where NAME is the name of a volume on - this resource and PATH is the path within the container's filesystem to - mount this volume. + Container Flags - --clear-volume-mounts - Remove all existing mounts from the current container. + If the --container or --remove-containers flag is specified the following + arguments may only be specified after a --container flag. - --remove-volume-mount=[MOUNT_PATH,...] - Removes the volume mounted at the specified path from the current - container. + --add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] + Adds a mount to the current container. Must contain the keys + volume=NAME and mount-path=/PATH where NAME is the name of a volume + on this resource and PATH is the path within the container's + filesystem to mount this volume. + + --args=[ARG,...] + Comma-separated arguments passed to the command run by the + container image. If not specified and no '--command' is provided, + the container image's default Cmd is used. Otherwise, if not + specified, no arguments are passed. To reset this field to its + default, pass an empty string. + + --clear-volume-mounts + Remove all existing mounts from the current container. + + --command=[COMMAND,...] + Entrypoint for the container image. If not specified, the container + image's default Entrypoint is run. To reset this field to its + default, pass an empty string. + + --cpu=CPU + Set a CPU limit in Kubernetes cpu units. + + Cloud Run (fully managed) supports values 1, 2 and 4. For Cloud Run + (fully managed), 4 cpus also requires a minimum 2Gi --memory value. + Examples 2, 2.0, 2000m + + Cloud Run for Anthos and Knative-compatible Kubernetes clusters + support fractional values. Examples .5, 500m, 2 + + --memory=MEMORY + Set a memory limit. Ex: 1024Mi, 4Gi. + + --remove-volume-mount=[MOUNT_PATH,...] + Removes the volume mounted at the specified path from the current + container. + + At most one of these can be specified: + + --clear-env-vars + Remove all environment variables. + + --env-vars-file=FILE_PATH + Path to a local YAML file with definitions for all environment + variables. All existing environment variables will be removed + before the new environment variables are added. Example YAML + content: + + KEY_1: "value1" + KEY_2: "value 2" + + --set-env-vars=[KEY=VALUE,...] + List of key-value pairs to set as environment variables. All + existing environment variables will be removed first. + + Only --update-env-vars and --remove-env-vars can be used together. + If both are specified, --remove-env-vars will be applied first. + + --remove-env-vars=[KEY,...] + List of environment variables to be removed. + + --update-env-vars=[KEY=VALUE,...] + List of key-value pairs to set as environment variables. + + Specify secrets to mount or provide as environment variables. Keys + starting with a forward slash '/' are mount paths. All other keys + correspond to environment variables. Values should be in the form + SECRET_NAME:SECRET_VERSION. For example: + '--update-secrets=/secrets/api/key=mysecret:latest,ENV=othersecret:1' + will mount a volume at '/secrets/api' containing a file 'key' with the + latest version of secret 'mysecret'. An environment variable named ENV + will also be created whose value is version 1 of secret 'othersecret'. + + At most one of these can be specified: + + --clear-secrets + Remove all secrets. + + --set-secrets=[KEY=VALUE,...] + List of key-value pairs to set as secrets. All existing secrets + will be removed first. + + Only --update-secrets and --remove-secrets can be used together. If + both are specified, --remove-secrets will be applied first. + + --remove-secrets=[KEY,...] + List of secrets to be removed. + + --update-secrets=[KEY=VALUE,...] + List of key-value pairs to set as secrets. + + At most one of these can be specified: + + --image=IMAGE + Name of the container image to deploy (e.g. + us-docker.pkg.dev/cloudrun/container/job:latest). + + --source=SOURCE + The location of the source to build. If a Dockerfile is present + in the source code directory, it will be built using that + Dockerfile, otherwise it will use Google Cloud buildpacks. See + https://cloud.google.com/run/docs/deploying-source-code for more + details. The location can be a directory on a local disk or a + gzipped archive file (.tar.gz) in Google Cloud Storage. If the + source is a local directory, this command skips the files + specified in the --ignore-file. If --ignore-file is not + specified, use .gcloudignore file. If a .gcloudignore file is + absent and a .gitignore file is present in the local source + directory, gcloud will use a generated Git-compatible + .gcloudignore file that respects your .gitignored files. The + global .gitignore is not respected. For more information on + .gcloudignore, see gcloud topic gcloudignore. At most one of these can be specified: @@ -248,32 +335,6 @@ FLAGS not set, gcloud exits successfully when the execution has started. Implies --execute-now. - At most one of these can be specified: - - --clear-env-vars - Remove all environment variables. - - --env-vars-file=FILE_PATH - Path to a local YAML file with definitions for all environment - variables. All existing environment variables will be removed before - the new environment variables are added. Example YAML content: - - KEY_1: "value1" - KEY_2: "value 2" - - --set-env-vars=[KEY=VALUE,...] - List of key-value pairs to set as environment variables. All existing - environment variables will be removed first. - - Only --update-env-vars and --remove-env-vars can be used together. If - both are specified, --remove-env-vars will be applied first. - - --remove-env-vars=[KEY,...] - List of environment variables to be removed. - - --update-env-vars=[KEY=VALUE,...] - List of key-value pairs to set as environment variables. - At most one of these can be specified: --clear-network @@ -305,27 +366,6 @@ FLAGS Applies the given Compute Engine tags (comma separated) to the Cloud Run job. To clear existing tags, use --clear-network-tags. - At most one of these can be specified: - - --image=IMAGE - Name of the container image to deploy (e.g. - us-docker.pkg.dev/cloudrun/container/job:latest). - - --source=SOURCE - The location of the source to build. If a Dockerfile is present in - the source code directory, it will be built using that Dockerfile, - otherwise it will use Google Cloud buildpacks. See - https://cloud.google.com/run/docs/deploying-source-code for more - details. The location can be a directory on a local disk or a gzipped - archive file (.tar.gz) in Google Cloud Storage. If the source is a - local directory, this command skips the files specified in the - --ignore-file. If --ignore-file is not specified, use .gcloudignore - file. If a .gcloudignore file is absent and a .gitignore file is - present in the local source directory, gcloud will use a generated - Git-compatible .gcloudignore file that respects your .gitignored - files. The global .gitignore is not respected. For more information - on .gcloudignore, see gcloud topic gcloudignore. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/run/jobs/update b/gcloud/alpha/run/jobs/update index be5d3c317..014d006a6 100644 --- a/gcloud/alpha/run/jobs/update +++ b/gcloud/alpha/run/jobs/update @@ -2,11 +2,10 @@ NAME gcloud alpha run jobs update - update a Cloud Run Job SYNOPSIS - gcloud alpha run jobs update [JOB] [--args=[ARG,...]] - [--breakglass=JUSTIFICATION] [--clear-vpc-connector] - [--command=[COMMAND,...]] [--cpu=CPU] [--image=IMAGE] [--key=KEY] - [--max-retries=MAX_RETRIES] [--memory=MEMORY] - [--parallelism=PARALLELISM] [--region=REGION] + gcloud alpha run jobs update [JOB] [--breakglass=JUSTIFICATION] + [--clear-vpc-connector] [--container=CONTAINER] [--key=KEY] + [--max-retries=MAX_RETRIES] [--parallelism=PARALLELISM] + [--region=REGION] [--remove-containers=[CONTAINER,...]] [--service-account=SERVICE_ACCOUNT] [--task-timeout=TASK_TIMEOUT] [--tasks=TASKS; default=1] [--vpc-connector=VPC_CONNECTOR] [--vpc-egress=VPC_EGRESS] @@ -17,20 +16,21 @@ SYNOPSIS [--add-volume=[KEY=VALUE,...] --clear-volumes --remove-volume=[VOLUME,...]] [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] - --clear-volume-mounts --remove-volume-mount=[MOUNT_PATH,...]] + --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] + --cpu=CPU --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,...] + --update-env-vars=[KEY=VALUE,...] --clear-secrets + | --set-secrets=[KEY=VALUE,...] + | --remove-secrets=[KEY,...] --update-secrets=[KEY=VALUE,...]] [--async | --execute-now --wait] [--binary-authorization=POLICY | --clear-binary-authorization] - [--clear-env-vars | --env-vars-file=FILE_PATH - | --set-env-vars=[KEY=VALUE,...] - | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...] --labels=[KEY=VALUE,...] | --update-labels=[KEY=VALUE,...]] [--clear-network | --network=NETWORK --subnet=SUBNET --clear-network-tags - | --network-tags=[TAG,...]] - [--clear-secrets | --set-secrets=[KEY=VALUE,...] - | --remove-secrets=[KEY,...] --update-secrets=[KEY=VALUE,...]] - [GCLOUD_WIDE_FLAG ...] + | --network-tags=[TAG,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Updates a Cloud Run job. @@ -62,12 +62,6 @@ POSITIONAL ARGUMENTS ▸ specify the job name from an interactive prompt. FLAGS - --args=[ARG,...] - Comma-separated arguments passed to the command run by the container - image. If not specified and no '--command' is provided, the container - image's default Cmd is used. Otherwise, if not specified, no arguments - are passed. To reset this field to its default, pass an empty string. - --breakglass=JUSTIFICATION Justification to bypass Binary Authorization policy constraints and allow the operation. See @@ -78,21 +72,9 @@ FLAGS --clear-vpc-connector Remove the VPC connector for this resource. - --command=[COMMAND,...] - Entrypoint for the container image. If not specified, the container - image's default Entrypoint is run. To reset this field to its default, - pass an empty string. - - --cpu=CPU - Set a CPU limit in Kubernetes cpu units. - - Cloud Run (fully managed) supports values 1, 2 and 4. For Cloud Run - (fully managed), 4 cpus also requires a minimum 2Gi --memory value. - Examples 2, 2.0, 2000m - - --image=IMAGE - Name of the container image to deploy (e.g. - us-docker.pkg.dev/cloudrun/container/job:latest). + --container=CONTAINER + Specifies a container by name. Flags following --container will apply + to the specified container. --key=KEY CMEK key reference to encrypt the container with. @@ -102,9 +84,6 @@ FLAGS being failed permanently. This applies per-task, not per-job. If set to 0, tasks will only run once and never be retried on failure. - --memory=MEMORY - Set a memory limit. Ex: 1024Mi, 4Gi. - --parallelism=PARALLELISM Number of tasks that may run concurrently. Must be less than or equal to the number of tasks. Set to 0 to unset. @@ -113,6 +92,9 @@ FLAGS Region in which the resource can be found. Alternatively, set the property [run/region]. + --remove-containers=[CONTAINER,...] + List of containers to remove. + --service-account=SERVICE_ACCOUNT Service account associated with the revision of the service. The service account represents the identity of the running revision, and @@ -179,7 +161,7 @@ FLAGS --add-volume=[KEY=VALUE,...] Adds a volume to the Cloud Run resource. To add more than one volume, - specify this flag mulitple times. Volumes must have a name and type + specify this flag multiple times. Volumes must have a name and type key. Only certain values are supported for type. Depending on the provided type, other keys will be required. The following types are supported with the specified additional keys: @@ -226,18 +208,106 @@ FLAGS --remove-volume=[VOLUME,...] Removes volumes from the Cloud Run resource. - --add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] - Adds a mount to the current container. Must contain the keys - volume=NAME and mount-path=/PATH where NAME is the name of a volume on - this resource and PATH is the path within the container's filesystem to - mount this volume. + Container Flags - --clear-volume-mounts - Remove all existing mounts from the current container. + If the --container or --remove-containers flag is specified the following + arguments may only be specified after a --container flag. - --remove-volume-mount=[MOUNT_PATH,...] - Removes the volume mounted at the specified path from the current - container. + --add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] + Adds a mount to the current container. Must contain the keys + volume=NAME and mount-path=/PATH where NAME is the name of a volume + on this resource and PATH is the path within the container's + filesystem to mount this volume. + + --args=[ARG,...] + Comma-separated arguments passed to the command run by the + container image. If not specified and no '--command' is provided, + the container image's default Cmd is used. Otherwise, if not + specified, no arguments are passed. To reset this field to its + default, pass an empty string. + + --clear-volume-mounts + Remove all existing mounts from the current container. + + --command=[COMMAND,...] + Entrypoint for the container image. If not specified, the container + image's default Entrypoint is run. To reset this field to its + default, pass an empty string. + + --cpu=CPU + Set a CPU limit in Kubernetes cpu units. + + Cloud Run (fully managed) supports values 1, 2 and 4. For Cloud Run + (fully managed), 4 cpus also requires a minimum 2Gi --memory value. + Examples 2, 2.0, 2000m + + Cloud Run for Anthos and Knative-compatible Kubernetes clusters + support fractional values. Examples .5, 500m, 2 + + --image=IMAGE + Name of the container image to deploy (e.g. + us-docker.pkg.dev/cloudrun/container/job:latest). + + --memory=MEMORY + Set a memory limit. Ex: 1024Mi, 4Gi. + + --remove-volume-mount=[MOUNT_PATH,...] + Removes the volume mounted at the specified path from the current + container. + + At most one of these can be specified: + + --clear-env-vars + Remove all environment variables. + + --env-vars-file=FILE_PATH + Path to a local YAML file with definitions for all environment + variables. All existing environment variables will be removed + before the new environment variables are added. Example YAML + content: + + KEY_1: "value1" + KEY_2: "value 2" + + --set-env-vars=[KEY=VALUE,...] + List of key-value pairs to set as environment variables. All + existing environment variables will be removed first. + + Only --update-env-vars and --remove-env-vars can be used together. + If both are specified, --remove-env-vars will be applied first. + + --remove-env-vars=[KEY,...] + List of environment variables to be removed. + + --update-env-vars=[KEY=VALUE,...] + List of key-value pairs to set as environment variables. + + Specify secrets to mount or provide as environment variables. Keys + starting with a forward slash '/' are mount paths. All other keys + correspond to environment variables. Values should be in the form + SECRET_NAME:SECRET_VERSION. For example: + '--update-secrets=/secrets/api/key=mysecret:latest,ENV=othersecret:1' + will mount a volume at '/secrets/api' containing a file 'key' with the + latest version of secret 'mysecret'. An environment variable named ENV + will also be created whose value is version 1 of secret 'othersecret'. + + At most one of these can be specified: + + --clear-secrets + Remove all secrets. + + --set-secrets=[KEY=VALUE,...] + List of key-value pairs to set as secrets. All existing secrets + will be removed first. + + Only --update-secrets and --remove-secrets can be used together. If + both are specified, --remove-secrets will be applied first. + + --remove-secrets=[KEY,...] + List of secrets to be removed. + + --update-secrets=[KEY=VALUE,...] + List of key-value pairs to set as secrets. At most one of these can be specified: @@ -266,32 +336,6 @@ FLAGS --clear-binary-authorization Remove any previously set Binary Authorization policy. - At most one of these can be specified: - - --clear-env-vars - Remove all environment variables. - - --env-vars-file=FILE_PATH - Path to a local YAML file with definitions for all environment - variables. All existing environment variables will be removed before - the new environment variables are added. Example YAML content: - - KEY_1: "value1" - KEY_2: "value 2" - - --set-env-vars=[KEY=VALUE,...] - List of key-value pairs to set as environment variables. All existing - environment variables will be removed first. - - Only --update-env-vars and --remove-env-vars can be used together. If - both are specified, --remove-env-vars will be applied first. - - --remove-env-vars=[KEY,...] - List of environment variables to be removed. - - --update-env-vars=[KEY=VALUE,...] - List of key-value pairs to set as environment variables. - At most one of these can be specified: --clear-labels @@ -354,33 +398,6 @@ FLAGS Applies the given Compute Engine tags (comma separated) to the Cloud Run job. To clear existing tags, use --clear-network-tags. - Specify secrets to mount or provide as environment variables. Keys - starting with a forward slash '/' are mount paths. All other keys - correspond to environment variables. Values should be in the form - SECRET_NAME:SECRET_VERSION. For example: - '--update-secrets=/secrets/api/key=mysecret:latest,ENV=othersecret:1' will - mount a volume at '/secrets/api' containing a file 'key' with the latest - version of secret 'mysecret'. An environment variable named ENV will also - be created whose value is version 1 of secret 'othersecret'. - - At most one of these can be specified: - - --clear-secrets - Remove all secrets. - - --set-secrets=[KEY=VALUE,...] - List of key-value pairs to set as secrets. All existing secrets will - be removed first. - - Only --update-secrets and --remove-secrets can be used together. If both - are specified, --remove-secrets will be applied first. - - --remove-secrets=[KEY,...] - List of secrets to be removed. - - --update-secrets=[KEY=VALUE,...] - List of key-value pairs to set as secrets. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/run/services/update b/gcloud/alpha/run/services/update index 104bfa563..395e28dcf 100644 --- a/gcloud/alpha/run/services/update +++ b/gcloud/alpha/run/services/update @@ -182,6 +182,8 @@ FLAGS revision by default, run the gcloud run services update-traffic command with --to-latest. + Container Flags + If the --container or --remove-containers flag is specified the following arguments may only be specified after a --container flag. @@ -321,8 +323,9 @@ FLAGS --no-cpu-throttling to disable. --[no-]default-url - toggles the default url for a run service. Use --default-url to - enable and --no-default-url to disable. + Toggles the default url for a run service. This is enabled by default + if not specified. Use --default-url to enable and --no-default-url to + disable. --[no-]deploy-health-check Schedules a single instance of the Revision and waits for it to start @@ -434,7 +437,7 @@ FLAGS --add-volume=[KEY=VALUE,...] Adds a volume to the Cloud Run resource. To add more than one volume, - specify this flag mulitple times. Volumes must have a name and type + specify this flag multiple times. Volumes must have a name and type key. Only certain values are supported for type. Depending on the provided type, other keys will be required. The following types are supported with the specified additional keys: diff --git a/gcloud/alpha/source-manager/help b/gcloud/alpha/source-manager/help new file mode 100644 index 000000000..29a8849d1 --- /dev/null +++ b/gcloud/alpha/source-manager/help @@ -0,0 +1,34 @@ +NAME + gcloud alpha source-manager - manage Secure Source Manager resources + +SYNOPSIS + gcloud alpha source-manager GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Secure Source Manager resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + instances + (ALPHA) Manage Secure Source Manager instances. + + locations + (ALPHA) Manage Secure Source Manager locations. + + operations + (ALPHA) Manage Secure Source Manager operations. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta source-manager + diff --git a/gcloud/alpha/source-manager/instances/add-iam-policy-binding b/gcloud/alpha/source-manager/instances/add-iam-policy-binding new file mode 100644 index 000000000..4a6ddc735 --- /dev/null +++ b/gcloud/alpha/source-manager/instances/add-iam-policy-binding @@ -0,0 +1,97 @@ +NAME + gcloud alpha source-manager instances add-iam-policy-binding - add an IAM + policy binding to a Secure Source Manager instance + +SYNOPSIS + gcloud alpha source-manager instances add-iam-policy-binding + (INSTANCE : --region=REGION) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Add an IAM policy binding to a Secure Source Manager instance. + +EXAMPLES + To add an IAM policy binding for the role of 'roles/editor' for the user + 'test-user@gmail.com' with instance named 'my-instance' and location + 'us-central1', run: + + $ gcloud alpha source-manager instances add-iam-policy-binding \ + my-instance --region='us-central1' \ + --member='user:test-user@gmail.com' --role='roles/editor' + + See https://cloud.google.com/iam/docs/managing-policies for details of + policy role and member types. + +POSITIONAL ARGUMENTS + Instance resource - The instance for which to add the IAM policy binding. + 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 instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to add the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + Role name to assign to the principal. The role name is the complete + path of a predefined role, such as roles/logging.viewer, or the role ID + for a custom role, such as + organizations/{ORGANIZATION_ID}/roles/logging.viewer. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta source-manager instances add-iam-policy-binding + diff --git a/gcloud/alpha/source-manager/instances/create b/gcloud/alpha/source-manager/instances/create new file mode 100644 index 000000000..73470dd87 --- /dev/null +++ b/gcloud/alpha/source-manager/instances/create @@ -0,0 +1,94 @@ +NAME + gcloud alpha source-manager instances create - create a Secure Source + Manager instance + +SYNOPSIS + gcloud alpha source-manager instances create (INSTANCE : --region=REGION) + [--async] [--ca-pool=CA_POOL] [--is-private] [--kms-key=KMS_KEY] + [--max-wait=MAX_WAIT; default="60m"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a Secure Source Manager instance. + +EXAMPLES + To create a Secure Source Manager instance named 'my-instance' in location + 'us-central1' asynchronously, run: + + $ gcloud alpha source-manager instances create my-instance \ + --region=us-central1 + + To create a Secure Source Manager instance named 'my-instance' in location + 'us-central1' synchronously, and wait a maximum of 30 minutes for it to + finish being created, run: + + $ gcloud alpha source-manager instances create my-instance \ + --region=us-central1 --no-async --max-wait=30m + +POSITIONAL ARGUMENTS + Instance resource - The Secure Source Manager instance to create. 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 instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --ca-pool=CA_POOL + CA Pool path for private instance. + + --is-private + Bool indicator for private instance. + + --kms-key=KMS_KEY + KMS key used to encrypt instance optionally. + + --max-wait=MAX_WAIT; default="60m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + +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 command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta source-manager instances create + diff --git a/gcloud/alpha/source-manager/instances/delete b/gcloud/alpha/source-manager/instances/delete new file mode 100644 index 000000000..f10fffe2c --- /dev/null +++ b/gcloud/alpha/source-manager/instances/delete @@ -0,0 +1,84 @@ +NAME + gcloud alpha source-manager instances delete - delete a Secure Source + Manager instance + +SYNOPSIS + gcloud alpha source-manager instances delete (INSTANCE : --region=REGION) + [--async] [--max-wait=MAX_WAIT; default="60m"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a Secure Source Manager instance. + +EXAMPLES + To delete a Secure Source Manager instance named 'my-instance' in location + 'us-central1' asynchronously, run: + + $ gcloud alpha source-manager instances delete my-instance \ + --region=us-central1 + + To delete a Secure Source Manager instance named 'my-instance' in location + 'us-central1' synchronously, and wait a maximum of 30 minutes for it to + finish being deleted, run: + + $ gcloud alpha source-manager instances delete my-instance \ + --region=us-central1 --no-async --max-wait=30m + +POSITIONAL ARGUMENTS + Instance resource - The Secure Source Manager instance to delete. 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 instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --max-wait=MAX_WAIT; default="60m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + +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 command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta source-manager instances delete + diff --git a/gcloud/alpha/source-manager/instances/describe b/gcloud/alpha/source-manager/instances/describe new file mode 100644 index 000000000..89fc191ce --- /dev/null +++ b/gcloud/alpha/source-manager/instances/describe @@ -0,0 +1,70 @@ +NAME + gcloud alpha source-manager instances describe - describe a Secure Source + Manager instance + +SYNOPSIS + gcloud alpha source-manager instances describe (INSTANCE : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get details of a Secure Source Manager instance. + +EXAMPLES + To describe a Secure Source Manager instance named 'my-instance' in + location 'us-central1' under the current project, run: + + $ gcloud alpha source-manager instances describe my-instance \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Instance resource - The instance you want to describe. 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 instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta source-manager instances describe + diff --git a/gcloud/alpha/source-manager/instances/get-iam-policy b/gcloud/alpha/source-manager/instances/get-iam-policy new file mode 100644 index 000000000..6c849943c --- /dev/null +++ b/gcloud/alpha/source-manager/instances/get-iam-policy @@ -0,0 +1,97 @@ +NAME + gcloud alpha source-manager instances get-iam-policy - get the IAM policy + for a Secure Source Manager instance + +SYNOPSIS + gcloud alpha source-manager instances get-iam-policy + (INSTANCE : --region=REGION) [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get the IAM policy for a Secure Source Manager instance. + +EXAMPLES + To get the IAM policy for an instance named 'my-instance' in location + 'us-central1', run: + + $ gcloud alpha source-manager instances get-iam-policy my-instance \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Instance resource - The Secure Source Manager instance for which to get + the IAM policy. 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 instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta source-manager instances get-iam-policy + diff --git a/gcloud/alpha/source-manager/instances/help b/gcloud/alpha/source-manager/instances/help new file mode 100644 index 000000000..2a207d7dc --- /dev/null +++ b/gcloud/alpha/source-manager/instances/help @@ -0,0 +1,51 @@ +NAME + gcloud alpha source-manager instances - manage Secure Source Manager + instances + +SYNOPSIS + gcloud alpha source-manager instances COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Secure Source Manager instances. + +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 + (ALPHA) Add an IAM policy binding to a Secure Source Manager instance. + + create + (ALPHA) Create a Secure Source Manager instance. + + delete + (ALPHA) Delete a Secure Source Manager instance. + + describe + (ALPHA) Describe a Secure Source Manager instance. + + get-iam-policy + (ALPHA) Get the IAM policy for a Secure Source Manager instance. + + list + (ALPHA) List Secure Source Manager instances. + + remove-iam-policy-binding + (ALPHA) Remove an IAM policy binding to a Secure Source Manager + instance. + + set-iam-policy + (ALPHA) Set the IAM policy for a Secure Source Manager instance. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta source-manager instances + diff --git a/gcloud/alpha/source-manager/instances/list b/gcloud/alpha/source-manager/instances/list new file mode 100644 index 000000000..7d439b166 --- /dev/null +++ b/gcloud/alpha/source-manager/instances/list @@ -0,0 +1,90 @@ +NAME + gcloud alpha source-manager instances list - list Secure Source Manager + instances + +SYNOPSIS + gcloud alpha source-manager instances list --region=REGION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List all instances on your Secure Source Manager. + +EXAMPLES + To list all Secure Source Manager instances in location 'us-central1' under + the current project, run: + + $ gcloud alpha source-manager instances list --region=us-central1 + +REQUIRED FLAGS + Location resource - The location you want to list the instances for. 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; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --region=REGION + ID of the location or fully qualified identifier for the location. + + To set the region attribute: + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta source-manager instances list + diff --git a/gcloud/alpha/source-manager/instances/remove-iam-policy-binding b/gcloud/alpha/source-manager/instances/remove-iam-policy-binding new file mode 100644 index 000000000..a359a5aaa --- /dev/null +++ b/gcloud/alpha/source-manager/instances/remove-iam-policy-binding @@ -0,0 +1,98 @@ +NAME + gcloud alpha source-manager instances remove-iam-policy-binding - remove an + IAM policy binding to a Secure Source Manager instance + +SYNOPSIS + gcloud alpha source-manager instances remove-iam-policy-binding + (INSTANCE : --region=REGION) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Remove an IAM policy binding to a Secure Source Manager instance. + +EXAMPLES + To remove an IAM policy binding for the role of 'roles/editor' for the user + 'test-user@gmail.com' with instance named 'my-instance' and location + 'us-central1', run: + + $ gcloud alpha source-manager instances remove-iam-policy-binding \ + my-instance --region='us-central1' \ + --member='user:test-user@gmail.com' --role='roles/editor' + + See https://cloud.google.com/iam/docs/managing-policies for details of + policy role and member types. + +POSITIONAL ARGUMENTS + Instance resource - The instance for which to remove the IAM policy + binding. 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 instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to remove the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Deleted principals have an additional deleted: prefix and a ?uid=UID + suffix, where UID is a unique identifier for the principal. Example: + deleted:user:test-user@gmail.com?uid=123456789012345678901. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + The role to remove the principal from. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta source-manager instances remove-iam-policy-binding + diff --git a/gcloud/alpha/source-manager/instances/set-iam-policy b/gcloud/alpha/source-manager/instances/set-iam-policy new file mode 100644 index 000000000..f66e77445 --- /dev/null +++ b/gcloud/alpha/source-manager/instances/set-iam-policy @@ -0,0 +1,77 @@ +NAME + gcloud alpha source-manager instances set-iam-policy - set the IAM policy + for a Secure Source Manager instance + +SYNOPSIS + gcloud alpha source-manager instances set-iam-policy + (INSTANCE : --region=REGION) POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Set the IAM policy for a Secure Source Manager instance. + +EXAMPLES + To set the IAM policy for an instance named 'my-instance' in location + 'us-central' to content of policy.json , run: + + $ gcloud alpha source-manager instances set-iam-policy my-instance \ + --region=us-central1 policy.json + +POSITIONAL ARGUMENTS + Instance resource - The Secure Source Manager instance for which to set + the IAM policy. 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 instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta source-manager instances set-iam-policy + diff --git a/gcloud/alpha/source-manager/locations/help b/gcloud/alpha/source-manager/locations/help new file mode 100644 index 000000000..4e75c3c47 --- /dev/null +++ b/gcloud/alpha/source-manager/locations/help @@ -0,0 +1,29 @@ +NAME + gcloud alpha source-manager locations - manage Secure Source Manager + locations + +SYNOPSIS + gcloud alpha source-manager locations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Secure Source Manager locations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + (ALPHA) List Secure Source Manager locations. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta source-manager locations + diff --git a/gcloud/alpha/source-manager/locations/list b/gcloud/alpha/source-manager/locations/list new file mode 100644 index 000000000..60343eb11 --- /dev/null +++ b/gcloud/alpha/source-manager/locations/list @@ -0,0 +1,71 @@ +NAME + gcloud alpha source-manager locations list - list Secure Source Manager + locations + +SYNOPSIS + gcloud alpha source-manager locations list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List all locations where Secure Source Manager is available. + +EXAMPLES + To list all locations where Secure Source Manager is available for the + current project, run: + + $ gcloud alpha source-manager locations list + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta source-manager locations list + diff --git a/gcloud/alpha/source-manager/operations/describe b/gcloud/alpha/source-manager/operations/describe new file mode 100644 index 000000000..5016666ee --- /dev/null +++ b/gcloud/alpha/source-manager/operations/describe @@ -0,0 +1,70 @@ +NAME + gcloud alpha source-manager operations describe - describe a Secure Source + Manager operation + +SYNOPSIS + gcloud alpha source-manager operations describe + (OPERATION : --region=REGION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get details of a Secure Source Manager operation. + +EXAMPLES + To describe a Secure Source Manager operation named 'my-operation' in + location 'us-central1' under the current project, run: + + $ gcloud alpha source-manager operations describe my-operation \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Operation resource - The operation you want to describe. 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 operation 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. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta source-manager operations describe + diff --git a/gcloud/alpha/source-manager/operations/help b/gcloud/alpha/source-manager/operations/help new file mode 100644 index 000000000..114639d6d --- /dev/null +++ b/gcloud/alpha/source-manager/operations/help @@ -0,0 +1,32 @@ +NAME + gcloud alpha source-manager operations - manage Secure Source Manager + operations + +SYNOPSIS + gcloud alpha source-manager operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Secure Source Manager operations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Describe a Secure Source Manager operation. + + list + (ALPHA) List Secure Source Manager operations. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta source-manager operations + diff --git a/gcloud/alpha/source-manager/operations/list b/gcloud/alpha/source-manager/operations/list new file mode 100644 index 000000000..d6809c7ec --- /dev/null +++ b/gcloud/alpha/source-manager/operations/list @@ -0,0 +1,90 @@ +NAME + gcloud alpha source-manager operations list - list Secure Source Manager + operations + +SYNOPSIS + gcloud alpha source-manager operations list --region=REGION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List all Secure Source Manager operations. + +EXAMPLES + To list all Secure Source Manager operations in location 'us-central1' + under the current project, run: + + $ gcloud alpha source-manager operations list --region=us-central1 + +REQUIRED FLAGS + Location resource - The location you want to list the operations for. 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; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --region=REGION + ID of the location or fully qualified identifier for the location. + + To set the region attribute: + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta source-manager operations list + diff --git a/gcloud/alpha/workstations/clusters/list b/gcloud/alpha/workstations/clusters/list index d7854014a..dd0da14e6 100644 --- a/gcloud/alpha/workstations/clusters/list +++ b/gcloud/alpha/workstations/clusters/list @@ -2,7 +2,7 @@ NAME gcloud alpha workstations clusters list - list workstation clusters SYNOPSIS - gcloud alpha workstations clusters list --region=REGION + gcloud alpha workstations clusters list [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -15,7 +15,7 @@ EXAMPLES $ gcloud alpha workstations clusters list -REQUIRED FLAGS +FLAGS Region resource - The region of the clusters to display. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. @@ -23,16 +23,18 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --region on the command line with a fully specified name; + ◆ set the property workstations/region with a fully specified name; + ◆ default is all regions with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - --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. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region; + ▸ default is all regions . LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/workstations/configs/create b/gcloud/alpha/workstations/configs/create index 97739d373..578a034c3 100644 --- a/gcloud/alpha/workstations/configs/create +++ b/gcloud/alpha/workstations/configs/create @@ -11,9 +11,9 @@ SYNOPSIS [--container-env=[CONTAINER_ENV,...]] [--container-run-as-user=CONTAINER_RUN_AS_USER] [--container-working-dir=CONTAINER_WORKING_DIR] - [--disable-public-ip-addresses] [--disable-tcp-connections] - [--enable-audit-agent] [--enable-confidential-compute] - [--enable-nested-virtualization] + [--disable-public-ip-addresses] [--disable-ssh-to-vm] + [--disable-tcp-connections] [--enable-audit-agent] + [--enable-confidential-compute] [--enable-nested-virtualization] [--idle-timeout=IDLE_TIMEOUT; default=7200] [--labels=[LABELS,...]] [--machine-type=MACHINE_TYPE; default="e2-standard-4"] [--network-tags=[NETWORK_TAGS,...]] @@ -90,7 +90,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/cluster. --region=REGION - The location for the config. + The region for the config. To set the region attribute: ▸ provide the argument config on the command line with a fully @@ -140,6 +140,10 @@ FLAGS Default value is false. If set, instances will have no public IP address. + --disable-ssh-to-vm + Default value is False. If set, workstations will disable SSH + connections to the root VM. + --disable-tcp-connections Default value is false. If set, workstations will not allow plain TCP connections. diff --git a/gcloud/alpha/workstations/configs/list b/gcloud/alpha/workstations/configs/list index 2d8e19339..097c80b32 100644 --- a/gcloud/alpha/workstations/configs/list +++ b/gcloud/alpha/workstations/configs/list @@ -2,10 +2,9 @@ NAME gcloud alpha workstations configs list - list workstation configurations SYNOPSIS - gcloud alpha workstations configs list - (--cluster=CLUSTER : --region=REGION) [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] - [GCLOUD_WIDE_FLAG ...] + gcloud alpha workstations configs list [--cluster=CLUSTER --region=REGION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) List all workstation configurations under the specified cluster. @@ -15,7 +14,7 @@ EXAMPLES $ gcloud alpha workstations configs list -REQUIRED FLAGS +FLAGS Cluster resource - The cluster of the configurations to display. 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 @@ -24,19 +23,18 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --cluster on the command line with a fully specified name; + ◆ set the property workstations/cluster with a fully specified name; + ◆ default is all clusters with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - --cluster=CLUSTER ID of the cluster or fully qualified identifier for the cluster. To set the cluster attribute: - ▸ provide the argument --cluster on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster; + ▸ default is all clusters . --region=REGION The name of the region of the cluster. @@ -44,8 +42,12 @@ REQUIRED FLAGS To set the region attribute: ▸ provide the argument --cluster on the command line with a fully specified name; + ▸ set the property workstations/cluster with a fully specified + name; + ▸ default is all clusters with a fully specified name; ▸ provide the argument --region on the command line; - ▸ set the property workstations/region. + ▸ set the property workstations/region; + ▸ default is all regions . LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/workstations/configs/update b/gcloud/alpha/workstations/configs/update index 2499da4c3..50fd1c83e 100644 --- a/gcloud/alpha/workstations/configs/update +++ b/gcloud/alpha/workstations/configs/update @@ -24,6 +24,7 @@ SYNOPSIS : --accelerator-type=ACCELERATOR_TYPE] [--container-custom-image=CONTAINER_CUSTOM_IMAGE | --container-predefined-image=CONTAINER_PREDEFINED_IMAGE] + [--disable-ssh-to-vm | --enable-ssh-to-vm] [--disable-tcp-connections | --enable-tcp-connections] [GCLOUD_WIDE_FLAG ...] @@ -78,7 +79,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/cluster. --region=REGION - The location for the config. + The region for the config. To set the region attribute: ▸ provide the argument config on the command line with a fully @@ -244,6 +245,16 @@ FLAGS webstorm WebStorm + At most one of these can be specified: + + --disable-ssh-to-vm + Default value is False. If set, workstations will enable SSH + connections to the root VM. + + --enable-ssh-to-vm + Default value is False. If set, workstations will enable SSH + connections to the root VM. + At most one of these can be specified: --disable-tcp-connections diff --git a/gcloud/alpha/workstations/list b/gcloud/alpha/workstations/list index 7ecef47ac..2c94d56e5 100644 --- a/gcloud/alpha/workstations/list +++ b/gcloud/alpha/workstations/list @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud alpha workstations list - (--config=CONFIG : --cluster=CLUSTER --region=REGION) + [--cluster=CLUSTER --config=CONFIG --region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -15,7 +15,7 @@ EXAMPLES $ gcloud alpha workstations list -REQUIRED FLAGS +FLAGS Config resource - The configuration of the workstations to display. 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 @@ -24,28 +24,30 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --config on the command line with a fully specified name; + ◆ set the property workstations/config with a fully specified name; + ◆ default is all configs with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - - --config=CONFIG - ID of the config or fully qualified identifier for the config. - - To set the config attribute: - ▸ provide the argument --config on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - --cluster=CLUSTER The name of the cluster containing the config. To set the cluster attribute: ▸ provide the argument --config on the command line with a fully specified name; + ▸ set the property workstations/config with a fully specified name; + ▸ default is all configs with a fully specified name; ▸ provide the argument --cluster on the command line; - ▸ set the property workstations/cluster. + ▸ set the property workstations/cluster; + ▸ default is all clusters . + + --config=CONFIG + ID of the config or fully qualified identifier for the config. + + To set the config attribute: + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config; + ▸ default is all configs . --region=REGION The name of the region of the config. @@ -53,8 +55,11 @@ REQUIRED FLAGS To set the region attribute: ▸ provide the argument --config on the command line with a fully specified name; + ▸ set the property workstations/config with a fully specified name; + ▸ default is all configs with a fully specified name; ▸ provide the argument --region on the command line; - ▸ set the property workstations/region. + ▸ set the property workstations/region; + ▸ default is all regions . LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/workstations/list-usable b/gcloud/alpha/workstations/list-usable index 030ac3eb0..70246939c 100644 --- a/gcloud/alpha/workstations/list-usable +++ b/gcloud/alpha/workstations/list-usable @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud alpha workstations list-usable - (--config=CONFIG : --cluster=CLUSTER --region=REGION) + [--cluster=CLUSTER --config=CONFIG --region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -15,7 +15,7 @@ EXAMPLES $ gcloud alpha workstations list-usable -REQUIRED FLAGS +FLAGS Config resource - The group of arguments defining a config 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 @@ -24,37 +24,38 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --config on the command line with a fully specified name; + ◆ default is all configs with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - - --config=CONFIG - ID of the config or fully qualified identifier for the config. - - To set the config attribute: - ▸ provide the argument --config on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - --cluster=CLUSTER The cluster for the config. To set the cluster attribute: ▸ provide the argument --config on the command line with a fully specified name; + ▸ default is all configs with a fully specified name; ▸ provide the argument --cluster on the command line; - ▸ set the property workstations/cluster. + ▸ set the property workstations/cluster; + ▸ default is all clusters. + + --config=CONFIG + ID of the config or fully qualified identifier for the config. + + To set the config attribute: + ▸ provide the argument --config on the command line; + ▸ default is all configs. --region=REGION - The location for the config. + The region for the config. To set the region attribute: ▸ provide the argument --config on the command line with a fully specified name; + ▸ default is all configs with a fully specified name; ▸ provide the argument --region on the command line; - ▸ set the property workstations/region. + ▸ set the property workstations/region; + ▸ default is all regions. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/workstations/ssh b/gcloud/alpha/workstations/ssh index 735521a88..d5c65078e 100644 --- a/gcloud/alpha/workstations/ssh +++ b/gcloud/alpha/workstations/ssh @@ -71,7 +71,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/config. --region=REGION - The location for the workstation. + The region for the workstation. To set the region attribute: ▸ provide the argument workstation on the command line with a fully diff --git a/gcloud/alpha/workstations/start b/gcloud/alpha/workstations/start index e6977384f..de4900a53 100644 --- a/gcloud/alpha/workstations/start +++ b/gcloud/alpha/workstations/start @@ -57,7 +57,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/config. --region=REGION - The location for the workstation. + The region for the workstation. To set the region attribute: ▸ provide the argument workstation on the command line with a fully diff --git a/gcloud/alpha/workstations/start-tcp-tunnel b/gcloud/alpha/workstations/start-tcp-tunnel index 663c0e0c4..81432bb00 100644 --- a/gcloud/alpha/workstations/start-tcp-tunnel +++ b/gcloud/alpha/workstations/start-tcp-tunnel @@ -63,7 +63,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/config. --region=REGION - The location for the workstation. + The region for the workstation. To set the region attribute: ▸ provide the argument workstation on the command line with a fully diff --git a/gcloud/alpha/workstations/stop b/gcloud/alpha/workstations/stop index a488f163c..b4ef6e50a 100644 --- a/gcloud/alpha/workstations/stop +++ b/gcloud/alpha/workstations/stop @@ -57,7 +57,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/config. --region=REGION - The location for the workstation. + The region for the workstation. To set the region attribute: ▸ provide the argument workstation on the command line with a fully diff --git a/gcloud/auth/application-default/login b/gcloud/auth/application-default/login index ef5c75c95..fb8432233 100644 --- a/gcloud/auth/application-default/login +++ b/gcloud/auth/application-default/login @@ -3,7 +3,7 @@ NAME for Application Default Credentials SYNOPSIS - gcloud auth application-default login [--no-browser] + gcloud auth application-default login [ACCOUNT] [--no-browser] [--client-id-file=CLIENT_ID_FILE] [--disable-quota-project] [--no-launch-browser] [--login-config=LOGIN_CONFIG] [--scopes=SCOPE,[SCOPE,...]] [GCLOUD_WIDE_FLAG ...] @@ -43,6 +43,14 @@ EXAMPLES $ gcloud auth application-default login \ --client-id-file=clientid.json +POSITIONAL ARGUMENTS + [ACCOUNT] + User account used for authorization. When the account specified has + valid credentials in the local credential store these credentials will + be re-used. Otherwise new ones will be fetched and replace any stored + credential. This caching behavior is only available for user + credentials. + FLAGS --no-browser If you want to authorize the client libraries on a machine that doesn't diff --git a/gcloud/beta/auth/application-default/login b/gcloud/beta/auth/application-default/login index 4fa62263a..e12975f8b 100644 --- a/gcloud/beta/auth/application-default/login +++ b/gcloud/beta/auth/application-default/login @@ -3,7 +3,7 @@ NAME to use for Application Default Credentials SYNOPSIS - gcloud beta auth application-default login [--no-browser] + gcloud beta auth application-default login [ACCOUNT] [--no-browser] [--client-id-file=CLIENT_ID_FILE] [--disable-quota-project] [--no-launch-browser] [--login-config=LOGIN_CONFIG] [--scopes=SCOPE,[SCOPE,...]] [GCLOUD_WIDE_FLAG ...] @@ -43,6 +43,14 @@ EXAMPLES $ gcloud beta auth application-default login \ --client-id-file=clientid.json +POSITIONAL ARGUMENTS + [ACCOUNT] + User account used for authorization. When the account specified has + valid credentials in the local credential store these credentials will + be re-used. Otherwise new ones will be fetched and replace any stored + credential. This caching behavior is only available for user + credentials. + FLAGS --no-browser If you want to authorize the client libraries on a machine that doesn't diff --git a/gcloud/beta/compute/interconnects/attachments/partner/create b/gcloud/beta/compute/interconnects/attachments/partner/create index e2e7662d1..c5f6c19e6 100644 --- a/gcloud/beta/compute/interconnects/attachments/partner/create +++ b/gcloud/beta/compute/interconnects/attachments/partner/create @@ -7,7 +7,7 @@ SYNOPSIS --edge-availability-domain=AVAILABILITY_DOMAIN --router=ROUTER [--description=DESCRIPTION] [--enable-admin] [--encryption=ENCRYPTION] [--ipsec-internal-addresses=[ADDRESSES]] [--mtu=MTU] [--region=REGION] - [GCLOUD_WIDE_FLAG ...] + [--stack-type=STACK_TYPE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute interconnects attachments partner create is used @@ -111,6 +111,15 @@ OPTIONAL FLAGS Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION. + --stack-type=STACK_TYPE + The stack type of the protocol(s) enabled on this interconnect + attachment. STACK_TYPE must be one of: + + IPV4_IPV6 + Both IPv4 and IPv6 protocols are enabled on this attachment. + IPV4_ONLY + Only IPv4 protocol is enabled on this attachment. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/compute/interconnects/attachments/partner/update b/gcloud/beta/compute/interconnects/attachments/partner/update index d1cebc63c..705773938 100644 --- a/gcloud/beta/compute/interconnects/attachments/partner/update +++ b/gcloud/beta/compute/interconnects/attachments/partner/update @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud beta compute interconnects attachments partner update NAME [--description=DESCRIPTION] [--enable-admin] [--mtu=MTU] - [--region=REGION] [--update-labels=[KEY=VALUE,...]] + [--region=REGION] [--stack-type=STACK_TYPE] + [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -52,6 +53,15 @@ FLAGS Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION. + --stack-type=STACK_TYPE + The stack type of the protocol(s) enabled on this interconnect + attachment. STACK_TYPE must be one of: + + IPV4_IPV6 + Both IPv4 and IPv6 protocols are enabled on this attachment. + IPV4_ONLY + Only IPv4 protocol is enabled on this attachment. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/beta/metastore/services/restore b/gcloud/beta/metastore/services/restore index 59bf32ee3..10fd6d96a 100644 --- a/gcloud/beta/metastore/services/restore +++ b/gcloud/beta/metastore/services/restore @@ -4,12 +4,13 @@ NAME SYNOPSIS gcloud beta metastore services restore (SERVICE : --location=LOCATION) - --backup=BACKUP [--async] + (--backup=BACKUP | --backup-location=BACKUP_LOCATION) [--async] [--restore-type=RESTORE_TYPE; default="metadata-only"] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Restore a Dataproc Metastore service from the given backup. + (BETA) Restore a Dataproc Metastore service from the given backup or + backup-location If run asynchronously with --async, exits after printing an operation name that can be used to poll the status of the creation via: @@ -23,6 +24,12 @@ EXAMPLES $ gcloud beta metastore services restore my-service \ --backup=my-backup --restore-type=full + To restore a Dataproc Metastore service with the name my-service from the + backup-location gs://gcs_bucket with a FULL restore type, run: + + $ gcloud beta metastore services restore my-service \ + --backup-location=gs://gcs_bucket --restore-type=full + POSITIONAL ARGUMENTS Service resource - Arguments and flags that specify the Dataproc Metastore service you want to restore. The arguments in this group can be used to @@ -58,10 +65,20 @@ POSITIONAL ARGUMENTS ▸ set the property metastore/location. REQUIRED FLAGS - --backup=BACKUP - The backup resource to restore from. This can be the backup's ID, - fully-qualified URL, or relative name in the form - projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}. + The backup resource or the location of the backup artifacts to store from. + + Exactly one of these must be specified: + + --backup=BACKUP + The backup resource to restore from. This can be the backup's ID, + fully-qualified URL, or relative name in the form + projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}. + + --backup-location=BACKUP_LOCATION + The location of the backup artifacts to restore from. This should be + a Cloud Storage URI, contains backup avro files under "avro/", + backup_metastore.json and service.json, in the form + gs://. OPTIONAL FLAGS --async diff --git a/gcloud/beta/notebooks/instances/create b/gcloud/beta/notebooks/instances/create index 6b71067e6..ea163fd97 100644 --- a/gcloud/beta/notebooks/instances/create +++ b/gcloud/beta/notebooks/instances/create @@ -3,23 +3,24 @@ NAME SYNOPSIS gcloud beta notebooks instances create (INSTANCE : --location=LOCATION) - ([--container-repository=CONTAINER_REPOSITORY - : --container-tag=CONTAINER_TAG] | [--environment=ENVIRONMENT - : --environment-location=ENVIRONMENT_LOCATION] - | [(--vm-image-family=VM_IMAGE_FAMILY; default="common-cpu" - | --vm-image-name=VM_IMAGE_NAME) - : --vm-image-project=VM_IMAGE_PROJECT; - default="deeplearning-platform-release"]) [--async] - [--instance-owners=INSTANCE_OWNERS] [--labels=[KEY=VALUE,...]] + [--async] [--instance-owners=INSTANCE_OWNERS] + [--labels=[KEY=VALUE,...]] [--machine-type=MACHINE_TYPE; default="n1-standard-1"] [--metadata=[KEY=VALUE,...]] [--post-startup-script=POST_STARTUP_SCRIPT] [--service-account=SERVICE_ACCOUNT] [--no-shielded-integrity-monitoring] [--shielded-secure-boot] - [--no-shielded-vtpm] + [--no-shielded-vtpm] [--tags=[TAGS,...]] [--accelerator-core-count=ACCELERATOR_CORE_COUNT --accelerator-type=ACCELERATOR_TYPE] [--boot-disk-size=BOOT_DISK_SIZE --boot-disk-type=BOOT_DISK_TYPE] + [[--container-repository=CONTAINER_REPOSITORY + : --container-tag=CONTAINER_TAG] | [--environment=ENVIRONMENT + : --environment-location=ENVIRONMENT_LOCATION] + | --vm-image-project=VM_IMAGE_PROJECT; + default="deeplearning-platform-release" + --vm-image-family=VM_IMAGE_FAMILY; default="common-cpu" + | --vm-image-name=VM_IMAGE_NAME] [--custom-gpu-driver-path=CUSTOM_GPU_DRIVER_PATH --install-gpu-driver] [--data-disk-size=DATA_DISK_SIZE --data-disk-type=DATA_DISK_TYPE --no-remove-data-disk] @@ -101,8 +102,86 @@ POSITIONAL ARGUMENTS ▸ provide the argument --location on the command line; ▸ set the property notebooks/location. -REQUIRED FLAGS - Exactly one of these must be specified: +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --instance-owners=INSTANCE_OWNERS + The owners of this instance after creation. Format:alias@example.com. + Currently supports one owner only.If not specified, all of the service + account users of the VM instance's service account can use the + instance. + + --labels=[KEY=VALUE,...] + Labels to apply to this instance. These can be later modified by the + setLabels method. + + --machine-type=MACHINE_TYPE; default="n1-standard-1" + The Compute Engine machine type + (https://cloud.google.com/sdk/gcloud/reference/compute/machine-types) + of this instance. + + --metadata=[KEY=VALUE,...] + Custom metadata to apply to this instance. + + For example, to specify a Cloud Storage bucket for automatic backup, + you can use the gcs-data-bucket metadata tag. Format: + "--metadata=gcs-data-bucket=BUCKET". + + --post-startup-script=POST_STARTUP_SCRIPT + Path to a Bash script that automatically runs after a notebook instance + fully boots up. The path must be a URL or Cloud Storage path + (gs://path-to-file/file-name). + + --service-account=SERVICE_ACCOUNT + The service account on this instance, giving access to other Google + Cloud services. You can use any service account within the same + project, but you must have the service account user permission to use + the instance. If not specified, the Compute Engine default service + account is used. + + --shielded-integrity-monitoring + Enable monitoring of the boot integrity of the instance. Enabled by + default, use --no-shielded-integrity-monitoring to disable. + + --shielded-secure-boot + Boot instance with secure boot enabled. Disabled by default. + + --shielded-vtpm + Boot instance with TPM (Trusted Platform Module) enabled. Enabled by + default, use --no-shielded-vtpm to disable. + + --tags=[TAGS,...] + Tags to apply to this instance. + + The hardware accelerator used on this instance. If you use accelerators, + make sure that your configuration has enough vCPUs and memory to support + the `machine_type` you have selected. + + --accelerator-core-count=ACCELERATOR_CORE_COUNT + Count of cores of this accelerator. + + --accelerator-type=ACCELERATOR_TYPE + Type of this accelerator. ACCELERATOR_TYPE must be one of: + NVIDIA_TESLA_A100, NVIDIA_TESLA_K80, NVIDIA_TESLA_P100, + NVIDIA_TESLA_V100, NVIDIA_TESLA_P4, NVIDIA_TESLA_T4, + NVIDIA_TESLA_T4_VWS, NVIDIA_TESLA_P100_VWS, NVIDIA_TESLA_P4_VWS, + TPU_V2, TPU_V3. + + Boot disk configurations. + + --boot-disk-size=BOOT_DISK_SIZE + Size of boot disk in GB attached to this instance, up to a maximum of + 64000 GB (64 TB). The minimum recommended value is 100 GB. If not + specified, this defaults to 100. + + --boot-disk-type=BOOT_DISK_TYPE + Type of boot disk attached to this instance, defaults to standard + persistent disk (PD_STANDARD). BOOT_DISK_TYPE must be one of: + PD_STANDARD, PD_SSD, PD_BALANCED, PD_EXTREME. + + At most one of these can be specified: --container-repository=CONTAINER_REPOSITORY The path to the container image repository. For example: @@ -155,7 +234,7 @@ REQUIRED FLAGS The ID of the Google Cloud project that this VM image belongs to. Format: projects/{project_id}. - Exactly one of these must be specified: + At most one of these can be specified: --vm-image-family=VM_IMAGE_FAMILY; default="common-cpu" Use this VM image family to find the image; the newest image in @@ -164,82 +243,6 @@ REQUIRED FLAGS --vm-image-name=VM_IMAGE_NAME Use this VM image name to find the image. -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --instance-owners=INSTANCE_OWNERS - The owners of this instance after creation. Format:alias@example.com. - Currently supports one owner only.If not specified, all of the service - account users of the VM instance's service account can use the - instance. - - --labels=[KEY=VALUE,...] - Labels to apply to this instance. These can be later modified by the - setLabels method. - - --machine-type=MACHINE_TYPE; default="n1-standard-1" - The Compute Engine machine type - (https://cloud.google.com/sdk/gcloud/reference/compute/machine-types) - of this instance. - - --metadata=[KEY=VALUE,...] - Custom metadata to apply to this instance. - - For example, to specify a Cloud Storage bucket for automatic backup, - you can use the gcs-data-bucket metadata tag. Format: - "--metadata=gcs-data-bucket=BUCKET". - - --post-startup-script=POST_STARTUP_SCRIPT - Path to a Bash script that automatically runs after a notebook instance - fully boots up. The path must be a URL or Cloud Storage path - (gs://path-to-file/file-name). - - --service-account=SERVICE_ACCOUNT - The service account on this instance, giving access to other Google - Cloud services. You can use any service account within the same - project, but you must have the service account user permission to use - the instance. If not specified, the Compute Engine default service - account is used. - - --shielded-integrity-monitoring - Enable monitoring of the boot integrity of the instance. Enabled by - default, use --no-shielded-integrity-monitoring to disable. - - --shielded-secure-boot - Boot instance with secure boot enabled. Disabled by default. - - --shielded-vtpm - Boot instance with TPM (Trusted Platform Module) enabled. Enabled by - default, use --no-shielded-vtpm to disable. - - The hardware accelerator used on this instance. If you use accelerators, - make sure that your configuration has enough vCPUs and memory to support - the `machine_type` you have selected. - - --accelerator-core-count=ACCELERATOR_CORE_COUNT - Count of cores of this accelerator. - - --accelerator-type=ACCELERATOR_TYPE - Type of this accelerator. ACCELERATOR_TYPE must be one of: - NVIDIA_TESLA_A100, NVIDIA_TESLA_K80, NVIDIA_TESLA_P100, - NVIDIA_TESLA_V100, NVIDIA_TESLA_P4, NVIDIA_TESLA_T4, - NVIDIA_TESLA_T4_VWS, NVIDIA_TESLA_P100_VWS, NVIDIA_TESLA_P4_VWS, - TPU_V2, TPU_V3. - - Boot disk configurations. - - --boot-disk-size=BOOT_DISK_SIZE - Size of boot disk in GB attached to this instance, up to a maximum of - 64000 GB (64 TB). The minimum recommended value is 100 GB. If not - specified, this defaults to 100. - - --boot-disk-type=BOOT_DISK_TYPE - Type of boot disk attached to this instance, defaults to standard - persistent disk (PD_STANDARD). BOOT_DISK_TYPE must be one of: - PD_STANDARD, PD_SSD, PD_BALANCED, PD_EXTREME. - GPU driver configurations. --custom-gpu-driver-path=CUSTOM_GPU_DRIVER_PATH diff --git a/gcloud/beta/run/deploy b/gcloud/beta/run/deploy index 7ad9d0ff3..3da6ac8f9 100644 --- a/gcloud/beta/run/deploy +++ b/gcloud/beta/run/deploy @@ -25,7 +25,7 @@ SYNOPSIS --update-config-maps=[KEY=VALUE,...]] [--[no-]allow-unauthenticated --breakglass=JUSTIFICATION --clear-vpc-connector --[no-]cpu-boost --[no-]cpu-throttling - --description=DESCRIPTION + --[no-]default-url --description=DESCRIPTION --execution-environment=EXECUTION_ENVIRONMENT --remove-containers=[CONTAINER,...] --revision-suffix=REVISION_SUFFIX --[no-]session-affinity --vpc-connector=VPC_CONNECTOR @@ -434,6 +434,11 @@ FLAGS serving requests. Use --cpu-throttling to enable and --no-cpu-throttling to disable. + --[no-]default-url + Toggles the default url for a run service. This is enabled by default + if not specified. Use --default-url to enable and --no-default-url to + disable. + --description=DESCRIPTION Provides an optional, human-readable description of the service. @@ -526,7 +531,7 @@ FLAGS --add-volume=[KEY=VALUE,...] Adds a volume to the Cloud Run resource. To add more than one volume, - specify this flag mulitple times. Volumes must have a name and type + specify this flag multiple times. Volumes must have a name and type key. Only certain values are supported for type. Depending on the provided type, other keys will be required. The following types are supported with the specified additional keys: diff --git a/gcloud/beta/run/jobs/deploy b/gcloud/beta/run/jobs/deploy index 389677f4c..37a38262e 100644 --- a/gcloud/beta/run/jobs/deploy +++ b/gcloud/beta/run/jobs/deploy @@ -169,7 +169,7 @@ FLAGS --add-volume=[KEY=VALUE,...] Adds a volume to the Cloud Run resource. To add more than one volume, - specify this flag mulitple times. Volumes must have a name and type + specify this flag multiple times. Volumes must have a name and type key. Only certain values are supported for type. Depending on the provided type, other keys will be required. The following types are supported with the specified additional keys: diff --git a/gcloud/beta/run/jobs/update b/gcloud/beta/run/jobs/update index a7eedcf5f..11603473f 100644 --- a/gcloud/beta/run/jobs/update +++ b/gcloud/beta/run/jobs/update @@ -179,7 +179,7 @@ FLAGS --add-volume=[KEY=VALUE,...] Adds a volume to the Cloud Run resource. To add more than one volume, - specify this flag mulitple times. Volumes must have a name and type + specify this flag multiple times. Volumes must have a name and type key. Only certain values are supported for type. Depending on the provided type, other keys will be required. The following types are supported with the specified additional keys: diff --git a/gcloud/beta/run/services/update b/gcloud/beta/run/services/update index 081818198..2054e58fe 100644 --- a/gcloud/beta/run/services/update +++ b/gcloud/beta/run/services/update @@ -20,7 +20,8 @@ SYNOPSIS | --set-secrets=[KEY=VALUE,...] | --remove-secrets=[KEY,...] --update-secrets=[KEY=VALUE,...]] [--breakglass=JUSTIFICATION --clear-vpc-connector --[no-]cpu-boost - --[no-]cpu-throttling --execution-environment=EXECUTION_ENVIRONMENT + --[no-]cpu-throttling --[no-]default-url + --execution-environment=EXECUTION_ENVIRONMENT --remove-containers=[CONTAINER,...] --revision-suffix=REVISION_SUFFIX --[no-]session-affinity --vpc-connector=VPC_CONNECTOR --vpc-egress=VPC_EGRESS @@ -179,6 +180,8 @@ FLAGS revision by default, run the gcloud run services update-traffic command with --to-latest. + Container Flags + If the --container or --remove-containers flag is specified the following arguments may only be specified after a --container flag. @@ -317,6 +320,11 @@ FLAGS serving requests. Use --cpu-throttling to enable and --no-cpu-throttling to disable. + --[no-]default-url + Toggles the default url for a run service. This is enabled by default + if not specified. Use --default-url to enable and --no-default-url to + disable. + --execution-environment=EXECUTION_ENVIRONMENT Selects the execution environment where the application will run. EXECUTION_ENVIRONMENT must be one of: @@ -406,7 +414,7 @@ FLAGS --add-volume=[KEY=VALUE,...] Adds a volume to the Cloud Run resource. To add more than one volume, - specify this flag mulitple times. Volumes must have a name and type + specify this flag multiple times. Volumes must have a name and type key. Only certain values are supported for type. Depending on the provided type, other keys will be required. The following types are supported with the specified additional keys: diff --git a/gcloud/beta/source-manager/help b/gcloud/beta/source-manager/help new file mode 100644 index 000000000..c8bf31a43 --- /dev/null +++ b/gcloud/beta/source-manager/help @@ -0,0 +1,32 @@ +NAME + gcloud beta source-manager - manage Secure Source Manager resources + +SYNOPSIS + gcloud beta source-manager GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Secure Source Manager resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + instances + (BETA) Manage Secure Source Manager instances. + + locations + (BETA) Manage Secure Source Manager locations. + + operations + (BETA) Manage Secure Source Manager operations. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager + diff --git a/gcloud/beta/source-manager/instances/add-iam-policy-binding b/gcloud/beta/source-manager/instances/add-iam-policy-binding new file mode 100644 index 000000000..bb3efb396 --- /dev/null +++ b/gcloud/beta/source-manager/instances/add-iam-policy-binding @@ -0,0 +1,95 @@ +NAME + gcloud beta source-manager instances add-iam-policy-binding - add an IAM + policy binding to a Secure Source Manager instance + +SYNOPSIS + gcloud beta source-manager instances add-iam-policy-binding + (INSTANCE : --region=REGION) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Add an IAM policy binding to a Secure Source Manager instance. + +EXAMPLES + To add an IAM policy binding for the role of 'roles/editor' for the user + 'test-user@gmail.com' with instance named 'my-instance' and location + 'us-central1', run: + + $ gcloud beta source-manager instances add-iam-policy-binding \ + my-instance --region='us-central1' \ + --member='user:test-user@gmail.com' --role='roles/editor' + + See https://cloud.google.com/iam/docs/managing-policies for details of + policy role and member types. + +POSITIONAL ARGUMENTS + Instance resource - The instance for which to add the IAM policy binding. + 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 instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to add the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + Role name to assign to the principal. The role name is the complete + path of a predefined role, such as roles/logging.viewer, or the role ID + for a custom role, such as + organizations/{ORGANIZATION_ID}/roles/logging.viewer. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager instances add-iam-policy-binding + diff --git a/gcloud/beta/source-manager/instances/create b/gcloud/beta/source-manager/instances/create new file mode 100644 index 000000000..533989e8e --- /dev/null +++ b/gcloud/beta/source-manager/instances/create @@ -0,0 +1,92 @@ +NAME + gcloud beta source-manager instances create - create a Secure Source + Manager instance + +SYNOPSIS + gcloud beta source-manager instances create (INSTANCE : --region=REGION) + [--async] [--ca-pool=CA_POOL] [--is-private] [--kms-key=KMS_KEY] + [--max-wait=MAX_WAIT; default="60m"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a Secure Source Manager instance. + +EXAMPLES + To create a Secure Source Manager instance named 'my-instance' in location + 'us-central1' asynchronously, run: + + $ gcloud beta source-manager instances create my-instance \ + --region=us-central1 + + To create a Secure Source Manager instance named 'my-instance' in location + 'us-central1' synchronously, and wait a maximum of 30 minutes for it to + finish being created, run: + + $ gcloud beta source-manager instances create my-instance \ + --region=us-central1 --no-async --max-wait=30m + +POSITIONAL ARGUMENTS + Instance resource - The Secure Source Manager instance to create. 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 instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --ca-pool=CA_POOL + CA Pool path for private instance. + + --is-private + Bool indicator for private instance. + + --kms-key=KMS_KEY + KMS key used to encrypt instance optionally. + + --max-wait=MAX_WAIT; default="60m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + +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 command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager instances create + diff --git a/gcloud/beta/source-manager/instances/delete b/gcloud/beta/source-manager/instances/delete new file mode 100644 index 000000000..63608aba6 --- /dev/null +++ b/gcloud/beta/source-manager/instances/delete @@ -0,0 +1,82 @@ +NAME + gcloud beta source-manager instances delete - delete a Secure Source + Manager instance + +SYNOPSIS + gcloud beta source-manager instances delete (INSTANCE : --region=REGION) + [--async] [--max-wait=MAX_WAIT; default="60m"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a Secure Source Manager instance. + +EXAMPLES + To delete a Secure Source Manager instance named 'my-instance' in location + 'us-central1' asynchronously, run: + + $ gcloud beta source-manager instances delete my-instance \ + --region=us-central1 + + To delete a Secure Source Manager instance named 'my-instance' in location + 'us-central1' synchronously, and wait a maximum of 30 minutes for it to + finish being deleted, run: + + $ gcloud beta source-manager instances delete my-instance \ + --region=us-central1 --no-async --max-wait=30m + +POSITIONAL ARGUMENTS + Instance resource - The Secure Source Manager instance to delete. 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 instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --max-wait=MAX_WAIT; default="60m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + +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 command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager instances delete + diff --git a/gcloud/beta/source-manager/instances/describe b/gcloud/beta/source-manager/instances/describe new file mode 100644 index 000000000..97d874c98 --- /dev/null +++ b/gcloud/beta/source-manager/instances/describe @@ -0,0 +1,68 @@ +NAME + gcloud beta source-manager instances describe - describe a Secure Source + Manager instance + +SYNOPSIS + gcloud beta source-manager instances describe (INSTANCE : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get details of a Secure Source Manager instance. + +EXAMPLES + To describe a Secure Source Manager instance named 'my-instance' in + location 'us-central1' under the current project, run: + + $ gcloud beta source-manager instances describe my-instance \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Instance resource - The instance you want to describe. 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 instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager instances describe + diff --git a/gcloud/beta/source-manager/instances/get-iam-policy b/gcloud/beta/source-manager/instances/get-iam-policy new file mode 100644 index 000000000..8d35e9ff0 --- /dev/null +++ b/gcloud/beta/source-manager/instances/get-iam-policy @@ -0,0 +1,95 @@ +NAME + gcloud beta source-manager instances get-iam-policy - get the IAM policy + for a Secure Source Manager instance + +SYNOPSIS + gcloud beta source-manager instances get-iam-policy + (INSTANCE : --region=REGION) [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get the IAM policy for a Secure Source Manager instance. + +EXAMPLES + To get the IAM policy for an instance named 'my-instance' in location + 'us-central1', run: + + $ gcloud beta source-manager instances get-iam-policy my-instance \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Instance resource - The Secure Source Manager instance for which to get + the IAM policy. 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 instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager instances get-iam-policy + diff --git a/gcloud/beta/source-manager/instances/help b/gcloud/beta/source-manager/instances/help new file mode 100644 index 000000000..baa3e27a3 --- /dev/null +++ b/gcloud/beta/source-manager/instances/help @@ -0,0 +1,49 @@ +NAME + gcloud beta source-manager instances - manage Secure Source Manager + instances + +SYNOPSIS + gcloud beta source-manager instances COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Secure Source Manager instances. + +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 + (BETA) Add an IAM policy binding to a Secure Source Manager instance. + + create + (BETA) Create a Secure Source Manager instance. + + delete + (BETA) Delete a Secure Source Manager instance. + + describe + (BETA) Describe a Secure Source Manager instance. + + get-iam-policy + (BETA) Get the IAM policy for a Secure Source Manager instance. + + list + (BETA) List Secure Source Manager instances. + + remove-iam-policy-binding + (BETA) Remove an IAM policy binding to a Secure Source Manager + instance. + + set-iam-policy + (BETA) Set the IAM policy for a Secure Source Manager instance. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager instances + diff --git a/gcloud/beta/source-manager/instances/list b/gcloud/beta/source-manager/instances/list new file mode 100644 index 000000000..d22ff7c87 --- /dev/null +++ b/gcloud/beta/source-manager/instances/list @@ -0,0 +1,88 @@ +NAME + gcloud beta source-manager instances list - list Secure Source Manager + instances + +SYNOPSIS + gcloud beta source-manager instances list --region=REGION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List all instances on your Secure Source Manager. + +EXAMPLES + To list all Secure Source Manager instances in location 'us-central1' under + the current project, run: + + $ gcloud beta source-manager instances list --region=us-central1 + +REQUIRED FLAGS + Location resource - The location you want to list the instances for. 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; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --region=REGION + ID of the location or fully qualified identifier for the location. + + To set the region attribute: + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager instances list + diff --git a/gcloud/beta/source-manager/instances/remove-iam-policy-binding b/gcloud/beta/source-manager/instances/remove-iam-policy-binding new file mode 100644 index 000000000..8817f12c3 --- /dev/null +++ b/gcloud/beta/source-manager/instances/remove-iam-policy-binding @@ -0,0 +1,96 @@ +NAME + gcloud beta source-manager instances remove-iam-policy-binding - remove an + IAM policy binding to a Secure Source Manager instance + +SYNOPSIS + gcloud beta source-manager instances remove-iam-policy-binding + (INSTANCE : --region=REGION) --member=PRINCIPAL --role=ROLE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Remove an IAM policy binding to a Secure Source Manager instance. + +EXAMPLES + To remove an IAM policy binding for the role of 'roles/editor' for the user + 'test-user@gmail.com' with instance named 'my-instance' and location + 'us-central1', run: + + $ gcloud beta source-manager instances remove-iam-policy-binding \ + my-instance --region='us-central1' \ + --member='user:test-user@gmail.com' --role='roles/editor' + + See https://cloud.google.com/iam/docs/managing-policies for details of + policy role and member types. + +POSITIONAL ARGUMENTS + Instance resource - The instance for which to remove the IAM policy + binding. 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 instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to remove the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Deleted principals have an additional deleted: prefix and a ?uid=UID + suffix, where UID is a unique identifier for the principal. Example: + deleted:user:test-user@gmail.com?uid=123456789012345678901. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + The role to remove the principal from. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager instances remove-iam-policy-binding + diff --git a/gcloud/beta/source-manager/instances/set-iam-policy b/gcloud/beta/source-manager/instances/set-iam-policy new file mode 100644 index 000000000..0dbc88f88 --- /dev/null +++ b/gcloud/beta/source-manager/instances/set-iam-policy @@ -0,0 +1,75 @@ +NAME + gcloud beta source-manager instances set-iam-policy - set the IAM policy + for a Secure Source Manager instance + +SYNOPSIS + gcloud beta source-manager instances set-iam-policy + (INSTANCE : --region=REGION) POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Set the IAM policy for a Secure Source Manager instance. + +EXAMPLES + To set the IAM policy for an instance named 'my-instance' in location + 'us-central' to content of policy.json , run: + + $ gcloud beta source-manager instances set-iam-policy my-instance \ + --region=us-central1 policy.json + +POSITIONAL ARGUMENTS + Instance resource - The Secure Source Manager instance for which to set + the IAM policy. 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 instance 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. + + INSTANCE + ID of the instance or fully qualified identifier for the instance. + + To set the instance attribute: + ▸ provide the argument instance on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument instance on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager instances set-iam-policy + diff --git a/gcloud/beta/source-manager/locations/help b/gcloud/beta/source-manager/locations/help new file mode 100644 index 000000000..2b76a92c0 --- /dev/null +++ b/gcloud/beta/source-manager/locations/help @@ -0,0 +1,27 @@ +NAME + gcloud beta source-manager locations - manage Secure Source Manager + locations + +SYNOPSIS + gcloud beta source-manager locations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Secure Source Manager locations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + (BETA) List Secure Source Manager locations. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager locations + diff --git a/gcloud/beta/source-manager/locations/list b/gcloud/beta/source-manager/locations/list new file mode 100644 index 000000000..fa3d1a697 --- /dev/null +++ b/gcloud/beta/source-manager/locations/list @@ -0,0 +1,69 @@ +NAME + gcloud beta source-manager locations list - list Secure Source Manager + locations + +SYNOPSIS + gcloud beta source-manager locations list [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List all locations where Secure Source Manager is available. + +EXAMPLES + To list all locations where Secure Source Manager is available for the + current project, run: + + $ gcloud beta source-manager locations list + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager locations list + diff --git a/gcloud/beta/source-manager/operations/describe b/gcloud/beta/source-manager/operations/describe new file mode 100644 index 000000000..8d2a1c2e4 --- /dev/null +++ b/gcloud/beta/source-manager/operations/describe @@ -0,0 +1,68 @@ +NAME + gcloud beta source-manager operations describe - describe a Secure Source + Manager operation + +SYNOPSIS + gcloud beta source-manager operations describe + (OPERATION : --region=REGION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get details of a Secure Source Manager operation. + +EXAMPLES + To describe a Secure Source Manager operation named 'my-operation' in + location 'us-central1' under the current project, run: + + $ gcloud beta source-manager operations describe my-operation \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Operation resource - The operation you want to describe. 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 operation 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. + + OPERATION + ID of the operation or fully qualified identifier for the operation. + + To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --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. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager operations describe + diff --git a/gcloud/beta/source-manager/operations/help b/gcloud/beta/source-manager/operations/help new file mode 100644 index 000000000..56f688bd2 --- /dev/null +++ b/gcloud/beta/source-manager/operations/help @@ -0,0 +1,30 @@ +NAME + gcloud beta source-manager operations - manage Secure Source Manager + operations + +SYNOPSIS + gcloud beta source-manager operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Secure Source Manager operations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Describe a Secure Source Manager operation. + + list + (BETA) List Secure Source Manager operations. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager operations + diff --git a/gcloud/beta/source-manager/operations/list b/gcloud/beta/source-manager/operations/list new file mode 100644 index 000000000..34341daf9 --- /dev/null +++ b/gcloud/beta/source-manager/operations/list @@ -0,0 +1,88 @@ +NAME + gcloud beta source-manager operations list - list Secure Source Manager + operations + +SYNOPSIS + gcloud beta source-manager operations list --region=REGION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List all Secure Source Manager operations. + +EXAMPLES + To list all Secure Source Manager operations in location 'us-central1' + under the current project, run: + + $ gcloud beta source-manager operations list --region=us-central1 + +REQUIRED FLAGS + Location resource - The location you want to list the operations for. 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; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --region=REGION + ID of the location or fully qualified identifier for the location. + + To set the region attribute: + ▸ provide the argument --region on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the securesourcemanager/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/secure-source-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha source-manager operations list + diff --git a/gcloud/beta/workstations/clusters/list b/gcloud/beta/workstations/clusters/list index e4de5a3f5..28cf0d677 100644 --- a/gcloud/beta/workstations/clusters/list +++ b/gcloud/beta/workstations/clusters/list @@ -2,7 +2,7 @@ NAME gcloud beta workstations clusters list - list workstation clusters SYNOPSIS - gcloud beta workstations clusters list --region=REGION + gcloud beta workstations clusters list [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -15,7 +15,7 @@ EXAMPLES $ gcloud beta workstations clusters list -REQUIRED FLAGS +FLAGS Region resource - The region of the clusters to display. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. @@ -23,16 +23,18 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --region on the command line with a fully specified name; + ◆ set the property workstations/region with a fully specified name; + ◆ default is all regions with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - --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. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region; + ▸ default is all regions . LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/workstations/configs/create b/gcloud/beta/workstations/configs/create index 8498f50c2..d28c4963c 100644 --- a/gcloud/beta/workstations/configs/create +++ b/gcloud/beta/workstations/configs/create @@ -11,9 +11,9 @@ SYNOPSIS [--container-env=[CONTAINER_ENV,...]] [--container-run-as-user=CONTAINER_RUN_AS_USER] [--container-working-dir=CONTAINER_WORKING_DIR] - [--disable-public-ip-addresses] [--disable-tcp-connections] - [--enable-audit-agent] [--enable-confidential-compute] - [--enable-nested-virtualization] + [--disable-public-ip-addresses] [--disable-ssh-to-vm] + [--disable-tcp-connections] [--enable-audit-agent] + [--enable-confidential-compute] [--enable-nested-virtualization] [--idle-timeout=IDLE_TIMEOUT; default=7200] [--labels=[LABELS,...]] [--machine-type=MACHINE_TYPE; default="e2-standard-4"] [--network-tags=[NETWORK_TAGS,...]] @@ -90,7 +90,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/cluster. --region=REGION - The location for the config. + The region for the config. To set the region attribute: ▸ provide the argument config on the command line with a fully @@ -140,6 +140,10 @@ FLAGS Default value is false. If set, instances will have no public IP address. + --disable-ssh-to-vm + Default value is False. If set, workstations will disable SSH + connections to the root VM. + --disable-tcp-connections Default value is false. If set, workstations will not allow plain TCP connections. diff --git a/gcloud/beta/workstations/configs/list b/gcloud/beta/workstations/configs/list index 8652c8dcf..b51f1bbee 100644 --- a/gcloud/beta/workstations/configs/list +++ b/gcloud/beta/workstations/configs/list @@ -2,7 +2,7 @@ NAME gcloud beta workstations configs list - list workstation configurations SYNOPSIS - gcloud beta workstations configs list (--cluster=CLUSTER : --region=REGION) + gcloud beta workstations configs list [--cluster=CLUSTER --region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -14,7 +14,7 @@ EXAMPLES $ gcloud beta workstations configs list -REQUIRED FLAGS +FLAGS Cluster resource - The cluster of the configurations to display. 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 @@ -23,19 +23,18 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --cluster on the command line with a fully specified name; + ◆ set the property workstations/cluster with a fully specified name; + ◆ default is all clusters with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - --cluster=CLUSTER ID of the cluster or fully qualified identifier for the cluster. To set the cluster attribute: - ▸ provide the argument --cluster on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster; + ▸ default is all clusters . --region=REGION The name of the region of the cluster. @@ -43,8 +42,12 @@ REQUIRED FLAGS To set the region attribute: ▸ provide the argument --cluster on the command line with a fully specified name; + ▸ set the property workstations/cluster with a fully specified + name; + ▸ default is all clusters with a fully specified name; ▸ provide the argument --region on the command line; - ▸ set the property workstations/region. + ▸ set the property workstations/region; + ▸ default is all regions . LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/workstations/configs/update b/gcloud/beta/workstations/configs/update index 16c9050aa..c89d21593 100644 --- a/gcloud/beta/workstations/configs/update +++ b/gcloud/beta/workstations/configs/update @@ -24,6 +24,7 @@ SYNOPSIS : --accelerator-type=ACCELERATOR_TYPE] [--container-custom-image=CONTAINER_CUSTOM_IMAGE | --container-predefined-image=CONTAINER_PREDEFINED_IMAGE] + [--disable-ssh-to-vm | --enable-ssh-to-vm] [--disable-tcp-connections | --enable-tcp-connections] [GCLOUD_WIDE_FLAG ...] @@ -78,7 +79,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/cluster. --region=REGION - The location for the config. + The region for the config. To set the region attribute: ▸ provide the argument config on the command line with a fully @@ -244,6 +245,16 @@ FLAGS webstorm WebStorm + At most one of these can be specified: + + --disable-ssh-to-vm + Default value is False. If set, workstations will enable SSH + connections to the root VM. + + --enable-ssh-to-vm + Default value is False. If set, workstations will enable SSH + connections to the root VM. + At most one of these can be specified: --disable-tcp-connections diff --git a/gcloud/beta/workstations/list b/gcloud/beta/workstations/list index df619f2e7..b10a0802b 100644 --- a/gcloud/beta/workstations/list +++ b/gcloud/beta/workstations/list @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud beta workstations list - (--config=CONFIG : --cluster=CLUSTER --region=REGION) + [--cluster=CLUSTER --config=CONFIG --region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -15,7 +15,7 @@ EXAMPLES $ gcloud beta workstations list -REQUIRED FLAGS +FLAGS Config resource - The configuration of the workstations to display. 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 @@ -24,28 +24,30 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --config on the command line with a fully specified name; + ◆ set the property workstations/config with a fully specified name; + ◆ default is all configs with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - - --config=CONFIG - ID of the config or fully qualified identifier for the config. - - To set the config attribute: - ▸ provide the argument --config on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - --cluster=CLUSTER The name of the cluster containing the config. To set the cluster attribute: ▸ provide the argument --config on the command line with a fully specified name; + ▸ set the property workstations/config with a fully specified name; + ▸ default is all configs with a fully specified name; ▸ provide the argument --cluster on the command line; - ▸ set the property workstations/cluster. + ▸ set the property workstations/cluster; + ▸ default is all clusters . + + --config=CONFIG + ID of the config or fully qualified identifier for the config. + + To set the config attribute: + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config; + ▸ default is all configs . --region=REGION The name of the region of the config. @@ -53,8 +55,11 @@ REQUIRED FLAGS To set the region attribute: ▸ provide the argument --config on the command line with a fully specified name; + ▸ set the property workstations/config with a fully specified name; + ▸ default is all configs with a fully specified name; ▸ provide the argument --region on the command line; - ▸ set the property workstations/region. + ▸ set the property workstations/region; + ▸ default is all regions . LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/workstations/list-usable b/gcloud/beta/workstations/list-usable index 424201380..9271c1670 100644 --- a/gcloud/beta/workstations/list-usable +++ b/gcloud/beta/workstations/list-usable @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud beta workstations list-usable - (--config=CONFIG : --cluster=CLUSTER --region=REGION) + [--cluster=CLUSTER --config=CONFIG --region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -15,7 +15,7 @@ EXAMPLES $ gcloud beta workstations list-usable -REQUIRED FLAGS +FLAGS Config resource - The group of arguments defining a config 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 @@ -24,37 +24,38 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --config on the command line with a fully specified name; + ◆ default is all configs with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - - --config=CONFIG - ID of the config or fully qualified identifier for the config. - - To set the config attribute: - ▸ provide the argument --config on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - --cluster=CLUSTER The cluster for the config. To set the cluster attribute: ▸ provide the argument --config on the command line with a fully specified name; + ▸ default is all configs with a fully specified name; ▸ provide the argument --cluster on the command line; - ▸ set the property workstations/cluster. + ▸ set the property workstations/cluster; + ▸ default is all clusters. + + --config=CONFIG + ID of the config or fully qualified identifier for the config. + + To set the config attribute: + ▸ provide the argument --config on the command line; + ▸ default is all configs. --region=REGION - The location for the config. + The region for the config. To set the region attribute: ▸ provide the argument --config on the command line with a fully specified name; + ▸ default is all configs with a fully specified name; ▸ provide the argument --region on the command line; - ▸ set the property workstations/region. + ▸ set the property workstations/region; + ▸ default is all regions. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/workstations/ssh b/gcloud/beta/workstations/ssh index 792c3eb03..93ad9893f 100644 --- a/gcloud/beta/workstations/ssh +++ b/gcloud/beta/workstations/ssh @@ -71,7 +71,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/config. --region=REGION - The location for the workstation. + The region for the workstation. To set the region attribute: ▸ provide the argument workstation on the command line with a fully diff --git a/gcloud/beta/workstations/start b/gcloud/beta/workstations/start index 4d934ce24..512fa2150 100644 --- a/gcloud/beta/workstations/start +++ b/gcloud/beta/workstations/start @@ -57,7 +57,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/config. --region=REGION - The location for the workstation. + The region for the workstation. To set the region attribute: ▸ provide the argument workstation on the command line with a fully diff --git a/gcloud/beta/workstations/start-tcp-tunnel b/gcloud/beta/workstations/start-tcp-tunnel index 1cd4b8e4b..930b77d28 100644 --- a/gcloud/beta/workstations/start-tcp-tunnel +++ b/gcloud/beta/workstations/start-tcp-tunnel @@ -63,7 +63,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/config. --region=REGION - The location for the workstation. + The region for the workstation. To set the region attribute: ▸ provide the argument workstation on the command line with a fully diff --git a/gcloud/beta/workstations/stop b/gcloud/beta/workstations/stop index 349d75205..0fce0e3eb 100644 --- a/gcloud/beta/workstations/stop +++ b/gcloud/beta/workstations/stop @@ -57,7 +57,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/config. --region=REGION - The location for the workstation. + The region for the workstation. To set the region attribute: ▸ provide the argument workstation on the command line with a fully diff --git a/gcloud/bms/os-images/describe b/gcloud/bms/os-images/describe new file mode 100644 index 000000000..22a29d5cb --- /dev/null +++ b/gcloud/bms/os-images/describe @@ -0,0 +1,60 @@ +NAME + gcloud bms os-images describe - describe Bare Metal Solution OS images in a + project + +SYNOPSIS + gcloud bms os-images describe (OS_IMAGE : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe Bare Metal Solution OS image in a project. + +EXAMPLES + To describe given OS image within the project, run: + + $ gcloud bms os-images describe my-os-image --project=my-project + +POSITIONAL ARGUMENTS + Os image resource - os_image. 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 os_image on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + OS_IMAGE + ID of the os_image or fully qualified identifier for the os_image. + + To set the os_image attribute: + ▸ provide the argument os_image on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Region of the resource. + + To set the region attribute: + ▸ provide the argument os_image on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ global is the only supported location. + +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 alpha bms os-images describe + diff --git a/gcloud/bms/os-images/help b/gcloud/bms/os-images/help index be6c31976..f9d778c4e 100644 --- a/gcloud/bms/os-images/help +++ b/gcloud/bms/os-images/help @@ -15,6 +15,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + describe + Describe Bare Metal Solution OS images in a project. + list List Bare Metal Solution OS images in a project. diff --git a/gcloud/compute/tpus/tpu-vm/create b/gcloud/compute/tpus/tpu-vm/create index 550872b6a..4d97b4ac0 100644 --- a/gcloud/compute/tpus/tpu-vm/create +++ b/gcloud/compute/tpus/tpu-vm/create @@ -9,7 +9,8 @@ SYNOPSIS [--network=NETWORK; default="default"] [--preemptible] [--queue-count=QUEUE_COUNT] [--range=RANGE] [--reserved] [--scopes=[SCOPES,...]] [--service-account=SERVICE_ACCOUNT] - [--shielded-secure-boot] [--subnetwork=SUBNETWORK] [--tags=[TAGS,...]] + [--shielded-secure-boot] [--spot] [--subnetwork=SUBNETWORK] + [--tags=[TAGS,...]] [--accelerator-type=ACCELERATOR_TYPE; default="v2-8" | --topology=TOPOLOGY --type=TYPE] [GCLOUD_WIDE_FLAG ...] @@ -170,6 +171,13 @@ OPTIONAL FLAGS Specifies that the TPU instances are created with secure boot enabled. This implicitly makes them Shielded VM instances. + --spot + If specified, create this VM as a spot VM. Spot VMs make unused + capacity available at highly discounted rates. Spot VMs may be + preempted at any time if the capacity is needed, but unless preempted + there is no limit on runtime duration. Spot VM TPUs cannot be + restarted, and must be recreated again. + --subnetwork=SUBNETWORK Subnetwork that this TPU will be a part of. diff --git a/gcloud/notebooks/instances/create b/gcloud/notebooks/instances/create index 311a19aaf..e0c01692f 100644 --- a/gcloud/notebooks/instances/create +++ b/gcloud/notebooks/instances/create @@ -3,23 +3,24 @@ NAME SYNOPSIS gcloud notebooks instances create (INSTANCE : --location=LOCATION) - ([--container-repository=CONTAINER_REPOSITORY - : --container-tag=CONTAINER_TAG] | [--environment=ENVIRONMENT - : --environment-location=ENVIRONMENT_LOCATION] - | [(--vm-image-family=VM_IMAGE_FAMILY; default="common-cpu" - | --vm-image-name=VM_IMAGE_NAME) - : --vm-image-project=VM_IMAGE_PROJECT; - default="deeplearning-platform-release"]) [--async] - [--instance-owners=INSTANCE_OWNERS] [--labels=[KEY=VALUE,...]] + [--async] [--instance-owners=INSTANCE_OWNERS] + [--labels=[KEY=VALUE,...]] [--machine-type=MACHINE_TYPE; default="n1-standard-1"] [--metadata=[KEY=VALUE,...]] [--post-startup-script=POST_STARTUP_SCRIPT] [--service-account=SERVICE_ACCOUNT] [--no-shielded-integrity-monitoring] [--shielded-secure-boot] - [--no-shielded-vtpm] + [--no-shielded-vtpm] [--tags=[TAGS,...]] [--accelerator-core-count=ACCELERATOR_CORE_COUNT --accelerator-type=ACCELERATOR_TYPE] [--boot-disk-size=BOOT_DISK_SIZE --boot-disk-type=BOOT_DISK_TYPE] + [[--container-repository=CONTAINER_REPOSITORY + : --container-tag=CONTAINER_TAG] | [--environment=ENVIRONMENT + : --environment-location=ENVIRONMENT_LOCATION] + | --vm-image-project=VM_IMAGE_PROJECT; + default="deeplearning-platform-release" + --vm-image-family=VM_IMAGE_FAMILY; default="common-cpu" + | --vm-image-name=VM_IMAGE_NAME] [--custom-gpu-driver-path=CUSTOM_GPU_DRIVER_PATH --install-gpu-driver] [--data-disk-size=DATA_DISK_SIZE --data-disk-type=DATA_DISK_TYPE --no-remove-data-disk] @@ -98,8 +99,86 @@ POSITIONAL ARGUMENTS ▸ provide the argument --location on the command line; ▸ set the property notebooks/location. -REQUIRED FLAGS - Exactly one of these must be specified: +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --instance-owners=INSTANCE_OWNERS + The owners of this instance after creation. Format:alias@example.com. + Currently supports one owner only.If not specified, all of the service + account users of the VM instance's service account can use the + instance. + + --labels=[KEY=VALUE,...] + Labels to apply to this instance. These can be later modified by the + setLabels method. + + --machine-type=MACHINE_TYPE; default="n1-standard-1" + The Compute Engine machine type + (https://cloud.google.com/sdk/gcloud/reference/compute/machine-types) + of this instance. + + --metadata=[KEY=VALUE,...] + Custom metadata to apply to this instance. + + For example, to specify a Cloud Storage bucket for automatic backup, + you can use the gcs-data-bucket metadata tag. Format: + "--metadata=gcs-data-bucket=BUCKET". + + --post-startup-script=POST_STARTUP_SCRIPT + Path to a Bash script that automatically runs after a notebook instance + fully boots up. The path must be a URL or Cloud Storage path + (gs://path-to-file/file-name). + + --service-account=SERVICE_ACCOUNT + The service account on this instance, giving access to other Google + Cloud services. You can use any service account within the same + project, but you must have the service account user permission to use + the instance. If not specified, the Compute Engine default service + account is used. + + --shielded-integrity-monitoring + Enable monitoring of the boot integrity of the instance. Enabled by + default, use --no-shielded-integrity-monitoring to disable. + + --shielded-secure-boot + Boot instance with secure boot enabled. Disabled by default. + + --shielded-vtpm + Boot instance with TPM (Trusted Platform Module) enabled. Enabled by + default, use --no-shielded-vtpm to disable. + + --tags=[TAGS,...] + Tags to apply to this instance. + + The hardware accelerator used on this instance. If you use accelerators, + make sure that your configuration has enough vCPUs and memory to support + the `machine_type` you have selected. + + --accelerator-core-count=ACCELERATOR_CORE_COUNT + Count of cores of this accelerator. + + --accelerator-type=ACCELERATOR_TYPE + Type of this accelerator. ACCELERATOR_TYPE must be one of: + NVIDIA_TESLA_A100, NVIDIA_TESLA_K80, NVIDIA_TESLA_P100, + NVIDIA_TESLA_V100, NVIDIA_TESLA_P4, NVIDIA_TESLA_T4, + NVIDIA_TESLA_T4_VWS, NVIDIA_TESLA_P100_VWS, NVIDIA_TESLA_P4_VWS, + TPU_V2, TPU_V3. + + Boot disk configurations. + + --boot-disk-size=BOOT_DISK_SIZE + Size of boot disk in GB attached to this instance, up to a maximum of + 64000 GB (64 TB). The minimum recommended value is 100 GB. If not + specified, this defaults to 100. + + --boot-disk-type=BOOT_DISK_TYPE + Type of boot disk attached to this instance, defaults to standard + persistent disk (PD_STANDARD). BOOT_DISK_TYPE must be one of: + PD_STANDARD, PD_SSD, PD_BALANCED, PD_EXTREME. + + At most one of these can be specified: --container-repository=CONTAINER_REPOSITORY The path to the container image repository. For example: @@ -152,7 +231,7 @@ REQUIRED FLAGS The ID of the Google Cloud project that this VM image belongs to. Format: projects/{project_id}. - Exactly one of these must be specified: + At most one of these can be specified: --vm-image-family=VM_IMAGE_FAMILY; default="common-cpu" Use this VM image family to find the image; the newest image in @@ -161,82 +240,6 @@ REQUIRED FLAGS --vm-image-name=VM_IMAGE_NAME Use this VM image name to find the image. -OPTIONAL FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - - --instance-owners=INSTANCE_OWNERS - The owners of this instance after creation. Format:alias@example.com. - Currently supports one owner only.If not specified, all of the service - account users of the VM instance's service account can use the - instance. - - --labels=[KEY=VALUE,...] - Labels to apply to this instance. These can be later modified by the - setLabels method. - - --machine-type=MACHINE_TYPE; default="n1-standard-1" - The Compute Engine machine type - (https://cloud.google.com/sdk/gcloud/reference/compute/machine-types) - of this instance. - - --metadata=[KEY=VALUE,...] - Custom metadata to apply to this instance. - - For example, to specify a Cloud Storage bucket for automatic backup, - you can use the gcs-data-bucket metadata tag. Format: - "--metadata=gcs-data-bucket=BUCKET". - - --post-startup-script=POST_STARTUP_SCRIPT - Path to a Bash script that automatically runs after a notebook instance - fully boots up. The path must be a URL or Cloud Storage path - (gs://path-to-file/file-name). - - --service-account=SERVICE_ACCOUNT - The service account on this instance, giving access to other Google - Cloud services. You can use any service account within the same - project, but you must have the service account user permission to use - the instance. If not specified, the Compute Engine default service - account is used. - - --shielded-integrity-monitoring - Enable monitoring of the boot integrity of the instance. Enabled by - default, use --no-shielded-integrity-monitoring to disable. - - --shielded-secure-boot - Boot instance with secure boot enabled. Disabled by default. - - --shielded-vtpm - Boot instance with TPM (Trusted Platform Module) enabled. Enabled by - default, use --no-shielded-vtpm to disable. - - The hardware accelerator used on this instance. If you use accelerators, - make sure that your configuration has enough vCPUs and memory to support - the `machine_type` you have selected. - - --accelerator-core-count=ACCELERATOR_CORE_COUNT - Count of cores of this accelerator. - - --accelerator-type=ACCELERATOR_TYPE - Type of this accelerator. ACCELERATOR_TYPE must be one of: - NVIDIA_TESLA_A100, NVIDIA_TESLA_K80, NVIDIA_TESLA_P100, - NVIDIA_TESLA_V100, NVIDIA_TESLA_P4, NVIDIA_TESLA_T4, - NVIDIA_TESLA_T4_VWS, NVIDIA_TESLA_P100_VWS, NVIDIA_TESLA_P4_VWS, - TPU_V2, TPU_V3. - - Boot disk configurations. - - --boot-disk-size=BOOT_DISK_SIZE - Size of boot disk in GB attached to this instance, up to a maximum of - 64000 GB (64 TB). The minimum recommended value is 100 GB. If not - specified, this defaults to 100. - - --boot-disk-type=BOOT_DISK_TYPE - Type of boot disk attached to this instance, defaults to standard - persistent disk (PD_STANDARD). BOOT_DISK_TYPE must be one of: - PD_STANDARD, PD_SSD, PD_BALANCED, PD_EXTREME. - GPU driver configurations. --custom-gpu-driver-path=CUSTOM_GPU_DRIVER_PATH diff --git a/gcloud/run/services/update b/gcloud/run/services/update index 21eddba54..6aee20ba8 100644 --- a/gcloud/run/services/update +++ b/gcloud/run/services/update @@ -174,6 +174,8 @@ FLAGS revision by default, run the gcloud run services update-traffic command with --to-latest. + Container Flags + If the --container or --remove-containers flag is specified the following arguments may only be specified after a --container flag. diff --git a/gcloud/workstations/clusters/list b/gcloud/workstations/clusters/list index 5abc47bef..89f974515 100644 --- a/gcloud/workstations/clusters/list +++ b/gcloud/workstations/clusters/list @@ -2,7 +2,7 @@ NAME gcloud workstations clusters list - list workstation clusters SYNOPSIS - gcloud workstations clusters list --region=REGION [--filter=EXPRESSION] + gcloud workstations clusters list [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -14,7 +14,7 @@ EXAMPLES $ gcloud workstations clusters list -REQUIRED FLAGS +FLAGS Region resource - The region of the clusters to display. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. @@ -22,16 +22,18 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --region on the command line with a fully specified name; + ◆ set the property workstations/region with a fully specified name; + ◆ default is all regions with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - --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. + ▸ provide the argument --region on the command line; + ▸ set the property workstations/region; + ▸ default is all regions . LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/workstations/configs/create b/gcloud/workstations/configs/create index 71da4e9ec..1f0c996da 100644 --- a/gcloud/workstations/configs/create +++ b/gcloud/workstations/configs/create @@ -10,9 +10,9 @@ SYNOPSIS [--container-env=[CONTAINER_ENV,...]] [--container-run-as-user=CONTAINER_RUN_AS_USER] [--container-working-dir=CONTAINER_WORKING_DIR] - [--disable-public-ip-addresses] [--disable-tcp-connections] - [--enable-audit-agent] [--enable-confidential-compute] - [--enable-nested-virtualization] + [--disable-public-ip-addresses] [--disable-ssh-to-vm] + [--disable-tcp-connections] [--enable-audit-agent] + [--enable-confidential-compute] [--enable-nested-virtualization] [--idle-timeout=IDLE_TIMEOUT; default=7200] [--labels=[LABELS,...]] [--machine-type=MACHINE_TYPE; default="e2-standard-4"] [--network-tags=[NETWORK_TAGS,...]] @@ -87,7 +87,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/cluster. --region=REGION - The location for the config. + The region for the config. To set the region attribute: ▸ provide the argument config on the command line with a fully @@ -136,6 +136,10 @@ FLAGS Default value is false. If set, instances will have no public IP address. + --disable-ssh-to-vm + Default value is False. If set, workstations will disable SSH + connections to the root VM. + --disable-tcp-connections Default value is false. If set, workstations will not allow plain TCP connections. diff --git a/gcloud/workstations/configs/list b/gcloud/workstations/configs/list index 88d17f24e..af3ea269a 100644 --- a/gcloud/workstations/configs/list +++ b/gcloud/workstations/configs/list @@ -2,7 +2,7 @@ NAME gcloud workstations configs list - list workstation configurations SYNOPSIS - gcloud workstations configs list (--cluster=CLUSTER : --region=REGION) + gcloud workstations configs list [--cluster=CLUSTER --region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -14,7 +14,7 @@ EXAMPLES $ gcloud workstations configs list -REQUIRED FLAGS +FLAGS Cluster resource - The cluster of the configurations to display. 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 @@ -23,19 +23,18 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --cluster on the command line with a fully specified name; + ◆ set the property workstations/cluster with a fully specified name; + ◆ default is all clusters with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - --cluster=CLUSTER ID of the cluster or fully qualified identifier for the cluster. To set the cluster attribute: - ▸ provide the argument --cluster on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. + ▸ provide the argument --cluster on the command line; + ▸ set the property workstations/cluster; + ▸ default is all clusters . --region=REGION The name of the region of the cluster. @@ -43,8 +42,12 @@ REQUIRED FLAGS To set the region attribute: ▸ provide the argument --cluster on the command line with a fully specified name; + ▸ set the property workstations/cluster with a fully specified + name; + ▸ default is all clusters with a fully specified name; ▸ provide the argument --region on the command line; - ▸ set the property workstations/region. + ▸ set the property workstations/region; + ▸ default is all regions . LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/workstations/configs/update b/gcloud/workstations/configs/update index 91cecff31..006db5923 100644 --- a/gcloud/workstations/configs/update +++ b/gcloud/workstations/configs/update @@ -21,6 +21,7 @@ SYNOPSIS [--shielded-vtpm] [--container-custom-image=CONTAINER_CUSTOM_IMAGE | --container-predefined-image=CONTAINER_PREDEFINED_IMAGE] + [--disable-ssh-to-vm | --enable-ssh-to-vm] [--disable-tcp-connections | --enable-tcp-connections] [GCLOUD_WIDE_FLAG ...] @@ -75,7 +76,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/cluster. --region=REGION - The location for the config. + The region for the config. To set the region attribute: ▸ provide the argument config on the command line with a fully @@ -228,6 +229,16 @@ FLAGS webstorm WebStorm + At most one of these can be specified: + + --disable-ssh-to-vm + Default value is False. If set, workstations will enable SSH + connections to the root VM. + + --enable-ssh-to-vm + Default value is False. If set, workstations will enable SSH + connections to the root VM. + At most one of these can be specified: --disable-tcp-connections diff --git a/gcloud/workstations/list b/gcloud/workstations/list index 7ca7c03ac..e1131db93 100644 --- a/gcloud/workstations/list +++ b/gcloud/workstations/list @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud workstations list - (--config=CONFIG : --cluster=CLUSTER --region=REGION) + [--cluster=CLUSTER --config=CONFIG --region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -15,7 +15,7 @@ EXAMPLES $ gcloud workstations list -REQUIRED FLAGS +FLAGS Config resource - The configuration of the workstations to display. 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 @@ -24,28 +24,30 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --config on the command line with a fully specified name; + ◆ set the property workstations/config with a fully specified name; + ◆ default is all configs with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - - --config=CONFIG - ID of the config or fully qualified identifier for the config. - - To set the config attribute: - ▸ provide the argument --config on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - --cluster=CLUSTER The name of the cluster containing the config. To set the cluster attribute: ▸ provide the argument --config on the command line with a fully specified name; + ▸ set the property workstations/config with a fully specified name; + ▸ default is all configs with a fully specified name; ▸ provide the argument --cluster on the command line; - ▸ set the property workstations/cluster. + ▸ set the property workstations/cluster; + ▸ default is all clusters . + + --config=CONFIG + ID of the config or fully qualified identifier for the config. + + To set the config attribute: + ▸ provide the argument --config on the command line; + ▸ set the property workstations/config; + ▸ default is all configs . --region=REGION The name of the region of the config. @@ -53,8 +55,11 @@ REQUIRED FLAGS To set the region attribute: ▸ provide the argument --config on the command line with a fully specified name; + ▸ set the property workstations/config with a fully specified name; + ▸ default is all configs with a fully specified name; ▸ provide the argument --region on the command line; - ▸ set the property workstations/region. + ▸ set the property workstations/region; + ▸ default is all regions . LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/workstations/list-usable b/gcloud/workstations/list-usable index 5c9fea7da..ad436c641 100644 --- a/gcloud/workstations/list-usable +++ b/gcloud/workstations/list-usable @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud workstations list-usable - (--config=CONFIG : --cluster=CLUSTER --region=REGION) + [--cluster=CLUSTER --config=CONFIG --region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -15,7 +15,7 @@ EXAMPLES $ gcloud workstations list-usable -REQUIRED FLAGS +FLAGS Config resource - The group of arguments defining a config 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 @@ -24,37 +24,38 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --config on the command line with a fully specified name; + ◆ default is all configs with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - - --config=CONFIG - ID of the config or fully qualified identifier for the config. - - To set the config attribute: - ▸ provide the argument --config on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - --cluster=CLUSTER The cluster for the config. To set the cluster attribute: ▸ provide the argument --config on the command line with a fully specified name; + ▸ default is all configs with a fully specified name; ▸ provide the argument --cluster on the command line; - ▸ set the property workstations/cluster. + ▸ set the property workstations/cluster; + ▸ default is all clusters. + + --config=CONFIG + ID of the config or fully qualified identifier for the config. + + To set the config attribute: + ▸ provide the argument --config on the command line; + ▸ default is all configs. --region=REGION - The location for the config. + The region for the config. To set the region attribute: ▸ provide the argument --config on the command line with a fully specified name; + ▸ default is all configs with a fully specified name; ▸ provide the argument --region on the command line; - ▸ set the property workstations/region. + ▸ set the property workstations/region; + ▸ default is all regions. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/workstations/ssh b/gcloud/workstations/ssh index eb46f474e..aeaca69a8 100644 --- a/gcloud/workstations/ssh +++ b/gcloud/workstations/ssh @@ -71,7 +71,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/config. --region=REGION - The location for the workstation. + The region for the workstation. To set the region attribute: ▸ provide the argument workstation on the command line with a fully diff --git a/gcloud/workstations/start b/gcloud/workstations/start index b1aef2408..bc76df9a6 100644 --- a/gcloud/workstations/start +++ b/gcloud/workstations/start @@ -57,7 +57,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/config. --region=REGION - The location for the workstation. + The region for the workstation. To set the region attribute: ▸ provide the argument workstation on the command line with a fully diff --git a/gcloud/workstations/start-tcp-tunnel b/gcloud/workstations/start-tcp-tunnel index 4fed16ec5..ca91ba652 100644 --- a/gcloud/workstations/start-tcp-tunnel +++ b/gcloud/workstations/start-tcp-tunnel @@ -63,7 +63,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/config. --region=REGION - The location for the workstation. + The region for the workstation. To set the region attribute: ▸ provide the argument workstation on the command line with a fully diff --git a/gcloud/workstations/stop b/gcloud/workstations/stop index 5999be2ed..fd1fa9326 100644 --- a/gcloud/workstations/stop +++ b/gcloud/workstations/stop @@ -57,7 +57,7 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/config. --region=REGION - The location for the workstation. + The region for the workstation. To set the region attribute: ▸ provide the argument workstation on the command line with a fully