diff --git a/gcloud/_version b/gcloud/_version index 96232e0f0..dcc8cf3b0 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,6 +1,6 @@ -Google Cloud SDK 380.0.0 -alpha 2022.04.01 -beta 2022.04.01 +Google Cloud SDK 381.0.0 +alpha 2022.04.08 +beta 2022.04.08 bq 2.0.74 -core 2022.04.01 -gsutil 5.8 +core 2022.04.08 +gsutil 5.9 diff --git a/gcloud/ai/endpoints/create b/gcloud/ai/endpoints/create index 6ccc1eed7..8eeb84aa2 100644 --- a/gcloud/ai/endpoints/create +++ b/gcloud/ai/endpoints/create @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud ai endpoints create --display-name=DISPLAY_NAME [--description=DESCRIPTION] [--endpoint-id=ENDPOINT_ID] - [--labels=[KEY=VALUE,...]] [--region=REGION] [GCLOUD_WIDE_FLAG ...] + [--labels=[KEY=VALUE,...]] [--network=NETWORK] [--region=REGION] + [GCLOUD_WIDE_FLAG ...] EXAMPLES To create an endpoint under project example in region us-central1, run: @@ -31,6 +32,10 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --network=NETWORK + The full name of the Google Compute Engine network to which the + endpoint should be peered. + Region resource - Cloud region to create endpoint. 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: diff --git a/gcloud/alpha/bigtable/hot-tablets/help b/gcloud/alpha/bigtable/hot-tablets/help index 2fa182265..04079c134 100644 --- a/gcloud/alpha/bigtable/hot-tablets/help +++ b/gcloud/alpha/bigtable/hot-tablets/help @@ -16,11 +16,15 @@ COMMANDS COMMAND is one of the following: list - (ALPHA) List Hottablets in Bigtable cluster. + (ALPHA) List hot tablets in a Cloud Bigtable cluster. 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. These variants are also available: + + $ gcloud bigtable hot-tablets + + $ gcloud beta bigtable hot-tablets diff --git a/gcloud/alpha/bigtable/hot-tablets/list b/gcloud/alpha/bigtable/hot-tablets/list index 52bbb9da9..bf192b711 100644 --- a/gcloud/alpha/bigtable/hot-tablets/list +++ b/gcloud/alpha/bigtable/hot-tablets/list @@ -1,6 +1,6 @@ NAME - gcloud alpha bigtable hot-tablets list - list Hottablets in Bigtable - cluster + gcloud alpha bigtable hot-tablets list - list hot tablets in a Cloud + Bigtable cluster SYNOPSIS gcloud alpha bigtable hot-tablets list (CLUSTER : --instance=INSTANCE) @@ -9,7 +9,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List Hottablets in Bigtable cluster. + (ALPHA) List hot tablets in a Cloud Bigtable cluster. EXAMPLES Search for hot tablets in the past 24 hours: @@ -109,5 +109,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. + access allowlist. These variants are also available: + + $ gcloud bigtable hot-tablets list + + $ gcloud beta bigtable hot-tablets list diff --git a/gcloud/alpha/builds/triggers/create/pubsub b/gcloud/alpha/builds/triggers/create/pubsub index d962d1da0..6cce1c8b0 100644 --- a/gcloud/alpha/builds/triggers/create/pubsub +++ b/gcloud/alpha/builds/triggers/create/pubsub @@ -10,8 +10,9 @@ SYNOPSIS default="/" --dockerfile-image=DOCKERFILE_IMAGE) : --description=DESCRIPTION --filter=FILTER --name=NAME --require-approval --service-account=SERVICE_ACCOUNT - --substitutions=[KEY=VALUE,...] --repo=REPO (--branch=BRANCH - | --tag=TAG)]) [GCLOUD_WIDE_FLAG ...] + --substitutions=[KEY=VALUE,...] + --repo=REPO --repo-type=REPO_TYPE (--branch=BRANCH | --tag=TAG)]) + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a build trigger with a Pub/Sub trigger event. @@ -25,7 +26,8 @@ EXAMPLES --service-account="projects/my-project/serviceAccounts/my-byosa@\ my-project.iam.gserviceaccount.com" \ --topic=projects/my-project/topics/my-topic \ - --repo=https://www.github.com/owner/repo --branch=my-branch + --repo=https://www.github.com/owner/repo --repo-type=GITHUB \ + --branch=my-branch REQUIRED FLAGS Exactly one of these must be specified: @@ -137,6 +139,13 @@ REQUIRED FLAGS This flag must be specified if any of the other arguments in this group are specified. + --repo-type=REPO_TYPE + Type of the repository. Currently only GitHub and Cloud Source + Repository types are supported. + + This flag must be specified if any of the other arguments in this + group are specified. + Exactly one of these must be specified: --branch=BRANCH diff --git a/gcloud/alpha/builds/triggers/create/webhook b/gcloud/alpha/builds/triggers/create/webhook index 328a0f740..456263618 100644 --- a/gcloud/alpha/builds/triggers/create/webhook +++ b/gcloud/alpha/builds/triggers/create/webhook @@ -10,8 +10,9 @@ SYNOPSIS default="/" --dockerfile-image=DOCKERFILE_IMAGE) : --description=DESCRIPTION --filter=FILTER --name=NAME --require-approval --service-account=SERVICE_ACCOUNT - --substitutions=[KEY=VALUE,...] --repo=REPO (--branch=BRANCH - | --tag=TAG)]) [GCLOUD_WIDE_FLAG ...] + --substitutions=[KEY=VALUE,...] + --repo=REPO --repo-type=REPO_TYPE (--branch=BRANCH | --tag=TAG)]) + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a build trigger with a Webhook trigger event. @@ -26,7 +27,8 @@ EXAMPLES --service-account="projects/my-project/serviceAccounts/my-byosa@\ my-project.iam.gserviceaccount.com" \ --secret=projects/my-project/secrets/my-secret/versions/2 \ - --repo=https://www.github.com/owner/repo --branch=my-branch + --repo=https://www.github.com/owner/repo --repo-type=GITHUB \ + --branch=my-branch REQUIRED FLAGS Exactly one of these must be specified: @@ -140,6 +142,13 @@ REQUIRED FLAGS This flag must be specified if any of the other arguments in this group are specified. + --repo-type=REPO_TYPE + Type of the repository. Currently only GitHub and Cloud Source + Repository types are supported. + + This flag must be specified if any of the other arguments in this + group are specified. + Exactly one of these must be specified: --branch=BRANCH diff --git a/gcloud/alpha/compute/backend-services/create b/gcloud/alpha/compute/backend-services/create index 309b6c025..360321f26 100644 --- a/gcloud/alpha/compute/backend-services/create +++ b/gcloud/alpha/compute/backend-services/create @@ -246,7 +246,14 @@ FLAGS --drop-traffic-if-unhealthy Enable dropping of traffic if there are no healthy VMs detected in both the primary and backup instance groups. Not compatible with the - --global flag and load balancing scheme must be INTERNAL or EXTERNAL. + --global flag. Applicable only for backend service-based network load + balancers and internal TCP/UDP load balancers as part of a connection + tracking policy. For details, see: Connection persistence on unhealthy + backends for internal TCP/UDP load balancing + (https://cloud.google.com/load-balancing/docs/internal#connection-persistence) + and Connection persistence on unhealthy backends for network load + balancing + (https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence). --[no-]enable-cdn Enable or disable Cloud CDN for the backend service. Only available for diff --git a/gcloud/alpha/compute/backend-services/update b/gcloud/alpha/compute/backend-services/update index 5f1200eb8..d91ea5338 100644 --- a/gcloud/alpha/compute/backend-services/update +++ b/gcloud/alpha/compute/backend-services/update @@ -154,7 +154,14 @@ FLAGS --drop-traffic-if-unhealthy Enable dropping of traffic if there are no healthy VMs detected in both the primary and backup instance groups. Not compatible with the - --global flag and load balancing scheme must be INTERNAL or EXTERNAL. + --global flag. Applicable only for backend service-based network load + balancers and internal TCP/UDP load balancers as part of a connection + tracking policy. For details, see: Connection persistence on unhealthy + backends for internal TCP/UDP load balancing + (https://cloud.google.com/load-balancing/docs/internal#connection-persistence) + and Connection persistence on unhealthy backends for network load + balancing + (https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence). --edge-security-policy=EDGE_SECURITY_POLICY The edge security policy that will be set for this backend service. To diff --git a/gcloud/alpha/compute/disks/create b/gcloud/alpha/compute/disks/create index 41b645593..3376a365d 100644 --- a/gcloud/alpha/compute/disks/create +++ b/gcloud/alpha/compute/disks/create @@ -86,7 +86,8 @@ FLAGS https://cloud.google.com/compute/docs/images/create-delete-deprecate-private-images#guest-os-features for descriptions of the supported features. GUEST_OS_FEATURE must be one of: BARE_METAL_LINUX_COMPATIBLE, GVNIC, MULTI_IP_SUBNET, - SEV_CAPABLE, UEFI_COMPATIBLE, VIRTIO_SCSI_MULTIQUEUE, WINDOWS. + SEV_CAPABLE, SEV_SNP_CAPABLE, UEFI_COMPATIBLE, VIRTIO_SCSI_MULTIQUEUE, + WINDOWS. --interface=INTERFACE Specifies the disk interface to use for attaching this disk. Valid diff --git a/gcloud/alpha/compute/disks/snapshot b/gcloud/alpha/compute/disks/snapshot index 89bc30790..ae6f65111 100644 --- a/gcloud/alpha/compute/disks/snapshot +++ b/gcloud/alpha/compute/disks/snapshot @@ -14,7 +14,7 @@ DESCRIPTION disks. Snapshots are useful for backing up data, copying a persistent disk, and even, creating a custom image. Snapshots can be created from persistent disks even while they are attached to running instances. Once created, - snapshots may be managed (listed, deleted, resized etc.) via gcloud compute + snapshots may be managed (listed, deleted, etc.) via gcloud compute snapshots. Refer to the Snapshot best practices guide. diff --git a/gcloud/alpha/compute/images/create b/gcloud/alpha/compute/images/create index 7346e278b..d608b8ba4 100644 --- a/gcloud/alpha/compute/images/create +++ b/gcloud/alpha/compute/images/create @@ -152,7 +152,8 @@ OPTIONAL FLAGS https://cloud.google.com/compute/docs/images/create-delete-deprecate-private-images#guest-os-features for descriptions of the supported features. GUEST_OS_FEATURE must be one of: BARE_METAL_LINUX_COMPATIBLE, GVNIC, MULTI_IP_SUBNET, - SEV_CAPABLE, UEFI_COMPATIBLE, VIRTIO_SCSI_MULTIQUEUE, WINDOWS. + SEV_CAPABLE, SEV_SNP_CAPABLE, UEFI_COMPATIBLE, VIRTIO_SCSI_MULTIQUEUE, + WINDOWS. --key-exchange-key-file=[KEK_VALUE,...] Comma-separated list of file paths that point to X.509 certificates in diff --git a/gcloud/alpha/compute/instances/set-scheduling b/gcloud/alpha/compute/instances/set-scheduling index bb633ec1a..2fbee5ab7 100644 --- a/gcloud/alpha/compute/instances/set-scheduling +++ b/gcloud/alpha/compute/instances/set-scheduling @@ -6,16 +6,20 @@ SYNOPSIS gcloud alpha compute instances set-scheduling INSTANCE_NAME [--clear-min-node-cpu] [--host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS] - [--min-node-cpu=MIN_NODE_CPU] [--preemptible] - [--[no-]restart-on-failure] [--zone=ZONE] + [--min-node-cpu=MIN_NODE_CPU] [--[no-]preemptible] + [--provisioning-model=PROVISIONING_MODEL] [--[no-]restart-on-failure] + [--zone=ZONE] + [--clear-instance-termination-action + | --instance-termination-action=INSTANCE_TERMINATION_ACTION] [--clear-node-affinities | --node=NODE | --node-affinity-file=NODE_AFFINITY_FILE | --node-group=NODE_GROUP] [--maintenance-policy=MAINTENANCE_POLICY | --on-host-maintenance=MAINTENANCE_POLICY] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) $gcloud alpha compute instances set-scheduling is used to configure - scheduling options for Compute Engine virtual machines. + (ALPHA) $gcloud alpha compute instances set-scheduling is used to update + scheduling options for VM instances. You can only call this method on a VM + instance that is stopped (a VM instance in a TERMINATED state). EXAMPLES To set instance to be terminated during maintenance, run: @@ -44,11 +48,25 @@ FLAGS Minimum number of virtual CPUs this instance will consume when running on a sole-tenant node. - --preemptible + --[no-]preemptible If provided, instances will be preemptible and time-limited. Instances might be preempted to free up resources for standard VM instances, and will only be able to run for a limited amount of time. Preemptible - instances can not be restarted and will not migrate. + instances can not be restarted and will not migrate. Use --preemptible + to enable and --no-preemptible to disable. + + --provisioning-model=PROVISIONING_MODEL + Specifies provisioning model, which determines price, obtainability, + and runtime for the VM instance. PROVISIONING_MODEL must be one of: + + SPOT + Spot VMs are spare capacity; Spot VMs are discounted to have much + lower prices than standard VMs but have no guaranteed runtime. Spot + VMs are the new version of preemptible VM instances, except Spot + VMs do not have a 24-hour maximum runtime. + STANDARD + Default. Standard provisioning model for VM instances, which has + user-controlled runtime but no Spot discounts. --[no-]restart-on-failure The instances will be restarted if they are terminated by Compute @@ -80,6 +98,29 @@ FLAGS Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE. + Instance Termination Action + + At most one of these can be specified: + + --clear-instance-termination-action + Disables the termination action for this VM if allowed OR sets + termination action to the default value. Depending on a VM's + availability settings, a termination action is either required or not + allowed. This flag is required when you are updating a VM such that + it's previously specified termination action is no longer allowed. If + you use this flag when a VM requires a termination action, it's + termination action is just set to the default value (stop). + + --instance-termination-action=INSTANCE_TERMINATION_ACTION + Specifies the termination action that will be taken upon VM + preemption. INSTANCE_TERMINATION_ACTION must be one of: + + DELETE + Permanently delete the VM. + STOP + Default. Stop the VM without preserving memory. The VM can be + restarted later. + Sole Tenancy. At most one of these can be specified: diff --git a/gcloud/alpha/compute/networks/peerings/create b/gcloud/alpha/compute/networks/peerings/create index e63606ef2..f10e1611b 100644 --- a/gcloud/alpha/compute/networks/peerings/create +++ b/gcloud/alpha/compute/networks/peerings/create @@ -7,7 +7,8 @@ SYNOPSIS --peer-network=PEER_NETWORK [--async] [--auto-create-routes] [--export-custom-routes] [--export-subnet-routes-with-public-ip] [--import-custom-routes] [--import-subnet-routes-with-public-ip] - [--peer-project=PEER_PROJECT] [GCLOUD_WIDE_FLAG ...] + [--peer-project=PEER_PROJECT] [--stack-type=STACK_TYPE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute networks peerings create is used to create @@ -73,6 +74,19 @@ OPTIONAL FLAGS The name of the project for the peer network. If not specified, defaults to current project. + --stack-type=STACK_TYPE + Stack type of the peering. If not specified, defaults to IPV4_ONLY. + + STACK_TYPE must be one of: + + IPV4_ONLY + Only IPv4 traffic and routes will be exchanged across this peering. + + IPV4_IPV6 + IPv4 traffic and routes will be exchanged across this peering. + IPv6 traffic and routes will be exchanged if the matching peering + also has stack_type IPV4_IPV6. + 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/compute/networks/peerings/update b/gcloud/alpha/compute/networks/peerings/update index d83740785..2f4dcadda 100644 --- a/gcloud/alpha/compute/networks/peerings/update +++ b/gcloud/alpha/compute/networks/peerings/update @@ -6,7 +6,7 @@ SYNOPSIS gcloud alpha compute networks peerings update NAME --network=NETWORK [--export-custom-routes] [--export-subnet-routes-with-public-ip] [--import-custom-routes] [--import-subnet-routes-with-public-ip] - [GCLOUD_WIDE_FLAG ...] + [--stack-type=STACK_TYPE] [GCLOUD_WIDE_FLAG ...] EXAMPLES To update the peering named peering-name to both export and import custom @@ -50,6 +50,19 @@ OPTIONAL FLAGS public IP ranges from peer network. Use --no-import-subnet-routes-with-public-ip to disable it. + --stack-type=STACK_TYPE + Stack type of the peering. If not specified, defaults to IPV4_ONLY. + + STACK_TYPE must be one of: + + IPV4_ONLY + Only IPv4 traffic and routes will be exchanged across this peering. + + IPV4_IPV6 + IPv4 traffic and routes will be exchanged across this peering. + IPv6 traffic and routes will be exchanged if the matching peering + also has stack_type IPV4_IPV6. + 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/compute/networks/subnets/create b/gcloud/alpha/compute/networks/subnets/create index ecd25765b..abd11c591 100644 --- a/gcloud/alpha/compute/networks/subnets/create +++ b/gcloud/alpha/compute/networks/subnets/create @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha compute networks subnets create NAME --network=NETWORK - --range=RANGE [--aggregation-interval=AGGREGATION_INTERVAL] + [--aggregation-interval=AGGREGATION_INTERVAL] [--description=DESCRIPTION] [--enable-flow-logs] [--enable-private-ip-google-access] [--flow-sampling=FLOW_SAMPLING] [--ipv6-access-type=IPV6_ACCESS_TYPE] @@ -14,9 +14,12 @@ SYNOPSIS [--logging-metadata=LOGGING_METADATA] [--logging-metadata-fields=[METADATA_FIELD,...]] [--metadata=METADATA] [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] - [--purpose=PURPOSE] [--region=REGION] [--role=ROLE] - [--secondary-range=PROPERTY=VALUE,[...]] [--stack-type=STACK_TYPE] - [--enable-l2 : --vlan=VLAN] [GCLOUD_WIDE_FLAG ...] + [--purpose=PURPOSE] [--range=RANGE] [--region=REGION] + [--reserved-internal-range=RESERVED_INTERNAL_RANGE] [--role=ROLE] + [--secondary-range=PROPERTY=VALUE,[...]] + [--secondary-range-with-reserved-internal-range=RANGE_NAME=INTERNAL_RANGE_URL, + [...]] [--stack-type=STACK_TYPE] [--enable-l2 : --vlan=VLAN] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute networks subnets create define a subnetwork @@ -38,9 +41,6 @@ REQUIRED FLAGS --network=NETWORK The network to which the subnetwork belongs. - --range=RANGE - The IP space allocated to this subnetwork in CIDR format. - OPTIONAL FLAGS --aggregation-interval=AGGREGATION_INTERVAL Can only be specified if VPC Flow Logs for this subnetwork is enabled. @@ -142,6 +142,9 @@ OPTIONAL FLAGS REGIONAL_MANAGED_PROXY Reserved for Regional HTTP(S) Load Balancing. + --range=RANGE + The IP space allocated to this subnetwork in CIDR format. + --region=REGION Region of the subnetwork to create. If not specified, you might be prompted to select a region (interactive mode only). @@ -162,6 +165,23 @@ OPTIONAL FLAGS Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION. + --reserved-internal-range=RESERVED_INTERNAL_RANGE + If set, the primary IP range of the subnetwork will be associated with + the given InternalRange resource. + + If --range is set, the subnetwork will only use the given IP range. It + has to be contained by the IP range defined by the InternalRange + resource. + + For example, --range=10.0.0.0/24 --reserved-internal-range + //networkconnectivity.googleapis.com/projects/PROJECT/locations/global/internalRanges/RANGE + + If --range is not set, the subnetwork will use the entire IP range + defined by the InternalRange resource. + + For example, --reserved-internal-range + //networkconnectivity.googleapis.com/projects/PROJECT/locations/global/internalRanges/RANGE + --role=ROLE The role of subnetwork. This field is required when the purpose is set to GLOBAL_MANAGED_PROXY, REGIONAL_MANAGED_PROXY or @@ -181,6 +201,17 @@ OPTIONAL FLAGS ◆ RANGE_NAME - Name of the secondary range. ◆ RANGE - IP range in CIDR format. + --secondary-range-with-reserved-internal-range=RANGE_NAME=INTERNAL_RANGE_URL,[...] + Adds secondary IP ranges that are associated with InternalRange + resources. + + For example, --secondary-range-with-reserved-internal-range + range1=//networkconnectivity.googleapis.com/projects/PROJECT/locations/global/internalRanges/RANGE + adds a secondary range with the reserved internal range resource. + + ◆ RANGE_NAME - Name of the secondary range. + ◆ INTERNAL_RANGE_URL - URL of an InternalRange resource. + --stack-type=STACK_TYPE The stack type for this subnet. Determines if IPv6 is enabled on the subnet. If not specified IPV4_ONLY will be used. STACK_TYPE must be one diff --git a/gcloud/alpha/compute/networks/subnets/update b/gcloud/alpha/compute/networks/subnets/update index 44b59ebbb..c5e5dc754 100644 --- a/gcloud/alpha/compute/networks/subnets/update +++ b/gcloud/alpha/compute/networks/subnets/update @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha compute networks subnets update NAME - [--aggregation-interval=AGGREGATION_INTERVAL] + [--add-secondary-ranges-with-reserved-internal-range=RANGE_NAME=INTERNAL_RANGE_URL, + [...]] [--aggregation-interval=AGGREGATION_INTERVAL] [--drain-timeout=DRAIN_TIMEOUT; default="0s"] [--flow-sampling=FLOW_SAMPLING] [--ipv6-access-type=IPV6_ACCESS_TYPE] [--logging-aggregation-interval=LOGGING_AGGREGATION_INTERVAL] @@ -36,6 +37,17 @@ POSITIONAL ARGUMENTS Name of the subnetwork to update. FLAGS + --add-secondary-ranges-with-reserved-internal-range=RANGE_NAME=INTERNAL_RANGE_URL,[...] + Adds secondary IP ranges that are associated with InternalRange + resources. + + For example, --add-secondary-ranges-with-reserved-internal-range + range1=//networkconnectivity.googleapis.com/projects/PROJECT/locations/global/internalRanges/RANGE + adds a secondary range with the reserved internal range resource. + + ◆ RANGE_NAME - Name of the secondary range. + ◆ INTERNAL_RANGE_URL - URL of an InternalRange resource. + --aggregation-interval=AGGREGATION_INTERVAL Can only be specified if VPC Flow Logs for this subnetwork is enabled. Toggles the aggregation interval for collecting flow logs. Increasing diff --git a/gcloud/alpha/compute/routers/add-bgp-peer b/gcloud/alpha/compute/routers/add-bgp-peer index 2741c4ff1..3626856ae 100644 --- a/gcloud/alpha/compute/routers/add-bgp-peer +++ b/gcloud/alpha/compute/routers/add-bgp-peer @@ -9,6 +9,7 @@ SYNOPSIS [--advertisement-mode=MODE] [--async] [--[no-]enable-ipv6] [--[no-]enabled] [--instance=INSTANCE] [--instance-zone=INSTANCE_ZONE] [--ipv6-nexthop-address=IPV6_NEXTHOP_ADDRESS] + [--md5-authentication-key=MD5_AUTHENTICATION_KEY] [--peer-ip-address=PEER_IP_ADDRESS] [--peer-ipv6-nexthop-address=PEER_IPV6_NEXTHOP_ADDRESS] [--region=REGION] [--set-advertisement-groups=[GROUP,...]] @@ -102,6 +103,10 @@ OPTIONAL FLAGS the range 2600:2d00:0:2:0:0:0:0/64 or 2600:2d00:0:3:0:0:0:0/64 and must belong to same subnet as the interface address of the peer router. + --md5-authentication-key=MD5_AUTHENTICATION_KEY + The MD5 authentication key for this BGP peer. Maximum length is 80 + characters. Can contain only printable ASCII characters. + --peer-ip-address=PEER_IP_ADDRESS The link-local address of the peer router. Must be a link-local IPv4 address belonging to the range 169.254.0.0/16. diff --git a/gcloud/alpha/compute/routers/update-bgp-peer b/gcloud/alpha/compute/routers/update-bgp-peer index 11f2af807..9833e0268 100644 --- a/gcloud/alpha/compute/routers/update-bgp-peer +++ b/gcloud/alpha/compute/routers/update-bgp-peer @@ -5,9 +5,11 @@ NAME SYNOPSIS gcloud alpha compute routers update-bgp-peer NAME --peer-name=PEER_NAME [--advertised-route-priority=ADVERTISED_ROUTE_PRIORITY] - [--advertisement-mode=MODE] [--async] [--[no-]enable-ipv6] + [--advertisement-mode=MODE] [--async] + [--[no-]clear-md5-authentication-key] [--[no-]enable-ipv6] [--[no-]enabled] [--interface=INTERFACE] [--ip-address=IP_ADDRESS] - [--ipv6-nexthop-address=IPV6_NEXTHOP_ADDRESS] [--peer-asn=PEER_ASN] + [--ipv6-nexthop-address=IPV6_NEXTHOP_ADDRESS] + [--md5-authentication-key=MD5_AUTHENTICATION_KEY] [--peer-asn=PEER_ASN] [--peer-ip-address=PEER_IP_ADDRESS] [--peer-ipv6-nexthop-address=PEER_IPV6_NEXTHOP_ADDRESS] [--region=REGION] [--set-advertisement-groups=[GROUP,...]] @@ -53,6 +55,11 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --[no-]clear-md5-authentication-key + Remove MD5 authentication from the BGP peer. Use + --clear-md5-authentication-key to enable and + --no-clear-md5-authentication-key to disable. + --[no-]enable-ipv6 If IPv6 is enabled, the peer connection can be established with IPv6 route exchange. If disabled, no IPv6 route exchange is allowed on any @@ -80,6 +87,10 @@ OPTIONAL FLAGS the range 2600:2d00:0:2:0:0:0:0/64 or 2600:2d00:0:3:0:0:0:0/64 and must belong to same subnet as the interface address of the peer router. + --md5-authentication-key=MD5_AUTHENTICATION_KEY + The MD5 authentication key for this BGP peer. Maximum length is 80 + characters. Can contain only printable ASCII characters. + --peer-asn=PEER_ASN The BGP autonomous system number (ASN) for this BGP peer. Must be a 16-bit or 32-bit private ASN as defined in diff --git a/gcloud/alpha/compute/ssl-policies/create b/gcloud/alpha/compute/ssl-policies/create index 1bd64350d..07a238c04 100644 --- a/gcloud/alpha/compute/ssl-policies/create +++ b/gcloud/alpha/compute/ssl-policies/create @@ -6,7 +6,8 @@ SYNOPSIS gcloud alpha compute ssl-policies create SSL_POLICY [--custom-features=[CUSTOM_FEATURES,...]] [--description=DESCRIPTION] [--min-tls-version=MIN_TLS_VERSION; default="1.0"] - [--profile=PROFILE; default="COMPATIBLE"] [GCLOUD_WIDE_FLAG ...] + [--profile=PROFILE; default="COMPATIBLE"] [--global | --region=REGION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute ssl-policies create creates a new SSL policy. @@ -69,6 +70,15 @@ FLAGS Restricted profile. Supports a reduced set of SSL features, intended to meet stricter compliance requirements. + At most one of these can be specified: + + --global + If set, the SSL policy is global. + + --region=REGION + Region of the SSL policy to create. 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, diff --git a/gcloud/alpha/compute/ssl-policies/delete b/gcloud/alpha/compute/ssl-policies/delete index b4b28aa16..b4236dcc4 100644 --- a/gcloud/alpha/compute/ssl-policies/delete +++ b/gcloud/alpha/compute/ssl-policies/delete @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha compute ssl-policies delete SSL_POLICY [SSL_POLICY ...] - [GCLOUD_WIDE_FLAG ...] + [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute ssl-policies delete is used to delete one or @@ -22,6 +22,16 @@ POSITIONAL ARGUMENTS SSL_POLICY [SSL_POLICY ...] Names of the SSL policies to delete. +FLAGS + At most one of these can be specified: + + --global + If set, the SSL policies are global. + + --region=REGION + Region of the SSL policies to delete. 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, diff --git a/gcloud/alpha/compute/ssl-policies/describe b/gcloud/alpha/compute/ssl-policies/describe index 99a32fe1a..ed68ef9a7 100644 --- a/gcloud/alpha/compute/ssl-policies/describe +++ b/gcloud/alpha/compute/ssl-policies/describe @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha compute ssl-policies describe SSL_POLICY - [GCLOUD_WIDE_FLAG ...] + [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute ssl-policies describe is used to display all @@ -20,6 +20,16 @@ POSITIONAL ARGUMENTS SSL_POLICY Name of the SSL policy to describe. +FLAGS + At most one of these can be specified: + + --global + If set, the SSL policy is global. + + --region=REGION + Region of the SSL policy to describe. 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, diff --git a/gcloud/alpha/compute/ssl-policies/export b/gcloud/alpha/compute/ssl-policies/export index 66dc366a9..7096782f3 100644 --- a/gcloud/alpha/compute/ssl-policies/export +++ b/gcloud/alpha/compute/ssl-policies/export @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud alpha compute ssl-policies export SSL_POLICY - [--destination=DESTINATION] [GCLOUD_WIDE_FLAG ...] + [--destination=DESTINATION] [--global | --region=REGION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Exports an SSL policy's configuration to a file. This configuration @@ -20,6 +21,15 @@ FLAGS a schema describing the export/import format, see: $CLOUDSDKROOT/lib/googlecloudsdk/schemas/compute/alpha/SslPolicy.yaml. + At most one of these can be specified: + + --global + If set, the SSL policy is global. + + --region=REGION + Region of the SSL policy to export. 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, diff --git a/gcloud/alpha/compute/ssl-policies/import b/gcloud/alpha/compute/ssl-policies/import index 6bc14b3b9..d0f9339db 100644 --- a/gcloud/alpha/compute/ssl-policies/import +++ b/gcloud/alpha/compute/ssl-policies/import @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud alpha compute ssl-policies import SSL_POLICY [--source=SOURCE] - [GCLOUD_WIDE_FLAG ...] + [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) If the specified SSL policy already exists, it will be overwritten. @@ -24,6 +24,15 @@ FLAGS Note: $CLOUDSDKROOT represents the Google Cloud CLI's installation directory. + At most one of these can be specified: + + --global + If set, the SSL policy is global. + + --region=REGION + Region of the SSL policy to import. 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, diff --git a/gcloud/alpha/compute/ssl-policies/list b/gcloud/alpha/compute/ssl-policies/list index 5d23e5d0c..34af526f2 100644 --- a/gcloud/alpha/compute/ssl-policies/list +++ b/gcloud/alpha/compute/ssl-policies/list @@ -3,14 +3,19 @@ NAME policies SYNOPSIS - gcloud alpha compute ssl-policies list [--filter=EXPRESSION] - [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] - [GCLOUD_WIDE_FLAG ...] + gcloud alpha compute ssl-policies list [NAME ...] + [--regexp=REGEXP, -r REGEXP] [--global | --regions=[REGION,...]] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute ssl-policies list displays all Google Compute Engine SSL policies in a project. + By default, global SSL policies and SSL policies from all regions are + listed. The results can be narrowed down by providing the --global or + --regions flag. + EXAMPLES To list all SSL policies in a project in table form, run: @@ -20,6 +25,41 @@ EXAMPLES $ gcloud alpha compute ssl-policies list --uri + To list all global SSL policies in a project, run: + + $ gcloud alpha compute ssl-policies list --global + + To list all SSL policies in the us-central1 and europe-west1 regions, given + they are regional resources, run: + + $ gcloud alpha compute ssl-policies list \ + --filter="region:( europe-west1 us-central1 )" + +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: + + --global + If provided, only global resources are shown. + + --regions=[REGION,...] + If provided, only regional resources are shown. If arguments are + provided, only resources from the given regions are shown. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/alpha/compute/ssl-policies/list-available-features b/gcloud/alpha/compute/ssl-policies/list-available-features index d116562da..0afac4066 100644 --- a/gcloud/alpha/compute/ssl-policies/list-available-features +++ b/gcloud/alpha/compute/ssl-policies/list-available-features @@ -3,7 +3,7 @@ NAME features that can be specified in an SSL policy SYNOPSIS - gcloud alpha compute ssl-policies list-available-features + gcloud alpha compute ssl-policies list-available-features [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] @@ -18,6 +18,10 @@ DESCRIPTION balancer. SSL policies do not affect the connection between the load balancers and the backends. +FLAGS + --region=REGION + If provided, only features for the given region are shown. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/alpha/compute/ssl-policies/update b/gcloud/alpha/compute/ssl-policies/update index 74a64dfc9..22b3e0359 100644 --- a/gcloud/alpha/compute/ssl-policies/update +++ b/gcloud/alpha/compute/ssl-policies/update @@ -6,7 +6,7 @@ SYNOPSIS gcloud alpha compute ssl-policies update SSL_POLICY [--custom-features=[CUSTOM_FEATURES,...]] [--min-tls-version=MIN_TLS_VERSION] [--profile=PROFILE] - [GCLOUD_WIDE_FLAG ...] + [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute ssl-policies update is used to update SSL @@ -67,6 +67,15 @@ FLAGS Restricted profile. Supports a reduced set of SSL features, intended to meet stricter compliance requirements. + At most one of these can be specified: + + --global + If set, the SSL policy is global. + + --region=REGION + Region of the SSL policy to patch. 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, diff --git a/gcloud/alpha/compute/target-https-proxies/create b/gcloud/alpha/compute/target-https-proxies/create index f2a9da636..4b4570cdc 100644 --- a/gcloud/alpha/compute/target-https-proxies/create +++ b/gcloud/alpha/compute/target-https-proxies/create @@ -10,6 +10,7 @@ SYNOPSIS [--global | --region=REGION] [--global-ssl-certificates | --ssl-certificates-region=SSL_CERTIFICATES_REGION] + [--global-ssl-policy | --ssl-policy-region=SSL_POLICY_REGION] [--global-url-map | --url-map-region=URL_MAP_REGION] [GCLOUD_WIDE_FLAG ...] @@ -151,6 +152,15 @@ OPTIONAL FLAGS Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION. + At most one of these can be specified: + + --global-ssl-policy + If set, the SSL policy is global. + + --ssl-policy-region=SSL_POLICY_REGION + Region of the SSL policy to operate on. Overrides the default + compute/region property value for this command invocation. + At most one of these can be specified: --global-url-map diff --git a/gcloud/alpha/compute/target-https-proxies/import b/gcloud/alpha/compute/target-https-proxies/import index b0c22862d..b5c6b672a 100644 --- a/gcloud/alpha/compute/target-https-proxies/import +++ b/gcloud/alpha/compute/target-https-proxies/import @@ -10,11 +10,16 @@ DESCRIPTION (ALPHA) Imports a target HTTPS proxy's configuration from a file. EXAMPLES - A target HTTPS proxy can be imported by running: + A global target HTTPS proxy can be imported by running: $ gcloud alpha compute target-https-proxies import NAME \ --source= + A regional target HTTPS proxy can be imported by running: + + $ gcloud alpha compute target-https-proxies import NAME \ + --source= --region=REGION_NAME + POSITIONAL ARGUMENTS NAME Name of the target HTTPS proxy to import. diff --git a/gcloud/alpha/compute/target-https-proxies/update b/gcloud/alpha/compute/target-https-proxies/update index c9dae72f0..4b9420082 100644 --- a/gcloud/alpha/compute/target-https-proxies/update +++ b/gcloud/alpha/compute/target-https-proxies/update @@ -8,8 +8,8 @@ SYNOPSIS [[--certificate-map=CERTIFICATE_MAP : --clear-certificate-map] | --ssl-certificates=SSL_CERTIFICATE,[...] --global-ssl-certificates | --ssl-certificates-region=SSL_CERTIFICATES_REGION] - [--clear-ssl-policy | --ssl-policy=SSL_POLICY] - [--global | --region=REGION] + [--clear-ssl-policy | --ssl-policy=SSL_POLICY | --global-ssl-policy + | --ssl-policy-region=SSL_POLICY_REGION] [--global | --region=REGION] [--global-url-map | --url-map-region=URL_MAP_REGION] [GCLOUD_WIDE_FLAG ...] @@ -136,6 +136,15 @@ FLAGS and the HTTPS proxy load balancer. The SSL policy must exist and cannot be deleted while referenced by a target HTTPS proxy. + At most one of these can be specified: + + --global-ssl-policy + If set, the SSL policy is global. + + --ssl-policy-region=SSL_POLICY_REGION + Region of the SSL policy to operate on. Overrides the default + compute/region property value for this command invocation. + At most one of these can be specified: --global diff --git a/gcloud/alpha/compute/target-ssl-proxies/create b/gcloud/alpha/compute/target-ssl-proxies/create index f9e5c5ec3..5941386ec 100644 --- a/gcloud/alpha/compute/target-ssl-proxies/create +++ b/gcloud/alpha/compute/target-ssl-proxies/create @@ -8,6 +8,7 @@ SYNOPSIS : --ssl-certificates=SSL_CERTIFICATE,[...]) [--description=DESCRIPTION] [--proxy-header=PROXY_HEADER; default="NONE"] [--ssl-policy=SSL_POLICY] + [--global-ssl-policy | --ssl-policy-region=SSL_POLICY_REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -74,6 +75,15 @@ OPTIONAL FLAGS and the SSL proxy load balancer. The SSL policy must exist and cannot be deleted while referenced by a target SSL proxy. + At most one of these can be specified: + + --global-ssl-policy + If set, the SSL policy is global. + + --ssl-policy-region=SSL_POLICY_REGION + Region of the SSL 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, diff --git a/gcloud/alpha/compute/target-ssl-proxies/update b/gcloud/alpha/compute/target-ssl-proxies/update index 71aaa3e76..794342d0b 100644 --- a/gcloud/alpha/compute/target-ssl-proxies/update +++ b/gcloud/alpha/compute/target-ssl-proxies/update @@ -7,7 +7,8 @@ SYNOPSIS [--certificate-map=CERTIFICATE_MAP : --ssl-certificates=SSL_CERTIFICATE,[...] | --clear-ssl-certificates | --clear-certificate-map] - [--clear-ssl-policy | --ssl-policy=SSL_POLICY] [GCLOUD_WIDE_FLAG ...] + [--clear-ssl-policy | --ssl-policy=SSL_POLICY | --global-ssl-policy + | --ssl-policy-region=SSL_POLICY_REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute target-ssl-proxies update is used to replace @@ -81,6 +82,15 @@ FLAGS and the SSL proxy load balancer. The SSL policy must exist and cannot be deleted while referenced by a target SSL proxy. + At most one of these can be specified: + + --global-ssl-policy + If set, the SSL policy is global. + + --ssl-policy-region=SSL_POLICY_REGION + Region of the SSL 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, diff --git a/gcloud/alpha/database-migration/connection-profiles/list b/gcloud/alpha/database-migration/connection-profiles/list index 42bb40d32..1cddb474e 100644 --- a/gcloud/alpha/database-migration/connection-profiles/list +++ b/gcloud/alpha/database-migration/connection-profiles/list @@ -21,7 +21,7 @@ EXAMPLES $ gcloud alpha database-migration connection-profiles list \ --filter="state=READY" -REQUIRED FLAGS +FLAGS Region resource - The location you want to list the connection profiles for. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the @@ -31,8 +31,6 @@ REQUIRED FLAGS ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - --region=REGION ID of the region or fully qualified identifier for the region. To set the region attribute: diff --git a/gcloud/alpha/dataproc/clusters/gke/create b/gcloud/alpha/dataproc/clusters/gke/create new file mode 100644 index 000000000..21cdda024 --- /dev/null +++ b/gcloud/alpha/dataproc/clusters/gke/create @@ -0,0 +1,308 @@ +NAME + gcloud alpha dataproc clusters gke create - create a GKE-based virtual + cluster + +SYNOPSIS + gcloud alpha dataproc clusters gke create (CLUSTER : --region=REGION) + --spark-engine-version=SPARK_ENGINE_VERSION + (--gke-cluster=GKE_CLUSTER + : --gke-cluster-location=GKE_CLUSTER_LOCATION) [--async] + [--namespace=NAMESPACE] [--pools=[KEY=VALUE[;VALUE],...]] + [--properties=[PREFIX:PROPERTY=VALUE,...]] [--setup-workload-identity] + [--staging-bucket=STAGING_BUCKET] + [--history-server-cluster=HISTORY_SERVER_CLUSTER + : --history-server-cluster-region=HISTORY_SERVER_CLUSTER_REGION] + [--metastore-service=METASTORE_SERVICE + : --metastore-service-location=METASTORE_SERVICE_LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a GKE-based virtual cluster. + +EXAMPLES + Create a Dataproc on GKE cluster in us-central1 on a GKE cluster in the + same project and region with default values: + + $ gcloud alpha dataproc clusters gke create my-cluster \ + --region=us-central1 --gke-cluster=my-gke-cluster \ + --spark-engine-version=latest --pools='name=dp,roles=default' + + Create a Dataproc on GKE cluster in us-central1 on a GKE cluster in the + same project and zone us-central1-f with default values: + + $ gcloud alpha dataproc clusters gke create my-cluster \ + --region=us-central1 --gke-cluster=my-gke-cluster \ + --gke-cluster-location=us-central1-f \ + --spark-engine-version=3.1 --pools='name=dp,roles=default' + + Create a Dataproc on GKE cluster in us-central1 with machine type + 'e2-standard-4', autoscaling 5-15 nodes per zone. + + $ gcloud alpha dataproc clusters gke create my-cluster \ + --region='us-central1' \ + --gke-cluster='projects/my-project/locations/us-central1/cluster\ + s/my-gke-cluster' --spark-engine-version=dataproc-1.5 \ + --pools='name=dp-default,roles=default,machineType=e2-standard-4\ + ,min=5,max=15' + + Create a Dataproc on GKE cluster in us-central1 with two distinct node + pools. + + $ gcloud alpha dataproc clusters gke create my-cluster \ + --region='us-central1' --gke-cluster='my-gke-cluster' \ + --spark-engine-version='dataproc-2.0' \ + --pools='name=dp-default,roles=default,machineType=e2-standard-4\ + ' \ + --pools='name=workers,roles=spark-drivers;spark-executors,machin\ + eType=n2-standard-8 + +POSITIONAL ARGUMENTS + Cluster resource - The name of the cluster 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 cluster 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. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. To + set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --region=REGION + Dataproc region for the cluster. Each Dataproc region constitutes an + independent resource namespace constrained to deploying instances + into Compute Engine zones inside the region. Overrides the default + dataproc/region property value for this command invocation. To set + the region attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property dataproc/region. + +REQUIRED FLAGS + --spark-engine-version=SPARK_ENGINE_VERSION + The version of the Spark engine to run on this cluster. + + Gke cluster resource - The GKE cluster to install the Dataproc cluster on. + 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 --gke-cluster 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. + + --gke-cluster=GKE_CLUSTER + ID of the gke-cluster or fully qualified identifier for the + gke-cluster. To set the gke-cluster attribute: + ▸ provide the argument --gke-cluster on the command line. + + This flag must be specified if any of the other arguments in this + group are specified. + + --gke-cluster-location=GKE_CLUSTER_LOCATION + GKE region for the gke-cluster. To set the gke-cluster-location + attribute: + ▸ provide the argument --gke-cluster on the command line with a + fully specified name; + ▸ provide the argument --gke-cluster-location on the command line; + ▸ provide the argument --region on the command line; + ▸ set the property dataproc/region. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --namespace=NAMESPACE + The name of the Kubernetes namespace to deploy Dataproc system + components in. This namespace does not need to exist. + + --pools=[KEY=VALUE[;VALUE],...] + Each --pools flag represents a single GKE node pool associated with the + virtual cluster. It is comprised of a CSV in the form + KEY=VALUE[;VALUE], where certain keys may have multiple values. + + The following KEYs must be specified: + + KEY Type Example Description + name string `my-node-pool` Name of the node pool. + roles repeated string `default;spark-driver` Roles that this node + pool should perform. + Valid values are + `default`, + `controller`, + `spark-driver`, + `spark-executor`. + + The following KEYs may be specified. + + KEY Type Example Description + machineType string `n1-standard-8` Compute + Engine + machine type + to use. + preemptible boolean `false` If true, + then this + node pool + uses + preemptible + VMs. This + cannot be + true on the + node pool + with the + `controllers + ` role (or + `default` + role if + `controllers + ` role is + not + specified). + localSsdCount int `2` The number + of local + SSDs to + attach to + each node. + accelerator repeated string `nvidia-tesla-a100=1` Accelerators + to attach to + each node. + In the + format + NAME=COUNT. + minCpuPlatform string `Intel Skylake` Minimum CPU + platform for + each node. + locations repeated string `us-west1-a;us-west1-c` Zones within + the location + of the GKE + cluster. All + `--pools` + flags for a + single + Dataproc + cluster must + have + identical + locations. + min int `0` Minimum + number of + nodes per + zone that + this node + pool can + scale down + to. + max int `10` Maximum + number of + nodes per + zone that + this node + pool can + scale up to. + + --properties=[PREFIX:PROPERTY=VALUE,...] + Specifies configuration properties for installed packages, such as + Spark. Properties are mapped to configuration files by specifying a + prefix, such as "core:io.serializations". + + --setup-workload-identity + Sets up the GKE Workload Identity for your Dataproc on GKE cluster. + Note that running this requires elevated permissions as it will + manipulate IAM policies on the Google Service Accounts that will be + used by your Dataproc on GKE cluster. + + --staging-bucket=STAGING_BUCKET + The Cloud Storage bucket to use to stage job dependencies, + miscellaneous config files, and job driver console output when using + this cluster. + + History server cluster resource - A Dataproc Cluster created as a History + Server, see + https://cloud.google.com/dataproc/docs/concepts/jobs/history-server 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 --history-server-cluster on the command line + with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --history-server-cluster=HISTORY_SERVER_CLUSTER + ID of the history-server-cluster or fully qualified identifier for + the history-server-cluster. To set the history-server-cluster + attribute: + ▸ provide the argument --history-server-cluster on the command + line. + + This flag must be specified if any of the other arguments in this + group are specified. + + --history-server-cluster-region=HISTORY_SERVER_CLUSTER_REGION + Compute Engine region for the history-server-cluster. It must be the + same region as the Dataproc cluster that is being created. To set the + history-server-cluster-region attribute: + ▸ provide the argument --history-server-cluster on the command line + with a fully specified name; + ▸ provide the argument --history-server-cluster-region on the + command line; + ▸ provide the argument --region on the command line; + ▸ set the property dataproc/region. + + Metastore service resource - Dataproc Metastore Service to be used as an + external metastore. 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 --metastore-service on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --metastore-service=METASTORE_SERVICE + ID of the metastore-service or fully qualified identifier for the + metastore-service. To set the metastore-service attribute: + ▸ provide the argument --metastore-service on the command line. + + This flag must be specified if any of the other arguments in this + group are specified. + + --metastore-service-location=METASTORE_SERVICE_LOCATION + Dataproc Metastore location for the metastore-service. To set the + metastore-service-location attribute: + ▸ provide the argument --metastore-service on the command line with + a fully specified name; + ▸ provide the argument --metastore-service-location on the command + line; + ▸ provide the argument --region on the command line; + ▸ set the property dataproc/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 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 dataproc clusters gke create + + $ gcloud beta dataproc clusters gke create + diff --git a/gcloud/alpha/dataproc/clusters/gke/help b/gcloud/alpha/dataproc/clusters/gke/help new file mode 100644 index 000000000..351ec1cca --- /dev/null +++ b/gcloud/alpha/dataproc/clusters/gke/help @@ -0,0 +1,39 @@ +NAME + gcloud alpha dataproc clusters gke - create Dataproc GKE-based virtual + clusters + +SYNOPSIS + gcloud alpha dataproc clusters gke COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) All interactions other than creation should be handled by "gcloud + dataproc clusters" commands. + +EXAMPLES + To create a cluster, run: + + $ gcloud alpha dataproc clusters gke my-cluster \ + --region='us-central1' --gke-cluster='my-gke-cluster' \ + --spark-engine-version='latest' --pools='name=dp,roles=default' + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a GKE-based virtual cluster. + +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 dataproc clusters gke + + $ gcloud beta dataproc clusters gke + diff --git a/gcloud/alpha/dataproc/clusters/help b/gcloud/alpha/dataproc/clusters/help index ffb749ffd..2668e08a0 100644 --- a/gcloud/alpha/dataproc/clusters/help +++ b/gcloud/alpha/dataproc/clusters/help @@ -37,6 +37,12 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +GROUPS + GROUP is one of the following: + + gke + (ALPHA) Create Dataproc GKE-based virtual clusters. + COMMANDS COMMAND is one of the following: diff --git a/gcloud/alpha/edge-cloud/help b/gcloud/alpha/edge-cloud/help index 9aa000a98..9388f9a21 100644 --- a/gcloud/alpha/edge-cloud/help +++ b/gcloud/alpha/edge-cloud/help @@ -18,6 +18,9 @@ GROUPS container (ALPHA) Manage Edge Container resources. + networking + (ALPHA) Manage Distributed Cloud Edge Network resources. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/edge-cloud/networking/help b/gcloud/alpha/edge-cloud/networking/help new file mode 100644 index 000000000..6cbcc14a6 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/help @@ -0,0 +1,40 @@ +NAME + gcloud alpha edge-cloud networking - manage Distributed Cloud Edge Network + resources + +SYNOPSIS + gcloud alpha edge-cloud networking GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Distributed Cloud Edge Network resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + interconnects + (ALPHA) Manage Distributed Cloud Edge Network interconnects. + + networks + (ALPHA) Manage Distributed Cloud Edge Network networks. + + operations + (ALPHA) Command group for working with Distributed Cloud Edge Network + operations. + + routers + (ALPHA) Manage Distributed Cloud Edge Network routers. + + subnets + (ALPHA) Manage Distributed Cloud Edge Network subnets. + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/dedicated/create b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/dedicated/create new file mode 100644 index 000000000..6695512e9 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/dedicated/create @@ -0,0 +1,110 @@ +NAME + gcloud alpha edge-cloud networking interconnects attachments dedicated + create - create a Distributed Cloud Edge Network interconnect + attachment + +SYNOPSIS + gcloud alpha edge-cloud networking interconnects attachments dedicated + create (INTERCONNECT_ATTACHMENT : --location=LOCATION --zone=ZONE) + --interconnect=INTERCONNECT --router=ROUTER --vlan-id=VLAN_ID [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--mtu=MTU] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a new dedicated Distributed Cloud Edge Network interconnect + attachment. + +EXAMPLES + To create a dedicated interconnect attachment called 'my-attachment' in + edge zone 'us-central1-edge-den1', run: + + $ gcloud alpha edge-cloud networking interconnects attachments \ + dedicated create my-attachment --location=us-central1 \ + --zone=us-central1-edge-den1 --interconnect=INTERCONNECT-LINK1 \ + --router=my-edge-router --vlan-id=200 --mtu=1500 + +POSITIONAL ARGUMENTS + Interconnect attachment resource - Distributed Cloud Edge Network + interconnectAttachment 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 interconnect_attachment 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. + + INTERCONNECT_ATTACHMENT + ID of the interconnect attachment or fully qualified identifier for + the interconnect attachment. To set the interconnect_attachment + attribute: + ▸ provide the argument interconnect_attachment on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument interconnect_attachment on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument interconnect_attachment on the command line + with a fully specified name; + ▸ provide the argument --zone on the command line. + +REQUIRED FLAGS + --interconnect=INTERCONNECT + The underlying interconnect object that this attachment's traffic will + traverse through. + + --router=ROUTER + The router to use for dynamic routing. + + --vlan-id=VLAN_ID + The ID of the vlan to tag the subnetwork. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + An optional, textual description for the interconnect attachment. + + --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. + + --mtu=MTU + Maximum transmission unit (MTU) is the size of the largest IP packet + that can be transmitted on this attachment. Default value is 1500 + bytes, and the valid values are 1500 and 9000. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/dedicated/help b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/dedicated/help new file mode 100644 index 000000000..efe199268 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/dedicated/help @@ -0,0 +1,31 @@ +NAME + gcloud alpha edge-cloud networking interconnects attachments dedicated - + manage Distributed Cloud Edge Network dedicated interconnect + attachments + +SYNOPSIS + gcloud alpha edge-cloud networking interconnects attachments dedicated + COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Distributed Cloud Edge Network dedicated interconnect + attachments. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a Distributed Cloud Edge Network interconnect + attachment. + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/delete b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/delete new file mode 100644 index 000000000..236957f5e --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/delete @@ -0,0 +1,78 @@ +NAME + gcloud alpha edge-cloud networking interconnects attachments delete - + delete a Distributed Cloud Edge Network interconnect attachment + +SYNOPSIS + gcloud alpha edge-cloud networking interconnects attachments delete + (INTERCONNECT_ATTACHMENT : --location=LOCATION --zone=ZONE) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a Distributed Cloud Edge Network interconnect attachment. + +EXAMPLES + To delete an interconnect attachment called 'my-attachment' in edge zone + 'us-central1-edge-den1', run: + + $ gcloud alpha edge-cloud networking interconnects attachments \ + delete my-attachment --location=us-central1 \ + --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Interconnect attachment resource - Distributed Cloud Edge Network + interconnectAttachment 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 interconnect_attachment 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. + + INTERCONNECT_ATTACHMENT + ID of the interconnect attachment or fully qualified identifier for + the interconnect attachment. To set the interconnect_attachment + attribute: + ▸ provide the argument interconnect_attachment on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument interconnect_attachment on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument interconnect_attachment on the command line + with a fully specified name; + ▸ provide the argument --zone on the command line. + +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. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/describe b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/describe new file mode 100644 index 000000000..6d44da9ec --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/describe @@ -0,0 +1,75 @@ +NAME + gcloud alpha edge-cloud networking interconnects attachments describe - + show details about a Distributed Cloud Edge Network interconnect + attachment + +SYNOPSIS + gcloud alpha edge-cloud networking interconnects attachments describe + (INTERCONNECT_ATTACHMENT : --location=LOCATION --zone=ZONE) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details about a Distributed Cloud Edge Network interconnect + attachment. + +EXAMPLES + To show details about an interconnect attachment called 'my-attachment' in + edge zone 'us-central1-edge-den1', run: + + $ gcloud alpha edge-cloud networking interconnects attachments \ + describe my-attachment --location=us-central1 \ + --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Interconnect attachment resource - The interconnect attachment you want to + describe. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument interconnect_attachment 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. + + INTERCONNECT_ATTACHMENT + ID of the interconnect attachment or fully qualified identifier for + the interconnect attachment. To set the interconnect_attachment + attribute: + ▸ provide the argument interconnect_attachment on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument interconnect_attachment on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument interconnect_attachment on the command line + with a fully specified name; + ▸ provide the argument --zone on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/help b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/help new file mode 100644 index 000000000..8be0760f5 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/help @@ -0,0 +1,43 @@ +NAME + gcloud alpha edge-cloud networking interconnects attachments - manage + Distributed Cloud Edge Network interconnect attachments + +SYNOPSIS + gcloud alpha edge-cloud networking interconnects attachments + GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Distributed Cloud Edge Network interconnect attachments. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + dedicated + (ALPHA) Manage Distributed Cloud Edge Network dedicated interconnect + attachments. + +COMMANDS + COMMAND is one of the following: + + delete + (ALPHA) Delete a Distributed Cloud Edge Network interconnect + attachment. + + describe + (ALPHA) Show details about a Distributed Cloud Edge Network + interconnect attachment. + + list + (ALPHA) List Distributed Cloud Edge Network interconnect attachments. + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/attachments/list b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/list new file mode 100644 index 000000000..ec910d9bc --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/interconnects/attachments/list @@ -0,0 +1,97 @@ +NAME + gcloud alpha edge-cloud networking interconnects attachments list - list + Distributed Cloud Edge Network interconnect attachments + +SYNOPSIS + gcloud alpha edge-cloud networking interconnects attachments list + (--zone=ZONE : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Distributed Cloud Edge Network interconnect attachments. + +EXAMPLES + To list the interconnect attachments in edge zone 'us-central1-edge-den1', + run: + + $ gcloud alpha edge-cloud networking interconnects attachments \ + list --location=us-central1 --zone=us-central1-edge-den1 + +REQUIRED FLAGS + Zone resource - Parent Distributed Cloud Edge Network zone to list all + contained Distributed Cloud Edge Network interconnect attachments. 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 --zone 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. + + --zone=ZONE + ID of the zone or fully qualified identifier for the zone. To set the + zone attribute: + ▸ provide the argument --zone on the command line. + + This flag must be specified if any of the other arguments in this + group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument --zone on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/describe b/gcloud/alpha/edge-cloud/networking/interconnects/describe new file mode 100644 index 000000000..f8ebce334 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/interconnects/describe @@ -0,0 +1,70 @@ +NAME + gcloud alpha edge-cloud networking interconnects describe - show details + about the Distributed Cloud Edge Network interconnect + +SYNOPSIS + gcloud alpha edge-cloud networking interconnects describe + (INTERCONNECT : --location=LOCATION --zone=ZONE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details about the Distributed Cloud Edge Network interconnect. + +EXAMPLES + To show details about an interconnect called 'my-interconnect1' in edge + zone 'us-central1-edge-den1', run: + + $ gcloud alpha edge-cloud networking interconnects describe \ + my-interconnect1 --location=us-central1 \ + --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Interconnect resource - The interconnect you want to describe. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument interconnect 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. + + INTERCONNECT + ID of the interconnect or fully qualified identifier for the + interconnect. To set the interconnect attribute: + ▸ provide the argument interconnect on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument interconnect on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument interconnect on the command line with a + fully specified name; + ▸ provide the argument --zone on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/help b/gcloud/alpha/edge-cloud/networking/interconnects/help new file mode 100644 index 000000000..703fd206b --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/interconnects/help @@ -0,0 +1,38 @@ +NAME + gcloud alpha edge-cloud networking interconnects - manage Distributed Cloud + Edge Network interconnects + +SYNOPSIS + gcloud alpha edge-cloud networking interconnects GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Distributed Cloud Edge Network interconnects. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + attachments + (ALPHA) Manage Distributed Cloud Edge Network interconnect attachments. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Show details about the Distributed Cloud Edge Network + interconnect. + + list + (ALPHA) List Distributed Cloud Edge Network interconnects. + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/interconnects/list b/gcloud/alpha/edge-cloud/networking/interconnects/list new file mode 100644 index 000000000..068f8abe6 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/interconnects/list @@ -0,0 +1,97 @@ +NAME + gcloud alpha edge-cloud networking interconnects list - list Distributed + Cloud Edge Network interconnects + +SYNOPSIS + gcloud alpha edge-cloud networking interconnects list + (--zone=ZONE : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Distributed Cloud Edge Network interconnects. + +EXAMPLES + To list the Distributed Cloud Edge Network interconnects in edge zone + 'us-central1-edge-den1', run: + + $ gcloud alpha edge-cloud networking interconnects list \ + --location=us-central1 --zone=us-central1-edge-den1 + +REQUIRED FLAGS + Zone resource - Parent Distributed Cloud Edge Network zone to list all + contained Distributed Cloud Edge Network interconnects. 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 --zone 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. + + --zone=ZONE + ID of the zone or fully qualified identifier for the zone. To set the + zone attribute: + ▸ provide the argument --zone on the command line. + + This flag must be specified if any of the other arguments in this + group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument --zone on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/networks/create b/gcloud/alpha/edge-cloud/networking/networks/create new file mode 100644 index 000000000..07b55c485 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/networks/create @@ -0,0 +1,92 @@ +NAME + gcloud alpha edge-cloud networking networks create - create a Edge Network + network + +SYNOPSIS + gcloud alpha edge-cloud networking networks create + (NETWORK : --location=LOCATION --zone=ZONE) [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--mtu=MTU] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a new Edge Network network resource. + +EXAMPLES + To create a network called 'my-network' with MTU value of 9000 bytes in + edge zone 'us-central1-edge-den1', run: + + $ gcloud alpha edge-cloud networking networks create my-network \ + --location=us-central1 --zone=den1 --mtu=9000 + +POSITIONAL ARGUMENTS + Network resource - Edge Network network 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 network 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. + + NETWORK + ID of the network or fully qualified identifier for the network. To + set the network attribute: + ▸ provide the argument network on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument network on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument network on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + An optional, textual description for the network. + + --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. + + --mtu=MTU + Maximum transmission unit (MTU) is the size of the largest IP packet + that can be transmitted on this network. Default value is 1500 bytes, + and the valid values are 1500 and 9000. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/networks/delete b/gcloud/alpha/edge-cloud/networking/networks/delete new file mode 100644 index 000000000..921152438 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/networks/delete @@ -0,0 +1,75 @@ +NAME + gcloud alpha edge-cloud networking networks delete - delete a Edge Network + network + +SYNOPSIS + gcloud alpha edge-cloud networking networks delete + (NETWORK : --location=LOCATION --zone=ZONE) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a Edge Network network. + +EXAMPLES + To delete a network called 'my-network' in edge zone + 'us-central1-edge-den1', run: + + $ gcloud alpha edge-cloud networking networks delete my-network \ + --location=us-central1 --zone=den1 + +POSITIONAL ARGUMENTS + Network resource - Edge Network network 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 network 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. + + NETWORK + ID of the network or fully qualified identifier for the network. To + set the network attribute: + ▸ provide the argument network on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument network on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument network on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +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. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/networks/describe b/gcloud/alpha/edge-cloud/networking/networks/describe new file mode 100644 index 000000000..bf448ba0b --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/networks/describe @@ -0,0 +1,69 @@ +NAME + gcloud alpha edge-cloud networking networks describe - show details about + the Edge Network network + +SYNOPSIS + gcloud alpha edge-cloud networking networks describe + (NETWORK : --location=LOCATION --zone=ZONE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details about the Edge Network network. + +EXAMPLES + To show details about a network called 'my-network' in edge zone + 'us-central1-edge-den1', run: + + $ gcloud alpha edge-cloud networking networks describe my-network \ + --location=us-central1 --zone=den1 + +POSITIONAL ARGUMENTS + Network resource - The Edge Network network you want to describe. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument network 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. + + NETWORK + ID of the network or fully qualified identifier for the network. To + set the network attribute: + ▸ provide the argument network on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument network on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument network on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/networks/help b/gcloud/alpha/edge-cloud/networking/networks/help new file mode 100644 index 000000000..bdf14f5d7 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/networks/help @@ -0,0 +1,36 @@ +NAME + gcloud alpha edge-cloud networking networks - manage Distributed Cloud Edge + Network networks + +SYNOPSIS + gcloud alpha edge-cloud networking networks COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Distributed Cloud Edge Network networks. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a Edge Network network. + + delete + (ALPHA) Delete a Edge Network network. + + describe + (ALPHA) Show details about the Edge Network network. + + list + (ALPHA) List Edge Network networks. + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/networks/list b/gcloud/alpha/edge-cloud/networking/networks/list new file mode 100644 index 000000000..d7c95edc5 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/networks/list @@ -0,0 +1,97 @@ +NAME + gcloud alpha edge-cloud networking networks list - list Edge Network + networks + +SYNOPSIS + gcloud alpha edge-cloud networking networks list + (--zone=ZONE : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Edge Network networks. + +EXAMPLES + To list the Edge Network networks in edge zone 'us-central1-edge-den1', + run: + + $ gcloud alpha edge-cloud networking networks list \ + --location=us-central1 --zone=us-central1-edge-den1 + +REQUIRED FLAGS + Zone resource - Parent Distributed Cloud Edge Network zone to list all + contained Distributed Cloud Edge Network networks. 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 --zone 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. + + --zone=ZONE + ID of the zone or fully qualified identifier for the zone. To set the + zone attribute: + ▸ provide the argument --zone on the command line. + + This flag must be specified if any of the other arguments in this + group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument --zone on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/operations/describe b/gcloud/alpha/edge-cloud/networking/operations/describe new file mode 100644 index 000000000..946f9be10 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/operations/describe @@ -0,0 +1,63 @@ +NAME + gcloud alpha edge-cloud networking operations describe - get description of + a long-running edge network operation + +SYNOPSIS + gcloud alpha edge-cloud networking operations describe + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Get information about a long-running edge network operation. + +EXAMPLES + To get information about a long-running operation with name + 'projects/my-project/locations/us-east1/operations/123', run the following + command: + + $ gcloud alpha edge-cloud networking operations describe \ + projects/my-project/locations/us-east1/operations/123 + +POSITIONAL ARGUMENTS + Operation resource - The ID of 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; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + 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 must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. 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. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/operations/help b/gcloud/alpha/edge-cloud/networking/operations/help new file mode 100644 index 000000000..91fad0d11 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/operations/help @@ -0,0 +1,32 @@ +NAME + gcloud alpha edge-cloud networking operations - command group for working + with Distributed Cloud Edge Network operations + +SYNOPSIS + gcloud alpha edge-cloud networking operations COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Command group for working with Distributed Cloud Edge Network + operations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Get description of a long-running edge network operation. + + wait + (ALPHA) Poll long-running edge network operation until it completes. + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/operations/wait b/gcloud/alpha/edge-cloud/networking/operations/wait new file mode 100644 index 000000000..e66eab8ea --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/operations/wait @@ -0,0 +1,65 @@ +NAME + gcloud alpha edge-cloud networking operations wait - poll long-running edge + network operation until it completes + +SYNOPSIS + gcloud alpha edge-cloud networking operations wait + (OPERATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Poll a long-running edge network operation until it completes. When + the operation is complete, this command will display the results of the + analysis. + +EXAMPLES + To poll a long-running edge network operation named + 'projects/my-project/locations/us-east1/operations/123' until it completes, + run the following: + + $ gcloud alpha edge-cloud networking operations wait \ + projects/my-project/locations/us-east1/operations/123 + +POSITIONAL ARGUMENTS + Operation resource - ID for the operation to poll until complete. 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; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + 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 must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. 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. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/routers/add-bgp-peer b/gcloud/alpha/edge-cloud/networking/routers/add-bgp-peer new file mode 100644 index 000000000..65c43af70 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/routers/add-bgp-peer @@ -0,0 +1,88 @@ +NAME + gcloud alpha edge-cloud networking routers add-bgp-peer - add a BGP peer to + a Distributed Cloud Edge Network router + +SYNOPSIS + gcloud alpha edge-cloud networking routers add-bgp-peer + (ROUTER : --location=LOCATION --zone=ZONE) --interface=INTERFACE + --peer-asn=PEER_ASN --peer-ipv4-range=PEER_IPV4_RANGE + --peer-name=PEER_NAME [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a BGP peer to a Distributed Cloud Edge Network router + +EXAMPLES + To create and add a BGP peer for the Distributed Cloud Edge Network router + 'my-router' in edge zone 'us-central1-edge-den1' , run: + + $ gcloud alpha edge-cloud networking routers add-bgp-peer \ + my-router --interface=my-int-r1 --peer-asn=33333 \ + --peer-name=peer1 --peer-ipv4-range=208.117.254.232/31 \ + --location=us-central1 --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Router resource - The router to which we add a bgp peer. 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 router 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. + + ROUTER + ID of the router or fully qualified identifier for the router. To set + the router attribute: + ▸ provide the argument router on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The Cloud location for the router. To set the location attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The zone of the router. To set the zone attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +REQUIRED FLAGS + --interface=INTERFACE + The name of the interface for this BGP peer. + + --peer-asn=PEER_ASN + The BGP autonomous system number (ASN) for this BGP peer. Must be a + 16-bit or 32-bit private ASN as defined in + https://tools.ietf.org/html/rfc6996, for example --asn=64512. + + --peer-ipv4-range=PEER_IPV4_RANGE + The link-local address range of the peer router. + + --peer-name=PEER_NAME + The name of the new BGP peer being added. + +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 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. + diff --git a/gcloud/alpha/edge-cloud/networking/routers/add-interface b/gcloud/alpha/edge-cloud/networking/routers/add-interface new file mode 100644 index 000000000..524b97c07 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/routers/add-interface @@ -0,0 +1,108 @@ +NAME + gcloud alpha edge-cloud networking routers add-interface - add an interface + to a Distributed Cloud Edge Network router + +SYNOPSIS + gcloud alpha edge-cloud networking routers add-interface + (ROUTER : --location=LOCATION --zone=ZONE) + --interface-name=INTERFACE_NAME + (--subnetwork=SUBNETWORK + | --interconnect-attachment=INTERCONNECT_ATTACHMENT + --ip-address=IP_ADDRESS --ip-mask-length=IP_MASK_LENGTH) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create an interface to a Distributed Cloud Edge Network router. + +EXAMPLES + To create and add a northbound interface for Distributed Cloud Edge Network + router 'my-router' in edge zone 'us-central1-edge-den1' , run: + + $ gcloud alpha edge-cloud networking routers add-interface \ + my-router --interface-name=my-int-r1 \ + --interconnect-attachment=my-link-attachment \ + --ip-address=208.117.254.233 --ip-mask-length=31 \ + --location=us-central1 --zone=us-central1-edge-den1 + + To create and add a southbound interface for Distributed Cloud Edge Network + router 'my-router' in edge zone 'us-central1-edge-den1', run: + + $ gcloud alpha edge-cloud networking routers add-interface \ + my-router --interface-name=my-int-r2 --subnetwork=my-subnet \ + --location=us-central1 --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Router resource - The router to which we add an interface. 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 router 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. + + ROUTER + ID of the router or fully qualified identifier for the router. To set + the router attribute: + ▸ provide the argument router on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The Cloud location for the router. To set the location attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The zone of the router. To set the zone attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +REQUIRED FLAGS + --interface-name=INTERFACE_NAME + The name of the interface being added. + + The argument group for configuring the interface for the router. + + Exactly one of these must be specified: + + --subnetwork=SUBNETWORK + The subnetwork of the interface being added. + + The argument group for adding northbound interface to edge router + + --interconnect-attachment=INTERCONNECT_ATTACHMENT + The interconnect attachment of the interface being added. + + --ip-address=IP_ADDRESS + The link local address of the router for this interface. + + --ip-mask-length=IP_MASK_LENGTH + The subnet mask for the link-local IP range of the interface. The + interface IP address and BGP peer IP address must be selected from + the subnet defined by this link-local range. + +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 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. + diff --git a/gcloud/alpha/edge-cloud/networking/routers/create b/gcloud/alpha/edge-cloud/networking/routers/create new file mode 100644 index 000000000..1de603bac --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/routers/create @@ -0,0 +1,101 @@ +NAME + gcloud alpha edge-cloud networking routers create - create a Distributed + Cloud Edge Network router + +SYNOPSIS + gcloud alpha edge-cloud networking routers create + (ROUTER : --location=LOCATION --zone=ZONE) --asn=ASN --network=NETWORK + [--async] [--description=DESCRIPTION] + [--keepalive-interval-in-seconds=KEEPALIVE_INTERVAL_IN_SECONDS] + [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a new Distributed Cloud Edge Network router. + +EXAMPLES + To create a router called 'my-router' with asn 65555 in edge zone + 'us-central1-edge-den1', run: + + $ gcloud alpha edge-cloud networking routers create my-router \ + --network=my-network --location=us-central1 \ + --zone=us-central1-edge-den1 --asn=65555 \ + --keepalive-interval-in-seconds=20 + +POSITIONAL ARGUMENTS + Router resource - Distributed Cloud Edge Network router 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 router 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. + + ROUTER + ID of the router or fully qualified identifier for the router. To set + the router attribute: + ▸ provide the argument router on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +REQUIRED FLAGS + --asn=ASN + The locally assigned BGP ASN. + + --network=NETWORK + The network that this subnetwork belongs to. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + An optional, textual description for the subnet. + + --keepalive-interval-in-seconds=KEEPALIVE_INTERVAL_IN_SECONDS + The interval in seconds between BGP keepalive messages that are sent to + the peer. + + --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. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/routers/delete b/gcloud/alpha/edge-cloud/networking/routers/delete new file mode 100644 index 000000000..20362f07a --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/routers/delete @@ -0,0 +1,75 @@ +NAME + gcloud alpha edge-cloud networking routers delete - delete a Distributed + Cloud Edge Network router + +SYNOPSIS + gcloud alpha edge-cloud networking routers delete + (ROUTER : --location=LOCATION --zone=ZONE) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a Distributed Cloud Edge Network router. + +EXAMPLES + To delete a router called 'my-router' in edge zone 'us-central1-edge-den1', + run: + + $ gcloud alpha edge-cloud networking routers delete my-router \ + --location=us-central1 --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Router resource - Distributed Cloud Edge Network router 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 router 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. + + ROUTER + ID of the router or fully qualified identifier for the router. To set + the router attribute: + ▸ provide the argument router on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +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. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/routers/describe b/gcloud/alpha/edge-cloud/networking/routers/describe new file mode 100644 index 000000000..b188bffe8 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/routers/describe @@ -0,0 +1,69 @@ +NAME + gcloud alpha edge-cloud networking routers describe - show details about + the Distributed Cloud Edge Network router + +SYNOPSIS + gcloud alpha edge-cloud networking routers describe + (ROUTER : --location=LOCATION --zone=ZONE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details about the Distributed Cloud Edge Network router. + +EXAMPLES + To show details about a router named 'my-router' in edge zone + 'us-central1-edge-den1', run: + + $ gcloud alpha edge-cloud networking routers describe my-router \ + --location=us-central1 --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Router resource - The router you want to describe. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: + ◆ provide the argument router 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. + + ROUTER + ID of the router or fully qualified identifier for the router. To set + the router attribute: + ▸ provide the argument router on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/routers/help b/gcloud/alpha/edge-cloud/networking/routers/help new file mode 100644 index 000000000..7cda5f9c4 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/routers/help @@ -0,0 +1,50 @@ +NAME + gcloud alpha edge-cloud networking routers - manage Distributed Cloud Edge + Network routers + +SYNOPSIS + gcloud alpha edge-cloud networking routers COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Distributed Cloud Edge Network routers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + add-bgp-peer + (ALPHA) Add a BGP peer to a Distributed Cloud Edge Network router. + + add-interface + (ALPHA) Add an interface to a Distributed Cloud Edge Network router. + + create + (ALPHA) Create a Distributed Cloud Edge Network router. + + delete + (ALPHA) Delete a Distributed Cloud Edge Network router. + + describe + (ALPHA) Show details about the Distributed Cloud Edge Network router. + + list + (ALPHA) List Distributed Cloud Edge Network routers. + + remove-bgp-peer + (ALPHA) Remove a list of BGP peers from a Distributed Cloud Edge + Network router. + + remove-interface + (ALPHA) remove a list of interfaces on a Distributed Cloud Edge Network + router. + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/routers/list b/gcloud/alpha/edge-cloud/networking/routers/list new file mode 100644 index 000000000..f1b6739ec --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/routers/list @@ -0,0 +1,96 @@ +NAME + gcloud alpha edge-cloud networking routers list - list Distributed Cloud + Edge Network routers + +SYNOPSIS + gcloud alpha edge-cloud networking routers list + (--zone=ZONE : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Distributed Cloud Edge Network routers. + +EXAMPLES + To list the routers in edge zone 'us-central1-edge-den1', run: + + $ gcloud alpha edge-cloud networking routers list \ + --location=us-central1 --zone=us-central1-edge-den1 + +REQUIRED FLAGS + Zone resource - Parent Distributed Cloud Edge Network zone to list all + contained Distributed Cloud Edge Network routers. 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 --zone 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. + + --zone=ZONE + ID of the zone or fully qualified identifier for the zone. To set the + zone attribute: + ▸ provide the argument --zone on the command line. + + This flag must be specified if any of the other arguments in this + group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument --zone on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/routers/remove-bgp-peer b/gcloud/alpha/edge-cloud/networking/routers/remove-bgp-peer new file mode 100644 index 000000000..56be25463 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/routers/remove-bgp-peer @@ -0,0 +1,78 @@ +NAME + gcloud alpha edge-cloud networking routers remove-bgp-peer - remove a list + of BGP peers from a Distributed Cloud Edge Network router + +SYNOPSIS + gcloud alpha edge-cloud networking routers remove-bgp-peer + (ROUTER : --location=LOCATION --zone=ZONE) + --peer-names=[BGP_PEER_NAME,...] [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a list of BGP peers from a Distributed Cloud Edge Network + router + +EXAMPLES + To delete a list of BGP peers contains 'peer1' and 'peer2' from the + Distributed Cloud Edge Network router 'my-router' in edge zone + 'us-central1-edge-den1' , run: + + $ gcloud alpha edge-cloud networking routers remove-bgp-peer \ + my-router --peer-names=peer1,peer2 --location=us-central1 \ + --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Router resource - The router from which we delete a list of bgp peers. 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 router 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. + + ROUTER + ID of the router or fully qualified identifier for the router. To set + the router attribute: + ▸ provide the argument router on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The Cloud location for the router. To set the location attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The zone of the router. To set the zone attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +REQUIRED FLAGS + --peer-names=[BGP_PEER_NAME,...] + The list of names for peers being removed. Only single value allowed + currently. + +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 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. + diff --git a/gcloud/alpha/edge-cloud/networking/routers/remove-interface b/gcloud/alpha/edge-cloud/networking/routers/remove-interface new file mode 100644 index 000000000..edf404043 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/routers/remove-interface @@ -0,0 +1,76 @@ +NAME + gcloud alpha edge-cloud networking routers remove-interface - remove a list + of interfaces on a Distributed Cloud Edge Network router + +SYNOPSIS + gcloud alpha edge-cloud networking routers remove-interface + (ROUTER : --location=LOCATION --zone=ZONE) + --interface-names=[INTERFACE_NAME,...] [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Remove a list of interfaces on a Distributed Cloud Edge Network + router. + +EXAMPLES + To remove a list of interfaces contains 'my-int-r1' on Distributed Cloud + Edge Network router 'my-router' in edge zone 'us-central1-edge-den1' , run: + + $ gcloud alpha edge-cloud networking routers remove-interface \ + my-router --interface-names=my-int-r1 --location=us-central1 \ + --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Router resource - The router from which we remove a list of interfaces. + 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 router 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. + + ROUTER + ID of the router or fully qualified identifier for the router. To set + the router attribute: + ▸ provide the argument router on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The Cloud location for the router. To set the location attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --zone=ZONE + The zone of the router. To set the zone attribute: + ▸ provide the argument router on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +REQUIRED FLAGS + --interface-names=[INTERFACE_NAME,...] + The list of names for interfaces being removed. + +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 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. + diff --git a/gcloud/alpha/edge-cloud/networking/subnets/create b/gcloud/alpha/edge-cloud/networking/subnets/create new file mode 100644 index 000000000..f93f2ac6c --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/subnets/create @@ -0,0 +1,108 @@ +NAME + gcloud alpha edge-cloud networking subnets create - create a Distributed + Cloud Edge Network subnet + +SYNOPSIS + gcloud alpha edge-cloud networking subnets create + (SUBNET : --location=LOCATION --zone=ZONE) + --ipv4-range=[IPV4_RANGE,...] --network=NETWORK [--async] + [--description=DESCRIPTION] [--ipv6-range=[IPV6_RANGE,...]] + [--labels=[KEY=VALUE,...]] [--vlan-id=VLAN_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a new Distributed Cloud Edge Network subnet. + +EXAMPLES + To create a Distributed Cloud Edge Network subnet called 'my-subnet' with + vlan id and owned ip ranges specified in the edge zone + 'us-central1-edge-den1', run: + + $ gcloud alpha edge-cloud networking subnets create my-subnet \ + --network=my-network --location=us-central1 \ + --zone=us-central1-edge-den1 \ + --ipv4-range=192.168.1.1/24,172.10.10.1/24 \ + --ipv6-range=2001:db8::1/64,4001:230::1/64 --vlan-id=100 + +POSITIONAL ARGUMENTS + Subnet resource - Distributed Cloud Edge Network subnet 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 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 must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. 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. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument subnet on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +REQUIRED FLAGS + --ipv4-range=[IPV4_RANGE,...] + The ranges of ipv4 addresses that are owned by this subnetwork in CIDR + format. + + --network=NETWORK + The network that this subnetwork belongs to. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + An optional, textual description for the subnet. + + --ipv6-range=[IPV6_RANGE,...] + The ranges of ipv6 addresses that are owned by this subnetwork in CIDR + format. + + --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. + + --vlan-id=VLAN_ID + The ID of the vlan to tag the subnetwork. If not specified we assign + one automatically. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/subnets/delete b/gcloud/alpha/edge-cloud/networking/subnets/delete new file mode 100644 index 000000000..0e9c9d010 --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/subnets/delete @@ -0,0 +1,75 @@ +NAME + gcloud alpha edge-cloud networking subnets delete - delete a Distributed + Cloud Edge Network subnet + +SYNOPSIS + gcloud alpha edge-cloud networking subnets delete + (SUBNET : --location=LOCATION --zone=ZONE) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a Distributed Cloud Edge Network subnet. + +EXAMPLES + To delete a subnet called 'my-subnet' in the edge zone + 'us-central1-edge-den1', run: + + $ gcloud alpha edge-cloud networking subnets delete my-subnet \ + --location=us-central1 --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Subnet resource - Distributed Cloud Edge Network subnet 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 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 must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. 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. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument subnet on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +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. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/subnets/describe b/gcloud/alpha/edge-cloud/networking/subnets/describe new file mode 100644 index 000000000..3a35495fe --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/subnets/describe @@ -0,0 +1,69 @@ +NAME + gcloud alpha edge-cloud networking subnets describe - show details about + the Distributed Cloud Edge Network subnet + +SYNOPSIS + gcloud alpha edge-cloud networking subnets describe + (SUBNET : --location=LOCATION --zone=ZONE) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details about the Distributed Cloud Edge Network subnet. + +EXAMPLES + To show details about a subnet named 'my-subnet' in the edge zone + 'us-central1-edge-den1', run: + + $ gcloud alpha edge-cloud networking subnets describe my-subnet \ + --location=us-central1 --zone=us-central1-edge-den1 + +POSITIONAL ARGUMENTS + Subnet resource - The subnet you want to describe. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. To set the project attribute: + ◆ provide the argument 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 must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The global location name. 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. + + --zone=ZONE + The name of the Google Distributed Cloud Edge zone. To set the zone + attribute: + ▸ provide the argument subnet on the command line with a fully + specified name; + ▸ provide the argument --zone on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/subnets/help b/gcloud/alpha/edge-cloud/networking/subnets/help new file mode 100644 index 000000000..c245dbddb --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/subnets/help @@ -0,0 +1,36 @@ +NAME + gcloud alpha edge-cloud networking subnets - manage Distributed Cloud Edge + Network subnets + +SYNOPSIS + gcloud alpha edge-cloud networking subnets COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Distributed Cloud Edge Network subnets. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a Distributed Cloud Edge Network subnet. + + delete + (ALPHA) Delete a Distributed Cloud Edge Network subnet. + + describe + (ALPHA) Show details about the Distributed Cloud Edge Network subnet. + + list + (ALPHA) List Distributed Cloud Edge Network subnets. + +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. + diff --git a/gcloud/alpha/edge-cloud/networking/subnets/list b/gcloud/alpha/edge-cloud/networking/subnets/list new file mode 100644 index 000000000..74c6ddc4b --- /dev/null +++ b/gcloud/alpha/edge-cloud/networking/subnets/list @@ -0,0 +1,96 @@ +NAME + gcloud alpha edge-cloud networking subnets list - list Distributed Cloud + Edge Network subnets + +SYNOPSIS + gcloud alpha edge-cloud networking subnets list + (--zone=ZONE : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List Distributed Cloud Edge Network subnets. + +EXAMPLES + To list the subnets in the edge zone 'us-central1-edge-den1', run: + + $ gcloud alpha edge-cloud networking subnets list \ + --location=us-central1 --zone=us-central1-edge-den1 + +REQUIRED FLAGS + Zone resource - Parent Distributed Cloud Edge Network zone to list all + contained Distributed Cloud Edge Network subnets. 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 --zone 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. + + --zone=ZONE + ID of the zone or fully qualified identifier for the zone. To set the + zone attribute: + ▸ provide the argument --zone on the command line. + + This flag must be specified if any of the other arguments in this + group are specified. + + --location=LOCATION + The global location name. To set the location attribute: + ▸ provide the argument --zone on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the edgenetwork/v1alpha1 API. The full documentation for + this API can be found at: go/gmec-nas + +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. + diff --git a/gcloud/alpha/healthcare/fhir-stores/export/bq b/gcloud/alpha/healthcare/fhir-stores/export/bq index 71e2ea043..eff11abbd 100644 --- a/gcloud/alpha/healthcare/fhir-stores/export/bq +++ b/gcloud/alpha/healthcare/fhir-stores/export/bq @@ -72,6 +72,11 @@ REQUIRED FLAGS Analytics schema defined by the FHIR community. See https://github.com/rbrush/sql-on-fhir/blob/master/sql-on-fhir.md. + analytics_v2 + Analytics V2, similar to schema defined by the FHIR community, with + added support for extensions with one or more occurrences and + contained resources in stringified JSON. + lossless Schema generated from original FHIR data. diff --git a/gcloud/alpha/run/jobs/create b/gcloud/alpha/run/jobs/create index bd0a3137a..fbb0a2355 100644 --- a/gcloud/alpha/run/jobs/create +++ b/gcloud/alpha/run/jobs/create @@ -4,10 +4,10 @@ NAME SYNOPSIS gcloud alpha run jobs create [JOB] --image=IMAGE [--args=[ARG,...]] [--binary-authorization=POLICY] [--breakglass=JUSTIFICATION] - [--command=[COMMAND,...]] [--cpu=CPU] [--key=KEY] + [--command=[COMMAND,...]] [--cpu=CPU] [--execute-now] [--key=KEY] [--labels=[KEY=VALUE,...]] [--max-retries=MAX_RETRIES] [--memory=MEMORY] [--parallelism=PARALLELISM] [--region=REGION] - [--run-now] [--service-account=SERVICE_ACCOUNT] + [--service-account=SERVICE_ACCOUNT] [--set-cloudsql-instances=[CLOUDSQL-INSTANCES,...]] [--set-env-vars=[KEY=VALUE,...]] [--set-secrets=[KEY=SECRET_NAME:SECRET_VERSION,...]] @@ -81,6 +81,9 @@ OPTIONAL FLAGS (fully managed), 4 cpus also requires a minimum 2Gi --memory value. Examples 2, 2.0, 2000m + --execute-now + Execute the job immediately after creation. + --key=KEY CMEK key reference to encrypt the container with. @@ -103,9 +106,6 @@ OPTIONAL FLAGS Region in which the resource can be found. Alternatively, set the property [run/region]. - --run-now - Run the job immediately after creation. - --service-account=SERVICE_ACCOUNT Service account associated with the revision of the service. The service account represents the identity of the running revision, and @@ -170,7 +170,7 @@ OPTIONAL FLAGS --wait Wait until the execution has completed running before exiting. If not set, gcloud exits successfully when the execution has started. - Implies --run-now. + Implies --execute-now. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/sql/instances/create b/gcloud/alpha/sql/instances/create index f04a27a48..fe1ae166d 100644 --- a/gcloud/alpha/sql/instances/create +++ b/gcloud/alpha/sql/instances/create @@ -94,8 +94,8 @@ FLAGS should be activated and is applicable only when the instance state is RUNNABLE. The default is on-demand. More information on activation policies can be found here: - https://cloud.google.com/sql/faq#activation_policy. ACTIVATION_POLICY - must be one of: always, never, on-demand. + https://cloud.google.com/sql/docs/mysql/start-stop-restart-instance#activation_policy. + ACTIVATION_POLICY must be one of: always, never, on-demand. --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 8b5f65826..9d442fa52 100644 --- a/gcloud/alpha/sql/instances/patch +++ b/gcloud/alpha/sql/instances/patch @@ -61,8 +61,8 @@ FLAGS should be activated and is applicable only when the instance state is RUNNABLE. The default is on-demand. More information on activation policies can be found here: - https://cloud.google.com/sql/faq#activation_policy. ACTIVATION_POLICY - must be one of: always, never, on-demand. + https://cloud.google.com/sql/docs/mysql/start-stop-restart-instance#activation_policy. + ACTIVATION_POLICY must be one of: always, never, on-demand. --active-directory-domain=ACTIVE_DIRECTORY_DOMAIN Managed Service for Microsoft Active Directory domain this instance is diff --git a/gcloud/alpha/vmware/clusters/create b/gcloud/alpha/vmware/clusters/create index 2f07e0108..4777cf5eb 100644 --- a/gcloud/alpha/vmware/clusters/create +++ b/gcloud/alpha/vmware/clusters/create @@ -5,8 +5,7 @@ NAME SYNOPSIS gcloud alpha vmware clusters create (CLUSTER : --location=LOCATION --private-cloud=PRIVATE_CLOUD) - --node-count=NODE_COUNT --node-type=NODE_TYPE - [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + --node-count=NODE_COUNT --node-type=NODE_TYPE [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a cluster in a VMware Engine private cloud. Successful @@ -86,15 +85,6 @@ REQUIRED FLAGS To set the node-type attribute: ▸ provide the argument --node-type on the command line. -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. - 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/vmware/help b/gcloud/alpha/vmware/help index 5b2c97687..b6d117918 100644 --- a/gcloud/alpha/vmware/help +++ b/gcloud/alpha/vmware/help @@ -24,7 +24,7 @@ GROUPS locations (ALPHA) List locations in Google Cloud VMware Engine. - nodetypes + node-types (ALPHA) Show node types in Google Cloud VMware Engine. nsx @@ -33,7 +33,7 @@ GROUPS operations (ALPHA) List and describe operations in Google Cloud VMware Engine. - privateclouds + private-clouds (ALPHA) Manage private clouds in Google Cloud VMware Engine. vcenter diff --git a/gcloud/alpha/vmware/nodetypes/describe b/gcloud/alpha/vmware/node-types/describe similarity index 88% rename from gcloud/alpha/vmware/nodetypes/describe rename to gcloud/alpha/vmware/node-types/describe index 9c30a0178..a25454649 100644 --- a/gcloud/alpha/vmware/nodetypes/describe +++ b/gcloud/alpha/vmware/node-types/describe @@ -1,9 +1,9 @@ NAME - gcloud alpha vmware nodetypes describe - display data associated with a + gcloud alpha vmware node-types describe - display data associated with a Google Cloud VMware Engine node type SYNOPSIS - gcloud alpha vmware nodetypes describe (NODE_TYPE : --location=LOCATION) + gcloud alpha vmware node-types describe (NODE_TYPE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -13,12 +13,12 @@ DESCRIPTION EXAMPLES To describe node type standard-72 in location us-west1-a, run: - $ gcloud alpha vmware nodetypes describe standard-72 \ + $ gcloud alpha vmware node-types describe standard-72 \ --location=us-central1 --project=my-project Or: - $ gcloud alpha vmware nodetypes describe standard-72 + $ gcloud alpha vmware node-types describe standard-72 In the second example, the project and location are taken from gcloud properties core/project and compute/zone. diff --git a/gcloud/alpha/vmware/nodetypes/help b/gcloud/alpha/vmware/node-types/help similarity index 83% rename from gcloud/alpha/vmware/nodetypes/help rename to gcloud/alpha/vmware/node-types/help index db55aeeb4..97e3bcfea 100644 --- a/gcloud/alpha/vmware/nodetypes/help +++ b/gcloud/alpha/vmware/node-types/help @@ -1,9 +1,9 @@ NAME - gcloud alpha vmware nodetypes - show node types in Google Cloud VMware + gcloud alpha vmware node-types - show node types in Google Cloud VMware Engine SYNOPSIS - gcloud alpha vmware nodetypes COMMAND [GCLOUD_WIDE_FLAG ...] + gcloud alpha vmware node-types COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Show node types in Google Cloud VMware Engine. diff --git a/gcloud/alpha/vmware/nodetypes/list b/gcloud/alpha/vmware/node-types/list similarity index 93% rename from gcloud/alpha/vmware/nodetypes/list rename to gcloud/alpha/vmware/node-types/list index 56f145a3a..4727bc057 100644 --- a/gcloud/alpha/vmware/nodetypes/list +++ b/gcloud/alpha/vmware/node-types/list @@ -1,9 +1,9 @@ NAME - gcloud alpha vmware nodetypes list - list supported Google Cloud VMware + gcloud alpha vmware node-types list - list supported Google Cloud VMware Engine node types SYNOPSIS - gcloud alpha vmware nodetypes list [--location=LOCATION] + gcloud alpha vmware node-types list [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] @@ -13,12 +13,12 @@ DESCRIPTION EXAMPLES To list VMware Engine node types, run: - $ gcloud alpha vmware nodetypes list --location=us-central1 \ + $ gcloud alpha vmware node-types list --location=us-central1 \ --project=my-project Or: - $ gcloud alpha vmware nodetypes list + $ gcloud alpha vmware node-types list In the second example, the project and location are taken from gcloud properties core/project and compute/zone. diff --git a/gcloud/alpha/vmware/privateclouds/create b/gcloud/alpha/vmware/private-clouds/create similarity index 83% rename from gcloud/alpha/vmware/privateclouds/create rename to gcloud/alpha/vmware/private-clouds/create index ebfacc17c..64852de60 100644 --- a/gcloud/alpha/vmware/privateclouds/create +++ b/gcloud/alpha/vmware/private-clouds/create @@ -1,26 +1,25 @@ NAME - gcloud alpha vmware privateclouds create - create a VMware Engine private + gcloud alpha vmware private-clouds create - create a VMware Engine private cloud SYNOPSIS - gcloud alpha vmware privateclouds create + gcloud alpha vmware private-clouds create (PRIVATE_CLOUD : --location=LOCATION) --cluster=CLUSTER --management-range=MANAGEMENT_RANGE --network=NETWORK --node-count=NODE_COUNT --node-type=NODE_TYPE - [--description=DESCRIPTION] [--external-ip-access] - [--labels=[KEY=VALUE,...]] [--network-project=NETWORK_PROJECT] + [--description=DESCRIPTION] [--network-project=NETWORK_PROJECT] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a VMware Engine private cloud. Private cloud creation is considered finished when the private cloud is in READY state. Check the - progress of a private cloud using gcloud alpha vmware privateclouds list. + progress of a private cloud using gcloud alpha vmware private-clouds list. EXAMPLES To create a private cloud in the us-west2-a zone using standard-72 nodes that connects to the default-vpc VPC network of another project, run: - $ gcloud alpha vmware privateclouds create my-private-cloud \ + $ gcloud alpha vmware private-clouds create my-private-cloud \ --location=us-west2-a --project=my-project \ --cluster=my-management-cluster --node-type=standard-72 \ --node-count=3 --management-range=192.168.0.0/24 \ @@ -28,7 +27,7 @@ EXAMPLES Or: - $ gcloud alpha vmware privateclouds create my-private-cloud \ + $ gcloud alpha vmware private-clouds create my-private-cloud \ --cluster=my-management-cluster --node-type=standard-72 \ --node-count=3 --management-range=192.168.0.0/24 \ --network=default-vpc --network-project=another-project @@ -122,21 +121,6 @@ OPTIONAL FLAGS --description=DESCRIPTION Text describing the private cloud. - --external-ip-access - Enable public IP address service for management appliances so vCenter - and NSX can be accessed via internet. Resolution of FQDNs requires - local DNS configuration for the private cloud domain. NAT is set up on - NSX for external IP ingress traffic, and users must manually configure - NSX firewall to allow HTTPS traffic. - - --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. - --network-project=NETWORK_PROJECT Project ID or project name of the VPC network. Use this flag when the VPC network is in another project. diff --git a/gcloud/alpha/vmware/privateclouds/delete b/gcloud/alpha/vmware/private-clouds/delete similarity index 88% rename from gcloud/alpha/vmware/privateclouds/delete rename to gcloud/alpha/vmware/private-clouds/delete index 3a98ca89b..c8140c367 100644 --- a/gcloud/alpha/vmware/privateclouds/delete +++ b/gcloud/alpha/vmware/private-clouds/delete @@ -1,26 +1,26 @@ NAME - gcloud alpha vmware privateclouds delete - delete a Google Cloud VMware + gcloud alpha vmware private-clouds delete - delete a Google Cloud VMware Engine private cloud SYNOPSIS - gcloud alpha vmware privateclouds delete + gcloud alpha vmware private-clouds delete (PRIVATE_CLOUD : --location=LOCATION) [--delay-hours=DELAY_HOURS; default=3] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Marks a VMware Engine private cloud for deletion. The resource is deleted 3 hours after being marked for deletion. This process can be - reversed by using gcloud alpha vmware privateclouds undelete. + reversed by using gcloud alpha vmware private-clouds undelete. EXAMPLES To mark a private cloud called my-private-cloud for deletion, run: - $ gcloud alpha vmware privateclouds delete my-private-cloud \ + $ gcloud alpha vmware private-clouds delete my-private-cloud \ --location=us-west2-a --project=my-project Or: - $ gcloud alpha vmware privateclouds delete my-private-cloud + $ gcloud alpha vmware private-clouds delete my-private-cloud In the second example, the project and location are taken from gcloud properties core/project and compute/zone. diff --git a/gcloud/alpha/vmware/privateclouds/describe b/gcloud/alpha/vmware/private-clouds/describe similarity index 88% rename from gcloud/alpha/vmware/privateclouds/describe rename to gcloud/alpha/vmware/private-clouds/describe index f082b290e..cd1c1b67b 100644 --- a/gcloud/alpha/vmware/privateclouds/describe +++ b/gcloud/alpha/vmware/private-clouds/describe @@ -1,9 +1,9 @@ NAME - gcloud alpha vmware privateclouds describe - describe a Google Cloud VMware - Engine private cloud + gcloud alpha vmware private-clouds describe - describe a Google Cloud + VMware Engine private cloud SYNOPSIS - gcloud alpha vmware privateclouds describe + gcloud alpha vmware private-clouds describe (PRIVATE_CLOUD : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -13,12 +13,12 @@ EXAMPLES To get a description of a private cloud called my-private-cloud in project my-project and zone us-west2-a, run: - $ gcloud alpha vmware privateclouds describe my-private-cloud \ + $ gcloud alpha vmware private-clouds describe my-private-cloud \ --location=us-west2-a --project=my-project Or: - $ gcloud alpha vmware privateclouds describe my-private-cloud + $ gcloud alpha vmware private-clouds describe my-private-cloud In the second example, the project and location are taken from gcloud properties core/project and compute/zone. diff --git a/gcloud/alpha/vmware/privateclouds/help b/gcloud/alpha/vmware/private-clouds/help similarity index 87% rename from gcloud/alpha/vmware/privateclouds/help rename to gcloud/alpha/vmware/private-clouds/help index 02d61bb3e..b31b0a58b 100644 --- a/gcloud/alpha/vmware/privateclouds/help +++ b/gcloud/alpha/vmware/private-clouds/help @@ -1,9 +1,9 @@ NAME - gcloud alpha vmware privateclouds - manage private clouds in Google Cloud + gcloud alpha vmware private-clouds - manage private clouds in Google Cloud VMware Engine SYNOPSIS - gcloud alpha vmware privateclouds COMMAND [GCLOUD_WIDE_FLAG ...] + gcloud alpha vmware private-clouds COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Manage private clouds in Google Cloud VMware Engine. diff --git a/gcloud/alpha/vmware/privateclouds/list b/gcloud/alpha/vmware/private-clouds/list similarity index 92% rename from gcloud/alpha/vmware/privateclouds/list rename to gcloud/alpha/vmware/private-clouds/list index d1c3f727d..40253e6c4 100644 --- a/gcloud/alpha/vmware/privateclouds/list +++ b/gcloud/alpha/vmware/private-clouds/list @@ -1,9 +1,9 @@ NAME - gcloud alpha vmware privateclouds list - list Google Cloud VMware Engine + gcloud alpha vmware private-clouds list - list Google Cloud VMware Engine private clouds SYNOPSIS - gcloud alpha vmware privateclouds list [--location=LOCATION] + gcloud alpha vmware private-clouds list [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] @@ -13,11 +13,11 @@ DESCRIPTION EXAMPLES To list VMware Engine operations in the location us-west2-a, run: - $ gcloud alpha vmware privateclouds list --location=us-west2-a + $ gcloud alpha vmware private-clouds list --location=us-west2-a Or: - $ gcloud alpha vmware privateclouds list + $ gcloud alpha vmware private-clouds list In the second example, the location is taken from gcloud properties compute/zone. diff --git a/gcloud/alpha/vmware/privateclouds/undelete b/gcloud/alpha/vmware/private-clouds/undelete similarity index 87% rename from gcloud/alpha/vmware/privateclouds/undelete rename to gcloud/alpha/vmware/private-clouds/undelete index 2bbcb1062..3556c4c71 100644 --- a/gcloud/alpha/vmware/privateclouds/undelete +++ b/gcloud/alpha/vmware/private-clouds/undelete @@ -1,24 +1,24 @@ NAME - gcloud alpha vmware privateclouds undelete - cancel deletion of a Google + gcloud alpha vmware private-clouds undelete - cancel deletion of a Google Cloud VMware Engine private cloud SYNOPSIS - gcloud alpha vmware privateclouds undelete + gcloud alpha vmware private-clouds undelete (PRIVATE_CLOUD : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Unmark a VMware Engine private cloud that was previously marked for - deletion by gcloud alpha vmware privateclouds delete. + deletion by gcloud alpha vmware private-clouds delete. EXAMPLES To unmark a private cloud called my-private-cloud for deletion, run: - $ gcloud alpha vmware privateclouds undelete my-private-cloud \ + $ gcloud alpha vmware private-clouds undelete my-private-cloud \ --location=us-west2-a --project=my-project Or: - $ gcloud alpha vmware privateclouds undelete my-private-cloud + $ gcloud alpha vmware private-clouds undelete my-private-cloud In the second example, the project and location are taken from gcloud properties core/project and compute/zone. diff --git a/gcloud/alpha/vmware/privateclouds/update b/gcloud/alpha/vmware/private-clouds/update similarity index 62% rename from gcloud/alpha/vmware/privateclouds/update rename to gcloud/alpha/vmware/private-clouds/update index 2c962afc5..0ed565343 100644 --- a/gcloud/alpha/vmware/privateclouds/update +++ b/gcloud/alpha/vmware/private-clouds/update @@ -1,11 +1,10 @@ NAME - gcloud alpha vmware privateclouds update - update a Google Cloud VMware + gcloud alpha vmware private-clouds update - update a Google Cloud VMware Engine private cloud SYNOPSIS - gcloud alpha vmware privateclouds update + gcloud alpha vmware private-clouds update (PRIVATE_CLOUD : --location=LOCATION) [--description=DESCRIPTION] - [--external-ip-access] [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -13,19 +12,16 @@ DESCRIPTION EXAMPLES To update a private cloud named my-private-cloud by changing its - description to Example description and adding the labels key1 and key2 with - respective values value1 and value2, run: + description to Example description run: - $ gcloud alpha vmware privateclouds update my-private-cloud \ + $ gcloud alpha vmware private-clouds update my-private-cloud \ --location=us-west2-a --project=my-project \ - --description='Example description' \ - --labels=key1=value1,key2=value2 + --description='Example description' Or: - $ gcloud alpha vmware privateclouds update my-private-cloud \ - --description='Example description' \ - --labels=key1=value1,key2=value2 + $ gcloud alpha vmware private-clouds update my-private-cloud \ + --description='Example description' In the second example, the project and location are taken from gcloud properties core/project and compute/zone. @@ -61,22 +57,6 @@ FLAGS --description=DESCRIPTION Text describing the private cloud - --external-ip-access - Enable public IP address service for management appliances so vCenter - and NSX can be accessed via internet. Resolution of FQDNs requires - local DNS configuration for the private cloud domain. NAT is set up on - NSX for external IP ingress traffic, and users must manually configure - NSX firewall to allow HTTPS traffic. Use --no-external-ip-access' to - disable. - - --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, diff --git a/gcloud/beta/bigtable/help b/gcloud/beta/bigtable/help index d23439a91..cea89fc0d 100644 --- a/gcloud/beta/bigtable/help +++ b/gcloud/beta/bigtable/help @@ -24,6 +24,9 @@ GROUPS clusters (BETA) Manage Cloud Bigtable clusters. + hot-tablets + (BETA) Manage Cloud Bigtable hot tablets. + instances (BETA) Manage Cloud Bigtable instances. diff --git a/gcloud/beta/bigtable/hot-tablets/help b/gcloud/beta/bigtable/hot-tablets/help new file mode 100644 index 000000000..efb340d18 --- /dev/null +++ b/gcloud/beta/bigtable/hot-tablets/help @@ -0,0 +1,28 @@ +NAME + gcloud beta bigtable hot-tablets - manage Cloud Bigtable hot tablets + +SYNOPSIS + gcloud beta bigtable hot-tablets COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Cloud Bigtable hot tablets. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + (BETA) List hot tablets in a Cloud Bigtable cluster. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud bigtable hot-tablets + + $ gcloud alpha bigtable hot-tablets + diff --git a/gcloud/beta/bigtable/hot-tablets/list b/gcloud/beta/bigtable/hot-tablets/list new file mode 100644 index 000000000..74bfa83ee --- /dev/null +++ b/gcloud/beta/bigtable/hot-tablets/list @@ -0,0 +1,115 @@ +NAME + gcloud beta bigtable hot-tablets list - list hot tablets in a Cloud + Bigtable cluster + +SYNOPSIS + gcloud beta bigtable hot-tablets list (CLUSTER : --instance=INSTANCE) + [--end-time=END_TIME] [--start-time=START_TIME] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List hot tablets in a Cloud Bigtable cluster. + +EXAMPLES + Search for hot tablets in the past 24 hours: + + $ gcloud beta bigtable hot-tablets list my-cluster-id \ + --instance=my-instance-id + + Search for hot tablets with start and end times by minute: + + $ gcloud beta bigtable hot-tablets list my-cluster-id \ + --instance=my-instance-id --start-time="2018-08-12 03:30:00" \ + --end-time="2018-08-13 17:00:00" + + Search for hot tablets with start and end times by day: + + $ gcloud beta bigtable hot-tablets list my-cluster-id \ + --instance=my-instance-id --start-time=2018-01-01 \ + --end-time=2018-01-05 + +POSITIONAL ARGUMENTS + Cluster resource - The cluster to list hot tablets for. 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; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. To + set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --instance=INSTANCE + Cloud Bigtable instance for the cluster. To set the instance + attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --instance on the command line. + +FLAGS + --end-time=END_TIME + End time of the time range to search for hot tablets. See $ gcloud + topic datetimes for information on time formats. + + --start-time=START_TIME + Start time of the time range to search for hot tablets. See $ gcloud + topic datetimes for information on time formats. + +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 bigtable hot-tablets list + + $ gcloud alpha bigtable hot-tablets list + diff --git a/gcloud/beta/compute/backend-services/create b/gcloud/beta/compute/backend-services/create index 9c4659761..0ef914242 100644 --- a/gcloud/beta/compute/backend-services/create +++ b/gcloud/beta/compute/backend-services/create @@ -245,7 +245,14 @@ FLAGS --drop-traffic-if-unhealthy Enable dropping of traffic if there are no healthy VMs detected in both the primary and backup instance groups. Not compatible with the - --global flag and load balancing scheme must be INTERNAL or EXTERNAL. + --global flag. Applicable only for backend service-based network load + balancers and internal TCP/UDP load balancers as part of a connection + tracking policy. For details, see: Connection persistence on unhealthy + backends for internal TCP/UDP load balancing + (https://cloud.google.com/load-balancing/docs/internal#connection-persistence) + and Connection persistence on unhealthy backends for network load + balancing + (https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence). --[no-]enable-cdn Enable or disable Cloud CDN for the backend service. Only available for diff --git a/gcloud/beta/compute/backend-services/update b/gcloud/beta/compute/backend-services/update index 5be022a0e..d9dea6361 100644 --- a/gcloud/beta/compute/backend-services/update +++ b/gcloud/beta/compute/backend-services/update @@ -153,7 +153,14 @@ FLAGS --drop-traffic-if-unhealthy Enable dropping of traffic if there are no healthy VMs detected in both the primary and backup instance groups. Not compatible with the - --global flag and load balancing scheme must be INTERNAL or EXTERNAL. + --global flag. Applicable only for backend service-based network load + balancers and internal TCP/UDP load balancers as part of a connection + tracking policy. For details, see: Connection persistence on unhealthy + backends for internal TCP/UDP load balancing + (https://cloud.google.com/load-balancing/docs/internal#connection-persistence) + and Connection persistence on unhealthy backends for network load + balancing + (https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence). --edge-security-policy=EDGE_SECURITY_POLICY The edge security policy that will be set for this backend service. To diff --git a/gcloud/beta/compute/disks/snapshot b/gcloud/beta/compute/disks/snapshot index 174eb3aae..152a60fe5 100644 --- a/gcloud/beta/compute/disks/snapshot +++ b/gcloud/beta/compute/disks/snapshot @@ -14,7 +14,7 @@ DESCRIPTION disks. Snapshots are useful for backing up data, copying a persistent disk, and even, creating a custom image. Snapshots can be created from persistent disks even while they are attached to running instances. Once created, - snapshots may be managed (listed, deleted, resized etc.) via gcloud compute + snapshots may be managed (listed, deleted, etc.) via gcloud compute snapshots. Refer to the Snapshot best practices guide. diff --git a/gcloud/beta/compute/instances/set-scheduling b/gcloud/beta/compute/instances/set-scheduling index 13c1d8160..ce090c05e 100644 --- a/gcloud/beta/compute/instances/set-scheduling +++ b/gcloud/beta/compute/instances/set-scheduling @@ -7,14 +7,18 @@ SYNOPSIS [--clear-min-node-cpu] [--host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS] [--maintenance-policy=MAINTENANCE_POLICY] [--min-node-cpu=MIN_NODE_CPU] - [--preemptible] [--[no-]restart-on-failure] [--zone=ZONE] + [--[no-]preemptible] [--provisioning-model=PROVISIONING_MODEL] + [--[no-]restart-on-failure] [--zone=ZONE] + [--clear-instance-termination-action + | --instance-termination-action=INSTANCE_TERMINATION_ACTION] [--clear-node-affinities | --node=NODE | --node-affinity-file=NODE_AFFINITY_FILE | --node-group=NODE_GROUP] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) $gcloud beta compute instances set-scheduling is used to configure - scheduling options for Compute Engine virtual machines. + (BETA) $gcloud beta compute instances set-scheduling is used to update + scheduling options for VM instances. You can only call this method on a VM + instance that is stopped (a VM instance in a TERMINATED state). EXAMPLES To set instance to be terminated during maintenance, run: @@ -56,11 +60,25 @@ FLAGS Minimum number of virtual CPUs this instance will consume when running on a sole-tenant node. - --preemptible + --[no-]preemptible If provided, instances will be preemptible and time-limited. Instances might be preempted to free up resources for standard VM instances, and will only be able to run for a limited amount of time. Preemptible - instances can not be restarted and will not migrate. + instances can not be restarted and will not migrate. Use --preemptible + to enable and --no-preemptible to disable. + + --provisioning-model=PROVISIONING_MODEL + Specifies provisioning model, which determines price, obtainability, + and runtime for the VM instance. PROVISIONING_MODEL must be one of: + + SPOT + Spot VMs are spare capacity; Spot VMs are discounted to have much + lower prices than standard VMs but have no guaranteed runtime. Spot + VMs are the new version of preemptible VM instances, except Spot + VMs do not have a 24-hour maximum runtime. + STANDARD + Default. Standard provisioning model for VM instances, which has + user-controlled runtime but no Spot discounts. --[no-]restart-on-failure The instances will be restarted if they are terminated by Compute @@ -92,6 +110,29 @@ FLAGS Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE. + Instance Termination Action + + At most one of these can be specified: + + --clear-instance-termination-action + Disables the termination action for this VM if allowed OR sets + termination action to the default value. Depending on a VM's + availability settings, a termination action is either required or not + allowed. This flag is required when you are updating a VM such that + it's previously specified termination action is no longer allowed. If + you use this flag when a VM requires a termination action, it's + termination action is just set to the default value (stop). + + --instance-termination-action=INSTANCE_TERMINATION_ACTION + Specifies the termination action that will be taken upon VM + preemption. INSTANCE_TERMINATION_ACTION must be one of: + + DELETE + Permanently delete the VM. + STOP + Default. Stop the VM without preserving memory. The VM can be + restarted later. + Sole Tenancy. At most one of these can be specified: diff --git a/gcloud/beta/compute/target-https-proxies/import b/gcloud/beta/compute/target-https-proxies/import index 62866b2ab..476738d3a 100644 --- a/gcloud/beta/compute/target-https-proxies/import +++ b/gcloud/beta/compute/target-https-proxies/import @@ -10,11 +10,16 @@ DESCRIPTION (BETA) Imports a target HTTPS proxy's configuration from a file. EXAMPLES - A target HTTPS proxy can be imported by running: + A global target HTTPS proxy can be imported by running: $ gcloud beta compute target-https-proxies import NAME \ --source= + A regional target HTTPS proxy can be imported by running: + + $ gcloud beta compute target-https-proxies import NAME \ + --source= --region=REGION_NAME + POSITIONAL ARGUMENTS NAME Name of the target HTTPS proxy to import. diff --git a/gcloud/beta/dataflow/flex-template/build b/gcloud/beta/dataflow/flex-template/build index c6e77c781..998124318 100644 --- a/gcloud/beta/dataflow/flex-template/build +++ b/gcloud/beta/dataflow/flex-template/build @@ -13,6 +13,9 @@ SYNOPSIS [--additional-user-labels=[ADDITIONAL_USER_LABELS,...]] [--dataflow-kms-key=DATAFLOW_KMS_KEY] [--disable-public-ips] [--enable-streaming-engine] [--gcs-log-dir=GCS_LOG_DIR] + [--image-repository-cert-path=IMAGE_REPOSITORY_CERT_PATH] + [--image-repository-password-secret-id=IMAGE_REPOSITORY_PASSWORD_SECRET_ID] + [--image-repository-username-secret-id=IMAGE_REPOSITORY_USERNAME_SECRET_ID] [--max-workers=MAX_WORKERS] [--metadata-file=METADATA_FILE] [--network=NETWORK] [--num-workers=NUM_WORKERS] [--print-only] [--service-account-email=SERVICE_ACCOUNT_EMAIL] @@ -127,6 +130,30 @@ OPTIONAL FLAGS Google Cloud Storage directory to save build logs.(Must be a URL beginning with 'gs://'.) + --image-repository-cert-path=IMAGE_REPOSITORY_CERT_PATH + The full URL to self-signed certificate of private registry in Cloud + Storage. For example, gs://mybucket/mycerts/selfsigned.crt. The + certificate provided in Cloud Storage must be DER-encoded and may be + supplied in binary or printable (Base64) encoding. If the certificate + is provided in Base64 encoding, it must be bounded at the beginning by + -----BEGIN CERTIFICATE-----, and must be bounded at the end by -----END + CERTIFICATE-----. If this parameter is provided, the docker daemon in + the template launcher will be instructed to trust that certificate. + + --image-repository-password-secret-id=IMAGE_REPOSITORY_PASSWORD_SECRET_ID + Secret Manager secret id for the password to authenticate to private + registry. Should be in the format + projects/{project}/secrets/{secret}/versions/{secret_version} or + projects/{project}/secrets/{secret}. If the version is not provided + latest version will be used. + + --image-repository-username-secret-id=IMAGE_REPOSITORY_USERNAME_SECRET_ID + Secret Manager secret id for the username to authenticate to private + registry. Should be in the format + projects/{project}/secrets/{secret}/versions/{secret_version} or + projects/{project}/secrets/{secret}. If the version is not provided + latest version will be used. + --max-workers=MAX_WORKERS Default maximum number of workers to run. diff --git a/gcloud/beta/dataproc/clusters/gke/create b/gcloud/beta/dataproc/clusters/gke/create new file mode 100644 index 000000000..7d0425e32 --- /dev/null +++ b/gcloud/beta/dataproc/clusters/gke/create @@ -0,0 +1,306 @@ +NAME + gcloud beta dataproc clusters gke create - create a GKE-based virtual + cluster + +SYNOPSIS + gcloud beta dataproc clusters gke create (CLUSTER : --region=REGION) + --spark-engine-version=SPARK_ENGINE_VERSION + (--gke-cluster=GKE_CLUSTER + : --gke-cluster-location=GKE_CLUSTER_LOCATION) [--async] + [--namespace=NAMESPACE] [--pools=[KEY=VALUE[;VALUE],...]] + [--properties=[PREFIX:PROPERTY=VALUE,...]] [--setup-workload-identity] + [--staging-bucket=STAGING_BUCKET] + [--history-server-cluster=HISTORY_SERVER_CLUSTER + : --history-server-cluster-region=HISTORY_SERVER_CLUSTER_REGION] + [--metastore-service=METASTORE_SERVICE + : --metastore-service-location=METASTORE_SERVICE_LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a GKE-based virtual cluster. + +EXAMPLES + Create a Dataproc on GKE cluster in us-central1 on a GKE cluster in the + same project and region with default values: + + $ gcloud beta dataproc clusters gke create my-cluster \ + --region=us-central1 --gke-cluster=my-gke-cluster \ + --spark-engine-version=latest --pools='name=dp,roles=default' + + Create a Dataproc on GKE cluster in us-central1 on a GKE cluster in the + same project and zone us-central1-f with default values: + + $ gcloud beta dataproc clusters gke create my-cluster \ + --region=us-central1 --gke-cluster=my-gke-cluster \ + --gke-cluster-location=us-central1-f \ + --spark-engine-version=3.1 --pools='name=dp,roles=default' + + Create a Dataproc on GKE cluster in us-central1 with machine type + 'e2-standard-4', autoscaling 5-15 nodes per zone. + + $ gcloud beta dataproc clusters gke create my-cluster \ + --region='us-central1' \ + --gke-cluster='projects/my-project/locations/us-central1/cluster\ + s/my-gke-cluster' --spark-engine-version=dataproc-1.5 \ + --pools='name=dp-default,roles=default,machineType=e2-standard-4\ + ,min=5,max=15' + + Create a Dataproc on GKE cluster in us-central1 with two distinct node + pools. + + $ gcloud beta dataproc clusters gke create my-cluster \ + --region='us-central1' --gke-cluster='my-gke-cluster' \ + --spark-engine-version='dataproc-2.0' \ + --pools='name=dp-default,roles=default,machineType=e2-standard-4\ + ' \ + --pools='name=workers,roles=spark-drivers;spark-executors,machin\ + eType=n2-standard-8 + +POSITIONAL ARGUMENTS + Cluster resource - The name of the cluster 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 cluster 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. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. To + set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --region=REGION + Dataproc region for the cluster. Each Dataproc region constitutes an + independent resource namespace constrained to deploying instances + into Compute Engine zones inside the region. Overrides the default + dataproc/region property value for this command invocation. To set + the region attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property dataproc/region. + +REQUIRED FLAGS + --spark-engine-version=SPARK_ENGINE_VERSION + The version of the Spark engine to run on this cluster. + + Gke cluster resource - The GKE cluster to install the Dataproc cluster on. + 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 --gke-cluster 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. + + --gke-cluster=GKE_CLUSTER + ID of the gke-cluster or fully qualified identifier for the + gke-cluster. To set the gke-cluster attribute: + ▸ provide the argument --gke-cluster on the command line. + + This flag must be specified if any of the other arguments in this + group are specified. + + --gke-cluster-location=GKE_CLUSTER_LOCATION + GKE region for the gke-cluster. To set the gke-cluster-location + attribute: + ▸ provide the argument --gke-cluster on the command line with a + fully specified name; + ▸ provide the argument --gke-cluster-location on the command line; + ▸ provide the argument --region on the command line; + ▸ set the property dataproc/region. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --namespace=NAMESPACE + The name of the Kubernetes namespace to deploy Dataproc system + components in. This namespace does not need to exist. + + --pools=[KEY=VALUE[;VALUE],...] + Each --pools flag represents a single GKE node pool associated with the + virtual cluster. It is comprised of a CSV in the form + KEY=VALUE[;VALUE], where certain keys may have multiple values. + + The following KEYs must be specified: + + KEY Type Example Description + name string `my-node-pool` Name of the node pool. + roles repeated string `default;spark-driver` Roles that this node + pool should perform. + Valid values are + `default`, + `controller`, + `spark-driver`, + `spark-executor`. + + The following KEYs may be specified. + + KEY Type Example Description + machineType string `n1-standard-8` Compute + Engine + machine type + to use. + preemptible boolean `false` If true, + then this + node pool + uses + preemptible + VMs. This + cannot be + true on the + node pool + with the + `controllers + ` role (or + `default` + role if + `controllers + ` role is + not + specified). + localSsdCount int `2` The number + of local + SSDs to + attach to + each node. + accelerator repeated string `nvidia-tesla-a100=1` Accelerators + to attach to + each node. + In the + format + NAME=COUNT. + minCpuPlatform string `Intel Skylake` Minimum CPU + platform for + each node. + locations repeated string `us-west1-a;us-west1-c` Zones within + the location + of the GKE + cluster. All + `--pools` + flags for a + single + Dataproc + cluster must + have + identical + locations. + min int `0` Minimum + number of + nodes per + zone that + this node + pool can + scale down + to. + max int `10` Maximum + number of + nodes per + zone that + this node + pool can + scale up to. + + --properties=[PREFIX:PROPERTY=VALUE,...] + Specifies configuration properties for installed packages, such as + Spark. Properties are mapped to configuration files by specifying a + prefix, such as "core:io.serializations". + + --setup-workload-identity + Sets up the GKE Workload Identity for your Dataproc on GKE cluster. + Note that running this requires elevated permissions as it will + manipulate IAM policies on the Google Service Accounts that will be + used by your Dataproc on GKE cluster. + + --staging-bucket=STAGING_BUCKET + The Cloud Storage bucket to use to stage job dependencies, + miscellaneous config files, and job driver console output when using + this cluster. + + History server cluster resource - A Dataproc Cluster created as a History + Server, see + https://cloud.google.com/dataproc/docs/concepts/jobs/history-server 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 --history-server-cluster on the command line + with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --history-server-cluster=HISTORY_SERVER_CLUSTER + ID of the history-server-cluster or fully qualified identifier for + the history-server-cluster. To set the history-server-cluster + attribute: + ▸ provide the argument --history-server-cluster on the command + line. + + This flag must be specified if any of the other arguments in this + group are specified. + + --history-server-cluster-region=HISTORY_SERVER_CLUSTER_REGION + Compute Engine region for the history-server-cluster. It must be the + same region as the Dataproc cluster that is being created. To set the + history-server-cluster-region attribute: + ▸ provide the argument --history-server-cluster on the command line + with a fully specified name; + ▸ provide the argument --history-server-cluster-region on the + command line; + ▸ provide the argument --region on the command line; + ▸ set the property dataproc/region. + + Metastore service resource - Dataproc Metastore Service to be used as an + external metastore. 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 --metastore-service on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --metastore-service=METASTORE_SERVICE + ID of the metastore-service or fully qualified identifier for the + metastore-service. To set the metastore-service attribute: + ▸ provide the argument --metastore-service on the command line. + + This flag must be specified if any of the other arguments in this + group are specified. + + --metastore-service-location=METASTORE_SERVICE_LOCATION + Dataproc Metastore location for the metastore-service. To set the + metastore-service-location attribute: + ▸ provide the argument --metastore-service on the command line with + a fully specified name; + ▸ provide the argument --metastore-service-location on the command + line; + ▸ provide the argument --region on the command line; + ▸ set the property dataproc/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. These + variants are also available: + + $ gcloud dataproc clusters gke create + + $ gcloud alpha dataproc clusters gke create + diff --git a/gcloud/beta/dataproc/clusters/gke/help b/gcloud/beta/dataproc/clusters/gke/help new file mode 100644 index 000000000..58bf77103 --- /dev/null +++ b/gcloud/beta/dataproc/clusters/gke/help @@ -0,0 +1,37 @@ +NAME + gcloud beta dataproc clusters gke - create Dataproc GKE-based virtual + clusters + +SYNOPSIS + gcloud beta dataproc clusters gke COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) All interactions other than creation should be handled by "gcloud + dataproc clusters" commands. + +EXAMPLES + To create a cluster, run: + + $ gcloud beta dataproc clusters gke my-cluster \ + --region='us-central1' --gke-cluster='my-gke-cluster' \ + --spark-engine-version='latest' --pools='name=dp,roles=default' + +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 GKE-based virtual cluster. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud dataproc clusters gke + + $ gcloud alpha dataproc clusters gke + diff --git a/gcloud/beta/dataproc/clusters/help b/gcloud/beta/dataproc/clusters/help index 3f5f4d852..5a44409b9 100644 --- a/gcloud/beta/dataproc/clusters/help +++ b/gcloud/beta/dataproc/clusters/help @@ -2,7 +2,7 @@ NAME gcloud beta dataproc clusters - create and manage Dataproc clusters SYNOPSIS - gcloud beta dataproc clusters COMMAND [GCLOUD_WIDE_FLAG ...] + gcloud beta dataproc clusters GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create and manage Dataproc clusters. @@ -37,6 +37,12 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +GROUPS + GROUP is one of the following: + + gke + (BETA) Create Dataproc GKE-based virtual clusters. + COMMANDS COMMAND is one of the following: diff --git a/gcloud/beta/datastream/connection-profiles/create b/gcloud/beta/datastream/connection-profiles/create index 7660a8091..1a3eeab8f 100644 --- a/gcloud/beta/datastream/connection-profiles/create +++ b/gcloud/beta/datastream/connection-profiles/create @@ -26,7 +26,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Create a Datastream connection profile + (BETA) (DEPRECATED) Datastream beta version is deprecated. Please + use`gcloud datastream connection-profiles create command instead. + + Create a Datastream connection profile EXAMPLES To create a connection profile for Oracle: diff --git a/gcloud/beta/datastream/connection-profiles/delete b/gcloud/beta/datastream/connection-profiles/delete index 7af8f9585..e302562cc 100644 --- a/gcloud/beta/datastream/connection-profiles/delete +++ b/gcloud/beta/datastream/connection-profiles/delete @@ -7,7 +7,10 @@ SYNOPSIS (CONNECTION_PROFILE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Deletes a connection profile. + (BETA) (DEPRECATED) This command has been deprecated. Use gcloud datastream + connection_profiles delete instead. + + Deletes a connection profile. EXAMPLES To delete a connection profile: diff --git a/gcloud/beta/datastream/connection-profiles/describe b/gcloud/beta/datastream/connection-profiles/describe index ec30d9f02..bf33c9b0c 100644 --- a/gcloud/beta/datastream/connection-profiles/describe +++ b/gcloud/beta/datastream/connection-profiles/describe @@ -7,7 +7,10 @@ SYNOPSIS (CONNECTION_PROFILE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Show details about a connection profile. + (BETA) (DEPRECATED) This command has been deprecated. Use gcloud datastream + connection_profiles describe instead. + + Show details about a connection profile. EXAMPLES To show details about a connection profile, run: diff --git a/gcloud/beta/datastream/connection-profiles/discover b/gcloud/beta/datastream/connection-profiles/discover index 8cf077cde..aed5da6c2 100644 --- a/gcloud/beta/datastream/connection-profiles/discover +++ b/gcloud/beta/datastream/connection-profiles/discover @@ -12,8 +12,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Discover data objects accessible from a Datastream connection - profile + (BETA) (DEPRECATED) Datastream beta version is deprecated. Please + use`gcloud datastream connection-profiles discover command instead. + + Discover data objects accessible from a Datastream connection profile EXAMPLES To discover an existing connection profile: diff --git a/gcloud/beta/datastream/connection-profiles/help b/gcloud/beta/datastream/connection-profiles/help index c40786c63..93e79331b 100644 --- a/gcloud/beta/datastream/connection-profiles/help +++ b/gcloud/beta/datastream/connection-profiles/help @@ -17,22 +17,22 @@ COMMANDS COMMAND is one of the following: create - (BETA) Create a Datastream connection profile. + (BETA) (DEPRECATED) Create a Datastream connection profile. delete - (BETA) Delete a Datastream connection profile. + (BETA) (DEPRECATED) Delete a Datastream connection profile. describe - (BETA) Show details about a Datastream connection profile. + (BETA) (DEPRECATED) Show details about a Datastream connection profile. discover - (BETA) Discover a Datastream connection profile. + (BETA) (DEPRECATED) Discover a Datastream connection profile. list - (BETA) List Datastream connection profiles. + (BETA) (DEPRECATED) List Datastream connection profiles. update - (BETA) Update a Datastream connection profile. + (BETA) (DEPRECATED) Update a Datastream connection profile. NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/datastream/connection-profiles/list b/gcloud/beta/datastream/connection-profiles/list index 47256f41c..52ddcaf06 100644 --- a/gcloud/beta/datastream/connection-profiles/list +++ b/gcloud/beta/datastream/connection-profiles/list @@ -8,7 +8,12 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) List connection profiles. + (BETA) (DEPRECATED) List Datastream connection profiles. + + Datastream beta version is deprecated. Please use`gcloud datastream + connection-profiles list command instead. + + List connection profiles. EXAMPLES To list all connection profiles in a project and location 'us-central1', diff --git a/gcloud/beta/datastream/connection-profiles/update b/gcloud/beta/datastream/connection-profiles/update index de22b93ce..03b81405e 100644 --- a/gcloud/beta/datastream/connection-profiles/update +++ b/gcloud/beta/datastream/connection-profiles/update @@ -27,7 +27,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Updates a Datastream connection profile + (BETA) (DEPRECATED) Datastream beta version is deprecated. Please + use`gcloud datastream connection-profiles update command instead. + + Updates a Datastream connection profile EXAMPLES To update a connection profile for Oracle: diff --git a/gcloud/beta/datastream/private-connections/create b/gcloud/beta/datastream/private-connections/create index 0cd5e5967..a0bf09afb 100644 --- a/gcloud/beta/datastream/private-connections/create +++ b/gcloud/beta/datastream/private-connections/create @@ -9,7 +9,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Create a Datastream private connection + (BETA) (DEPRECATED) Datastream beta version is deprecated. Please + use`gcloud datastream private-connections create command instead. + + Create a Datastream private connection EXAMPLES To create a privateConnection called 'my-privateConnection', run: diff --git a/gcloud/beta/datastream/private-connections/delete b/gcloud/beta/datastream/private-connections/delete index a511ad68d..a72c214be 100644 --- a/gcloud/beta/datastream/private-connections/delete +++ b/gcloud/beta/datastream/private-connections/delete @@ -8,8 +8,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Deletes a private connection. You must set the --force parameter to - ensure that the private connectivity configuration is deleted properly. + (BETA) (DEPRECATED) This command has been deprecated. Use gcloud datastream + private_connections delete instead. + + Deletes a private connection. You must set the --force parameter to ensure + that the private connectivity configuration is deleted properly. EXAMPLES To delete a private connection: diff --git a/gcloud/beta/datastream/private-connections/describe b/gcloud/beta/datastream/private-connections/describe index bc2722e3f..6126943e4 100644 --- a/gcloud/beta/datastream/private-connections/describe +++ b/gcloud/beta/datastream/private-connections/describe @@ -7,7 +7,10 @@ SYNOPSIS (PRIVATE_CONNECTION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Show details about a private connection. + (BETA) (DEPRECATED) This command has been deprecated. Use gcloud datastream + private_connections describe instead. + + Show details about a private connection. EXAMPLES To show details about a private connection, run: diff --git a/gcloud/beta/datastream/private-connections/help b/gcloud/beta/datastream/private-connections/help index c0bfb2612..b27ae431f 100644 --- a/gcloud/beta/datastream/private-connections/help +++ b/gcloud/beta/datastream/private-connections/help @@ -17,16 +17,16 @@ COMMANDS COMMAND is one of the following: create - (BETA) Create a Datastream private connection. + (BETA) (DEPRECATED) Create a Datastream private connection. delete - (BETA) Delete a Datastream private connection. + (BETA) (DEPRECATED) Delete a Datastream private connection. describe - (BETA) Show details about a Datastream private connection. + (BETA) (DEPRECATED) Show details about a Datastream private connection. list - (BETA) List private connections. + (BETA) (DEPRECATED) List private connections. NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/datastream/private-connections/list b/gcloud/beta/datastream/private-connections/list index 9c96e8a0d..e0b80c5ed 100644 --- a/gcloud/beta/datastream/private-connections/list +++ b/gcloud/beta/datastream/private-connections/list @@ -7,7 +7,10 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) List private connections. + (BETA) (DEPRECATED) This command has been deprecated. Use gcloud datastream + private_connections list instead. + + List private connections. EXAMPLES To list all private connections in a project and location 'us-central1', diff --git a/gcloud/beta/datastream/routes/create b/gcloud/beta/datastream/routes/create index d47bd0bb7..a1d974978 100644 --- a/gcloud/beta/datastream/routes/create +++ b/gcloud/beta/datastream/routes/create @@ -10,7 +10,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Create a Datastream private connection route + (BETA) (DEPRECATED) Datastream beta version is deprecated. Please + use`gcloud datastream routes create command instead. + + Create a Datastream private connection route EXAMPLES To create a route called 'my-route', run: diff --git a/gcloud/beta/datastream/routes/delete b/gcloud/beta/datastream/routes/delete index 9286e0768..dd16ec905 100644 --- a/gcloud/beta/datastream/routes/delete +++ b/gcloud/beta/datastream/routes/delete @@ -8,7 +8,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Deletes a Datastream private connection route. + (BETA) (DEPRECATED) This command has been deprecated. Use gcloud datastream + routes delete instead. + + Deletes a Datastream private connection route. EXAMPLES To delete a Datastream private connection route: diff --git a/gcloud/beta/datastream/routes/describe b/gcloud/beta/datastream/routes/describe index 8a7f0b66d..82bd3888d 100644 --- a/gcloud/beta/datastream/routes/describe +++ b/gcloud/beta/datastream/routes/describe @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Show details about the route. + (BETA) (DEPRECATED) This command has been deprecated. Use gcloud datastream + routes describe instead. + + Show details about the route. EXAMPLES To show details about a device, run: diff --git a/gcloud/beta/datastream/routes/help b/gcloud/beta/datastream/routes/help index 6d53658df..b2992aaad 100644 --- a/gcloud/beta/datastream/routes/help +++ b/gcloud/beta/datastream/routes/help @@ -16,16 +16,16 @@ COMMANDS COMMAND is one of the following: create - (BETA) Create a Datastream private connection route. + (BETA) (DEPRECATED) Create a Datastream private connection route. delete - (BETA) Delete a Datastream private connection route. + (BETA) (DEPRECATED) Delete a Datastream private connection route. describe - (BETA) Show details about the route. + (BETA) (DEPRECATED) Show details about the route. list - (BETA) List Datastream routes. + (BETA) (DEPRECATED) List Datastream routes. NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/datastream/routes/list b/gcloud/beta/datastream/routes/list index 6800519a6..ff332aa5f 100644 --- a/gcloud/beta/datastream/routes/list +++ b/gcloud/beta/datastream/routes/list @@ -8,7 +8,10 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) List Datastream routes. + (BETA) (DEPRECATED) This command has been deprecated. Use gcloud datastream + routes list instead. + + List Datastream routes. EXAMPLES To list the routes, run: diff --git a/gcloud/beta/datastream/streams/create b/gcloud/beta/datastream/streams/create index d0a246375..82994eaab 100644 --- a/gcloud/beta/datastream/streams/create +++ b/gcloud/beta/datastream/streams/create @@ -15,7 +15,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Create a Datastream stream + (BETA) (DEPRECATED) Datastream beta version is deprecated. Please + use`gcloud datastream streams create command instead. + + Create a Datastream stream EXAMPLES To create a stream with an Oracle source and Google Cloud Storage diff --git a/gcloud/beta/datastream/streams/delete b/gcloud/beta/datastream/streams/delete index 035fd8ae6..0b20c4c84 100644 --- a/gcloud/beta/datastream/streams/delete +++ b/gcloud/beta/datastream/streams/delete @@ -6,7 +6,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Deletes a stream. + (BETA) (DEPRECATED) This command has been deprecated. Use gcloud datastream + streams delete instead. + + Deletes a stream. EXAMPLES To delete a stream: diff --git a/gcloud/beta/datastream/streams/describe b/gcloud/beta/datastream/streams/describe index 3769f28ca..e16cc6266 100644 --- a/gcloud/beta/datastream/streams/describe +++ b/gcloud/beta/datastream/streams/describe @@ -7,7 +7,10 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Show details about a Datastream stream resource. + (BETA) (DEPRECATED) This command has been deprecated. Use gcloud datastream + streams describe instead. + + Show details about a Datastream stream resource. EXAMPLES To show details about a stream, run: diff --git a/gcloud/beta/datastream/streams/help b/gcloud/beta/datastream/streams/help index 9e2dae3da..be1758fa2 100644 --- a/gcloud/beta/datastream/streams/help +++ b/gcloud/beta/datastream/streams/help @@ -16,19 +16,19 @@ COMMANDS COMMAND is one of the following: create - (BETA) Creates a Datastream stream. + (BETA) (DEPRECATED) Creates a Datastream stream. delete - (BETA) Delete a Datastream stream. + (BETA) (DEPRECATED) Delete a Datastream stream. describe - (BETA) Show details about a Datastream stream resource. + (BETA) (DEPRECATED) Show details about a Datastream stream resource. list - (BETA) List Datastream stream resources. + (BETA) (DEPRECATED) List Datastream stream resources. update - (BETA) Updates a Datastream stream. + (BETA) (DEPRECATED) Updates a Datastream stream. NOTES This command is currently in beta and might change without notice. This diff --git a/gcloud/beta/datastream/streams/list b/gcloud/beta/datastream/streams/list index 917a95cfc..830c23e1d 100644 --- a/gcloud/beta/datastream/streams/list +++ b/gcloud/beta/datastream/streams/list @@ -7,7 +7,10 @@ SYNOPSIS [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) List Datastream stream resources. + (BETA) (DEPRECATED) This command has been deprecated. Use gcloud datastream + streams list instead. + + List Datastream stream resources. EXAMPLES To list all streams in a project and location 'us-central1', run: diff --git a/gcloud/beta/datastream/streams/update b/gcloud/beta/datastream/streams/update index 845c6c3ae..c1a6368ef 100644 --- a/gcloud/beta/datastream/streams/update +++ b/gcloud/beta/datastream/streams/update @@ -16,7 +16,10 @@ SYNOPSIS | --oracle-source-config=ORACLE_SOURCE_CONFIG] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Create a Datastream stream + (BETA) (DEPRECATED) Datastream beta version is deprecated. Please + use`gcloud datastream streams update command instead. + + Create a Datastream stream EXAMPLES To update a stream with a new source and new display name: diff --git a/gcloud/beta/healthcare/fhir-stores/export/bq b/gcloud/beta/healthcare/fhir-stores/export/bq index a3fb6c488..e40393add 100644 --- a/gcloud/beta/healthcare/fhir-stores/export/bq +++ b/gcloud/beta/healthcare/fhir-stores/export/bq @@ -72,6 +72,11 @@ REQUIRED FLAGS Analytics schema defined by the FHIR community. See https://github.com/rbrush/sql-on-fhir/blob/master/sql-on-fhir.md. + analytics_v2 + Analytics V2, similar to schema defined by the FHIR community, with + added support for extensions with one or more occurrences and + contained resources in stringified JSON. + lossless Schema generated from original FHIR data. diff --git a/gcloud/beta/sql/instances/create b/gcloud/beta/sql/instances/create index 07395ed18..811f6a7ed 100644 --- a/gcloud/beta/sql/instances/create +++ b/gcloud/beta/sql/instances/create @@ -94,8 +94,8 @@ FLAGS should be activated and is applicable only when the instance state is RUNNABLE. The default is on-demand. More information on activation policies can be found here: - https://cloud.google.com/sql/faq#activation_policy. ACTIVATION_POLICY - must be one of: always, never, on-demand. + https://cloud.google.com/sql/docs/mysql/start-stop-restart-instance#activation_policy. + ACTIVATION_POLICY must be one of: always, never, on-demand. --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 8eef1ef03..70b8878c6 100644 --- a/gcloud/beta/sql/instances/patch +++ b/gcloud/beta/sql/instances/patch @@ -61,8 +61,8 @@ FLAGS should be activated and is applicable only when the instance state is RUNNABLE. The default is on-demand. More information on activation policies can be found here: - https://cloud.google.com/sql/faq#activation_policy. ACTIVATION_POLICY - must be one of: always, never, on-demand. + https://cloud.google.com/sql/docs/mysql/start-stop-restart-instance#activation_policy. + ACTIVATION_POLICY must be one of: always, never, on-demand. --active-directory-domain=ACTIVE_DIRECTORY_DOMAIN Managed Service for Microsoft Active Directory domain this instance is diff --git a/gcloud/bigtable/help b/gcloud/bigtable/help index e3390ba0c..88ab99781 100644 --- a/gcloud/bigtable/help +++ b/gcloud/bigtable/help @@ -24,6 +24,9 @@ GROUPS clusters Manage Cloud Bigtable clusters. + hot-tablets + Manage Cloud Bigtable hot tablets. + instances Manage Cloud Bigtable instances. diff --git a/gcloud/bigtable/hot-tablets/help b/gcloud/bigtable/hot-tablets/help new file mode 100644 index 000000000..5528d015c --- /dev/null +++ b/gcloud/bigtable/hot-tablets/help @@ -0,0 +1,27 @@ +NAME + gcloud bigtable hot-tablets - manage Cloud Bigtable hot tablets + +SYNOPSIS + gcloud bigtable hot-tablets COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Cloud Bigtable hot tablets. + +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 hot tablets in a Cloud Bigtable cluster. + +NOTES + These variants are also available: + + $ gcloud alpha bigtable hot-tablets + + $ gcloud beta bigtable hot-tablets + diff --git a/gcloud/bigtable/hot-tablets/list b/gcloud/bigtable/hot-tablets/list new file mode 100644 index 000000000..be11b147f --- /dev/null +++ b/gcloud/bigtable/hot-tablets/list @@ -0,0 +1,114 @@ +NAME + gcloud bigtable hot-tablets list - list hot tablets in a Cloud Bigtable + cluster + +SYNOPSIS + gcloud bigtable hot-tablets list (CLUSTER : --instance=INSTANCE) + [--end-time=END_TIME] [--start-time=START_TIME] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List hot tablets in a Cloud Bigtable cluster. + +EXAMPLES + Search for hot tablets in the past 24 hours: + + $ gcloud bigtable hot-tablets list my-cluster-id \ + --instance=my-instance-id + + Search for hot tablets with start and end times by minute: + + $ gcloud bigtable hot-tablets list my-cluster-id \ + --instance=my-instance-id --start-time="2018-08-12 03:30:00" \ + --end-time="2018-08-13 17:00:00" + + Search for hot tablets with start and end times by day: + + $ gcloud bigtable hot-tablets list my-cluster-id \ + --instance=my-instance-id --start-time=2018-01-01 \ + --end-time=2018-01-05 + +POSITIONAL ARGUMENTS + Cluster resource - The cluster to list hot tablets for. 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; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. To + set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --instance=INSTANCE + Cloud Bigtable instance for the cluster. To set the instance + attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --instance on the command line. + +FLAGS + --end-time=END_TIME + End time of the time range to search for hot tablets. See $ gcloud + topic datetimes for information on time formats. + + --start-time=START_TIME + Start time of the time range to search for hot tablets. See $ gcloud + topic datetimes for information on time formats. + +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 bigtable hot-tablets list + + $ gcloud beta bigtable hot-tablets list + diff --git a/gcloud/composer/environments/run b/gcloud/composer/environments/run index 592f3483a..f660cd99c 100644 --- a/gcloud/composer/environments/run +++ b/gcloud/composer/environments/run @@ -22,6 +22,15 @@ EXAMPLES airflow trigger_dag some_dag --run_id=foo + The following command (for environments with Airflow 2.0+): + + gcloud composer environments run myenv dags list + + is equivalent to running the following command from a shell inside the + my-environment environment: + + airflow dags list + POSITIONAL ARGUMENTS Environment resource - The environment in which to run an Airflow command. The arguments in this group can be used to specify the attributes of this diff --git a/gcloud/compute/backend-services/create b/gcloud/compute/backend-services/create index aeb4d70f6..0ab1cff88 100644 --- a/gcloud/compute/backend-services/create +++ b/gcloud/compute/backend-services/create @@ -229,7 +229,14 @@ FLAGS --drop-traffic-if-unhealthy Enable dropping of traffic if there are no healthy VMs detected in both the primary and backup instance groups. Not compatible with the - --global flag and load balancing scheme must be INTERNAL or EXTERNAL. + --global flag. Applicable only for backend service-based network load + balancers and internal TCP/UDP load balancers as part of a connection + tracking policy. For details, see: Connection persistence on unhealthy + backends for internal TCP/UDP load balancing + (https://cloud.google.com/load-balancing/docs/internal#connection-persistence) + and Connection persistence on unhealthy backends for network load + balancing + (https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence). --[no-]enable-cdn Enable or disable Cloud CDN for the backend service. Only available for diff --git a/gcloud/compute/backend-services/update b/gcloud/compute/backend-services/update index 4191c5372..c314caa59 100644 --- a/gcloud/compute/backend-services/update +++ b/gcloud/compute/backend-services/update @@ -138,7 +138,14 @@ FLAGS --drop-traffic-if-unhealthy Enable dropping of traffic if there are no healthy VMs detected in both the primary and backup instance groups. Not compatible with the - --global flag and load balancing scheme must be INTERNAL or EXTERNAL. + --global flag. Applicable only for backend service-based network load + balancers and internal TCP/UDP load balancers as part of a connection + tracking policy. For details, see: Connection persistence on unhealthy + backends for internal TCP/UDP load balancing + (https://cloud.google.com/load-balancing/docs/internal#connection-persistence) + and Connection persistence on unhealthy backends for network load + balancing + (https://cloud.google.com/load-balancing/docs/network/networklb-backend-service#connection-persistence). --edge-security-policy=EDGE_SECURITY_POLICY The edge security policy that will be set for this backend service. To diff --git a/gcloud/compute/disks/snapshot b/gcloud/compute/disks/snapshot index d5e4eeaab..797b60004 100644 --- a/gcloud/compute/disks/snapshot +++ b/gcloud/compute/disks/snapshot @@ -14,7 +14,7 @@ DESCRIPTION Snapshots are useful for backing up data, copying a persistent disk, and even, creating a custom image. Snapshots can be created from persistent disks even while they are attached to running instances. Once created, - snapshots may be managed (listed, deleted, resized etc.) via gcloud compute + snapshots may be managed (listed, deleted, etc.) via gcloud compute snapshots. Refer to the Snapshot best practices guide. diff --git a/gcloud/compute/instances/set-scheduling b/gcloud/compute/instances/set-scheduling index e9f648045..09beec537 100644 --- a/gcloud/compute/instances/set-scheduling +++ b/gcloud/compute/instances/set-scheduling @@ -5,15 +5,16 @@ NAME SYNOPSIS gcloud compute instances set-scheduling INSTANCE_NAME [--clear-min-node-cpu] [--maintenance-policy=MAINTENANCE_POLICY] - [--min-node-cpu=MIN_NODE_CPU] [--preemptible] + [--min-node-cpu=MIN_NODE_CPU] [--[no-]preemptible] [--[no-]restart-on-failure] [--zone=ZONE] [--clear-node-affinities | --node=NODE | --node-affinity-file=NODE_AFFINITY_FILE | --node-group=NODE_GROUP] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - $gcloud compute instances set-scheduling is used to configure scheduling - options for Compute Engine virtual machines. + $gcloud compute instances set-scheduling is used to update scheduling + options for VM instances. You can only call this method on a VM instance + that is stopped (a VM instance in a TERMINATED state). EXAMPLES To set instance to be terminated during maintenance, run: @@ -50,11 +51,12 @@ FLAGS Minimum number of virtual CPUs this instance will consume when running on a sole-tenant node. - --preemptible + --[no-]preemptible If provided, instances will be preemptible and time-limited. Instances might be preempted to free up resources for standard VM instances, and will only be able to run for a limited amount of time. Preemptible - instances can not be restarted and will not migrate. + instances can not be restarted and will not migrate. Use --preemptible + to enable and --no-preemptible to disable. --[no-]restart-on-failure The instances will be restarted if they are terminated by Compute diff --git a/gcloud/compute/target-https-proxies/import b/gcloud/compute/target-https-proxies/import index f0a3f740c..ff2990222 100644 --- a/gcloud/compute/target-https-proxies/import +++ b/gcloud/compute/target-https-proxies/import @@ -9,11 +9,16 @@ DESCRIPTION Imports a target HTTPS proxy's configuration from a file. EXAMPLES - A target HTTPS proxy can be imported by running: + A global target HTTPS proxy can be imported by running: $ gcloud compute target-https-proxies import NAME \ --source= + A regional target HTTPS proxy can be imported by running: + + $ gcloud compute target-https-proxies import NAME \ + --source= --region=REGION_NAME + POSITIONAL ARGUMENTS NAME Name of the target HTTPS proxy to import. diff --git a/gcloud/data-catalog/entries/create b/gcloud/data-catalog/entries/create index 43106940b..74716bad0 100644 --- a/gcloud/data-catalog/entries/create +++ b/gcloud/data-catalog/entries/create @@ -23,7 +23,7 @@ EXAMPLES $ gcloud data-catalog entries create entry1 --location=us-central1 \ --entry-group=group1 \ --gcs-file-patterns="gs://bucket1/abc/*,gs://bucket1/file1" \ - --display-name="analytics data" type=FILESET + --display-name="analytics data" --type=FILESET To create an entry for a Google Cloud Storage fileset with an inline schema, run: diff --git a/gcloud/database-migration/connection-profiles/list b/gcloud/database-migration/connection-profiles/list index ab75ffa73..9db518164 100644 --- a/gcloud/database-migration/connection-profiles/list +++ b/gcloud/database-migration/connection-profiles/list @@ -21,7 +21,7 @@ EXAMPLES $ gcloud database-migration connection-profiles list \ --filter="state=READY" -REQUIRED FLAGS +FLAGS Region resource - The location you want to list the connection profiles for. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the @@ -31,8 +31,6 @@ REQUIRED FLAGS ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - --region=REGION ID of the region or fully qualified identifier for the region. To set the region attribute: diff --git a/gcloud/dataflow/flex-template/build b/gcloud/dataflow/flex-template/build index d4e6cfb11..c1973ee1e 100644 --- a/gcloud/dataflow/flex-template/build +++ b/gcloud/dataflow/flex-template/build @@ -13,6 +13,9 @@ SYNOPSIS [--additional-user-labels=[ADDITIONAL_USER_LABELS,...]] [--dataflow-kms-key=DATAFLOW_KMS_KEY] [--disable-public-ips] [--enable-streaming-engine] [--gcs-log-dir=GCS_LOG_DIR] + [--image-repository-cert-path=IMAGE_REPOSITORY_CERT_PATH] + [--image-repository-password-secret-id=IMAGE_REPOSITORY_PASSWORD_SECRET_ID] + [--image-repository-username-secret-id=IMAGE_REPOSITORY_USERNAME_SECRET_ID] [--max-workers=MAX_WORKERS] [--metadata-file=METADATA_FILE] [--network=NETWORK] [--num-workers=NUM_WORKERS] [--print-only] [--service-account-email=SERVICE_ACCOUNT_EMAIL] @@ -126,6 +129,30 @@ OPTIONAL FLAGS Google Cloud Storage directory to save build logs.(Must be a URL beginning with 'gs://'.) + --image-repository-cert-path=IMAGE_REPOSITORY_CERT_PATH + The full URL to self-signed certificate of private registry in Cloud + Storage. For example, gs://mybucket/mycerts/selfsigned.crt. The + certificate provided in Cloud Storage must be DER-encoded and may be + supplied in binary or printable (Base64) encoding. If the certificate + is provided in Base64 encoding, it must be bounded at the beginning by + -----BEGIN CERTIFICATE-----, and must be bounded at the end by -----END + CERTIFICATE-----. If this parameter is provided, the docker daemon in + the template launcher will be instructed to trust that certificate. + + --image-repository-password-secret-id=IMAGE_REPOSITORY_PASSWORD_SECRET_ID + Secret Manager secret id for the password to authenticate to private + registry. Should be in the format + projects/{project}/secrets/{secret}/versions/{secret_version} or + projects/{project}/secrets/{secret}. If the version is not provided + latest version will be used. + + --image-repository-username-secret-id=IMAGE_REPOSITORY_USERNAME_SECRET_ID + Secret Manager secret id for the username to authenticate to private + registry. Should be in the format + projects/{project}/secrets/{secret}/versions/{secret_version} or + projects/{project}/secrets/{secret}. If the version is not provided + latest version will be used. + --max-workers=MAX_WORKERS Default maximum number of workers to run. diff --git a/gcloud/dataproc/clusters/gke/create b/gcloud/dataproc/clusters/gke/create new file mode 100644 index 000000000..48bb5b2a2 --- /dev/null +++ b/gcloud/dataproc/clusters/gke/create @@ -0,0 +1,304 @@ +NAME + gcloud dataproc clusters gke create - create a GKE-based virtual cluster + +SYNOPSIS + gcloud dataproc clusters gke create (CLUSTER : --region=REGION) + --spark-engine-version=SPARK_ENGINE_VERSION + (--gke-cluster=GKE_CLUSTER + : --gke-cluster-location=GKE_CLUSTER_LOCATION) [--async] + [--namespace=NAMESPACE] [--pools=[KEY=VALUE[;VALUE],...]] + [--properties=[PREFIX:PROPERTY=VALUE,...]] [--setup-workload-identity] + [--staging-bucket=STAGING_BUCKET] + [--history-server-cluster=HISTORY_SERVER_CLUSTER + : --history-server-cluster-region=HISTORY_SERVER_CLUSTER_REGION] + [--metastore-service=METASTORE_SERVICE + : --metastore-service-location=METASTORE_SERVICE_LOCATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a GKE-based virtual cluster. + +EXAMPLES + Create a Dataproc on GKE cluster in us-central1 on a GKE cluster in the + same project and region with default values: + + $ gcloud dataproc clusters gke create my-cluster \ + --region=us-central1 --gke-cluster=my-gke-cluster \ + --spark-engine-version=latest --pools='name=dp,roles=default' + + Create a Dataproc on GKE cluster in us-central1 on a GKE cluster in the + same project and zone us-central1-f with default values: + + $ gcloud dataproc clusters gke create my-cluster \ + --region=us-central1 --gke-cluster=my-gke-cluster \ + --gke-cluster-location=us-central1-f \ + --spark-engine-version=3.1 --pools='name=dp,roles=default' + + Create a Dataproc on GKE cluster in us-central1 with machine type + 'e2-standard-4', autoscaling 5-15 nodes per zone. + + $ gcloud dataproc clusters gke create my-cluster \ + --region='us-central1' \ + --gke-cluster='projects/my-project/locations/us-central1/cluster\ + s/my-gke-cluster' --spark-engine-version=dataproc-1.5 \ + --pools='name=dp-default,roles=default,machineType=e2-standard-4\ + ,min=5,max=15' + + Create a Dataproc on GKE cluster in us-central1 with two distinct node + pools. + + $ gcloud dataproc clusters gke create my-cluster \ + --region='us-central1' --gke-cluster='my-gke-cluster' \ + --spark-engine-version='dataproc-2.0' \ + --pools='name=dp-default,roles=default,machineType=e2-standard-4\ + ' \ + --pools='name=workers,roles=spark-drivers;spark-executors,machin\ + eType=n2-standard-8 + +POSITIONAL ARGUMENTS + Cluster resource - The name of the cluster 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 cluster 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. + + CLUSTER + ID of the cluster or fully qualified identifier for the cluster. To + set the cluster attribute: + ▸ provide the argument cluster on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --region=REGION + Dataproc region for the cluster. Each Dataproc region constitutes an + independent resource namespace constrained to deploying instances + into Compute Engine zones inside the region. Overrides the default + dataproc/region property value for this command invocation. To set + the region attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property dataproc/region. + +REQUIRED FLAGS + --spark-engine-version=SPARK_ENGINE_VERSION + The version of the Spark engine to run on this cluster. + + Gke cluster resource - The GKE cluster to install the Dataproc cluster on. + 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 --gke-cluster 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. + + --gke-cluster=GKE_CLUSTER + ID of the gke-cluster or fully qualified identifier for the + gke-cluster. To set the gke-cluster attribute: + ▸ provide the argument --gke-cluster on the command line. + + This flag must be specified if any of the other arguments in this + group are specified. + + --gke-cluster-location=GKE_CLUSTER_LOCATION + GKE region for the gke-cluster. To set the gke-cluster-location + attribute: + ▸ provide the argument --gke-cluster on the command line with a + fully specified name; + ▸ provide the argument --gke-cluster-location on the command line; + ▸ provide the argument --region on the command line; + ▸ set the property dataproc/region. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --namespace=NAMESPACE + The name of the Kubernetes namespace to deploy Dataproc system + components in. This namespace does not need to exist. + + --pools=[KEY=VALUE[;VALUE],...] + Each --pools flag represents a single GKE node pool associated with the + virtual cluster. It is comprised of a CSV in the form + KEY=VALUE[;VALUE], where certain keys may have multiple values. + + The following KEYs must be specified: + + KEY Type Example Description + name string `my-node-pool` Name of the node pool. + roles repeated string `default;spark-driver` Roles that this node + pool should perform. + Valid values are + `default`, + `controller`, + `spark-driver`, + `spark-executor`. + + The following KEYs may be specified. + + KEY Type Example Description + machineType string `n1-standard-8` Compute + Engine + machine type + to use. + preemptible boolean `false` If true, + then this + node pool + uses + preemptible + VMs. This + cannot be + true on the + node pool + with the + `controllers + ` role (or + `default` + role if + `controllers + ` role is + not + specified). + localSsdCount int `2` The number + of local + SSDs to + attach to + each node. + accelerator repeated string `nvidia-tesla-a100=1` Accelerators + to attach to + each node. + In the + format + NAME=COUNT. + minCpuPlatform string `Intel Skylake` Minimum CPU + platform for + each node. + locations repeated string `us-west1-a;us-west1-c` Zones within + the location + of the GKE + cluster. All + `--pools` + flags for a + single + Dataproc + cluster must + have + identical + locations. + min int `0` Minimum + number of + nodes per + zone that + this node + pool can + scale down + to. + max int `10` Maximum + number of + nodes per + zone that + this node + pool can + scale up to. + + --properties=[PREFIX:PROPERTY=VALUE,...] + Specifies configuration properties for installed packages, such as + Spark. Properties are mapped to configuration files by specifying a + prefix, such as "core:io.serializations". + + --setup-workload-identity + Sets up the GKE Workload Identity for your Dataproc on GKE cluster. + Note that running this requires elevated permissions as it will + manipulate IAM policies on the Google Service Accounts that will be + used by your Dataproc on GKE cluster. + + --staging-bucket=STAGING_BUCKET + The Cloud Storage bucket to use to stage job dependencies, + miscellaneous config files, and job driver console output when using + this cluster. + + History server cluster resource - A Dataproc Cluster created as a History + Server, see + https://cloud.google.com/dataproc/docs/concepts/jobs/history-server 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 --history-server-cluster on the command line + with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --history-server-cluster=HISTORY_SERVER_CLUSTER + ID of the history-server-cluster or fully qualified identifier for + the history-server-cluster. To set the history-server-cluster + attribute: + ▸ provide the argument --history-server-cluster on the command + line. + + This flag must be specified if any of the other arguments in this + group are specified. + + --history-server-cluster-region=HISTORY_SERVER_CLUSTER_REGION + Compute Engine region for the history-server-cluster. It must be the + same region as the Dataproc cluster that is being created. To set the + history-server-cluster-region attribute: + ▸ provide the argument --history-server-cluster on the command line + with a fully specified name; + ▸ provide the argument --history-server-cluster-region on the + command line; + ▸ provide the argument --region on the command line; + ▸ set the property dataproc/region. + + Metastore service resource - Dataproc Metastore Service to be used as an + external metastore. 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 --metastore-service on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --metastore-service=METASTORE_SERVICE + ID of the metastore-service or fully qualified identifier for the + metastore-service. To set the metastore-service attribute: + ▸ provide the argument --metastore-service on the command line. + + This flag must be specified if any of the other arguments in this + group are specified. + + --metastore-service-location=METASTORE_SERVICE_LOCATION + Dataproc Metastore location for the metastore-service. To set the + metastore-service-location attribute: + ▸ provide the argument --metastore-service on the command line with + a fully specified name; + ▸ provide the argument --metastore-service-location on the command + line; + ▸ provide the argument --region on the command line; + ▸ set the property dataproc/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 + These variants are also available: + + $ gcloud alpha dataproc clusters gke create + + $ gcloud beta dataproc clusters gke create + diff --git a/gcloud/dataproc/clusters/gke/help b/gcloud/dataproc/clusters/gke/help new file mode 100644 index 000000000..ba180b6f5 --- /dev/null +++ b/gcloud/dataproc/clusters/gke/help @@ -0,0 +1,35 @@ +NAME + gcloud dataproc clusters gke - create Dataproc GKE-based virtual clusters + +SYNOPSIS + gcloud dataproc clusters gke COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + All interactions other than creation should be handled by "gcloud dataproc + clusters" commands. + +EXAMPLES + To create a cluster, run: + + $ gcloud dataproc clusters gke my-cluster --region='us-central1' \ + --gke-cluster='my-gke-cluster' --spark-engine-version='latest' \ + --pools='name=dp,roles=default' + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a GKE-based virtual cluster. + +NOTES + These variants are also available: + + $ gcloud alpha dataproc clusters gke + + $ gcloud beta dataproc clusters gke + diff --git a/gcloud/dataproc/clusters/help b/gcloud/dataproc/clusters/help index ffe37a72f..88c5064a9 100644 --- a/gcloud/dataproc/clusters/help +++ b/gcloud/dataproc/clusters/help @@ -2,7 +2,7 @@ NAME gcloud dataproc clusters - create and manage Dataproc clusters SYNOPSIS - gcloud dataproc clusters COMMAND [GCLOUD_WIDE_FLAG ...] + gcloud dataproc clusters GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create and manage Dataproc clusters. @@ -34,6 +34,12 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +GROUPS + GROUP is one of the following: + + gke + Create Dataproc GKE-based virtual clusters. + COMMANDS COMMAND is one of the following: diff --git a/gcloud/healthcare/fhir-stores/export/bq b/gcloud/healthcare/fhir-stores/export/bq index a2cc91d97..6b292a966 100644 --- a/gcloud/healthcare/fhir-stores/export/bq +++ b/gcloud/healthcare/fhir-stores/export/bq @@ -6,8 +6,9 @@ SYNOPSIS gcloud healthcare fhir-stores export bq (FHIR_STORE : --dataset=DATASET --location=LOCATION) --bq-dataset=BQ_DATASET --schema-type=SCHEMA_TYPE [--async] - [--recursive-depth=RECURSIVE_DEPTH] - [--write-disposition=WRITE_DISPOSITION] [GCLOUD_WIDE_FLAG ...] + [--recursive-depth=RECURSIVE_DEPTH] [--resource-type=RESOURCE_TYPE] + [--since=SINCE] [--write-disposition=WRITE_DISPOSITION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Export Cloud Healthcare API FHIR resources to BigQuery. @@ -83,6 +84,16 @@ OPTIONAL FLAGS called concept.concept but not concept.concept.concept. If not specified or set to 0, the server will use the default value 2. + --resource-type=RESOURCE_TYPE + String of comma-delimited FHIR resource types. If provided, only + resources of the specified resource type(s) are exported. + + --since=SINCE + If provided, only resources updated after this time are exported. The + time uses the format YYYY-MM-DDThh:mm:ss.sss+zz:zz. For example, + 2015-02-07T13:28:17.239+02:00 or 2017-01-01T00:00:00Z. The time must be + specified to the second and include a time zone. + --write-disposition=WRITE_DISPOSITION Determines whether existing tables in the destination dataset are overwritten or appended to. WRITE_DISPOSITION must be one of: diff --git a/gcloud/healthcare/fhir-stores/export/gcs b/gcloud/healthcare/fhir-stores/export/gcs index f7ee3aa0f..33ee9c93a 100644 --- a/gcloud/healthcare/fhir-stores/export/gcs +++ b/gcloud/healthcare/fhir-stores/export/gcs @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud healthcare fhir-stores export gcs (FHIR_STORE : --dataset=DATASET --location=LOCATION) --gcs-uri=GCS_URI - [--async] [GCLOUD_WIDE_FLAG ...] + [--async] [--resource-type=RESOURCE_TYPE] [--since=SINCE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Export Cloud Healthcare API FHIR resources to Google Cloud Storage. @@ -63,6 +64,16 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --resource-type=RESOURCE_TYPE + String of comma-delimited FHIR resource types. If provided, only + resources of the specified resource type(s) are exported. + + --since=SINCE + If provided, only resources updated after this time are exported. The + time uses the format YYYY-MM-DDThh:mm:ss.sss+zz:zz. For example, + 2015-02-07T13:28:17.239+02:00 or 2017-01-01T00:00:00Z. The time must be + specified to the second and include a time zone. + 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/spanner/instances/create b/gcloud/spanner/instances/create index 314daec69..e641a497f 100644 --- a/gcloud/spanner/instances/create +++ b/gcloud/spanner/instances/create @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud spanner instances create INSTANCE --config=CONFIG - --description=DESCRIPTION --nodes=NODES [--async] + --description=DESCRIPTION + (--nodes=NODES | --processing-units=PROCESSING_UNITS) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -29,8 +30,13 @@ REQUIRED FLAGS --description=DESCRIPTION Description of the instance. - --nodes=NODES - Number of nodes for the instance. + Exactly one of these must be specified: + + --nodes=NODES + Number of nodes for the instance. + + --processing-units=PROCESSING_UNITS + Number of processing units for the instance. OPTIONAL FLAGS --async diff --git a/gcloud/spanner/instances/update b/gcloud/spanner/instances/update index 22c440f50..8463931b7 100644 --- a/gcloud/spanner/instances/update +++ b/gcloud/spanner/instances/update @@ -3,7 +3,9 @@ NAME SYNOPSIS gcloud spanner instances update INSTANCE [--async] - [--description=DESCRIPTION] [--nodes=NODES] [GCLOUD_WIDE_FLAG ...] + [--description=DESCRIPTION] + [--nodes=NODES | --processing-units=PROCESSING_UNITS] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Update a Cloud Spanner instance. @@ -30,8 +32,13 @@ FLAGS --description=DESCRIPTION Description of the instance. - --nodes=NODES - Number of nodes for the instance. + At most one of these can be specified: + + --nodes=NODES + Number of nodes for the instance. + + --processing-units=PROCESSING_UNITS + Number of processing units for the instance. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/sql/instances/create b/gcloud/sql/instances/create index 1a818a8c9..63e765d00 100644 --- a/gcloud/sql/instances/create +++ b/gcloud/sql/instances/create @@ -83,8 +83,8 @@ FLAGS should be activated and is applicable only when the instance state is RUNNABLE. The default is on-demand. More information on activation policies can be found here: - https://cloud.google.com/sql/faq#activation_policy. ACTIVATION_POLICY - must be one of: always, never, on-demand. + https://cloud.google.com/sql/docs/mysql/start-stop-restart-instance#activation_policy. + ACTIVATION_POLICY must be one of: always, never, on-demand. --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 b61fead49..88a52f79f 100644 --- a/gcloud/sql/instances/patch +++ b/gcloud/sql/instances/patch @@ -55,8 +55,8 @@ FLAGS should be activated and is applicable only when the instance state is RUNNABLE. The default is on-demand. More information on activation policies can be found here: - https://cloud.google.com/sql/faq#activation_policy. ACTIVATION_POLICY - must be one of: always, never, on-demand. + https://cloud.google.com/sql/docs/mysql/start-stop-restart-instance#activation_policy. + ACTIVATION_POLICY must be one of: always, never, on-demand. --active-directory-domain=ACTIVE_DIRECTORY_DOMAIN Managed Service for Microsoft Active Directory domain this instance is