diff --git a/gcloud/_version b/gcloud/_version index c5c9aa100..b61a77a04 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 434.0.0 -alpha 2023.06.02 -beta 2023.06.02 +Google Cloud SDK 435.0.1 +alpha 2023.06.14 +beta 2023.06.14 bq 2.0.93 bundled-python3-unix 3.9.16 -core 2023.06.02 +core 2023.06.14 gcloud-crc32c 1.0.0 gsutil 5.24 diff --git a/gcloud/alpha/compute/instance-templates/create b/gcloud/alpha/compute/instance-templates/create index aaf826122..862ac422d 100644 --- a/gcloud/alpha/compute/instance-templates/create +++ b/gcloud/alpha/compute/instance-templates/create @@ -344,6 +344,10 @@ FLAGS be the same as the instance zone. You can't use this option with boot disks. + storage-pool + The name of the storage pool in which the new disk is created. The + new disk and the storage pool must be in the same location. + --description=DESCRIPTION Specifies a textual description for the instance template. diff --git a/gcloud/alpha/compute/instances/bulk/create b/gcloud/alpha/compute/instances/bulk/create index f5dcafae9..727ee9e5d 100644 --- a/gcloud/alpha/compute/instances/bulk/create +++ b/gcloud/alpha/compute/instances/bulk/create @@ -378,6 +378,10 @@ OPTIONAL FLAGS Path to a Customer-Supplied Encryption Key (CSEK) key file for the image. Must be specified with image-csek-required. + storage-pool + The name of the storage pool in which the new disk is created. The + new disk and the storage pool must be in the same location. + --description=DESCRIPTION Specifies a textual description of the instances. diff --git a/gcloud/alpha/compute/instances/create b/gcloud/alpha/compute/instances/create index f8fd65c3c..f8f5f0d0a 100644 --- a/gcloud/alpha/compute/instances/create +++ b/gcloud/alpha/compute/instances/create @@ -13,8 +13,8 @@ SYNOPSIS [--confidential-compute-type=CONFIDENTIAL_COMPUTE_TYPE] [--create-disk=[PROPERTY=VALUE,...]] [--csek-key-file=FILE] [--deletion-protection] [--description=DESCRIPTION] - [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT], - [device-name=DEVICE-NAME],[mode=MODE],[name=NAME],[scope=SCOPE]] + [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME], + [force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]] [--enable-display-device] [--[no-]enable-nested-virtualization] [--[no-]enable-uefi-networking] [--erase-windows-vss-signature] [--external-ipv6-address=EXTERNAL_IPV6_ADDRESS] @@ -410,6 +410,10 @@ FLAGS be the same as the instance zone. You can't use this option with boot disks. + storage-pool + The name of the storage pool in which the new disk is created. The + new disk and the storage pool must be in the same location. + --csek-key-file=FILE Path to a Customer-Supplied Encryption Key (CSEK) key file that maps Compute Engine resources to user managed keys to be used when creating, @@ -425,7 +429,7 @@ FLAGS --description=DESCRIPTION Specifies a textual description of the instances. - --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME],[scope=SCOPE] + --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE] Attaches persistent disks to the instances. The disks specified must already exist. @@ -462,6 +466,10 @@ FLAGS zonal disk in the same zone as the instance (default). If regional, the disk is interpreted as a regional disk in the same region as the instance. The default value for this is zonal. + force-attach + If yes, this persistent disk will force-attached to the instance + even it is already attached to another instance. The default value + is 'no'. --enable-display-device Enable a display device on VM instances. Disabled by default. diff --git a/gcloud/alpha/compute/instances/create-with-container b/gcloud/alpha/compute/instances/create-with-container index 70ac1f225..f7ee46dd4 100644 --- a/gcloud/alpha/compute/instances/create-with-container +++ b/gcloud/alpha/compute/instances/create-with-container @@ -24,8 +24,8 @@ SYNOPSIS [--container-restart-policy=POLICY; default="always"] [--container-stdin] [--container-tty] [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION] - [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT], - [device-name=DEVICE-NAME],[mode=MODE],[name=NAME],[scope=SCOPE]] + [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME], + [force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]] [--[no-]enable-nested-virtualization] [--external-ipv6-address=EXTERNAL_IPV6_ADDRESS] [--external-ipv6-prefix-length=EXTERNAL_IPV6_PREFIX_LENGTH] @@ -385,7 +385,7 @@ FLAGS --description=DESCRIPTION Specifies a textual description of the instances. - --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME],[scope=SCOPE] + --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE] Attaches persistent disks to the instances. The disks specified must already exist. @@ -426,6 +426,10 @@ FLAGS zonal disk in the same zone as the instance (default). If regional, the disk is interpreted as a regional disk in the same region as the instance. The default value for this is zonal. + force-attach + If yes, this persistent disk will force-attached to the instance + even it is already attached to another instance. The default value + is 'no'. --[no-]enable-nested-virtualization If set to true, enables nested virtualization for the instance. Use diff --git a/gcloud/alpha/compute/instant-snapshots/add-labels b/gcloud/alpha/compute/instant-snapshots/add-labels index b381f99be..858d9ed50 100644 --- a/gcloud/alpha/compute/instant-snapshots/add-labels +++ b/gcloud/alpha/compute/instant-snapshots/add-labels @@ -91,5 +91,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 beta compute instant-snapshots add-labels diff --git a/gcloud/alpha/compute/instant-snapshots/create b/gcloud/alpha/compute/instant-snapshots/create index b8b54125e..f80331f84 100644 --- a/gcloud/alpha/compute/instant-snapshots/create +++ b/gcloud/alpha/compute/instant-snapshots/create @@ -1,6 +1,6 @@ NAME - gcloud alpha compute instant-snapshots create - create Compute Engine - instant snapshots + gcloud alpha compute instant-snapshots create - create a Compute Engine + instant snapshot SYNOPSIS gcloud alpha compute instant-snapshots create INSTANT_SNAPSHOT_NAME @@ -8,7 +8,16 @@ SYNOPSIS [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create Compute Engine instant snapshots. + (ALPHA) gcloud alpha compute instant-snapshots create creates an instant + snapshot of persistent disk. Instant snapshots are useful for backing up + persistent disk data. + +EXAMPLES + To create an instant snapshot 'my-instant-snap' from a disk 'my-disk' in + zone 'us-east1-a', run: + + $ gcloud alpha compute instant-snapshots create my-instant-snap \ + --source-disk=my-disk --zone=us-east1-a POSITIONAL ARGUMENTS INSTANT_SNAPSHOT_NAME @@ -86,5 +95,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 beta compute instant-snapshots create diff --git a/gcloud/alpha/compute/instant-snapshots/delete b/gcloud/alpha/compute/instant-snapshots/delete index 10fc43b51..92875dddc 100644 --- a/gcloud/alpha/compute/instant-snapshots/delete +++ b/gcloud/alpha/compute/instant-snapshots/delete @@ -1,6 +1,6 @@ NAME - gcloud alpha compute instant-snapshots delete - delete Compute Engine - instant snapshots + gcloud alpha compute instant-snapshots delete - delete a Compute Engine + instant snapshot SYNOPSIS gcloud alpha compute instant-snapshots delete INSTANT_SNAPSHOT_NAME @@ -8,7 +8,26 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete Compute Engine instant snapshots. + (ALPHA) gcloud alpha compute instant-snapshots delete deletes a Compute + Engine instant snapshot. A disk can be deleted only if it is not attached + to any virtual machine instances. + +EXAMPLES + To delete Compute Engine instant snapshots with the names + 'instant-snapshot-1' and 'instant-snapshot-2', run: + + $ gcloud alpha compute instant-snapshots delete instant-snapshot-1 \ + instant-snapshot-2 + + To list all instant snapshots that were created before a specific date, use + the --filter flag with the gcloud alpha compute instant-snapshots list + command. + + $ gcloud alpha compute instant-snapshots list \ + --filter="creationTimestamp<'2017-01-01'" + + For more information on how to use --filter with the list command, run $ + gcloud topic filters. POSITIONAL ARGUMENTS INSTANT_SNAPSHOT_NAME [INSTANT_SNAPSHOT_NAME ...] @@ -70,5 +89,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 beta compute instant-snapshots delete diff --git a/gcloud/alpha/compute/instant-snapshots/describe b/gcloud/alpha/compute/instant-snapshots/describe index 410bc6986..7927be219 100644 --- a/gcloud/alpha/compute/instant-snapshots/describe +++ b/gcloud/alpha/compute/instant-snapshots/describe @@ -11,10 +11,11 @@ DESCRIPTION associated with a Compute Engine instant snapshot in a project. EXAMPLES - To describe the instant snapshot 'ips-1' in zone 'us-east1-a', run: + To describe the instant snapshot 'instant-snapshot-1' in zone 'us-east1-a', + run: - $ gcloud alpha compute instant-snapshots describe ips-1 \ - --zone=us-east1-a + $ gcloud alpha compute instant-snapshots describe \ + instant-snapshot-1 --zone=us-east1-a POSITIONAL ARGUMENTS INSTANT_SNAPSHOT_NAME @@ -76,5 +77,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 beta compute instant-snapshots describe diff --git a/gcloud/alpha/compute/instant-snapshots/help b/gcloud/alpha/compute/instant-snapshots/help index cb8dc62c9..f931b5152 100644 --- a/gcloud/alpha/compute/instant-snapshots/help +++ b/gcloud/alpha/compute/instant-snapshots/help @@ -6,7 +6,11 @@ SYNOPSIS gcloud alpha compute instant-snapshots COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List, create, and delete Compute Engine instant snapshots. + (ALPHA) List, create, describe, and delete Compute Engine instant + snapshots. + + See also: Snapshots API + (https://cloud.google.com/compute/docs/reference/rest/beta/instantSnapshots). GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -20,20 +24,22 @@ COMMANDS (ALPHA) Add labels to Google Compute Engine instant-snapshotss. create - (ALPHA) Create Compute Engine instant snapshots. + (ALPHA) Create a Compute Engine instant snapshot. delete - (ALPHA) Delete Compute Engine instant snapshots. + (ALPHA) Delete a Compute Engine instant snapshot. describe (ALPHA) Describe a Compute Engine instant snapshot. list - (ALPHA) List Compute Engine persistent instant snapshots. + (ALPHA) List Google Compute Engine instant snapshots. 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 beta compute instant-snapshots diff --git a/gcloud/alpha/compute/instant-snapshots/list b/gcloud/alpha/compute/instant-snapshots/list index 4c70d5a54..b656fe23b 100644 --- a/gcloud/alpha/compute/instant-snapshots/list +++ b/gcloud/alpha/compute/instant-snapshots/list @@ -1,6 +1,6 @@ NAME - gcloud alpha compute instant-snapshots list - list Compute Engine - persistent instant snapshots + gcloud alpha compute instant-snapshots list - list Google Compute Engine + instant snapshots SYNOPSIS gcloud alpha compute instant-snapshots list [NAME ...] @@ -10,7 +10,33 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List Compute Engine persistent instant snapshots. + (ALPHA) gcloud alpha compute instant-snapshots list displays all Google + Compute Engine instant snapshots in a project. + + By default, instant snapshots from all regions and instant snapshots from + all zones are listed. The results can be narrowed down by providing the + --regions or --zones flag. + +EXAMPLES + To list all instant snapshots in a project in table form, run: + + $ gcloud alpha compute instant-snapshots list + + To list the URIs of all instant snapshots in a project, run: + + $ gcloud alpha compute instant-snapshots list --uri + + To list all instant snapshots in the us-central1 and europe-west1 regions, + given they are regional resources, run: + + $ gcloud alpha compute instant-snapshots list \ + --filter="region:( europe-west1 us-central1 )" + + To list all instant snapshots in zones us-central1-b and europe-west1-d, + given they are zonal resources, run: + + $ gcloud alpha compute instant-snapshots list \ + --filter="zone:( europe-west1-d us-central1-b )" POSITIONAL ARGUMENTS [NAME ...] @@ -82,5 +108,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 beta compute instant-snapshots list diff --git a/gcloud/alpha/compute/security-policies/add-user-defined-field b/gcloud/alpha/compute/security-policies/add-user-defined-field index bff51e2aa..f299d0cb6 100644 --- a/gcloud/alpha/compute/security-policies/add-user-defined-field +++ b/gcloud/alpha/compute/security-policies/add-user-defined-field @@ -59,5 +59,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 beta compute security-policies add-user-defined-field diff --git a/gcloud/alpha/compute/security-policies/remove-user-defined-field b/gcloud/alpha/compute/security-policies/remove-user-defined-field index 755b2946b..90a184468 100644 --- a/gcloud/alpha/compute/security-policies/remove-user-defined-field +++ b/gcloud/alpha/compute/security-policies/remove-user-defined-field @@ -42,5 +42,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 beta compute security-policies remove-user-defined-field diff --git a/gcloud/alpha/compute/security-policies/rules/create b/gcloud/alpha/compute/security-policies/rules/create index 9e82a5eaa..0a0eec559 100644 --- a/gcloud/alpha/compute/security-policies/rules/create +++ b/gcloud/alpha/compute/security-policies/rules/create @@ -30,6 +30,8 @@ SYNOPSIS [--exceed-redirect-type=EXCEED_REDIRECT_TYPE] [--preview] [--rate-limit-threshold-count=RATE_LIMIT_THRESHOLD_COUNT] [--rate-limit-threshold-interval-sec=RATE_LIMIT_THRESHOLD_INTERVAL_SEC] + [--recaptcha-action-site-keys=[SITE_KEY,...]] + [--recaptcha-session-site-keys=[SITE_KEY,...]] [--redirect-target=REDIRECT_TARGET] [--redirect-type=REDIRECT_TYPE] [--region=REGION] [--request-headers-to-add=[REQUEST_HEADERS_TO_ADD,...]] @@ -250,6 +252,18 @@ OPTIONAL FLAGS Interval over which the threshold for rate limiting requests is computed. + --recaptcha-action-site-keys=[SITE_KEY,...] + A comma-separated list of site keys to be used during the validation of + reCAPTCHA action-tokens. The provided site keys need to be created from + the reCAPTCHA API under the same project where the security policy is + created. + + --recaptcha-session-site-keys=[SITE_KEY,...] + A comma-separated list of site keys to be used during the validation of + reCAPTCHA session-tokens. The provided site keys need to be created + from the reCAPTCHA API under the same project where the security policy + is created. + --redirect-target=REDIRECT_TARGET URL target for the redirect action. Must be specified if the redirect type is external-302. Cannot be specified if the redirect type is diff --git a/gcloud/alpha/compute/security-policies/rules/update b/gcloud/alpha/compute/security-policies/rules/update index 645f2a217..aebb4f0ab 100644 --- a/gcloud/alpha/compute/security-policies/rules/update +++ b/gcloud/alpha/compute/security-policies/rules/update @@ -20,6 +20,8 @@ SYNOPSIS [--exceed-redirect-type=EXCEED_REDIRECT_TYPE] [--preview] [--rate-limit-threshold-count=RATE_LIMIT_THRESHOLD_COUNT] [--rate-limit-threshold-interval-sec=RATE_LIMIT_THRESHOLD_INTERVAL_SEC] + [--recaptcha-action-site-keys=[SITE_KEY,...]] + [--recaptcha-session-site-keys=[SITE_KEY,...]] [--redirect-target=REDIRECT_TARGET] [--redirect-type=REDIRECT_TYPE] [--region=REGION] [--request-headers-to-add=[REQUEST_HEADERS_TO_ADD,...]] @@ -200,6 +202,18 @@ FLAGS Interval over which the threshold for rate limiting requests is computed. + --recaptcha-action-site-keys=[SITE_KEY,...] + A comma-separated list of site keys to be used during the validation of + reCAPTCHA action-tokens. The provided site keys need to be created from + the reCAPTCHA API under the same project where the security policy is + created. + + --recaptcha-session-site-keys=[SITE_KEY,...] + A comma-separated list of site keys to be used during the validation of + reCAPTCHA session-tokens. The provided site keys need to be created + from the reCAPTCHA API under the same project where the security policy + is created. + --redirect-target=REDIRECT_TARGET URL target for the redirect action. Must be specified if the redirect type is external-302. Cannot be specified if the redirect type is diff --git a/gcloud/alpha/compute/target-instances/update b/gcloud/alpha/compute/target-instances/update index 65ccf0558..8bb3d8ec0 100644 --- a/gcloud/alpha/compute/target-instances/update +++ b/gcloud/alpha/compute/target-instances/update @@ -65,5 +65,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 beta compute target-instances update diff --git a/gcloud/alpha/compute/target-pools/update b/gcloud/alpha/compute/target-pools/update index fcd004a82..35bc36e73 100644 --- a/gcloud/alpha/compute/target-pools/update +++ b/gcloud/alpha/compute/target-pools/update @@ -63,5 +63,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 beta compute target-pools update diff --git a/gcloud/alpha/container/aws/clusters/create b/gcloud/alpha/container/aws/clusters/create index adc174da7..102ce001d 100644 --- a/gcloud/alpha/container/aws/clusters/create +++ b/gcloud/alpha/container/aws/clusters/create @@ -14,17 +14,19 @@ SYNOPSIS --subnet-ids=[SUBNET_ID,...] --vpc-id=VPC_ID [--admin-users=USER,[USER,...]] [--annotations=ANNOTATION,[ANNOTATION,...]] [--async] - [--description=DESCRIPTION] [--enable-managed-prometheus] - [--instance-placement=INSTANCE_PLACEMENT] + [--description=DESCRIPTION] [--disable-per-node-pool-sg-rules] + [--enable-managed-prometheus] [--instance-placement=INSTANCE_PLACEMENT] [--instance-type=INSTANCE_TYPE] [--logging=COMPONENT,[COMPONENT,...]] [--main-volume-iops=MAIN_VOLUME_IOPS] [--main-volume-kms-key-arn=MAIN_VOLUME_KMS_KEY_ARN] [--main-volume-size=MAIN_VOLUME_SIZE] + [--main-volume-throughput=MAIN_VOLUME_THROUGHPUT] [--main-volume-type=MAIN_VOLUME_TYPE] [--role-session-name=ROLE_SESSION_NAME] [--root-volume-iops=ROOT_VOLUME_IOPS] [--root-volume-kms-key-arn=ROOT_VOLUME_KMS_KEY_ARN] [--root-volume-size=ROOT_VOLUME_SIZE] + [--root-volume-throughput=ROOT_VOLUME_THROUGHPUT] [--root-volume-type=ROOT_VOLUME_TYPE] [--security-group-ids=[SECURITY_GROUP_ID,...]] [--ssh-ec2-key-pair=SSH_EC2_KEY_PAIR] [--tags=TAG,[TAG,...]] @@ -133,6 +135,12 @@ OPTIONAL FLAGS --description=DESCRIPTION Description for the cluster. + --disable-per-node-pool-sg-rules + Disable the default per node pool subnet security group rules on the + control plane security group. When disabled, at least one security + group that allows node pools to send traffic to the control plane on + ports TCP/443 and TCP/8132 must be provided. + --enable-managed-prometheus Enable managed collection for Managed Service for Prometheus. @@ -167,6 +175,10 @@ OPTIONAL FLAGS size unit of GB for gigabyte, or TB for terabyte. If no size unit is specified, GB is assumed. + --main-volume-throughput=MAIN_VOLUME_THROUGHPUT + Throughput to provision for the main volume, in MiB/s. Only valid if + the volume type is GP3. + --main-volume-type=MAIN_VOLUME_TYPE Type of the main volume. MAIN_VOLUME_TYPE must be one of: gp2, gp3. @@ -186,6 +198,10 @@ OPTIONAL FLAGS size unit of GB for gigabyte, or TB for terabyte. If no size unit is specified, GB is assumed. + --root-volume-throughput=ROOT_VOLUME_THROUGHPUT + Throughput to provision for the root volume, in MiB/s. Only valid if + the volume type is GP3. + --root-volume-type=ROOT_VOLUME_TYPE Type of the root volume. ROOT_VOLUME_TYPE must be one of: gp2, gp3. diff --git a/gcloud/alpha/container/aws/clusters/update b/gcloud/alpha/container/aws/clusters/update index 3b0764fc6..35395b9dc 100644 --- a/gcloud/alpha/container/aws/clusters/update +++ b/gcloud/alpha/container/aws/clusters/update @@ -13,6 +13,7 @@ SYNOPSIS [--root-volume-iops=ROOT_VOLUME_IOPS] [--root-volume-kms-key-arn=ROOT_VOLUME_KMS_KEY_ARN] [--root-volume-size=ROOT_VOLUME_SIZE] + [--root-volume-throughput=ROOT_VOLUME_THROUGHPUT] [--root-volume-type=ROOT_VOLUME_TYPE] [--validate-only] [--annotations=ANNOTATION,[ANNOTATION,...] | --clear-annotations] [--clear-description | --description=DESCRIPTION] @@ -23,6 +24,7 @@ SYNOPSIS [--clear-ssh-ec2-key-pair | --ssh-ec2-key-pair=SSH_EC2_KEY_PAIR] [--clear-tags | --tags=TAG,[TAG,...]] [--disable-managed-prometheus | --enable-managed-prometheus] + [--disable-per-node-pool-sg-rules | --enable-per-node-pool-sg-rules] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -116,6 +118,10 @@ FLAGS size unit of GB for gigabyte, or TB for terabyte. If no size unit is specified, GB is assumed. + --root-volume-throughput=ROOT_VOLUME_THROUGHPUT + Throughput to provision for the root volume, in MiB/s. Only valid if + the volume type is GP3. + --root-volume-type=ROOT_VOLUME_TYPE Type of the root volume. ROOT_VOLUME_TYPE must be one of: gp2, gp3. @@ -207,6 +213,20 @@ FLAGS --enable-managed-prometheus Enable managed collection for Managed Service for Prometheus. + Default per node pool security group rules + + At most one of these can be specified: + + --disable-per-node-pool-sg-rules + Disable the default per node pool subnet security group rules on the + control plane security group. When disabled, at least one security + group that allows node pools to send traffic to the control plane on + ports TCP/443 and TCP/8132 must be provided. + + --enable-per-node-pool-sg-rules + Enable the default per node pool subnet security group rules on the + control plane security group. + 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/container/aws/node-pools/create b/gcloud/alpha/container/aws/node-pools/create index 558725ea0..e0f5de283 100644 --- a/gcloud/alpha/container/aws/node-pools/create +++ b/gcloud/alpha/container/aws/node-pools/create @@ -17,6 +17,7 @@ SYNOPSIS [--root-volume-iops=ROOT_VOLUME_IOPS] [--root-volume-kms-key-arn=ROOT_VOLUME_KMS_KEY_ARN] [--root-volume-size=ROOT_VOLUME_SIZE] + [--root-volume-throughput=ROOT_VOLUME_THROUGHPUT] [--root-volume-type=ROOT_VOLUME_TYPE] [--security-group-ids=[SECURITY_GROUP_ID,...]] [--ssh-ec2-key-pair=SSH_EC2_KEY_PAIR] [--tags=TAG,[TAG,...]] @@ -161,6 +162,10 @@ OPTIONAL FLAGS size unit of GB for gigabyte, or TB for terabyte. If no size unit is specified, GB is assumed. + --root-volume-throughput=ROOT_VOLUME_THROUGHPUT + Throughput to provision for the root volume, in MiB/s. Only valid if + the volume type is GP3. + --root-volume-type=ROOT_VOLUME_TYPE Type of the root volume. ROOT_VOLUME_TYPE must be one of: gp2, gp3. diff --git a/gcloud/alpha/container/aws/node-pools/update b/gcloud/alpha/container/aws/node-pools/update index 143afe8ac..33eca3e8c 100644 --- a/gcloud/alpha/container/aws/node-pools/update +++ b/gcloud/alpha/container/aws/node-pools/update @@ -10,6 +10,7 @@ SYNOPSIS [--node-version=NODE_VERSION] [--root-volume-iops=ROOT_VOLUME_IOPS] [--root-volume-kms-key-arn=ROOT_VOLUME_KMS_KEY_ARN] [--root-volume-size=ROOT_VOLUME_SIZE] + [--root-volume-throughput=ROOT_VOLUME_THROUGHPUT] [--root-volume-type=ROOT_VOLUME_TYPE] [--validate-only] [--annotations=ANNOTATION,[ANNOTATION,...] | --clear-annotations] [--clear-autoscaling-metrics @@ -106,6 +107,10 @@ FLAGS size unit of GB for gigabyte, or TB for terabyte. If no size unit is specified, GB is assumed. + --root-volume-throughput=ROOT_VOLUME_THROUGHPUT + Throughput to provision for the root volume, in MiB/s. Only valid if + the volume type is GP3. + --root-volume-type=ROOT_VOLUME_TYPE Type of the root volume. ROOT_VOLUME_TYPE must be one of: gp2, gp3. diff --git a/gcloud/alpha/container/clusters/check-autopilot-compatibility b/gcloud/alpha/container/clusters/check-autopilot-compatibility new file mode 100644 index 000000000..a00d7f74f --- /dev/null +++ b/gcloud/alpha/container/clusters/check-autopilot-compatibility @@ -0,0 +1,87 @@ +NAME + gcloud alpha container clusters check-autopilot-compatibility - check + autopilot compatibility of a running cluster + +SYNOPSIS + gcloud alpha container clusters check-autopilot-compatibility NAME + [--location=LOCATION | --region=REGION | --zone=ZONE, -z ZONE] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Check autopilot compatibility of a running cluster. + +EXAMPLES + To check autopilot compatibility of an existing cluster, run: + + $ gcloud alpha container clusters check-autopilot-compatibility \ + sample-cluster + +POSITIONAL ARGUMENTS + NAME + The name of this cluster. + +FLAGS + At most one of these can be specified: + + --location=LOCATION + Compute zone or region (e.g. us-central1-a or us-central1) for the + cluster. + + --region=REGION + Compute region (e.g. us-central1) for the cluster. + + --zone=ZONE, -z ZONE + Compute zone (e.g. us-central1-a) for the cluster. Overrides the + default compute/zone property value for this command invocation. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This 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. These variants are also available: + + $ gcloud container clusters check-autopilot-compatibility + + $ gcloud beta container clusters check-autopilot-compatibility + diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index a021fef6d..2d429d974 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -656,7 +656,7 @@ FLAGS Set the components that have logging enabled. Valid component values are: SYSTEM, WORKLOAD, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, NONE - For more information, look at + For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-logs Examples: @@ -796,10 +796,10 @@ FLAGS --monitoring=[COMPONENT,...] Set the components that have monitoring enabled. Valid component values - are: SYSTEM, WORKLOAD (Deprecated), NONE,API_SERVER, + are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER - For more information, look at + For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics Examples: @@ -1213,7 +1213,8 @@ FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, MONITORING, - MONITORING_AND_PROJECT_SINGLETON_POLICY_ENFORCE, + MONITORING_AND_PROJECT_SINGLETON_POLICY_ENFORCE, POLICY_BINDINGS, + POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE, PROJECT_SINGLETON_POLICY_ENFORCE. --enable-binauthz diff --git a/gcloud/alpha/container/clusters/create-auto b/gcloud/alpha/container/clusters/create-auto index f9607a2ad..8329ead4d 100644 --- a/gcloud/alpha/container/clusters/create-auto +++ b/gcloud/alpha/container/clusters/create-auto @@ -14,6 +14,7 @@ SYNOPSIS [--enable-google-cloud-access] [--enable-kubernetes-unstable-apis=API,[API,...]] [--enable-master-global-access] [--fleet-project=PROJECT_ID_OR_NUMBER] + [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] [--network=NETWORK] [--private-endpoint-subnetwork=NAME] [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] @@ -184,6 +185,34 @@ FLAGS Example: $ gcloud alpha container clusters create-auto \ --fleet-project=my-project + --logging=[COMPONENT,...] + Set the components that have logging enabled. Valid component values + are: SYSTEM, WORKLOAD, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, NONE + + For more information, see + https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-logs + + Examples: + + $ gcloud alpha container clusters create-auto --logging=SYSTEM + $ gcloud alpha container clusters create-auto \ + --logging=SYSTEM,API_SERVER,WORKLOAD + $ gcloud alpha container clusters create-auto --logging=NONE + + --monitoring=[COMPONENT,...] + Set the components that have monitoring enabled. Valid component values + are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, + CONTROLLER_MANAGER, SCHEDULER + + For more information, see + https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics + + Examples: + + $ gcloud alpha container clusters create-auto \ + --monitoring=SYSTEM,API_SERVER + $ gcloud alpha container clusters create-auto --monitoring=NONE + --network=NETWORK The Compute Engine Network that the cluster will connect to. Google Kubernetes Engine will use this network when creating routes and @@ -273,7 +302,8 @@ FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, MONITORING, - MONITORING_AND_PROJECT_SINGLETON_POLICY_ENFORCE, + MONITORING_AND_PROJECT_SINGLETON_POLICY_ENFORCE, POLICY_BINDINGS, + POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE, PROJECT_SINGLETON_POLICY_ENFORCE. --binauthz-policy=BINAUTHZ_POLICY diff --git a/gcloud/alpha/container/clusters/help b/gcloud/alpha/container/clusters/help index 897215726..9c09cd7ef 100644 --- a/gcloud/alpha/container/clusters/help +++ b/gcloud/alpha/container/clusters/help @@ -42,6 +42,9 @@ GROUPS COMMANDS COMMAND is one of the following: + check-autopilot-compatibility + (ALPHA) Check autopilot compatibility of a running cluster. + create (ALPHA) Create a cluster for running containers. diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index 67249ba72..6bb2dad2b 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -662,7 +662,8 @@ REQUIRED FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, MONITORING, - MONITORING_AND_PROJECT_SINGLETON_POLICY_ENFORCE, + MONITORING_AND_PROJECT_SINGLETON_POLICY_ENFORCE, POLICY_BINDINGS, + POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE, PROJECT_SINGLETON_POLICY_ENFORCE. --enable-binauthz @@ -1100,7 +1101,7 @@ REQUIRED FLAGS are: SYSTEM, WORKLOAD, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, NONE - For more information, look at + For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-logs Examples: @@ -1112,10 +1113,10 @@ REQUIRED FLAGS --monitoring=[COMPONENT,...] Set the components that have monitoring enabled. Valid component - values are: SYSTEM, WORKLOAD (Deprecated), NONE,API_SERVER, + values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER - For more information, look at + For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics Examples: diff --git a/gcloud/alpha/dataflow/jobs/export-steps b/gcloud/alpha/dataflow/jobs/export-steps index 28ddc7ddd..80761cf8a 100644 --- a/gcloud/alpha/dataflow/jobs/export-steps +++ b/gcloud/alpha/dataflow/jobs/export-steps @@ -11,12 +11,11 @@ DESCRIPTION POSITIONAL ARGUMENTS JOB_ID - The job ID to operate on. + Job ID to operate on. FLAGS --region=REGION_ID - The region ID of the job's regional endpoint. Defaults to - 'us-central1'. + Region ID of the job's regional endpoint. Defaults to 'us-central1'. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/dataflow/jobs/resume-unsupported-sdk b/gcloud/alpha/dataflow/jobs/resume-unsupported-sdk index e5d5780cf..ca67f968c 100644 --- a/gcloud/alpha/dataflow/jobs/resume-unsupported-sdk +++ b/gcloud/alpha/dataflow/jobs/resume-unsupported-sdk @@ -12,7 +12,7 @@ DESCRIPTION POSITIONAL ARGUMENTS JOB_ID - The job ID to operate on. + Job ID to operate on. REQUIRED FLAGS --token=TOKEN @@ -20,8 +20,7 @@ REQUIRED FLAGS OPTIONAL FLAGS --region=REGION_ID - The region ID of the job's regional endpoint. Defaults to - 'us-central1'. + Region ID of the job's regional endpoint. Defaults to 'us-central1'. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/dataflow/logs/list b/gcloud/alpha/dataflow/logs/list index 9407648fa..16d54bd3b 100644 --- a/gcloud/alpha/dataflow/logs/list +++ b/gcloud/alpha/dataflow/logs/list @@ -32,7 +32,7 @@ EXAMPLES POSITIONAL ARGUMENTS JOB_ID - The job ID to operate on. + Job ID to operate on. FLAGS --after=AFTER @@ -49,8 +49,7 @@ FLAGS be one of: debug, detailed, warning, error. --region=REGION_ID - The region ID of the job's regional endpoint. Defaults to - 'us-central1'. + Region ID of the job's regional endpoint. Defaults to 'us-central1'. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/dataflow/metrics/list b/gcloud/alpha/dataflow/metrics/list index ac963825a..459c25e36 100644 --- a/gcloud/alpha/dataflow/metrics/list +++ b/gcloud/alpha/dataflow/metrics/list @@ -44,7 +44,7 @@ EXAMPLES POSITIONAL ARGUMENTS JOB_ID - The job ID to operate on. + Job ID to operate on. FLAGS --changed-after=CHANGED_AFTER @@ -56,8 +56,7 @@ FLAGS If true, hide committed values. --region=REGION_ID - The region ID of the job's regional endpoint. Defaults to - 'us-central1'. + Region ID of the job's regional endpoint. Defaults to 'us-central1'. --source=SOURCE; default="all" Set the metrics source. SOURCE must be one of: diff --git a/gcloud/alpha/filestore/instances/create b/gcloud/alpha/filestore/instances/create index 041cbc54b..2bea64b2d 100644 --- a/gcloud/alpha/filestore/instances/create +++ b/gcloud/alpha/filestore/instances/create @@ -145,6 +145,20 @@ REQUIRED FLAGS NO_ROOT_SQUASH is specified, an error will be returned. The default value is 65534. + security-flavors + A list of security flavors that are allowed to be used during mount + command in NFSv4.1 filestore instances. The security flavors + supported are: + ◆ SECURITY_FLAVOR_UNSPECIFIED: SecurityFlavor not set. Defaults to + AUTH_SYS. + ◆ AUTH_SYS: The user's UNIX user-id and group-ids are passed in the + clear. + ◆ KRB5: The end-user authentication is done using Kerberos V5. + ◆ KRB5I: KRB5 plus integrity protection (data packets are tamper + proof). + ◆ KRB5P: KRB5I plus privacy protection (data packets are tamper + proof and encrypted). + source-snapshot The name of the snapshot to restore from. Supported for BASIC instances only. diff --git a/gcloud/alpha/filestore/instances/update b/gcloud/alpha/filestore/instances/update index 2e07b5815..074c800ba 100644 --- a/gcloud/alpha/filestore/instances/update +++ b/gcloud/alpha/filestore/instances/update @@ -159,6 +159,20 @@ FLAGS NO_ROOT_SQUASH is specified, an error will be returned. The default value is 65534. + security-flavors + A list of security flavors that are allowed to be used during mount + command in NFSv4.1 filestore instances. The security flavors + supported are: + ◆ SECURITY_FLAVOR_UNSPECIFIED: SecurityFlavor not set. Defaults to + AUTH_SYS. + ◆ AUTH_SYS: The user's UNIX user-id and group-ids are passed in the + clear. + ◆ KRB5: The end-user authentication is done using Kerberos V5. + ◆ KRB5I: KRB5 plus integrity protection (data packets are tamper + proof). + ◆ KRB5P: KRB5I plus privacy protection (data packets are tamper + proof and encrypted). + source-snapshot The name of the snapshot to restore from. Supported for BASIC instances only. diff --git a/gcloud/alpha/firestore/databases/describe b/gcloud/alpha/firestore/databases/describe index a929ce457..3553e120a 100644 --- a/gcloud/alpha/firestore/databases/describe +++ b/gcloud/alpha/firestore/databases/describe @@ -9,6 +9,14 @@ SYNOPSIS DESCRIPTION (ALPHA) The following command describes a Google Cloud Firestore database. +EXAMPLES + To describe a Firestore database with a databaseId testdb. + + $ gcloud alpha firestore databases describe --database=testdb + + If databaseId is not specified, the command will describe information about + the (default) database. + $ gcloud alpha firestore databases describe FLAGS diff --git a/gcloud/alpha/firestore/export b/gcloud/alpha/firestore/export index 45754c69d..2fad5caf5 100644 --- a/gcloud/alpha/firestore/export +++ b/gcloud/alpha/firestore/export @@ -6,7 +6,8 @@ SYNOPSIS gcloud alpha firestore export OUTPUT_URI_PREFIX [--async] [--collection-ids=[COLLECTION_IDS,...]] [--database=DATABASE; default="(default)"] - [--namespace-ids=[NAMESPACE_IDS,...]] [GCLOUD_WIDE_FLAG ...] + [--namespace-ids=[NAMESPACE_IDS,...]] [--snapshot-time=SNAPSHOT_TIME] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) export Cloud Firestore documents to Google Cloud Storage. @@ -28,6 +29,11 @@ EXAMPLES $ gcloud alpha firestore export gs://mybucket/my/path \ --namespace-ids='specific namespace id' + To export from a snapshot at '2023-05-26T10:20:00.00Z', run: + + $ gcloud alpha firestore export gs://mybucket/my/path \ + --snapshot-time='2023-05-26T10:20:00.00Z' + POSITIONAL ARGUMENTS OUTPUT_URI_PREFIX Location where the export files will be stored. Must be a valid Google @@ -70,6 +76,19 @@ FLAGS $ gcloud alpha firestore export --namespaces-ids='customers','orders' + --snapshot-time=SNAPSHOT_TIME + The version of the database to export. + + The timestamp must be rounded to the minute, in the past, and not older + than 1 hour. If specified, then the exported documents will represent a + consistent view of the database at the provided time. Otherwise, there + are no guarantees about the consistency of the exported documents. + + For example, to operate on snapshot time 2023-05-26T10:20:00.00Z: + + $ gcloud alpha firestore export \ + --snapshot-time='2023-05-26T10:20:00.00Z' + 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/functions/deploy b/gcloud/alpha/functions/deploy index 9027bcef8..85e87d5bc 100644 --- a/gcloud/alpha/functions/deploy +++ b/gcloud/alpha/functions/deploy @@ -127,11 +127,8 @@ FLAGS --entry-point=ENTRY_POINT Name of a Google Cloud Function (as defined in source code) that will - be executed. Defaults to the resource name suffix, if not specified. - For backward compatibility, if function with given name is not found, - then the system will try to use function named "function". For Node.js - this is name of a function exported by the module specified in - source_location. + be executed. Defaults to the resource name suffix (ID of the function), + if not specified. --gen2 If enabled, this command will use Cloud Functions (Second generation). diff --git a/gcloud/alpha/iam/workload-identity-pools/providers/create-oidc b/gcloud/alpha/iam/workload-identity-pools/providers/create-oidc index 27f3c50c5..12c3278bc 100644 --- a/gcloud/alpha/iam/workload-identity-pools/providers/create-oidc +++ b/gcloud/alpha/iam/workload-identity-pools/providers/create-oidc @@ -9,7 +9,8 @@ SYNOPSIS --attribute-mapping=[ATTRIBUTE_MAPPING,...] --issuer-uri=ISSUER_URI [--allowed-audiences=[ALLOWED_AUDIENCES,...]] [--attribute-condition=ATTRIBUTE_CONDITION] [--description=DESCRIPTION] - [--disabled] [--display-name=DISPLAY_NAME] [GCLOUD_WIDE_FLAG ...] + [--disabled] [--display-name=DISPLAY_NAME] + [--jwk-json-path=JWK_JSON_PATH] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a new OIDC workload identity pool provider. @@ -28,7 +29,7 @@ EXAMPLES --attribute-condition="true" \ --issuer-uri="https://test-idp.com" \ --allowed-audiences=https://test-audience-1.com,https://\ - test-audience-2.com + test-audience-2.com --jwk-json-path="path/to/jwk.json" POSITIONAL ARGUMENTS Workload identity pool provider resource - The workload identity pool @@ -205,6 +206,25 @@ OPTIONAL FLAGS --display-name=DISPLAY_NAME A display name for the provider. Cannot exceed 32 characters. + --jwk-json-path=JWK_JSON_PATH + Optional file containing jwk public keys. The file format must follow + jwk specifications (https://www.rfc-editor.org/rfc/rfc7517#section-4). + Example file format: { + "keys": [ + { + "kty": "RSA/EC", + "alg": "", + "use": "sig", + "kid": "", + "n": "", + "e": "" + "x": "" + "y": "" + "crv": "" + } + ] + } + 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/iam/workload-identity-pools/providers/update-oidc b/gcloud/alpha/iam/workload-identity-pools/providers/update-oidc index 33b8d9a17..0e00075bb 100644 --- a/gcloud/alpha/iam/workload-identity-pools/providers/update-oidc +++ b/gcloud/alpha/iam/workload-identity-pools/providers/update-oidc @@ -10,7 +10,8 @@ SYNOPSIS [--attribute-condition=ATTRIBUTE_CONDITION] [--attribute-mapping=[ATTRIBUTE_MAPPING,...]] [--description=DESCRIPTION] [--disabled] [--display-name=DISPLAY_NAME] - [--issuer-uri=ISSUER_URI] [GCLOUD_WIDE_FLAG ...] + [--issuer-uri=ISSUER_URI] [--jwk-json-path=JWK_JSON_PATH] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Update an OIDC workload identity pool provider. @@ -29,7 +30,7 @@ EXAMPLES --attribute-condition="true" \ --issuer-uri="https://test-idp.com" \ --allowed-audiences=https://test-audience-1.com,https://\ - test-audience-2.com + test-audience-2.com --jwk-json-path="path/to/jwk.json" POSITIONAL ARGUMENTS Workload identity pool provider resource - The workload identity pool @@ -205,6 +206,25 @@ FLAGS --issuer-uri=ISSUER_URI The OIDC issuer URL. + --jwk-json-path=JWK_JSON_PATH + Optional file containing jwk public keys. The file format must follow + jwk specifications (https://www.rfc-editor.org/rfc/rfc7517#section-4). + Example file format: { + "keys": [ + { + "kty": "RSA/EC", + "alg": "", + "use": "sig", + "kid": "", + "n": "", + "e": "" + "x": "" + "y": "" + "crv": "" + } + ] + } + 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/logging/sinks/create b/gcloud/alpha/logging/sinks/create index e7b2851b4..969d6012c 100644 --- a/gcloud/alpha/logging/sinks/create +++ b/gcloud/alpha/logging/sinks/create @@ -63,6 +63,11 @@ EXAMPLES logging.googleapis.com/projects/my-central-project/locations/\ global/buckets/my-central-bucket + To route all logs to another project, run: + + $ gcloud alpha logging sinks create my-sink \ + logging.googleapis.com/projects/my-destination-project + POSITIONAL ARGUMENTS SINK_NAME The name for the sink. diff --git a/gcloud/alpha/netapp/active-directories/create b/gcloud/alpha/netapp/active-directories/create index 2f037df35..889d1f7eb 100644 --- a/gcloud/alpha/netapp/active-directories/create +++ b/gcloud/alpha/netapp/active-directories/create @@ -17,7 +17,18 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a Cloud NetApp Active Directory. + (ALPHA) Creates an AD (Active Directory) config for Cloud NetApp Volumes + +EXAMPLES + The following command creates an AD named AD_NAME with the required + arguments + + $ gcloud alpha netapp active-directories create AD_NAME \ + --location=us-central1 --domain=example-domain.com \ + --dns=0.0.0.0 --net-bios-prefix=prefix-1 --enable-aes=true \ + --username=user1 --password="secure1" \ + --backup-operators=backup_op1,backup_op2 \ + --security-operators=sec_op1,sec_op2 --enable-ldap-signing=false POSITIONAL ARGUMENTS Active directory resource - The Active Directory to create. The arguments @@ -135,5 +146,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 beta netapp active-directories create diff --git a/gcloud/alpha/netapp/active-directories/delete b/gcloud/alpha/netapp/active-directories/delete index c741f514b..16bdf883d 100644 --- a/gcloud/alpha/netapp/active-directories/delete +++ b/gcloud/alpha/netapp/active-directories/delete @@ -8,7 +8,19 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a Cloud NetApp Active Directory. + (ALPHA) Deletes an AD (Active Directory) config for Cloud NetApp Volumes + +EXAMPLES + The following command deletes an AD named AD_NAME with the required + arguments + + $ gcloud alpha netapp active-directories delete AD_NAME \ + --location=us-central1 + + To delete a AD Config asynchronously, run the following command: + + $ gcloud alpha netapp active-directories delete AD_NAME \ + --location=us-central1 --async POSITIONAL ARGUMENTS Active directory resource - The Active Directory to delete. The arguments @@ -61,5 +73,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 beta netapp active-directories delete diff --git a/gcloud/alpha/netapp/active-directories/describe b/gcloud/alpha/netapp/active-directories/describe index e9b79268a..efefed6c9 100644 --- a/gcloud/alpha/netapp/active-directories/describe +++ b/gcloud/alpha/netapp/active-directories/describe @@ -7,7 +7,14 @@ SYNOPSIS (ACTIVE_DIRECTORY : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Show metadata for a Cloud NetApp Active Directory. + (ALPHA) Describes an AD (Active Directory) config for Cloud NetApp Volumes + +EXAMPLES + The following command describes an AD named AD_NAME with the required + arguments + + $ gcloud alpha netapp active-directories describe AD_NAME \ + --location=us-central1 POSITIONAL ARGUMENTS Active directory resource - The Active Directory to describe. The @@ -55,5 +62,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 beta netapp active-directories describe diff --git a/gcloud/alpha/netapp/active-directories/help b/gcloud/alpha/netapp/active-directories/help index dc9c5da44..c68ef3af9 100644 --- a/gcloud/alpha/netapp/active-directories/help +++ b/gcloud/alpha/netapp/active-directories/help @@ -35,5 +35,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 beta netapp active-directories diff --git a/gcloud/alpha/netapp/active-directories/list b/gcloud/alpha/netapp/active-directories/list index 91245585d..78789bee4 100644 --- a/gcloud/alpha/netapp/active-directories/list +++ b/gcloud/alpha/netapp/active-directories/list @@ -8,7 +8,12 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List Cloud NetApp Active Directories. + (ALPHA) Lists AD (Active Directory) configs for Cloud NetApp Volumes + +EXAMPLES + The following command lists AD configs in the given project and location + + $ gcloud alpha netapp active-directories list --location=us-central1 FLAGS Location resource - The location in which to list Active Directories. This @@ -77,5 +82,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 beta netapp active-directories list diff --git a/gcloud/alpha/netapp/active-directories/update b/gcloud/alpha/netapp/active-directories/update index f0354a1f3..6135b4a85 100644 --- a/gcloud/alpha/netapp/active-directories/update +++ b/gcloud/alpha/netapp/active-directories/update @@ -18,7 +18,19 @@ SYNOPSIS [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a Cloud NetApp Active Directory. + (ALPHA) Updates AD (Active Directory) configs for Cloud NetApp Volumes + +EXAMPLES + The following command updates an AD config in the given project and + location with specified arguments + + $ gcloud alpha netapp active-directories update AD_NAME \ + --location=us-central1 --domain=new-domain.com --dns=1.1.1.1 \ + --site=new_site --net-bios-prefix=new_prefix \ + --organizational-unit=ou2 --enable-aes=true --username=user2 \ + --password="secure2" --backup-operators=backup_op3 \ + --security-operators=secure_op3 --enable-ldap-signing=true \ + --encrypt-dc-connections=yes --kdc-hostname=kdc-host1 POSITIONAL ARGUMENTS Active directory resource - The Active Directory to update. The arguments @@ -157,5 +169,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 beta netapp active-directories update diff --git a/gcloud/alpha/netapp/help b/gcloud/alpha/netapp/help index f53d31cfd..16ba32880 100644 --- a/gcloud/alpha/netapp/help +++ b/gcloud/alpha/netapp/help @@ -6,13 +6,14 @@ SYNOPSIS DESCRIPTION (ALPHA) The gcloud netapp command group lets you create, configure and - manipulate Cloud NetApp Files resources such as Volumes, Storage Pools, + manipulate Cloud NetApp Volumes resources such as Volumes, Storage Pools, + Active Directories, KMS Configs, Volume Snapshots, and Volume Replications etc. - With Cloud NetApp Files, you can take advantage of Google Cloud Platform's - scale, performance and value to manage and run on-prem NetApp Files - solutions on Google infrastructure, so you don't have to modernize your - file workloads, and allow for legacy feature support. + With Cloud NetApp Volumes, you can take advantage of Google Cloud + Platform's scale, performance and value to manage and run on-prem NetApp + Files solutions on Google infrastructure, so you don't have to modernize + your file workloads, and allow for legacy feature support. More information on Cloud NetApp Files can be found here: https://cloud.google.com/netapp/docs/reference/rest @@ -44,5 +45,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 beta netapp diff --git a/gcloud/alpha/netapp/locations/describe b/gcloud/alpha/netapp/locations/describe index 2b3e3ce4c..787723653 100644 --- a/gcloud/alpha/netapp/locations/describe +++ b/gcloud/alpha/netapp/locations/describe @@ -45,5 +45,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 beta netapp locations describe diff --git a/gcloud/alpha/netapp/locations/help b/gcloud/alpha/netapp/locations/help index ee9e75154..306dbcd2b 100644 --- a/gcloud/alpha/netapp/locations/help +++ b/gcloud/alpha/netapp/locations/help @@ -26,5 +26,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 beta netapp locations diff --git a/gcloud/alpha/netapp/locations/list b/gcloud/alpha/netapp/locations/list index f8d1592ce..8cb10e29e 100644 --- a/gcloud/alpha/netapp/locations/list +++ b/gcloud/alpha/netapp/locations/list @@ -10,8 +10,7 @@ DESCRIPTION (ALPHA) Lists all Cloud NetApp Files locations. EXAMPLES - The following command shows the details for the NetApp Files location named - NAME. + The following command lists NetApp Files locations. $ gcloud alpha netapp locations list @@ -59,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 beta netapp locations list diff --git a/gcloud/alpha/netapp/operations/describe b/gcloud/alpha/netapp/operations/describe index e59ebe28d..e17b48617 100644 --- a/gcloud/alpha/netapp/operations/describe +++ b/gcloud/alpha/netapp/operations/describe @@ -9,6 +9,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Describe a Cloud NetApp Files operation. +EXAMPLES + The following command shows the details for the NetApp Files operation + named NAME. + + $ gcloud alpha netapp operations describe NAME + POSITIONAL ARGUMENTS Operation resource - The operation to describe. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -54,5 +60,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 beta netapp operations describe diff --git a/gcloud/alpha/netapp/operations/help b/gcloud/alpha/netapp/operations/help index 79cb40011..4d5e6f6d2 100644 --- a/gcloud/alpha/netapp/operations/help +++ b/gcloud/alpha/netapp/operations/help @@ -26,5 +26,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 beta netapp operations diff --git a/gcloud/alpha/netapp/operations/list b/gcloud/alpha/netapp/operations/list index 0b671a1d5..ff3e636c2 100644 --- a/gcloud/alpha/netapp/operations/list +++ b/gcloud/alpha/netapp/operations/list @@ -7,7 +7,12 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List Cloud NetApp Files operations. + (ALPHA) Lists all Cloud NetApp Files operations. + +EXAMPLES + The following command lists NetApp Files operations under a given location + + $ gcloud alpha netapp operations list --location=us-central1 FLAGS Location resource - The location in which to list operations. This @@ -76,5 +81,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 beta netapp operations list diff --git a/gcloud/alpha/netapp/storage-pools/create b/gcloud/alpha/netapp/storage-pools/create index 80811964d..40ecc63cc 100644 --- a/gcloud/alpha/netapp/storage-pools/create +++ b/gcloud/alpha/netapp/storage-pools/create @@ -5,11 +5,25 @@ NAME SYNOPSIS gcloud alpha netapp storage-pools create (STORAGE_POOL : --location=LOCATION) --capacity=CAPACITY - --service-level=SERVICE_LEVEL [--async] [--description=DESCRIPTION] - [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + --network=[name=NAME],[psa-range=PSA-RANGE] + --service-level=SERVICE_LEVEL [--active-directory=ACTIVE_DIRECTORY] + [--async] [--description=DESCRIPTION] [--enable-ldap=ENABLE_LDAP] + [--kms-config=KMS_CONFIG] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a Cloud NetApp Storage Pool. + (ALPHA) Creates a Storage Pool to contain Volumes with a specified Service + Level and capacity. + +EXAMPLES + The following command creates a Storage Pool named NAME using all possible + arguments + + $ gcloud alpha netapp storage-pools create NAME \ + --location=us-central1 --service-level=standard \ + --capacity=2048 --network=name=default --active-directory=ad1 \ + --kms-config=kms-config1 --enable-ldap=true \ + --description="example description" POSITIONAL ARGUMENTS Storage pool resource - The Storage Pool to create. The arguments in this @@ -50,6 +64,18 @@ REQUIRED FLAGS The desired capacity of the Storage Pool in GiB or TiB units.If no capacity unit is specified, GiB is assumed. + --network=[name=NAME],[psa-range=PSA-RANGE] + Network configuration for a Cloud NetApp Files Storage Pool. Specifying + psa-range is optional. + name + The name of the Google Compute Engine VPC network to which the + volume is connected. + psa-range + The psa-range is the name of the allocated range of the Private + Service Access connection. The range you specify can't overlap with + either existing subnets or assigned IP address ranges for other + Cloud NetApp Files Storage Pools in the selected VPC network. + --service-level=SERVICE_LEVEL The service level for the Cloud NetApp Storage Pool. For more details, see: @@ -67,6 +93,30 @@ REQUIRED FLAGS 64 MiB/s. OPTIONAL FLAGS + Active directory resource - The Active Directory to attach to the Storage + Pool. 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 --active-directory on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --active-directory on the command line with a + fully specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --active-directory=ACTIVE_DIRECTORY + ID of the active_directory or fully qualified identifier for the + active_directory. + + To set the active_directory attribute: + ▸ provide the argument --active-directory on the command line. + --async Return immediately, without waiting for the operation in progress to complete. @@ -74,6 +124,34 @@ OPTIONAL FLAGS --description=DESCRIPTION A description of the Cloud NetApp Storage Pool + --enable-ldap=ENABLE_LDAP + Boolean flag indicating whether Storage Pool is a NFS LDAP Storage Pool + or not + + Kms config resource - The KMS config to attach to the Storage Pool. 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 --kms-config on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --kms-config on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --kms-config=KMS_CONFIG + ID of the kms_config or fully qualified identifier for the + kms_config. + + To set the kms_config attribute: + ▸ provide the argument --kms-config on the command line. + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. @@ -94,5 +172,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 beta netapp storage-pools create diff --git a/gcloud/alpha/netapp/storage-pools/delete b/gcloud/alpha/netapp/storage-pools/delete index 46d1c66c6..0d5056aef 100644 --- a/gcloud/alpha/netapp/storage-pools/delete +++ b/gcloud/alpha/netapp/storage-pools/delete @@ -7,7 +7,19 @@ SYNOPSIS (STORAGE_POOL : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a Cloud NetApp Storage Pool. + (ALPHA) Delete a Storage Pool + +EXAMPLES + The following command deletes a Storage Pool named NAME in the given + location + + $ gcloud alpha netapp storage-pools delete NAME \ + --location=us-central1 + + To delete a Storage Pool asynchronously, run the following command: + + $ gcloud alpha netapp storage-pools delete NAME \ + --location=us-central1 --async POSITIONAL ARGUMENTS Storage pool resource - The Storage Pool to delete. The arguments in this @@ -60,5 +72,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 beta netapp storage-pools delete diff --git a/gcloud/alpha/netapp/storage-pools/describe b/gcloud/alpha/netapp/storage-pools/describe index 71bcd2e73..30ac3baa6 100644 --- a/gcloud/alpha/netapp/storage-pools/describe +++ b/gcloud/alpha/netapp/storage-pools/describe @@ -7,7 +7,14 @@ SYNOPSIS (STORAGE_POOL : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Show metadata for a Cloud NetApp Storage Pool. + (ALPHA) Describe a Storage Pool + +EXAMPLES + The following command describes a Storage Pool named NAME in the given + location + + $ gcloud alpha netapp storage-pools describe NAME \ + --location=us-central1 POSITIONAL ARGUMENTS Storage pool resource - The Storage Pool to describe. The arguments in @@ -55,5 +62,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 beta netapp storage-pools describe diff --git a/gcloud/alpha/netapp/storage-pools/help b/gcloud/alpha/netapp/storage-pools/help index 84755e859..5f0052823 100644 --- a/gcloud/alpha/netapp/storage-pools/help +++ b/gcloud/alpha/netapp/storage-pools/help @@ -35,5 +35,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 beta netapp storage-pools diff --git a/gcloud/alpha/netapp/storage-pools/list b/gcloud/alpha/netapp/storage-pools/list index a19096a0a..9cef7348e 100644 --- a/gcloud/alpha/netapp/storage-pools/list +++ b/gcloud/alpha/netapp/storage-pools/list @@ -7,7 +7,12 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List Cloud NetApp Storage Pools. + (ALPHA) Lists Storage Pools + +EXAMPLES + The following command lists Storage Pools in the given location + + $ gcloud alpha netapp storage-pools list --location=us-central1 FLAGS Location resource - The location in which to list Storage Pools. This @@ -76,5 +81,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 beta netapp storage-pools list diff --git a/gcloud/alpha/netapp/storage-pools/update b/gcloud/alpha/netapp/storage-pools/update index bad48d547..4905f90ff 100644 --- a/gcloud/alpha/netapp/storage-pools/update +++ b/gcloud/alpha/netapp/storage-pools/update @@ -4,12 +4,21 @@ NAME SYNOPSIS gcloud alpha netapp storage-pools update - (STORAGE_POOL : --location=LOCATION) [--async] [--capacity=CAPACITY] + (STORAGE_POOL : --location=LOCATION) + [--active-directory=ACTIVE_DIRECTORY] [--async] [--capacity=CAPACITY] [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a Cloud NetApp Storage Pool. + (ALPHA) Updates a Storage Pool with given arguments + +EXAMPLES + The following command updates a Storage Pool named NAME in the given + location + + $ gcloud alpha netapp storage-pools update NAME \ + --location=us-central1 --capacity=4096 --active-directory=ad-2 \ + --description="new description" --update-labels=key1=val1 POSITIONAL ARGUMENTS Storage pool resource - The Storage Pool to update. The arguments in this @@ -46,6 +55,30 @@ POSITIONAL ARGUMENTS ▸ set the property netapp/region. FLAGS + Active directory resource - The Active Directory to attach to the Storage + Pool. 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 --active-directory on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --active-directory on the command line with a + fully specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --active-directory=ACTIVE_DIRECTORY + ID of the active_directory or fully qualified identifier for the + active_directory. + + To set the active_directory attribute: + ▸ provide the argument --active-directory on the command line. + --async Return immediately, without waiting for the operation in progress to complete. @@ -98,5 +131,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 beta netapp storage-pools update diff --git a/gcloud/alpha/netapp/volumes/create b/gcloud/alpha/netapp/volumes/create index b4905c746..b04434b0f 100644 --- a/gcloud/alpha/netapp/volumes/create +++ b/gcloud/alpha/netapp/volumes/create @@ -3,10 +3,9 @@ NAME SYNOPSIS gcloud alpha netapp volumes create (VOLUME : --location=LOCATION) - --capacity=CAPACITY --network=[name=NAME],[psa-range=PSA-RANGE] - --protocols=PROTOCOL,[PROTOCOL,...] --share-name=SHARE_NAME - --storage-pool=STORAGE_POOL [--async] [--description=DESCRIPTION] - [--enable-kerberos=ENABLE_KERBEROS] [--enable-ldap=ENABLE_LDAP] + --capacity=CAPACITY --protocols=PROTOCOL,[PROTOCOL,...] + --share-name=SHARE_NAME --storage-pool=STORAGE_POOL [--async] + [--description=DESCRIPTION] [--enable-kerberos=ENABLE_KERBEROS] [--export-policy=[access-type=ACCESS-TYPE], [allowed-clients=ALLOWED-CLIENTS],[has-root-access=HAS-ROOT-ACCESS], [kerberos-5-read-only=KERBEROS-5-READ-ONLY], @@ -32,7 +31,25 @@ SYNOPSIS [--unix-permissions=UNIX_PERMISSIONS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Create a Cloud NetApp Volume. + (ALPHA) Create a Cloud NetApp Volume + +EXAMPLES + The following command creates a NFS Volume named NAME asynchronously using + the specified arguments + + $ gcloud alpha netapp volumes create NAME --capacity=1024 \ + --protocols=nfsv3,nfsv4 --share-name=share1 --storage-pool=sp1 \ + --description="test description" --enable-kerberos=true \ + --unix-permissions=0755 --async + + The following command creates a SMB Volume named NAME asynchronously using + the specified arguments + + $ gcloud alpha netapp volumes create NAME --capacity=1024 \ + --protocols=smb --share-name=share2 --storage-pool=sp2 \ + --description="test smb" --security-style=ntfs \ + --smb-settings=SHOW_SNAPSHOT,SHOW_PREVIOUS_VERSIONS,\ + ACCESS_BASED_ENUMERATION --snap-reserve=0.1 --async POSITIONAL ARGUMENTS Volume resource - The Volume to create. The arguments in this group can be @@ -71,18 +88,6 @@ REQUIRED FLAGS The desired capacity of the Volume in GiB or TiB units.If no capacity unit is specified, GiB is assumed. - --network=[name=NAME],[psa-range=PSA-RANGE] - Network configuration for a Cloud NetApp Files Volume. Specifying - psa-range is optional. - name - The name of the Google Compute Engine VPC network to which the - volume is connected. - psa-range - The psa-range is the name of the allocated range of the Private - Service Access connection. The range you specify can't overlap with - either existing subnets or assigned IP address ranges for other - Cloud NetApp Files Volumes in the selected VPC network. - --protocols=PROTOCOL,[PROTOCOL,...] Type of File System protocols for the Cloud NetApp Files VolumeValid component values are: NFSV3, NFSV4, SMB @@ -129,9 +134,6 @@ OPTIONAL FLAGS --enable-kerberos=ENABLE_KERBEROS Boolean flag indicating whether Volume is a kerberos Volume or not - --enable-ldap=ENABLE_LDAP - Boolean flag indicating whether Volume is a NFS LDAP Volume or not - --export-policy=[access-type=ACCESS-TYPE],[allowed-clients=ALLOWED-CLIENTS],[has-root-access=HAS-ROOT-ACCESS],[kerberos-5-read-only=KERBEROS-5-READ-ONLY],[kerberos-5-read-write=KERBEROS-5-READ-WRITE],[kerberos-5i-read-only=KERBEROS-5I-READ-ONLY],[kerberos-5i-read-write=KERBEROS-5I-READ-WRITE],[kerberos-5p-read-only=KERBEROS-5P-READ-ONLY],[kerberos-5p-read-write=KERBEROS-5P-READ-WRITE],[nfsv3=NFSV3],[nfsv4=NFSV4] Export Policy of a Cloud NetApp Files Volume. This will be a field similar to network in which export policy fields can be specified as @@ -235,5 +237,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 beta netapp volumes create diff --git a/gcloud/alpha/netapp/volumes/delete b/gcloud/alpha/netapp/volumes/delete index dc3ede58e..87a44bda2 100644 --- a/gcloud/alpha/netapp/volumes/delete +++ b/gcloud/alpha/netapp/volumes/delete @@ -6,7 +6,17 @@ SYNOPSIS [--force] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a Cloud NetApp Volume. + (ALPHA) Delete a Cloud NetApp Volume + +EXAMPLES + The following command deletes a Volume named NAME in the given location + + $ gcloud alpha netapp volumes delete NAME --location=us-central1 + + To delete a Volume named NAME asynchronously, run the following command: + + $ gcloud alpha netapp volumes delete NAME --location=us-central1 \ + --async POSITIONAL ARGUMENTS Volume resource - The Volume to delete. The arguments in this group can be @@ -61,5 +71,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 beta netapp volumes delete diff --git a/gcloud/alpha/netapp/volumes/describe b/gcloud/alpha/netapp/volumes/describe index ff25e59f2..21846a851 100644 --- a/gcloud/alpha/netapp/volumes/describe +++ b/gcloud/alpha/netapp/volumes/describe @@ -7,7 +7,12 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Show metadata for a Cloud NetApp Volume. + (ALPHA) Describe a Cloud NetApp Volume + +EXAMPLES + The following command describe a Volume named NAME in the given location + + $ gcloud alpha netapp volumes describe NAME --location=us-central1 POSITIONAL ARGUMENTS Volume resource - The Volume to describe. The arguments in this group can @@ -53,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 beta netapp volumes describe diff --git a/gcloud/alpha/netapp/volumes/help b/gcloud/alpha/netapp/volumes/help index 65bfe3a95..b92b10c9b 100644 --- a/gcloud/alpha/netapp/volumes/help +++ b/gcloud/alpha/netapp/volumes/help @@ -43,5 +43,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 beta netapp volumes diff --git a/gcloud/alpha/netapp/volumes/list b/gcloud/alpha/netapp/volumes/list index db7294a34..793bdacd4 100644 --- a/gcloud/alpha/netapp/volumes/list +++ b/gcloud/alpha/netapp/volumes/list @@ -7,7 +7,12 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List Cloud NetApp Volumes. + (ALPHA) Lists Cloud NetApp Volumes + +EXAMPLES + The following command lists all Volumes in the given location + + $ gcloud alpha netapp volumes list --location=us-central1 FLAGS Location resource - The location in which to list Volumes. This represents @@ -76,5 +81,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 beta netapp volumes list diff --git a/gcloud/alpha/netapp/volumes/revert b/gcloud/alpha/netapp/volumes/revert index 7c2c2e79a..ecc465968 100644 --- a/gcloud/alpha/netapp/volumes/revert +++ b/gcloud/alpha/netapp/volumes/revert @@ -7,7 +7,14 @@ SYNOPSIS --snapshot=SNAPSHOT [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Revert a Cloud NetApp Volume back to a specified Snapshot. + (ALPHA) Revert a Cloud NetApp Volume back to a specified source Snapshot + +EXAMPLES + The following command reverts a Volume named NAME in the given location and + snapshot + + $ gcloud alpha netapp volumes revert NAME --location=us-central1 \ + --snapshot="snapshot1" POSITIONAL ARGUMENTS Volume resource - The Volume to revert. The arguments in this group can be @@ -87,5 +94,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 beta netapp volumes revert diff --git a/gcloud/alpha/netapp/volumes/snapshots/create b/gcloud/alpha/netapp/volumes/snapshots/create index f30152e0f..0247e425c 100644 --- a/gcloud/alpha/netapp/volumes/snapshots/create +++ b/gcloud/alpha/netapp/volumes/snapshots/create @@ -8,7 +8,14 @@ SYNOPSIS [--labels=[KEY=VALUE,...]] [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Creates a Cloud NetApp Volume Snapshot. + (ALPHA) Create a Cloud NetApp Volume Snapshot + +EXAMPLES + The following command creates a Snapshot named NAME using the required + arguments + + $ gcloud alpha netapp volumes snapshots create NAME \ + --location=us-central1 --volume=vol1 POSITIONAL ARGUMENTS Snapshot resource - The Snapshot to create. The arguments in this group @@ -99,5 +106,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 beta netapp volumes snapshots create diff --git a/gcloud/alpha/netapp/volumes/snapshots/delete b/gcloud/alpha/netapp/volumes/snapshots/delete index b9f032866..1cbcc9a83 100644 --- a/gcloud/alpha/netapp/volumes/snapshots/delete +++ b/gcloud/alpha/netapp/volumes/snapshots/delete @@ -8,7 +8,19 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Delete a Cloud NetApp Volume Snapshot. + (ALPHA) Delete a Cloud NetApp Volume Snapshot + +EXAMPLES + The following command deletes a Snapshot named NAME in the given location + and volume + + $ gcloud alpha netapp volumes snapshots delete NAME \ + --location=us-central1 --volume=vol1 + + To delete a Snapshot named NAME asynchronously, run the following command: + + $ gcloud alpha netapp volumes snapshots delete NAME \ + --location=us-central1 --volume=vol1 --async POSITIONAL ARGUMENTS Snapshot resource - The Snapshot to delete. The arguments in this group @@ -88,5 +100,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 beta netapp volumes snapshots delete diff --git a/gcloud/alpha/netapp/volumes/snapshots/describe b/gcloud/alpha/netapp/volumes/snapshots/describe index f6d3533dd..f67fe7c3a 100644 --- a/gcloud/alpha/netapp/volumes/snapshots/describe +++ b/gcloud/alpha/netapp/volumes/snapshots/describe @@ -8,7 +8,14 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Describe a Cloud NetApp Volume Snapshot. + (ALPHA) Describe a Cloud NetApp Volume Snapshot + +EXAMPLES + The following command describes a Snapshot named NAME in the given location + and volume + + $ gcloud alpha netapp volumes snapshots describe NAME \ + --location=us-central1 --volume=vol1 POSITIONAL ARGUMENTS Snapshot resource - The Snapshot to describe. The arguments in this group @@ -84,5 +91,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 beta netapp volumes snapshots describe diff --git a/gcloud/alpha/netapp/volumes/snapshots/help b/gcloud/alpha/netapp/volumes/snapshots/help index 5b8469da8..9a8f673b7 100644 --- a/gcloud/alpha/netapp/volumes/snapshots/help +++ b/gcloud/alpha/netapp/volumes/snapshots/help @@ -35,5 +35,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 beta netapp volumes snapshots diff --git a/gcloud/alpha/netapp/volumes/snapshots/list b/gcloud/alpha/netapp/volumes/snapshots/list index 6c6e8b1c7..b92188a05 100644 --- a/gcloud/alpha/netapp/volumes/snapshots/list +++ b/gcloud/alpha/netapp/volumes/snapshots/list @@ -9,7 +9,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List Cloud NetApp Volume Snapshots. + (ALPHA) Lists Cloud NetApp Volume Snapshots + +EXAMPLES + The following command lists all Snapshots in the given location and volume + + $ gcloud alpha netapp volumes snapshots list \ + --location=us-central1 --volume=vol1 FLAGS Location resource - The location in which to list Volume Snapshots. This @@ -101,5 +107,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 beta netapp volumes snapshots list diff --git a/gcloud/alpha/netapp/volumes/snapshots/update b/gcloud/alpha/netapp/volumes/snapshots/update index 086cfc7d7..43f6cd8c2 100644 --- a/gcloud/alpha/netapp/volumes/snapshots/update +++ b/gcloud/alpha/netapp/volumes/snapshots/update @@ -9,7 +9,15 @@ SYNOPSIS [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a Cloud NetApp Volume Snapshot. + (ALPHA) Update a Cloud NetApp Volume Snapshot and its specified parameters + +EXAMPLES + The following command updates a Snapshot named NAME and its specified + parameters + + $ gcloud alpha netapp volumes snapshots update NAME \ + --location=us-central1 --description="new" \ + --update-labels=key2=val2 --volume=vol1 POSITIONAL ARGUMENTS Snapshot resource - The Snapshot to update. The arguments in this group @@ -121,5 +129,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 beta netapp volumes snapshots update diff --git a/gcloud/alpha/netapp/volumes/update b/gcloud/alpha/netapp/volumes/update index 2efcca13e..67b7cad45 100644 --- a/gcloud/alpha/netapp/volumes/update +++ b/gcloud/alpha/netapp/volumes/update @@ -32,7 +32,16 @@ SYNOPSIS [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update a Cloud NetApp Volume. + (ALPHA) Update a Cloud NetApp Volume and its specified parameters + +EXAMPLES + The following command updates a Volume named NAME and its specified + parameters + + $ gcloud alpha netapp volumes update NAME --location=us-central1 \ + --capacity=4096 --description="new description" \ + --enable-kerberos=false --storage-pool=sp3 \ + --unix-permissions=0777 POSITIONAL ARGUMENTS Volume resource - The Volume to update. The arguments in this group can be @@ -238,5 +247,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 beta netapp volumes update diff --git a/gcloud/alpha/network-security/firewall-endpoint-associations/create b/gcloud/alpha/network-security/firewall-endpoint-associations/create index 3aa6a7596..f9c845f96 100644 --- a/gcloud/alpha/network-security/firewall-endpoint-associations/create +++ b/gcloud/alpha/network-security/firewall-endpoint-associations/create @@ -8,7 +8,8 @@ SYNOPSIS (--endpoint=ENDPOINT : --endpoint-zone=ENDPOINT_ZONE --organization=ORGANIZATION) [--async] [--labels=[KEY=VALUE,...]] - [--max-wait=MAX_WAIT; default="60m"] [GCLOUD_WIDE_FLAG ...] + [--max-wait=MAX_WAIT; default="60m"] + [--tls-inspection-policy=TLS_INSPECTION_POLICY] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Associate the specified network with the firewall endpoint. @@ -134,6 +135,10 @@ OPTIONAL FLAGS specified. See $ gcloud topic datetimes for information on time formats. + --tls-inspection-policy=TLS_INSPECTION_POLICY + Path to TLS Inspection Policy configuration to use for intercepting + TLS-encrypted traffic in this network. + 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/pubsub/subscriptions/create b/gcloud/alpha/pubsub/subscriptions/create index 6d7489b86..2391a7ddc 100644 --- a/gcloud/alpha/pubsub/subscriptions/create +++ b/gcloud/alpha/pubsub/subscriptions/create @@ -141,31 +141,33 @@ OPTIONAL FLAGS --message-retention-duration window. Acknowledged messages are not retained by default. - BigQuery Config Options. The Cloud Pub/Sub service account associated with - the enclosing subscription's parent project (i.e., - service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have - permission to write to this BigQuery table. + At most one of these can be specified: - --bigquery-table=BIGQUERY_TABLE - A BigQuery table of the form {project}:{dataset_name}.{table_name} to - which to write messages for this subscription. + BigQuery Config Options. The Cloud Pub/Sub service account associated + with the enclosing subscription's parent project (i.e., + service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must + have permission to write to this BigQuery table. - This flag argument must be specified if any of the other arguments in - this group are specified. + --bigquery-table=BIGQUERY_TABLE + A BigQuery table of the form {project}:{dataset_name}.{table_name} + to which to write messages for this subscription. - --drop-unknown-fields - When --use-topic-schema is set, whether or not to ignore fields in - the topic schema that do not appear in the BigQuery schema. If false, - then the BigQuery schema must contain all fields that are also - present in the topic schema. + This flag argument must be specified if any of the other arguments + in this group are specified. - --use-topic-schema - Whether or not to use the schema for the subscription's topic (if it - exists) when writing messages to BigQuery. + --drop-unknown-fields + When --use-topic-schema is set, whether or not to ignore fields in + the topic schema that do not appear in the BigQuery schema. If + false, then the BigQuery schema must contain all fields that are + also present in the topic schema. - --write-metadata - Whether or not to write message metadata including message ID, - publish timestamp, ordering key, and attributes to BigQuery. + --use-topic-schema + Whether or not to use the schema for the subscription's topic (if + it exists) when writing messages to BigQuery. + + --write-metadata + Whether or not to write message metadata including message ID, + publish timestamp, ordering key, and attributes to BigQuery. Dead Letter Queue Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., diff --git a/gcloud/alpha/pubsub/subscriptions/update b/gcloud/alpha/pubsub/subscriptions/update index 51bceaf58..7e4125983 100644 --- a/gcloud/alpha/pubsub/subscriptions/update +++ b/gcloud/alpha/pubsub/subscriptions/update @@ -106,34 +106,37 @@ FLAGS At most one of these can be specified: - --clear-bigquery-config - If set, clear the BigQuery config from the subscription. + At most one of these can be specified: - BigQuery Config Options. The Cloud Pub/Sub service account associated - with the enclosing subscription's parent project (i.e., - service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must - have permission to write to this BigQuery table. + --clear-bigquery-config + If set, clear the BigQuery config from the subscription. - --bigquery-table=BIGQUERY_TABLE - A BigQuery table of the form {project}:{dataset_name}.{table_name} - to which to write messages for this subscription. + BigQuery Config Options. The Cloud Pub/Sub service account associated + with the enclosing subscription's parent project (i.e., + service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must + have permission to write to this BigQuery table. - This flag argument must be specified if any of the other arguments - in this group are specified. + --bigquery-table=BIGQUERY_TABLE + A BigQuery table of the form + {project}:{dataset_name}.{table_name} to which to write messages + for this subscription. - --drop-unknown-fields - When --use-topic-schema is set, whether or not to ignore fields in - the topic schema that do not appear in the BigQuery schema. If - false, then the BigQuery schema must contain all fields that are - also present in the topic schema. + This flag argument must be specified if any of the other + arguments in this group are specified. - --use-topic-schema - Whether or not to use the schema for the subscription's topic (if - it exists) when writing messages to BigQuery. + --drop-unknown-fields + When --use-topic-schema is set, whether or not to ignore fields + in the topic schema that do not appear in the BigQuery schema. If + false, then the BigQuery schema must contain all fields that are + also present in the topic schema. - --write-metadata - Whether or not to write message metadata including message ID, - publish timestamp, ordering key, and attributes to BigQuery. + --use-topic-schema + Whether or not to use the schema for the subscription's topic (if + it exists) when writing messages to BigQuery. + + --write-metadata + Whether or not to write message metadata including message ID, + publish timestamp, ordering key, and attributes to BigQuery. At most one of these can be specified: diff --git a/gcloud/alpha/run/services/proxy b/gcloud/alpha/run/services/proxy index c1c607ff6..bc4051b26 100644 --- a/gcloud/alpha/run/services/proxy +++ b/gcloud/alpha/run/services/proxy @@ -162,7 +162,9 @@ 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: + access allowlist. These variants are also available: + + $ gcloud run services proxy $ gcloud beta run services proxy diff --git a/gcloud/alpha/sql/instances/create b/gcloud/alpha/sql/instances/create index eeb3c946d..dfdd7f886 100644 --- a/gcloud/alpha/sql/instances/create +++ b/gcloud/alpha/sql/instances/create @@ -99,10 +99,10 @@ FLAGS --activation-policy=ACTIVATION_POLICY Activation policy for this instance. This specifies when the instance should be activated and is applicable only when the instance state is - RUNNABLE. The default is on-demand. More information on activation + RUNNABLE. The default is always. More information on activation policies can be found here: https://cloud.google.com/sql/docs/mysql/start-stop-restart-instance#activation_policy. - ACTIVATION_POLICY must be one of: always, never, on-demand. + ACTIVATION_POLICY must be one of: always, never. --active-directory-domain=ACTIVE_DIRECTORY_DOMAIN Managed Service for Microsoft Active Directory domain this instance is diff --git a/gcloud/alpha/sql/instances/patch b/gcloud/alpha/sql/instances/patch index a9a077886..b9ee154ec 100644 --- a/gcloud/alpha/sql/instances/patch +++ b/gcloud/alpha/sql/instances/patch @@ -63,10 +63,10 @@ FLAGS --activation-policy=ACTIVATION_POLICY Activation policy for this instance. This specifies when the instance should be activated and is applicable only when the instance state is - RUNNABLE. The default is on-demand. More information on activation + RUNNABLE. The default is always. More information on activation policies can be found here: https://cloud.google.com/sql/docs/mysql/start-stop-restart-instance#activation_policy. - ACTIVATION_POLICY must be one of: always, never, on-demand. + ACTIVATION_POLICY must be one of: always, never. --active-directory-domain=ACTIVE_DIRECTORY_DOMAIN Managed Service for Microsoft Active Directory domain this instance is diff --git a/gcloud/alpha/storage/buckets/create b/gcloud/alpha/storage/buckets/create index 30a63f04b..af8630891 100644 --- a/gcloud/alpha/storage/buckets/create +++ b/gcloud/alpha/storage/buckets/create @@ -82,9 +82,9 @@ FLAGS dual-regions buckets. ASYNC_TURBO option is only valid for dual-region buckets. If unspecified when the bucket is created, it defaults to DEFAULT for dual-region and multi-region buckets. For more information, - see Turbo Replication - (https://cloud.google.com/storage/docs/turbo-replication). SETTING must - be one of: ASYNC_TURBO, DEFAULT. + see replication in Cloud Storage + (https://cloud.google.com/storage/docs/availability-durability#cross-region-redundancy). + SETTING must be one of: ASYNC_TURBO, DEFAULT. --retention-period=RETENTION_PERIOD Minimum retention period diff --git a/gcloud/alpha/storage/buckets/update b/gcloud/alpha/storage/buckets/update index 6d403facb..4d114c4af 100644 --- a/gcloud/alpha/storage/buckets/update +++ b/gcloud/alpha/storage/buckets/update @@ -90,9 +90,9 @@ FLAGS dual-regions buckets. ASYNC_TURBO option is only valid for dual-region buckets. If unspecified when the bucket is created, it defaults to DEFAULT for dual-region and multi-region buckets. For more information, - see Turbo Replication - (https://cloud.google.com/storage/docs/turbo-replication). SETTING must - be one of: ASYNC_TURBO, DEFAULT. + see replication in Cloud Storage + (https://cloud.google.com/storage/docs/availability-durability#cross-region-redundancy). + SETTING must be one of: ASYNC_TURBO, DEFAULT. --[no-]requester-pays Allows you to configure a Cloud Storage bucket so that the requester diff --git a/gcloud/alpha/transfer/jobs/create b/gcloud/alpha/transfer/jobs/create index 672cee45e..33a65d8df 100644 --- a/gcloud/alpha/transfer/jobs/create +++ b/gcloud/alpha/transfer/jobs/create @@ -302,7 +302,7 @@ FLAGS https://cloud.google.com/storage-transfer/docs/metadata-preservation. METADATA_FIELDS must be one of: acl, gid, kms-key, mode, - storage-class, symlink, temporary-hold, uid. + storage-class, symlink, temporary-hold, time-created, uid. --custom-storage-class=CUSTOM_STORAGE_CLASS Specifies the storage class to set on objects being transferred to diff --git a/gcloud/alpha/transfer/jobs/update b/gcloud/alpha/transfer/jobs/update index 82a7ad209..a0d176574 100644 --- a/gcloud/alpha/transfer/jobs/update +++ b/gcloud/alpha/transfer/jobs/update @@ -363,7 +363,7 @@ FLAGS https://cloud.google.com/storage-transfer/docs/metadata-preservation. METADATA_FIELDS must be one of: acl, gid, kms-key, mode, - storage-class, symlink, temporary-hold, uid. + storage-class, symlink, temporary-hold, time-created, uid. --custom-storage-class=CUSTOM_STORAGE_CLASS Specifies the storage class to set on objects being transferred to diff --git a/gcloud/beta/compute/disks/create b/gcloud/beta/compute/disks/create index 419bbd4b7..d892046e6 100644 --- a/gcloud/beta/compute/disks/create +++ b/gcloud/beta/compute/disks/create @@ -16,7 +16,9 @@ SYNOPSIS [--image-family-scope=IMAGE_FAMILY_SCOPE --image-project=IMAGE_PROJECT --image=IMAGE | --image-family=IMAGE_FAMILY | --primary-disk=PRIMARY_DISK - | --source-disk=SOURCE_DISK | --source-snapshot=SOURCE_SNAPSHOT] + | --source-disk=SOURCE_DISK + | --source-instant-snapshot=SOURCE_INSTANT_SNAPSHOT + | --source-snapshot=SOURCE_SNAPSHOT] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [--primary-disk-region=PRIMARY_DISK_REGION @@ -220,6 +222,9 @@ FLAGS The source disk must be in the same zone/region as the disk to be created. + --source-instant-snapshot=SOURCE_INSTANT_SNAPSHOT + Source instant snapshot used to create the disks. + --source-snapshot=SOURCE_SNAPSHOT Source snapshot used to create the disks. It is safe to delete a snapshot after a disk has been created from the snapshot. In such diff --git a/gcloud/beta/compute/help b/gcloud/beta/compute/help index b87f78f09..1d430fc30 100644 --- a/gcloud/beta/compute/help +++ b/gcloud/beta/compute/help @@ -84,6 +84,9 @@ GROUPS instances (BETA) Read and manipulate Compute Engine virtual machine instances. + instant-snapshots + (BETA) Create, list and delete Compute Engine instant snapshots. + interconnects (BETA) Read and manipulate Compute Engine interconnects. diff --git a/gcloud/beta/compute/instances/create b/gcloud/beta/compute/instances/create index 2158a702d..37cda3138 100644 --- a/gcloud/beta/compute/instances/create +++ b/gcloud/beta/compute/instances/create @@ -12,8 +12,8 @@ SYNOPSIS [--can-ip-forward] [--confidential-compute] [--create-disk=[PROPERTY=VALUE,...]] [--csek-key-file=FILE] [--deletion-protection] [--description=DESCRIPTION] - [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT], - [device-name=DEVICE-NAME],[mode=MODE],[name=NAME],[scope=SCOPE]] + [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME], + [force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]] [--enable-display-device] [--[no-]enable-nested-virtualization] [--[no-]enable-uefi-networking] [--erase-windows-vss-signature] [--external-ipv6-address=EXTERNAL_IPV6_ADDRESS] @@ -367,7 +367,7 @@ FLAGS --description=DESCRIPTION Specifies a textual description of the instances. - --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME],[scope=SCOPE] + --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE] Attaches persistent disks to the instances. The disks specified must already exist. @@ -404,6 +404,10 @@ FLAGS zonal disk in the same zone as the instance (default). If regional, the disk is interpreted as a regional disk in the same region as the instance. The default value for this is zonal. + force-attach + If yes, this persistent disk will force-attached to the instance + even it is already attached to another instance. The default value + is 'no'. --enable-display-device Enable a display device on VM instances. Disabled by default. diff --git a/gcloud/beta/compute/instances/create-with-container b/gcloud/beta/compute/instances/create-with-container index ee8191dbd..e06993ec2 100644 --- a/gcloud/beta/compute/instances/create-with-container +++ b/gcloud/beta/compute/instances/create-with-container @@ -23,8 +23,8 @@ SYNOPSIS [--container-restart-policy=POLICY; default="always"] [--container-stdin] [--container-tty] [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION] - [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT], - [device-name=DEVICE-NAME],[mode=MODE],[name=NAME],[scope=SCOPE]] + [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME], + [force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]] [--[no-]enable-nested-virtualization] [--external-ipv6-address=EXTERNAL_IPV6_ADDRESS] [--external-ipv6-prefix-length=EXTERNAL_IPV6_PREFIX_LENGTH] @@ -363,7 +363,7 @@ FLAGS --description=DESCRIPTION Specifies a textual description of the instances. - --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME],[scope=SCOPE] + --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE] Attaches persistent disks to the instances. The disks specified must already exist. @@ -404,6 +404,10 @@ FLAGS zonal disk in the same zone as the instance (default). If regional, the disk is interpreted as a regional disk in the same region as the instance. The default value for this is zonal. + force-attach + If yes, this persistent disk will force-attached to the instance + even it is already attached to another instance. The default value + is 'no'. --[no-]enable-nested-virtualization If set to true, enables nested virtualization for the instance. Use diff --git a/gcloud/beta/compute/instances/network-interfaces/update b/gcloud/beta/compute/instances/network-interfaces/update index bcafec2e6..15e2e00f9 100644 --- a/gcloud/beta/compute/instances/network-interfaces/update +++ b/gcloud/beta/compute/instances/network-interfaces/update @@ -10,8 +10,11 @@ SYNOPSIS [--internal-ipv6-prefix-length=INTERNAL_IPV6_PREFIX_LENGTH] [--ipv6-network-tier=IPV6_NETWORK_TIER] [--network=NETWORK] [--network-interface=NETWORK_INTERFACE; default="nic0"] - [--private-network-ip=PRIVATE_NETWORK_IP] [--stack-type=STACK_TYPE] - [--subnetwork=SUBNETWORK] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + [--private-network-ip=PRIVATE_NETWORK_IP] + [--security-policy=SECURITY_POLICY] + [--security-policy-region=SECURITY_POLICY_REGION] + [--stack-type=STACK_TYPE] [--subnetwork=SUBNETWORK] [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute instances network-interfaces update updates @@ -91,6 +94,15 @@ FLAGS available in the new subnetwork, then another available IP address will be allocated automatically from the new subnetwork CIDR range. + --security-policy=SECURITY_POLICY + The security policy that will be set for this instance network + interface. To remove the policy from this instance network interface + set the policy to an empty string. + + --security-policy-region=SECURITY_POLICY_REGION + Region of the security policy to operate on. Overrides the default + compute/region property value for this command invocation. + --stack-type=STACK_TYPE The stack type for the default network interface. Determines if IPv6 is enabled on the default network interface. STACK_TYPE must be one of: diff --git a/gcloud/beta/compute/instant-snapshots/add-labels b/gcloud/beta/compute/instant-snapshots/add-labels new file mode 100644 index 000000000..7319b582f --- /dev/null +++ b/gcloud/beta/compute/instant-snapshots/add-labels @@ -0,0 +1,95 @@ +NAME + gcloud beta compute instant-snapshots add-labels - add labels to Google + Compute Engine instant-snapshotss + +SYNOPSIS + gcloud beta compute instant-snapshots add-labels INSTANT_SNAPSHOT_NAME + --labels=[KEY=VALUE,...] [--region=REGION | --zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute instant-snapshots add-labels adds labels to a + Google Compute Engine instant-snapshots. + +EXAMPLES + To add key-value pairs k0=v0 and k1=v1 to 'example-instant-snapshots' + + $ gcloud beta compute instant-snapshots add-labels \ + example-instant-snapshots --labels=k0=v0,k1=v1 + + Labels can be used to identify the instant-snapshots and to filter them. To + find a instant-snapshots labeled with key-value pair k1, v2 + + $ gcloud beta compute instant-snapshots list --filter='labels.k1:v2' + + To list only the labels when describing a resource, use --format + + $ gcloud beta compute instant-snapshots describe \ + example-instant-snapshots --format='default(labels)' + +POSITIONAL ARGUMENTS + INSTANT_SNAPSHOT_NAME + Name of the instant snapshot to operate on. + +REQUIRED FLAGS + --labels=[KEY=VALUE,...] + A list of labels to add. + +OPTIONAL FLAGS + At most one of these can be specified: + + --region=REGION + Region of the instant snapshot to operate on. If not specified, you + might be prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + --zone=ZONE + Zone of the instant snapshot to operate on. If not specified and the + compute/zone property isn't set, you might be prompted to select a + zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +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 compute instant-snapshots add-labels + diff --git a/gcloud/beta/compute/instant-snapshots/create b/gcloud/beta/compute/instant-snapshots/create new file mode 100644 index 000000000..35b979831 --- /dev/null +++ b/gcloud/beta/compute/instant-snapshots/create @@ -0,0 +1,99 @@ +NAME + gcloud beta compute instant-snapshots create - create a Compute Engine + instant snapshot + +SYNOPSIS + gcloud beta compute instant-snapshots create INSTANT_SNAPSHOT_NAME + --source-disk=SOURCE_DISK [--labels=[KEY=VALUE,...]] + [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute instant-snapshots create creates an instant + snapshot of persistent disk. Instant snapshots are useful for backing up + persistent disk data. + +EXAMPLES + To create an instant snapshot 'my-instant-snap' from a disk 'my-disk' in + zone 'us-east1-a', run: + + $ gcloud beta compute instant-snapshots create my-instant-snap \ + --source-disk=my-disk --zone=us-east1-a + +POSITIONAL ARGUMENTS + INSTANT_SNAPSHOT_NAME + Name of the instant snapshot to create. + +REQUIRED FLAGS + Source disk options + + This must be specified. + + --source-disk=SOURCE_DISK + Source disk used to create the instant snapshot. + +OPTIONAL FLAGS + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --region=REGION + Region of the instant snapshot to create. If not specified, you might + be prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + --zone=ZONE + Zone of the instant snapshot to create. If not specified and the + compute/zone property isn't set, you might be prompted to select a + zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +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 compute instant-snapshots create + diff --git a/gcloud/beta/compute/instant-snapshots/delete b/gcloud/beta/compute/instant-snapshots/delete new file mode 100644 index 000000000..132b8b3ee --- /dev/null +++ b/gcloud/beta/compute/instant-snapshots/delete @@ -0,0 +1,93 @@ +NAME + gcloud beta compute instant-snapshots delete - delete a Compute Engine + instant snapshot + +SYNOPSIS + gcloud beta compute instant-snapshots delete INSTANT_SNAPSHOT_NAME + [INSTANT_SNAPSHOT_NAME ...] [--region=REGION | --zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute instant-snapshots delete deletes a Compute + Engine instant snapshot. A disk can be deleted only if it is not attached + to any virtual machine instances. + +EXAMPLES + To delete Compute Engine instant snapshots with the names + 'instant-snapshot-1' and 'instant-snapshot-2', run: + + $ gcloud beta compute instant-snapshots delete instant-snapshot-1 \ + instant-snapshot-2 + + To list all instant snapshots that were created before a specific date, use + the --filter flag with the gcloud beta compute instant-snapshots list + command. + + $ gcloud beta compute instant-snapshots list \ + --filter="creationTimestamp<'2017-01-01'" + + For more information on how to use --filter with the list command, run $ + gcloud topic filters. + +POSITIONAL ARGUMENTS + INSTANT_SNAPSHOT_NAME [INSTANT_SNAPSHOT_NAME ...] + Names of the instant snapshots to delete. + +FLAGS + At most one of these can be specified: + + --region=REGION + Region of the instant snapshots to delete. If not specified, you + might be prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + --zone=ZONE + Zone of the instant snapshots to delete. If not specified and the + compute/zone property isn't set, you might be prompted to select a + zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +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 compute instant-snapshots delete + diff --git a/gcloud/beta/compute/instant-snapshots/describe b/gcloud/beta/compute/instant-snapshots/describe new file mode 100644 index 000000000..811bff95f --- /dev/null +++ b/gcloud/beta/compute/instant-snapshots/describe @@ -0,0 +1,81 @@ +NAME + gcloud beta compute instant-snapshots describe - describe a Compute Engine + instant snapshot + +SYNOPSIS + gcloud beta compute instant-snapshots describe INSTANT_SNAPSHOT_NAME + [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute instant-snapshots describe displays all data + associated with a Compute Engine instant snapshot in a project. + +EXAMPLES + To describe the instant snapshot 'instant-snapshot-1' in zone 'us-east1-a', + run: + + $ gcloud beta compute instant-snapshots describe \ + instant-snapshot-1 --zone=us-east1-a + +POSITIONAL ARGUMENTS + INSTANT_SNAPSHOT_NAME + Name of the instant snapshot to describe. + +FLAGS + At most one of these can be specified: + + --region=REGION + Region of the instant snapshot to describe. If not specified, you + might be prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + --zone=ZONE + Zone of the instant snapshot to describe. If not specified and the + compute/zone property isn't set, you might be prompted to select a + zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +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 compute instant-snapshots describe + diff --git a/gcloud/beta/compute/instant-snapshots/help b/gcloud/beta/compute/instant-snapshots/help new file mode 100644 index 000000000..ffce92e7b --- /dev/null +++ b/gcloud/beta/compute/instant-snapshots/help @@ -0,0 +1,42 @@ +NAME + gcloud beta compute instant-snapshots - create, list and delete Compute + Engine instant snapshots + +SYNOPSIS + gcloud beta compute instant-snapshots COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List, create, describe, and delete Compute Engine instant snapshots. + + See also: Snapshots API + (https://cloud.google.com/compute/docs/reference/rest/beta/instantSnapshots). + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + add-labels + (BETA) Add labels to Google Compute Engine instant-snapshotss. + + create + (BETA) Create a Compute Engine instant snapshot. + + delete + (BETA) Delete a Compute Engine instant snapshot. + + describe + (BETA) Describe a Compute Engine instant snapshot. + + list + (BETA) List Google Compute Engine instant snapshots. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute instant-snapshots + diff --git a/gcloud/beta/compute/instant-snapshots/list b/gcloud/beta/compute/instant-snapshots/list new file mode 100644 index 000000000..fd87f77ff --- /dev/null +++ b/gcloud/beta/compute/instant-snapshots/list @@ -0,0 +1,112 @@ +NAME + gcloud beta compute instant-snapshots list - list Google Compute Engine + instant snapshots + +SYNOPSIS + gcloud beta compute instant-snapshots list [NAME ...] + [--regexp=REGEXP, -r REGEXP] + [--regions=[REGION,...] | --zones=[ZONE,...]] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute instant-snapshots list displays all Google + Compute Engine instant snapshots in a project. + + By default, instant snapshots from all regions and instant snapshots from + all zones are listed. The results can be narrowed down by providing the + --regions or --zones flag. + +EXAMPLES + To list all instant snapshots in a project in table form, run: + + $ gcloud beta compute instant-snapshots list + + To list the URIs of all instant snapshots in a project, run: + + $ gcloud beta compute instant-snapshots list --uri + + To list all instant snapshots in the us-central1 and europe-west1 regions, + given they are regional resources, run: + + $ gcloud beta compute instant-snapshots list \ + --filter="region:( europe-west1 us-central1 )" + + To list all instant snapshots in zones us-central1-b and europe-west1-d, + given they are zonal resources, run: + + $ gcloud beta compute instant-snapshots list \ + --filter="zone:( europe-west1-d us-central1-b )" + +POSITIONAL ARGUMENTS + [NAME ...] + (DEPRECATED) If provided, show details for the specified names and/or + URIs of resources. + + Argument NAME is deprecated. Use --filter="name=( 'NAME' ... )" + instead. + +FLAGS + --regexp=REGEXP, -r REGEXP + (DEPRECATED) Regular expression to filter the names of the results on. + Any names that do not match the entire regular expression will be + filtered out. + + Flag --regexp is deprecated. Use --filter="name~'REGEXP'" instead. + + At most one of these can be specified: + + --regions=[REGION,...] + If provided, only regional resources are shown. If arguments are + provided, only resources from the given regions are shown. + + --zones=[ZONE,...] + If provided, only zonal resources are shown. If arguments are + provided, only resources from the given zones are shown. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute instant-snapshots list + diff --git a/gcloud/beta/compute/security-policies/add-user-defined-field b/gcloud/beta/compute/security-policies/add-user-defined-field new file mode 100644 index 000000000..649e9263c --- /dev/null +++ b/gcloud/beta/compute/security-policies/add-user-defined-field @@ -0,0 +1,63 @@ +NAME + gcloud beta compute security-policies add-user-defined-field - add a user + defined field to a Compute Engine security policy + +SYNOPSIS + gcloud beta compute security-policies add-user-defined-field NAME + --base=BASE --offset=OFFSET --size=SIZE + --user-defined-field-name=USER_DEFINED_FIELD_NAME [--mask=MASK] + [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute security-policies add-user-defined-field is used + to add user defined fields to security policies. + +EXAMPLES + To add a user defined field run this: + + $ gcloud beta compute security-policies add-user-defined-field \ + SECURITY_POLICY --user-defined-field-name=my-field --base=ipv6 \ + --offset=10 --size=3 + +POSITIONAL ARGUMENTS + NAME + Name of the security policy to update. + +REQUIRED FLAGS + --base=BASE + The base relative to which offset is measured. BASE must be one of: + ipv4, ipv6, tcp, udp. + + --offset=OFFSET + Offset of the first byte of the field (in network byte order) relative + to base. + + --size=SIZE + Size of the field in bytes. Valid values: 1-4. + + --user-defined-field-name=USER_DEFINED_FIELD_NAME + The name for the user defined field. + +OPTIONAL FLAGS + --mask=MASK + If specified, apply this mask (bitwise AND) to the field to ignore bits + before matching. Encoded as a hexadecimal number (starting with "0x"). + + --region=REGION + Region of the security policy to update. Overrides the default + compute/region property value for this command invocation. + +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 compute security-policies add-user-defined-field + diff --git a/gcloud/beta/compute/security-policies/help b/gcloud/beta/compute/security-policies/help index 3d3cd9c2b..a3c40a325 100644 --- a/gcloud/beta/compute/security-policies/help +++ b/gcloud/beta/compute/security-policies/help @@ -33,6 +33,9 @@ GROUPS COMMANDS COMMAND is one of the following: + add-user-defined-field + (BETA) Add a user defined field to a Compute Engine security policy. + create (BETA) Create a Compute Engine security policy. @@ -54,6 +57,10 @@ COMMANDS list-preconfigured-expression-sets (BETA) List all available preconfigured expression sets. + remove-user-defined-field + (BETA) Remove a user defined field from a Compute Engine security + policy. + update (BETA) Update a Compute Engine security policy. diff --git a/gcloud/beta/compute/security-policies/remove-user-defined-field b/gcloud/beta/compute/security-policies/remove-user-defined-field new file mode 100644 index 000000000..2c45e864f --- /dev/null +++ b/gcloud/beta/compute/security-policies/remove-user-defined-field @@ -0,0 +1,46 @@ +NAME + gcloud beta compute security-policies remove-user-defined-field - remove a + user defined field from a Compute Engine security policy + +SYNOPSIS + gcloud beta compute security-policies remove-user-defined-field NAME + --user-defined-field-name=USER_DEFINED_FIELD_NAME [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute security-policies remove-user-defined-field is + used to remove user defined fields from security policies. + +EXAMPLES + To remove a user defined field run this: + + $ gcloud beta compute security-policies remove-user-defined-field \ + SECURITY_POLICY --user-defined-field-name=my-field + +POSITIONAL ARGUMENTS + NAME + Name of the security policy to update. + +REQUIRED FLAGS + --user-defined-field-name=USER_DEFINED_FIELD_NAME + The name of the user defined field to remove. + +OPTIONAL FLAGS + --region=REGION + Region of the security policy to update. Overrides the default + compute/region property value for this command invocation. + +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 compute security-policies remove-user-defined-field + diff --git a/gcloud/beta/compute/security-policies/rules/create b/gcloud/beta/compute/security-policies/rules/create index 9e4e1b47d..e4c95dfdc 100644 --- a/gcloud/beta/compute/security-policies/rules/create +++ b/gcloud/beta/compute/security-policies/rules/create @@ -4,7 +4,15 @@ NAME SYNOPSIS gcloud beta compute security-policies rules create PRIORITY --action=ACTION - (--expression=EXPRESSION | --src-ip-ranges=[SRC_IP_RANGE,...]) + (--expression=EXPRESSION --network-dest-ip-ranges=[DEST_IP_RANGE,...] + --network-dest-ports=[DEST_PORT,...] + --network-ip-protocols=[IP_PROTOCOL,...] + --network-src-asns=[SRC_ASN,...] + --network-src-ip-ranges=[SRC_IP_RANGE,...] + --network-src-ports=[SRC_PORT,...] + --network-src-region-codes=[SRC_REGION_CODE,...] + --network-user-defined-fields=[NAME;VALUE:VALUE:...,...] + --src-ip-ranges=[SRC_IP_RANGE,...]) [--ban-duration-sec=BAN_DURATION_SEC] [--ban-threshold-count=BAN_THRESHOLD_COUNT] [--ban-threshold-interval-sec=BAN_THRESHOLD_INTERVAL_SEC] @@ -19,6 +27,8 @@ SYNOPSIS [--exceed-redirect-type=EXCEED_REDIRECT_TYPE] [--preview] [--rate-limit-threshold-count=RATE_LIMIT_THRESHOLD_COUNT] [--rate-limit-threshold-interval-sec=RATE_LIMIT_THRESHOLD_INTERVAL_SEC] + [--recaptcha-action-site-keys=[SITE_KEY,...]] + [--recaptcha-session-site-keys=[SITE_KEY,...]] [--redirect-target=REDIRECT_TARGET] [--redirect-type=REDIRECT_TYPE] [--region=REGION] [--request-headers-to-add=[REQUEST_HEADERS_TO_ADD,...]] @@ -73,11 +83,48 @@ REQUIRED FLAGS Security policy rule matcher. - Exactly one of these must be specified: + At least one of these must be specified: --expression=EXPRESSION The Cloud Armor rules language expression to match for this rule. + --network-dest-ip-ranges=[DEST_IP_RANGE,...] + The destination IPs/IP ranges to match for this rule. To match all + IPs specify *. + + --network-dest-ports=[DEST_PORT,...] + The destination ports to match for this rule. Each element can be an + 16-bit unsigned decimal number (e.g. "80") or range (e.g."0-1023"), + To match all destination ports specify *. + + --network-ip-protocols=[IP_PROTOCOL,...] + The IP protocols to match for this rule. Each element can be an 8-bit + unsigned decimal number (e.g. "6"), range (e.g."253-254"), or one of + the following protocol names: "tcp", "udp", "icmp", "esp", "ah", + "ipip", or "sctp". To match all protocols specify *. + + --network-src-asns=[SRC_ASN,...] + BGP Autonomous System Number associated with the source IP address to + match for this rule. + + --network-src-ip-ranges=[SRC_IP_RANGE,...] + The source IPs/IP ranges to match for this rule. To match all IPs + specify *. + + --network-src-ports=[SRC_PORT,...] + The source ports to match for this rule. Each element can be an + 16-bit unsigned decimal number (e.g. "80") or range (e.g."0-1023"), + To match all source ports specify *. + + --network-src-region-codes=[SRC_REGION_CODE,...] + The two letter ISO 3166-1 alpha-2 country code associated with the + source IP address to match for this rule. To match all region codes + specify *. + + --network-user-defined-fields=[NAME;VALUE:VALUE:...,...] + Each element names a defined field and lists the matching values for + that field. + --src-ip-ranges=[SRC_IP_RANGE,...] The source IPs/IP ranges to match for this rule. To match all IPs specify *. @@ -190,6 +237,18 @@ OPTIONAL FLAGS Interval over which the threshold for rate limiting requests is computed. + --recaptcha-action-site-keys=[SITE_KEY,...] + A comma-separated list of site keys to be used during the validation of + reCAPTCHA action-tokens. The provided site keys need to be created from + the reCAPTCHA API under the same project where the security policy is + created. + + --recaptcha-session-site-keys=[SITE_KEY,...] + A comma-separated list of site keys to be used during the validation of + reCAPTCHA session-tokens. The provided site keys need to be created + from the reCAPTCHA API under the same project where the security policy + is created. + --redirect-target=REDIRECT_TARGET URL target for the redirect action. Must be specified if the redirect type is external-302. Cannot be specified if the redirect type is diff --git a/gcloud/beta/compute/security-policies/rules/update b/gcloud/beta/compute/security-policies/rules/update index 0175eea9c..859988578 100644 --- a/gcloud/beta/compute/security-policies/rules/update +++ b/gcloud/beta/compute/security-policies/rules/update @@ -18,12 +18,21 @@ SYNOPSIS [--exceed-redirect-type=EXCEED_REDIRECT_TYPE] [--preview] [--rate-limit-threshold-count=RATE_LIMIT_THRESHOLD_COUNT] [--rate-limit-threshold-interval-sec=RATE_LIMIT_THRESHOLD_INTERVAL_SEC] + [--recaptcha-action-site-keys=[SITE_KEY,...]] + [--recaptcha-session-site-keys=[SITE_KEY,...]] [--redirect-target=REDIRECT_TARGET] [--redirect-type=REDIRECT_TYPE] [--region=REGION] [--request-headers-to-add=[REQUEST_HEADERS_TO_ADD,...]] [--security-policy=SECURITY_POLICY] - [--expression=EXPRESSION | --src-ip-ranges=[SRC_IP_RANGE,...]] - [GCLOUD_WIDE_FLAG ...] + [--expression=EXPRESSION --network-dest-ip-ranges=[DEST_IP_RANGE,...] + --network-dest-ports=[DEST_PORT,...] + --network-ip-protocols=[IP_PROTOCOL,...] + --network-src-asns=[SRC_ASN,...] + --network-src-ip-ranges=[SRC_IP_RANGE,...] + --network-src-ports=[SRC_PORT,...] + --network-src-region-codes=[SRC_REGION_CODE,...] + --network-user-defined-fields=[NAME;VALUE:VALUE:...,...] + --src-ip-ranges=[SRC_IP_RANGE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute security-policies rules update is used to update @@ -179,6 +188,18 @@ FLAGS Interval over which the threshold for rate limiting requests is computed. + --recaptcha-action-site-keys=[SITE_KEY,...] + A comma-separated list of site keys to be used during the validation of + reCAPTCHA action-tokens. The provided site keys need to be created from + the reCAPTCHA API under the same project where the security policy is + created. + + --recaptcha-session-site-keys=[SITE_KEY,...] + A comma-separated list of site keys to be used during the validation of + reCAPTCHA session-tokens. The provided site keys need to be created + from the reCAPTCHA API under the same project where the security policy + is created. + --redirect-target=REDIRECT_TARGET URL target for the redirect action. Must be specified if the redirect type is external-302. Cannot be specified if the redirect type is @@ -209,11 +230,46 @@ FLAGS Security policy rule matcher. - At most one of these can be specified: - --expression=EXPRESSION The Cloud Armor rules language expression to match for this rule. + --network-dest-ip-ranges=[DEST_IP_RANGE,...] + The destination IPs/IP ranges to match for this rule. To match all + IPs specify *. + + --network-dest-ports=[DEST_PORT,...] + The destination ports to match for this rule. Each element can be an + 16-bit unsigned decimal number (e.g. "80") or range (e.g."0-1023"), + To match all destination ports specify *. + + --network-ip-protocols=[IP_PROTOCOL,...] + The IP protocols to match for this rule. Each element can be an 8-bit + unsigned decimal number (e.g. "6"), range (e.g."253-254"), or one of + the following protocol names: "tcp", "udp", "icmp", "esp", "ah", + "ipip", or "sctp". To match all protocols specify *. + + --network-src-asns=[SRC_ASN,...] + BGP Autonomous System Number associated with the source IP address to + match for this rule. + + --network-src-ip-ranges=[SRC_IP_RANGE,...] + The source IPs/IP ranges to match for this rule. To match all IPs + specify *. + + --network-src-ports=[SRC_PORT,...] + The source ports to match for this rule. Each element can be an + 16-bit unsigned decimal number (e.g. "80") or range (e.g."0-1023"), + To match all source ports specify *. + + --network-src-region-codes=[SRC_REGION_CODE,...] + The two letter ISO 3166-1 alpha-2 country code associated with the + source IP address to match for this rule. To match all region codes + specify *. + + --network-user-defined-fields=[NAME;VALUE:VALUE:...,...] + Each element names a defined field and lists the matching values for + that field. + --src-ip-ranges=[SRC_IP_RANGE,...] The source IPs/IP ranges to match for this rule. To match all IPs specify *. diff --git a/gcloud/beta/compute/snapshots/create b/gcloud/beta/compute/snapshots/create index 1e30efb2f..83224f202 100644 --- a/gcloud/beta/compute/snapshots/create +++ b/gcloud/beta/compute/snapshots/create @@ -6,9 +6,14 @@ SYNOPSIS [--chain-name=CHAIN_NAME] [--csek-key-file=FILE] [--description=DESCRIPTION] [--guest-flush] [--labels=[KEY=VALUE,...]] [--snapshot-type=SNAPSHOT_TYPE] [--source-disk=SOURCE_DISK] - [--source-disk-key-file=FILE] [--storage-location=LOCATION] + [--source-disk-key-file=FILE] + [--source-instant-snapshot=SOURCE_INSTANT_SNAPSHOT] + [--storage-location=LOCATION] [--source-disk-region=SOURCE_DISK_REGION - | --source-disk-zone=SOURCE_DISK_ZONE] [GCLOUD_WIDE_FLAG ...] + | --source-disk-zone=SOURCE_DISK_ZONE] + [--source-instant-snapshot-region=SOURCE_INSTANT_SNAPSHOT_REGION + | --source-instant-snapshot-zone=SOURCE_INSTANT_SNAPSHOT_ZONE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute snapshots create creates snapshot of persistent @@ -81,6 +86,12 @@ FLAGS Required if the source disk is protected by a customer-supplied encryption key. + --source-instant-snapshot=SOURCE_INSTANT_SNAPSHOT + Source instant snapshot used to create the snapshot. To create a + snapshot from a source instant snapshot in a different project, specify + the full path to the source instant snapshot. For example: + https://www.googleapis.com/compute/v1/projects/MY-PROJECT/zones/MY-ZONE/instantSnapshots/MY-INSTANT-SNAPSHOT + --storage-location=LOCATION Google Cloud Storage location, either regional or multi-regional, where snapshot content is to be stored. If absent, a nearby regional or @@ -96,6 +107,16 @@ FLAGS Zone of the source disk to operate on. Overrides the default compute/zone property value for this command invocation. + At most one of these can be specified: + + --source-instant-snapshot-region=SOURCE_INSTANT_SNAPSHOT_REGION + Region of the source instant snapshot to operate on. Overrides the + default compute/region property value for this command invocation. + + --source-instant-snapshot-zone=SOURCE_INSTANT_SNAPSHOT_ZONE + Zone of the source instant snapshot to operate on. Overrides the + default compute/zone property value for this command invocation. + 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/target-instances/help b/gcloud/beta/compute/target-instances/help index 3ad016200..2ff4d25a4 100644 --- a/gcloud/beta/compute/target-instances/help +++ b/gcloud/beta/compute/target-instances/help @@ -36,6 +36,9 @@ COMMANDS list (BETA) List Google Compute Engine target instances. + update + (BETA) Update a Compute Engine target instance. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/compute/target-instances/update b/gcloud/beta/compute/target-instances/update new file mode 100644 index 000000000..2d82760e0 --- /dev/null +++ b/gcloud/beta/compute/target-instances/update @@ -0,0 +1,69 @@ +NAME + gcloud beta compute target-instances update - update a Compute Engine + target instance + +SYNOPSIS + gcloud beta compute target-instances update NAME + [--security-policy=SECURITY_POLICY] + [--security-policy-region=SECURITY_POLICY_REGION] [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute target-instances update updates a Compute Engine + target instance. + +EXAMPLES + To update the security policy run this: + + $ gcloud beta compute target-instances update TARGET_INSTANCE \ + --security-policy='my-policy' + +POSITIONAL ARGUMENTS + NAME + Name of the target instance to update. + +FLAGS + --security-policy=SECURITY_POLICY + The security policy that will be set for this target instance. To + remove the policy from this target instance set the policy to an empty + string. + + --security-policy-region=SECURITY_POLICY_REGION + Region of the security policy to operate on. Overrides the default + compute/region property value for this command invocation. + + --zone=ZONE + Zone of the target instance to update. If not specified and the + compute/zone property isn't set, you might be prompted to select a zone + (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +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 compute target-instances update + diff --git a/gcloud/beta/compute/target-pools/help b/gcloud/beta/compute/target-pools/help index c2bbe09bf..3cf4520a2 100644 --- a/gcloud/beta/compute/target-pools/help +++ b/gcloud/beta/compute/target-pools/help @@ -52,6 +52,9 @@ COMMANDS set-backup (BETA) Set a backup pool for a target pool. + update + (BETA) Update a Compute Engine target pool. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/compute/target-pools/update b/gcloud/beta/compute/target-pools/update new file mode 100644 index 000000000..0a6b0532b --- /dev/null +++ b/gcloud/beta/compute/target-pools/update @@ -0,0 +1,67 @@ +NAME + gcloud beta compute target-pools update - update a Compute Engine target + pool + +SYNOPSIS + gcloud beta compute target-pools update NAME [--region=REGION] + [--security-policy=SECURITY_POLICY] + [--security-policy-region=SECURITY_POLICY_REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute target-pools update updates a Compute Engine + target pool. + +EXAMPLES + To update the security policy run this: + + $ gcloud beta compute target-pools update TARGET_POOL \ + --security-policy='my-policy' + +POSITIONAL ARGUMENTS + NAME + The name of the target pool. + +FLAGS + --region=REGION + Region of the target pool to update. If not specified, you might be + prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + --security-policy=SECURITY_POLICY + The security policy that will be set for this target pool. To remove + the policy from this target pool set the policy to an empty string. + + --security-policy-region=SECURITY_POLICY_REGION + Region of the security policy to operate on. Overrides the default + compute/region property value for this command invocation. + +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 compute target-pools update + diff --git a/gcloud/beta/container/clusters/check-autopilot-compatibility b/gcloud/beta/container/clusters/check-autopilot-compatibility new file mode 100644 index 000000000..f28f74c75 --- /dev/null +++ b/gcloud/beta/container/clusters/check-autopilot-compatibility @@ -0,0 +1,85 @@ +NAME + gcloud beta container clusters check-autopilot-compatibility - check + autopilot compatibility of a running cluster + +SYNOPSIS + gcloud beta container clusters check-autopilot-compatibility NAME + [--location=LOCATION | --region=REGION | --zone=ZONE, -z ZONE] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Check autopilot compatibility of a running cluster. + +EXAMPLES + To check autopilot compatibility of an existing cluster, run: + + $ gcloud beta container clusters check-autopilot-compatibility \ + sample-cluster + +POSITIONAL ARGUMENTS + NAME + The name of this cluster. + +FLAGS + At most one of these can be specified: + + --location=LOCATION + Compute zone or region (e.g. us-central1-a or us-central1) for the + cluster. + + --region=REGION + Compute region (e.g. us-central1) for the cluster. + + --zone=ZONE, -z ZONE + Compute zone (e.g. us-central1-a) for the cluster. Overrides the + default compute/zone property value for this command invocation. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud container clusters check-autopilot-compatibility + + $ gcloud alpha container clusters check-autopilot-compatibility + diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index 9cc09aafe..5b81f4149 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -637,7 +637,7 @@ FLAGS Set the components that have logging enabled. Valid component values are: SYSTEM, WORKLOAD, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, NONE - For more information, look at + For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-logs Examples: @@ -777,10 +777,10 @@ FLAGS --monitoring=[COMPONENT,...] Set the components that have monitoring enabled. Valid component values - are: SYSTEM, WORKLOAD (Deprecated), NONE,API_SERVER, + are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER - For more information, look at + For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics Examples: @@ -1178,9 +1178,9 @@ FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. - BINAUTHZ_EVALUATION_MODE must be one of: BOUND_POLICIES, - BOUND_POLICIES_AND_PROJECT_SINGLETON_POLICY_ENFORCE, DISABLED, - MONITORING, MONITORING_AND_PROJECT_SINGLETON_POLICY_ENFORCE, + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, MONITORING, + MONITORING_AND_PROJECT_SINGLETON_POLICY_ENFORCE, POLICY_BINDINGS, + POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE, PROJECT_SINGLETON_POLICY_ENFORCE. --enable-binauthz diff --git a/gcloud/beta/container/clusters/create-auto b/gcloud/beta/container/clusters/create-auto index acab8d7c8..6f926606e 100644 --- a/gcloud/beta/container/clusters/create-auto +++ b/gcloud/beta/container/clusters/create-auto @@ -14,6 +14,7 @@ SYNOPSIS [--enable-google-cloud-access] [--enable-kubernetes-unstable-apis=API,[API,...]] [--enable-master-global-access] [--fleet-project=PROJECT_ID_OR_NUMBER] + [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] [--network=NETWORK] [--private-endpoint-subnetwork=NAME] [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] @@ -184,6 +185,34 @@ FLAGS Example: $ gcloud beta container clusters create-auto \ --fleet-project=my-project + --logging=[COMPONENT,...] + Set the components that have logging enabled. Valid component values + are: SYSTEM, WORKLOAD, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, NONE + + For more information, see + https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-logs + + Examples: + + $ gcloud beta container clusters create-auto --logging=SYSTEM + $ gcloud beta container clusters create-auto \ + --logging=SYSTEM,API_SERVER,WORKLOAD + $ gcloud beta container clusters create-auto --logging=NONE + + --monitoring=[COMPONENT,...] + Set the components that have monitoring enabled. Valid component values + are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, + CONTROLLER_MANAGER, SCHEDULER + + For more information, see + https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics + + Examples: + + $ gcloud beta container clusters create-auto \ + --monitoring=SYSTEM,API_SERVER + $ gcloud beta container clusters create-auto --monitoring=NONE + --network=NETWORK The Compute Engine Network that the cluster will connect to. Google Kubernetes Engine will use this network when creating routes and @@ -272,9 +301,9 @@ FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. - BINAUTHZ_EVALUATION_MODE must be one of: BOUND_POLICIES, - BOUND_POLICIES_AND_PROJECT_SINGLETON_POLICY_ENFORCE, DISABLED, - MONITORING, MONITORING_AND_PROJECT_SINGLETON_POLICY_ENFORCE, + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, MONITORING, + MONITORING_AND_PROJECT_SINGLETON_POLICY_ENFORCE, POLICY_BINDINGS, + POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE, PROJECT_SINGLETON_POLICY_ENFORCE. --binauthz-policy=BINAUTHZ_POLICY diff --git a/gcloud/beta/container/clusters/help b/gcloud/beta/container/clusters/help index d376f69de..030e2fe14 100644 --- a/gcloud/beta/container/clusters/help +++ b/gcloud/beta/container/clusters/help @@ -36,6 +36,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + check-autopilot-compatibility + (BETA) Check autopilot compatibility of a running cluster. + create (BETA) Create a cluster for running containers. diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index b57acf1ae..138088cc1 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -650,9 +650,9 @@ REQUIRED FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. - BINAUTHZ_EVALUATION_MODE must be one of: BOUND_POLICIES, - BOUND_POLICIES_AND_PROJECT_SINGLETON_POLICY_ENFORCE, DISABLED, - MONITORING, MONITORING_AND_PROJECT_SINGLETON_POLICY_ENFORCE, + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, MONITORING, + MONITORING_AND_PROJECT_SINGLETON_POLICY_ENFORCE, POLICY_BINDINGS, + POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE, PROJECT_SINGLETON_POLICY_ENFORCE. --enable-binauthz @@ -1090,7 +1090,7 @@ REQUIRED FLAGS are: SYSTEM, WORKLOAD, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, NONE - For more information, look at + For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-logs Examples: @@ -1102,10 +1102,10 @@ REQUIRED FLAGS --monitoring=[COMPONENT,...] Set the components that have monitoring enabled. Valid component - values are: SYSTEM, WORKLOAD (Deprecated), NONE,API_SERVER, + values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER - For more information, look at + For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics Examples: diff --git a/gcloud/beta/dataflow/jobs/cancel b/gcloud/beta/dataflow/jobs/cancel index 9f9088487..bc9236cce 100644 --- a/gcloud/beta/dataflow/jobs/cancel +++ b/gcloud/beta/dataflow/jobs/cancel @@ -11,7 +11,7 @@ DESCRIPTION POSITIONAL ARGUMENTS JOB_ID [JOB_ID ...] - The job IDs to operate on. + Job IDs to operate on. FLAGS --force @@ -20,8 +20,7 @@ FLAGS ago for a job to be force cancelled. --region=REGION_ID - The region ID of the jobs' regional endpoint. Defaults to - 'us-central1'. + Region ID of the jobs' regional endpoint. Defaults to 'us-central1'. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/dataflow/jobs/describe b/gcloud/beta/dataflow/jobs/describe index 3a3a0fe1f..9c543f0b9 100644 --- a/gcloud/beta/dataflow/jobs/describe +++ b/gcloud/beta/dataflow/jobs/describe @@ -23,15 +23,14 @@ DESCRIPTION POSITIONAL ARGUMENTS JOB_ID - The job ID to operate on. + Job ID to operate on. FLAGS --full Retrieve the full Job rather than the summary view --region=REGION_ID - The region ID of the job's regional endpoint. Defaults to - 'us-central1'. + Region ID of the job's regional endpoint. Defaults to 'us-central1'. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/dataflow/jobs/drain b/gcloud/beta/dataflow/jobs/drain index 381aa0c44..317a81814 100644 --- a/gcloud/beta/dataflow/jobs/drain +++ b/gcloud/beta/dataflow/jobs/drain @@ -14,12 +14,11 @@ DESCRIPTION POSITIONAL ARGUMENTS JOB_ID [JOB_ID ...] - The job IDs to operate on. + Job IDs to operate on. FLAGS --region=REGION_ID - The region ID of the jobs' regional endpoint. Defaults to - 'us-central1'. + Region ID of the jobs' regional endpoint. Defaults to 'us-central1'. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/dataflow/jobs/export-steps b/gcloud/beta/dataflow/jobs/export-steps index 797ca1770..54f10f72d 100644 --- a/gcloud/beta/dataflow/jobs/export-steps +++ b/gcloud/beta/dataflow/jobs/export-steps @@ -11,12 +11,11 @@ DESCRIPTION POSITIONAL ARGUMENTS JOB_ID - The job ID to operate on. + Job ID to operate on. FLAGS --region=REGION_ID - The region ID of the job's regional endpoint. Defaults to - 'us-central1'. + Region ID of the job's regional endpoint. Defaults to 'us-central1'. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/dataflow/jobs/run b/gcloud/beta/dataflow/jobs/run index 9c9e5a46d..cfde8ea2e 100644 --- a/gcloud/beta/dataflow/jobs/run +++ b/gcloud/beta/dataflow/jobs/run @@ -58,8 +58,7 @@ OPTIONAL FLAGS The parameters to pass to the job. --region=REGION_ID - The region ID of the job's regional endpoint. Defaults to - 'us-central1'. + Region ID of the job's regional endpoint. Defaults to 'us-central1'. --service-account-email=SERVICE_ACCOUNT_EMAIL The service account to run the workers as. diff --git a/gcloud/beta/dataflow/jobs/show b/gcloud/beta/dataflow/jobs/show index 3a509f04f..d8781630e 100644 --- a/gcloud/beta/dataflow/jobs/show +++ b/gcloud/beta/dataflow/jobs/show @@ -10,15 +10,14 @@ DESCRIPTION POSITIONAL ARGUMENTS JOB_ID - The job ID to operate on. + Job ID to operate on. FLAGS --environment If present, the environment will be listed. --region=REGION_ID - The region ID of the job's regional endpoint. Defaults to - 'us-central1'. + Region ID of the job's regional endpoint. Defaults to 'us-central1'. --steps If present, the steps will be listed. diff --git a/gcloud/beta/dataflow/logs/list b/gcloud/beta/dataflow/logs/list index cbc2ce003..b4c52fd54 100644 --- a/gcloud/beta/dataflow/logs/list +++ b/gcloud/beta/dataflow/logs/list @@ -32,7 +32,7 @@ EXAMPLES POSITIONAL ARGUMENTS JOB_ID - The job ID to operate on. + Job ID to operate on. FLAGS --after=AFTER @@ -49,8 +49,7 @@ FLAGS be one of: debug, detailed, warning, error. --region=REGION_ID - The region ID of the job's regional endpoint. Defaults to - 'us-central1'. + Region ID of the job's regional endpoint. Defaults to 'us-central1'. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/dataflow/metrics/list b/gcloud/beta/dataflow/metrics/list index 927a39680..6b072b336 100644 --- a/gcloud/beta/dataflow/metrics/list +++ b/gcloud/beta/dataflow/metrics/list @@ -44,7 +44,7 @@ EXAMPLES POSITIONAL ARGUMENTS JOB_ID - The job ID to operate on. + Job ID to operate on. FLAGS --changed-after=CHANGED_AFTER @@ -56,8 +56,7 @@ FLAGS If true, hide committed values. --region=REGION_ID - The region ID of the job's regional endpoint. Defaults to - 'us-central1'. + Region ID of the job's regional endpoint. Defaults to 'us-central1'. --source=SOURCE; default="all" Set the metrics source. SOURCE must be one of: diff --git a/gcloud/beta/dataflow/sql/query b/gcloud/beta/dataflow/sql/query index d49df0419..fda89aecd 100644 --- a/gcloud/beta/dataflow/sql/query +++ b/gcloud/beta/dataflow/sql/query @@ -72,8 +72,7 @@ REQUIRED FLAGS The unique name to assign to the Cloud Dataflow job. --region=REGION - The region ID of the job's regional endpoint. Defaults to - 'us-central1'. + Region ID of the job's regional endpoint. Defaults to 'us-central1'. The destination(s) for the output of the query. diff --git a/gcloud/beta/filestore/backups/create b/gcloud/beta/filestore/backups/create index 74e743aae..522f00da6 100644 --- a/gcloud/beta/filestore/backups/create +++ b/gcloud/beta/filestore/backups/create @@ -59,7 +59,7 @@ OPTIONAL FLAGS --kms-key=KMS_KEY CMEK for backup in the form of - projects/{}/locations/{}/keyRings/{}/cryptoKeys/{} + projects/{project}/locations/{location}/keyRings/{key-ring}/cryptoKeys/{crypto-key} --labels=KEY=VALUE List of label KEY=VALUE pairs to add. diff --git a/gcloud/beta/filestore/instances/create b/gcloud/beta/filestore/instances/create index c49629c76..d411d2f22 100644 --- a/gcloud/beta/filestore/instances/create +++ b/gcloud/beta/filestore/instances/create @@ -9,8 +9,10 @@ SYNOPSIS --network=[connect-mode=CONNECT-MODE], [name=NAME],[reserved-ip-range=RESERVED-IP-RANGE] [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--location=LOCATION] [--protocol=PROTOCOL; default="NFS_V3"] - [--region=REGION] [--tier=TIER; default="BASIC_HDD"] + [--location=LOCATION] + [--managed-ad=[computer=COMPUTER],[domain=DOMAIN]] + [--protocol=PROTOCOL; default="NFS_V3"] [--region=REGION] + [--tier=TIER; default="BASIC_HDD"] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] [GCLOUD_WIDE_FLAG ...] @@ -29,6 +31,7 @@ EXAMPLES reserved-ip-range=RESERVED_IP_RANGE,connect-mode=CONNECT_MODE \ --zone=ZONE --kms-key=KMS-KEY --kms-keyring=KMS_KEYRING \ --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT \ + --managed-ad=domain=DOMAIN,computer=COMPUTER \ --flags-file=FLAGS_FILE Example json configuration file: @@ -41,6 +44,10 @@ EXAMPLES "10.0.0.0/8", ], "squash-mode": "NO_ROOT_SQUASH", + "security-flavors": [ + "AUTH_SYS", + "KRB5P", + ], }, { "access-mode": "READ_ONLY", @@ -148,6 +155,20 @@ REQUIRED FLAGS NO_ROOT_SQUASH is specified, an error will be returned. The default value is 65534. + security-flavors + A list of security flavors that are allowed to be used during mount + command in NFSv4.1 filestore instances. The security flavors + supported are: + ◆ SECURITY_FLAVOR_UNSPECIFIED: SecurityFlavor not set. Defaults to + AUTH_SYS. + ◆ AUTH_SYS: The user's UNIX user-id and group-ids are passed in the + clear. + ◆ KRB5: The end-user authentication is done using Kerberos V5. + ◆ KRB5I: KRB5 plus integrity protection (data packets are tamper + proof). + ◆ KRB5P: KRB5I plus privacy protection (data packets are tamper + proof and encrypted). + source-backup The name of the backup to restore from. @@ -200,6 +221,19 @@ OPTIONAL FLAGS --location=LOCATION Location of the Cloud Filestore instance/operation. + --managed-ad=[computer=COMPUTER],[domain=DOMAIN] + Managed Active Directory configuration for an instance. Specifying both + domain name and a computer name (unique to the domain) to be created by + filestore instance. + + domain + The desired domain full uri. i.e: + projects/PROJECT/locations/global/domains/DOMAIN + + computer + The desired active directory computer name to be created by + filestore instance when connecting to the domain. + --protocol=PROTOCOL; default="NFS_V3" The service protocol for the Cloud Filestore instance. PROTOCOL must be one of: diff --git a/gcloud/beta/filestore/instances/update b/gcloud/beta/filestore/instances/update index d5feff476..5335c8bff 100644 --- a/gcloud/beta/filestore/instances/update +++ b/gcloud/beta/filestore/instances/update @@ -156,6 +156,20 @@ FLAGS NO_ROOT_SQUASH is specified, an error will be returned. The default value is 65534. + security-flavors + A list of security flavors that are allowed to be used during mount + command in NFSv4.1 filestore instances. The security flavors + supported are: + ◆ SECURITY_FLAVOR_UNSPECIFIED: SecurityFlavor not set. Defaults to + AUTH_SYS. + ◆ AUTH_SYS: The user's UNIX user-id and group-ids are passed in the + clear. + ◆ KRB5: The end-user authentication is done using Kerberos V5. + ◆ KRB5I: KRB5 plus integrity protection (data packets are tamper + proof). + ◆ KRB5P: KRB5I plus privacy protection (data packets are tamper + proof and encrypted). + --location=LOCATION Location of the Cloud Filestore instance/operation. diff --git a/gcloud/beta/firestore/databases/describe b/gcloud/beta/firestore/databases/describe index a870c3a6e..cd1474225 100644 --- a/gcloud/beta/firestore/databases/describe +++ b/gcloud/beta/firestore/databases/describe @@ -1,38 +1,31 @@ NAME - gcloud beta firestore databases describe - describe a Google Cloud - Firestore database + gcloud beta firestore databases describe - describes information about a + Cloud Firestore database SYNOPSIS - gcloud beta firestore databases describe [--database=DATABASE] - [GCLOUD_WIDE_FLAG ...] + gcloud beta firestore databases describe + [--database=DATABASE; default="(default)"] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Describe a Google Cloud Firestore database. + (BETA) The following command describes a Google Cloud Firestore database. EXAMPLES - The following command describes a Google Cloud Firestore database. + To describe a Firestore database with a databaseId testdb. + + $ gcloud beta firestore databases describe --database=testdb + + If databaseId is not specified, the command will describe information about + the (default) database. $ gcloud beta firestore databases describe FLAGS - Database resource - The Google Cloud Firestore database to describe. This - represents a Cloud resource. (NOTE) Some attributes are not given - arguments in this group but can be set in other ways. + --database=DATABASE; default="(default)" + The database to operate on. The default value is (default). - To set the project attribute: - ◆ provide the argument --database on the command line with a fully - specified name; - ◆ the default value of argument [--database] is (default) with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. + For example, to operate on database foo: - --database=DATABASE - ID of the database or fully qualified identifier for the database. - - To set the database attribute: - ▸ provide the argument --database on the command line; - ▸ the default value of argument [--database] is (default). + $ gcloud beta firestore databases describe --database='foo' GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, @@ -42,10 +35,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the firestore/v1 API. The full documentation for this API - can be found at: https://cloud.google.com/firestore - NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/firestore/databases/help b/gcloud/beta/firestore/databases/help index 1ceea48d2..ed147eb70 100644 --- a/gcloud/beta/firestore/databases/help +++ b/gcloud/beta/firestore/databases/help @@ -20,7 +20,7 @@ COMMANDS (BETA) Create a Google Cloud Firestore database via Firestore API. describe - (BETA) Describe a Google Cloud Firestore database. + (BETA) Describes information about a Cloud Firestore database. list (BETA) Lists all Firestore databases under the project. diff --git a/gcloud/beta/functions/deploy b/gcloud/beta/functions/deploy index e39379a91..655f236ff 100644 --- a/gcloud/beta/functions/deploy +++ b/gcloud/beta/functions/deploy @@ -123,11 +123,8 @@ FLAGS --entry-point=ENTRY_POINT Name of a Google Cloud Function (as defined in source code) that will - be executed. Defaults to the resource name suffix, if not specified. - For backward compatibility, if function with given name is not found, - then the system will try to use function named "function". For Node.js - this is name of a function exported by the module specified in - source_location. + be executed. Defaults to the resource name suffix (ID of the function), + if not specified. --gen2 If enabled, this command will use Cloud Functions (Second generation). diff --git a/gcloud/beta/iam/workload-identity-pools/providers/create-oidc b/gcloud/beta/iam/workload-identity-pools/providers/create-oidc index 4a2000f6c..8ca30da70 100644 --- a/gcloud/beta/iam/workload-identity-pools/providers/create-oidc +++ b/gcloud/beta/iam/workload-identity-pools/providers/create-oidc @@ -9,7 +9,8 @@ SYNOPSIS --attribute-mapping=[ATTRIBUTE_MAPPING,...] --issuer-uri=ISSUER_URI [--allowed-audiences=[ALLOWED_AUDIENCES,...]] [--attribute-condition=ATTRIBUTE_CONDITION] [--description=DESCRIPTION] - [--disabled] [--display-name=DISPLAY_NAME] [GCLOUD_WIDE_FLAG ...] + [--disabled] [--display-name=DISPLAY_NAME] + [--jwk-json-path=JWK_JSON_PATH] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a new OIDC workload identity pool provider. @@ -28,7 +29,7 @@ EXAMPLES --attribute-condition="true" \ --issuer-uri="https://test-idp.com" \ --allowed-audiences=https://test-audience-1.com,https://\ - test-audience-2.com + test-audience-2.com --jwk-json-path="path/to/jwk.json" POSITIONAL ARGUMENTS Workload identity pool provider resource - The workload identity pool @@ -205,6 +206,25 @@ OPTIONAL FLAGS --display-name=DISPLAY_NAME A display name for the provider. Cannot exceed 32 characters. + --jwk-json-path=JWK_JSON_PATH + Optional file containing jwk public keys. The file format must follow + jwk specifications (https://www.rfc-editor.org/rfc/rfc7517#section-4). + Example file format: { + "keys": [ + { + "kty": "RSA/EC", + "alg": "", + "use": "sig", + "kid": "", + "n": "", + "e": "" + "x": "" + "y": "" + "crv": "" + } + ] + } + 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/iam/workload-identity-pools/providers/update-oidc b/gcloud/beta/iam/workload-identity-pools/providers/update-oidc index 024711d17..ece9aec4b 100644 --- a/gcloud/beta/iam/workload-identity-pools/providers/update-oidc +++ b/gcloud/beta/iam/workload-identity-pools/providers/update-oidc @@ -10,7 +10,8 @@ SYNOPSIS [--attribute-condition=ATTRIBUTE_CONDITION] [--attribute-mapping=[ATTRIBUTE_MAPPING,...]] [--description=DESCRIPTION] [--disabled] [--display-name=DISPLAY_NAME] - [--issuer-uri=ISSUER_URI] [GCLOUD_WIDE_FLAG ...] + [--issuer-uri=ISSUER_URI] [--jwk-json-path=JWK_JSON_PATH] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Update an OIDC workload identity pool provider. @@ -29,7 +30,7 @@ EXAMPLES --attribute-condition="true" \ --issuer-uri="https://test-idp.com" \ --allowed-audiences=https://test-audience-1.com,https://\ - test-audience-2.com + test-audience-2.com --jwk-json-path="path/to/jwk.json" POSITIONAL ARGUMENTS Workload identity pool provider resource - The workload identity pool @@ -205,6 +206,25 @@ FLAGS --issuer-uri=ISSUER_URI The OIDC issuer URL. + --jwk-json-path=JWK_JSON_PATH + Optional file containing jwk public keys. The file format must follow + jwk specifications (https://www.rfc-editor.org/rfc/rfc7517#section-4). + Example file format: { + "keys": [ + { + "kty": "RSA/EC", + "alg": "", + "use": "sig", + "kid": "", + "n": "", + "e": "" + "x": "" + "y": "" + "crv": "" + } + ] + } + 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/logging/sinks/create b/gcloud/beta/logging/sinks/create index 2712f9842..15ba668c9 100644 --- a/gcloud/beta/logging/sinks/create +++ b/gcloud/beta/logging/sinks/create @@ -63,6 +63,11 @@ EXAMPLES logging.googleapis.com/projects/my-central-project/locations/\ global/buckets/my-central-bucket + To route all logs to another project, run: + + $ gcloud beta logging sinks create my-sink \ + logging.googleapis.com/projects/my-destination-project + POSITIONAL ARGUMENTS SINK_NAME The name for the sink. diff --git a/gcloud/beta/netapp/active-directories/create b/gcloud/beta/netapp/active-directories/create new file mode 100644 index 000000000..12db43f4a --- /dev/null +++ b/gcloud/beta/netapp/active-directories/create @@ -0,0 +1,150 @@ +NAME + gcloud beta netapp active-directories create - create a Cloud NetApp Active + Directory + +SYNOPSIS + gcloud beta netapp active-directories create + (ACTIVE_DIRECTORY : --location=LOCATION) --dns=DNS --domain=DOMAIN + --net-bios-prefix=NET_BIOS_PREFIX --password=PASSWORD + --username=USERNAME [--async] + [--backup-operators=[BACKUP_OPERATOR,...]] [--description=DESCRIPTION] + [--enable-aes=ENABLE_AES] [--enable-ldap-signing=ENABLE_LDAP_SIGNING] + [--encrypt-dc-connections=ENCRYPT_DC_CONNECTIONS] + [--kdc-hostname=KDC_HOSTNAME] [--kdc-ip=KDC_IP] + [--labels=[KEY=VALUE,...]] [--nfs-users-with-ldap=NFS_USERS_WITH_LDAP] + [--organizational-unit=ORGANIZATIONAL_UNIT] + [--security-operators=[SECURITY_OPERATOR,...]] [--site=SITE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Creates an AD (Active Directory) config for Cloud NetApp Volumes + +EXAMPLES + The following command creates an AD named AD_NAME with the required + arguments + + $ gcloud beta netapp active-directories create AD_NAME \ + --location=us-central1 --domain=example-domain.com \ + --dns=0.0.0.0 --net-bios-prefix=prefix-1 --enable-aes=true \ + --username=user1 --password="secure1" \ + --backup-operators=backup_op1,backup_op2 \ + --security-operators=sec_op1,sec_op2 --enable-ldap-signing=false + +POSITIONAL ARGUMENTS + Active directory resource - The Active Directory 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 active_directory 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. + + ACTIVE_DIRECTORY + ID of the active_directory or fully qualified identifier for the + active_directory. + + To set the active_directory attribute: + ▸ provide the argument active_directory on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the active_directory. + + To set the location attribute: + ▸ provide the argument active_directory on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +REQUIRED FLAGS + --dns=DNS + A comma separated list of DNS server IP addresses for the Active + Directory domain. + + --domain=DOMAIN + The Active Directory domain. + + --net-bios-prefix=NET_BIOS_PREFIX + NetBIOS prefix name of the server. + + --password=PASSWORD + Password of the Active Directory domain administrator. + + --username=USERNAME + Username of the Active Directory domain administrator. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --backup-operators=[BACKUP_OPERATOR,...] + Users to be added to the Built-in Backup Operator Active Directory + group. + + --description=DESCRIPTION + A description of the Cloud NetApp Active Directory + + --enable-aes=ENABLE_AES + The Boolean value indiciating whether AES encryption will be enabled + for SMB communication. + + --enable-ldap-signing=ENABLE_LDAP_SIGNING + Boolean flag that specifies whether or not LDAP traffic needs to be + signed. + + --encrypt-dc-connections=ENCRYPT_DC_CONNECTIONS + Boolean flag that specifies whether traffic between SMB server to + Domain Controller (DC) will be encrypted. + + --kdc-hostname=KDC_HOSTNAME + Name of the Active Directory machine. + + --kdc-ip=KDC_IP + KDC server IP address for the Active Directory machine. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --nfs-users-with-ldap=NFS_USERS_WITH_LDAP + Boolean flag that allows access to local users and LDAP users. If + access is needed only for LDAP users, it has to be disabled. + + --organizational-unit=ORGANIZATIONAL_UNIT + The Organizational Unit (OU) within the Windows Active Directory the + user belongs to. + + --security-operators=[SECURITY_OPERATOR,...] + Domain users to be given the Security privilege. + + --site=SITE + The Active Directory site the service will limit Domain Controller + discovery to. + +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 netapp active-directories create + diff --git a/gcloud/beta/netapp/active-directories/delete b/gcloud/beta/netapp/active-directories/delete new file mode 100644 index 000000000..b3e361cd8 --- /dev/null +++ b/gcloud/beta/netapp/active-directories/delete @@ -0,0 +1,77 @@ +NAME + gcloud beta netapp active-directories delete - delete a Cloud NetApp Active + Directory + +SYNOPSIS + gcloud beta netapp active-directories delete + (ACTIVE_DIRECTORY : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Deletes an AD (Active Directory) config for Cloud NetApp Volumes + +EXAMPLES + The following command deletes an AD named AD_NAME with the required + arguments + + $ gcloud beta netapp active-directories delete AD_NAME \ + --location=us-central1 + + To delete a AD Config asynchronously, run the following command: + + $ gcloud beta netapp active-directories delete AD_NAME \ + --location=us-central1 --async + +POSITIONAL ARGUMENTS + Active directory resource - The Active Directory 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 active_directory 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. + + ACTIVE_DIRECTORY + ID of the active_directory or fully qualified identifier for the + active_directory. + + To set the active_directory attribute: + ▸ provide the argument active_directory on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the active_directory. + + To set the location attribute: + ▸ provide the argument active_directory on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp active-directories delete + diff --git a/gcloud/beta/netapp/active-directories/describe b/gcloud/beta/netapp/active-directories/describe new file mode 100644 index 000000000..fe8d5a1e0 --- /dev/null +++ b/gcloud/beta/netapp/active-directories/describe @@ -0,0 +1,66 @@ +NAME + gcloud beta netapp active-directories describe - show metadata for a Cloud + NetApp Active Directory + +SYNOPSIS + gcloud beta netapp active-directories describe + (ACTIVE_DIRECTORY : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describes an AD (Active Directory) config for Cloud NetApp Volumes + +EXAMPLES + The following command describes an AD named AD_NAME with the required + arguments + + $ gcloud beta netapp active-directories describe AD_NAME \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Active directory resource - The Active Directory 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 active_directory 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. + + ACTIVE_DIRECTORY + ID of the active_directory or fully qualified identifier for the + active_directory. + + To set the active_directory attribute: + ▸ provide the argument active_directory on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the active_directory. + + To set the location attribute: + ▸ provide the argument active_directory on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp active-directories describe + diff --git a/gcloud/beta/netapp/active-directories/help b/gcloud/beta/netapp/active-directories/help new file mode 100644 index 000000000..942f26246 --- /dev/null +++ b/gcloud/beta/netapp/active-directories/help @@ -0,0 +1,39 @@ +NAME + gcloud beta netapp active-directories - create and manage Cloud NetApp + Active Directories + +SYNOPSIS + gcloud beta netapp active-directories COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create and manage Cloud NetApp Active Directories. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a Cloud NetApp Active Directory. + + delete + (BETA) Delete a Cloud NetApp Active Directory. + + describe + (BETA) Show metadata for a Cloud NetApp Active Directory. + + list + (BETA) List Cloud NetApp Active Directories. + + update + (BETA) Update a Cloud NetApp Active Directory. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp active-directories + diff --git a/gcloud/beta/netapp/active-directories/list b/gcloud/beta/netapp/active-directories/list new file mode 100644 index 000000000..af3b9f50c --- /dev/null +++ b/gcloud/beta/netapp/active-directories/list @@ -0,0 +1,86 @@ +NAME + gcloud beta netapp active-directories list - list Cloud NetApp Active + Directories + +SYNOPSIS + gcloud beta netapp active-directories list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Lists AD (Active Directory) configs for Cloud NetApp Volumes + +EXAMPLES + The following command lists AD configs in the given project and location + + $ gcloud beta netapp active-directories list --location=us-central1 + +FLAGS + Location resource - The location in which to list Active Directories. 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 --location on the command line with a fully + specified name; + ◆ uses all locations by default. with a fully specified name; + ◆ set the property netapp/location with a fully specified name; + ◆ set the property netapp/region with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ uses all locations by default.; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp active-directories list + diff --git a/gcloud/beta/netapp/active-directories/update b/gcloud/beta/netapp/active-directories/update new file mode 100644 index 000000000..9eb83590f --- /dev/null +++ b/gcloud/beta/netapp/active-directories/update @@ -0,0 +1,173 @@ +NAME + gcloud beta netapp active-directories update - update a Cloud NetApp Active + Directory + +SYNOPSIS + gcloud beta netapp active-directories update + (ACTIVE_DIRECTORY : --location=LOCATION) --dns=DNS --domain=DOMAIN + --net-bios-prefix=NET_BIOS_PREFIX --password=PASSWORD + --username=USERNAME [--async] + [--backup-operators=[BACKUP_OPERATOR,...]] [--description=DESCRIPTION] + [--enable-aes=ENABLE_AES] [--enable-ldap-signing=ENABLE_LDAP_SIGNING] + [--encrypt-dc-connections=ENCRYPT_DC_CONNECTIONS] + [--kdc-hostname=KDC_HOSTNAME] [--kdc-ip=KDC_IP] + [--nfs-users-with-ldap=NFS_USERS_WITH_LDAP] + [--organizational-unit=ORGANIZATIONAL_UNIT] + [--security-operators=[SECURITY_OPERATOR,...]] [--site=SITE] + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Updates AD (Active Directory) configs for Cloud NetApp Volumes + +EXAMPLES + The following command updates an AD config in the given project and + location with specified arguments + + $ gcloud beta netapp active-directories update AD_NAME \ + --location=us-central1 --domain=new-domain.com --dns=1.1.1.1 \ + --site=new_site --net-bios-prefix=new_prefix \ + --organizational-unit=ou2 --enable-aes=true --username=user2 \ + --password="secure2" --backup-operators=backup_op3 \ + --security-operators=secure_op3 --enable-ldap-signing=true \ + --encrypt-dc-connections=yes --kdc-hostname=kdc-host1 + +POSITIONAL ARGUMENTS + Active directory resource - The Active Directory to update. 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 active_directory 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. + + ACTIVE_DIRECTORY + ID of the active_directory or fully qualified identifier for the + active_directory. + + To set the active_directory attribute: + ▸ provide the argument active_directory on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the active_directory. + + To set the location attribute: + ▸ provide the argument active_directory on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +REQUIRED FLAGS + --dns=DNS + A comma separated list of DNS server IP addresses for the Active + Directory domain. + + --domain=DOMAIN + The Active Directory domain. + + --net-bios-prefix=NET_BIOS_PREFIX + NetBIOS prefix name of the server. + + --password=PASSWORD + Password of the Active Directory domain administrator. + + --username=USERNAME + Username of the Active Directory domain administrator. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --backup-operators=[BACKUP_OPERATOR,...] + Users to be added to the Built-in Backup Operator Active Directory + group. + + --description=DESCRIPTION + A description of the Cloud NetApp Active Directory + + --enable-aes=ENABLE_AES + The Boolean value indiciating whether AES encryption will be enabled + for SMB communication. + + --enable-ldap-signing=ENABLE_LDAP_SIGNING + Boolean flag that specifies whether or not LDAP traffic needs to be + signed. + + --encrypt-dc-connections=ENCRYPT_DC_CONNECTIONS + Boolean flag that specifies whether traffic between SMB server to + Domain Controller (DC) will be encrypted. + + --kdc-hostname=KDC_HOSTNAME + Name of the Active Directory machine. + + --kdc-ip=KDC_IP + KDC server IP address for the Active Directory machine. + + --nfs-users-with-ldap=NFS_USERS_WITH_LDAP + Boolean flag that allows access to local users and LDAP users. If + access is needed only for LDAP users, it has to be disabled. + + --organizational-unit=ORGANIZATIONAL_UNIT + The Organizational Unit (OU) within the Windows Active Directory the + user belongs to. + + --security-operators=[SECURITY_OPERATOR,...] + Domain users to be given the Security privilege. + + --site=SITE + The Active Directory site the service will limit Domain Controller + discovery to. + + --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. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta netapp active-directories update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta netapp active-directories update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +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 netapp active-directories update + diff --git a/gcloud/beta/netapp/help b/gcloud/beta/netapp/help new file mode 100644 index 000000000..dfc5f4e38 --- /dev/null +++ b/gcloud/beta/netapp/help @@ -0,0 +1,52 @@ +NAME + gcloud beta netapp - create and manipulate Cloud NetApp Files resources + +SYNOPSIS + gcloud beta netapp GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) The gcloud netapp command group lets you create, configure and + manipulate Cloud NetApp Volumes resources such as Volumes, Storage Pools, + Active Directories, KMS Configs, Volume Snapshots, and Volume Replications + etc. + + With Cloud NetApp Volumes, you can take advantage of Google Cloud + Platform's scale, performance and value to manage and run on-prem NetApp + Files solutions on Google infrastructure, so you don't have to modernize + your file workloads, and allow for legacy feature support. + + More information on Cloud NetApp Files can be found here: + https://cloud.google.com/netapp/docs/reference/rest + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + active-directories + (BETA) Create and manage Cloud NetApp Active Directories. + + kms-configs + (BETA) Create and manage Cloud NetApp Volumes KMS Configs. + + locations + (BETA) Get and list locations where Cloud NetApp Files is available. + + operations + (BETA) Read and manage Cloud NetApp Files Operations. + + storage-pools + (BETA) Create and manage Cloud NetApp Storage Pools. + + volumes + (BETA) Create and manage Cloud NetApp Volumes. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp + diff --git a/gcloud/beta/netapp/kms-configs/create b/gcloud/beta/netapp/kms-configs/create new file mode 100644 index 000000000..08237c389 --- /dev/null +++ b/gcloud/beta/netapp/kms-configs/create @@ -0,0 +1,129 @@ +NAME + gcloud beta netapp kms-configs create - create a Cloud NetApp Volumes KMS + Config + +SYNOPSIS + gcloud beta netapp kms-configs create (KMS_CONFIG : --location=LOCATION) + (--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING + --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT) [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Creates a KMS (Key Management System) Config to encrypt Cloud NetApp + Volumes, Storage Pools etc. using Customer Managed Encryption Keys (CMEK) + +EXAMPLES + The following command creates a KMS Config instance named KMS_CONFIG using + specified project, location, Key Ring and Crypto Key + + $ gcloud beta netapp kms-configs create KMS_CONFIG \ + --location=us-central1 --kms-location=northamerica-northeast1 \ + --kms-project=kms-project1 --kms-keyring=kms-keyring21 \ + --kms-key=crypto-key1 + +POSITIONAL ARGUMENTS + Kms config resource - The KMS Config 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 kms_config 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. + + KMS_CONFIG + ID of the kms_config or fully qualified identifier for the + kms_config. + + To set the kms_config attribute: + ▸ provide the argument kms_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the kms_config. + + To set the location attribute: + ▸ provide the argument kms_config on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +REQUIRED FLAGS + Kms key resource - The Cloud KMS (Key Management Service) Crypto Key that + will be used The arguments in this group can be used to specify the + attributes of this resource. + + This must be specified. + + --kms-key=KMS_KEY + ID of the kms_key or fully qualified identifier for the kms_key. + + To set the kms-key attribute: + ▸ provide the argument --kms-key on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --kms-keyring=KMS_KEYRING + The KMS keyring of the kms_key + + To set the kms-keyring attribute: + ▸ provide the argument --kms-key on the command line with a fully + specified name; + ▸ provide the argument --kms-keyring on the command line. + + --kms-location=KMS_LOCATION + The Cloud location for the kms_key. + + To set the kms-location attribute: + ▸ provide the argument --kms-key on the command line with a fully + specified name; + ▸ provide the argument --kms-location on the command line; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + + --kms-project=KMS_PROJECT + The Cloud project for the kms_key. + + To set the kms-project attribute: + ▸ provide the argument --kms-key on the command line with a fully + specified name; + ▸ provide the argument --kms-project on the command line; + ▸ set the property core/project. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp KMS Config + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +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. + diff --git a/gcloud/beta/netapp/kms-configs/delete b/gcloud/beta/netapp/kms-configs/delete new file mode 100644 index 000000000..1b95e06a8 --- /dev/null +++ b/gcloud/beta/netapp/kms-configs/delete @@ -0,0 +1,72 @@ +NAME + gcloud beta netapp kms-configs delete - delete a Cloud NetApp Volumes KMS + Config + +SYNOPSIS + gcloud beta netapp kms-configs delete (KMS_CONFIG : --location=LOCATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a KMS (Key Management System) Config + +EXAMPLES + The following command deletes a KMS Config instance named KMS_CONFIG in the + default netapp/location + + $ gcloud beta netapp kms-configs delete KMS_CONFIG + + To delete a KMS Config named KMS_CONFIG asynchronously, run the following + command: + + $ gcloud beta netapp kms-configs delete KMS_CONFIG --async + +POSITIONAL ARGUMENTS + Kms config resource - The KMS Config 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 kms_config 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. + + KMS_CONFIG + ID of the kms_config or fully qualified identifier for the + kms_config. + + To set the kms_config attribute: + ▸ provide the argument kms_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the kms_config. + + To set the location attribute: + ▸ provide the argument kms_config on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/kms-configs/describe b/gcloud/beta/netapp/kms-configs/describe new file mode 100644 index 000000000..e43568f3c --- /dev/null +++ b/gcloud/beta/netapp/kms-configs/describe @@ -0,0 +1,68 @@ +NAME + gcloud beta netapp kms-configs describe - show metadata for a Cloud NetApp + Volumes KMS Config + +SYNOPSIS + gcloud beta netapp kms-configs describe (KMS_CONFIG : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a KMS (Key Management System) Config + +EXAMPLES + The following command gets metadata using describe for a KMS Config + instance named KMS_CONFIG in the default netapp/location + + $ gcloud beta netapp kms-configs describe KMS_CONFIG + + To get metadata on a KMS Config named KMS_CONFIG in a specified location, + run: + + $ gcloud beta netapp kms-configs describe KMS_CONFIG \ + --location=us-central1s + +POSITIONAL ARGUMENTS + Kms config resource - The KMS Config 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 kms_config 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. + + KMS_CONFIG + ID of the kms_config or fully qualified identifier for the + kms_config. + + To set the kms_config attribute: + ▸ provide the argument kms_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the kms_config. + + To set the location attribute: + ▸ provide the argument kms_config on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/kms-configs/encrypt b/gcloud/beta/netapp/kms-configs/encrypt new file mode 100644 index 000000000..fa38ef5ad --- /dev/null +++ b/gcloud/beta/netapp/kms-configs/encrypt @@ -0,0 +1,70 @@ +NAME + gcloud beta netapp kms-configs encrypt - encrypt all existing volumes and + storage pools in the same region with the desired Cloud NetApp Volumes + KMS Config + +SYNOPSIS + gcloud beta netapp kms-configs encrypt (KMS_CONFIG : --location=LOCATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Encrypt the existing volumes with the desired KMS (Key Management + System) Config using Customer Managed Encryption Keys (CMEK) + +EXAMPLES + The following command encrypts the existing volumes with the desired KMS + Config instance named KMS_CONFIG using specified project and location. + + $ gcloud beta netapp kms-configs encrypt KMS_CONFIG \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Kms config resource - The KMS Config used to encrypt 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 kms_config 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. + + KMS_CONFIG + ID of the kms_config or fully qualified identifier for the + kms_config. + + To set the kms_config attribute: + ▸ provide the argument kms_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the kms_config. + + To set the location attribute: + ▸ provide the argument kms_config on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/kms-configs/help b/gcloud/beta/netapp/kms-configs/help new file mode 100644 index 000000000..432269ba9 --- /dev/null +++ b/gcloud/beta/netapp/kms-configs/help @@ -0,0 +1,43 @@ +NAME + gcloud beta netapp kms-configs - create and manage Cloud NetApp Volumes KMS + Configs + +SYNOPSIS + gcloud beta netapp kms-configs COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create and manage Cloud NetApp Volumes KMS Configs. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a Cloud NetApp Volumes KMS Config. + + delete + (BETA) Delete a Cloud NetApp Volumes KMS Config. + + describe + (BETA) Show metadata for a Cloud NetApp Volumes KMS Config. + + encrypt + (BETA) Encrypt all existing volumes and storage pools in the same + region with the desired Cloud NetApp Volumes KMS Config. + + list + (BETA) List Cloud NetApp Volumes KMS Configs. + + update + (BETA) Update a Cloud NetApp Volumes KMS Config. + + verify + (BETA) Verify that the Cloud NetApp Volumes KMS Config is reachable. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/kms-configs/list b/gcloud/beta/netapp/kms-configs/list new file mode 100644 index 000000000..c741f6db6 --- /dev/null +++ b/gcloud/beta/netapp/kms-configs/list @@ -0,0 +1,88 @@ +NAME + gcloud beta netapp kms-configs list - list Cloud NetApp Volumes KMS Configs + +SYNOPSIS + gcloud beta netapp kms-configs list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Lists KMS (Key Management System) Configs to encrypt Cloud NetApp + Volumes, Storage Pools etc. using Customer Managed Encryption Keys (CMEK) + +EXAMPLES + The following command lists all KMS Config instance in the default + netapp/location + + $ gcloud beta netapp kms-configs list + + To list all KMS Configs in a specified location, run: + + $ gcloud beta netapp kms-configs list --location=us-central1 + +FLAGS + Location resource - The location in which to list KMS Configs. 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 --location on the command line with a fully + specified name; + ◆ uses all locations by default. with a fully specified name; + ◆ set the property netapp/location with a fully specified name; + ◆ set the property netapp/region with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ uses all locations by default.; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/kms-configs/update b/gcloud/beta/netapp/kms-configs/update new file mode 100644 index 000000000..3bf8db95d --- /dev/null +++ b/gcloud/beta/netapp/kms-configs/update @@ -0,0 +1,155 @@ +NAME + gcloud beta netapp kms-configs update - update a Cloud NetApp Volumes KMS + Config + +SYNOPSIS + gcloud beta netapp kms-configs update (KMS_CONFIG : --location=LOCATION) + [--async] [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] + [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING + --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Updates a KMS (Key Management System) Config + +EXAMPLES + The following command updates a KMS Config instance named KMS_CONFIG with + all possible arguments + + $ gcloud beta netapp kms-configs update KMS_CONFIG \ + --location=us-central1 --kms-location=europe-southwest1 \ + --kms-project=new-kms-project --kms-keyring=kms-keyring2 \ + --kms-key=crypto-key2 + + To update a KMS Config named KMS_CONFIG asynchronously, run the following + command: + + $ gcloud beta netapp kms-configs update KMS_CONFIG --async \ + --location=us-central1 --kms-location=europe-southwest1 \ + --kms-project=new-kms-project --kms-keyring=kms-keyring2 \ + --kms-key=crypto-key2 + +POSITIONAL ARGUMENTS + Kms config resource - The KMS Config to update 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 kms_config 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. + + KMS_CONFIG + ID of the kms_config or fully qualified identifier for the + kms_config. + + To set the kms_config attribute: + ▸ provide the argument kms_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the kms_config. + + To set the location attribute: + ▸ provide the argument kms_config on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp KMS Config + + --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. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta netapp kms-configs update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta netapp kms-configs update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + + Kms key resource - The Cloud KMS (Key Management Service) Crypto Key that + will be used The arguments in this group can be used to specify the + attributes of this resource. + + --kms-key=KMS_KEY + ID of the kms_key or fully qualified identifier for the kms_key. + + To set the kms-key attribute: + ▸ provide the argument --kms-key on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --kms-keyring=KMS_KEYRING + The KMS keyring of the kms_key + + To set the kms-keyring attribute: + ▸ provide the argument --kms-key on the command line with a fully + specified name; + ▸ provide the argument --kms-keyring on the command line. + + --kms-location=KMS_LOCATION + The Cloud location for the kms_key. + + To set the kms-location attribute: + ▸ provide the argument --kms-key on the command line with a fully + specified name; + ▸ provide the argument --kms-location on the command line; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + + --kms-project=KMS_PROJECT + The Cloud project for the kms_key. + + To set the kms-project attribute: + ▸ provide the argument --kms-key on the command line with a fully + specified name; + ▸ provide the argument --kms-project on the command line; + ▸ set the property core/project. + +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. + diff --git a/gcloud/beta/netapp/kms-configs/verify b/gcloud/beta/netapp/kms-configs/verify new file mode 100644 index 000000000..7fdf7f2a4 --- /dev/null +++ b/gcloud/beta/netapp/kms-configs/verify @@ -0,0 +1,64 @@ +NAME + gcloud beta netapp kms-configs verify - verify that the Cloud NetApp + Volumes KMS Config is reachable + +SYNOPSIS + gcloud beta netapp kms-configs verify (KMS_CONFIG : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Verifies that the Cloud NetApp Volumes KMS (Key Management System) + Config is reachable + +EXAMPLES + The following command verifies that the KMS Config instance named + KMS_CONFIG is reachable using specified location. + + $ gcloud beta netapp kms-configs verify KMS_CONFIG \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Kms config resource - The KMS Config used to verify 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 kms_config 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. + + KMS_CONFIG + ID of the kms_config or fully qualified identifier for the + kms_config. + + To set the kms_config attribute: + ▸ provide the argument kms_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the kms_config. + + To set the location attribute: + ▸ provide the argument kms_config on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/locations/describe b/gcloud/beta/netapp/locations/describe new file mode 100644 index 000000000..53cda9f44 --- /dev/null +++ b/gcloud/beta/netapp/locations/describe @@ -0,0 +1,49 @@ +NAME + gcloud beta netapp locations describe - describe a Cloud NetApp Files + location + +SYNOPSIS + gcloud beta netapp locations describe LOCATION [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a Cloud NetApp Files location. + +EXAMPLES + The following command shows the details for the NetApp Files location named + NAME. + + $ gcloud beta netapp locations describe NAME + +POSITIONAL ARGUMENTS + Location resource - The location to describe. 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 location 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. + + LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp locations describe + diff --git a/gcloud/beta/netapp/locations/help b/gcloud/beta/netapp/locations/help new file mode 100644 index 000000000..d97d0f8d5 --- /dev/null +++ b/gcloud/beta/netapp/locations/help @@ -0,0 +1,30 @@ +NAME + gcloud beta netapp locations - get and list locations where Cloud NetApp + Files is available + +SYNOPSIS + gcloud beta netapp locations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Get and list locations where Cloud NetApp Files is available. + +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 Cloud NetApp Files location. + + list + (BETA) List all Cloud NetApp Files locations. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp locations + diff --git a/gcloud/beta/netapp/locations/list b/gcloud/beta/netapp/locations/list new file mode 100644 index 000000000..3dcd73ece --- /dev/null +++ b/gcloud/beta/netapp/locations/list @@ -0,0 +1,62 @@ +NAME + gcloud beta netapp locations list - list all Cloud NetApp Files locations + +SYNOPSIS + gcloud beta netapp locations list [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Lists all Cloud NetApp Files locations. + +EXAMPLES + The following command lists NetApp Files locations. + + $ gcloud beta netapp 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. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp locations list + diff --git a/gcloud/beta/netapp/operations/describe b/gcloud/beta/netapp/operations/describe new file mode 100644 index 000000000..cd55018ca --- /dev/null +++ b/gcloud/beta/netapp/operations/describe @@ -0,0 +1,64 @@ +NAME + gcloud beta netapp operations describe - describe a Cloud NetApp Files + operation + +SYNOPSIS + gcloud beta netapp operations describe (OPERATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a Cloud NetApp Files operation. + +EXAMPLES + The following command shows the details for the NetApp Files operation + named NAME. + + $ gcloud beta netapp operations describe NAME + +POSITIONAL ARGUMENTS + Operation resource - The operation 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. + + --location=LOCATION + The location of the operation. + + To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp operations describe + diff --git a/gcloud/beta/netapp/operations/help b/gcloud/beta/netapp/operations/help new file mode 100644 index 000000000..2b0073eb4 --- /dev/null +++ b/gcloud/beta/netapp/operations/help @@ -0,0 +1,30 @@ +NAME + gcloud beta netapp operations - read and manage Cloud NetApp Files + Operations + +SYNOPSIS + gcloud beta netapp operations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Read and manage Cloud NetApp Files 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 Cloud NetApp Files operation. + + list + (BETA) List Cloud NetApp Files operations. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp operations + diff --git a/gcloud/beta/netapp/operations/list b/gcloud/beta/netapp/operations/list new file mode 100644 index 000000000..2c1817dc4 --- /dev/null +++ b/gcloud/beta/netapp/operations/list @@ -0,0 +1,85 @@ +NAME + gcloud beta netapp operations list - list Cloud NetApp Files operations + +SYNOPSIS + gcloud beta netapp operations list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Lists all Cloud NetApp Files operations. + +EXAMPLES + The following command lists NetApp Files operations under a given location + + $ gcloud beta netapp operations list --location=us-central1 + +FLAGS + Location resource - The location in which to list operations. 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 --location on the command line with a fully + specified name; + ◆ uses all locations by default. with a fully specified name; + ◆ set the property netapp/location with a fully specified name; + ◆ set the property netapp/region with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ uses all locations by default.; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp operations list + diff --git a/gcloud/beta/netapp/storage-pools/create b/gcloud/beta/netapp/storage-pools/create new file mode 100644 index 000000000..329123b03 --- /dev/null +++ b/gcloud/beta/netapp/storage-pools/create @@ -0,0 +1,176 @@ +NAME + gcloud beta netapp storage-pools create - create a Cloud NetApp Storage + Pool + +SYNOPSIS + gcloud beta netapp storage-pools create + (STORAGE_POOL : --location=LOCATION) --capacity=CAPACITY + --network=[name=NAME],[psa-range=PSA-RANGE] + --service-level=SERVICE_LEVEL [--active-directory=ACTIVE_DIRECTORY] + [--async] [--description=DESCRIPTION] [--enable-ldap=ENABLE_LDAP] + [--kms-config=KMS_CONFIG] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Creates a Storage Pool to contain Volumes with a specified Service + Level and capacity. + +EXAMPLES + The following command creates a Storage Pool named NAME using all possible + arguments + + $ gcloud beta netapp storage-pools create NAME \ + --location=us-central1 --service-level=standard \ + --capacity=2048 --network=name=default --active-directory=ad1 \ + --kms-config=kms-config1 --enable-ldap=true \ + --description="example description" + +POSITIONAL ARGUMENTS + Storage pool resource - The Storage Pool 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 storage_pool 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. + + STORAGE_POOL + ID of the storage_pool or fully qualified identifier for the + storage_pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the storage_pool. + + To set the location attribute: + ▸ provide the argument storage_pool on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +REQUIRED FLAGS + --capacity=CAPACITY + The desired capacity of the Storage Pool in GiB or TiB units.If no + capacity unit is specified, GiB is assumed. + + --network=[name=NAME],[psa-range=PSA-RANGE] + Network configuration for a Cloud NetApp Files Storage Pool. Specifying + psa-range is optional. + name + The name of the Google Compute Engine VPC network to which the + volume is connected. + psa-range + The psa-range is the name of the allocated range of the Private + Service Access connection. The range you specify can't overlap with + either existing subnets or assigned IP address ranges for other + Cloud NetApp Files Storage Pools in the selected VPC network. + + --service-level=SERVICE_LEVEL + The service level for the Cloud NetApp Storage Pool. For more details, + see: + https://cloud.google.com/architecture/partners/netapp-cloud-volumes/service-levels + + SERVICE_LEVEL must be one of: + + extreme + Extreme Service Level for Cloud NetApp Storage Pool. The Extreme + Service Level has a throughput per TiB of allocated volume size of + 128 MiB/s. + premium + Premium Service Level for Cloud NetApp Storage Pool. The Premium + Service Level has a throughput per TiB of allocated volume size of + 64 MiB/s. + +OPTIONAL FLAGS + Active directory resource - The Active Directory to attach to the Storage + Pool. 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 --active-directory on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --active-directory on the command line with a + fully specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --active-directory=ACTIVE_DIRECTORY + ID of the active_directory or fully qualified identifier for the + active_directory. + + To set the active_directory attribute: + ▸ provide the argument --active-directory on the command line. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Storage Pool + + --enable-ldap=ENABLE_LDAP + Boolean flag indicating whether Storage Pool is a NFS LDAP Storage Pool + or not + + Kms config resource - The KMS config to attach to the Storage Pool. 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 --kms-config on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --kms-config on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --kms-config=KMS_CONFIG + ID of the kms_config or fully qualified identifier for the + kms_config. + + To set the kms_config attribute: + ▸ provide the argument --kms-config on the command line. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +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 netapp storage-pools create + diff --git a/gcloud/beta/netapp/storage-pools/delete b/gcloud/beta/netapp/storage-pools/delete new file mode 100644 index 000000000..429b71324 --- /dev/null +++ b/gcloud/beta/netapp/storage-pools/delete @@ -0,0 +1,75 @@ +NAME + gcloud beta netapp storage-pools delete - delete a Cloud NetApp Storage + Pool + +SYNOPSIS + gcloud beta netapp storage-pools delete + (STORAGE_POOL : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a Storage Pool + +EXAMPLES + The following command deletes a Storage Pool named NAME in the given + location + + $ gcloud beta netapp storage-pools delete NAME --location=us-central1 + + To delete a Storage Pool asynchronously, run the following command: + + $ gcloud beta netapp storage-pools delete NAME \ + --location=us-central1 --async + +POSITIONAL ARGUMENTS + Storage pool resource - The Storage Pool 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 storage_pool 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. + + STORAGE_POOL + ID of the storage_pool or fully qualified identifier for the + storage_pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the storage_pool. + + To set the location attribute: + ▸ provide the argument storage_pool on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp storage-pools delete + diff --git a/gcloud/beta/netapp/storage-pools/describe b/gcloud/beta/netapp/storage-pools/describe new file mode 100644 index 000000000..fe8d7cbf5 --- /dev/null +++ b/gcloud/beta/netapp/storage-pools/describe @@ -0,0 +1,66 @@ +NAME + gcloud beta netapp storage-pools describe - show metadata for a Cloud + NetApp Storage Pool + +SYNOPSIS + gcloud beta netapp storage-pools describe + (STORAGE_POOL : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a Storage Pool + +EXAMPLES + The following command describes a Storage Pool named NAME in the given + location + + $ gcloud beta netapp storage-pools describe NAME \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Storage pool resource - The Storage Pool 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 storage_pool 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. + + STORAGE_POOL + ID of the storage_pool or fully qualified identifier for the + storage_pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the storage_pool. + + To set the location attribute: + ▸ provide the argument storage_pool on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp storage-pools describe + diff --git a/gcloud/beta/netapp/storage-pools/help b/gcloud/beta/netapp/storage-pools/help new file mode 100644 index 000000000..a51ae97aa --- /dev/null +++ b/gcloud/beta/netapp/storage-pools/help @@ -0,0 +1,39 @@ +NAME + gcloud beta netapp storage-pools - create and manage Cloud NetApp Storage + Pools + +SYNOPSIS + gcloud beta netapp storage-pools COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create and manage Cloud NetApp Storage Pools. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a Cloud NetApp Storage Pool. + + delete + (BETA) Delete a Cloud NetApp Storage Pool. + + describe + (BETA) Show metadata for a Cloud NetApp Storage Pool. + + list + (BETA) List Cloud NetApp Storage Pools. + + update + (BETA) Update a Cloud NetApp Storage Pool. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp storage-pools + diff --git a/gcloud/beta/netapp/storage-pools/list b/gcloud/beta/netapp/storage-pools/list new file mode 100644 index 000000000..2023797f6 --- /dev/null +++ b/gcloud/beta/netapp/storage-pools/list @@ -0,0 +1,85 @@ +NAME + gcloud beta netapp storage-pools list - list Cloud NetApp Storage Pools + +SYNOPSIS + gcloud beta netapp storage-pools list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Lists Storage Pools + +EXAMPLES + The following command lists Storage Pools in the given location + + $ gcloud beta netapp storage-pools list --location=us-central1 + +FLAGS + Location resource - The location in which to list Storage Pools. 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 --location on the command line with a fully + specified name; + ◆ uses all locations by default. with a fully specified name; + ◆ set the property netapp/location with a fully specified name; + ◆ set the property netapp/region with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ uses all locations by default.; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp storage-pools list + diff --git a/gcloud/beta/netapp/storage-pools/update b/gcloud/beta/netapp/storage-pools/update new file mode 100644 index 000000000..7dc7beecd --- /dev/null +++ b/gcloud/beta/netapp/storage-pools/update @@ -0,0 +1,135 @@ +NAME + gcloud beta netapp storage-pools update - update a Cloud NetApp Storage + Pool + +SYNOPSIS + gcloud beta netapp storage-pools update + (STORAGE_POOL : --location=LOCATION) + [--active-directory=ACTIVE_DIRECTORY] [--async] [--capacity=CAPACITY] + [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Updates a Storage Pool with given arguments + +EXAMPLES + The following command updates a Storage Pool named NAME in the given + location + + $ gcloud beta netapp storage-pools update NAME \ + --location=us-central1 --capacity=4096 --active-directory=ad-2 \ + --description="new description" --update-labels=key1=val1 + +POSITIONAL ARGUMENTS + Storage pool resource - The Storage Pool to update. 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 storage_pool 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. + + STORAGE_POOL + ID of the storage_pool or fully qualified identifier for the + storage_pool. + + To set the storage_pool attribute: + ▸ provide the argument storage_pool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the storage_pool. + + To set the location attribute: + ▸ provide the argument storage_pool on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + Active directory resource - The Active Directory to attach to the Storage + Pool. 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 --active-directory on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --active-directory on the command line with a + fully specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --active-directory=ACTIVE_DIRECTORY + ID of the active_directory or fully qualified identifier for the + active_directory. + + To set the active_directory attribute: + ▸ provide the argument --active-directory on the command line. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --capacity=CAPACITY + The desired capacity of the Storage Pool in GiB or TiB units.If no + capacity unit is specified, GiB is assumed. + + --description=DESCRIPTION + A description of the Cloud NetApp Storage Pool + + --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. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta netapp storage-pools update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta netapp storage-pools update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +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 netapp storage-pools update + diff --git a/gcloud/beta/netapp/volumes/create b/gcloud/beta/netapp/volumes/create new file mode 100644 index 000000000..81eb6cc46 --- /dev/null +++ b/gcloud/beta/netapp/volumes/create @@ -0,0 +1,241 @@ +NAME + gcloud beta netapp volumes create - create a Cloud NetApp Volume + +SYNOPSIS + gcloud beta netapp volumes create (VOLUME : --location=LOCATION) + --capacity=CAPACITY --protocols=PROTOCOL,[PROTOCOL,...] + --share-name=SHARE_NAME --storage-pool=STORAGE_POOL [--async] + [--description=DESCRIPTION] [--enable-kerberos=ENABLE_KERBEROS] + [--export-policy=[access-type=ACCESS-TYPE], + [allowed-clients=ALLOWED-CLIENTS],[has-root-access=HAS-ROOT-ACCESS], + [kerberos-5-read-only=KERBEROS-5-READ-ONLY], + [kerberos-5-read-write=KERBEROS-5-READ-WRITE], + [kerberos-5i-read-only=KERBEROS-5I-READ-ONLY], + [kerberos-5i-read-write=KERBEROS-5I-READ-WRITE], + [kerberos-5p-read-only=KERBEROS-5P-READ-ONLY], + [kerberos-5p-read-write=KERBEROS-5P-READ-WRITE], + [nfsv3=NFSV3],[nfsv4=NFSV4]] [--labels=[KEY=VALUE,...]] + [--security-style=SECURITY_STYLE; default="SECURITY_STYLE_UNSPECIFIED"] + [--smb-settings=SMB_SETTING,[SMB_SETTING,...]] + [--snap-reserve=SNAP_RESERVE] + [--snapshot-daily=[hour=HOUR], + [minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] + [--snapshot-directory=SNAPSHOT_DIRECTORY; default="true"] + [--snapshot-hourly=[minute=MINUTE], + [snapshots-to-keep=SNAPSHOTS-TO-KEEP]] + [--snapshot-monthly=[day=DAY], + [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] + [--snapshot-weekly=[day=DAY], + [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] + [--source-snapshot=SOURCE_SNAPSHOT] + [--unix-permissions=UNIX_PERMISSIONS] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a Cloud NetApp Volume + +EXAMPLES + The following command creates a NFS Volume named NAME asynchronously using + the specified arguments + + $ gcloud beta netapp volumes create NAME --capacity=1024 \ + --protocols=nfsv3,nfsv4 --share-name=share1 --storage-pool=sp1 \ + --description="test description" --enable-kerberos=true \ + --unix-permissions=0755 --async + + The following command creates a SMB Volume named NAME asynchronously using + the specified arguments + + $ gcloud beta netapp volumes create NAME --capacity=1024 \ + --protocols=smb --share-name=share2 --storage-pool=sp2 \ + --description="test smb" --security-style=ntfs \ + --smb-settings=SHOW_SNAPSHOT,SHOW_PREVIOUS_VERSIONS,\ + ACCESS_BASED_ENUMERATION --snap-reserve=0.1 --async + +POSITIONAL ARGUMENTS + Volume resource - The Volume 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 volume 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. + + VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument volume on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the volume. + + To set the location attribute: + ▸ provide the argument volume on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +REQUIRED FLAGS + --capacity=CAPACITY + The desired capacity of the Volume in GiB or TiB units.If no capacity + unit is specified, GiB is assumed. + + --protocols=PROTOCOL,[PROTOCOL,...] + Type of File System protocols for the Cloud NetApp Files VolumeValid + component values are: NFSV3, NFSV4, SMB + + For more information, look athttps://cloud.google.com/netapp/docs/reference/rest/v1alpha1/projects.locations.volumes#protocols. + + --share-name=SHARE_NAME + Share name of the Mount path clients will use. + + Storage pool resource - The Storage Pool to associate with Volume. 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 --storage-pool on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --storage-pool on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + This must be specified. + + --storage-pool=STORAGE_POOL + ID of the storage_pool or fully qualified identifier for the + storage_pool. + + To set the storage_pool attribute: + ▸ provide the argument --storage-pool on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Volume + + --enable-kerberos=ENABLE_KERBEROS + Boolean flag indicating whether Volume is a kerberos Volume or not + + --export-policy=[access-type=ACCESS-TYPE],[allowed-clients=ALLOWED-CLIENTS],[has-root-access=HAS-ROOT-ACCESS],[kerberos-5-read-only=KERBEROS-5-READ-ONLY],[kerberos-5-read-write=KERBEROS-5-READ-WRITE],[kerberos-5i-read-only=KERBEROS-5I-READ-ONLY],[kerberos-5i-read-write=KERBEROS-5I-READ-WRITE],[kerberos-5p-read-only=KERBEROS-5P-READ-ONLY],[kerberos-5p-read-write=KERBEROS-5P-READ-WRITE],[nfsv3=NFSV3],[nfsv4=NFSV4] + Export Policy of a Cloud NetApp Files Volume. This will be a field + similar to network in which export policy fields can be specified as + such: --export-policy=allowed-clients=ALLOWED_CLIENTS_IP_ADDRESSES, + has-root-access=HAS_ROOT_ACCESS_BOOL,access=ACCESS_TYPE,nfsv3=NFSV3, + nfsv4=NFSV4,kerberos-5-read-only=KERBEROS_5_READ_ONLY, + kerberos-5-read-write=KERBEROS_5_READ_WRITE, + kerberos-5i-read-only=KERBEROS_5I_READ_ONLY, + kerberos-5i-read-write=KERBEROS_5I_READ_WRITE, + kerberos-5p-read-only=KERBEROS_5P_READ_ONLY, + kerberos-5p-read-write=KERBEROS_5P_READ_WRITE + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --security-style=SECURITY_STYLE; default="SECURITY_STYLE_UNSPECIFIED" + The security style of the Volume. This can either be UNIX or NTFS. + + SECURITY_STYLE must be one of: + + ntfs + NTFS security style for Volume. + unix + UNIX security style for Volume + + --smb-settings=SMB_SETTING,[SMB_SETTING,...] + List of settings specific to SMB protocolfor a Cloud NetApp Files + VolumeValid component values are: ENCRYPT_DATA, BROWSABLE, + CHANGE_NOTIFY, NON_BROWSABLE, OPLOCKS, SHOW_SNAPSHOT, + SHOW_PREVIOUS_VERSIONS, ACCESS_BASED_ENUMERATION, + CONTINUOUSLY_AVAILABLE + + For more information, look at https://cloud.google.com/netapp/docs/reference/rest/v1alpha1/projects.locations.volumes#smbsettings. + + --snap-reserve=SNAP_RESERVE + The percentage of volume storage reserved for snapshot storage. The + default value for this is 0 percent + + --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] + Make a snapshot every day e.g. at 06:00, 05:20, 23:50 + + --snapshot-directory=SNAPSHOT_DIRECTORY; default="true" + Snapshot Directory if enabled (true) makes the Volume contain a + read-only .snapshot directory which provides access to each of the + volume's snapshots + + --snapshot-hourly=[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] + Make a snapshot every hour e.g. at 04:00, 05:20, 06:00 + + --snapshot-monthly=[day=DAY],[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] + Make a snapshot once a month e.g. at 2nd 04:00, 7th 05:20, 24th 23:50 + + --snapshot-weekly=[day=DAY],[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] + Make a snapshot every week e.g. at Monday 04:00, Wednesday 05:20, + Sunday 23:50 + + Snapshot resource - The source Snapshot to create the Volume from. 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 --source-snapshot on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --source-snapshot on the command line with a + fully specified name; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + To set the volume attribute: + ◆ provide the argument --source-snapshot on the command line with a + fully specified name. + + --source-snapshot=SOURCE_SNAPSHOT + ID of the snapshot or fully qualified identifier for the snapshot. + + To set the snapshot attribute: + ▸ provide the argument --source-snapshot on the command line. + + --unix-permissions=UNIX_PERMISSIONS + Unix permissions the mount point will be created with.Unix permissions + are only applicable with NFS protocol only + +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 netapp volumes create + diff --git a/gcloud/beta/netapp/volumes/delete b/gcloud/beta/netapp/volumes/delete new file mode 100644 index 000000000..6cde097ab --- /dev/null +++ b/gcloud/beta/netapp/volumes/delete @@ -0,0 +1,75 @@ +NAME + gcloud beta netapp volumes delete - delete a Cloud NetApp Volume + +SYNOPSIS + gcloud beta netapp volumes delete (VOLUME : --location=LOCATION) [--async] + [--force] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a Cloud NetApp Volume + +EXAMPLES + The following command deletes a Volume named NAME in the given location + + $ gcloud beta netapp volumes delete NAME --location=us-central1 + + To delete a Volume named NAME asynchronously, run the following command: + + $ gcloud beta netapp volumes delete NAME --location=us-central1 \ + --async + +POSITIONAL ARGUMENTS + Volume resource - The Volume 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 volume 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. + + VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument volume on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the volume. + + To set the location attribute: + ▸ provide the argument volume on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --force + Forces the deletion of a volume and its child resources, such as + snapshots. + +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 netapp volumes delete + diff --git a/gcloud/beta/netapp/volumes/describe b/gcloud/beta/netapp/volumes/describe new file mode 100644 index 000000000..c9f6ece4e --- /dev/null +++ b/gcloud/beta/netapp/volumes/describe @@ -0,0 +1,62 @@ +NAME + gcloud beta netapp volumes describe - show metadata for a Cloud NetApp + Volume + +SYNOPSIS + gcloud beta netapp volumes describe (VOLUME : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a Cloud NetApp Volume + +EXAMPLES + The following command describe a Volume named NAME in the given location + + $ gcloud beta netapp volumes describe NAME --location=us-central1 + +POSITIONAL ARGUMENTS + Volume resource - The Volume 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 volume 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. + + VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument volume on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the volume. + + To set the location attribute: + ▸ provide the argument volume on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp volumes describe + diff --git a/gcloud/beta/netapp/volumes/help b/gcloud/beta/netapp/volumes/help new file mode 100644 index 000000000..b640f8268 --- /dev/null +++ b/gcloud/beta/netapp/volumes/help @@ -0,0 +1,50 @@ +NAME + gcloud beta netapp volumes - create and manage Cloud NetApp Volumes + +SYNOPSIS + gcloud beta netapp volumes GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create and manage Cloud NetApp Volumes. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + replications + (BETA) Create and manage Cloud NetApp Volume Replications. + + snapshots + (BETA) Create and manage Cloud NetApp Volume Snapshots. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a Cloud NetApp Volume. + + delete + (BETA) Delete a Cloud NetApp Volume. + + describe + (BETA) Show metadata for a Cloud NetApp Volume. + + list + (BETA) List Cloud NetApp Volumes. + + revert + (BETA) Revert a Cloud NetApp Volume back to a specified Snapshot. + + update + (BETA) Update a Cloud NetApp Volume. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp volumes + diff --git a/gcloud/beta/netapp/volumes/list b/gcloud/beta/netapp/volumes/list new file mode 100644 index 000000000..125808dc5 --- /dev/null +++ b/gcloud/beta/netapp/volumes/list @@ -0,0 +1,85 @@ +NAME + gcloud beta netapp volumes list - list Cloud NetApp Volumes + +SYNOPSIS + gcloud beta netapp volumes list [--location=LOCATION] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Lists Cloud NetApp Volumes + +EXAMPLES + The following command lists all Volumes in the given location + + $ gcloud beta netapp volumes list --location=us-central1 + +FLAGS + Location resource - The location in which to list Volumes. 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 --location on the command line with a fully + specified name; + ◆ uses all locations by default. with a fully specified name; + ◆ set the property netapp/location with a fully specified name; + ◆ set the property netapp/region with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ uses all locations by default.; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp volumes list + diff --git a/gcloud/beta/netapp/volumes/replications/create b/gcloud/beta/netapp/volumes/replications/create new file mode 100644 index 000000000..da4da8bc5 --- /dev/null +++ b/gcloud/beta/netapp/volumes/replications/create @@ -0,0 +1,121 @@ +NAME + gcloud beta netapp volumes replications create - create a Cloud NetApp + Volume Replication + +SYNOPSIS + gcloud beta netapp volumes replications create + (REPLICATION : --location=LOCATION) + --destination-volume-parameters=[description=DESCRIPTION], + [share_name=SHARE_NAME], + [storage_pool=STORAGE_POOL],[volume_id=VOLUME_ID] + --replication-schedule=REPLICATION_SCHEDULE [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a Cloud NetApp Volume Replication + +EXAMPLES + The following command creates a Replication named NAME using the required + arguments + + $ gcloud beta netapp volumes replications create NAME \ + --location=us-central1 --volume=vol1 \ + --replication-schedule=EVERY_10_MINUTES \ + --destination-volume-parameters=storage_pool=sp1,\ + volume_id=vol2,share_name=share2 + +POSITIONAL ARGUMENTS + Replication resource - The Replication 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 replication on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the volume attribute: + ◆ provide the argument replication on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + REPLICATION + ID of the replication or fully qualified identifier for the + replication. + + To set the replication attribute: + ▸ provide the argument replication on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the replication. + + To set the location attribute: + ▸ provide the argument replication on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +REQUIRED FLAGS + --destination-volume-parameters=[description=DESCRIPTION],[share_name=SHARE_NAME],[storage_pool=STORAGE_POOL],[volume_id=VOLUME_ID] + --replication-schedule=REPLICATION_SCHEDULE + The schedule for the Replication. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Replication + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + Volume resource - The Volume that the Replication is based on 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/volumes/replications/delete b/gcloud/beta/netapp/volumes/replications/delete new file mode 100644 index 000000000..dfaec8305 --- /dev/null +++ b/gcloud/beta/netapp/volumes/replications/delete @@ -0,0 +1,103 @@ +NAME + gcloud beta netapp volumes replications delete - delete a Cloud NetApp + Volume Replication + +SYNOPSIS + gcloud beta netapp volumes replications delete + (REPLICATION : --location=LOCATION) [--async] [--volume=VOLUME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a Cloud NetApp Volume Replication + +EXAMPLES + The following command deletes a Replication named NAME using the required + arguments + + $ gcloud beta netapp volumes replications delete NAME \ + --location=us-central1 --volume=vol1 + + To delete a Replication named NAME asynchronously, run the following + command: + + $ gcloud beta netapp volumes replications delete NAME \ + --location=us-central1 --volume=vol1 --async + +POSITIONAL ARGUMENTS + Replication resource - The Replication 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 replication on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the volume attribute: + ◆ provide the argument replication on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + REPLICATION + ID of the replication or fully qualified identifier for the + replication. + + To set the replication attribute: + ▸ provide the argument replication on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the replication. + + To set the location attribute: + ▸ provide the argument replication on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Volume resource - The Volume that the Replication is based on 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/volumes/replications/describe b/gcloud/beta/netapp/volumes/replications/describe new file mode 100644 index 000000000..0508b64a4 --- /dev/null +++ b/gcloud/beta/netapp/volumes/replications/describe @@ -0,0 +1,93 @@ +NAME + gcloud beta netapp volumes replications describe - describe a Cloud NetApp + Volume Replication + +SYNOPSIS + gcloud beta netapp volumes replications describe + (REPLICATION : --location=LOCATION) [--volume=VOLUME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a Cloud NetApp Volume Replication + +EXAMPLES + The following command describes a Replication named NAME in the given + location and volume + + $ gcloud beta netapp volumes replications describe NAME \ + --location=us-central1 --volume=vol1 + +POSITIONAL ARGUMENTS + Replication resource - The Replication 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 replication on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the volume attribute: + ◆ provide the argument replication on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + REPLICATION + ID of the replication or fully qualified identifier for the + replication. + + To set the replication attribute: + ▸ provide the argument replication on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the replication. + + To set the location attribute: + ▸ provide the argument replication on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + Volume resource - The Volume that the Replication is based on 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/volumes/replications/help b/gcloud/beta/netapp/volumes/replications/help new file mode 100644 index 000000000..c95055adb --- /dev/null +++ b/gcloud/beta/netapp/volumes/replications/help @@ -0,0 +1,45 @@ +NAME + gcloud beta netapp volumes replications - create and manage Cloud NetApp + Volume Replications + +SYNOPSIS + gcloud beta netapp volumes replications COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create and manage Cloud NetApp Volume Replications. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a Cloud NetApp Volume Replication. + + delete + (BETA) Delete a Cloud NetApp Volume Replication. + + describe + (BETA) Describe a Cloud NetApp Volume Replication. + + list + (BETA) List Cloud NetApp Volume Replications. + + resume + (BETA) Resume a Cloud NetApp Volume Replication. + + reverse + (BETA) Reverse a Cloud NetApp Volume Replication's direction. + + stop + (BETA) Stop a Cloud NetApp Volume Replication. + + update + (BETA) Update a Cloud NetApp Volume Replication. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/volumes/replications/list b/gcloud/beta/netapp/volumes/replications/list new file mode 100644 index 000000000..fef5dde1c --- /dev/null +++ b/gcloud/beta/netapp/volumes/replications/list @@ -0,0 +1,109 @@ +NAME + gcloud beta netapp volumes replications list - list Cloud NetApp Volume + Replications + +SYNOPSIS + gcloud beta netapp volumes replications list [--location=LOCATION] + [--volume=VOLUME] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Lists Cloud NetApp Volume Replications + +EXAMPLES + The following command lists all Replications in the given location and + volume + + $ gcloud beta netapp volumes replications list \ + --location=us-central1 --volume=vol1 + +FLAGS + Location resource - The location in which to list Volume Replications. + 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 --location on the command line with a fully + specified name; + ◆ uses all locations by default. with a fully specified name; + ◆ set the property netapp/location with a fully specified name; + ◆ set the property netapp/region with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ uses all locations by default.; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + + Volume resource - The Volume that the Replication is based on 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume 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. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/volumes/replications/resume b/gcloud/beta/netapp/volumes/replications/resume new file mode 100644 index 000000000..dbf898138 --- /dev/null +++ b/gcloud/beta/netapp/volumes/replications/resume @@ -0,0 +1,103 @@ +NAME + gcloud beta netapp volumes replications resume - resume a Cloud NetApp + Volume Replication + +SYNOPSIS + gcloud beta netapp volumes replications resume + (REPLICATION : --location=LOCATION) [--async] [--volume=VOLUME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Resume a Cloud NetApp Volume Replication + +EXAMPLES + The following command resumes a Replication named NAME using the required + arguments + + $ gcloud beta netapp volumes replications resume NAME \ + --location=us-central1 --volume=vol1 + + To resume a Replication named NAME asynchronously, run the following + command: + + $ gcloud beta netapp volumes replications resume NAME \ + --location=us-central1 --volume=vol1 --async + +POSITIONAL ARGUMENTS + Replication resource - The Replication 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 replication on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the volume attribute: + ◆ provide the argument replication on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + REPLICATION + ID of the replication or fully qualified identifier for the + replication. + + To set the replication attribute: + ▸ provide the argument replication on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the replication. + + To set the location attribute: + ▸ provide the argument replication on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Volume resource - The Volume that the Replication is based on 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/volumes/replications/reverse b/gcloud/beta/netapp/volumes/replications/reverse new file mode 100644 index 000000000..d5f035606 --- /dev/null +++ b/gcloud/beta/netapp/volumes/replications/reverse @@ -0,0 +1,103 @@ +NAME + gcloud beta netapp volumes replications reverse - reverse a Cloud NetApp + Volume Replication's direction + +SYNOPSIS + gcloud beta netapp volumes replications reverse + (REPLICATION : --location=LOCATION) [--async] [--volume=VOLUME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Reverse a Cloud NetApp Volume Replication + +EXAMPLES + The following command reverses a Replication named NAME using the required + arguments + + $ gcloud beta netapp volumes replications reverse NAME \ + --location=us-central1 --volume=vol1 + + To reverse a Replication named NAME asynchronously, run the following + command: + + $ gcloud beta netapp volumes replications reverse NAME \ + --location=us-central1 --volume=vol1 --async + +POSITIONAL ARGUMENTS + Replication resource - The Replication to reverse direction. 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 replication on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the volume attribute: + ◆ provide the argument replication on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + REPLICATION + ID of the replication or fully qualified identifier for the + replication. + + To set the replication attribute: + ▸ provide the argument replication on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the replication. + + To set the location attribute: + ▸ provide the argument replication on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Volume resource - The source Volume to reverse the Replication direction + of 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/volumes/replications/stop b/gcloud/beta/netapp/volumes/replications/stop new file mode 100644 index 000000000..d85588812 --- /dev/null +++ b/gcloud/beta/netapp/volumes/replications/stop @@ -0,0 +1,102 @@ +NAME + gcloud beta netapp volumes replications stop - stop a Cloud NetApp Volume + Replication + +SYNOPSIS + gcloud beta netapp volumes replications stop + (REPLICATION : --location=LOCATION) [--async] [--volume=VOLUME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Stop a Cloud NetApp Volume Replication + +EXAMPLES + The following command stops a Replication named NAME using the required + arguments + + $ gcloud beta netapp volumes replications stop NAME \ + --location=us-central1 --volume=vol1 + + To stop a Replication named NAME asynchronously, run the following command: + + $ gcloud beta netapp volumes replications stop NAME \ + --location=us-central1 --volume=vol1 --async + +POSITIONAL ARGUMENTS + Replication resource - The Replication 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 replication on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the volume attribute: + ◆ provide the argument replication on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + REPLICATION + ID of the replication or fully qualified identifier for the + replication. + + To set the replication attribute: + ▸ provide the argument replication on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the replication. + + To set the location attribute: + ▸ provide the argument replication on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Volume resource - The Volume that the Replication is based on 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/netapp/volumes/replications/update b/gcloud/beta/netapp/volumes/replications/update new file mode 100644 index 000000000..c076c7eef --- /dev/null +++ b/gcloud/beta/netapp/volumes/replications/update @@ -0,0 +1,138 @@ +NAME + gcloud beta netapp volumes replications update - update a Cloud NetApp + Volume Replication + +SYNOPSIS + gcloud beta netapp volumes replications update + (REPLICATION : --location=LOCATION) [--async] + [--description=DESCRIPTION] + [--replication-schedule=REPLICATION_SCHEDULE] + [--update-labels=[KEY=VALUE,...]] [--volume=VOLUME] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a Cloud NetApp Volume Replication and its specified + parameters + +EXAMPLES + The following command updates a Replication named NAME and its specified + parameters + + $ gcloud beta netapp volumes replications update NAME \ + --location=us-central1 --volume=vol1 \ + --replication-schedule=EVERY_5_MINUTES \ + --description="new description" + +POSITIONAL ARGUMENTS + Replication resource - The Replication to update. 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 replication on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the volume attribute: + ◆ provide the argument replication on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + REPLICATION + ID of the replication or fully qualified identifier for the + replication. + + To set the replication attribute: + ▸ provide the argument replication on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the replication. + + To set the location attribute: + ▸ provide the argument replication on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Replication + + --replication-schedule=REPLICATION_SCHEDULE + The schedule for the Replication. + + --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. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + Volume resource - The Volume that the Replication is based on 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta netapp volumes replications update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta netapp volumes replications update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +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. + diff --git a/gcloud/beta/netapp/volumes/revert b/gcloud/beta/netapp/volumes/revert new file mode 100644 index 000000000..ab4b4392b --- /dev/null +++ b/gcloud/beta/netapp/volumes/revert @@ -0,0 +1,98 @@ +NAME + gcloud beta netapp volumes revert - revert a Cloud NetApp Volume back to a + specified Snapshot + +SYNOPSIS + gcloud beta netapp volumes revert (VOLUME : --location=LOCATION) + --snapshot=SNAPSHOT [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Revert a Cloud NetApp Volume back to a specified source Snapshot + +EXAMPLES + The following command reverts a Volume named NAME in the given location and + snapshot + + $ gcloud beta netapp volumes revert NAME --location=us-central1 \ + --snapshot="snapshot1" + +POSITIONAL ARGUMENTS + Volume resource - The Volume to revert. 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 volume 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. + + VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument volume on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the volume. + + To set the location attribute: + ▸ provide the argument volume on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +REQUIRED FLAGS + Snapshot resource - The Snapshot to revert the Volume back to. 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 --snapshot on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --snapshot on the command line with a fully + specified name; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + To set the volume attribute: + ◆ provide the argument --snapshot on the command line with a fully + specified name. + + This must be specified. + + --snapshot=SNAPSHOT + ID of the snapshot or fully qualified identifier for the snapshot. + + To set the snapshot attribute: + ▸ provide the argument --snapshot on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp volumes revert + diff --git a/gcloud/beta/netapp/volumes/snapshots/create b/gcloud/beta/netapp/volumes/snapshots/create new file mode 100644 index 000000000..4d8eac2c4 --- /dev/null +++ b/gcloud/beta/netapp/volumes/snapshots/create @@ -0,0 +1,110 @@ +NAME + gcloud beta netapp volumes snapshots create - create a Cloud NetApp Volume + Snapshot + +SYNOPSIS + gcloud beta netapp volumes snapshots create + (SNAPSHOT : --location=LOCATION) [--async] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a Cloud NetApp Volume Snapshot + +EXAMPLES + The following command creates a Snapshot named NAME using the required + arguments + + $ gcloud beta netapp volumes snapshots create NAME \ + --location=us-central1 --volume=vol1 + +POSITIONAL ARGUMENTS + Snapshot resource - The Snapshot 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 snapshot on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the volume attribute: + ◆ provide the argument snapshot on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + SNAPSHOT + ID of the snapshot or fully qualified identifier for the snapshot. + + To set the snapshot attribute: + ▸ provide the argument snapshot on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the snapshot. + + To set the location attribute: + ▸ provide the argument snapshot on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Snapshot + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + Volume resource - The Volume to take a Snapshot of. 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp volumes snapshots create + diff --git a/gcloud/beta/netapp/volumes/snapshots/delete b/gcloud/beta/netapp/volumes/snapshots/delete new file mode 100644 index 000000000..e1bf228df --- /dev/null +++ b/gcloud/beta/netapp/volumes/snapshots/delete @@ -0,0 +1,104 @@ +NAME + gcloud beta netapp volumes snapshots delete - delete a Cloud NetApp Volume + Snapshot + +SYNOPSIS + gcloud beta netapp volumes snapshots delete + (SNAPSHOT : --location=LOCATION) [--async] [--volume=VOLUME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a Cloud NetApp Volume Snapshot + +EXAMPLES + The following command deletes a Snapshot named NAME in the given location + and volume + + $ gcloud beta netapp volumes snapshots delete NAME \ + --location=us-central1 --volume=vol1 + + To delete a Snapshot named NAME asynchronously, run the following command: + + $ gcloud beta netapp volumes snapshots delete NAME \ + --location=us-central1 --volume=vol1 --async + +POSITIONAL ARGUMENTS + Snapshot resource - The Snapshot 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 snapshot on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the volume attribute: + ◆ provide the argument snapshot on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + SNAPSHOT + ID of the snapshot or fully qualified identifier for the snapshot. + + To set the snapshot attribute: + ▸ provide the argument snapshot on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the snapshot. + + To set the location attribute: + ▸ provide the argument snapshot on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Volume resource - The Volume to take a Snapshot of. 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp volumes snapshots delete + diff --git a/gcloud/beta/netapp/volumes/snapshots/describe b/gcloud/beta/netapp/volumes/snapshots/describe new file mode 100644 index 000000000..7baf28c14 --- /dev/null +++ b/gcloud/beta/netapp/volumes/snapshots/describe @@ -0,0 +1,95 @@ +NAME + gcloud beta netapp volumes snapshots describe - describe a Cloud NetApp + Volume Snapshot + +SYNOPSIS + gcloud beta netapp volumes snapshots describe + (SNAPSHOT : --location=LOCATION) [--volume=VOLUME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a Cloud NetApp Volume Snapshot + +EXAMPLES + The following command describes a Snapshot named NAME in the given location + and volume + + $ gcloud beta netapp volumes snapshots describe NAME \ + --location=us-central1 --volume=vol1 + +POSITIONAL ARGUMENTS + Snapshot resource - The Snapshot 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 snapshot on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the volume attribute: + ◆ provide the argument snapshot on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + SNAPSHOT + ID of the snapshot or fully qualified identifier for the snapshot. + + To set the snapshot attribute: + ▸ provide the argument snapshot on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the snapshot. + + To set the location attribute: + ▸ provide the argument snapshot on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + Volume resource - The Volume to take a Snapshot of. 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp volumes snapshots describe + diff --git a/gcloud/beta/netapp/volumes/snapshots/help b/gcloud/beta/netapp/volumes/snapshots/help new file mode 100644 index 000000000..68b8791c4 --- /dev/null +++ b/gcloud/beta/netapp/volumes/snapshots/help @@ -0,0 +1,39 @@ +NAME + gcloud beta netapp volumes snapshots - create and manage Cloud NetApp + Volume Snapshots + +SYNOPSIS + gcloud beta netapp volumes snapshots COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create and manage Cloud NetApp Volume Snapshots. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a Cloud NetApp Volume Snapshot. + + delete + (BETA) Delete a Cloud NetApp Volume Snapshot. + + describe + (BETA) Describe a Cloud NetApp Volume Snapshot. + + list + (BETA) List Cloud NetApp Volume Snapshots. + + update + (BETA) Update a Cloud NetApp Volume Snapshot. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp volumes snapshots + diff --git a/gcloud/beta/netapp/volumes/snapshots/list b/gcloud/beta/netapp/volumes/snapshots/list new file mode 100644 index 000000000..23ef8d1f3 --- /dev/null +++ b/gcloud/beta/netapp/volumes/snapshots/list @@ -0,0 +1,111 @@ +NAME + gcloud beta netapp volumes snapshots list - list Cloud NetApp Volume + Snapshots + +SYNOPSIS + gcloud beta netapp volumes snapshots list [--location=LOCATION] + [--volume=VOLUME] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Lists Cloud NetApp Volume Snapshots + +EXAMPLES + The following command lists all Snapshots in the given location and volume + + $ gcloud beta netapp volumes snapshots list --location=us-central1 \ + --volume=vol1 + +FLAGS + Location resource - The location in which to list Volume Snapshots. 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 --location on the command line with a fully + specified name; + ◆ uses all locations by default. with a fully specified name; + ◆ set the property netapp/location with a fully specified name; + ◆ set the property netapp/region with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ uses all locations by default.; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + + Volume resource - The Volume to take a Snapshot of. 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume 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. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha netapp volumes snapshots list + diff --git a/gcloud/beta/netapp/volumes/snapshots/update b/gcloud/beta/netapp/volumes/snapshots/update new file mode 100644 index 000000000..692cc1c3f --- /dev/null +++ b/gcloud/beta/netapp/volumes/snapshots/update @@ -0,0 +1,133 @@ +NAME + gcloud beta netapp volumes snapshots update - update a Cloud NetApp Volume + Snapshot + +SYNOPSIS + gcloud beta netapp volumes snapshots update + (SNAPSHOT : --location=LOCATION) [--async] [--description=DESCRIPTION] + [--update-labels=[KEY=VALUE,...]] [--volume=VOLUME] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a Cloud NetApp Volume Snapshot and its specified parameters + +EXAMPLES + The following command updates a Snapshot named NAME and its specified + parameters + + $ gcloud beta netapp volumes snapshots update NAME \ + --location=us-central1 --description="new" \ + --update-labels=key2=val2 --volume=vol1 + +POSITIONAL ARGUMENTS + Snapshot resource - The Snapshot to update. 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 snapshot on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the volume attribute: + ◆ provide the argument snapshot on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + SNAPSHOT + ID of the snapshot or fully qualified identifier for the snapshot. + + To set the snapshot attribute: + ▸ provide the argument snapshot on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the snapshot. + + To set the location attribute: + ▸ provide the argument snapshot on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Snapshot + + --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. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + Volume resource - The Volume to take a Snapshot of. 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta netapp volumes snapshots update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta netapp volumes snapshots update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +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 netapp volumes snapshots update + diff --git a/gcloud/beta/netapp/volumes/update b/gcloud/beta/netapp/volumes/update new file mode 100644 index 000000000..f646b9f43 --- /dev/null +++ b/gcloud/beta/netapp/volumes/update @@ -0,0 +1,251 @@ +NAME + gcloud beta netapp volumes update - update a Cloud NetApp Volume + +SYNOPSIS + gcloud beta netapp volumes update (VOLUME : --location=LOCATION) [--async] + [--capacity=CAPACITY] [--description=DESCRIPTION] + [--enable-kerberos=ENABLE_KERBEROS] + [--export-policy=[access-type=ACCESS-TYPE], + [allowed-clients=ALLOWED-CLIENTS],[has-root-access=HAS-ROOT-ACCESS], + [kerberos-5-read-only=KERBEROS-5-READ-ONLY], + [kerberos-5-read-write=KERBEROS-5-READ-WRITE], + [kerberos-5i-read-only=KERBEROS-5I-READ-ONLY], + [kerberos-5i-read-write=KERBEROS-5I-READ-WRITE], + [kerberos-5p-read-only=KERBEROS-5P-READ-ONLY], + [kerberos-5p-read-write=KERBEROS-5P-READ-WRITE], + [nfsv3=NFSV3],[nfsv4=NFSV4]] [--protocols=PROTOCOL,[PROTOCOL,...]] + [--security-style=SECURITY_STYLE; default="SECURITY_STYLE_UNSPECIFIED"] + [--share-name=SHARE_NAME] + [--smb-settings=SMB_SETTING,[SMB_SETTING,...]] + [--snap-reserve=SNAP_RESERVE] + [--snapshot-daily=[hour=HOUR], + [minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] + [--snapshot-directory=SNAPSHOT_DIRECTORY; default="true"] + [--snapshot-hourly=[minute=MINUTE], + [snapshots-to-keep=SNAPSHOTS-TO-KEEP]] + [--snapshot-monthly=[day=DAY], + [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] + [--snapshot-weekly=[day=DAY], + [hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] + [--source-snapshot=SOURCE_SNAPSHOT] [--storage-pool=STORAGE_POOL] + [--unix-permissions=UNIX_PERMISSIONS] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a Cloud NetApp Volume and its specified parameters + +EXAMPLES + The following command updates a Volume named NAME and its specified + parameters + + $ gcloud beta netapp volumes update NAME --location=us-central1 \ + --capacity=4096 --description="new description" \ + --enable-kerberos=false --storage-pool=sp3 \ + --unix-permissions=0777 + +POSITIONAL ARGUMENTS + Volume resource - The Volume to update. 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 volume 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. + + VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument volume on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the volume. + + To set the location attribute: + ▸ provide the argument volume on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location; + ▸ set the property netapp/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --capacity=CAPACITY + The desired capacity of the Volume in GiB or TiB units.If no capacity + unit is specified, GiB is assumed. + + --description=DESCRIPTION + A description of the Cloud NetApp Volume + + --enable-kerberos=ENABLE_KERBEROS + Boolean flag indicating whether Volume is a kerberos Volume or not + + --export-policy=[access-type=ACCESS-TYPE],[allowed-clients=ALLOWED-CLIENTS],[has-root-access=HAS-ROOT-ACCESS],[kerberos-5-read-only=KERBEROS-5-READ-ONLY],[kerberos-5-read-write=KERBEROS-5-READ-WRITE],[kerberos-5i-read-only=KERBEROS-5I-READ-ONLY],[kerberos-5i-read-write=KERBEROS-5I-READ-WRITE],[kerberos-5p-read-only=KERBEROS-5P-READ-ONLY],[kerberos-5p-read-write=KERBEROS-5P-READ-WRITE],[nfsv3=NFSV3],[nfsv4=NFSV4] + Export Policy of a Cloud NetApp Files Volume. This will be a field + similar to network in which export policy fields can be specified as + such: --export-policy=allowed-clients=ALLOWED_CLIENTS_IP_ADDRESSES, + has-root-access=HAS_ROOT_ACCESS_BOOL,access=ACCESS_TYPE,nfsv3=NFSV3, + nfsv4=NFSV4,kerberos-5-read-only=KERBEROS_5_READ_ONLY, + kerberos-5-read-write=KERBEROS_5_READ_WRITE, + kerberos-5i-read-only=KERBEROS_5I_READ_ONLY, + kerberos-5i-read-write=KERBEROS_5I_READ_WRITE, + kerberos-5p-read-only=KERBEROS_5P_READ_ONLY, + kerberos-5p-read-write=KERBEROS_5P_READ_WRITE + + --protocols=PROTOCOL,[PROTOCOL,...] + Type of File System protocols for the Cloud NetApp Files VolumeValid + component values are: NFSV3, NFSV4, SMB + + For more information, look athttps://cloud.google.com/netapp/docs/reference/rest/v1alpha1/projects.locations.volumes#protocols. + + --security-style=SECURITY_STYLE; default="SECURITY_STYLE_UNSPECIFIED" + The security style of the Volume. This can either be UNIX or NTFS. + + SECURITY_STYLE must be one of: + + ntfs + NTFS security style for Volume. + unix + UNIX security style for Volume + + --share-name=SHARE_NAME + Share name of the Mount path clients will use. + + --smb-settings=SMB_SETTING,[SMB_SETTING,...] + List of settings specific to SMB protocolfor a Cloud NetApp Files + VolumeValid component values are: ENCRYPT_DATA, BROWSABLE, + CHANGE_NOTIFY, NON_BROWSABLE, OPLOCKS, SHOW_SNAPSHOT, + SHOW_PREVIOUS_VERSIONS, ACCESS_BASED_ENUMERATION, + CONTINUOUSLY_AVAILABLE + + For more information, look at https://cloud.google.com/netapp/docs/reference/rest/v1alpha1/projects.locations.volumes#smbsettings. + + --snap-reserve=SNAP_RESERVE + The percentage of volume storage reserved for snapshot storage. The + default value for this is 0 percent + + --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] + Make a snapshot every day e.g. at 06:00, 05:20, 23:50 + + --snapshot-directory=SNAPSHOT_DIRECTORY; default="true" + Snapshot Directory if enabled (true) makes the Volume contain a + read-only .snapshot directory which provides access to each of the + volume's snapshots + + --snapshot-hourly=[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] + Make a snapshot every hour e.g. at 04:00, 05:20, 06:00 + + --snapshot-monthly=[day=DAY],[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] + Make a snapshot once a month e.g. at 2nd 04:00, 7th 05:20, 24th 23:50 + + --snapshot-weekly=[day=DAY],[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] + Make a snapshot every week e.g. at Monday 04:00, Wednesday 05:20, + Sunday 23:50 + + Snapshot resource - The source Snapshot to create the Volume from. 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 --source-snapshot on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --source-snapshot on the command line with a + fully specified name; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + To set the volume attribute: + ◆ provide the argument --source-snapshot on the command line with a + fully specified name. + + --source-snapshot=SOURCE_SNAPSHOT + ID of the snapshot or fully qualified identifier for the snapshot. + + To set the snapshot attribute: + ▸ provide the argument --source-snapshot on the command line. + + Storage pool resource - The Storage Pool to associate with Volume. 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 --storage-pool on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + To set the location attribute: + ◆ provide the argument --storage-pool on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location; + ◆ set the property netapp/region. + + --storage-pool=STORAGE_POOL + ID of the storage_pool or fully qualified identifier for the + storage_pool. + + To set the storage_pool attribute: + ▸ provide the argument --storage-pool on the command line. + + --unix-permissions=UNIX_PERMISSIONS + Unix permissions the mount point will be created with.Unix permissions + are only applicable with NFS protocol only + + --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. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta netapp volumes update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta netapp volumes update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +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 netapp volumes update + diff --git a/gcloud/beta/pubsub/subscriptions/create b/gcloud/beta/pubsub/subscriptions/create index 5c2eb92fa..14dee7eaa 100644 --- a/gcloud/beta/pubsub/subscriptions/create +++ b/gcloud/beta/pubsub/subscriptions/create @@ -141,31 +141,33 @@ OPTIONAL FLAGS --message-retention-duration window. Acknowledged messages are not retained by default. - BigQuery Config Options. The Cloud Pub/Sub service account associated with - the enclosing subscription's parent project (i.e., - service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have - permission to write to this BigQuery table. + At most one of these can be specified: - --bigquery-table=BIGQUERY_TABLE - A BigQuery table of the form {project}:{dataset_name}.{table_name} to - which to write messages for this subscription. + BigQuery Config Options. The Cloud Pub/Sub service account associated + with the enclosing subscription's parent project (i.e., + service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must + have permission to write to this BigQuery table. - This flag argument must be specified if any of the other arguments in - this group are specified. + --bigquery-table=BIGQUERY_TABLE + A BigQuery table of the form {project}:{dataset_name}.{table_name} + to which to write messages for this subscription. - --drop-unknown-fields - When --use-topic-schema is set, whether or not to ignore fields in - the topic schema that do not appear in the BigQuery schema. If false, - then the BigQuery schema must contain all fields that are also - present in the topic schema. + This flag argument must be specified if any of the other arguments + in this group are specified. - --use-topic-schema - Whether or not to use the schema for the subscription's topic (if it - exists) when writing messages to BigQuery. + --drop-unknown-fields + When --use-topic-schema is set, whether or not to ignore fields in + the topic schema that do not appear in the BigQuery schema. If + false, then the BigQuery schema must contain all fields that are + also present in the topic schema. - --write-metadata - Whether or not to write message metadata including message ID, - publish timestamp, ordering key, and attributes to BigQuery. + --use-topic-schema + Whether or not to use the schema for the subscription's topic (if + it exists) when writing messages to BigQuery. + + --write-metadata + Whether or not to write message metadata including message ID, + publish timestamp, ordering key, and attributes to BigQuery. Dead Letter Queue Options. The Cloud Pub/Sub service account associated with the enclosing subscription's parent project (i.e., diff --git a/gcloud/beta/pubsub/subscriptions/update b/gcloud/beta/pubsub/subscriptions/update index 8aa626622..8e3fe2005 100644 --- a/gcloud/beta/pubsub/subscriptions/update +++ b/gcloud/beta/pubsub/subscriptions/update @@ -106,34 +106,37 @@ FLAGS At most one of these can be specified: - --clear-bigquery-config - If set, clear the BigQuery config from the subscription. + At most one of these can be specified: - BigQuery Config Options. The Cloud Pub/Sub service account associated - with the enclosing subscription's parent project (i.e., - service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must - have permission to write to this BigQuery table. + --clear-bigquery-config + If set, clear the BigQuery config from the subscription. - --bigquery-table=BIGQUERY_TABLE - A BigQuery table of the form {project}:{dataset_name}.{table_name} - to which to write messages for this subscription. + BigQuery Config Options. The Cloud Pub/Sub service account associated + with the enclosing subscription's parent project (i.e., + service-{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must + have permission to write to this BigQuery table. - This flag argument must be specified if any of the other arguments - in this group are specified. + --bigquery-table=BIGQUERY_TABLE + A BigQuery table of the form + {project}:{dataset_name}.{table_name} to which to write messages + for this subscription. - --drop-unknown-fields - When --use-topic-schema is set, whether or not to ignore fields in - the topic schema that do not appear in the BigQuery schema. If - false, then the BigQuery schema must contain all fields that are - also present in the topic schema. + This flag argument must be specified if any of the other + arguments in this group are specified. - --use-topic-schema - Whether or not to use the schema for the subscription's topic (if - it exists) when writing messages to BigQuery. + --drop-unknown-fields + When --use-topic-schema is set, whether or not to ignore fields + in the topic schema that do not appear in the BigQuery schema. If + false, then the BigQuery schema must contain all fields that are + also present in the topic schema. - --write-metadata - Whether or not to write message metadata including message ID, - publish timestamp, ordering key, and attributes to BigQuery. + --use-topic-schema + Whether or not to use the schema for the subscription's topic (if + it exists) when writing messages to BigQuery. + + --write-metadata + Whether or not to write message metadata including message ID, + publish timestamp, ordering key, and attributes to BigQuery. At most one of these can be specified: diff --git a/gcloud/beta/run/services/proxy b/gcloud/beta/run/services/proxy index a82a35ce9..e0badddb9 100644 --- a/gcloud/beta/run/services/proxy +++ b/gcloud/beta/run/services/proxy @@ -159,8 +159,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud run services proxy $ gcloud alpha run services proxy diff --git a/gcloud/beta/sql/instances/create b/gcloud/beta/sql/instances/create index d1f1a1377..7ee59486e 100644 --- a/gcloud/beta/sql/instances/create +++ b/gcloud/beta/sql/instances/create @@ -99,10 +99,10 @@ FLAGS --activation-policy=ACTIVATION_POLICY Activation policy for this instance. This specifies when the instance should be activated and is applicable only when the instance state is - RUNNABLE. The default is on-demand. More information on activation + RUNNABLE. The default is always. More information on activation policies can be found here: https://cloud.google.com/sql/docs/mysql/start-stop-restart-instance#activation_policy. - ACTIVATION_POLICY must be one of: always, never, on-demand. + ACTIVATION_POLICY must be one of: always, never. --active-directory-domain=ACTIVE_DIRECTORY_DOMAIN Managed Service for Microsoft Active Directory domain this instance is diff --git a/gcloud/beta/sql/instances/patch b/gcloud/beta/sql/instances/patch index 7b409423b..ebce4801c 100644 --- a/gcloud/beta/sql/instances/patch +++ b/gcloud/beta/sql/instances/patch @@ -63,10 +63,10 @@ FLAGS --activation-policy=ACTIVATION_POLICY Activation policy for this instance. This specifies when the instance should be activated and is applicable only when the instance state is - RUNNABLE. The default is on-demand. More information on activation + RUNNABLE. The default is always. More information on activation policies can be found here: https://cloud.google.com/sql/docs/mysql/start-stop-restart-instance#activation_policy. - ACTIVATION_POLICY must be one of: always, never, on-demand. + ACTIVATION_POLICY must be one of: always, never. --active-directory-domain=ACTIVE_DIRECTORY_DOMAIN Managed Service for Microsoft Active Directory domain this instance is diff --git a/gcloud/compute/instances/create b/gcloud/compute/instances/create index 58eda4dc1..0b3a55ca6 100644 --- a/gcloud/compute/instances/create +++ b/gcloud/compute/instances/create @@ -12,8 +12,8 @@ SYNOPSIS [--can-ip-forward] [--confidential-compute] [--create-disk=[PROPERTY=VALUE,...]] [--csek-key-file=FILE] [--deletion-protection] [--description=DESCRIPTION] - [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT], - [device-name=DEVICE-NAME],[mode=MODE],[name=NAME],[scope=SCOPE]] + [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME], + [force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]] [--enable-display-device] [--[no-]enable-nested-virtualization] [--[no-]enable-uefi-networking] [--erase-windows-vss-signature] [--external-ipv6-address=EXTERNAL_IPV6_ADDRESS] @@ -357,7 +357,7 @@ FLAGS --description=DESCRIPTION Specifies a textual description of the instances. - --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME],[scope=SCOPE] + --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE] Attaches persistent disks to the instances. The disks specified must already exist. @@ -394,6 +394,10 @@ FLAGS zonal disk in the same zone as the instance (default). If regional, the disk is interpreted as a regional disk in the same region as the instance. The default value for this is zonal. + force-attach + If yes, this persistent disk will force-attached to the instance + even it is already attached to another instance. The default value + is 'no'. --enable-display-device Enable a display device on VM instances. Disabled by default. diff --git a/gcloud/compute/instances/create-with-container b/gcloud/compute/instances/create-with-container index a9ea52d57..b380bcd98 100644 --- a/gcloud/compute/instances/create-with-container +++ b/gcloud/compute/instances/create-with-container @@ -23,8 +23,8 @@ SYNOPSIS [--container-restart-policy=POLICY; default="always"] [--container-stdin] [--container-tty] [--create-disk=[PROPERTY=VALUE,...]] [--description=DESCRIPTION] - [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT], - [device-name=DEVICE-NAME],[mode=MODE],[name=NAME],[scope=SCOPE]] + [--disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME], + [force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE]] [--[no-]enable-nested-virtualization] [--external-ipv6-address=EXTERNAL_IPV6_ADDRESS] [--external-ipv6-prefix-length=EXTERNAL_IPV6_PREFIX_LENGTH] @@ -354,7 +354,7 @@ FLAGS --description=DESCRIPTION Specifies a textual description of the instances. - --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[mode=MODE],[name=NAME],[scope=SCOPE] + --disk=[auto-delete=AUTO-DELETE],[boot=BOOT],[device-name=DEVICE-NAME],[force-attach=FORCE-ATTACH],[mode=MODE],[name=NAME],[scope=SCOPE] Attaches persistent disks to the instances. The disks specified must already exist. @@ -395,6 +395,10 @@ FLAGS zonal disk in the same zone as the instance (default). If regional, the disk is interpreted as a regional disk in the same region as the instance. The default value for this is zonal. + force-attach + If yes, this persistent disk will force-attached to the instance + even it is already attached to another instance. The default value + is 'no'. --[no-]enable-nested-virtualization If set to true, enables nested virtualization for the instance. Use diff --git a/gcloud/container/aws/clusters/create b/gcloud/container/aws/clusters/create index b5a7c8df7..4019fc158 100644 --- a/gcloud/container/aws/clusters/create +++ b/gcloud/container/aws/clusters/create @@ -13,16 +13,19 @@ SYNOPSIS --subnet-ids=[SUBNET_ID,...] --vpc-id=VPC_ID [--admin-users=USER,[USER,...]] [--annotations=ANNOTATION,[ANNOTATION,...]] [--async] - [--description=DESCRIPTION] [--enable-managed-prometheus] - [--instance-type=INSTANCE_TYPE] [--logging=COMPONENT,[COMPONENT,...]] + [--description=DESCRIPTION] [--disable-per-node-pool-sg-rules] + [--enable-managed-prometheus] [--instance-type=INSTANCE_TYPE] + [--logging=COMPONENT,[COMPONENT,...]] [--main-volume-iops=MAIN_VOLUME_IOPS] [--main-volume-kms-key-arn=MAIN_VOLUME_KMS_KEY_ARN] [--main-volume-size=MAIN_VOLUME_SIZE] + [--main-volume-throughput=MAIN_VOLUME_THROUGHPUT] [--main-volume-type=MAIN_VOLUME_TYPE] [--role-session-name=ROLE_SESSION_NAME] [--root-volume-iops=ROOT_VOLUME_IOPS] [--root-volume-kms-key-arn=ROOT_VOLUME_KMS_KEY_ARN] [--root-volume-size=ROOT_VOLUME_SIZE] + [--root-volume-throughput=ROOT_VOLUME_THROUGHPUT] [--root-volume-type=ROOT_VOLUME_TYPE] [--security-group-ids=[SECURITY_GROUP_ID,...]] [--ssh-ec2-key-pair=SSH_EC2_KEY_PAIR] [--tags=TAG,[TAG,...]] @@ -131,6 +134,12 @@ OPTIONAL FLAGS --description=DESCRIPTION Description for the cluster. + --disable-per-node-pool-sg-rules + Disable the default per node pool subnet security group rules on the + control plane security group. When disabled, at least one security + group that allows node pools to send traffic to the control plane on + ports TCP/443 and TCP/8132 must be provided. + --enable-managed-prometheus Enable managed collection for Managed Service for Prometheus. @@ -160,6 +169,10 @@ OPTIONAL FLAGS size unit of GB for gigabyte, or TB for terabyte. If no size unit is specified, GB is assumed. + --main-volume-throughput=MAIN_VOLUME_THROUGHPUT + Throughput to provision for the main volume, in MiB/s. Only valid if + the volume type is GP3. + --main-volume-type=MAIN_VOLUME_TYPE Type of the main volume. MAIN_VOLUME_TYPE must be one of: gp2, gp3. @@ -179,6 +192,10 @@ OPTIONAL FLAGS size unit of GB for gigabyte, or TB for terabyte. If no size unit is specified, GB is assumed. + --root-volume-throughput=ROOT_VOLUME_THROUGHPUT + Throughput to provision for the root volume, in MiB/s. Only valid if + the volume type is GP3. + --root-volume-type=ROOT_VOLUME_TYPE Type of the root volume. ROOT_VOLUME_TYPE must be one of: gp2, gp3. diff --git a/gcloud/container/aws/clusters/update b/gcloud/container/aws/clusters/update index 0922231bb..314b52405 100644 --- a/gcloud/container/aws/clusters/update +++ b/gcloud/container/aws/clusters/update @@ -12,6 +12,7 @@ SYNOPSIS [--root-volume-iops=ROOT_VOLUME_IOPS] [--root-volume-kms-key-arn=ROOT_VOLUME_KMS_KEY_ARN] [--root-volume-size=ROOT_VOLUME_SIZE] + [--root-volume-throughput=ROOT_VOLUME_THROUGHPUT] [--root-volume-type=ROOT_VOLUME_TYPE] [--validate-only] [--annotations=ANNOTATION,[ANNOTATION,...] | --clear-annotations] [--clear-description | --description=DESCRIPTION] @@ -22,6 +23,7 @@ SYNOPSIS [--clear-ssh-ec2-key-pair | --ssh-ec2-key-pair=SSH_EC2_KEY_PAIR] [--clear-tags | --tags=TAG,[TAG,...]] [--disable-managed-prometheus | --enable-managed-prometheus] + [--disable-per-node-pool-sg-rules | --enable-per-node-pool-sg-rules] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -114,6 +116,10 @@ FLAGS size unit of GB for gigabyte, or TB for terabyte. If no size unit is specified, GB is assumed. + --root-volume-throughput=ROOT_VOLUME_THROUGHPUT + Throughput to provision for the root volume, in MiB/s. Only valid if + the volume type is GP3. + --root-volume-type=ROOT_VOLUME_TYPE Type of the root volume. ROOT_VOLUME_TYPE must be one of: gp2, gp3. @@ -205,6 +211,20 @@ FLAGS --enable-managed-prometheus Enable managed collection for Managed Service for Prometheus. + Default per node pool security group rules + + At most one of these can be specified: + + --disable-per-node-pool-sg-rules + Disable the default per node pool subnet security group rules on the + control plane security group. When disabled, at least one security + group that allows node pools to send traffic to the control plane on + ports TCP/443 and TCP/8132 must be provided. + + --enable-per-node-pool-sg-rules + Enable the default per node pool subnet security group rules on the + control plane security group. + 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/container/aws/node-pools/create b/gcloud/container/aws/node-pools/create index 91b08902e..a15744379 100644 --- a/gcloud/container/aws/node-pools/create +++ b/gcloud/container/aws/node-pools/create @@ -16,6 +16,7 @@ SYNOPSIS [--root-volume-iops=ROOT_VOLUME_IOPS] [--root-volume-kms-key-arn=ROOT_VOLUME_KMS_KEY_ARN] [--root-volume-size=ROOT_VOLUME_SIZE] + [--root-volume-throughput=ROOT_VOLUME_THROUGHPUT] [--root-volume-type=ROOT_VOLUME_TYPE] [--security-group-ids=[SECURITY_GROUP_ID,...]] [--ssh-ec2-key-pair=SSH_EC2_KEY_PAIR] [--tags=TAG,[TAG,...]] @@ -143,6 +144,10 @@ OPTIONAL FLAGS size unit of GB for gigabyte, or TB for terabyte. If no size unit is specified, GB is assumed. + --root-volume-throughput=ROOT_VOLUME_THROUGHPUT + Throughput to provision for the root volume, in MiB/s. Only valid if + the volume type is GP3. + --root-volume-type=ROOT_VOLUME_TYPE Type of the root volume. ROOT_VOLUME_TYPE must be one of: gp2, gp3. diff --git a/gcloud/container/aws/node-pools/update b/gcloud/container/aws/node-pools/update index ded8a5157..d64a55640 100644 --- a/gcloud/container/aws/node-pools/update +++ b/gcloud/container/aws/node-pools/update @@ -10,6 +10,7 @@ SYNOPSIS [--node-version=NODE_VERSION] [--root-volume-iops=ROOT_VOLUME_IOPS] [--root-volume-kms-key-arn=ROOT_VOLUME_KMS_KEY_ARN] [--root-volume-size=ROOT_VOLUME_SIZE] + [--root-volume-throughput=ROOT_VOLUME_THROUGHPUT] [--root-volume-type=ROOT_VOLUME_TYPE] [--validate-only] [--annotations=ANNOTATION,[ANNOTATION,...] | --clear-annotations] [--clear-autoscaling-metrics @@ -100,6 +101,10 @@ FLAGS size unit of GB for gigabyte, or TB for terabyte. If no size unit is specified, GB is assumed. + --root-volume-throughput=ROOT_VOLUME_THROUGHPUT + Throughput to provision for the root volume, in MiB/s. Only valid if + the volume type is GP3. + --root-volume-type=ROOT_VOLUME_TYPE Type of the root volume. ROOT_VOLUME_TYPE must be one of: gp2, gp3. diff --git a/gcloud/container/clusters/check-autopilot-compatibility b/gcloud/container/clusters/check-autopilot-compatibility new file mode 100644 index 000000000..0c0d16814 --- /dev/null +++ b/gcloud/container/clusters/check-autopilot-compatibility @@ -0,0 +1,84 @@ +NAME + gcloud container clusters check-autopilot-compatibility - check autopilot + compatibility of a running cluster + +SYNOPSIS + gcloud container clusters check-autopilot-compatibility NAME + [--location=LOCATION | --region=REGION | --zone=ZONE, -z ZONE] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Check autopilot compatibility of a running cluster. + +EXAMPLES + To check autopilot compatibility of an existing cluster, run: + + $ gcloud container clusters check-autopilot-compatibility \ + sample-cluster + +POSITIONAL ARGUMENTS + NAME + The name of this cluster. + +FLAGS + At most one of these can be specified: + + --location=LOCATION + Compute zone or region (e.g. us-central1-a or us-central1) for the + cluster. + + --region=REGION + Compute region (e.g. us-central1) for the cluster. + + --zone=ZONE, -z ZONE + Compute zone (e.g. us-central1-a) for the cluster. Overrides the + default compute/zone property value for this command invocation. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha container clusters check-autopilot-compatibility + + $ gcloud beta container clusters check-autopilot-compatibility + diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index d780a98d8..c6909e381 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -563,7 +563,7 @@ FLAGS Set the components that have logging enabled. Valid component values are: SYSTEM, WORKLOAD, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, NONE - For more information, look at + For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-logs Examples: @@ -702,10 +702,10 @@ FLAGS --monitoring=[COMPONENT,...] Set the components that have monitoring enabled. Valid component values - are: SYSTEM, WORKLOAD (Deprecated), NONE,API_SERVER, + are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER - For more information, look at + For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics Examples: @@ -1055,8 +1055,8 @@ FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. - BINAUTHZ_EVALUATION_MODE must be one of: BOUND_POLICIES, - BOUND_POLICIES_AND_PROJECT_SINGLETON_POLICY_ENFORCE, DISABLED, + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS, + POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE, PROJECT_SINGLETON_POLICY_ENFORCE. --enable-binauthz diff --git a/gcloud/container/clusters/create-auto b/gcloud/container/clusters/create-auto index 6667f56e4..287da5489 100644 --- a/gcloud/container/clusters/create-auto +++ b/gcloud/container/clusters/create-auto @@ -14,7 +14,8 @@ SYNOPSIS [--database-encryption-key=DATABASE_ENCRYPTION_KEY] [--enable-google-cloud-access] [--enable-kubernetes-unstable-apis=API,[API,...]] - [--enable-master-global-access] [--network=NETWORK] + [--enable-master-global-access] [--logging=[COMPONENT,...]] + [--monitoring=[COMPONENT,...]] [--network=NETWORK] [--private-endpoint-subnetwork=NAME] [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] @@ -68,8 +69,8 @@ FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. - BINAUTHZ_EVALUATION_MODE must be one of: BOUND_POLICIES, - BOUND_POLICIES_AND_PROJECT_SINGLETON_POLICY_ENFORCE, DISABLED, + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, POLICY_BINDINGS, + POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE, PROJECT_SINGLETON_POLICY_ENFORCE. --boot-disk-kms-key=BOOT_DISK_KMS_KEY @@ -176,6 +177,34 @@ FLAGS Must be used in conjunction with '--enable-ip-alias' and '--enable-private-nodes'. + --logging=[COMPONENT,...] + Set the components that have logging enabled. Valid component values + are: SYSTEM, WORKLOAD, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, NONE + + For more information, see + https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-logs + + Examples: + + $ gcloud container clusters create-auto --logging=SYSTEM + $ gcloud container clusters create-auto \ + --logging=SYSTEM,API_SERVER,WORKLOAD + $ gcloud container clusters create-auto --logging=NONE + + --monitoring=[COMPONENT,...] + Set the components that have monitoring enabled. Valid component values + are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, + CONTROLLER_MANAGER, SCHEDULER + + For more information, see + https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics + + Examples: + + $ gcloud container clusters create-auto \ + --monitoring=SYSTEM,API_SERVER + $ gcloud container clusters create-auto --monitoring=NONE + --network=NETWORK The Compute Engine Network that the cluster will connect to. Google Kubernetes Engine will use this network when creating routes and diff --git a/gcloud/container/clusters/help b/gcloud/container/clusters/help index 5293001ce..0f4f3e049 100644 --- a/gcloud/container/clusters/help +++ b/gcloud/container/clusters/help @@ -36,6 +36,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + check-autopilot-compatibility + Check autopilot compatibility of a running cluster. + create Create a cluster for running containers. diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index f793dfc2a..52d074fc8 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -551,8 +551,9 @@ REQUIRED FLAGS --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE Enable Binary Authorization for this cluster. - BINAUTHZ_EVALUATION_MODE must be one of: BOUND_POLICIES, - BOUND_POLICIES_AND_PROJECT_SINGLETON_POLICY_ENFORCE, DISABLED, + BINAUTHZ_EVALUATION_MODE must be one of: DISABLED, + POLICY_BINDINGS, + POLICY_BINDINGS_AND_PROJECT_SINGLETON_POLICY_ENFORCE, PROJECT_SINGLETON_POLICY_ENFORCE. --enable-binauthz @@ -960,7 +961,7 @@ REQUIRED FLAGS are: SYSTEM, WORKLOAD, API_SERVER, CONTROLLER_MANAGER, SCHEDULER, NONE - For more information, look at + For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-logs Examples: @@ -972,10 +973,10 @@ REQUIRED FLAGS --monitoring=[COMPONENT,...] Set the components that have monitoring enabled. Valid component - values are: SYSTEM, WORKLOAD (Deprecated), NONE,API_SERVER, + values are: SYSTEM, WORKLOAD (Deprecated), NONE, API_SERVER, CONTROLLER_MANAGER, SCHEDULER - For more information, look at + For more information, see https://cloud.google.com/stackdriver/docs/solutions/gke/installing#available-metrics Examples: diff --git a/gcloud/dataflow/jobs/cancel b/gcloud/dataflow/jobs/cancel index 68e05d48d..88a154715 100644 --- a/gcloud/dataflow/jobs/cancel +++ b/gcloud/dataflow/jobs/cancel @@ -11,7 +11,7 @@ DESCRIPTION POSITIONAL ARGUMENTS JOB_ID [JOB_ID ...] - The job IDs to operate on. + Job IDs to operate on. FLAGS --force @@ -20,8 +20,7 @@ FLAGS ago for a job to be force cancelled. --region=REGION_ID - The region ID of the jobs' regional endpoint. Defaults to - 'us-central1'. + Region ID of the jobs' regional endpoint. Defaults to 'us-central1'. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/dataflow/jobs/describe b/gcloud/dataflow/jobs/describe index ec55f9f38..ce49d6152 100644 --- a/gcloud/dataflow/jobs/describe +++ b/gcloud/dataflow/jobs/describe @@ -23,15 +23,14 @@ DESCRIPTION POSITIONAL ARGUMENTS JOB_ID - The job ID to operate on. + Job ID to operate on. FLAGS --full Retrieve the full Job rather than the summary view --region=REGION_ID - The region ID of the job's regional endpoint. Defaults to - 'us-central1'. + Region ID of the job's regional endpoint. Defaults to 'us-central1'. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/dataflow/jobs/drain b/gcloud/dataflow/jobs/drain index 39819f460..788fa5789 100644 --- a/gcloud/dataflow/jobs/drain +++ b/gcloud/dataflow/jobs/drain @@ -14,12 +14,11 @@ DESCRIPTION POSITIONAL ARGUMENTS JOB_ID [JOB_ID ...] - The job IDs to operate on. + Job IDs to operate on. FLAGS --region=REGION_ID - The region ID of the jobs' regional endpoint. Defaults to - 'us-central1'. + Region ID of the jobs' regional endpoint. Defaults to 'us-central1'. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/dataflow/jobs/run b/gcloud/dataflow/jobs/run index c3e374494..6ca768265 100644 --- a/gcloud/dataflow/jobs/run +++ b/gcloud/dataflow/jobs/run @@ -58,8 +58,7 @@ OPTIONAL FLAGS The parameters to pass to the job. --region=REGION_ID - The region ID of the job's regional endpoint. Defaults to - 'us-central1'. + Region ID of the job's regional endpoint. Defaults to 'us-central1'. --service-account-email=SERVICE_ACCOUNT_EMAIL The service account to run the workers as. diff --git a/gcloud/dataflow/jobs/show b/gcloud/dataflow/jobs/show index 288553f2b..2ae0a308d 100644 --- a/gcloud/dataflow/jobs/show +++ b/gcloud/dataflow/jobs/show @@ -10,15 +10,14 @@ DESCRIPTION POSITIONAL ARGUMENTS JOB_ID - The job ID to operate on. + Job ID to operate on. FLAGS --environment If present, the environment will be listed. --region=REGION_ID - The region ID of the job's regional endpoint. Defaults to - 'us-central1'. + Region ID of the job's regional endpoint. Defaults to 'us-central1'. --steps If present, the steps will be listed. diff --git a/gcloud/dataflow/sql/query b/gcloud/dataflow/sql/query index a87c59bb1..a37af0bc3 100644 --- a/gcloud/dataflow/sql/query +++ b/gcloud/dataflow/sql/query @@ -72,8 +72,7 @@ REQUIRED FLAGS The unique name to assign to the Cloud Dataflow job. --region=REGION - The region ID of the job's regional endpoint. Defaults to - 'us-central1'. + Region ID of the job's regional endpoint. Defaults to 'us-central1'. The destination(s) for the output of the query. diff --git a/gcloud/filestore/backups/create b/gcloud/filestore/backups/create index 50fda6725..a93511c43 100644 --- a/gcloud/filestore/backups/create +++ b/gcloud/filestore/backups/create @@ -3,9 +3,10 @@ NAME SYNOPSIS gcloud filestore backups create BACKUP --file-share=FILE_SHARE - --instance=INSTANCE --instance-zone=INSTANCE_ZONE --region=REGION - [--async] [--description=DESCRIPTION] [--labels=KEY=VALUE] - [GCLOUD_WIDE_FLAG ...] + --instance=INSTANCE --region=REGION + (--instance-location=INSTANCE_LOCATION | --instance-zone=INSTANCE_ZONE) + [--async] [--description=DESCRIPTION] [--kms-key=KMS_KEY] + [--labels=KEY=VALUE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a Filestore backup of an instance file share. @@ -36,12 +37,17 @@ REQUIRED FLAGS --instance=INSTANCE Share name of the Filestore instance you want to backup. - --instance-zone=INSTANCE_ZONE - Zone of the Filestore instance. - --region=REGION Region (e.g. us-central1) for the backup. + Exactly one of these must be specified: + + --instance-location=INSTANCE_LOCATION + Region of the Filestore instance. + + --instance-zone=INSTANCE_ZONE + Zone of the Filestore instance. + OPTIONAL FLAGS --async Return immediately, without waiting for the operation in progress to @@ -50,6 +56,10 @@ OPTIONAL FLAGS --description=DESCRIPTION Description for the backup. Limit: 2048 characters. + --kms-key=KMS_KEY + CMEK for backup in the form of + projects/{project}/locations/{location}/keyRings/{key-ring}/cryptoKeys/{crypto-key} + --labels=KEY=VALUE List of label KEY=VALUE pairs to add. diff --git a/gcloud/firestore/databases/describe b/gcloud/firestore/databases/describe index 8ff5f620d..2b69cae95 100644 --- a/gcloud/firestore/databases/describe +++ b/gcloud/firestore/databases/describe @@ -1,38 +1,31 @@ NAME - gcloud firestore databases describe - describe a Google Cloud Firestore - database + gcloud firestore databases describe - describes information about a Cloud + Firestore database SYNOPSIS - gcloud firestore databases describe [--database=DATABASE] - [GCLOUD_WIDE_FLAG ...] + gcloud firestore databases describe + [--database=DATABASE; default="(default)"] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Describe a Google Cloud Firestore database. + The following command describes a Google Cloud Firestore database. EXAMPLES - The following command describes a Google Cloud Firestore database. + To describe a Firestore database with a databaseId testdb. + + $ gcloud firestore databases describe --database=testdb + + If databaseId is not specified, the command will describe information about + the (default) database. $ gcloud firestore databases describe FLAGS - Database resource - The Google Cloud Firestore database to describe. This - represents a Cloud resource. (NOTE) Some attributes are not given - arguments in this group but can be set in other ways. + --database=DATABASE; default="(default)" + The database to operate on. The default value is (default). - To set the project attribute: - ◆ provide the argument --database on the command line with a fully - specified name; - ◆ the default value of argument [--database] is (default) with a fully - specified name; - ◆ set the property core/project; - ◆ provide the argument --project on the command line. + For example, to operate on database foo: - --database=DATABASE - ID of the database or fully qualified identifier for the database. - - To set the database attribute: - ▸ provide the argument --database on the command line; - ▸ the default value of argument [--database] is (default). + $ gcloud firestore databases describe --database='foo' GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, @@ -42,10 +35,6 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. -API REFERENCE - This command uses the firestore/v1 API. The full documentation for this API - can be found at: https://cloud.google.com/firestore - NOTES These variants are also available: diff --git a/gcloud/firestore/databases/help b/gcloud/firestore/databases/help index a06b465a1..63446b667 100644 --- a/gcloud/firestore/databases/help +++ b/gcloud/firestore/databases/help @@ -20,7 +20,7 @@ COMMANDS Create a Google Cloud Firestore database via Firestore API. describe - Describe a Google Cloud Firestore database. + Describes information about a Cloud Firestore database. list Lists all Firestore databases under the project. diff --git a/gcloud/functions/deploy b/gcloud/functions/deploy index 4b308b55b..6f3bf86bc 100644 --- a/gcloud/functions/deploy +++ b/gcloud/functions/deploy @@ -117,11 +117,8 @@ FLAGS --entry-point=ENTRY_POINT Name of a Google Cloud Function (as defined in source code) that will - be executed. Defaults to the resource name suffix, if not specified. - For backward compatibility, if function with given name is not found, - then the system will try to use function named "function". For Node.js - this is name of a function exported by the module specified in - source_location. + be executed. Defaults to the resource name suffix (ID of the function), + if not specified. --gen2 If enabled, this command will use Cloud Functions (Second generation). diff --git a/gcloud/iam/workload-identity-pools/providers/create-oidc b/gcloud/iam/workload-identity-pools/providers/create-oidc index feba0ae9e..50a5321f7 100644 --- a/gcloud/iam/workload-identity-pools/providers/create-oidc +++ b/gcloud/iam/workload-identity-pools/providers/create-oidc @@ -9,7 +9,8 @@ SYNOPSIS --attribute-mapping=[ATTRIBUTE_MAPPING,...] --issuer-uri=ISSUER_URI [--allowed-audiences=[ALLOWED_AUDIENCES,...]] [--attribute-condition=ATTRIBUTE_CONDITION] [--description=DESCRIPTION] - [--disabled] [--display-name=DISPLAY_NAME] [GCLOUD_WIDE_FLAG ...] + [--disabled] [--display-name=DISPLAY_NAME] + [--jwk-json-path=JWK_JSON_PATH] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a new OIDC workload identity pool provider. @@ -28,7 +29,7 @@ EXAMPLES --attribute-condition="true" \ --issuer-uri="https://test-idp.com" \ --allowed-audiences=https://test-audience-1.com,https://\ - test-audience-2.com + test-audience-2.com --jwk-json-path="path/to/jwk.json" POSITIONAL ARGUMENTS Workload identity pool provider resource - The workload identity pool @@ -205,6 +206,25 @@ OPTIONAL FLAGS --display-name=DISPLAY_NAME A display name for the provider. Cannot exceed 32 characters. + --jwk-json-path=JWK_JSON_PATH + Optional file containing jwk public keys. The file format must follow + jwk specifications (https://www.rfc-editor.org/rfc/rfc7517#section-4). + Example file format: { + "keys": [ + { + "kty": "RSA/EC", + "alg": "", + "use": "sig", + "kid": "", + "n": "", + "e": "" + "x": "" + "y": "" + "crv": "" + } + ] + } + 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/iam/workload-identity-pools/providers/update-oidc b/gcloud/iam/workload-identity-pools/providers/update-oidc index 90b3b5134..ef703e1b3 100644 --- a/gcloud/iam/workload-identity-pools/providers/update-oidc +++ b/gcloud/iam/workload-identity-pools/providers/update-oidc @@ -10,7 +10,8 @@ SYNOPSIS [--attribute-condition=ATTRIBUTE_CONDITION] [--attribute-mapping=[ATTRIBUTE_MAPPING,...]] [--description=DESCRIPTION] [--disabled] [--display-name=DISPLAY_NAME] - [--issuer-uri=ISSUER_URI] [GCLOUD_WIDE_FLAG ...] + [--issuer-uri=ISSUER_URI] [--jwk-json-path=JWK_JSON_PATH] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update an OIDC workload identity pool provider. @@ -29,7 +30,7 @@ EXAMPLES --attribute-condition="true" \ --issuer-uri="https://test-idp.com" \ --allowed-audiences=https://test-audience-1.com,https://\ - test-audience-2.com + test-audience-2.com --jwk-json-path="path/to/jwk.json" POSITIONAL ARGUMENTS Workload identity pool provider resource - The workload identity pool @@ -205,6 +206,25 @@ FLAGS --issuer-uri=ISSUER_URI The OIDC issuer URL. + --jwk-json-path=JWK_JSON_PATH + Optional file containing jwk public keys. The file format must follow + jwk specifications (https://www.rfc-editor.org/rfc/rfc7517#section-4). + Example file format: { + "keys": [ + { + "kty": "RSA/EC", + "alg": "", + "use": "sig", + "kid": "", + "n": "", + "e": "" + "x": "" + "y": "" + "crv": "" + } + ] + } + 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/logging/sinks/create b/gcloud/logging/sinks/create index 6dd0e46e2..36a7d033c 100644 --- a/gcloud/logging/sinks/create +++ b/gcloud/logging/sinks/create @@ -63,6 +63,11 @@ EXAMPLES logging.googleapis.com/projects/my-central-project/locations/\ global/buckets/my-central-bucket + To route all logs to another project, run: + + $ gcloud logging sinks create my-sink \ + logging.googleapis.com/projects/my-destination-project + POSITIONAL ARGUMENTS SINK_NAME The name for the sink. diff --git a/gcloud/metastore/services/create b/gcloud/metastore/services/create index e139d6801..8022949e6 100644 --- a/gcloud/metastore/services/create +++ b/gcloud/metastore/services/create @@ -5,6 +5,7 @@ SYNOPSIS gcloud metastore services create (SERVICE : --location=LOCATION) [--async] [--database-type=DATABASE_TYPE; default="mysql"] [--encryption-kms-key=ENCRYPTION_KMS_KEY] + [--endpoint-protocol=ENDPOINT_PROTOCOL; default="thrift"] [--hive-metastore-version=HIVE_METASTORE_VERSION] [--labels=[KEY=VALUE,...]] [--port=PORT; default=9083] [--release-channel=RELEASE_CHANNEL; default="stable"] @@ -102,6 +103,16 @@ FLAGS URL, or a relative name in the form projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{crypto_key_id}. + --endpoint-protocol=ENDPOINT_PROTOCOL; default="thrift" + The protocol to use for the metastore service endpoint. If unspecified, + defaults to THRIFT. ENDPOINT_PROTOCOL must be one of: + + grpc + The modernized GRPC protocol. + + thrift + The legacy Apache THRIFT protocol. + --hive-metastore-version=HIVE_METASTORE_VERSION The Hive metastore schema version. The supported versions of a location are listed via: diff --git a/gcloud/run/services/help b/gcloud/run/services/help index ba59ee333..5cf489fcc 100644 --- a/gcloud/run/services/help +++ b/gcloud/run/services/help @@ -122,6 +122,10 @@ COMMANDS list List available services. + proxy + Proxy a service to localhost authenticating as the active account or + with the specified token. + remove-iam-policy-binding Remove IAM policy binding of a Cloud Run service. diff --git a/gcloud/run/services/proxy b/gcloud/run/services/proxy new file mode 100644 index 000000000..feb3b23dc --- /dev/null +++ b/gcloud/run/services/proxy @@ -0,0 +1,167 @@ +NAME + gcloud run services proxy - proxy a service to localhost authenticating as + the active account or with the specified token + +SYNOPSIS + gcloud run services proxy (SERVICE : --namespace=NAMESPACE) + [--platform=PLATFORM; default="managed"] [--port=PORT] [--tag=TAG] + [--token=TOKEN] + [--region=REGION + | --cluster=CLUSTER --cluster-location=CLUSTER_LOCATION + | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Proxy a service to localhost authenticating as the active account or with + the specified token. + +EXAMPLES + To proxy the service 'my-service' at localhost port 8080: + + $ gcloud run services proxy my-service --port=8080 + + To proxy the existing traffic tag 'my-tag' on the service 'my-service: + + $ gcloud run services proxy my-service --tag=my-tag + +POSITIONAL ARGUMENTS + Service resource - Service to proxy locally. The arguments in this group + can be used to specify the attributes of this resource. + + This must be specified. + + SERVICE + ID of the service or fully qualified identifier for the service. + + To set the service attribute: + ▸ provide the argument SERVICE on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --namespace=NAMESPACE + Specific to Cloud Run for Anthos: Kubernetes namespace for the + service. + + To set the namespace attribute: + ▸ provide the argument SERVICE on the command line with a fully + specified name; + ▸ provide the argument --namespace on the command line; + ▸ set the property run/namespace; + ▸ For Cloud Run on Kubernetes Engine, defaults to "default". + Otherwise, defaults to project ID.; + ▸ provide the argument project on the command line; + ▸ set the property core/project. + +FLAGS + --platform=PLATFORM; default="managed" + Target platform for running commands. Alternatively, set the property + [run/platform]. PLATFORM must be one of: + + managed + Fully managed version of Cloud Run. Use with the --region flag or + set the [run/region] property to specify a Cloud Run region. + gke + Cloud Run for Anthos on Google Cloud. Use with the --cluster and + --cluster-location flags or set the [run/cluster] and + [run/cluster_location] properties to specify a cluster in a given + zone. + kubernetes + Use a Knative-compatible kubernetes cluster. Use with the + --kubeconfig and --context flags to specify a kubeconfig file and + the context for connecting. + + --port=PORT + Local port number to expose the proxied service. If not specified, it + will be set to 8080. + + --tag=TAG + Traffic tag of the service to expose via the proxy. If not specified, + the default service URL will be proxied which may serve different + revisions based on traffic-splits. Custom tags can be used to proxy + specific revisions. Please see + https://cloud.google.com/run/docs/rollouts-rollbacks-traffic-migration#tags. + + --token=TOKEN + The specific identity token to add to all requests of the proxied + service. If not specified, the identity token of the currently active + authenticated account will be used (e.g. gcloud auth + print-identity-token). + + Arguments to locate resources, depending on the platform used. + + At most one of these can be specified: + + Only applicable if connecting to Cloud Run (fully managed). Specify + --platform=managed to use: + + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + + Only applicable if connecting to Cloud Run for Anthos deployed on Google + Cloud. Specify --platform=gke to use: + + Cluster resource - Kubernetes Engine cluster to connect to. 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 --cluster on the command line with a fully + specified name; + ▫ set the property run/cluster with a fully specified name; + ▫ specify the cluster from a list of available clusters with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --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; + ◇ set the property run/cluster; + ◇ specify the cluster from a list of available clusters. + + --cluster-location=CLUSTER_LOCATION + Zone in which the cluster is located. Alternatively, set the + property [run/cluster_location]. + + To set the location attribute: + ◇ provide the argument --cluster on the command line with a + fully specified name; + ◇ set the property run/cluster with a fully specified name; + ◇ specify the cluster from a list of available clusters with a + fully specified name; + ◇ provide the argument --cluster-location on the command line; + ◇ set the property run/cluster_location; + ◇ specify the cluster location from a list of available zones. + + Only applicable if connecting to Cloud Run for Anthos deployed on + VMware. Specify --platform=kubernetes to use: + + --context=CONTEXT + The name of the context in your kubectl config file to use for + connecting. + + --kubeconfig=KUBECONFIG + The absolute path to your kubectl config file. If not specified, + the colon- or semicolon-delimited list of paths specified by + $KUBECONFIG will be used. If $KUBECONFIG is unset, this defaults to + ~/.kube/config. + +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 + These variants are also available: + + $ gcloud alpha run services proxy + + $ gcloud beta run services proxy + diff --git a/gcloud/sql/instances/create b/gcloud/sql/instances/create index 5028c4d69..1fcb07ea3 100644 --- a/gcloud/sql/instances/create +++ b/gcloud/sql/instances/create @@ -88,10 +88,10 @@ FLAGS --activation-policy=ACTIVATION_POLICY Activation policy for this instance. This specifies when the instance should be activated and is applicable only when the instance state is - RUNNABLE. The default is on-demand. More information on activation + RUNNABLE. The default is always. More information on activation policies can be found here: https://cloud.google.com/sql/docs/mysql/start-stop-restart-instance#activation_policy. - ACTIVATION_POLICY must be one of: always, never, on-demand. + ACTIVATION_POLICY must be one of: always, never. --active-directory-domain=ACTIVE_DIRECTORY_DOMAIN Managed Service for Microsoft Active Directory domain this instance is diff --git a/gcloud/sql/instances/patch b/gcloud/sql/instances/patch index 38b031c5e..d25001679 100644 --- a/gcloud/sql/instances/patch +++ b/gcloud/sql/instances/patch @@ -58,10 +58,10 @@ FLAGS --activation-policy=ACTIVATION_POLICY Activation policy for this instance. This specifies when the instance should be activated and is applicable only when the instance state is - RUNNABLE. The default is on-demand. More information on activation + RUNNABLE. The default is always. More information on activation policies can be found here: https://cloud.google.com/sql/docs/mysql/start-stop-restart-instance#activation_policy. - ACTIVATION_POLICY must be one of: always, never, on-demand. + ACTIVATION_POLICY must be one of: always, never. --active-directory-domain=ACTIVE_DIRECTORY_DOMAIN Managed Service for Microsoft Active Directory domain this instance is diff --git a/gcloud/storage/buckets/create b/gcloud/storage/buckets/create index 29fa8f213..b8ed61ed3 100644 --- a/gcloud/storage/buckets/create +++ b/gcloud/storage/buckets/create @@ -82,9 +82,9 @@ FLAGS dual-regions buckets. ASYNC_TURBO option is only valid for dual-region buckets. If unspecified when the bucket is created, it defaults to DEFAULT for dual-region and multi-region buckets. For more information, - see Turbo Replication - (https://cloud.google.com/storage/docs/turbo-replication). SETTING must - be one of: ASYNC_TURBO, DEFAULT. + see replication in Cloud Storage + (https://cloud.google.com/storage/docs/availability-durability#cross-region-redundancy). + SETTING must be one of: ASYNC_TURBO, DEFAULT. --retention-period=RETENTION_PERIOD Minimum retention period diff --git a/gcloud/storage/buckets/update b/gcloud/storage/buckets/update index 50966a0b0..ac12b3d92 100644 --- a/gcloud/storage/buckets/update +++ b/gcloud/storage/buckets/update @@ -96,9 +96,9 @@ FLAGS dual-regions buckets. ASYNC_TURBO option is only valid for dual-region buckets. If unspecified when the bucket is created, it defaults to DEFAULT for dual-region and multi-region buckets. For more information, - see Turbo Replication - (https://cloud.google.com/storage/docs/turbo-replication). SETTING must - be one of: ASYNC_TURBO, DEFAULT. + see replication in Cloud Storage + (https://cloud.google.com/storage/docs/availability-durability#cross-region-redundancy). + SETTING must be one of: ASYNC_TURBO, DEFAULT. --[no-]requester-pays Allows you to configure a Cloud Storage bucket so that the requester diff --git a/gcloud/transfer/jobs/create b/gcloud/transfer/jobs/create index 73b5aecaf..2384385c8 100644 --- a/gcloud/transfer/jobs/create +++ b/gcloud/transfer/jobs/create @@ -301,7 +301,7 @@ FLAGS https://cloud.google.com/storage-transfer/docs/metadata-preservation. METADATA_FIELDS must be one of: acl, gid, kms-key, mode, - storage-class, symlink, temporary-hold, uid. + storage-class, symlink, temporary-hold, time-created, uid. --custom-storage-class=CUSTOM_STORAGE_CLASS Specifies the storage class to set on objects being transferred to diff --git a/gcloud/transfer/jobs/update b/gcloud/transfer/jobs/update index 86f7c9d89..e9f0805d3 100644 --- a/gcloud/transfer/jobs/update +++ b/gcloud/transfer/jobs/update @@ -363,7 +363,7 @@ FLAGS https://cloud.google.com/storage-transfer/docs/metadata-preservation. METADATA_FIELDS must be one of: acl, gid, kms-key, mode, - storage-class, symlink, temporary-hold, uid. + storage-class, symlink, temporary-hold, time-created, uid. --custom-storage-class=CUSTOM_STORAGE_CLASS Specifies the storage class to set on objects being transferred to diff --git a/gcloud/vmware/help b/gcloud/vmware/help index 4f26a764f..a758c8e24 100644 --- a/gcloud/vmware/help +++ b/gcloud/vmware/help @@ -32,3 +32,6 @@ GROUPS private-clouds Manage private clouds in Google Cloud VMware Engine. + + private-connections + Manage Private Connections in Google Cloud VMware Engine. diff --git a/gcloud/vmware/private-clouds/subnets/describe b/gcloud/vmware/private-clouds/subnets/describe new file mode 100644 index 000000000..530ec1453 --- /dev/null +++ b/gcloud/vmware/private-clouds/subnets/describe @@ -0,0 +1,76 @@ +NAME + gcloud vmware private-clouds subnets describe - describe a subnet in a + VMware Engine private cloud + +SYNOPSIS + gcloud vmware private-clouds subnets describe + (SUBNET : --location=LOCATION --private-cloud=PRIVATE_CLOUD) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Subnet by its resource name. It contains details of the subnet, + such as ip_cidr_range, gateway_ip, state, and type. + +EXAMPLES + To get the information about a subnet resource called my-subnet, that + belongs to the private cloud my-private-cloud in project my-project and + zone us-west1-a, run: + + $ gcloud vmware private-clouds subnets describe my-subnet \ + --private-cloud=my-private-cloud --location=us-west1-a \ + --project=my-project + + Or: + + $ gcloud vmware private-clouds subnets describe my-subnet \ + --private-cloud=my-private-cloud + + In the second example, the project and location are taken from gcloud + properties core/project and compute/zone, respectively. + +POSITIONAL ARGUMENTS + Subnet resource - subnet. 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 subnet 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. + + SUBNET + ID of the subnet or fully qualified identifier for the subnet. + + To set the subnet attribute: + ▸ provide the argument subnet on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the private cloud or cluster. + + To set the location attribute: + ▸ provide the argument subnet on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property compute/zone. + + --private-cloud=PRIVATE_CLOUD + VMware Engine private cloud. + + To set the private-cloud attribute: + ▸ provide the argument subnet on the command line with a fully + specified name; + ▸ provide the argument --private-cloud 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. diff --git a/gcloud/vmware/private-clouds/subnets/help b/gcloud/vmware/private-clouds/subnets/help index 5fcdf17bc..b26c37e7c 100644 --- a/gcloud/vmware/private-clouds/subnets/help +++ b/gcloud/vmware/private-clouds/subnets/help @@ -16,5 +16,11 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + describe + Describe a subnet in a VMware Engine private cloud. + list List subnets in a VMware Engine private cloud. + + update + Update a subnet. diff --git a/gcloud/vmware/private-clouds/subnets/update b/gcloud/vmware/private-clouds/subnets/update new file mode 100644 index 000000000..e490d2e46 --- /dev/null +++ b/gcloud/vmware/private-clouds/subnets/update @@ -0,0 +1,79 @@ +NAME + gcloud vmware private-clouds subnets update - update a subnet + +SYNOPSIS + gcloud vmware private-clouds subnets update + (SUBNET : --location=LOCATION --private-cloud=PRIVATE_CLOUD) + --ip-cidr-range=IP_CIDR_RANGE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a Subnet. Only ip-cidr-range can be updated. This is a synchronous + command and doesn't support --async and --no-async flags. + +EXAMPLES + To update a subnet named my-subnet, that belongs to the private cloud + my-private-cloud in project my-project and zone us-west1-a by changing its + ip-cidr-range to 10.0.0.0/24, run: + + $ gcloud vmware private-clouds subnets update my-subnet \ + --private-cloud=my-private-cloud --location=us-west1 \ + --project=my-project --ip-cidr-range=10.0.0.0/24 + + Or: + + $ gcloud vmware private-clouds subnets update my-subnet \ + --private-cloud=my-private-cloud --ip-cidr-range=10.0.0.0/24 + + In the second example, the project and location are taken from gcloud + properties core/project and compute/zone, respectively. + +POSITIONAL ARGUMENTS + Subnet resource - subnet. 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 subnet 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. + + SUBNET + ID of the subnet or fully qualified identifier for the subnet. + + To set the subnet attribute: + ▸ provide the argument subnet on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the private cloud or cluster. + + To set the location attribute: + ▸ provide the argument subnet on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property compute/zone. + + --private-cloud=PRIVATE_CLOUD + VMware Engine private cloud. + + To set the private-cloud attribute: + ▸ provide the argument subnet on the command line with a fully + specified name; + ▸ provide the argument --private-cloud on the command line. + +REQUIRED FLAGS + --ip-cidr-range=IP_CIDR_RANGE + Updated IP CIDR range for this subnet. + +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. diff --git a/gcloud/vmware/private-connections/create b/gcloud/vmware/private-connections/create new file mode 100644 index 000000000..3306d094f --- /dev/null +++ b/gcloud/vmware/private-connections/create @@ -0,0 +1,192 @@ +NAME + gcloud vmware private-connections create - create a Google Cloud Private + Connection + +SYNOPSIS + gcloud vmware private-connections create + (PRIVATE_CONNECTION : --location=LOCATION) + --service-project=SERVICE_PROJECT --type=TYPE + --vmware-engine-network=VMWARE_ENGINE_NETWORK [--async] + [--description=DESCRIPTION] [--routing-mode=ROUTING_MODE] + [--service-network=SERVICE_NETWORK] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Creates a new private connection to connect VMware Engine Network to the + specified VPC network. This establishes private IP connectivity between the + VPC network and all the VMware Private Clouds attached to the VMware Engine + Network. Private connection creation is considered finished when the + connection is in ACTIVE state. Check the progress of the private connection + using gcloud vmware private-connections list. + +EXAMPLES + To create a Private Connection of type PRIVATE_SERVICE_ACCESS, first obtain + the service-project by listing vpc-peerings, run: + + $ gcloud compute networks peerings list --network=my-vpc \ + --project=my-project + + where my-vpc is the VPC on which a private service access connection is + created and project is the one in which the private connection will be + created. + + The response will be of this format: + + NAME NETWORK PEER_PROJECT + + servicenetworking-googleapis-com my-vpc td096d594ece09650-tp + + The PEER_PROJECT field in the output of the command will provide the value + for the service-project required for creating the private connection. + + To create a Private Connection called my-private-connection of type + PRIVATE_SERVICE_ACCESS in project my-project and region us-west1 with + routing_mode REGIONAL to connect service networking VPC from project + td096d594ece09650-tp to legacy VMware Engine Network us-west1-default, run: + + $ gcloud vmware private-connections create my-private-connection \ + --location=us-west1 --project=my-project \ + --vmware-engine-network=us-west1-default \ + --description="A short description for the new private \ + connection" --routing-mode=REGIONAL \ + --service-project=td096d594ece09650-tp \ + --type=PRIVATE_SERVICE_ACCESS + + Or: + + $ gcloud vmware private-connections create my-private-connection \ + --vmware-engine-network=us-west1-default \ + --description="A short description for the new private \ + connection" --routing-mode=REGIONAL \ + --service-project=td096d594ece09650-tp \ + --type=PRIVATE_SERVICE_ACCESS + + In the second example, the project and location are taken from gcloud properties core/project and compute/region, respectively. + + To create a Private Connection called my-private-connection of type + THIRD_PARTY_SERVICE in project my-project and region us-west1 to connect + VPC my-service-network from project td096d594ece09650-tp to legacy VMware + Engine Network us-west1-default, run: + + $ gcloud vmware private-connections create my-private-connection \ + --location=us-west1 --project=my-project \ + --vmware-engine-network=us-west1-default \ + --description="A short description for the new private \ + connection" --service-network=my-service-network \ + --service-project=td096d594ece09650-tp \ + --type=THIRD_PARTY_SERVICE + + Or: + + $ gcloud vmware private-connections create my-private-connection \ + --vmware-engine-network=us-west1-default \ + --description="A short description for the new private \ + connection" --service-network=my-service-network \ + --service-project=td096d594ece09650-tp \ + --type=THIRD_PARTY_SERVICE + + In the above example, the project and location are taken from gcloud properties core/project and compute/region, respectively. + + If you try to create a private connection of type=THIRD_PARTY_SERVICE, and + do not provide the service-network field, an error will be thrown with the + message: + + Missing required argument [--service-network]: For private connection of + type THIRD_PARTY_SERVICE, service-network field is required + +POSITIONAL ARGUMENTS + Private Connection resource - private_connection. 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 private_connection 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. + + PRIVATE_CONNECTION + ID of the Private Connection or fully qualified identifier for the + Private Connection. + + To set the private-connection attribute: + ▸ provide the argument private_connection on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The resource name of the location. + + To set the location attribute: + ▸ provide the argument private_connection on the command line with + a fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. + +REQUIRED FLAGS + --service-project=SERVICE_PROJECT + Project ID or project number of the service network. + + --type=TYPE + Type of private connection. TYPE must be one of: + + DELL_POWERSCALE + Peering connection used for connecting to Dell PowerScale. + NETAPP_CLOUD_VOLUMES + Peering connection used for connecting to NetApp Cloud Volumes. + PRIVATE_SERVICE_ACCESS + Peering connection used for establishing private services access + (https://cloud.google.com/vpc/docs/private-services-access). + THIRD_PARTY_SERVICE + Peering connection used for connecting to third-party services. + Most third-party services require manual setup of reverse peering + on the VPC network associated with the third-party service. + + --vmware-engine-network=VMWARE_ENGINE_NETWORK + Resource ID of the legacy VMware Engine network. Provide the + {vmware_engine_network_id}, which will be in the form of + {location}-default. The {location} is the same as the location + specified in the private connection resource. + +OPTIONAL 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. + + --description=DESCRIPTION + Text describing the private connection. + + --routing-mode=ROUTING_MODE + Type of the routing mode. Default value is set to GLOBAL. For + type=PRIVATE_SERVICE_ACCESS, this field can be set to GLOBAL or + REGIONAL, for other types only GLOBAL is supported. ROUTING_MODE must + be one of: GLOBAL, REGIONAL. + + --service-network=SERVICE_NETWORK + Resource ID of the service network to connect with the VMware Engine + network to create a private connection. + ◆ For type=PRIVATE_SERVICE_ACCESS, this field represents service + networking VPC. In this case the field value will be automatically + set to servicenetworking and cannot be changed. + ◆ For type=NETAPP_CLOUD_VOLUME, this field represents NetApp service + VPC. In this case the field value will be automatically set to + netapp-tenant-vpc and cannot be changed. + ◆ For type=DELL_POWERSCALE, this field represents Dell service VPC. + In this case the field value will be automatically set to + dell-tenant-vpc and cannot be changed. + ◆ For type=THIRD_PARTY_SERVICE, this field could represent a consumer + VPC or any other producer VPC to which the VMware Engine Network + needs to be connected. service-network field is required for this + type. + +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. diff --git a/gcloud/vmware/private-connections/delete b/gcloud/vmware/private-connections/delete new file mode 100644 index 000000000..2332e2804 --- /dev/null +++ b/gcloud/vmware/private-connections/delete @@ -0,0 +1,74 @@ +NAME + gcloud vmware private-connections delete - delete a Google Cloud Private + Connection + +SYNOPSIS + gcloud vmware private-connections delete + (PRIVATE_CONNECTION : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a Private Connection. When a private connection is deleted for a + VMware Engine network, the connected network becomes inaccessible to that + VMware Engine network. + +EXAMPLES + To delete a Private Connection resource called my-private-connection in + project my-project and region us-west1, run: + + $ gcloud vmware private-connections delete my-private-connection \ + --location=us-west1 --project=my-project + + Or: + + $ gcloud vmware private-connections delete my-private-connection + + In the second example, the project and the location is taken from gcloud + properties core/project and compute/region, respectively. + +POSITIONAL ARGUMENTS + Private Connection resource - private_connection. 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 private_connection 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. + + PRIVATE_CONNECTION + ID of the Private Connection or fully qualified identifier for the + Private Connection. + + To set the private-connection attribute: + ▸ provide the argument private_connection on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The resource name of the location. + + To set the location attribute: + ▸ provide the argument private_connection on the command line with + a fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. + +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. + +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. diff --git a/gcloud/vmware/private-connections/describe b/gcloud/vmware/private-connections/describe new file mode 100644 index 000000000..e6c6a753a --- /dev/null +++ b/gcloud/vmware/private-connections/describe @@ -0,0 +1,67 @@ +NAME + gcloud vmware private-connections describe - describe a Google Cloud + Private Connection + +SYNOPSIS + gcloud vmware private-connections describe + (PRIVATE_CONNECTION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Private Connection by its resource name. It contains details of + the private connection, such as service_network, vmware_engine_network, + routing_mode and state. + +EXAMPLES + To get the information about a private connection resource called + my-private-connection in project my-project and region us-west1, run: + + $ gcloud vmware private-connections describe my-private-connection \ + --location=us-west1 --project=my-project + + Or: + + $ gcloud vmware private-connections describe my-private-connection + + In the second example, the project and location are taken from gcloud + properties core/project and compute/region, respectively. + +POSITIONAL ARGUMENTS + Private Connection resource - private_connection. 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 private_connection 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. + + PRIVATE_CONNECTION + ID of the Private Connection or fully qualified identifier for the + Private Connection. + + To set the private-connection attribute: + ▸ provide the argument private_connection on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The resource name of the location. + + To set the location attribute: + ▸ provide the argument private_connection on the command line with + a fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. diff --git a/gcloud/vmware/private-connections/help b/gcloud/vmware/private-connections/help new file mode 100644 index 000000000..fae0cc7d0 --- /dev/null +++ b/gcloud/vmware/private-connections/help @@ -0,0 +1,38 @@ +NAME + gcloud vmware private-connections - manage Private Connections in Google + Cloud VMware Engine + +SYNOPSIS + gcloud vmware private-connections GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Private Connections in Google Cloud VMware Engine. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + routes + Manage private connection peering routes in Google Cloud VMware Engine. + +COMMANDS + COMMAND is one of the following: + + create + Create a Google Cloud Private Connection. + + delete + Delete a Google Cloud Private Connection. + + describe + Describe a Google Cloud Private Connection. + + list + List Google Cloud Private Connections. + + update + Update a Google Cloud Private Connection. diff --git a/gcloud/vmware/private-connections/list b/gcloud/vmware/private-connections/list new file mode 100644 index 000000000..6ad9e49d5 --- /dev/null +++ b/gcloud/vmware/private-connections/list @@ -0,0 +1,97 @@ +NAME + gcloud vmware private-connections list - list Google Cloud Private + Connections + +SYNOPSIS + gcloud vmware private-connections list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Lists VMware Engine private connections. + +EXAMPLES + To list private connections in project my-project and region us-west1 + sorted from oldest to newest, run: + + $ gcloud vmware private-connections list --location=us-west1 \ + --project=my-project --sort-by=~create_time + + Or: + + $ gcloud vmware private-connections list --sort-by=~create_time + + In the second example, the project and the location are taken from gcloud + properties core/project and compute/region, respectively. + + To list private connections in project my-project from all regions, run: + + $ gcloud vmware private-connections list --location=- \ + --project=my-project + + Or: + + $ gcloud vmware private-connections list --location=- + + In the last example, the project is taken from gcloud properties + core/project. + +FLAGS + Regional location resource - location. 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 --location on the command line with a fully + specified name; + ◆ set the property compute/region with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --location=LOCATION + ID of the regional location or fully qualified identifier for the + regional location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. diff --git a/gcloud/vmware/private-connections/routes/help b/gcloud/vmware/private-connections/routes/help new file mode 100644 index 000000000..88a10a46b --- /dev/null +++ b/gcloud/vmware/private-connections/routes/help @@ -0,0 +1,20 @@ +NAME + gcloud vmware private-connections routes - manage private connection + peering routes in Google Cloud VMware Engine + +SYNOPSIS + gcloud vmware private-connections routes COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage private connection peering routes in Google Cloud VMware Engine. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List Google Cloud private connection peering routes. diff --git a/gcloud/vmware/private-connections/routes/list b/gcloud/vmware/private-connections/routes/list new file mode 100644 index 000000000..83342d863 --- /dev/null +++ b/gcloud/vmware/private-connections/routes/list @@ -0,0 +1,101 @@ +NAME + gcloud vmware private-connections routes list - list Google Cloud private + connection peering routes + +SYNOPSIS + gcloud vmware private-connections routes list + (--private-connection=PRIVATE_CONNECTION : --location=LOCATION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Lists the private connection routes exchanged over a peering connection. + +EXAMPLES + To list all the peering routes of private connection called + my-private-connection in project my-project and region us-west1, run: + + $ gcloud vmware private-connections routes list \ + --private-connection=my-private-connection --location=us-west1 \ + --project=my-project + + Or: + + $ gcloud vmware private-connections routes list \ + --private-connection=my-private-connection + + In the last example, the project and the location are taken from gcloud + properties core/project and compute/region, respectively. + +REQUIRED FLAGS + Private Connection resource - private_connection. 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 --private-connection 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. + + --private-connection=PRIVATE_CONNECTION + ID of the Private Connection or fully qualified identifier for the + Private Connection. + + To set the private-connection attribute: + ▸ provide the argument --private-connection on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The resource name of the location. + + To set the location attribute: + ▸ provide the argument --private-connection on the command line + with a fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. diff --git a/gcloud/vmware/private-connections/update b/gcloud/vmware/private-connections/update new file mode 100644 index 000000000..312169d2d --- /dev/null +++ b/gcloud/vmware/private-connections/update @@ -0,0 +1,86 @@ +NAME + gcloud vmware private-connections update - update a Google Cloud Private + Connection + +SYNOPSIS + gcloud vmware private-connections update + (PRIVATE_CONNECTION : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--routing-mode=ROUTING_MODE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Updates a VMware Engine private connection. Only description and + routing-mode can be updated. + +EXAMPLES + To update a private connection named my-private-connection in project + my-project and region us-west1 by changing its description to Updated + description for the private connection and routing-mode to GLOBAL, run: + + $ gcloud vmware private-connections update my-private-connection \ + --location=us-west1 --project=my-project \ + --description="Updated description for the private connection" \ + --routing-mode=GLOBAL + + Or: + + $ gcloud vmware private-connections update my-private-connection \ + --description="Updated description for the private connection" \ + --routing-mode=GLOBAL + + In the second example, the project and location are taken from gcloud + properties core/project and compute/regions, respectively. + +POSITIONAL ARGUMENTS + Private Connection resource - private_connection. 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 private_connection 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. + + PRIVATE_CONNECTION + ID of the Private Connection or fully qualified identifier for the + Private Connection. + + To set the private-connection attribute: + ▸ provide the argument private_connection on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The resource name of the location. + + To set the location attribute: + ▸ provide the argument private_connection on the command line with + a fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property compute/region. + +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. + + --description=DESCRIPTION + Updated description for this Private Connection. + + --routing-mode=ROUTING_MODE + Updated routing mode for this Private Connection. ROUTING_MODE must be + one of: GLOBAL, REGIONAL. + +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.