diff --git a/gcloud/_version b/gcloud/_version index 0bcbe4740..a558378f1 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 530.0.0 -alpha 2025.07.11 -beta 2025.07.11 -bq 2.1.19 +Google Cloud SDK 531.0.0 +alpha 2025.07.18 +beta 2025.07.18 +bq 2.1.20 bundled-python3-unix 3.12.9 -core 2025.07.11 +core 2025.07.18 gcloud-crc32c 1.0.0 gsutil 5.35 diff --git a/gcloud/alpha/alloydb/instances/create b/gcloud/alpha/alloydb/instances/create index 7697228c8..6f80a359d 100644 --- a/gcloud/alpha/alloydb/instances/create +++ b/gcloud/alpha/alloydb/instances/create @@ -10,6 +10,7 @@ SYNOPSIS [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] [--async] [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] [--availability-type=AVAILABILITY_TYPE] + [--connection-pooling-client-connection-idle-timeout=CONNECTION_POOLING_CLIENT_CONNECTION_IDLE_TIMEOUT] [--connection-pooling-ignore-startup-parameters=[STARTUP_PARAMETERS, ...]] [--connection-pooling-max-client-connections=CONNECTION_POOLING_MAX_CLIENT_CONNECTIONS] @@ -18,6 +19,7 @@ SYNOPSIS [--connection-pooling-pool-mode=CONNECTION_POOLING_POOL_MODE] [--connection-pooling-query-wait-timeout=CONNECTION_POOLING_QUERY_WAIT_TIMEOUT] [--connection-pooling-server-idle-timeout=CONNECTION_POOLING_SERVER_IDLE_TIMEOUT] + [--connection-pooling-server-lifetime=CONNECTION_POOLING_SERVER_LIFETIME] [--connection-pooling-stats-users=[STATS_USERS,...]] [--cpu-count=CPU_COUNT] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] [--[no-]enable-connection-pooling] @@ -125,6 +127,10 @@ OPTIONAL FLAGS production instances; instance does not automatically fail over to another zone. + --connection-pooling-client-connection-idle-timeout=CONNECTION_POOLING_CLIENT_CONNECTION_IDLE_TIMEOUT + The maximum number of seconds a client is allowed to be idle before it + is disconnected. + --connection-pooling-ignore-startup-parameters=[STARTUP_PARAMETERS,...] Comma-separated list of startup parameters that should be ignored by the connection pool. @@ -153,6 +159,12 @@ OPTIONAL FLAGS --connection-pooling-server-idle-timeout=CONNECTION_POOLING_SERVER_IDLE_TIMEOUT The server idle timeout for managed connection pooling. + --connection-pooling-server-lifetime=CONNECTION_POOLING_SERVER_LIFETIME + The lifetime of a server connection in seconds. The pooler will close + an unused (not currently linked to any client connection) server + connection that has been connected longer than this. Setting it to 0 + means the connection is to be used only once, then closed. + --connection-pooling-stats-users=[STATS_USERS,...] Comma-separated list of database users to access connection pooling stats. diff --git a/gcloud/alpha/alloydb/instances/update b/gcloud/alpha/alloydb/instances/update index c5fdc3ff4..1b9db37f4 100644 --- a/gcloud/alpha/alloydb/instances/update +++ b/gcloud/alpha/alloydb/instances/update @@ -10,6 +10,7 @@ SYNOPSIS [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] [--availability-type=AVAILABILITY_TYPE] [--clear-psc-network-attachment-uri] + [--connection-pooling-client-connection-idle-timeout=CONNECTION_POOLING_CLIENT_CONNECTION_IDLE_TIMEOUT] [--connection-pooling-ignore-startup-parameters=[STARTUP_PARAMETERS, ...]] [--connection-pooling-max-client-connections=CONNECTION_POOLING_MAX_CLIENT_CONNECTIONS] @@ -18,6 +19,7 @@ SYNOPSIS [--connection-pooling-pool-mode=CONNECTION_POOLING_POOL_MODE] [--connection-pooling-query-wait-timeout=CONNECTION_POOLING_QUERY_WAIT_TIMEOUT] [--connection-pooling-server-idle-timeout=CONNECTION_POOLING_SERVER_IDLE_TIMEOUT] + [--connection-pooling-server-lifetime=CONNECTION_POOLING_SERVER_LIFETIME] [--connection-pooling-stats-users=[STATS_USERS,...]] [--cpu-count=CPU_COUNT] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] [--[no-]enable-connection-pooling] @@ -111,6 +113,10 @@ OPTIONAL FLAGS Disable outbound connectivity from an AlloyDB instance which uses Private Service Connect (PSC). + --connection-pooling-client-connection-idle-timeout=CONNECTION_POOLING_CLIENT_CONNECTION_IDLE_TIMEOUT + The maximum number of seconds a client is allowed to be idle before it + is disconnected. + --connection-pooling-ignore-startup-parameters=[STARTUP_PARAMETERS,...] Comma-separated list of startup parameters that should be ignored by the connection pool. @@ -139,6 +145,12 @@ OPTIONAL FLAGS --connection-pooling-server-idle-timeout=CONNECTION_POOLING_SERVER_IDLE_TIMEOUT The server idle timeout for managed connection pooling. + --connection-pooling-server-lifetime=CONNECTION_POOLING_SERVER_LIFETIME + The lifetime of a server connection in seconds. The pooler will close + an unused (not currently linked to any client connection) server + connection that has been connected longer than this. Setting it to 0 + means the connection is to be used only once, then closed. + --connection-pooling-stats-users=[STATS_USERS,...] Comma-separated list of database users to access connection pooling stats. diff --git a/gcloud/alpha/compute/commitments/create b/gcloud/alpha/compute/commitments/create index 0b634e8d8..87398b2e4 100644 --- a/gcloud/alpha/compute/commitments/create +++ b/gcloud/alpha/compute/commitments/create @@ -39,7 +39,8 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --plan=PLAN - Duration of the commitment. PLAN must be one of: 12-month, 36-month. + Duration of the commitment. PLAN must be one of: 12-month, 36-month, + 60-month. Manage the commitment for particular resources. diff --git a/gcloud/alpha/compute/commitments/update b/gcloud/alpha/compute/commitments/update index 343f958f3..7d27f09ab 100644 --- a/gcloud/alpha/compute/commitments/update +++ b/gcloud/alpha/compute/commitments/update @@ -41,8 +41,7 @@ FLAGS term. --plan=PLAN - Duration of the commitment. PLAN must be (only one value is supported): - 36-month. + Duration of the commitment. PLAN must be one of: 36-month, 60-month. --region=REGION Region of the commitment to update. If not specified, you might be diff --git a/gcloud/alpha/compute/firewall-policies/force-start-progressive-rollout b/gcloud/alpha/compute/firewall-policies/force-start-progressive-rollout new file mode 100644 index 000000000..8beb0cef0 --- /dev/null +++ b/gcloud/alpha/compute/firewall-policies/force-start-progressive-rollout @@ -0,0 +1,49 @@ +NAME + gcloud alpha compute firewall-policies force-start-progressive-rollout - + starts a new rollout of organization firewall policy + +SYNOPSIS + gcloud alpha compute firewall-policies force-start-progressive-rollout + FIREWALL_POLICY [--organization=ORGANIZATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Starts a new rollout of organization firewall policy. + +EXAMPLES + To start a new rollout of an organization firewall policy with ID + ``123456789", run: + + $ gcloud alpha compute firewall-policies \ + force-start-progressive-rollout 123456789 + +POSITIONAL ARGUMENTS + FIREWALL_POLICY + Short name or ID of the firewall policy to start a new rollout of. + +FLAGS + --organization=ORGANIZATION + Organization in which the organization firewall policy to start the + rollout of resides. Must be set if firewall-policy is short name. + +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. + +IAM PERMISSIONS + To start rollout of a firewall policy, the user must have the following + permission: compute.firewallPolicies.update, compute.firewallPolicies.use', + *'compute.organizations.setFirewallPolicy'. + + To find predefined roles that contain those permissions, see the Compute + Engine IAM roles (https://cloud.google.com/compute/docs/access/iam). + +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/compute/firewall-policies/help b/gcloud/alpha/compute/firewall-policies/help index 8704f5747..ba99accb5 100644 --- a/gcloud/alpha/compute/firewall-policies/help +++ b/gcloud/alpha/compute/firewall-policies/help @@ -49,6 +49,9 @@ COMMANDS export-rules (ALPHA) Export Compute Engine organization firewall policy rules. + force-start-progressive-rollout + (ALPHA) Starts a new rollout of organization firewall policy. + import-rules (ALPHA) Import Compute Engine organization firewall policy rules. diff --git a/gcloud/alpha/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy b/gcloud/alpha/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy index 3c8999675..e58026903 100644 --- a/gcloud/alpha/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy +++ b/gcloud/alpha/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy @@ -56,5 +56,8 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute interconnects application-awareness \ + configure-bandwidth-percentage-policy diff --git a/gcloud/alpha/compute/interconnects/application-awareness/configure-shaper-average-percentage b/gcloud/alpha/compute/interconnects/application-awareness/configure-shaper-average-percentage index c3c78ddb7..a22d0a884 100644 --- a/gcloud/alpha/compute/interconnects/application-awareness/configure-shaper-average-percentage +++ b/gcloud/alpha/compute/interconnects/application-awareness/configure-shaper-average-percentage @@ -56,5 +56,8 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute interconnects application-awareness \ + configure-shaper-average-percentage diff --git a/gcloud/alpha/compute/interconnects/application-awareness/configure-strict-priority-policy b/gcloud/alpha/compute/interconnects/application-awareness/configure-strict-priority-policy index 26249d536..f0da2d7aa 100644 --- a/gcloud/alpha/compute/interconnects/application-awareness/configure-strict-priority-policy +++ b/gcloud/alpha/compute/interconnects/application-awareness/configure-strict-priority-policy @@ -48,5 +48,8 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute interconnects application-awareness \ + configure-strict-priority-policy diff --git a/gcloud/alpha/compute/interconnects/application-awareness/delete b/gcloud/alpha/compute/interconnects/application-awareness/delete index 08efb43ba..97a70d65e 100644 --- a/gcloud/alpha/compute/interconnects/application-awareness/delete +++ b/gcloud/alpha/compute/interconnects/application-awareness/delete @@ -36,5 +36,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute interconnects application-awareness delete diff --git a/gcloud/alpha/compute/interconnects/application-awareness/get-config b/gcloud/alpha/compute/interconnects/application-awareness/get-config index 9a714e742..86b56e65b 100644 --- a/gcloud/alpha/compute/interconnects/application-awareness/get-config +++ b/gcloud/alpha/compute/interconnects/application-awareness/get-config @@ -36,5 +36,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute interconnects application-awareness get-config diff --git a/gcloud/alpha/compute/interconnects/application-awareness/help b/gcloud/alpha/compute/interconnects/application-awareness/help index 7313911d0..12223a152 100644 --- a/gcloud/alpha/compute/interconnects/application-awareness/help +++ b/gcloud/alpha/compute/interconnects/application-awareness/help @@ -47,5 +47,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute interconnects application-awareness diff --git a/gcloud/alpha/compute/interconnects/application-awareness/update b/gcloud/alpha/compute/interconnects/application-awareness/update index eb7f1864b..3adb24eb7 100644 --- a/gcloud/alpha/compute/interconnects/application-awareness/update +++ b/gcloud/alpha/compute/interconnects/application-awareness/update @@ -46,5 +46,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta compute interconnects application-awareness update diff --git a/gcloud/alpha/compute/networks/subnets/create b/gcloud/alpha/compute/networks/subnets/create index 2e2a99df9..596a482ad 100644 --- a/gcloud/alpha/compute/networks/subnets/create +++ b/gcloud/alpha/compute/networks/subnets/create @@ -19,6 +19,7 @@ SYNOPSIS [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] [--purpose=PURPOSE] [--range=RANGE] [--region=REGION] [--reserved-internal-range=RESERVED_INTERNAL_RANGE] + [--resolve-subnet-mask=RESOLVE_SUBNET_MASK] [--resource-manager-tags=[KEY=VALUE,...]] [--role=ROLE] [--secondary-range=PROPERTY=VALUE,[...]] [--secondary-range-with-reserved-internal-range=RANGE_NAME=INTERNAL_RANGE_URL, @@ -205,6 +206,17 @@ OPTIONAL FLAGS --reserved-internal-range //networkconnectivity.googleapis.com/projects/PROJECT/locations/global/internalRanges/RANGE + --resolve-subnet-mask=RESOLVE_SUBNET_MASK + Resolve subnet mask can only be set when subnet is created. + RESOLVE_SUBNET_MASK must be one of: + + ARP_ALL_RANGES + All IP ranges assigned to VM NICs in this subnet will respond to + ARP + + ARP_PRIMARY_RANGE + Primary IP range of VM NICs in this subnet will respond to ARP. + --resource-manager-tags=[KEY=VALUE,...] A comma-separated list of Resource Manager tags to apply to the subnetwork. diff --git a/gcloud/alpha/compute/reservations/blocks/describe b/gcloud/alpha/compute/reservations/blocks/describe index 8cb690c99..6c802571d 100644 --- a/gcloud/alpha/compute/reservations/blocks/describe +++ b/gcloud/alpha/compute/reservations/blocks/describe @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud alpha compute reservations blocks describe RESERVATION - --block-name=BLOCK_NAME [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + --block-name=BLOCK_NAME + [--full-view=FULL_VIEW; default="BLOCK_VIEW_UNSPECIFIED"] [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Describe a Compute Engine reservation block. @@ -25,6 +27,14 @@ REQUIRED FLAGS The name of the reservation block. OPTIONAL FLAGS + --full-view=FULL_VIEW; default="BLOCK_VIEW_UNSPECIFIED" + The view type for the reservation block. FULL_VIEW must be one of: + + BLOCK_VIEW_BASIC + Basic default view of the reservation block. + BLOCK_VIEW_FULL + Full detailed view of the reservation block. + --zone=ZONE Zone of the reservation to describe. If not specified and the compute/zone property isn't set, you might be prompted to select a zone diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index 34f8a2d6b..b5139829a 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -100,6 +100,8 @@ SYNOPSIS enforcement-mode=ENFORCEMENT_MODE,...] --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE | --enable-binauthz] + [--boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS + --boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT] [--cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN --cluster-dns-scope=CLUSTER_DNS_SCOPE --additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN @@ -1807,6 +1809,16 @@ FLAGS The --enable-binauthz flag is deprecated. Please use --binauthz-evaluation-mode instead. + Configure boot disk options. + + --boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS + Configure the Provisioned IOPS for the node pool boot disks. Only + valid for hyperdisk-balanced boot disks. + + --boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT + Configure the Provisioned Throughput for the node pool boot disks. + Only valid for hyperdisk-throughput boot disks. + ClusterDNS --cluster-dns=CLUSTER_DNS diff --git a/gcloud/alpha/container/fleet/cloudrun/disable b/gcloud/alpha/container/fleet/cloudrun/disable index ae57dac41..430c49535 100644 --- a/gcloud/alpha/container/fleet/cloudrun/disable +++ b/gcloud/alpha/container/fleet/cloudrun/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/fleet/config-management/disable b/gcloud/alpha/container/fleet/config-management/disable index d4098c815..a6f4ae60a 100644 --- a/gcloud/alpha/container/fleet/config-management/disable +++ b/gcloud/alpha/container/fleet/config-management/disable @@ -32,8 +32,9 @@ FLAGS Does not change existing membership configurations. --force - Disable this feature, even if it is currently in use. Force - disablement may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/fleet/dataplane-v2-encryption/disable b/gcloud/alpha/container/fleet/dataplane-v2-encryption/disable index 041950da2..ee1ae2173 100644 --- a/gcloud/alpha/container/fleet/dataplane-v2-encryption/disable +++ b/gcloud/alpha/container/fleet/dataplane-v2-encryption/disable @@ -17,8 +17,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/fleet/fleetobservability/disable b/gcloud/alpha/container/fleet/fleetobservability/disable index 3e2d18a98..f5a07aa58 100644 --- a/gcloud/alpha/container/fleet/fleetobservability/disable +++ b/gcloud/alpha/container/fleet/fleetobservability/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/fleet/identity-service/disable b/gcloud/alpha/container/fleet/identity-service/disable index d39659700..83aa2b93a 100644 --- a/gcloud/alpha/container/fleet/identity-service/disable +++ b/gcloud/alpha/container/fleet/identity-service/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/fleet/ingress/disable b/gcloud/alpha/container/fleet/ingress/disable index 005f1dacc..ff17044aa 100644 --- a/gcloud/alpha/container/fleet/ingress/disable +++ b/gcloud/alpha/container/fleet/ingress/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/fleet/multi-cluster-services/disable b/gcloud/alpha/container/fleet/multi-cluster-services/disable index 712ad573a..7d84e3eda 100644 --- a/gcloud/alpha/container/fleet/multi-cluster-services/disable +++ b/gcloud/alpha/container/fleet/multi-cluster-services/disable @@ -17,8 +17,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/fleet/namespaceactuation/delete b/gcloud/alpha/container/fleet/namespaceactuation/delete index 841e4c5f6..0cb605788 100644 --- a/gcloud/alpha/container/fleet/namespaceactuation/delete +++ b/gcloud/alpha/container/fleet/namespaceactuation/delete @@ -18,8 +18,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/create b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/create index 75481b5ca..7c186bfbf 100644 --- a/gcloud/alpha/container/fleet/packages/resource-bundles/releases/create +++ b/gcloud/alpha/container/fleet/packages/resource-bundles/releases/create @@ -6,7 +6,8 @@ SYNOPSIS gcloud alpha container fleet packages resource-bundles releases create --resource-bundle=RESOURCE_BUNDLE --source=SOURCE --version=VERSION [--lifecycle=LIFECYCLE] [--location=LOCATION] - [--variants-pattern=VARIANTS_PATTERN] [GCLOUD_WIDE_FLAG ...] + [--variants-pattern=VARIANTS_PATTERN; default="*"] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create Package Rollouts Release. @@ -50,7 +51,7 @@ OPTIONAL FLAGS --location=LOCATION Google Cloud zone or region. - --variants-pattern=VARIANTS_PATTERN + --variants-pattern=VARIANTS_PATTERN; default="*" Glob pattern to Variants of the Release, to be paired with the --source arg. ex: --source=/manifests-dir/ --variants-pattern=**, --source=/manifests-dir/ --variants-pattern=us-*.yaml, diff --git a/gcloud/alpha/container/fleet/service-directory/disable b/gcloud/alpha/container/fleet/service-directory/disable index 092d75a9c..2edaf6072 100644 --- a/gcloud/alpha/container/fleet/service-directory/disable +++ b/gcloud/alpha/container/fleet/service-directory/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/fleet/workload-identity/disable b/gcloud/alpha/container/fleet/workload-identity/disable index 969922840..ba007872a 100644 --- a/gcloud/alpha/container/fleet/workload-identity/disable +++ b/gcloud/alpha/container/fleet/workload-identity/disable @@ -11,8 +11,9 @@ DESCRIPTION FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/hub/cloudrun/disable b/gcloud/alpha/container/hub/cloudrun/disable index 977c94e1b..71c30b4eb 100644 --- a/gcloud/alpha/container/hub/cloudrun/disable +++ b/gcloud/alpha/container/hub/cloudrun/disable @@ -15,8 +15,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/hub/config-management/disable b/gcloud/alpha/container/hub/config-management/disable index 9b710dd00..92a74d38d 100644 --- a/gcloud/alpha/container/hub/config-management/disable +++ b/gcloud/alpha/container/hub/config-management/disable @@ -32,8 +32,9 @@ FLAGS Does not change existing membership configurations. --force - Disable this feature, even if it is currently in use. Force - disablement may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/hub/dataplane-v2-encryption/disable b/gcloud/alpha/container/hub/dataplane-v2-encryption/disable index 862aeaef7..89ef171b8 100644 --- a/gcloud/alpha/container/hub/dataplane-v2-encryption/disable +++ b/gcloud/alpha/container/hub/dataplane-v2-encryption/disable @@ -17,8 +17,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/hub/fleetobservability/disable b/gcloud/alpha/container/hub/fleetobservability/disable index 6ea6e7d9f..d0b50371a 100644 --- a/gcloud/alpha/container/hub/fleetobservability/disable +++ b/gcloud/alpha/container/hub/fleetobservability/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/hub/identity-service/disable b/gcloud/alpha/container/hub/identity-service/disable index 15d569f17..6ee63f51b 100644 --- a/gcloud/alpha/container/hub/identity-service/disable +++ b/gcloud/alpha/container/hub/identity-service/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/hub/ingress/disable b/gcloud/alpha/container/hub/ingress/disable index e9f418805..c67983388 100644 --- a/gcloud/alpha/container/hub/ingress/disable +++ b/gcloud/alpha/container/hub/ingress/disable @@ -15,8 +15,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/hub/multi-cluster-services/disable b/gcloud/alpha/container/hub/multi-cluster-services/disable index a9cc00fcf..716ca0d41 100644 --- a/gcloud/alpha/container/hub/multi-cluster-services/disable +++ b/gcloud/alpha/container/hub/multi-cluster-services/disable @@ -17,8 +17,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/hub/namespaceactuation/delete b/gcloud/alpha/container/hub/namespaceactuation/delete index 957493e62..664a4e374 100644 --- a/gcloud/alpha/container/hub/namespaceactuation/delete +++ b/gcloud/alpha/container/hub/namespaceactuation/delete @@ -18,8 +18,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/hub/packages/resource-bundles/releases/create b/gcloud/alpha/container/hub/packages/resource-bundles/releases/create index 578aad62b..d7ab47c38 100644 --- a/gcloud/alpha/container/hub/packages/resource-bundles/releases/create +++ b/gcloud/alpha/container/hub/packages/resource-bundles/releases/create @@ -6,7 +6,8 @@ SYNOPSIS gcloud alpha container hub packages resource-bundles releases create --resource-bundle=RESOURCE_BUNDLE --source=SOURCE --version=VERSION [--lifecycle=LIFECYCLE] [--location=LOCATION] - [--variants-pattern=VARIANTS_PATTERN] [GCLOUD_WIDE_FLAG ...] + [--variants-pattern=VARIANTS_PATTERN; default="*"] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create Package Rollouts Release. @@ -50,7 +51,7 @@ OPTIONAL FLAGS --location=LOCATION Google Cloud zone or region. - --variants-pattern=VARIANTS_PATTERN + --variants-pattern=VARIANTS_PATTERN; default="*" Glob pattern to Variants of the Release, to be paired with the --source arg. ex: --source=/manifests-dir/ --variants-pattern=**, --source=/manifests-dir/ --variants-pattern=us-*.yaml, diff --git a/gcloud/alpha/container/hub/service-directory/disable b/gcloud/alpha/container/hub/service-directory/disable index 3856c5127..6521c0aeb 100644 --- a/gcloud/alpha/container/hub/service-directory/disable +++ b/gcloud/alpha/container/hub/service-directory/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/hub/workload-identity/disable b/gcloud/alpha/container/hub/workload-identity/disable index 139be4f80..4d9bf2a27 100644 --- a/gcloud/alpha/container/hub/workload-identity/disable +++ b/gcloud/alpha/container/hub/workload-identity/disable @@ -11,8 +11,9 @@ DESCRIPTION FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/node-pools/create b/gcloud/alpha/container/node-pools/create index 108ef5dec..79a47bd03 100644 --- a/gcloud/alpha/container/node-pools/create +++ b/gcloud/alpha/container/node-pools/create @@ -14,8 +14,10 @@ SYNOPSIS [--additional-pod-network=[subnetwork=SUBNETWORK_NAME, pod-ipv4-range=SECONDARY_RANGE_NAME, [max-pods-per-node=NUM_PODS],...]] [--async] - [--boot-disk-kms-key=BOOT_DISK_KMS_KEY] [--cluster=CLUSTER] - [--confidential-node-type=CONFIDENTIAL_NODE_TYPE] + [--boot-disk-kms-key=BOOT_DISK_KMS_KEY] + [--boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS] + [--boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT] + [--cluster=CLUSTER] [--confidential-node-type=CONFIDENTIAL_NODE_TYPE] [--containerd-config-from-file=PATH_TO_FILE] [--data-cache-count=DATA_CACHE_COUNT] [--disable-pod-cidr-overprovision] [--disk-size=DISK_SIZE] @@ -193,6 +195,14 @@ FLAGS please see: https://cloud.google.com/compute/docs/disks/customer-managed-encryption + --boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS + Configure the Provisioned IOPS for the node pool boot disks. Only valid + for hyperdisk-balanced boot disks. + + --boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT + Configure the Provisioned Throughput for the node pool boot disks. Only + valid for hyperdisk-throughput boot disks. + --cluster=CLUSTER The cluster to add the node pool to. Overrides the default container/cluster property value for this command invocation. diff --git a/gcloud/alpha/container/node-pools/update b/gcloud/alpha/container/node-pools/update index 439fa557a..b1957af75 100644 --- a/gcloud/alpha/container/node-pools/update +++ b/gcloud/alpha/container/node-pools/update @@ -30,7 +30,10 @@ SYNOPSIS --node-pool-soak-duration=NODE_POOL_SOAK_DURATION --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, batch-percent=BATCH_NODE_PERCENTAGE, - batch-soak-duration=BATCH_SOAK_DURATION,...] | --disk-size=DISK_SIZE + batch-soak-duration=BATCH_SOAK_DURATION,...] + | --boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS + --boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT + --disk-size=DISK_SIZE --disk-type=DISK_TYPE --machine-type=MACHINE_TYPE | --enable-autoprovisioning --enable-autoscaling --location-policy=LOCATION_POLICY --max-nodes=MAX_NODES @@ -646,6 +649,14 @@ REQUIRED FLAGS Node config + --boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS + Configure the Provisioned IOPS for the node pool boot disks. Only + valid for hyperdisk-balanced boot disks. + + --boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT + Configure the Provisioned Throughput for the node pool boot disks. + Only valid for hyperdisk-throughput boot disks. + --disk-size=DISK_SIZE Size for node VM boot disks in GB. Defaults to 100GB. diff --git a/gcloud/alpha/dataproc/clusters/diagnose b/gcloud/alpha/dataproc/clusters/diagnose index 81452d216..ee7ed1c2e 100644 --- a/gcloud/alpha/dataproc/clusters/diagnose +++ b/gcloud/alpha/dataproc/clusters/diagnose @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud alpha dataproc clusters diagnose (CLUSTER : --region=REGION) [--end-time=END_TIME] [--job-ids=JOB_IDS] [--start-time=START_TIME] - [--tarball-access=TARBALL_ACCESS] + [--tarball-access=TARBALL_ACCESS] [--tarball-gcs-dir=TARBALL_GCS_DIR] [--yarn-application-ids=YARN_APPLICATION_IDS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -65,9 +65,14 @@ FLAGS format). --tarball-access=TARBALL_ACCESS - Target access privileges for diagnose tarball. TARBALL_ACCESS must be + Target access privileges for diagnostic tarball. TARBALL_ACCESS must be one of: GOOGLE_CLOUD_SUPPORT, GOOGLE_DATAPROC_DIAGNOSE. + --tarball-gcs-dir=TARBALL_GCS_DIR + The output Cloud Storage directory for the diagnostic tarball. If not + specified, a task-specific directory in the cluster's staging bucket + will be used. + --yarn-application-ids=YARN_APPLICATION_IDS A list of yarn applications on which to perform the diagnosis. diff --git a/gcloud/alpha/filestore/instances/create b/gcloud/alpha/filestore/instances/create index 7fc68dc5a..d66723703 100644 --- a/gcloud/alpha/filestore/instances/create +++ b/gcloud/alpha/filestore/instances/create @@ -166,6 +166,11 @@ REQUIRED FLAGS ▫ KRB5P: KRB5I plus privacy protection (data packets are tamper proof and encrypted). + network + The source VPC network for ip-ranges. Required for instances using + Private Service Connect, optional otherwise. If provided, must be + the same network specified in the network.name field. + source-snapshot The name of the snapshot to restore from. Supported for BASIC instances only. diff --git a/gcloud/alpha/filestore/instances/update b/gcloud/alpha/filestore/instances/update index c7645d678..d30b9bdc9 100644 --- a/gcloud/alpha/filestore/instances/update +++ b/gcloud/alpha/filestore/instances/update @@ -216,6 +216,11 @@ FLAGS ▫ KRB5P: KRB5I plus privacy protection (data packets are tamper proof and encrypted). + network + The source VPC network for ip-ranges. Required for instances + using Private Service Connect, optional otherwise. If provided, + must be the same network specified in the network.name field. + source-snapshot The name of the snapshot to restore from. Supported for BASIC instances only. diff --git a/gcloud/alpha/firebase/test/android/run b/gcloud/alpha/firebase/test/android/run index 77e27b714..5b15d74e6 100644 --- a/gcloud/alpha/firebase/test/android/run +++ b/gcloud/alpha/firebase/test/android/run @@ -120,11 +120,13 @@ EXAMPLES Controlling Results Storage By default, Firebase Test Lab stores detailed test results for a limited - time in a Google Cloud Storage bucket provided for you at no charge. If you - wish to use a storage bucket that you control, or if you need to retain - detailed test results for a longer period, use the --results-bucket option. - See https://firebase.google.com/docs/test-lab/analyzing-results#detailed - for more information. + time in a Google Cloud Storage bucket provided for you at no charge. Note: + This requires the principal executing the test to have "roles/editor" role + for the project. If either you do not have that role, you wish to use a + storage bucket that you control, or you need to retain detailed test + results for a longer period, use the --results-bucket option. See + https://firebase.google.com/docs/test-lab/analyzing-results#detailed for + more information. Detailed test result files are prefixed by default with a timestamp and a random character string. If you require a predictable path where detailed diff --git a/gcloud/alpha/firestore/databases/clone b/gcloud/alpha/firestore/databases/clone deleted file mode 100644 index 8c0b9550a..000000000 --- a/gcloud/alpha/firestore/databases/clone +++ /dev/null @@ -1,138 +0,0 @@ -NAME - gcloud alpha firestore databases clone - clone a Google Cloud Firestore - database from another - -SYNOPSIS - gcloud alpha firestore databases clone - --destination-database=DESTINATION_DATABASE - --snapshot-time=SNAPSHOT_TIME --source-database=SOURCE_DATABASE - [--tags=[KEY=VALUE,...]] - [--encryption-type=ENCRYPTION_TYPE : --kms-key-name=KMS_KEY_NAME] - [GCLOUD_WIDE_FLAG ...] - -EXAMPLES - To clone a database from another: - - $ gcloud alpha firestore databases clone \ - --source-database=projects/PROJECT_ID/databases/\ - SOURCE_DATABASE --snapshot-time=2025-05-26T10:20:00.00Z \ - --destination-database=DATABASE_ID - - To clone to a CMEK-enabled database: - - $ gcloud alpha firestore databases clone \ - --source-database=projects/PROJECT_ID/databases/\ - SOURCE_DATABASE --snapshot-time=2025-05-26T10:20:00.00Z \ - --destination-database=DATABASE_ID \ - --encryption-type=customer-managed-encryption \ - --kms-key-name=projects/PROJECT_ID/locations/LOCATION_ID/\ - keyRings/KEY_RING_ID/cryptoKeys/CRYPTO_KEY_ID - -REQUIRED FLAGS - --destination-database=DESTINATION_DATABASE - Destination database to clone to. Destination database will be created - in the same location as the source database. - - This value should be 4-63 characters. Valid characters are - /[a-z][0-9]-/ with first character a letter and the last a letter or a - number. Must not be UUID-like /[0-9a-f]8(-[0-9a-f]4)3-[0-9a-f]12/. - - Using "(default)" database ID is also allowed. - - For example, to clone to database testdb: - - $ gcloud alpha firestore databases clone \ - --destination-database=testdb - - --snapshot-time=SNAPSHOT_TIME - Snapshot time at which to clone. This must be a whole minute, in the - past, and not earlier than the source database's earliest_version_time. - Additionally, if older than one hour in the past, PITR must be enabled - on the source database. - - For example, to restore from snapshot 2025-05-26T10:20:00.00Z of source - database source-db: - - $ gcloud alpha firestore databases clone \ - --source-database=projects/PROJECT_ID/databases/source-db \ - --snapshot-time=2025-05-26T10:20:00.00Z - - --source-database=SOURCE_DATABASE - The source database to clone from. - - For example, to clone from database source-db: - - $ gcloud alpha firestore databases clone \ - --source-database=projects/PROJECT_ID/databases/source-db - -OPTIONAL FLAGS - --tags=[KEY=VALUE,...] - Tags to attach to the destination database. Example: - --tags=key1=value1,key2=value2 - - For example, to attach tags to a database: - - $ --tags=key1=value1,key2=value2 - - The encryption configuration of the new database being created from the - database. If not specified, the same encryption settings as the database - will be used. - - To create a CMEK-enabled database: - - $ gcloud alpha firestore databases clone \ - --encryption-type=customer-managed-encryption \ - --kms-key-name=projects/PROJECT_ID/locations/LOCATION_ID/\ - keyRings/KEY_RING_ID/cryptoKeys/CRYPTO_KEY_ID - - To create a Google-default-encrypted database: - - $ gcloud alpha firestore databases clone \ - --encryption-type=google-default-encryption - - To create a database using the same encryption settings as the database: - - $ gcloud alpha firestore databases clone \ - --encryption-type=use-source-encryption - - --encryption-type=ENCRYPTION_TYPE - The encryption type of the destination database. ENCRYPTION_TYPE must - be one of: use-source-encryption, customer-managed-encryption, - google-default-encryption. - - This flag argument must be specified if any of the other arguments in - this group are specified. - - --kms-key-name=KMS_KEY_NAME - The resource ID of a Cloud KMS key. If set, the database created will - be a Customer-Managed Encryption Key (CMEK) database encrypted with - this key. This feature is allowlist only in initial launch. - - Only a key in the same location as this database is allowed to be - used for encryption. For Firestore's nam5 multi-region, this - corresponds to Cloud KMS location us. For Firestore's eur3 - multi-region, this corresponds to Cloud KMS location europe. See - https://cloud.google.com/kms/docs/locations. - - This value should be the KMS key resource ID in the format of - projects/{project_id}/locations/{kms_location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}. - How to retrieve this resource ID is listed at - https://cloud.google.com/kms/docs/getting-resource-ids#getting_the_id_for_a_key_and_version. - - This flag must only be specified when encryption-type is - customer-managed-encryption. - -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/firestore/databases/help b/gcloud/alpha/firestore/databases/help index be64f0b4f..6a8e0c889 100644 --- a/gcloud/alpha/firestore/databases/help +++ b/gcloud/alpha/firestore/databases/help @@ -16,9 +16,6 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: - clone - (ALPHA) Clone a Google Cloud Firestore database from another. - connection-string (ALPHA) Prints the mongo connection string for the given Firestore database. diff --git a/gcloud/alpha/gemini-cloud-assist/investigations/add-iam-policy-binding b/gcloud/alpha/gemini-cloud-assist/investigations/add-iam-policy-binding index 0fba97720..202302c63 100644 --- a/gcloud/alpha/gemini-cloud-assist/investigations/add-iam-policy-binding +++ b/gcloud/alpha/gemini-cloud-assist/investigations/add-iam-policy-binding @@ -4,8 +4,7 @@ NAME SYNOPSIS gcloud alpha gemini-cloud-assist investigations add-iam-policy-binding - (INVESTIGATION : --region=REGION) --member=PRINCIPAL --role=ROLE - [GCLOUD_WIDE_FLAG ...] + INVESTIGATION --member=PRINCIPAL --role=ROLE [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Adds an IAM policy binding for an investigation. @@ -28,9 +27,8 @@ EXAMPLES POSITIONAL ARGUMENTS Investigation resource - The investigation name to add IAM policy binding - 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. + for. This represents a Cloud resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. To set the project attribute: ◆ provide the argument investigation on the command line with a fully @@ -38,6 +36,11 @@ POSITIONAL ARGUMENTS ◆ provide the argument --project on the command line; ◆ set the property core/project. + To set the location attribute: + ◆ provide the argument investigation on the command line with a fully + specified name; + ◆ The default is global. + This must be specified. INVESTIGATION @@ -47,17 +50,6 @@ POSITIONAL ARGUMENTS To set the investigation attribute: ▸ provide the argument investigation on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - - --region=REGION - The Cloud region for the investigation. - - To set the region attribute: - ▸ provide the argument investigation on the command line with a - fully specified name; - ▸ provide the argument --region on the command line. - REQUIRED FLAGS --member=PRINCIPAL The principal to add the binding for. Should be of the form diff --git a/gcloud/alpha/gemini-cloud-assist/investigations/get-iam-policy b/gcloud/alpha/gemini-cloud-assist/investigations/get-iam-policy index a8a611f78..3361437c0 100644 --- a/gcloud/alpha/gemini-cloud-assist/investigations/get-iam-policy +++ b/gcloud/alpha/gemini-cloud-assist/investigations/get-iam-policy @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha gemini-cloud-assist investigations get-iam-policy - (INVESTIGATION : --region=REGION) [GCLOUD_WIDE_FLAG ...] + INVESTIGATION [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Get IAM policy for an investigation. @@ -19,10 +19,9 @@ EXAMPLES my-investigation POSITIONAL ARGUMENTS - Investigation resource - The investigation name to get IAM policy 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. + Investigation resource - The investigation name to get IAM policy for. + This represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project attribute: ◆ provide the argument investigation on the command line with a fully @@ -30,6 +29,11 @@ POSITIONAL ARGUMENTS ◆ provide the argument --project on the command line; ◆ set the property core/project. + To set the location attribute: + ◆ provide the argument investigation on the command line with a fully + specified name; + ◆ The default is global. + This must be specified. INVESTIGATION @@ -39,17 +43,6 @@ POSITIONAL ARGUMENTS To set the investigation attribute: ▸ provide the argument investigation on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - - --region=REGION - The Cloud region for the investigation. - - To set the region attribute: - ▸ provide the argument investigation on the command line with a - fully specified name; - ▸ provide the argument --region on the command line. - GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/gemini-cloud-assist/investigations/remove-iam-policy-binding b/gcloud/alpha/gemini-cloud-assist/investigations/remove-iam-policy-binding index 80eead1c0..1f21c0ec8 100644 --- a/gcloud/alpha/gemini-cloud-assist/investigations/remove-iam-policy-binding +++ b/gcloud/alpha/gemini-cloud-assist/investigations/remove-iam-policy-binding @@ -4,8 +4,7 @@ NAME SYNOPSIS gcloud alpha gemini-cloud-assist investigations remove-iam-policy-binding - (INVESTIGATION : --region=REGION) --member=PRINCIPAL --role=ROLE - [GCLOUD_WIDE_FLAG ...] + INVESTIGATION --member=PRINCIPAL --role=ROLE [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Removes an IAM policy binding from an investigation. @@ -28,9 +27,8 @@ EXAMPLES POSITIONAL ARGUMENTS Investigation resource - The investigation name to remove IAM policy - binding from. 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. + binding from. This represents a Cloud resource. (NOTE) Some attributes are + not given arguments in this group but can be set in other ways. To set the project attribute: ◆ provide the argument investigation on the command line with a fully @@ -38,6 +36,11 @@ POSITIONAL ARGUMENTS ◆ provide the argument --project on the command line; ◆ set the property core/project. + To set the location attribute: + ◆ provide the argument investigation on the command line with a fully + specified name; + ◆ The default is global. + This must be specified. INVESTIGATION @@ -47,17 +50,6 @@ POSITIONAL ARGUMENTS To set the investigation attribute: ▸ provide the argument investigation on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - - --region=REGION - The Cloud region for the investigation. - - To set the region attribute: - ▸ provide the argument investigation on the command line with a - fully specified name; - ▸ provide the argument --region on the command line. - REQUIRED FLAGS --member=PRINCIPAL The principal to add the binding for. Should be of the form diff --git a/gcloud/alpha/gemini-cloud-assist/investigations/set-iam-policy b/gcloud/alpha/gemini-cloud-assist/investigations/set-iam-policy index 225c38d2f..977b84e7f 100644 --- a/gcloud/alpha/gemini-cloud-assist/investigations/set-iam-policy +++ b/gcloud/alpha/gemini-cloud-assist/investigations/set-iam-policy @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha gemini-cloud-assist investigations set-iam-policy - (INVESTIGATION : --region=REGION) POLICY_FILE [GCLOUD_WIDE_FLAG ...] + INVESTIGATION POLICY_FILE [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Sets IAM policy for an investigation. @@ -20,9 +20,8 @@ EXAMPLES POSITIONAL ARGUMENTS Investigation resource - The investigation name to remove IAM policy - binding from. 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. + binding from. This represents a Cloud resource. (NOTE) Some attributes are + not given arguments in this group but can be set in other ways. To set the project attribute: ◆ provide the argument investigation on the command line with a fully @@ -30,6 +29,11 @@ POSITIONAL ARGUMENTS ◆ provide the argument --project on the command line; ◆ set the property core/project. + To set the location attribute: + ◆ provide the argument investigation on the command line with a fully + specified name; + ◆ The default is global. + This must be specified. INVESTIGATION @@ -39,17 +43,6 @@ POSITIONAL ARGUMENTS To set the investigation attribute: ▸ provide the argument investigation on the command line. - This positional argument must be specified if any of the other - arguments in this group are specified. - - --region=REGION - The Cloud region for the investigation. - - To set the region attribute: - ▸ provide the argument investigation on the command line with a - fully specified name; - ▸ provide the argument --region on the command line. - POLICY_FILE Path to a local JSON or YAML formatted file containing a valid policy. diff --git a/gcloud/alpha/iap/settings/set b/gcloud/alpha/iap/settings/set index 75a7b2e11..0965806ac 100644 --- a/gcloud/alpha/iap/settings/set +++ b/gcloud/alpha/iap/settings/set @@ -99,49 +99,54 @@ POSITIONAL ARGUMENTS SETTING_FILE JSON or YAML file containing the IAP resource settings. - JSON example: - { - "access_settings" : { - "oauth_settings" : { - "login_hint" : { - "value": "test_hint" - } - }, - "gcip_settings" : { - "tenant_ids": ["tenant1-p9puj", "tenant2-y8rxc"], - "login_page_uri" : { - "value" : "https://test.com/?apiKey=abcd_efgh" - } - }, - "cors_settings": { - "allow_http_options" : { - "value": true - } - } - }, - "application_settings" : { - "csm_settings" : { - "rctoken_aud" : { - "value" : "test_aud" - } - } - } - } + JSON example: + + { + "access_settings": { + "oauth_settings": { + "login_hint": { + "value": "test_hint" + } + }, + "gcip_settings": { + "tenant_ids": [ + "tenant1-p9puj", + "tenant2-y8rxc" + ], + "login_page_uri": { + "value": "https://test.com/?apiKey=abcd_efgh" + } + }, + "cors_settings": { + "allow_http_options": { + "value": true + } + } + }, + "application_settings": { + "csm_settings": { + "rctoken_aud": { + "value": "test_aud" + } + } + } + } + + YAML example: - YAML example: accessSettings : - oauthSettings: - loginHint: test_hint - gcipSettings: - tenantIds: - - tenant1-p9puj - - tenant2-y8rxc - loginPageUri: https://test.com/?apiKey=abcd_efgh - corsSettings: - allowHttpOptions: true + oauthSettings: + loginHint: test_hint + gcipSettings: + tenantIds: + - tenant1-p9puj + - tenant2-y8rxc + loginPageUri: https://test.com/?apiKey=abcd_efgh + corsSettings: + allowHttpOptions: true applicationSettings: - csmSettings: - rctokenAud: test_aud + csmSettings: + rctokenAud: test_aud FLAGS --folder=FOLDER diff --git a/gcloud/alpha/lustre/instances/create b/gcloud/alpha/lustre/instances/create index ca01619b8..b8ae5a01e 100644 --- a/gcloud/alpha/lustre/instances/create +++ b/gcloud/alpha/lustre/instances/create @@ -96,7 +96,8 @@ OPTIONAL FLAGS --gke-support-enabled Indicates whether you want to enable support for GKE clients. By - default, GKE clients are not supported. + default, GKE clients are not supported. Deprecated. No longer required + for GKE instance creation. --labels=[LABELS,...] Labels as key value pairs. diff --git a/gcloud/alpha/lustre/instances/update b/gcloud/alpha/lustre/instances/update index 71fbdf26f..5b2762da4 100644 --- a/gcloud/alpha/lustre/instances/update +++ b/gcloud/alpha/lustre/instances/update @@ -67,8 +67,9 @@ FLAGS --[no-]gke-support-enabled Indicates whether you want to enable support for GKE clients. By - default, GKE clients are not supported. Use --gke-support-enabled to - enable and --no-gke-support-enabled to disable. + default, GKE clients are not supported. Deprecated. No longer required + for GKE instance creation. Use --gke-support-enabled to enable and + --no-gke-support-enabled to disable. --per-unit-storage-throughput=PER_UNIT_STORAGE_THROUGHPUT The throughput of the instance in MB/s/TiB. Valid values are 125, 250, diff --git a/gcloud/alpha/migration/vms/image-imports/create b/gcloud/alpha/migration/vms/image-imports/create index 55e9f1b78..7b94afa15 100644 --- a/gcloud/alpha/migration/vms/image-imports/create +++ b/gcloud/alpha/migration/vms/image-imports/create @@ -11,9 +11,8 @@ SYNOPSIS [--labels=[KEY=VALUE,...]] [--single-region-storage] [--target-project=TARGET_PROJECT] [--skip-os-adaptation | --adaptation-modifiers=ADAPTATION_MODIFIERS - --boot-conversion=BOOT_CONVERSION --generalize - --license-type=LICENSE_TYPE - --rootfs-uuid=ROOTFS_UUID --suppress-package-installation-failure] + --boot-conversion=BOOT_CONVERSION + --generalize --license-type=LICENSE_TYPE --rootfs-uuid=ROOTFS_UUID] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -141,10 +140,6 @@ OPTIONAL FLAGS --rootfs-uuid=ROOTFS_UUID Identifies the file system to adapt. - --suppress-package-installation-failure - If true, suppress package installation failure and continue with a - warning. - 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/migration/vms/machine-image-imports/create b/gcloud/alpha/migration/vms/machine-image-imports/create index da0f2cd4c..5e9dec57a 100644 --- a/gcloud/alpha/migration/vms/machine-image-imports/create +++ b/gcloud/alpha/migration/vms/machine-image-imports/create @@ -16,9 +16,8 @@ SYNOPSIS [--enable-integrity-monitoring --enable-vtpm --secure-boot=SECURE_BOOT] [--scopes=[SCOPES,...] --service-account=SERVICE_ACCOUNT] [--skip-os-adaptation | --adaptation-modifiers=ADAPTATION_MODIFIERS - --boot-conversion=BOOT_CONVERSION --generalize - --license-type=LICENSE_TYPE - --rootfs-uuid=ROOTFS_UUID --suppress-package-installation-failure] + --boot-conversion=BOOT_CONVERSION + --generalize --license-type=LICENSE_TYPE --rootfs-uuid=ROOTFS_UUID] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -188,10 +187,6 @@ OPTIONAL FLAGS --rootfs-uuid=ROOTFS_UUID Identifies the file system to adapt. - --suppress-package-installation-failure - If true, suppress package installation failure and continue with a - warning. - 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/netapp/volumes/create b/gcloud/alpha/netapp/volumes/create index 6be181f93..9da54b4d1 100644 --- a/gcloud/alpha/netapp/volumes/create +++ b/gcloud/alpha/netapp/volumes/create @@ -31,7 +31,7 @@ SYNOPSIS [--snap-reserve=SNAP_RESERVE] [--snapshot-daily=[hour=HOUR], [minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] - [--snapshot-directory=SNAPSHOT_DIRECTORY] + [--snapshot-directory=SNAPSHOT_DIRECTORY; default="true"] [--snapshot-hourly=[minute=MINUTE], [snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--snapshot-monthly=[day=DAY], @@ -231,7 +231,7 @@ OPTIONAL FLAGS --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 - --snapshot-directory=SNAPSHOT_DIRECTORY + --snapshot-directory=SNAPSHOT_DIRECTORY; default="true" Snapshot Directory if enabled (true) makes the Volume contain a read-only .snapshot directory which provides access to each of the volume's snapshots diff --git a/gcloud/alpha/netapp/volumes/update b/gcloud/alpha/netapp/volumes/update index fb0b32619..fe1893287 100644 --- a/gcloud/alpha/netapp/volumes/update +++ b/gcloud/alpha/netapp/volumes/update @@ -21,7 +21,7 @@ SYNOPSIS [--snap-reserve=SNAP_RESERVE] [--snapshot-daily=[hour=HOUR], [minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] - [--snapshot-directory=SNAPSHOT_DIRECTORY] + [--snapshot-directory=SNAPSHOT_DIRECTORY; default="true"] [--snapshot-hourly=[minute=MINUTE], [snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--snapshot-monthly=[day=DAY], @@ -140,7 +140,7 @@ FLAGS --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 - --snapshot-directory=SNAPSHOT_DIRECTORY + --snapshot-directory=SNAPSHOT_DIRECTORY; default="true" Snapshot Directory if enabled (true) makes the Volume contain a read-only .snapshot directory which provides access to each of the volume's snapshots diff --git a/gcloud/alpha/network-services/multicast-domain-activations/help b/gcloud/alpha/network-services/multicast-domain-activations/help index bbb3422a1..2c0d01194 100644 --- a/gcloud/alpha/network-services/multicast-domain-activations/help +++ b/gcloud/alpha/network-services/multicast-domain-activations/help @@ -29,6 +29,9 @@ COMMANDS list (ALPHA) List multicast domain activations. + update + (ALPHA) Update a multicast domain activation. + 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/network-services/multicast-domain-activations/update b/gcloud/alpha/network-services/multicast-domain-activations/update new file mode 100644 index 000000000..afa8e2647 --- /dev/null +++ b/gcloud/alpha/network-services/multicast-domain-activations/update @@ -0,0 +1,136 @@ +NAME + gcloud alpha network-services multicast-domain-activations update - update + a multicast domain activation + +SYNOPSIS + gcloud alpha network-services multicast-domain-activations update + (MULTICAST_DOMAIN_ACTIVATION : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--aggr-egress-pps=AGGR_EGRESS_PPS --aggr-ingress-pps=AGGR_INGRESS_PPS + --avg-packet-size=AVG_PACKET_SIZE + --max-per-group-ingress-pps=MAX_PER_GROUP_INGRESS_PPS + --max-per-group-subscribers=MAX_PER_GROUP_SUBSCRIBERS] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a multicast domain activation in the specified location of + the current project. + +EXAMPLES + Update a multicast domain activation with the name + my-multicast-domain-activation and location zone. + + $ gcloud alpha network-services multicast-domain-activations \ + update my-multicast-domain-activation --aggr-egress-pps=10000 \ + --max-per-group-subscribers=10 --location=zone + +POSITIONAL ARGUMENTS + Multicast domain activation resource - Name of the multicast domain + activation to be updated. 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 multicast_domain_activation 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. + + MULTICAST_DOMAIN_ACTIVATION + ID of the multicast domain activation or fully qualified identifier + for the multicast domain activation. + + To set the multicast_domain_activation attribute: + ▸ provide the argument multicast_domain_activation on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain_activation on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the multicast domain activation. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --aggr-egress-pps=AGGR_EGRESS_PPS + Aggregated egress packets per second for all multicast groups in the + domain in this zone. + + --aggr-ingress-pps=AGGR_INGRESS_PPS + Aggregated ingress Packet-Per-Second for all multicast groups in the + domain in this zone. + + --avg-packet-size=AVG_PACKET_SIZE + Average packet size (defaults to 512 bytes). + + --max-per-group-ingress-pps=MAX_PER_GROUP_INGRESS_PPS + Maximum ingress Packet-Per-Second for a single multicast group in this + zone. + + --max-per-group-subscribers=MAX_PER_GROUP_SUBSCRIBERS + Maximum number of subscribers for a single multicast group in this + zone. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud alpha network-services multicast-domain-activations \ + update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud alpha network-services multicast-domain-activations \ + update --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-services multicast-domain-activations update + diff --git a/gcloud/alpha/pubsub/subscriptions/create b/gcloud/alpha/pubsub/subscriptions/create index 190199fa3..ae5257c16 100644 --- a/gcloud/alpha/pubsub/subscriptions/create +++ b/gcloud/alpha/pubsub/subscriptions/create @@ -298,7 +298,7 @@ OPTIONAL FLAGS --max-retry-delay=MAX_RETRY_DELAY The maximum delay between consecutive deliveries of a given message. - Value should be between 0 and 600 seconds. Defaults to 10 seconds. + Value should be between 0 and 600 seconds. Defaults to 600 seconds. Valid values are strings of the form INTEGER[UNIT], where UNIT is one of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. diff --git a/gcloud/alpha/pubsub/subscriptions/update b/gcloud/alpha/pubsub/subscriptions/update index 2f31669cf..d420961ef 100644 --- a/gcloud/alpha/pubsub/subscriptions/update +++ b/gcloud/alpha/pubsub/subscriptions/update @@ -333,7 +333,7 @@ FLAGS --max-retry-delay=MAX_RETRY_DELAY The maximum delay between consecutive deliveries of a given - message. Value should be between 0 and 600 seconds. Defaults to 10 + message. Value should be between 0 and 600 seconds. Defaults to 600 seconds. Valid values are strings of the form INTEGER[UNIT], where UNIT is one of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. diff --git a/gcloud/alpha/run/jobs/create b/gcloud/alpha/run/jobs/create index 9b035db11..cd5ae3588 100644 --- a/gcloud/alpha/run/jobs/create +++ b/gcloud/alpha/run/jobs/create @@ -16,8 +16,8 @@ SYNOPSIS [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --image=IMAGE - --memory=MEMORY - --remove-volume-mount=[MOUNT_PATH,...] --clear-env-vars + --memory=MEMORY --remove-volume-mount=[MOUNT_PATH,...] + --startup-probe=[KEY=VALUE,...] --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets @@ -264,6 +264,23 @@ FLAGS Removes the volume mounted at the specified path from the current container. + --startup-probe=[KEY=VALUE,...] + Comma separated settings for startup probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: initialDelaySeconds, timeoutSeconds, + periodSeconds, failureThreshold, httpGet.port, httpGet.path, + grpc.port, grpc.service, tcpSocket.port. + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --startup-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --startup-probe="" + At most one of these can be specified: --clear-env-vars diff --git a/gcloud/alpha/run/jobs/deploy b/gcloud/alpha/run/jobs/deploy index ee9a65a0a..65c2cfb1b 100644 --- a/gcloud/alpha/run/jobs/deploy +++ b/gcloud/alpha/run/jobs/deploy @@ -17,7 +17,8 @@ SYNOPSIS [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --memory=MEMORY - --remove-volume-mount=[MOUNT_PATH,...] --clear-env-vars + --remove-volume-mount=[MOUNT_PATH,...] + --startup-probe=[KEY=VALUE,...] --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets @@ -265,6 +266,23 @@ FLAGS Removes the volume mounted at the specified path from the current container. + --startup-probe=[KEY=VALUE,...] + Comma separated settings for startup probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: initialDelaySeconds, timeoutSeconds, + periodSeconds, failureThreshold, httpGet.port, httpGet.path, + grpc.port, grpc.service, tcpSocket.port. + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --startup-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --startup-probe="" + At most one of these can be specified: --clear-env-vars diff --git a/gcloud/alpha/run/jobs/update b/gcloud/alpha/run/jobs/update index 213a45fbf..e083b2945 100644 --- a/gcloud/alpha/run/jobs/update +++ b/gcloud/alpha/run/jobs/update @@ -19,8 +19,8 @@ SYNOPSIS [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --image=IMAGE - --memory=MEMORY - --remove-volume-mount=[MOUNT_PATH,...] --clear-env-vars + --memory=MEMORY --remove-volume-mount=[MOUNT_PATH,...] + --startup-probe=[KEY=VALUE,...] --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets @@ -280,6 +280,23 @@ FLAGS Removes the volume mounted at the specified path from the current container. + --startup-probe=[KEY=VALUE,...] + Comma separated settings for startup probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: initialDelaySeconds, timeoutSeconds, + periodSeconds, failureThreshold, httpGet.port, httpGet.path, + grpc.port, grpc.service, tcpSocket.port. + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --startup-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --startup-probe="" + At most one of these can be specified: --clear-env-vars diff --git a/gcloud/alpha/run/worker-pools/add-iam-policy-binding b/gcloud/alpha/run/worker-pools/add-iam-policy-binding new file mode 100644 index 000000000..82f953385 --- /dev/null +++ b/gcloud/alpha/run/worker-pools/add-iam-policy-binding @@ -0,0 +1,138 @@ +NAME + gcloud alpha run worker-pools add-iam-policy-binding - add IAM policy + binding to a Cloud Run worker pool + +SYNOPSIS + gcloud alpha run worker-pools add-iam-policy-binding + (WORKERPOOL : --region=REGION) --member=PRINCIPAL --role=ROLE + [--condition=[KEY=VALUE,...] | --condition-from-file=PATH_TO_FILE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Add an IAM policy binding to the IAM policy of a Cloud Run worker + pool. One binding consists of a member, and a role. + +EXAMPLES + To add an IAM policy binding for the role of 'roles/run.developer' for the + user 'test-user@gmail.com' with worker pool 'my-worker-pool' and region + 'us-central1', run: + + $ gcloud alpha run worker-pools add-iam-policy-binding \ + my-worker-pool --region='us-central1' \ + --member='user:test-user@gmail.com' --role='roles/run.developer' + + See https://cloud.google.com/iam/docs/managing-policies for details of + policy role and member types. + +POSITIONAL ARGUMENTS + Workerpool resource - The worker pool for which to add IAM policy binding + to. The arguments in this group can be used to specify the attributes of + this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument workerpool 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. + + WORKERPOOL + ID of the workerpool or fully qualified identifier for the + workerpool. + + To set the workerpool attribute: + ▸ provide the argument workerpool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The Cloud Run region. + + To set the region attribute: + ▸ provide the argument workerpool on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property run/region; + ▸ specify from a list of available regions in a prompt. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to add the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + Role name to assign to the principal. The role name is the complete + path of a predefined role, such as roles/logging.viewer, or the role ID + for a custom role, such as + organizations/{ORGANIZATION_ID}/roles/logging.viewer. + +OPTIONAL FLAGS + At most one of these can be specified: + + --condition=[KEY=VALUE,...] + A condition to include in the binding. When the condition is + explicitly specified as None (--condition=None), a binding without a + condition is added. When the condition is specified and is not None, + --role cannot be a basic role. Basic roles are roles/editor, + roles/owner, and roles/viewer. For more on conditions, refer to the + conditions overview guide: + https://cloud.google.com/iam/docs/conditions-overview + + When using the --condition flag, include the following key-value + pairs: + + expression + (Required) Condition expression that evaluates to True or False. + This uses a subset of Common Expression Language syntax. + + If the condition expression includes a comma, use a different + delimiter to separate the key-value pairs. Specify the delimiter + before listing the key-value pairs. For example, to specify a + colon (:) as the delimiter, do the following: + --condition=^:^title=TITLE:expression=EXPRESSION. For more + information, see + https://cloud.google.com/sdk/gcloud/reference/topic/escaping. + + title + (Required) A short string describing the purpose of the + expression. + + description + (Optional) Additional description for the expression. + + --condition-from-file=PATH_TO_FILE + Path to a local JSON or YAML file that defines the condition. To see + available fields, see the help for --condition. Use a full or + relative path to a local file containing the value of condition. + +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 run/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/run/ + +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/run/worker-pools/deploy b/gcloud/alpha/run/worker-pools/deploy index d4f50306e..657d36769 100644 --- a/gcloud/alpha/run/worker-pools/deploy +++ b/gcloud/alpha/run/worker-pools/deploy @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud alpha run worker-pools deploy [[WORKER_POOL] --region=REGION] [--async] [--breakglass=JUSTIFICATION] [--container=CONTAINER] - [--description=DESCRIPTION] [--max=MAX] [--mesh=MESH] [--min=MIN] + [--description=DESCRIPTION] [--gpu-type=GPU_TYPE] + [--[no-]gpu-zonal-redundancy] [--max=MAX] [--mesh=MESH] [--min=MIN] [--no-promote] [--remove-containers=[CONTAINER,...]] [--revision-suffix=REVISION_SUFFIX] [--scaling=SCALING] [--service-account=SERVICE_ACCOUNT] [--vpc-egress=VPC_EGRESS] @@ -17,7 +18,7 @@ SYNOPSIS --clear-volumes --remove-volume=[VOLUME,...]] [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] - --cpu=CPU --depends-on=[CONTAINER,...] --memory=MEMORY + --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --memory=MEMORY --remove-volume-mount=[MOUNT_PATH,...] --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] @@ -109,6 +110,13 @@ FLAGS --description=DESCRIPTION Provides an optional, human-readable description of the service. + --gpu-type=GPU_TYPE + The GPU type to use. + + --[no-]gpu-zonal-redundancy + Set GPU zonal redundancy. Use --gpu-zonal-redundancy to enable and + --no-gpu-zonal-redundancy to disable. + --max=MAX The maximum number of container instances to run for this WorkerPool or 'default' to use system default of 100. This instance limit will be @@ -296,6 +304,10 @@ FLAGS --depends-on=[CONTAINER,...] List of container dependencies to add to the current container. + --gpu=GPU + Cloud Run supports values 0 or 1. 1 gpu also requires a minimum 4 + --cpu value and a minimum 8Gi --memory value. + --memory=MEMORY Set a memory limit. Ex: 1024Mi, 4Gi. diff --git a/gcloud/alpha/run/worker-pools/get-iam-policy b/gcloud/alpha/run/worker-pools/get-iam-policy new file mode 100644 index 000000000..f9dc9d168 --- /dev/null +++ b/gcloud/alpha/run/worker-pools/get-iam-policy @@ -0,0 +1,100 @@ +NAME + gcloud alpha run worker-pools get-iam-policy - get the IAM policy for a + Cloud Run worker pool + +SYNOPSIS + gcloud alpha run worker-pools get-iam-policy (WORKERPOOL : --region=REGION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command gets the IAM policy for a worker pool. If formatted as + JSON, the output can be edited and used as a policy file for + set-iam-policy. The output includes an "etag" field identifying the version + emitted and allowing detection of concurrent policy updates; see $ gcloud + alpha run registries set-iam-policy for additional details. + +EXAMPLES + To print the IAM policy for a given worker pool, run: + + $ gcloud alpha run worker-pools get-iam-policy \ + --region=us-central1 my-worker-pool + +POSITIONAL ARGUMENTS + Workerpool resource - The worker pool for which to display the IAM policy. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument workerpool 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. + + WORKERPOOL + ID of the workerpool or fully qualified identifier for the + workerpool. + + To set the workerpool attribute: + ▸ provide the argument workerpool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The Cloud Run region. + + To set the region attribute: + ▸ provide the argument workerpool on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property run/region; + ▸ specify from a list of available regions in a prompt. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the run/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/run/ + +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/run/worker-pools/help b/gcloud/alpha/run/worker-pools/help index 251f0d699..792ee211d 100644 --- a/gcloud/alpha/run/worker-pools/help +++ b/gcloud/alpha/run/worker-pools/help @@ -30,6 +30,9 @@ GROUPS COMMANDS COMMAND is one of the following: + add-iam-policy-binding + (ALPHA) Add IAM policy binding to a Cloud Run worker pool. + delete (ALPHA) Delete a worker-pool. @@ -39,13 +42,22 @@ COMMANDS describe (ALPHA) Obtain details about a given worker-pool. + get-iam-policy + (ALPHA) Get the IAM policy for a Cloud Run worker pool. + list (ALPHA) List available worker-pools. + remove-iam-policy-binding + (ALPHA) Remove IAM policy binding of a Cloud Run worker pool. + replace (ALPHA) Create or replace a worker-pool from a YAML worker-pool specification. + set-iam-policy + (ALPHA) Set the IAM policy for a worker pool. + update (ALPHA) Update Cloud Run environment variables and other configuration settings. diff --git a/gcloud/alpha/run/worker-pools/remove-iam-policy-binding b/gcloud/alpha/run/worker-pools/remove-iam-policy-binding new file mode 100644 index 000000000..01b124780 --- /dev/null +++ b/gcloud/alpha/run/worker-pools/remove-iam-policy-binding @@ -0,0 +1,143 @@ +NAME + gcloud alpha run worker-pools remove-iam-policy-binding - remove IAM policy + binding of a Cloud Run worker pool + +SYNOPSIS + gcloud alpha run worker-pools remove-iam-policy-binding + (WORKERPOOL : --region=REGION) --member=PRINCIPAL --role=ROLE + [--all | --condition=[KEY=VALUE,...] + | --condition-from-file=PATH_TO_FILE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Remove an IAM policy binding from the IAM policy of a worker pool. + One binding consists of a member, and a role. + +EXAMPLES + To remove an IAM policy binding for the role of 'roles/run.developer' for + the user 'test-user@gmail.com' with worker pool 'my-worker-pool' and region + 'us-central1', run: + + $ gcloud alpha run worker-pools remove-iam-policy-binding \ + my-worker-pool --region='us-central1' \ + --member='user:test-user@gmail.com' --role='roles/run.developer' + + See https://cloud.google.com/iam/docs/managing-policies for details of + policy role and member types. + +POSITIONAL ARGUMENTS + Workerpool resource - The service for which to remove the IAM policy + binding. The arguments in this group can be used to specify the attributes + of this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument workerpool 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. + + WORKERPOOL + ID of the workerpool or fully qualified identifier for the + workerpool. + + To set the workerpool attribute: + ▸ provide the argument workerpool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The Cloud Run region. + + To set the region attribute: + ▸ provide the argument workerpool on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property run/region; + ▸ specify from a list of available regions in a prompt. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to remove the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Deleted principals have an additional deleted: prefix and a ?uid=UID + suffix, where UID is a unique identifier for the principal. Example: + deleted:user:test-user@gmail.com?uid=123456789012345678901. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + The role to remove the principal from. + +OPTIONAL FLAGS + At most one of these can be specified: + + --all + Remove all bindings with this role and principal, irrespective of any + conditions. + + --condition=[KEY=VALUE,...] + The condition of the binding that you want to remove. When the + condition is explicitly specified as None (--condition=None), a + binding without a condition is removed. Otherwise, only a binding + with a condition that exactly matches the specified condition + (including the optional description) is removed. For more on + conditions, refer to the conditions overview guide: + https://cloud.google.com/iam/docs/conditions-overview + + When using the --condition flag, include the following key-value + pairs: + + expression + (Required) Condition expression that evaluates to True or False. + This uses a subset of Common Expression Language syntax. + + If the condition expression includes a comma, use a different + delimiter to separate the key-value pairs. Specify the delimiter + before listing the key-value pairs. For example, to specify a + colon (:) as the delimiter, do the following: + --condition=^:^title=TITLE:expression=EXPRESSION. For more + information, see + https://cloud.google.com/sdk/gcloud/reference/topic/escaping. + + title + (Required) A short string describing the purpose of the + expression. + + description + (Optional) Additional description for the expression. + + --condition-from-file=PATH_TO_FILE + Path to a local JSON or YAML file that defines the condition. To see + available fields, see the help for --condition. Use a full or + relative path to a local file containing the value of condition. + +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 run/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/run/ + +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/run/worker-pools/set-iam-policy b/gcloud/alpha/run/worker-pools/set-iam-policy new file mode 100644 index 000000000..b4d42408f --- /dev/null +++ b/gcloud/alpha/run/worker-pools/set-iam-policy @@ -0,0 +1,87 @@ +NAME + gcloud alpha run worker-pools set-iam-policy - set the IAM policy for a + worker pool + +SYNOPSIS + gcloud alpha run worker-pools set-iam-policy (WORKERPOOL : --region=REGION) + POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command replaces the existing IAM policy for a worker pool, + given a worker pool and a file encoded in JSON or YAML that contains the + IAM policy. If the given policy file specifies an "etag" value, then the + replacement will succeed only if the policy already in place matches that + etag. (An etag obtain via get-iam-policy will prevent the replacement if + the policy for the worker pool has been subsequently updated.) A policy + file that does not contain an etag value will replace any existing policy + for the worker pool. + +EXAMPLES + The following command will read an IAM policy defined in a JSON file + 'policy.json' and set it for a worker pool with identifier 'my-worker-pool' + + $ gcloud alpha run worker-pools set-iam-policy \ + --region=us-central1 my-worker-pool policy.json + + See https://cloud.google.com/iam/docs/managing-policies for details of the + policy file format and contents. + +POSITIONAL ARGUMENTS + Workerpool resource - The service for which to set the IAM policy. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument workerpool 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. + + WORKERPOOL + ID of the workerpool or fully qualified identifier for the + workerpool. + + To set the workerpool attribute: + ▸ provide the argument workerpool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The Cloud Run region. + + To set the region attribute: + ▸ provide the argument workerpool on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property run/region; + ▸ specify from a list of available regions in a prompt. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the run/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/run/ + +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/run/worker-pools/update b/gcloud/alpha/run/worker-pools/update index 36761a034..9c23c4ed1 100644 --- a/gcloud/alpha/run/worker-pools/update +++ b/gcloud/alpha/run/worker-pools/update @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud alpha run worker-pools update [[WORKER_POOL] --region=REGION] [--async] [--breakglass=JUSTIFICATION] [--container=CONTAINER] - [--description=DESCRIPTION] [--max=MAX] [--mesh=MESH] [--min=MIN] + [--description=DESCRIPTION] [--gpu-type=GPU_TYPE] + [--[no-]gpu-zonal-redundancy] [--max=MAX] [--mesh=MESH] [--min=MIN] [--no-promote] [--remove-containers=[CONTAINER,...]] [--revision-suffix=REVISION_SUFFIX] [--scaling=SCALING] [--service-account=SERVICE_ACCOUNT] [--vpc-egress=VPC_EGRESS] @@ -17,7 +18,8 @@ SYNOPSIS --clear-volumes --remove-volume=[VOLUME,...]] [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] - --cpu=CPU --depends-on=[CONTAINER,...] --image=IMAGE --memory=MEMORY + --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --image=IMAGE + --memory=MEMORY --remove-volume-mount=[MOUNT_PATH,...] --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] @@ -104,6 +106,13 @@ FLAGS --description=DESCRIPTION Provides an optional, human-readable description of the service. + --gpu-type=GPU_TYPE + The GPU type to use. + + --[no-]gpu-zonal-redundancy + Set GPU zonal redundancy. Use --gpu-zonal-redundancy to enable and + --no-gpu-zonal-redundancy to disable. + --max=MAX The maximum number of container instances to run for this WorkerPool or 'default' to use system default of 100. This instance limit will be @@ -291,6 +300,10 @@ FLAGS --depends-on=[CONTAINER,...] List of container dependencies to add to the current container. + --gpu=GPU + Cloud Run supports values 0 or 1. 1 gpu also requires a minimum 4 + --cpu value and a minimum 8Gi --memory value. + --image=IMAGE Name of the container image to deploy (e.g. us-docker.pkg.dev/cloudrun/container/hello:latest). diff --git a/gcloud/alpha/source-manager/repos/delete b/gcloud/alpha/source-manager/repos/delete index 09bd9620d..1109cf136 100644 --- a/gcloud/alpha/source-manager/repos/delete +++ b/gcloud/alpha/source-manager/repos/delete @@ -50,8 +50,8 @@ POSITIONAL ARGUMENTS FLAGS --allow-missing - If set to true, and the repository is not found, the request will - succeed but no action will be taken on the server. + If set to true, and the resource is not found, the request will succeed + but no action will be taken on the server. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/source-manager/repos/help b/gcloud/alpha/source-manager/repos/help index bc236741d..f171d85e7 100644 --- a/gcloud/alpha/source-manager/repos/help +++ b/gcloud/alpha/source-manager/repos/help @@ -42,6 +42,9 @@ COMMANDS set-iam-policy (ALPHA) Set the IAM policy for a Secure Source Manager repository. + update + (ALPHA) Update a Secure Source Manager repository. + 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/source-manager/repos/update b/gcloud/alpha/source-manager/repos/update new file mode 100644 index 000000000..714a06fff --- /dev/null +++ b/gcloud/alpha/source-manager/repos/update @@ -0,0 +1,72 @@ +NAME + gcloud alpha source-manager repos update - update a Secure Source Manager + repository + +SYNOPSIS + gcloud alpha source-manager repos update (REPOSITORY : --region=REGION) + [--description=DESCRIPTION] [--validate-only] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a Secure Source Manager repository. + +EXAMPLES + To update the description of a repository called my-repo in location + us-central1, run the following command: + + $ gcloud alpha source-manager repos update my-repo \ + --description="new description" --region=us-central1 + +POSITIONAL ARGUMENTS + Repository resource - The Secure Source Manager repository to update. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument repository 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. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. + + To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + Secure Source Manager location. + + To set the region attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --region on the command line. + +FLAGS + --description=DESCRIPTION + Description of the repository. Cannot exceed 500 characters. + + --validate-only + If set to true, the request is validated and the user is provided with + an expected result, but no actual change is made. + +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/sql/backups/restore b/gcloud/alpha/sql/backups/restore index bd9f63613..275789c84 100644 --- a/gcloud/alpha/sql/backups/restore +++ b/gcloud/alpha/sql/backups/restore @@ -48,10 +48,11 @@ SYNOPSIS | --secondary-zone=SECONDARY_ZONE --zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) The command lets you restore to an existing instance using ID. When - backup Name is used for restore it lets you restore to an existing instance - or a new instance. When restoring to new instance, optional flags can be - used to customize the new instance. + (ALPHA) The command lets you restore to an existing instance using ID. To + restore using a backupDR backup, use the backupDR ID. When backup Name is + used to restore it lets you restore to an existing instance or a new + instance. When restoring to new instance, optional flags can be used to + customize the new instance. POSITIONAL ARGUMENTS ID diff --git a/gcloud/alpha/sql/instances/delete b/gcloud/alpha/sql/instances/delete index cc085ab7b..75c3e1c3c 100644 --- a/gcloud/alpha/sql/instances/delete +++ b/gcloud/alpha/sql/instances/delete @@ -31,11 +31,13 @@ FLAGS --final-backup-expiry-time=FINAL_BACKUP_EXPIRY_TIME Specifies the time at which the final backup will expire. Maximum - time allowed is 365 days from now. Format: YYYY-MM-DDTHH:MM:SS. + time allowed is 365 days. For instances managed by BackupDR, the + maximum time allowed is 99 years. Format: YYYY-MM-DDTHH:MM:SS. --final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS Specifies number of days to retain final backup. The valid range is - between 1 and 365. Default value is 30 days. + between 1 and 365. For instances managed by BackupDR, the valid range + is between 1 day and 99 years. Default value is 30 days. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/sql/instances/help b/gcloud/alpha/sql/instances/help index 37b9154d5..0df294264 100644 --- a/gcloud/alpha/sql/instances/help +++ b/gcloud/alpha/sql/instances/help @@ -55,6 +55,10 @@ COMMANDS patch (ALPHA) Updates the settings of a Cloud SQL instance. + point-in-time-restore + (ALPHA) Performs a point in time restore for a Cloud SQL instance + managed by Google Cloud Backup and Disaster Recovery. + promote-replica (ALPHA) Promotes Cloud SQL read replica to a stand-alone instance. diff --git a/gcloud/alpha/sql/instances/point-in-time-restore b/gcloud/alpha/sql/instances/point-in-time-restore new file mode 100644 index 000000000..a7827ed4d --- /dev/null +++ b/gcloud/alpha/sql/instances/point-in-time-restore @@ -0,0 +1,84 @@ +NAME + gcloud alpha sql instances point-in-time-restore - performs a point in time + restore for a Cloud SQL instance managed by Google Cloud Backup and + Disaster Recovery + +SYNOPSIS + gcloud alpha sql instances point-in-time-restore DATASOURCE TARGET + POINT_IN_TIME [--allocated-ip-range-name=ALLOCATED_IP_RANGE_NAME] + [--async] [--preferred-secondary-zone=PREFERRED_SECONDARY_ZONE] + [--preferred-zone=PREFERRED_ZONE] [--private-network=PRIVATE_NETWORK] + [--restore-database-names=RESTORE_DATABASE_NAMES] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha sql instances point-in-time-restore performs a point + in time restore for a Cloud SQL instance managed by Google Cloud Backup and + Disaster Recovery. + +EXAMPLES + To perform a point in time restore from an earlier point in time: + + $ gcloud alpha sql instances point-in-time-restore datasource \ + target-instance '2012-11-15T16:19:00.094Z' + +POSITIONAL ARGUMENTS + DATASOURCE + The Google Cloud Backup and Disaster Recovery Datasource URI, of the + form projects/{project}/locations/{region}/backupVaults/ + {backupvault}/dataSources/{datasource}. + + TARGET + Cloud SQL instance ID of the target instance. + + POINT_IN_TIME + The point in time in which to restore the instance to. Uses RFC 3339 + format in UTC timezone. For example, '2012-11-15T16:19:00.094Z'. + +FLAGS + --allocated-ip-range-name=ALLOCATED_IP_RANGE_NAME + The name of the IP range allocated for the target instance with private + network connectivity. For example: 'google-managed-services-default'. + If set, the target instance IP is created in the allocated range + represented by this name. Reserved for future use. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --preferred-secondary-zone=PREFERRED_SECONDARY_ZONE + The preferred secondary zone for the cloned regional instance. If you + specify a value for this flag, then the target instance uses the value + as the secondary zone. The secondary zone can't be the same as the + primary zone. + + --preferred-zone=PREFERRED_ZONE + The preferred zone for the target instance. If you specify a value for + this flag, then the target instance uses the value as the primary zone. + + --private-network=PRIVATE_NETWORK + The resource link for the VPC network from which the Cloud SQL instance + is accessible for private IP. For example, + '/projects/myProject/global/networks/default'. + + --restore-database-names=RESTORE_DATABASE_NAMES + The name of the databases to be restored for a point-in-time restore. + If set, the destination instance will only restore the specified + databases. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta sql instances point-in-time-restore + diff --git a/gcloud/alpha/storage/buckets/create b/gcloud/alpha/storage/buckets/create index e676d56d8..160774e37 100644 --- a/gcloud/alpha/storage/buckets/create +++ b/gcloud/alpha/storage/buckets/create @@ -84,6 +84,10 @@ FLAGS ] } + For more information about supported configurations, see Cloud Storage + bucket IP filtering configurations + (https://cloud.google.com/storage/docs/create-ip-filter#ip-filtering-configurations) + --lifecycle-file=LIFECYCLE_FILE Sets the lifecycle management configuration on a bucket. For example, The following lifecycle management configuration JSON document diff --git a/gcloud/alpha/storage/buckets/update b/gcloud/alpha/storage/buckets/update index aabc5878e..756d2f62e 100644 --- a/gcloud/alpha/storage/buckets/update +++ b/gcloud/alpha/storage/buckets/update @@ -212,6 +212,10 @@ FLAGS ] } + For more information about supported configurations, see Cloud + Storage bucket IP filtering configurations + (https://cloud.google.com/storage/docs/create-ip-filter#ip-filtering-configurations) + At most one of these can be specified: --clear-labels diff --git a/gcloud/beta/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy b/gcloud/beta/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy new file mode 100644 index 000000000..62b3fefa7 --- /dev/null +++ b/gcloud/beta/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy @@ -0,0 +1,61 @@ +NAME + gcloud beta compute interconnects application-awareness + configure-bandwidth-percentage-policy - configure bandwidth percentage + policy for application awareness configuration of a Compute Engine + interconnect + +SYNOPSIS + gcloud beta compute interconnects application-awareness + configure-bandwidth-percentage-policy NAME + --bandwidth-percentages=[TC1=TC1], + [TC2=TC2],[TC3=TC3],[TC4=TC4],[TC5=TC5],[TC6=TC6] [--enabled] + [--profile-description=PROFILE_DESCRIPTION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute interconnects application-awareness + configure-bandwidth-percentage-policy is used to configure bandwidth + percentage policy for using application awareness on interconnect. + + For an example, refer to the EXAMPLES section below. + +EXAMPLES + To configure bandwidth percentage policy for an interconnect + example-interconnect, run: + + $ gcloud beta compute interconnects application-awareness \ configure-bandwidth-percentage-policy example-interconnect \ + --bandwidth-percentages="TC1=11,TC2=10" --enabled \ + --profile_description="some string " + +POSITIONAL ARGUMENTS + NAME + Name of the interconnect to patch. + +REQUIRED FLAGS + --bandwidth-percentages=[TC1=TC1],[TC2=TC2],[TC3=TC3],[TC4=TC4],[TC5=TC5],[TC6=TC6] + A list of bandwidth percentages for each application awareness profile. + The sum of all bandwidth percentages must be 100. + +OPTIONAL FLAGS + --enabled + Enable or disable application awareness on the interconnect. + Application awareness enablement will fail if the application awareness + configuration is not specified. Use --no-enabled to disable it. + + --profile-description=PROFILE_DESCRIPTION + Add profile description for application awareness. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute interconnects application-awareness \ + configure-bandwidth-percentage-policy + diff --git a/gcloud/beta/compute/interconnects/application-awareness/configure-shaper-average-percentage b/gcloud/beta/compute/interconnects/application-awareness/configure-shaper-average-percentage new file mode 100644 index 000000000..132c1c11c --- /dev/null +++ b/gcloud/beta/compute/interconnects/application-awareness/configure-shaper-average-percentage @@ -0,0 +1,61 @@ +NAME + gcloud beta compute interconnects application-awareness + configure-shaper-average-percentage - configure shaper average + percentage for application awareness configuration of a Compute Engine + interconnect + +SYNOPSIS + gcloud beta compute interconnects application-awareness + configure-shaper-average-percentage NAME + --bandwidth-percentages=[TC1=TC1], + [TC2=TC2],[TC3=TC3],[TC4=TC4],[TC5=TC5],[TC6=TC6] [--enabled] + [--profile-description=PROFILE_DESCRIPTION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute interconnects application-awareness + configure-shaper-average-percentage is used to configure shaper average + percentage for using application awareness on interconnect. + + For an example, refer to the EXAMPLES section below. + +EXAMPLES + To configure shaper average percentage for an interconnect + example-interconnect, run: + + $ gcloud beta compute interconnects application-awareness \ configure-shaper-average-percentage example-interconnect \ + --bandwidth-percentages="TC1=11,TC2=10" --enabled \ + --profile_description="some string " + +POSITIONAL ARGUMENTS + NAME + Name of the interconnect to patch. + +REQUIRED FLAGS + --bandwidth-percentages=[TC1=TC1],[TC2=TC2],[TC3=TC3],[TC4=TC4],[TC5=TC5],[TC6=TC6] + A list of bandwidth percentages for each application awareness profile. + The sum of all bandwidth percentages must be 100. + +OPTIONAL FLAGS + --enabled + Enable or disable application awareness on the interconnect. + Application awareness enablement will fail if the application awareness + configuration is not specified. Use --no-enabled to disable it. + + --profile-description=PROFILE_DESCRIPTION + Add profile description for application awareness. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute interconnects application-awareness \ + configure-shaper-average-percentage + diff --git a/gcloud/beta/compute/interconnects/application-awareness/configure-strict-priority-policy b/gcloud/beta/compute/interconnects/application-awareness/configure-strict-priority-policy new file mode 100644 index 000000000..e2ad5c5de --- /dev/null +++ b/gcloud/beta/compute/interconnects/application-awareness/configure-strict-priority-policy @@ -0,0 +1,53 @@ +NAME + gcloud beta compute interconnects application-awareness + configure-strict-priority-policy - configure strict priority policy for + application awareness configuration of a Compute Engine interconnect + +SYNOPSIS + gcloud beta compute interconnects application-awareness + configure-strict-priority-policy NAME [--enabled] + [--profile-description=PROFILE_DESCRIPTION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute interconnects application-awareness + configure-strict-priority-policy is used to configure strict priority + policy for using application awareness on interconnect. + + For an example, refer to the EXAMPLES section below. + +EXAMPLES + To configure strict priority policy for an interconnect + example-interconnect, run: + + $ gcloud beta compute interconnects application-awareness \ + configure-strict-priority-policy example-interconnect \ + --enabled --profile-description="some string" + +POSITIONAL ARGUMENTS + NAME + Name of the interconnect to patch. + +FLAGS + --enabled + Enable or disable application awareness on the interconnect. + Application awareness enablement will fail if the application awareness + configuration is not specified. Use --no-enabled to disable it. + + --profile-description=PROFILE_DESCRIPTION + Add profile description for application awareness. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute interconnects application-awareness \ + configure-strict-priority-policy + diff --git a/gcloud/beta/compute/interconnects/application-awareness/delete b/gcloud/beta/compute/interconnects/application-awareness/delete new file mode 100644 index 000000000..09dae117a --- /dev/null +++ b/gcloud/beta/compute/interconnects/application-awareness/delete @@ -0,0 +1,40 @@ +NAME + gcloud beta compute interconnects application-awareness delete - delete + application awareness configuration of a Compute Engine interconnect + +SYNOPSIS + gcloud beta compute interconnects application-awareness delete NAME + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute interconnects application-awareness delete is + used to delete all configuration state for application awareness on + interconnect. + + For an example, refer to the EXAMPLES section below. + +EXAMPLES + To delete application awareness configuration for an interconnect + example-interconnect, run: + + $ gcloud beta compute interconnects application-awareness delete \ + example-interconnect + +POSITIONAL ARGUMENTS + NAME + Name of the interconnect to patch. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute interconnects application-awareness delete + diff --git a/gcloud/beta/compute/interconnects/application-awareness/get-config b/gcloud/beta/compute/interconnects/application-awareness/get-config new file mode 100644 index 000000000..3159b60ee --- /dev/null +++ b/gcloud/beta/compute/interconnects/application-awareness/get-config @@ -0,0 +1,40 @@ +NAME + gcloud beta compute interconnects application-awareness get-config - get + application awareness configuration of a Compute Engine interconnect + +SYNOPSIS + gcloud beta compute interconnects application-awareness get-config NAME + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute interconnects application-awareness get-config + displays configuration data associated with application awareness on + Compute Engine interconnect in a project. + + For an example, refer to the EXAMPLES section below. + +EXAMPLES + To displays configuration data associated with application awareness on + Compute Engine interconnect in a project, run: + + $ gcloud beta compute interconnects application-awareness \ + get-config example-interconnect + +POSITIONAL ARGUMENTS + NAME + Name of the interconnect to describe. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute interconnects application-awareness get-config + diff --git a/gcloud/beta/compute/interconnects/application-awareness/help b/gcloud/beta/compute/interconnects/application-awareness/help new file mode 100644 index 000000000..9050c92d4 --- /dev/null +++ b/gcloud/beta/compute/interconnects/application-awareness/help @@ -0,0 +1,51 @@ +NAME + gcloud beta compute interconnects application-awareness - read and + manipulate configuration for application awareness on Compute Engine + interconnect + +SYNOPSIS + gcloud beta compute interconnects application-awareness COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Read and manipulate configuration for application awareness on + Compute Engine interconnect. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + configure-bandwidth-percentage-policy + (BETA) Configure bandwidth percentage policy for application awareness + configuration of a Compute Engine interconnect. + + configure-shaper-average-percentage + (BETA) Configure shaper average percentage for application awareness + configuration of a Compute Engine interconnect. + + configure-strict-priority-policy + (BETA) Configure strict priority policy for application awareness + configuration of a Compute Engine interconnect. + + delete + (BETA) Delete application awareness configuration of a Compute Engine + interconnect. + + get-config + (BETA) Get application awareness configuration of a Compute Engine + interconnect. + + update + (BETA) Updates application awareness configuration of a Compute Engine + interconnect. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute interconnects application-awareness + diff --git a/gcloud/beta/compute/interconnects/application-awareness/update b/gcloud/beta/compute/interconnects/application-awareness/update new file mode 100644 index 000000000..fc0840db8 --- /dev/null +++ b/gcloud/beta/compute/interconnects/application-awareness/update @@ -0,0 +1,50 @@ +NAME + gcloud beta compute interconnects application-awareness update - updates + application awareness configuration of a Compute Engine interconnect + +SYNOPSIS + gcloud beta compute interconnects application-awareness update NAME + [--enabled] [--profile-description=PROFILE_DESCRIPTION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta compute interconnects application-awareness update + allows the user to enable or disable application awareness on Interconnect, + as well as add/update the description of the application awareness on + Interconnect profile. For an example, refer to the EXAMPLES section below. + +EXAMPLES + To update the application awareness config on Compute Engine interconnect + in a project, run: + + $ gcloud beta compute interconnects application-awareness update \ + example-interconnect application-awareness update --enabled \ + --profile-description="Some string" + +POSITIONAL ARGUMENTS + NAME + Name of the interconnect to patch. + +FLAGS + --enabled + Enable or disable application awareness on the interconnect. + Application awareness enablement will fail if the application awareness + configuration is not specified. Use --no-enabled to disable it. + + --profile-description=PROFILE_DESCRIPTION + Add profile description for application awareness. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha compute interconnects application-awareness update + diff --git a/gcloud/beta/compute/interconnects/help b/gcloud/beta/compute/interconnects/help index 5f2045827..1cb4582c9 100644 --- a/gcloud/beta/compute/interconnects/help +++ b/gcloud/beta/compute/interconnects/help @@ -23,6 +23,10 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + application-awareness + (BETA) Read and manipulate configuration for application awareness on + Compute Engine interconnect. + attachments (BETA) Read and manipulate Compute Engine interconnect attachments. diff --git a/gcloud/beta/compute/reservations/blocks/describe b/gcloud/beta/compute/reservations/blocks/describe index e547503e2..721808315 100644 --- a/gcloud/beta/compute/reservations/blocks/describe +++ b/gcloud/beta/compute/reservations/blocks/describe @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud beta compute reservations blocks describe RESERVATION - --block-name=BLOCK_NAME [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + --block-name=BLOCK_NAME + [--full-view=FULL_VIEW; default="BLOCK_VIEW_UNSPECIFIED"] [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Describe a Compute Engine reservation block. @@ -25,6 +27,14 @@ REQUIRED FLAGS The name of the reservation block. OPTIONAL FLAGS + --full-view=FULL_VIEW; default="BLOCK_VIEW_UNSPECIFIED" + The view type for the reservation block. FULL_VIEW must be one of: + + BLOCK_VIEW_BASIC + Basic default view of the reservation block. + BLOCK_VIEW_FULL + Full detailed view of the reservation block. + --zone=ZONE Zone of the reservation to describe. If not specified and the compute/zone property isn't set, you might be prompted to select a zone diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index 3d67a2b26..ad0d97be2 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -98,6 +98,8 @@ SYNOPSIS [--binauthz-policy-bindings=[name=BINAUTHZ_POLICY] --binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE | --enable-binauthz] + [--boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS + --boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT] [--cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN --cluster-dns-scope=CLUSTER_DNS_SCOPE --additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN @@ -1764,6 +1766,16 @@ FLAGS The --enable-binauthz flag is deprecated. Please use --binauthz-evaluation-mode instead. + Configure boot disk options. + + --boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS + Configure the Provisioned IOPS for the node pool boot disks. Only + valid for hyperdisk-balanced boot disks. + + --boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT + Configure the Provisioned Throughput for the node pool boot disks. + Only valid for hyperdisk-throughput boot disks. + ClusterDNS --cluster-dns=CLUSTER_DNS diff --git a/gcloud/beta/container/fleet/cloudrun/disable b/gcloud/beta/container/fleet/cloudrun/disable index e6d332795..274e0f0e8 100644 --- a/gcloud/beta/container/fleet/cloudrun/disable +++ b/gcloud/beta/container/fleet/cloudrun/disable @@ -15,8 +15,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/fleet/config-management/disable b/gcloud/beta/container/fleet/config-management/disable index 57f24dd97..5a4bb5bf5 100644 --- a/gcloud/beta/container/fleet/config-management/disable +++ b/gcloud/beta/container/fleet/config-management/disable @@ -32,8 +32,9 @@ FLAGS Does not change existing membership configurations. --force - Disable this feature, even if it is currently in use. Force - disablement may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/fleet/dataplane-v2-encryption/disable b/gcloud/beta/container/fleet/dataplane-v2-encryption/disable index efb6ae53f..46befec5a 100644 --- a/gcloud/beta/container/fleet/dataplane-v2-encryption/disable +++ b/gcloud/beta/container/fleet/dataplane-v2-encryption/disable @@ -17,8 +17,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/fleet/fleetobservability/disable b/gcloud/beta/container/fleet/fleetobservability/disable index a2335f0e2..bb4db4a40 100644 --- a/gcloud/beta/container/fleet/fleetobservability/disable +++ b/gcloud/beta/container/fleet/fleetobservability/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/fleet/identity-service/disable b/gcloud/beta/container/fleet/identity-service/disable index 98b1d7a3a..0ce1c607f 100644 --- a/gcloud/beta/container/fleet/identity-service/disable +++ b/gcloud/beta/container/fleet/identity-service/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/fleet/ingress/disable b/gcloud/beta/container/fleet/ingress/disable index c36b3f42a..c5c7b37f1 100644 --- a/gcloud/beta/container/fleet/ingress/disable +++ b/gcloud/beta/container/fleet/ingress/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/fleet/multi-cluster-services/disable b/gcloud/beta/container/fleet/multi-cluster-services/disable index 2d3430231..9b2e986fb 100644 --- a/gcloud/beta/container/fleet/multi-cluster-services/disable +++ b/gcloud/beta/container/fleet/multi-cluster-services/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/fleet/packages/resource-bundles/releases/create b/gcloud/beta/container/fleet/packages/resource-bundles/releases/create index ee36e2bc6..832d12920 100644 --- a/gcloud/beta/container/fleet/packages/resource-bundles/releases/create +++ b/gcloud/beta/container/fleet/packages/resource-bundles/releases/create @@ -6,7 +6,8 @@ SYNOPSIS gcloud beta container fleet packages resource-bundles releases create --resource-bundle=RESOURCE_BUNDLE --source=SOURCE --version=VERSION [--lifecycle=LIFECYCLE] [--location=LOCATION] - [--variants-pattern=VARIANTS_PATTERN] [GCLOUD_WIDE_FLAG ...] + [--variants-pattern=VARIANTS_PATTERN; default="*"] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create Package Rollouts Release. @@ -50,7 +51,7 @@ OPTIONAL FLAGS --location=LOCATION Google Cloud zone or region. - --variants-pattern=VARIANTS_PATTERN + --variants-pattern=VARIANTS_PATTERN; default="*" Glob pattern to Variants of the Release, to be paired with the --source arg. ex: --source=/manifests-dir/ --variants-pattern=**, --source=/manifests-dir/ --variants-pattern=us-*.yaml, diff --git a/gcloud/beta/container/hub/cloudrun/disable b/gcloud/beta/container/hub/cloudrun/disable index eb2d118cb..8c46c26fd 100644 --- a/gcloud/beta/container/hub/cloudrun/disable +++ b/gcloud/beta/container/hub/cloudrun/disable @@ -14,8 +14,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/hub/config-management/disable b/gcloud/beta/container/hub/config-management/disable index 3a05ab00e..ce4cff2ac 100644 --- a/gcloud/beta/container/hub/config-management/disable +++ b/gcloud/beta/container/hub/config-management/disable @@ -32,8 +32,9 @@ FLAGS Does not change existing membership configurations. --force - Disable this feature, even if it is currently in use. Force - disablement may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/hub/dataplane-v2-encryption/disable b/gcloud/beta/container/hub/dataplane-v2-encryption/disable index 31a13fa7f..9851bde8c 100644 --- a/gcloud/beta/container/hub/dataplane-v2-encryption/disable +++ b/gcloud/beta/container/hub/dataplane-v2-encryption/disable @@ -17,8 +17,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/hub/fleetobservability/disable b/gcloud/beta/container/hub/fleetobservability/disable index fc552e3a8..ccecba83e 100644 --- a/gcloud/beta/container/hub/fleetobservability/disable +++ b/gcloud/beta/container/hub/fleetobservability/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/hub/identity-service/disable b/gcloud/beta/container/hub/identity-service/disable index 015dbb169..8cca1fd87 100644 --- a/gcloud/beta/container/hub/identity-service/disable +++ b/gcloud/beta/container/hub/identity-service/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/hub/ingress/disable b/gcloud/beta/container/hub/ingress/disable index 8e55ee892..185f23e04 100644 --- a/gcloud/beta/container/hub/ingress/disable +++ b/gcloud/beta/container/hub/ingress/disable @@ -15,8 +15,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/hub/multi-cluster-services/disable b/gcloud/beta/container/hub/multi-cluster-services/disable index dde0425e1..14ddefa96 100644 --- a/gcloud/beta/container/hub/multi-cluster-services/disable +++ b/gcloud/beta/container/hub/multi-cluster-services/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/container/hub/packages/resource-bundles/releases/create b/gcloud/beta/container/hub/packages/resource-bundles/releases/create index ca571df84..14b083f8e 100644 --- a/gcloud/beta/container/hub/packages/resource-bundles/releases/create +++ b/gcloud/beta/container/hub/packages/resource-bundles/releases/create @@ -6,7 +6,8 @@ SYNOPSIS gcloud beta container hub packages resource-bundles releases create --resource-bundle=RESOURCE_BUNDLE --source=SOURCE --version=VERSION [--lifecycle=LIFECYCLE] [--location=LOCATION] - [--variants-pattern=VARIANTS_PATTERN] [GCLOUD_WIDE_FLAG ...] + [--variants-pattern=VARIANTS_PATTERN; default="*"] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create Package Rollouts Release. @@ -50,7 +51,7 @@ OPTIONAL FLAGS --location=LOCATION Google Cloud zone or region. - --variants-pattern=VARIANTS_PATTERN + --variants-pattern=VARIANTS_PATTERN; default="*" Glob pattern to Variants of the Release, to be paired with the --source arg. ex: --source=/manifests-dir/ --variants-pattern=**, --source=/manifests-dir/ --variants-pattern=us-*.yaml, diff --git a/gcloud/beta/container/node-pools/create b/gcloud/beta/container/node-pools/create index 9d8c6f728..9b9394245 100644 --- a/gcloud/beta/container/node-pools/create +++ b/gcloud/beta/container/node-pools/create @@ -14,8 +14,10 @@ SYNOPSIS [--additional-pod-network=[subnetwork=SUBNETWORK_NAME, pod-ipv4-range=SECONDARY_RANGE_NAME, [max-pods-per-node=NUM_PODS],...]] [--async] - [--boot-disk-kms-key=BOOT_DISK_KMS_KEY] [--cluster=CLUSTER] - [--confidential-node-type=CONFIDENTIAL_NODE_TYPE] + [--boot-disk-kms-key=BOOT_DISK_KMS_KEY] + [--boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS] + [--boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT] + [--cluster=CLUSTER] [--confidential-node-type=CONFIDENTIAL_NODE_TYPE] [--containerd-config-from-file=PATH_TO_FILE] [--data-cache-count=DATA_CACHE_COUNT] [--disable-pod-cidr-overprovision] [--disk-size=DISK_SIZE] @@ -190,6 +192,14 @@ FLAGS please see: https://cloud.google.com/compute/docs/disks/customer-managed-encryption + --boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS + Configure the Provisioned IOPS for the node pool boot disks. Only valid + for hyperdisk-balanced boot disks. + + --boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT + Configure the Provisioned Throughput for the node pool boot disks. Only + valid for hyperdisk-throughput boot disks. + --cluster=CLUSTER The cluster to add the node pool to. Overrides the default container/cluster property value for this command invocation. diff --git a/gcloud/beta/container/node-pools/update b/gcloud/beta/container/node-pools/update index 28921303e..e27ce3bca 100644 --- a/gcloud/beta/container/node-pools/update +++ b/gcloud/beta/container/node-pools/update @@ -30,7 +30,10 @@ SYNOPSIS --node-pool-soak-duration=NODE_POOL_SOAK_DURATION --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, batch-percent=BATCH_NODE_PERCENTAGE, - batch-soak-duration=BATCH_SOAK_DURATION,...] | --disk-size=DISK_SIZE + batch-soak-duration=BATCH_SOAK_DURATION,...] + | --boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS + --boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT + --disk-size=DISK_SIZE --disk-type=DISK_TYPE --machine-type=MACHINE_TYPE | --enable-autoprovisioning --enable-autoscaling --location-policy=LOCATION_POLICY --max-nodes=MAX_NODES @@ -646,6 +649,14 @@ REQUIRED FLAGS Node config + --boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS + Configure the Provisioned IOPS for the node pool boot disks. Only + valid for hyperdisk-balanced boot disks. + + --boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT + Configure the Provisioned Throughput for the node pool boot disks. + Only valid for hyperdisk-throughput boot disks. + --disk-size=DISK_SIZE Size for node VM boot disks in GB. Defaults to 100GB. diff --git a/gcloud/beta/dataflow/yaml/run b/gcloud/beta/dataflow/yaml/run index 54f524274..81ebafc86 100644 --- a/gcloud/beta/dataflow/yaml/run +++ b/gcloud/beta/dataflow/yaml/run @@ -5,9 +5,11 @@ SYNOPSIS gcloud beta dataflow yaml run JOB_NAME (--yaml-pipeline=YAML_PIPELINE | --yaml-pipeline-file=YAML_PIPELINE_FILE) - [--jinja-variables=JSON_OBJECT] + [--jinja-variables=JSON_OBJECT] [--network=NETWORK] [--pipeline-options=[OPTIONS=VALUE;OPTION=VALUE,...]] - [--region=REGION_ID] [GCLOUD_WIDE_FLAG ...] + [--region=REGION_ID] [--subnetwork=SUBNETWORK] + [--template-file-gcs-location=TEMPLATE_FILE_GCS_LOCATION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Runs a job from the specified YAML description or Cloud Storage @@ -37,12 +39,24 @@ OPTIONAL FLAGS --jinja-variables=JSON_OBJECT Jinja2 variables to be used in reifying the yaml. + --network=NETWORK + Compute Engine network for launching worker instances to run the + pipeline. If not set, the default network is used. + --pipeline-options=[OPTIONS=VALUE;OPTION=VALUE,...] Pipeline options to pass to the job. --region=REGION_ID Region ID of the job's regional endpoint. Defaults to 'us-central1'. + --subnetwork=SUBNETWORK + Compute Engine subnetwork for launching worker instances to run the + pipeline. If not set, the default subnetwork is used. + + --template-file-gcs-location=TEMPLATE_FILE_GCS_LOCATION + Google Cloud Storage location of the YAML template to run. (Must be a + URL beginning with 'gs://'.) + 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/dataproc/clusters/diagnose b/gcloud/beta/dataproc/clusters/diagnose index 1685c86ca..a57b19022 100644 --- a/gcloud/beta/dataproc/clusters/diagnose +++ b/gcloud/beta/dataproc/clusters/diagnose @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud beta dataproc clusters diagnose (CLUSTER : --region=REGION) [--end-time=END_TIME] [--job-ids=JOB_IDS] [--start-time=START_TIME] - [--tarball-access=TARBALL_ACCESS] + [--tarball-access=TARBALL_ACCESS] [--tarball-gcs-dir=TARBALL_GCS_DIR] [--yarn-application-ids=YARN_APPLICATION_IDS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -65,9 +65,14 @@ FLAGS format). --tarball-access=TARBALL_ACCESS - Target access privileges for diagnose tarball. TARBALL_ACCESS must be + Target access privileges for diagnostic tarball. TARBALL_ACCESS must be one of: GOOGLE_CLOUD_SUPPORT, GOOGLE_DATAPROC_DIAGNOSE. + --tarball-gcs-dir=TARBALL_GCS_DIR + The output Cloud Storage directory for the diagnostic tarball. If not + specified, a task-specific directory in the cluster's staging bucket + will be used. + --yarn-application-ids=YARN_APPLICATION_IDS A list of yarn applications on which to perform the diagnosis. diff --git a/gcloud/beta/datastream/connection-profiles/create b/gcloud/beta/datastream/connection-profiles/create index 707aa97a7..82c51612a 100644 --- a/gcloud/beta/datastream/connection-profiles/create +++ b/gcloud/beta/datastream/connection-profiles/create @@ -7,14 +7,14 @@ SYNOPSIS (CONNECTION_PROFILE : --location=LOCATION) --display-name=DISPLAY_NAME --type=TYPE [--labels=[KEY=VALUE,...]] [[--bucket-name=BUCKET_NAME : --root-path=ROOT_PATH] - | --database-service=DATABASE_SERVICE + | [--database-service=DATABASE_SERVICE --oracle-hostname=ORACLE_HOSTNAME --oracle-port=ORACLE_PORT --oracle-username=ORACLE_USERNAME (--oracle-password=ORACLE_PASSWORD | --oracle-prompt-for-password - | --oracle-secret-manager-stored-password=ORACLE_SECRET_MANAGER_STORED_PASSWORD) | [--mongodb-host-addresses=IPv4_ADDRESS_OR_HOSTNAME:PORT, + | --oracle-secret-manager-stored-password=ORACLE_SECRET_MANAGER_STORED_PASSWORD) : --oracle-ca-certificate=ORACLE_CA_CERTIFICATE --oracle-server-certificate-distinguished-name=ORACLE_SERVER_CERTIFICATE_DISTINGUISHED_NAME] | [--mongodb-host-addresses=IPv4_ADDRESS_OR_HOSTNAME:PORT, [...] --mongodb-username=MONGODB_USERNAME (--mongodb-password=MONGODB_PASSWORD | --mongodb-prompt-for-password - | --mongodb-secret-manager-stored-password=MONGODB_SECRET_MANAGER_STORED_PASSWORD) (--mongodb-srv-connection-format | --mongodb-standard-connection-format) : --mongodb-direct-connection --mongodb-replica-set=MONGODB_REPLICA_SET --mongodb-tls] | [--mysql-hostname=MYSQL_HOSTNAME --mysql-port=MYSQL_PORT --mysql-username=MYSQL_USERNAME (--mysql-password=MYSQL_PASSWORD | --mysql-prompt-for-password | --mysql-secret-manager-stored-password=MYSQL_SECRET_MANAGER_STORED_PASSWORD) : --ca-certificate=CA_CERTIFICATE --client-certificate=CLIENT_CERTIFICATE --client-key=CLIENT_KEY] | [--postgresql-database=POSTGRESQL_DATABASE --postgresql-hostname=POSTGRESQL_HOSTNAME --postgresql-port=POSTGRESQL_PORT --postgresql-username=POSTGRESQL_USERNAME (--postgresql-password=POSTGRESQL_PASSWORD | --postgresql-prompt-for-password | --postgresql-secret-manager-stored-password=POSTGRESQL_SECRET_MANAGER_STORED_PASSWORD) : [--postgresql-ca-certificate=POSTGRESQL_CA_CERTIFICATE : --postgresql-client-certificate=POSTGRESQL_CLIENT_CERTIFICATE --postgresql-client-key=POSTGRESQL_CLIENT_KEY]] | --salesforce-domain=SALESFORCE_DOMAIN (--salesforce-oauth2-client-id=SALESFORCE_OAUTH2_CLIENT_ID (--salesforce-oauth2-client-secret=SALESFORCE_OAUTH2_CLIENT_SECRET | --salesforce-prompt-for-oauth2-client-secret | --salesforce-secret-manager-stored-oauth2-client-secret=SALESFORCE_SECRET_MANAGER_STORED_OAUTH2_CLIENT_SECRET) | --salesforce-username=SALESFORCE_USERNAME (--salesforce-password=SALESFORCE_PASSWORD | --salesforce-prompt-for-password | --salesforce-secret-manager-stored-password=SALESFORCE_SECRET_MANAGER_STORED_PASSWORD) (--salesforce-prompt-for-security-token | --salesforce-secret-manager-stored-security-token=SALESFORCE_SECRET_MANAGER_STORED_SECURITY_TOKEN | --salesforce-security-token=SALESFORCE_SECURITY_TOKEN)) | --sqlserver-database=SQLSERVER_DATABASE --sqlserver-hostname=SQLSERVER_HOSTNAME --sqlserver-port=SQLSERVER_PORT --sqlserver-username=SQLSERVER_USERNAME (--sqlserver-password=SQLSERVER_PASSWORD | --sqlserver-prompt-for-password | --sqlserver-secret-manager-stored-password=SQLSERVER_SECRET_MANAGER_STORED_PASSWORD)] + | --mongodb-secret-manager-stored-password=MONGODB_SECRET_MANAGER_STORED_PASSWORD) (--mongodb-srv-connection-format | --mongodb-standard-connection-format) : --mongodb-direct-connection --mongodb-replica-set=MONGODB_REPLICA_SET --mongodb-tls] | [--mysql-hostname=MYSQL_HOSTNAME --mysql-port=MYSQL_PORT --mysql-username=MYSQL_USERNAME (--mysql-password=MYSQL_PASSWORD | --mysql-prompt-for-password | --mysql-secret-manager-stored-password=MYSQL_SECRET_MANAGER_STORED_PASSWORD) : --ca-certificate=CA_CERTIFICATE --client-certificate=CLIENT_CERTIFICATE --client-key=CLIENT_KEY] | [--postgresql-database=POSTGRESQL_DATABASE --postgresql-hostname=POSTGRESQL_HOSTNAME --postgresql-port=POSTGRESQL_PORT --postgresql-username=POSTGRESQL_USERNAME (--postgresql-password=POSTGRESQL_PASSWORD | --postgresql-prompt-for-password | --postgresql-secret-manager-stored-password=POSTGRESQL_SECRET_MANAGER_STORED_PASSWORD) : [--postgresql-ca-certificate=POSTGRESQL_CA_CERTIFICATE : --postgresql-server-certificate-hostname=POSTGRESQL_SERVER_CERTIFICATE_HOSTNAME --postgresql-client-certificate=POSTGRESQL_CLIENT_CERTIFICATE --postgresql-client-key=POSTGRESQL_CLIENT_KEY]] | --salesforce-domain=SALESFORCE_DOMAIN (--salesforce-oauth2-client-id=SALESFORCE_OAUTH2_CLIENT_ID (--salesforce-oauth2-client-secret=SALESFORCE_OAUTH2_CLIENT_SECRET | --salesforce-prompt-for-oauth2-client-secret | --salesforce-secret-manager-stored-oauth2-client-secret=SALESFORCE_SECRET_MANAGER_STORED_OAUTH2_CLIENT_SECRET) | --salesforce-username=SALESFORCE_USERNAME (--salesforce-password=SALESFORCE_PASSWORD | --salesforce-prompt-for-password | --salesforce-secret-manager-stored-password=SALESFORCE_SECRET_MANAGER_STORED_PASSWORD) (--salesforce-prompt-for-security-token | --salesforce-secret-manager-stored-security-token=SALESFORCE_SECRET_MANAGER_STORED_SECURITY_TOKEN | --salesforce-security-token=SALESFORCE_SECURITY_TOKEN)) | --sqlserver-database=SQLSERVER_DATABASE --sqlserver-hostname=SQLSERVER_HOSTNAME --sqlserver-port=SQLSERVER_PORT --sqlserver-username=SQLSERVER_USERNAME (--sqlserver-password=SQLSERVER_PASSWORD | --sqlserver-prompt-for-password | --sqlserver-secret-manager-stored-password=SQLSERVER_SECRET_MANAGER_STORED_PASSWORD)] [--no-connectivity | --private-connection-name=PRIVATE_CONNECTION_NAME | --static-ip-connectivity | [--forward-ssh-hostname=FORWARD_SSH_HOSTNAME @@ -155,6 +155,15 @@ OPTIONAL FLAGS Path to secret manager, storing the password for the user used to connect to the database. + --oracle-ca-certificate=ORACLE_CA_CERTIFICATE + PEM-encoded certificate of the CA that signed the source database + server's certificate. + + --oracle-server-certificate-distinguished-name=ORACLE_SERVER_CERTIFICATE_DISTINGUISHED_NAME + The distinguished name (DN) mentioned in the server certificate. This + corresponds to the SSL_SERVER_CERT_DN sqlnet parameter. If this field + is not provided, the DN matching is not enforced. + --mongodb-host-addresses=IPv4_ADDRESS_OR_HOSTNAME:PORT,[...] IP or hostname and port of the MongoDB source database. @@ -299,6 +308,11 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --postgresql-server-certificate-hostname=POSTGRESQL_SERVER_CERTIFICATE_HOSTNAME + The hostname mentioned in the Subject or SAN extension of the server + certificate. If this field is not provided, the hostname in the + server certificate is not validated. + --postgresql-client-certificate=POSTGRESQL_CLIENT_CERTIFICATE x509 PEM-encoded certificate that will be used by the replica to authenticate against the source database server. diff --git a/gcloud/beta/datastream/connection-profiles/update b/gcloud/beta/datastream/connection-profiles/update index a6f5bd04f..1ec45e7ea 100644 --- a/gcloud/beta/datastream/connection-profiles/update +++ b/gcloud/beta/datastream/connection-profiles/update @@ -9,13 +9,13 @@ SYNOPSIS [--bucket-name=BUCKET_NAME --root-path=ROOT_PATH | --database-service=DATABASE_SERVICE --oracle-hostname=ORACLE_HOSTNAME --oracle-port=ORACLE_PORT - --oracle-username=ORACLE_USERNAME --oracle-password=ORACLE_PASSWORD - | --oracle-prompt-for-password - | --oracle-secret-manager-stored-password=ORACLE_SECRET_MANAGER_STORED_PASSWORD | --mongodb-direct-connection --mongodb-host-addresses=IPv4_ADDRESS_OR_HOSTNAME:PORT, + --oracle-username=ORACLE_USERNAME + --oracle-ca-certificate=ORACLE_CA_CERTIFICATE + --oracle-server-certificate-distinguished-name=ORACLE_SERVER_CERTIFICATE_DISTINGUISHED_NAME --oracle-password=ORACLE_PASSWORD | --oracle-prompt-for-password | --oracle-secret-manager-stored-password=ORACLE_SECRET_MANAGER_STORED_PASSWORD | --mongodb-direct-connection --mongodb-host-addresses=IPv4_ADDRESS_OR_HOSTNAME:PORT, [...] --mongodb-replica-set=MONGODB_REPLICA_SET --mongodb-tls --mongodb-username=MONGODB_USERNAME --mongodb-password=MONGODB_PASSWORD | --mongodb-prompt-for-password - | --mongodb-secret-manager-stored-password=MONGODB_SECRET_MANAGER_STORED_PASSWORD --mongodb-srv-connection-format | --mongodb-standard-connection-format | --mysql-hostname=MYSQL_HOSTNAME --mysql-port=MYSQL_PORT --mysql-username=MYSQL_USERNAME --ca-certificate=CA_CERTIFICATE --client-certificate=CLIENT_CERTIFICATE --client-key=CLIENT_KEY --mysql-password=MYSQL_PASSWORD | --mysql-prompt-for-password | --mysql-secret-manager-stored-password=MYSQL_SECRET_MANAGER_STORED_PASSWORD | --postgresql-database=POSTGRESQL_DATABASE --postgresql-hostname=POSTGRESQL_HOSTNAME --postgresql-port=POSTGRESQL_PORT --postgresql-username=POSTGRESQL_USERNAME --postgresql-ca-certificate=POSTGRESQL_CA_CERTIFICATE --postgresql-client-certificate=POSTGRESQL_CLIENT_CERTIFICATE --postgresql-client-key=POSTGRESQL_CLIENT_KEY --postgresql-password=POSTGRESQL_PASSWORD | --postgresql-prompt-for-password | --postgresql-secret-manager-stored-password=POSTGRESQL_SECRET_MANAGER_STORED_PASSWORD | --salesforce-domain=SALESFORCE_DOMAIN --salesforce-oauth2-client-id=SALESFORCE_OAUTH2_CLIENT_ID --salesforce-oauth2-client-secret=SALESFORCE_OAUTH2_CLIENT_SECRET | --salesforce-prompt-for-oauth2-client-secret | --salesforce-secret-manager-stored-oauth2-client-secret=SALESFORCE_SECRET_MANAGER_STORED_OAUTH2_CLIENT_SECRET | --salesforce-username=SALESFORCE_USERNAME --salesforce-password=SALESFORCE_PASSWORD | --salesforce-prompt-for-password | --salesforce-secret-manager-stored-password=SALESFORCE_SECRET_MANAGER_STORED_PASSWORD --salesforce-prompt-for-security-token | --salesforce-secret-manager-stored-security-token=SALESFORCE_SECRET_MANAGER_STORED_SECURITY_TOKEN | --salesforce-security-token=SALESFORCE_SECURITY_TOKEN | --sqlserver-database=SQLSERVER_DATABASE --sqlserver-hostname=SQLSERVER_HOSTNAME --sqlserver-port=SQLSERVER_PORT --sqlserver-username=SQLSERVER_USERNAME --sqlserver-password=SQLSERVER_PASSWORD | --sqlserver-prompt-for-password | --sqlserver-secret-manager-stored-password=SQLSERVER_SECRET_MANAGER_STORED_PASSWORD] + | --mongodb-secret-manager-stored-password=MONGODB_SECRET_MANAGER_STORED_PASSWORD --mongodb-srv-connection-format | --mongodb-standard-connection-format | --mysql-hostname=MYSQL_HOSTNAME --mysql-port=MYSQL_PORT --mysql-username=MYSQL_USERNAME --ca-certificate=CA_CERTIFICATE --client-certificate=CLIENT_CERTIFICATE --client-key=CLIENT_KEY --mysql-password=MYSQL_PASSWORD | --mysql-prompt-for-password | --mysql-secret-manager-stored-password=MYSQL_SECRET_MANAGER_STORED_PASSWORD | --postgresql-database=POSTGRESQL_DATABASE --postgresql-hostname=POSTGRESQL_HOSTNAME --postgresql-port=POSTGRESQL_PORT --postgresql-username=POSTGRESQL_USERNAME --postgresql-ca-certificate=POSTGRESQL_CA_CERTIFICATE --postgresql-server-certificate-hostname=POSTGRESQL_SERVER_CERTIFICATE_HOSTNAME --postgresql-client-certificate=POSTGRESQL_CLIENT_CERTIFICATE --postgresql-client-key=POSTGRESQL_CLIENT_KEY --postgresql-password=POSTGRESQL_PASSWORD | --postgresql-prompt-for-password | --postgresql-secret-manager-stored-password=POSTGRESQL_SECRET_MANAGER_STORED_PASSWORD | --salesforce-domain=SALESFORCE_DOMAIN --salesforce-oauth2-client-id=SALESFORCE_OAUTH2_CLIENT_ID --salesforce-oauth2-client-secret=SALESFORCE_OAUTH2_CLIENT_SECRET | --salesforce-prompt-for-oauth2-client-secret | --salesforce-secret-manager-stored-oauth2-client-secret=SALESFORCE_SECRET_MANAGER_STORED_OAUTH2_CLIENT_SECRET | --salesforce-username=SALESFORCE_USERNAME --salesforce-password=SALESFORCE_PASSWORD | --salesforce-prompt-for-password | --salesforce-secret-manager-stored-password=SALESFORCE_SECRET_MANAGER_STORED_PASSWORD --salesforce-prompt-for-security-token | --salesforce-secret-manager-stored-security-token=SALESFORCE_SECRET_MANAGER_STORED_SECURITY_TOKEN | --salesforce-security-token=SALESFORCE_SECURITY_TOKEN | --sqlserver-database=SQLSERVER_DATABASE --sqlserver-hostname=SQLSERVER_HOSTNAME --sqlserver-port=SQLSERVER_PORT --sqlserver-username=SQLSERVER_USERNAME --sqlserver-password=SQLSERVER_PASSWORD | --sqlserver-prompt-for-password | --sqlserver-secret-manager-stored-password=SQLSERVER_SECRET_MANAGER_STORED_PASSWORD] [--clear-labels | --remove-labels=[KEY,...]] [--no-connectivity | --private-connection-name=PRIVATE_CONNECTION_NAME | --static-ip-connectivity @@ -129,6 +129,15 @@ OPTIONAL FLAGS --oracle-username=ORACLE_USERNAME Username Datastream will use to connect to the database. + --oracle-ca-certificate=ORACLE_CA_CERTIFICATE + PEM-encoded certificate of the CA that signed the source database + server's certificate. + + --oracle-server-certificate-distinguished-name=ORACLE_SERVER_CERTIFICATE_DISTINGUISHED_NAME + The distinguished name (DN) mentioned in the server certificate. This + corresponds to the SSL_SERVER_CERT_DN sqlnet parameter. If this field + is not provided, the DN matching is not enforced. + At most one of these can be specified: --oracle-password=ORACLE_PASSWORD @@ -234,6 +243,11 @@ OPTIONAL FLAGS database server's certificate. The replica will use this certificate to verify it's connecting to the right host. + --postgresql-server-certificate-hostname=POSTGRESQL_SERVER_CERTIFICATE_HOSTNAME + The hostname mentioned in the Subject or SAN extension of the server + certificate. If this field is not provided, the hostname in the + server certificate is not validated. + --postgresql-client-certificate=POSTGRESQL_CLIENT_CERTIFICATE x509 PEM-encoded certificate that will be used by the replica to authenticate against the source database server. diff --git a/gcloud/beta/filestore/instances/create b/gcloud/beta/filestore/instances/create index 1f87fa1e9..bfc3fd8c0 100644 --- a/gcloud/beta/filestore/instances/create +++ b/gcloud/beta/filestore/instances/create @@ -183,6 +183,11 @@ REQUIRED FLAGS ▫ KRB5P: KRB5I plus privacy protection (data packets are tamper proof and encrypted). + network + The source VPC network for ip-ranges. Required for instances using + Private Service Connect, optional otherwise. If provided, must be + the same network specified in the network.name field. + source-backup The name of the backup to restore from. diff --git a/gcloud/beta/filestore/instances/update b/gcloud/beta/filestore/instances/update index f9ae368b7..8cfa3fffe 100644 --- a/gcloud/beta/filestore/instances/update +++ b/gcloud/beta/filestore/instances/update @@ -280,6 +280,11 @@ FLAGS ▫ KRB5P: KRB5I plus privacy protection (data packets are tamper proof and encrypted). + network + The source VPC network for ip-ranges. Required for instances + using Private Service Connect, optional otherwise. If provided, + must be the same network specified in the network.name field. + This flag argument must be specified if any of the other arguments in this group are specified. diff --git a/gcloud/beta/firebase/test/android/run b/gcloud/beta/firebase/test/android/run index 377503b79..4d8c11dd2 100644 --- a/gcloud/beta/firebase/test/android/run +++ b/gcloud/beta/firebase/test/android/run @@ -120,11 +120,13 @@ EXAMPLES Controlling Results Storage By default, Firebase Test Lab stores detailed test results for a limited - time in a Google Cloud Storage bucket provided for you at no charge. If you - wish to use a storage bucket that you control, or if you need to retain - detailed test results for a longer period, use the --results-bucket option. - See https://firebase.google.com/docs/test-lab/analyzing-results#detailed - for more information. + time in a Google Cloud Storage bucket provided for you at no charge. Note: + This requires the principal executing the test to have "roles/editor" role + for the project. If either you do not have that role, you wish to use a + storage bucket that you control, or you need to retain detailed test + results for a longer period, use the --results-bucket option. See + https://firebase.google.com/docs/test-lab/analyzing-results#detailed for + more information. Detailed test result files are prefixed by default with a timestamp and a random character string. If you require a predictable path where detailed diff --git a/gcloud/beta/iap/settings/set b/gcloud/beta/iap/settings/set index 3cdf9a15c..3a2b109e0 100644 --- a/gcloud/beta/iap/settings/set +++ b/gcloud/beta/iap/settings/set @@ -98,49 +98,54 @@ POSITIONAL ARGUMENTS SETTING_FILE JSON or YAML file containing the IAP resource settings. - JSON example: - { - "access_settings" : { - "oauth_settings" : { - "login_hint" : { - "value": "test_hint" - } - }, - "gcip_settings" : { - "tenant_ids": ["tenant1-p9puj", "tenant2-y8rxc"], - "login_page_uri" : { - "value" : "https://test.com/?apiKey=abcd_efgh" - } - }, - "cors_settings": { - "allow_http_options" : { - "value": true - } - } - }, - "application_settings" : { - "csm_settings" : { - "rctoken_aud" : { - "value" : "test_aud" - } - } - } - } + JSON example: + + { + "access_settings": { + "oauth_settings": { + "login_hint": { + "value": "test_hint" + } + }, + "gcip_settings": { + "tenant_ids": [ + "tenant1-p9puj", + "tenant2-y8rxc" + ], + "login_page_uri": { + "value": "https://test.com/?apiKey=abcd_efgh" + } + }, + "cors_settings": { + "allow_http_options": { + "value": true + } + } + }, + "application_settings": { + "csm_settings": { + "rctoken_aud": { + "value": "test_aud" + } + } + } + } + + YAML example: - YAML example: accessSettings : - oauthSettings: - loginHint: test_hint - gcipSettings: - tenantIds: - - tenant1-p9puj - - tenant2-y8rxc - loginPageUri: https://test.com/?apiKey=abcd_efgh - corsSettings: - allowHttpOptions: true + oauthSettings: + loginHint: test_hint + gcipSettings: + tenantIds: + - tenant1-p9puj + - tenant2-y8rxc + loginPageUri: https://test.com/?apiKey=abcd_efgh + corsSettings: + allowHttpOptions: true applicationSettings: - csmSettings: - rctokenAud: test_aud + csmSettings: + rctokenAud: test_aud FLAGS --folder=FOLDER diff --git a/gcloud/beta/netapp/volumes/create b/gcloud/beta/netapp/volumes/create index 2c8747f61..74c2b39d2 100644 --- a/gcloud/beta/netapp/volumes/create +++ b/gcloud/beta/netapp/volumes/create @@ -34,7 +34,7 @@ SYNOPSIS [--snap-reserve=SNAP_RESERVE] [--snapshot-daily=[hour=HOUR], [minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] - [--snapshot-directory=SNAPSHOT_DIRECTORY] + [--snapshot-directory=SNAPSHOT_DIRECTORY; default="true"] [--snapshot-hourly=[minute=MINUTE], [snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--snapshot-monthly=[day=DAY], @@ -249,7 +249,7 @@ OPTIONAL FLAGS --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 - --snapshot-directory=SNAPSHOT_DIRECTORY + --snapshot-directory=SNAPSHOT_DIRECTORY; default="true" Snapshot Directory if enabled (true) makes the Volume contain a read-only .snapshot directory which provides access to each of the volume's snapshots diff --git a/gcloud/beta/netapp/volumes/update b/gcloud/beta/netapp/volumes/update index 204ada226..de90f63e4 100644 --- a/gcloud/beta/netapp/volumes/update +++ b/gcloud/beta/netapp/volumes/update @@ -24,7 +24,7 @@ SYNOPSIS [--snap-reserve=SNAP_RESERVE] [--snapshot-daily=[hour=HOUR], [minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] - [--snapshot-directory=SNAPSHOT_DIRECTORY] + [--snapshot-directory=SNAPSHOT_DIRECTORY; default="true"] [--snapshot-hourly=[minute=MINUTE], [snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--snapshot-monthly=[day=DAY], @@ -158,7 +158,7 @@ FLAGS --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 - --snapshot-directory=SNAPSHOT_DIRECTORY + --snapshot-directory=SNAPSHOT_DIRECTORY; default="true" Snapshot Directory if enabled (true) makes the Volume contain a read-only .snapshot directory which provides access to each of the volume's snapshots diff --git a/gcloud/beta/network-services/multicast-domain-activations/help b/gcloud/beta/network-services/multicast-domain-activations/help index d79f6b869..97de99a38 100644 --- a/gcloud/beta/network-services/multicast-domain-activations/help +++ b/gcloud/beta/network-services/multicast-domain-activations/help @@ -29,6 +29,9 @@ COMMANDS list (BETA) List multicast domain activations. + update + (BETA) Update a multicast domain activation. + NOTES This command is currently in beta and might change without notice. This variant is also available: diff --git a/gcloud/beta/network-services/multicast-domain-activations/update b/gcloud/beta/network-services/multicast-domain-activations/update new file mode 100644 index 000000000..5ddafdbf0 --- /dev/null +++ b/gcloud/beta/network-services/multicast-domain-activations/update @@ -0,0 +1,134 @@ +NAME + gcloud beta network-services multicast-domain-activations update - update a + multicast domain activation + +SYNOPSIS + gcloud beta network-services multicast-domain-activations update + (MULTICAST_DOMAIN_ACTIVATION : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--aggr-egress-pps=AGGR_EGRESS_PPS --aggr-ingress-pps=AGGR_INGRESS_PPS + --avg-packet-size=AVG_PACKET_SIZE + --max-per-group-ingress-pps=MAX_PER_GROUP_INGRESS_PPS + --max-per-group-subscribers=MAX_PER_GROUP_SUBSCRIBERS] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a multicast domain activation in the specified location of + the current project. + +EXAMPLES + Update a multicast domain activation with the name + my-multicast-domain-activation and location zone. + + $ gcloud beta network-services multicast-domain-activations update \ + my-multicast-domain-activation --aggr-egress-pps=10000 \ + --max-per-group-subscribers=10 --location=zone + +POSITIONAL ARGUMENTS + Multicast domain activation resource - Name of the multicast domain + activation to be updated. 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 multicast_domain_activation 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. + + MULTICAST_DOMAIN_ACTIVATION + ID of the multicast domain activation or fully qualified identifier + for the multicast domain activation. + + To set the multicast_domain_activation attribute: + ▸ provide the argument multicast_domain_activation on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain_activation on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the multicast domain activation. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --aggr-egress-pps=AGGR_EGRESS_PPS + Aggregated egress packets per second for all multicast groups in the + domain in this zone. + + --aggr-ingress-pps=AGGR_INGRESS_PPS + Aggregated ingress Packet-Per-Second for all multicast groups in the + domain in this zone. + + --avg-packet-size=AVG_PACKET_SIZE + Average packet size (defaults to 512 bytes). + + --max-per-group-ingress-pps=MAX_PER_GROUP_INGRESS_PPS + Maximum ingress Packet-Per-Second for a single multicast group in this + zone. + + --max-per-group-subscribers=MAX_PER_GROUP_SUBSCRIBERS + Maximum number of subscribers for a single multicast group in this + zone. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta network-services multicast-domain-activations update \ + --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta network-services multicast-domain-activations update \ + --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-services multicast-domain-activations update + diff --git a/gcloud/beta/pubsub/subscriptions/create b/gcloud/beta/pubsub/subscriptions/create index 7f06e08e9..4231b9787 100644 --- a/gcloud/beta/pubsub/subscriptions/create +++ b/gcloud/beta/pubsub/subscriptions/create @@ -298,7 +298,7 @@ OPTIONAL FLAGS --max-retry-delay=MAX_RETRY_DELAY The maximum delay between consecutive deliveries of a given message. - Value should be between 0 and 600 seconds. Defaults to 10 seconds. + Value should be between 0 and 600 seconds. Defaults to 600 seconds. Valid values are strings of the form INTEGER[UNIT], where UNIT is one of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. diff --git a/gcloud/beta/pubsub/subscriptions/update b/gcloud/beta/pubsub/subscriptions/update index 8908093fb..2286db737 100644 --- a/gcloud/beta/pubsub/subscriptions/update +++ b/gcloud/beta/pubsub/subscriptions/update @@ -333,7 +333,7 @@ FLAGS --max-retry-delay=MAX_RETRY_DELAY The maximum delay between consecutive deliveries of a given - message. Value should be between 0 and 600 seconds. Defaults to 10 + message. Value should be between 0 and 600 seconds. Defaults to 600 seconds. Valid values are strings of the form INTEGER[UNIT], where UNIT is one of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. diff --git a/gcloud/beta/run/jobs/create b/gcloud/beta/run/jobs/create index e905841a5..3beefafdd 100644 --- a/gcloud/beta/run/jobs/create +++ b/gcloud/beta/run/jobs/create @@ -16,8 +16,8 @@ SYNOPSIS [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --image=IMAGE - --memory=MEMORY - --remove-volume-mount=[MOUNT_PATH,...] --clear-env-vars + --memory=MEMORY --remove-volume-mount=[MOUNT_PATH,...] + --startup-probe=[KEY=VALUE,...] --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets @@ -245,6 +245,23 @@ FLAGS Removes the volume mounted at the specified path from the current container. + --startup-probe=[KEY=VALUE,...] + Comma separated settings for startup probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: initialDelaySeconds, timeoutSeconds, + periodSeconds, failureThreshold, httpGet.port, httpGet.path, + grpc.port, grpc.service, tcpSocket.port. + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --startup-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --startup-probe="" + At most one of these can be specified: --clear-env-vars diff --git a/gcloud/beta/run/jobs/deploy b/gcloud/beta/run/jobs/deploy index 22e614fb7..7f89b6dc4 100644 --- a/gcloud/beta/run/jobs/deploy +++ b/gcloud/beta/run/jobs/deploy @@ -17,7 +17,8 @@ SYNOPSIS [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --memory=MEMORY - --remove-volume-mount=[MOUNT_PATH,...] --clear-env-vars + --remove-volume-mount=[MOUNT_PATH,...] + --startup-probe=[KEY=VALUE,...] --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets @@ -246,6 +247,23 @@ FLAGS Removes the volume mounted at the specified path from the current container. + --startup-probe=[KEY=VALUE,...] + Comma separated settings for startup probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: initialDelaySeconds, timeoutSeconds, + periodSeconds, failureThreshold, httpGet.port, httpGet.path, + grpc.port, grpc.service, tcpSocket.port. + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --startup-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --startup-probe="" + At most one of these can be specified: --clear-env-vars diff --git a/gcloud/beta/run/jobs/update b/gcloud/beta/run/jobs/update index 0ae310f5e..028072c16 100644 --- a/gcloud/beta/run/jobs/update +++ b/gcloud/beta/run/jobs/update @@ -19,8 +19,8 @@ SYNOPSIS [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --image=IMAGE - --memory=MEMORY - --remove-volume-mount=[MOUNT_PATH,...] --clear-env-vars + --memory=MEMORY --remove-volume-mount=[MOUNT_PATH,...] + --startup-probe=[KEY=VALUE,...] --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets @@ -262,6 +262,23 @@ FLAGS Removes the volume mounted at the specified path from the current container. + --startup-probe=[KEY=VALUE,...] + Comma separated settings for startup probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: initialDelaySeconds, timeoutSeconds, + periodSeconds, failureThreshold, httpGet.port, httpGet.path, + grpc.port, grpc.service, tcpSocket.port. + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --startup-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --startup-probe="" + At most one of these can be specified: --clear-env-vars diff --git a/gcloud/beta/saas-runtime/releases/create b/gcloud/beta/saas-runtime/releases/create index c68888621..5c9a3aba7 100644 --- a/gcloud/beta/saas-runtime/releases/create +++ b/gcloud/beta/saas-runtime/releases/create @@ -150,7 +150,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/releases/delete b/gcloud/beta/saas-runtime/releases/delete index 0e8c600f3..3c94b98ec 100644 --- a/gcloud/beta/saas-runtime/releases/delete +++ b/gcloud/beta/saas-runtime/releases/delete @@ -53,7 +53,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/releases/describe b/gcloud/beta/saas-runtime/releases/describe index 6aa8277e4..71e380e26 100644 --- a/gcloud/beta/saas-runtime/releases/describe +++ b/gcloud/beta/saas-runtime/releases/describe @@ -53,7 +53,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/releases/list b/gcloud/beta/saas-runtime/releases/list index 0013cb820..9a8abe667 100644 --- a/gcloud/beta/saas-runtime/releases/list +++ b/gcloud/beta/saas-runtime/releases/list @@ -76,7 +76,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/releases/update b/gcloud/beta/saas-runtime/releases/update index e71094f66..185209a80 100644 --- a/gcloud/beta/saas-runtime/releases/update +++ b/gcloud/beta/saas-runtime/releases/update @@ -246,7 +246,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/rollout-kinds/create b/gcloud/beta/saas-runtime/rollout-kinds/create index 78dbf205c..29e0758f7 100644 --- a/gcloud/beta/saas-runtime/rollout-kinds/create +++ b/gcloud/beta/saas-runtime/rollout-kinds/create @@ -145,7 +145,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/rollout-kinds/delete b/gcloud/beta/saas-runtime/rollout-kinds/delete index e79a71234..d9a77b1ee 100644 --- a/gcloud/beta/saas-runtime/rollout-kinds/delete +++ b/gcloud/beta/saas-runtime/rollout-kinds/delete @@ -55,7 +55,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/rollout-kinds/describe b/gcloud/beta/saas-runtime/rollout-kinds/describe index e746f5e46..31f8ea77f 100644 --- a/gcloud/beta/saas-runtime/rollout-kinds/describe +++ b/gcloud/beta/saas-runtime/rollout-kinds/describe @@ -55,7 +55,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/rollout-kinds/list b/gcloud/beta/saas-runtime/rollout-kinds/list index d76913965..eb89d9841 100644 --- a/gcloud/beta/saas-runtime/rollout-kinds/list +++ b/gcloud/beta/saas-runtime/rollout-kinds/list @@ -76,7 +76,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/rollout-kinds/update b/gcloud/beta/saas-runtime/rollout-kinds/update index 9b27735a8..bafad806b 100644 --- a/gcloud/beta/saas-runtime/rollout-kinds/update +++ b/gcloud/beta/saas-runtime/rollout-kinds/update @@ -174,7 +174,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/rollouts/create b/gcloud/beta/saas-runtime/rollouts/create index 16d9ed567..e56b4efdf 100644 --- a/gcloud/beta/saas-runtime/rollouts/create +++ b/gcloud/beta/saas-runtime/rollouts/create @@ -159,7 +159,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/rollouts/delete b/gcloud/beta/saas-runtime/rollouts/delete index 3e7b9c270..1d10352e4 100644 --- a/gcloud/beta/saas-runtime/rollouts/delete +++ b/gcloud/beta/saas-runtime/rollouts/delete @@ -53,7 +53,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/rollouts/describe b/gcloud/beta/saas-runtime/rollouts/describe index b91f2a292..82ca4c291 100644 --- a/gcloud/beta/saas-runtime/rollouts/describe +++ b/gcloud/beta/saas-runtime/rollouts/describe @@ -53,7 +53,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/rollouts/list b/gcloud/beta/saas-runtime/rollouts/list index b46712397..7a5715cd3 100644 --- a/gcloud/beta/saas-runtime/rollouts/list +++ b/gcloud/beta/saas-runtime/rollouts/list @@ -76,7 +76,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/rollouts/update b/gcloud/beta/saas-runtime/rollouts/update index 3b7594a67..203a7a047 100644 --- a/gcloud/beta/saas-runtime/rollouts/update +++ b/gcloud/beta/saas-runtime/rollouts/update @@ -180,7 +180,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/saas/create b/gcloud/beta/saas-runtime/saas/create index 9105e68f1..da12ab243 100644 --- a/gcloud/beta/saas-runtime/saas/create +++ b/gcloud/beta/saas-runtime/saas/create @@ -100,7 +100,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/saas/delete b/gcloud/beta/saas-runtime/saas/delete index defcaa5d9..533a5e9c0 100644 --- a/gcloud/beta/saas-runtime/saas/delete +++ b/gcloud/beta/saas-runtime/saas/delete @@ -54,7 +54,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/saas/describe b/gcloud/beta/saas-runtime/saas/describe index 6fb66ba8d..8081b2a66 100644 --- a/gcloud/beta/saas-runtime/saas/describe +++ b/gcloud/beta/saas-runtime/saas/describe @@ -54,7 +54,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/saas/list b/gcloud/beta/saas-runtime/saas/list index 8b6293a86..08e360921 100644 --- a/gcloud/beta/saas-runtime/saas/list +++ b/gcloud/beta/saas-runtime/saas/list @@ -76,7 +76,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/saas/update b/gcloud/beta/saas-runtime/saas/update index 2ed5e7857..b9e92b1c5 100644 --- a/gcloud/beta/saas-runtime/saas/update +++ b/gcloud/beta/saas-runtime/saas/update @@ -204,7 +204,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/tenants/create b/gcloud/beta/saas-runtime/tenants/create index e23a67809..604593588 100644 --- a/gcloud/beta/saas-runtime/tenants/create +++ b/gcloud/beta/saas-runtime/tenants/create @@ -108,7 +108,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/tenants/delete b/gcloud/beta/saas-runtime/tenants/delete index 1291ff25b..eefa18212 100644 --- a/gcloud/beta/saas-runtime/tenants/delete +++ b/gcloud/beta/saas-runtime/tenants/delete @@ -53,7 +53,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/tenants/describe b/gcloud/beta/saas-runtime/tenants/describe index 454597ed1..0ea066427 100644 --- a/gcloud/beta/saas-runtime/tenants/describe +++ b/gcloud/beta/saas-runtime/tenants/describe @@ -53,7 +53,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/tenants/list b/gcloud/beta/saas-runtime/tenants/list index 50379939d..a488c77a6 100644 --- a/gcloud/beta/saas-runtime/tenants/list +++ b/gcloud/beta/saas-runtime/tenants/list @@ -76,7 +76,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/tenants/update b/gcloud/beta/saas-runtime/tenants/update index 9dba817ff..33b3b5b04 100644 --- a/gcloud/beta/saas-runtime/tenants/update +++ b/gcloud/beta/saas-runtime/tenants/update @@ -130,7 +130,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/unit-kinds/create b/gcloud/beta/saas-runtime/unit-kinds/create index 56354a295..2c22955ce 100644 --- a/gcloud/beta/saas-runtime/unit-kinds/create +++ b/gcloud/beta/saas-runtime/unit-kinds/create @@ -241,7 +241,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/unit-kinds/delete b/gcloud/beta/saas-runtime/unit-kinds/delete index a27e7254e..92959398c 100644 --- a/gcloud/beta/saas-runtime/unit-kinds/delete +++ b/gcloud/beta/saas-runtime/unit-kinds/delete @@ -53,7 +53,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/unit-kinds/describe b/gcloud/beta/saas-runtime/unit-kinds/describe index e271da522..01692fce3 100644 --- a/gcloud/beta/saas-runtime/unit-kinds/describe +++ b/gcloud/beta/saas-runtime/unit-kinds/describe @@ -53,7 +53,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/unit-kinds/list b/gcloud/beta/saas-runtime/unit-kinds/list index e074ff408..6a877419e 100644 --- a/gcloud/beta/saas-runtime/unit-kinds/list +++ b/gcloud/beta/saas-runtime/unit-kinds/list @@ -76,7 +76,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/unit-kinds/update b/gcloud/beta/saas-runtime/unit-kinds/update index a14cf1259..a7cb5d656 100644 --- a/gcloud/beta/saas-runtime/unit-kinds/update +++ b/gcloud/beta/saas-runtime/unit-kinds/update @@ -564,7 +564,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/unit-operations/create b/gcloud/beta/saas-runtime/unit-operations/create index 4dab1a62e..9543da528 100644 --- a/gcloud/beta/saas-runtime/unit-operations/create +++ b/gcloud/beta/saas-runtime/unit-operations/create @@ -291,7 +291,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/unit-operations/delete b/gcloud/beta/saas-runtime/unit-operations/delete index eda3f346d..395766101 100644 --- a/gcloud/beta/saas-runtime/unit-operations/delete +++ b/gcloud/beta/saas-runtime/unit-operations/delete @@ -55,7 +55,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/unit-operations/describe b/gcloud/beta/saas-runtime/unit-operations/describe index 6906c7673..c8ee15b7e 100644 --- a/gcloud/beta/saas-runtime/unit-operations/describe +++ b/gcloud/beta/saas-runtime/unit-operations/describe @@ -56,7 +56,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/unit-operations/list b/gcloud/beta/saas-runtime/unit-operations/list index 514d11552..7cd30a8ce 100644 --- a/gcloud/beta/saas-runtime/unit-operations/list +++ b/gcloud/beta/saas-runtime/unit-operations/list @@ -76,7 +76,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/unit-operations/update b/gcloud/beta/saas-runtime/unit-operations/update index 83b887aa8..398f277c1 100644 --- a/gcloud/beta/saas-runtime/unit-operations/update +++ b/gcloud/beta/saas-runtime/unit-operations/update @@ -491,7 +491,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/units/create b/gcloud/beta/saas-runtime/units/create index ff7cd1e3c..113eab9d1 100644 --- a/gcloud/beta/saas-runtime/units/create +++ b/gcloud/beta/saas-runtime/units/create @@ -147,7 +147,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/units/delete b/gcloud/beta/saas-runtime/units/delete index e188fd326..66033ebb5 100644 --- a/gcloud/beta/saas-runtime/units/delete +++ b/gcloud/beta/saas-runtime/units/delete @@ -53,7 +53,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/units/describe b/gcloud/beta/saas-runtime/units/describe index 1b3fc6ff3..c1083a0f2 100644 --- a/gcloud/beta/saas-runtime/units/describe +++ b/gcloud/beta/saas-runtime/units/describe @@ -53,7 +53,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/units/list b/gcloud/beta/saas-runtime/units/list index 689448e4b..698b3ead2 100644 --- a/gcloud/beta/saas-runtime/units/list +++ b/gcloud/beta/saas-runtime/units/list @@ -76,7 +76,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/saas-runtime/units/update b/gcloud/beta/saas-runtime/units/update index 1bfe0c6fb..cc517761a 100644 --- a/gcloud/beta/saas-runtime/units/update +++ b/gcloud/beta/saas-runtime/units/update @@ -205,7 +205,7 @@ GCLOUD WIDE FLAGS API REFERENCE This command uses the saasservicemgmt/v1beta1 API. The full documentation - for this API can be found at: https://cloud.google.com/ + for this API can be found at: https://cloud.google.com/saas-runtime/docs NOTES This command is currently in beta and might change without notice. diff --git a/gcloud/beta/source-manager/repos/delete b/gcloud/beta/source-manager/repos/delete index 8577b10a3..9403b1292 100644 --- a/gcloud/beta/source-manager/repos/delete +++ b/gcloud/beta/source-manager/repos/delete @@ -50,8 +50,8 @@ POSITIONAL ARGUMENTS FLAGS --allow-missing - If set to true, and the repository is not found, the request will - succeed but no action will be taken on the server. + If set to true, and the resource is not found, the request will succeed + but no action will be taken on the server. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/sql/backups/restore b/gcloud/beta/sql/backups/restore index 827f7fc26..1274061ae 100644 --- a/gcloud/beta/sql/backups/restore +++ b/gcloud/beta/sql/backups/restore @@ -47,10 +47,11 @@ SYNOPSIS | --secondary-zone=SECONDARY_ZONE --zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) The command lets you restore to an existing instance using ID. When - backup Name is used for restore it lets you restore to an existing instance - or a new instance. When restoring to new instance, optional flags can be - used to customize the new instance. + (BETA) The command lets you restore to an existing instance using ID. To + restore using a backupDR backup, use the backupDR ID. When backup Name is + used to restore it lets you restore to an existing instance or a new + instance. When restoring to new instance, optional flags can be used to + customize the new instance. POSITIONAL ARGUMENTS ID diff --git a/gcloud/beta/sql/instances/delete b/gcloud/beta/sql/instances/delete index 6d970d8ba..8f4e4dc2a 100644 --- a/gcloud/beta/sql/instances/delete +++ b/gcloud/beta/sql/instances/delete @@ -30,11 +30,13 @@ FLAGS --final-backup-expiry-time=FINAL_BACKUP_EXPIRY_TIME Specifies the time at which the final backup will expire. Maximum - time allowed is 365 days from now. Format: YYYY-MM-DDTHH:MM:SS. + time allowed is 365 days. For instances managed by BackupDR, the + maximum time allowed is 99 years. Format: YYYY-MM-DDTHH:MM:SS. --final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS Specifies number of days to retain final backup. The valid range is - between 1 and 365. Default value is 30 days. + between 1 and 365. For instances managed by BackupDR, the valid range + is between 1 day and 99 years. Default value is 30 days. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/sql/instances/help b/gcloud/beta/sql/instances/help index c8832bf9c..16d2b42a5 100644 --- a/gcloud/beta/sql/instances/help +++ b/gcloud/beta/sql/instances/help @@ -49,6 +49,10 @@ COMMANDS patch (BETA) Updates the settings of a Cloud SQL instance. + point-in-time-restore + (BETA) Performs a point in time restore for a Cloud SQL instance + managed by Google Cloud Backup and Disaster Recovery. + promote-replica (BETA) Promotes Cloud SQL read replica to a stand-alone instance. diff --git a/gcloud/beta/sql/instances/point-in-time-restore b/gcloud/beta/sql/instances/point-in-time-restore new file mode 100644 index 000000000..909db94bf --- /dev/null +++ b/gcloud/beta/sql/instances/point-in-time-restore @@ -0,0 +1,82 @@ +NAME + gcloud beta sql instances point-in-time-restore - performs a point in time + restore for a Cloud SQL instance managed by Google Cloud Backup and + Disaster Recovery + +SYNOPSIS + gcloud beta sql instances point-in-time-restore DATASOURCE TARGET + POINT_IN_TIME [--allocated-ip-range-name=ALLOCATED_IP_RANGE_NAME] + [--async] [--preferred-secondary-zone=PREFERRED_SECONDARY_ZONE] + [--preferred-zone=PREFERRED_ZONE] [--private-network=PRIVATE_NETWORK] + [--restore-database-names=RESTORE_DATABASE_NAMES] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) gcloud beta sql instances point-in-time-restore performs a point in + time restore for a Cloud SQL instance managed by Google Cloud Backup and + Disaster Recovery. + +EXAMPLES + To perform a point in time restore from an earlier point in time: + + $ gcloud beta sql instances point-in-time-restore datasource \ + target-instance '2012-11-15T16:19:00.094Z' + +POSITIONAL ARGUMENTS + DATASOURCE + The Google Cloud Backup and Disaster Recovery Datasource URI, of the + form projects/{project}/locations/{region}/backupVaults/ + {backupvault}/dataSources/{datasource}. + + TARGET + Cloud SQL instance ID of the target instance. + + POINT_IN_TIME + The point in time in which to restore the instance to. Uses RFC 3339 + format in UTC timezone. For example, '2012-11-15T16:19:00.094Z'. + +FLAGS + --allocated-ip-range-name=ALLOCATED_IP_RANGE_NAME + The name of the IP range allocated for the target instance with private + network connectivity. For example: 'google-managed-services-default'. + If set, the target instance IP is created in the allocated range + represented by this name. Reserved for future use. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --preferred-secondary-zone=PREFERRED_SECONDARY_ZONE + The preferred secondary zone for the cloned regional instance. If you + specify a value for this flag, then the target instance uses the value + as the secondary zone. The secondary zone can't be the same as the + primary zone. + + --preferred-zone=PREFERRED_ZONE + The preferred zone for the target instance. If you specify a value for + this flag, then the target instance uses the value as the primary zone. + + --private-network=PRIVATE_NETWORK + The resource link for the VPC network from which the Cloud SQL instance + is accessible for private IP. For example, + '/projects/myProject/global/networks/default'. + + --restore-database-names=RESTORE_DATABASE_NAMES + The name of the databases to be restored for a point-in-time restore. + If set, the destination instance will only restore the specified + databases. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha sql instances point-in-time-restore + diff --git a/gcloud/compute/reservations/blocks/describe b/gcloud/compute/reservations/blocks/describe index 474ef4ec1..a4be7cf45 100644 --- a/gcloud/compute/reservations/blocks/describe +++ b/gcloud/compute/reservations/blocks/describe @@ -4,7 +4,9 @@ NAME SYNOPSIS gcloud compute reservations blocks describe RESERVATION - --block-name=BLOCK_NAME [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + --block-name=BLOCK_NAME + [--full-view=FULL_VIEW; default="BLOCK_VIEW_UNSPECIFIED"] [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Describe a Compute Engine reservation block. @@ -25,6 +27,14 @@ REQUIRED FLAGS The name of the reservation block. OPTIONAL FLAGS + --full-view=FULL_VIEW; default="BLOCK_VIEW_UNSPECIFIED" + The view type for the reservation block. FULL_VIEW must be one of: + + BLOCK_VIEW_BASIC + Basic default view of the reservation block. + BLOCK_VIEW_FULL + Full detailed view of the reservation block. + --zone=ZONE Zone of the reservation to describe. If not specified and the compute/zone property isn't set, you might be prompted to select a zone diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index 215fc9d41..3c9ea752b 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -93,6 +93,8 @@ SYNOPSIS --service-account-verification-keys=KEY_VERSION,[KEY_VERSION,...]] [--binauthz-evaluation-mode=BINAUTHZ_EVALUATION_MODE | --enable-binauthz] + [--boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS + --boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT] [--cluster-dns=CLUSTER_DNS --cluster-dns-domain=CLUSTER_DNS_DOMAIN --cluster-dns-scope=CLUSTER_DNS_SCOPE --additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN @@ -1660,6 +1662,16 @@ FLAGS The --enable-binauthz flag is deprecated. Please use --binauthz-evaluation-mode instead. + Configure boot disk options. + + --boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS + Configure the Provisioned IOPS for the node pool boot disks. Only + valid for hyperdisk-balanced boot disks. + + --boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT + Configure the Provisioned Throughput for the node pool boot disks. + Only valid for hyperdisk-throughput boot disks. + ClusterDNS --cluster-dns=CLUSTER_DNS diff --git a/gcloud/container/fleet/cloudrun/disable b/gcloud/container/fleet/cloudrun/disable index d08fc63d5..ec4d81c0b 100644 --- a/gcloud/container/fleet/cloudrun/disable +++ b/gcloud/container/fleet/cloudrun/disable @@ -14,8 +14,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/container/fleet/dataplane-v2-encryption/disable b/gcloud/container/fleet/dataplane-v2-encryption/disable index 6775f19d4..73f38aaae 100644 --- a/gcloud/container/fleet/dataplane-v2-encryption/disable +++ b/gcloud/container/fleet/dataplane-v2-encryption/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/container/fleet/fleetobservability/disable b/gcloud/container/fleet/fleetobservability/disable index 025696537..3d3c85a1a 100644 --- a/gcloud/container/fleet/fleetobservability/disable +++ b/gcloud/container/fleet/fleetobservability/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/container/fleet/identity-service/disable b/gcloud/container/fleet/identity-service/disable index 3b1913219..11d635bd2 100644 --- a/gcloud/container/fleet/identity-service/disable +++ b/gcloud/container/fleet/identity-service/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/container/fleet/ingress/disable b/gcloud/container/fleet/ingress/disable index 721a34bff..8cf9c674f 100644 --- a/gcloud/container/fleet/ingress/disable +++ b/gcloud/container/fleet/ingress/disable @@ -15,8 +15,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/container/fleet/multi-cluster-services/disable b/gcloud/container/fleet/multi-cluster-services/disable index 19abd05db..8af22598b 100644 --- a/gcloud/container/fleet/multi-cluster-services/disable +++ b/gcloud/container/fleet/multi-cluster-services/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/container/hub/cloudrun/disable b/gcloud/container/hub/cloudrun/disable index 2b1b2513c..ecb80887d 100644 --- a/gcloud/container/hub/cloudrun/disable +++ b/gcloud/container/hub/cloudrun/disable @@ -14,8 +14,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/container/hub/dataplane-v2-encryption/disable b/gcloud/container/hub/dataplane-v2-encryption/disable index 258d567e2..72b48343a 100644 --- a/gcloud/container/hub/dataplane-v2-encryption/disable +++ b/gcloud/container/hub/dataplane-v2-encryption/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/container/hub/fleetobservability/disable b/gcloud/container/hub/fleetobservability/disable index c93344d74..f85e319b8 100644 --- a/gcloud/container/hub/fleetobservability/disable +++ b/gcloud/container/hub/fleetobservability/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/container/hub/identity-service/disable b/gcloud/container/hub/identity-service/disable index 6ffcb3e9f..e5b90141e 100644 --- a/gcloud/container/hub/identity-service/disable +++ b/gcloud/container/hub/identity-service/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/container/hub/ingress/disable b/gcloud/container/hub/ingress/disable index dae388b12..31f9c0227 100644 --- a/gcloud/container/hub/ingress/disable +++ b/gcloud/container/hub/ingress/disable @@ -15,8 +15,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/container/hub/multi-cluster-services/disable b/gcloud/container/hub/multi-cluster-services/disable index 22b7fd63b..ed958b655 100644 --- a/gcloud/container/hub/multi-cluster-services/disable +++ b/gcloud/container/hub/multi-cluster-services/disable @@ -16,8 +16,9 @@ EXAMPLES FLAGS --force - Disable this feature, even if it is currently in use. Force disablement - may result in unexpected behavior. + Bypasses any prompts for confirmation. When disabling the entire + feature, forces disable even if the feature is in use. Force + disablement of the entire feature may result in unexpected behavior. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/container/node-pools/create b/gcloud/container/node-pools/create index 2a58bc0db..f293904e2 100644 --- a/gcloud/container/node-pools/create +++ b/gcloud/container/node-pools/create @@ -14,8 +14,10 @@ SYNOPSIS [--additional-pod-network=[subnetwork=SUBNETWORK_NAME, pod-ipv4-range=SECONDARY_RANGE_NAME, [max-pods-per-node=NUM_PODS],...]] [--async] - [--boot-disk-kms-key=BOOT_DISK_KMS_KEY] [--cluster=CLUSTER] - [--confidential-node-type=CONFIDENTIAL_NODE_TYPE] + [--boot-disk-kms-key=BOOT_DISK_KMS_KEY] + [--boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS] + [--boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT] + [--cluster=CLUSTER] [--confidential-node-type=CONFIDENTIAL_NODE_TYPE] [--containerd-config-from-file=PATH_TO_FILE] [--data-cache-count=DATA_CACHE_COUNT] [--disk-size=DISK_SIZE] [--disk-type=DISK_TYPE] [--enable-autoprovisioning] @@ -187,6 +189,14 @@ FLAGS please see: https://cloud.google.com/compute/docs/disks/customer-managed-encryption + --boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS + Configure the Provisioned IOPS for the node pool boot disks. Only valid + for hyperdisk-balanced boot disks. + + --boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT + Configure the Provisioned Throughput for the node pool boot disks. Only + valid for hyperdisk-throughput boot disks. + --cluster=CLUSTER The cluster to add the node pool to. Overrides the default container/cluster property value for this command invocation. diff --git a/gcloud/container/node-pools/update b/gcloud/container/node-pools/update index 42ba21800..5db874ee9 100644 --- a/gcloud/container/node-pools/update +++ b/gcloud/container/node-pools/update @@ -24,7 +24,10 @@ SYNOPSIS | --storage-pools=STORAGE_POOL,[...] | --system-config-from-file=PATH_TO_FILE | --tags=[TAG,...] | --windows-os-version=WINDOWS_OS_VERSION - | --workload-metadata=WORKLOAD_METADATA | --disk-size=DISK_SIZE + | --workload-metadata=WORKLOAD_METADATA + | --boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS + --boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT + --disk-size=DISK_SIZE --disk-type=DISK_TYPE --machine-type=MACHINE_TYPE | --enable-autoprovisioning --enable-autoscaling --location-policy=LOCATION_POLICY --max-nodes=MAX_NODES @@ -565,6 +568,14 @@ REQUIRED FLAGS Node config + --boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS + Configure the Provisioned IOPS for the node pool boot disks. Only + valid for hyperdisk-balanced boot disks. + + --boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT + Configure the Provisioned Throughput for the node pool boot disks. + Only valid for hyperdisk-throughput boot disks. + --disk-size=DISK_SIZE Size for node VM boot disks in GB. Defaults to 100GB. diff --git a/gcloud/dataflow/yaml/run b/gcloud/dataflow/yaml/run index 30d23a9ee..185728a39 100644 --- a/gcloud/dataflow/yaml/run +++ b/gcloud/dataflow/yaml/run @@ -5,9 +5,11 @@ SYNOPSIS gcloud dataflow yaml run JOB_NAME (--yaml-pipeline=YAML_PIPELINE | --yaml-pipeline-file=YAML_PIPELINE_FILE) - [--jinja-variables=JSON_OBJECT] + [--jinja-variables=JSON_OBJECT] [--network=NETWORK] [--pipeline-options=[OPTIONS=VALUE;OPTION=VALUE,...]] - [--region=REGION_ID] [GCLOUD_WIDE_FLAG ...] + [--region=REGION_ID] [--subnetwork=SUBNETWORK] + [--template-file-gcs-location=TEMPLATE_FILE_GCS_LOCATION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Runs a job from the specified YAML description or Cloud Storage path. @@ -36,12 +38,24 @@ OPTIONAL FLAGS --jinja-variables=JSON_OBJECT Jinja2 variables to be used in reifying the yaml. + --network=NETWORK + Compute Engine network for launching worker instances to run the + pipeline. If not set, the default network is used. + --pipeline-options=[OPTIONS=VALUE;OPTION=VALUE,...] Pipeline options to pass to the job. --region=REGION_ID Region ID of the job's regional endpoint. Defaults to 'us-central1'. + --subnetwork=SUBNETWORK + Compute Engine subnetwork for launching worker instances to run the + pipeline. If not set, the default subnetwork is used. + + --template-file-gcs-location=TEMPLATE_FILE_GCS_LOCATION + Google Cloud Storage location of the YAML template to run. (Must be a + URL beginning with 'gs://'.) + 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/dataproc/clusters/diagnose b/gcloud/dataproc/clusters/diagnose index 5682227a7..40e943c17 100644 --- a/gcloud/dataproc/clusters/diagnose +++ b/gcloud/dataproc/clusters/diagnose @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud dataproc clusters diagnose (CLUSTER : --region=REGION) [--end-time=END_TIME] [--job-ids=JOB_IDS] [--start-time=START_TIME] - [--tarball-access=TARBALL_ACCESS] + [--tarball-access=TARBALL_ACCESS] [--tarball-gcs-dir=TARBALL_GCS_DIR] [--yarn-application-ids=YARN_APPLICATION_IDS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -63,9 +63,14 @@ FLAGS format). --tarball-access=TARBALL_ACCESS - Target access privileges for diagnose tarball. TARBALL_ACCESS must be + Target access privileges for diagnostic tarball. TARBALL_ACCESS must be one of: GOOGLE_CLOUD_SUPPORT, GOOGLE_DATAPROC_DIAGNOSE. + --tarball-gcs-dir=TARBALL_GCS_DIR + The output Cloud Storage directory for the diagnostic tarball. If not + specified, a task-specific directory in the cluster's staging bucket + will be used. + --yarn-application-ids=YARN_APPLICATION_IDS A list of yarn applications on which to perform the diagnosis. diff --git a/gcloud/datastream/connection-profiles/create b/gcloud/datastream/connection-profiles/create index 7e2167698..1c5c59cbd 100644 --- a/gcloud/datastream/connection-profiles/create +++ b/gcloud/datastream/connection-profiles/create @@ -7,14 +7,14 @@ SYNOPSIS (CONNECTION_PROFILE : --location=LOCATION) --display-name=DISPLAY_NAME --type=TYPE [--force] [--labels=[KEY=VALUE,...]] [[--bucket=BUCKET : --root-path=ROOT_PATH] - | --database-service=DATABASE_SERVICE + | [--database-service=DATABASE_SERVICE --oracle-hostname=ORACLE_HOSTNAME --oracle-port=ORACLE_PORT --oracle-username=ORACLE_USERNAME (--oracle-password=ORACLE_PASSWORD | --oracle-prompt-for-password - | --oracle-secret-manager-stored-password=ORACLE_SECRET_MANAGER_STORED_PASSWORD) | [--mongodb-host-addresses=IPv4_ADDRESS_OR_HOSTNAME:PORT, + | --oracle-secret-manager-stored-password=ORACLE_SECRET_MANAGER_STORED_PASSWORD) : --oracle-ca-certificate=ORACLE_CA_CERTIFICATE --oracle-server-certificate-distinguished-name=ORACLE_SERVER_CERTIFICATE_DISTINGUISHED_NAME] | [--mongodb-host-addresses=IPv4_ADDRESS_OR_HOSTNAME:PORT, [...] --mongodb-username=MONGODB_USERNAME (--mongodb-password=MONGODB_PASSWORD | --mongodb-prompt-for-password - | --mongodb-secret-manager-stored-password=MONGODB_SECRET_MANAGER_STORED_PASSWORD) (--mongodb-srv-connection-format | --mongodb-standard-connection-format) : --mongodb-direct-connection --mongodb-replica-set=MONGODB_REPLICA_SET --mongodb-tls] | [--mysql-hostname=MYSQL_HOSTNAME --mysql-port=MYSQL_PORT --mysql-username=MYSQL_USERNAME (--mysql-password=MYSQL_PASSWORD | --mysql-prompt-for-password | --mysql-secret-manager-stored-password=MYSQL_SECRET_MANAGER_STORED_PASSWORD) : --ca-certificate=CA_CERTIFICATE --client-certificate=CLIENT_CERTIFICATE --client-key=CLIENT_KEY] | [--postgresql-database=POSTGRESQL_DATABASE --postgresql-hostname=POSTGRESQL_HOSTNAME --postgresql-port=POSTGRESQL_PORT --postgresql-username=POSTGRESQL_USERNAME (--postgresql-password=POSTGRESQL_PASSWORD | --postgresql-prompt-for-password | --postgresql-secret-manager-stored-password=POSTGRESQL_SECRET_MANAGER_STORED_PASSWORD) : [--postgresql-ca-certificate=POSTGRESQL_CA_CERTIFICATE : --postgresql-client-certificate=POSTGRESQL_CLIENT_CERTIFICATE --postgresql-client-key=POSTGRESQL_CLIENT_KEY]] | --salesforce-domain=SALESFORCE_DOMAIN (--salesforce-oauth2-client-id=SALESFORCE_OAUTH2_CLIENT_ID (--salesforce-oauth2-client-secret=SALESFORCE_OAUTH2_CLIENT_SECRET | --salesforce-prompt-for-oauth2-client-secret | --salesforce-secret-manager-stored-oauth2-client-secret=SALESFORCE_SECRET_MANAGER_STORED_OAUTH2_CLIENT_SECRET) | --salesforce-username=SALESFORCE_USERNAME (--salesforce-password=SALESFORCE_PASSWORD | --salesforce-prompt-for-password | --salesforce-secret-manager-stored-password=SALESFORCE_SECRET_MANAGER_STORED_PASSWORD) (--salesforce-prompt-for-security-token | --salesforce-secret-manager-stored-security-token=SALESFORCE_SECRET_MANAGER_STORED_SECURITY_TOKEN | --salesforce-security-token=SALESFORCE_SECURITY_TOKEN)) | --sqlserver-database=SQLSERVER_DATABASE --sqlserver-hostname=SQLSERVER_HOSTNAME --sqlserver-port=SQLSERVER_PORT --sqlserver-username=SQLSERVER_USERNAME (--sqlserver-password=SQLSERVER_PASSWORD | --sqlserver-prompt-for-password | --sqlserver-secret-manager-stored-password=SQLSERVER_SECRET_MANAGER_STORED_PASSWORD)] + | --mongodb-secret-manager-stored-password=MONGODB_SECRET_MANAGER_STORED_PASSWORD) (--mongodb-srv-connection-format | --mongodb-standard-connection-format) : --mongodb-direct-connection --mongodb-replica-set=MONGODB_REPLICA_SET --mongodb-tls] | [--mysql-hostname=MYSQL_HOSTNAME --mysql-port=MYSQL_PORT --mysql-username=MYSQL_USERNAME (--mysql-password=MYSQL_PASSWORD | --mysql-prompt-for-password | --mysql-secret-manager-stored-password=MYSQL_SECRET_MANAGER_STORED_PASSWORD) : --ca-certificate=CA_CERTIFICATE --client-certificate=CLIENT_CERTIFICATE --client-key=CLIENT_KEY] | [--postgresql-database=POSTGRESQL_DATABASE --postgresql-hostname=POSTGRESQL_HOSTNAME --postgresql-port=POSTGRESQL_PORT --postgresql-username=POSTGRESQL_USERNAME (--postgresql-password=POSTGRESQL_PASSWORD | --postgresql-prompt-for-password | --postgresql-secret-manager-stored-password=POSTGRESQL_SECRET_MANAGER_STORED_PASSWORD) : [--postgresql-ca-certificate=POSTGRESQL_CA_CERTIFICATE : --postgresql-server-certificate-hostname=POSTGRESQL_SERVER_CERTIFICATE_HOSTNAME --postgresql-client-certificate=POSTGRESQL_CLIENT_CERTIFICATE --postgresql-client-key=POSTGRESQL_CLIENT_KEY]] | --salesforce-domain=SALESFORCE_DOMAIN (--salesforce-oauth2-client-id=SALESFORCE_OAUTH2_CLIENT_ID (--salesforce-oauth2-client-secret=SALESFORCE_OAUTH2_CLIENT_SECRET | --salesforce-prompt-for-oauth2-client-secret | --salesforce-secret-manager-stored-oauth2-client-secret=SALESFORCE_SECRET_MANAGER_STORED_OAUTH2_CLIENT_SECRET) | --salesforce-username=SALESFORCE_USERNAME (--salesforce-password=SALESFORCE_PASSWORD | --salesforce-prompt-for-password | --salesforce-secret-manager-stored-password=SALESFORCE_SECRET_MANAGER_STORED_PASSWORD) (--salesforce-prompt-for-security-token | --salesforce-secret-manager-stored-security-token=SALESFORCE_SECRET_MANAGER_STORED_SECURITY_TOKEN | --salesforce-security-token=SALESFORCE_SECURITY_TOKEN)) | --sqlserver-database=SQLSERVER_DATABASE --sqlserver-hostname=SQLSERVER_HOSTNAME --sqlserver-port=SQLSERVER_PORT --sqlserver-username=SQLSERVER_USERNAME (--sqlserver-password=SQLSERVER_PASSWORD | --sqlserver-prompt-for-password | --sqlserver-secret-manager-stored-password=SQLSERVER_SECRET_MANAGER_STORED_PASSWORD)] [--private-connection=PRIVATE_CONNECTION | --static-ip-connectivity | [--forward-ssh-hostname=FORWARD_SSH_HOSTNAME --forward-ssh-username=FORWARD_SSH_USERNAME @@ -206,6 +206,15 @@ OPTIONAL FLAGS Path to secret manager, storing the password for the user used to connect to the database. + --oracle-ca-certificate=ORACLE_CA_CERTIFICATE + PEM-encoded certificate of the CA that signed the source database + server's certificate. + + --oracle-server-certificate-distinguished-name=ORACLE_SERVER_CERTIFICATE_DISTINGUISHED_NAME + The distinguished name (DN) mentioned in the server certificate. This + corresponds to the SSL_SERVER_CERT_DN sqlnet parameter. If this field + is not provided, the DN matching is not enforced. + --mongodb-host-addresses=IPv4_ADDRESS_OR_HOSTNAME:PORT,[...] IP or hostname and port of the MongoDB source database. @@ -350,6 +359,11 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. + --postgresql-server-certificate-hostname=POSTGRESQL_SERVER_CERTIFICATE_HOSTNAME + The hostname mentioned in the Subject or SAN extension of the server + certificate. If this field is not provided, the hostname in the + server certificate is not validated. + --postgresql-client-certificate=POSTGRESQL_CLIENT_CERTIFICATE x509 PEM-encoded certificate that will be used by the replica to authenticate against the source database server. diff --git a/gcloud/datastream/connection-profiles/update b/gcloud/datastream/connection-profiles/update index a61d9a9e8..697893a96 100644 --- a/gcloud/datastream/connection-profiles/update +++ b/gcloud/datastream/connection-profiles/update @@ -10,13 +10,13 @@ SYNOPSIS [--bucket=BUCKET --root-path=ROOT_PATH | --database-service=DATABASE_SERVICE --oracle-hostname=ORACLE_HOSTNAME --oracle-port=ORACLE_PORT - --oracle-username=ORACLE_USERNAME --oracle-password=ORACLE_PASSWORD - | --oracle-prompt-for-password - | --oracle-secret-manager-stored-password=ORACLE_SECRET_MANAGER_STORED_PASSWORD | --mongodb-direct-connection --mongodb-host-addresses=IPv4_ADDRESS_OR_HOSTNAME:PORT, + --oracle-username=ORACLE_USERNAME + --oracle-ca-certificate=ORACLE_CA_CERTIFICATE + --oracle-server-certificate-distinguished-name=ORACLE_SERVER_CERTIFICATE_DISTINGUISHED_NAME --oracle-password=ORACLE_PASSWORD | --oracle-prompt-for-password | --oracle-secret-manager-stored-password=ORACLE_SECRET_MANAGER_STORED_PASSWORD | --mongodb-direct-connection --mongodb-host-addresses=IPv4_ADDRESS_OR_HOSTNAME:PORT, [...] --mongodb-replica-set=MONGODB_REPLICA_SET --mongodb-tls --mongodb-username=MONGODB_USERNAME --mongodb-password=MONGODB_PASSWORD | --mongodb-prompt-for-password - | --mongodb-secret-manager-stored-password=MONGODB_SECRET_MANAGER_STORED_PASSWORD --mongodb-srv-connection-format | --mongodb-standard-connection-format | --mysql-hostname=MYSQL_HOSTNAME --mysql-port=MYSQL_PORT --mysql-username=MYSQL_USERNAME --ca-certificate=CA_CERTIFICATE --client-certificate=CLIENT_CERTIFICATE --client-key=CLIENT_KEY --mysql-password=MYSQL_PASSWORD | --mysql-prompt-for-password | --mysql-secret-manager-stored-password=MYSQL_SECRET_MANAGER_STORED_PASSWORD | --postgresql-database=POSTGRESQL_DATABASE --postgresql-hostname=POSTGRESQL_HOSTNAME --postgresql-port=POSTGRESQL_PORT --postgresql-username=POSTGRESQL_USERNAME --postgresql-ca-certificate=POSTGRESQL_CA_CERTIFICATE --postgresql-client-certificate=POSTGRESQL_CLIENT_CERTIFICATE --postgresql-client-key=POSTGRESQL_CLIENT_KEY --postgresql-password=POSTGRESQL_PASSWORD | --postgresql-prompt-for-password | --postgresql-secret-manager-stored-password=POSTGRESQL_SECRET_MANAGER_STORED_PASSWORD | --salesforce-domain=SALESFORCE_DOMAIN --salesforce-oauth2-client-id=SALESFORCE_OAUTH2_CLIENT_ID --salesforce-oauth2-client-secret=SALESFORCE_OAUTH2_CLIENT_SECRET | --salesforce-prompt-for-oauth2-client-secret | --salesforce-secret-manager-stored-oauth2-client-secret=SALESFORCE_SECRET_MANAGER_STORED_OAUTH2_CLIENT_SECRET | --salesforce-username=SALESFORCE_USERNAME --salesforce-password=SALESFORCE_PASSWORD | --salesforce-prompt-for-password | --salesforce-secret-manager-stored-password=SALESFORCE_SECRET_MANAGER_STORED_PASSWORD --salesforce-prompt-for-security-token | --salesforce-secret-manager-stored-security-token=SALESFORCE_SECRET_MANAGER_STORED_SECURITY_TOKEN | --salesforce-security-token=SALESFORCE_SECURITY_TOKEN | --sqlserver-database=SQLSERVER_DATABASE --sqlserver-hostname=SQLSERVER_HOSTNAME --sqlserver-port=SQLSERVER_PORT --sqlserver-username=SQLSERVER_USERNAME --sqlserver-password=SQLSERVER_PASSWORD | --sqlserver-prompt-for-password | --sqlserver-secret-manager-stored-password=SQLSERVER_SECRET_MANAGER_STORED_PASSWORD] + | --mongodb-secret-manager-stored-password=MONGODB_SECRET_MANAGER_STORED_PASSWORD --mongodb-srv-connection-format | --mongodb-standard-connection-format | --mysql-hostname=MYSQL_HOSTNAME --mysql-port=MYSQL_PORT --mysql-username=MYSQL_USERNAME --ca-certificate=CA_CERTIFICATE --client-certificate=CLIENT_CERTIFICATE --client-key=CLIENT_KEY --mysql-password=MYSQL_PASSWORD | --mysql-prompt-for-password | --mysql-secret-manager-stored-password=MYSQL_SECRET_MANAGER_STORED_PASSWORD | --postgresql-database=POSTGRESQL_DATABASE --postgresql-hostname=POSTGRESQL_HOSTNAME --postgresql-port=POSTGRESQL_PORT --postgresql-username=POSTGRESQL_USERNAME --postgresql-ca-certificate=POSTGRESQL_CA_CERTIFICATE --postgresql-server-certificate-hostname=POSTGRESQL_SERVER_CERTIFICATE_HOSTNAME --postgresql-client-certificate=POSTGRESQL_CLIENT_CERTIFICATE --postgresql-client-key=POSTGRESQL_CLIENT_KEY --postgresql-password=POSTGRESQL_PASSWORD | --postgresql-prompt-for-password | --postgresql-secret-manager-stored-password=POSTGRESQL_SECRET_MANAGER_STORED_PASSWORD | --salesforce-domain=SALESFORCE_DOMAIN --salesforce-oauth2-client-id=SALESFORCE_OAUTH2_CLIENT_ID --salesforce-oauth2-client-secret=SALESFORCE_OAUTH2_CLIENT_SECRET | --salesforce-prompt-for-oauth2-client-secret | --salesforce-secret-manager-stored-oauth2-client-secret=SALESFORCE_SECRET_MANAGER_STORED_OAUTH2_CLIENT_SECRET | --salesforce-username=SALESFORCE_USERNAME --salesforce-password=SALESFORCE_PASSWORD | --salesforce-prompt-for-password | --salesforce-secret-manager-stored-password=SALESFORCE_SECRET_MANAGER_STORED_PASSWORD --salesforce-prompt-for-security-token | --salesforce-secret-manager-stored-security-token=SALESFORCE_SECRET_MANAGER_STORED_SECURITY_TOKEN | --salesforce-security-token=SALESFORCE_SECURITY_TOKEN | --sqlserver-database=SQLSERVER_DATABASE --sqlserver-hostname=SQLSERVER_HOSTNAME --sqlserver-port=SQLSERVER_PORT --sqlserver-username=SQLSERVER_USERNAME --sqlserver-password=SQLSERVER_PASSWORD | --sqlserver-prompt-for-password | --sqlserver-secret-manager-stored-password=SQLSERVER_SECRET_MANAGER_STORED_PASSWORD] [--clear-labels | --remove-labels=[KEY,...]] [--private-connection=PRIVATE_CONNECTION | --static-ip-connectivity | --forward-ssh-hostname=FORWARD_SSH_HOSTNAME @@ -169,6 +169,15 @@ OPTIONAL FLAGS --oracle-username=ORACLE_USERNAME Username Datastream will use to connect to the database. + --oracle-ca-certificate=ORACLE_CA_CERTIFICATE + PEM-encoded certificate of the CA that signed the source database + server's certificate. + + --oracle-server-certificate-distinguished-name=ORACLE_SERVER_CERTIFICATE_DISTINGUISHED_NAME + The distinguished name (DN) mentioned in the server certificate. This + corresponds to the SSL_SERVER_CERT_DN sqlnet parameter. If this field + is not provided, the DN matching is not enforced. + At most one of these can be specified: --oracle-password=ORACLE_PASSWORD @@ -274,6 +283,11 @@ OPTIONAL FLAGS database server's certificate. The replica will use this certificate to verify it's connecting to the right host. + --postgresql-server-certificate-hostname=POSTGRESQL_SERVER_CERTIFICATE_HOSTNAME + The hostname mentioned in the Subject or SAN extension of the server + certificate. If this field is not provided, the hostname in the + server certificate is not validated. + --postgresql-client-certificate=POSTGRESQL_CLIENT_CERTIFICATE x509 PEM-encoded certificate that will be used by the replica to authenticate against the source database server. diff --git a/gcloud/firebase/test/android/run b/gcloud/firebase/test/android/run index 74db6cd83..b301b8b5d 100644 --- a/gcloud/firebase/test/android/run +++ b/gcloud/firebase/test/android/run @@ -118,11 +118,13 @@ EXAMPLES Controlling Results Storage By default, Firebase Test Lab stores detailed test results for a limited - time in a Google Cloud Storage bucket provided for you at no charge. If you - wish to use a storage bucket that you control, or if you need to retain - detailed test results for a longer period, use the --results-bucket option. - See https://firebase.google.com/docs/test-lab/analyzing-results#detailed - for more information. + time in a Google Cloud Storage bucket provided for you at no charge. Note: + This requires the principal executing the test to have "roles/editor" role + for the project. If either you do not have that role, you wish to use a + storage bucket that you control, or you need to retain detailed test + results for a longer period, use the --results-bucket option. See + https://firebase.google.com/docs/test-lab/analyzing-results#detailed for + more information. Detailed test result files are prefixed by default with a timestamp and a random character string. If you require a predictable path where detailed diff --git a/gcloud/iap/settings/set b/gcloud/iap/settings/set index e14dec610..cddef128b 100644 --- a/gcloud/iap/settings/set +++ b/gcloud/iap/settings/set @@ -83,49 +83,54 @@ POSITIONAL ARGUMENTS SETTING_FILE JSON or YAML file containing the IAP resource settings. - JSON example: - { - "access_settings" : { - "oauth_settings" : { - "login_hint" : { - "value": "test_hint" - } - }, - "gcip_settings" : { - "tenant_ids": ["tenant1-p9puj", "tenant2-y8rxc"], - "login_page_uri" : { - "value" : "https://test.com/?apiKey=abcd_efgh" - } - }, - "cors_settings": { - "allow_http_options" : { - "value": true - } - } - }, - "application_settings" : { - "csm_settings" : { - "rctoken_aud" : { - "value" : "test_aud" - } - } - } - } + JSON example: + + { + "access_settings": { + "oauth_settings": { + "login_hint": { + "value": "test_hint" + } + }, + "gcip_settings": { + "tenant_ids": [ + "tenant1-p9puj", + "tenant2-y8rxc" + ], + "login_page_uri": { + "value": "https://test.com/?apiKey=abcd_efgh" + } + }, + "cors_settings": { + "allow_http_options": { + "value": true + } + } + }, + "application_settings": { + "csm_settings": { + "rctoken_aud": { + "value": "test_aud" + } + } + } + } + + YAML example: - YAML example: accessSettings : - oauthSettings: - loginHint: test_hint - gcipSettings: - tenantIds: - - tenant1-p9puj - - tenant2-y8rxc - loginPageUri: https://test.com/?apiKey=abcd_efgh - corsSettings: - allowHttpOptions: true + oauthSettings: + loginHint: test_hint + gcipSettings: + tenantIds: + - tenant1-p9puj + - tenant2-y8rxc + loginPageUri: https://test.com/?apiKey=abcd_efgh + corsSettings: + allowHttpOptions: true applicationSettings: - csmSettings: - rctokenAud: test_aud + csmSettings: + rctokenAud: test_aud FLAGS --folder=FOLDER diff --git a/gcloud/lustre/instances/create b/gcloud/lustre/instances/create index 25e2182fd..87109194e 100644 --- a/gcloud/lustre/instances/create +++ b/gcloud/lustre/instances/create @@ -96,7 +96,8 @@ OPTIONAL FLAGS --gke-support-enabled Indicates whether you want to enable support for GKE clients. By - default, GKE clients are not supported. + default, GKE clients are not supported. Deprecated. No longer required + for GKE instance creation. --labels=[LABELS,...] Labels as key value pairs. diff --git a/gcloud/lustre/instances/update b/gcloud/lustre/instances/update index 5496d2fb5..97c5457e4 100644 --- a/gcloud/lustre/instances/update +++ b/gcloud/lustre/instances/update @@ -67,8 +67,9 @@ FLAGS --[no-]gke-support-enabled Indicates whether you want to enable support for GKE clients. By - default, GKE clients are not supported. Use --gke-support-enabled to - enable and --no-gke-support-enabled to disable. + default, GKE clients are not supported. Deprecated. No longer required + for GKE instance creation. Use --gke-support-enabled to enable and + --no-gke-support-enabled to disable. --per-unit-storage-throughput=PER_UNIT_STORAGE_THROUGHPUT The throughput of the instance in MB/s/TiB. Valid values are 125, 250, diff --git a/gcloud/migration/vms/image-imports/create b/gcloud/migration/vms/image-imports/create index 3d9e89a47..bcde4a501 100644 --- a/gcloud/migration/vms/image-imports/create +++ b/gcloud/migration/vms/image-imports/create @@ -11,9 +11,8 @@ SYNOPSIS [--labels=[KEY=VALUE,...]] [--single-region-storage] [--target-project=TARGET_PROJECT] [--skip-os-adaptation | --adaptation-modifiers=ADAPTATION_MODIFIERS - --boot-conversion=BOOT_CONVERSION --generalize - --license-type=LICENSE_TYPE - --rootfs-uuid=ROOTFS_UUID --suppress-package-installation-failure] + --boot-conversion=BOOT_CONVERSION + --generalize --license-type=LICENSE_TYPE --rootfs-uuid=ROOTFS_UUID] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -141,10 +140,6 @@ OPTIONAL FLAGS --rootfs-uuid=ROOTFS_UUID Identifies the file system to adapt. - --suppress-package-installation-failure - If true, suppress package installation failure and continue with a - warning. - 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/migration/vms/machine-image-imports/create b/gcloud/migration/vms/machine-image-imports/create index 73bc56f03..00bf39d6f 100644 --- a/gcloud/migration/vms/machine-image-imports/create +++ b/gcloud/migration/vms/machine-image-imports/create @@ -16,9 +16,8 @@ SYNOPSIS [--enable-integrity-monitoring --enable-vtpm --secure-boot=SECURE_BOOT] [--scopes=[SCOPES,...] --service-account=SERVICE_ACCOUNT] [--skip-os-adaptation | --adaptation-modifiers=ADAPTATION_MODIFIERS - --boot-conversion=BOOT_CONVERSION --generalize - --license-type=LICENSE_TYPE - --rootfs-uuid=ROOTFS_UUID --suppress-package-installation-failure] + --boot-conversion=BOOT_CONVERSION + --generalize --license-type=LICENSE_TYPE --rootfs-uuid=ROOTFS_UUID] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -188,10 +187,6 @@ OPTIONAL FLAGS --rootfs-uuid=ROOTFS_UUID Identifies the file system to adapt. - --suppress-package-installation-failure - If true, suppress package installation failure and continue with a - warning. - 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/netapp/volumes/create b/gcloud/netapp/volumes/create index 74d07af24..9ebd7bd07 100644 --- a/gcloud/netapp/volumes/create +++ b/gcloud/netapp/volumes/create @@ -31,7 +31,7 @@ SYNOPSIS [--snap-reserve=SNAP_RESERVE] [--snapshot-daily=[hour=HOUR], [minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] - [--snapshot-directory=SNAPSHOT_DIRECTORY] + [--snapshot-directory=SNAPSHOT_DIRECTORY; default="true"] [--snapshot-hourly=[minute=MINUTE], [snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--snapshot-monthly=[day=DAY], @@ -246,7 +246,7 @@ OPTIONAL FLAGS --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 - --snapshot-directory=SNAPSHOT_DIRECTORY + --snapshot-directory=SNAPSHOT_DIRECTORY; default="true" Snapshot Directory if enabled (true) makes the Volume contain a read-only .snapshot directory which provides access to each of the volume's snapshots diff --git a/gcloud/netapp/volumes/update b/gcloud/netapp/volumes/update index cd15003d2..1a4891c8c 100644 --- a/gcloud/netapp/volumes/update +++ b/gcloud/netapp/volumes/update @@ -24,7 +24,7 @@ SYNOPSIS [--snap-reserve=SNAP_RESERVE] [--snapshot-daily=[hour=HOUR], [minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP]] - [--snapshot-directory=SNAPSHOT_DIRECTORY] + [--snapshot-directory=SNAPSHOT_DIRECTORY; default="true"] [--snapshot-hourly=[minute=MINUTE], [snapshots-to-keep=SNAPSHOTS-TO-KEEP]] [--snapshot-monthly=[day=DAY], @@ -158,7 +158,7 @@ FLAGS --snapshot-daily=[hour=HOUR],[minute=MINUTE],[snapshots-to-keep=SNAPSHOTS-TO-KEEP] Make a snapshot every day e.g. at 06:00, 05:20, 23:50 - --snapshot-directory=SNAPSHOT_DIRECTORY + --snapshot-directory=SNAPSHOT_DIRECTORY; default="true" Snapshot Directory if enabled (true) makes the Volume contain a read-only .snapshot directory which provides access to each of the volume's snapshots diff --git a/gcloud/pubsub/subscriptions/create b/gcloud/pubsub/subscriptions/create index f7ff2c81a..c39209f2a 100644 --- a/gcloud/pubsub/subscriptions/create +++ b/gcloud/pubsub/subscriptions/create @@ -298,7 +298,7 @@ OPTIONAL FLAGS --max-retry-delay=MAX_RETRY_DELAY The maximum delay between consecutive deliveries of a given message. - Value should be between 0 and 600 seconds. Defaults to 10 seconds. + Value should be between 0 and 600 seconds. Defaults to 600 seconds. Valid values are strings of the form INTEGER[UNIT], where UNIT is one of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. diff --git a/gcloud/pubsub/subscriptions/update b/gcloud/pubsub/subscriptions/update index 545cd9a29..df0a79011 100644 --- a/gcloud/pubsub/subscriptions/update +++ b/gcloud/pubsub/subscriptions/update @@ -333,7 +333,7 @@ FLAGS --max-retry-delay=MAX_RETRY_DELAY The maximum delay between consecutive deliveries of a given - message. Value should be between 0 and 600 seconds. Defaults to 10 + message. Value should be between 0 and 600 seconds. Defaults to 600 seconds. Valid values are strings of the form INTEGER[UNIT], where UNIT is one of "s", "m", "h", and "d" for seconds, minutes, hours, and days, respectively. If the unit is omitted, seconds is assumed. diff --git a/gcloud/run/jobs/create b/gcloud/run/jobs/create index d89e10f8a..83364a304 100644 --- a/gcloud/run/jobs/create +++ b/gcloud/run/jobs/create @@ -15,7 +15,8 @@ SYNOPSIS [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] --cpu=CPU --depends-on=[CONTAINER,...] --image=IMAGE --memory=MEMORY - --remove-volume-mount=[MOUNT_PATH,...] --clear-env-vars + --remove-volume-mount=[MOUNT_PATH,...] + --startup-probe=[KEY=VALUE,...] --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets @@ -229,6 +230,23 @@ FLAGS Removes the volume mounted at the specified path from the current container. + --startup-probe=[KEY=VALUE,...] + Comma separated settings for startup probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: initialDelaySeconds, timeoutSeconds, + periodSeconds, failureThreshold, httpGet.port, httpGet.path, + grpc.port, grpc.service, tcpSocket.port. + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --startup-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --startup-probe="" + At most one of these can be specified: --clear-env-vars diff --git a/gcloud/run/jobs/deploy b/gcloud/run/jobs/deploy index 29f791ffa..ed7082ae1 100644 --- a/gcloud/run/jobs/deploy +++ b/gcloud/run/jobs/deploy @@ -16,7 +16,8 @@ SYNOPSIS [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] --cpu=CPU --depends-on=[CONTAINER,...] --memory=MEMORY - --remove-volume-mount=[MOUNT_PATH,...] --clear-env-vars + --remove-volume-mount=[MOUNT_PATH,...] + --startup-probe=[KEY=VALUE,...] --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets @@ -231,6 +232,23 @@ FLAGS Removes the volume mounted at the specified path from the current container. + --startup-probe=[KEY=VALUE,...] + Comma separated settings for startup probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: initialDelaySeconds, timeoutSeconds, + periodSeconds, failureThreshold, httpGet.port, httpGet.path, + grpc.port, grpc.service, tcpSocket.port. + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --startup-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --startup-probe="" + At most one of these can be specified: --clear-env-vars diff --git a/gcloud/run/jobs/update b/gcloud/run/jobs/update index 089acc616..5da7001ca 100644 --- a/gcloud/run/jobs/update +++ b/gcloud/run/jobs/update @@ -18,7 +18,8 @@ SYNOPSIS [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] --cpu=CPU --depends-on=[CONTAINER,...] --image=IMAGE --memory=MEMORY - --remove-volume-mount=[MOUNT_PATH,...] --clear-env-vars + --remove-volume-mount=[MOUNT_PATH,...] + --startup-probe=[KEY=VALUE,...] --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets @@ -246,6 +247,23 @@ FLAGS Removes the volume mounted at the specified path from the current container. + --startup-probe=[KEY=VALUE,...] + Comma separated settings for startup probe in the form KEY=VALUE. + Each key stands for a field of the probe described in + https://cloud.google.com/run/docs/reference/rest/v1/Container#Probe. + Currently supported keys are: initialDelaySeconds, timeoutSeconds, + periodSeconds, failureThreshold, httpGet.port, httpGet.path, + grpc.port, grpc.service, tcpSocket.port. + + For example, to set a probe with 10s timeout and HTTP probe + requests sent to 8080 port of the container: + + $ --startup-probe=timeoutSeconds=10,httpGet.port=8080 + + To remove existing probe: + + $ --startup-probe="" + At most one of these can be specified: --clear-env-vars diff --git a/gcloud/sql/backups/restore b/gcloud/sql/backups/restore index 9917831bb..979bb793f 100644 --- a/gcloud/sql/backups/restore +++ b/gcloud/sql/backups/restore @@ -47,10 +47,11 @@ SYNOPSIS | --secondary-zone=SECONDARY_ZONE --zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - The command lets you restore to an existing instance using ID. When backup - Name is used for restore it lets you restore to an existing instance or a - new instance. When restoring to new instance, optional flags can be used to - customize the new instance. + The command lets you restore to an existing instance using ID. To restore + using a backupDR backup, use the backupDR ID. When backup Name is used to + restore it lets you restore to an existing instance or a new instance. When + restoring to new instance, optional flags can be used to customize the new + instance. POSITIONAL ARGUMENTS ID diff --git a/gcloud/sql/instances/delete b/gcloud/sql/instances/delete index 624d13009..9ee313e03 100644 --- a/gcloud/sql/instances/delete +++ b/gcloud/sql/instances/delete @@ -30,11 +30,13 @@ FLAGS --final-backup-expiry-time=FINAL_BACKUP_EXPIRY_TIME Specifies the time at which the final backup will expire. Maximum - time allowed is 365 days from now. Format: YYYY-MM-DDTHH:MM:SS. + time allowed is 365 days. For instances managed by BackupDR, the + maximum time allowed is 99 years. Format: YYYY-MM-DDTHH:MM:SS. --final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS Specifies number of days to retain final backup. The valid range is - between 1 and 365. Default value is 30 days. + between 1 and 365. For instances managed by BackupDR, the valid range + is between 1 day and 99 years. Default value is 30 days. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/storage/buckets/create b/gcloud/storage/buckets/create index a1fd02144..58fc12398 100644 --- a/gcloud/storage/buckets/create +++ b/gcloud/storage/buckets/create @@ -9,7 +9,8 @@ SYNOPSIS [--default-storage-class=DEFAULT_STORAGE_CLASS, -c DEFAULT_STORAGE_CLASS, -s DEFAULT_STORAGE_CLASS] [--enable-hierarchical-namespace] [--enable-per-object-retention] - [--lifecycle-file=LIFECYCLE_FILE] [--location=LOCATION, -l LOCATION] + [--ip-filter-file=IP_FILTER_FILE] [--lifecycle-file=LIFECYCLE_FILE] + [--location=LOCATION, -l LOCATION] [--[no-]pap, --[no-]public-access-prevention] [--placement=[REGION,...]] [--recovery-point-objective=SETTING, --rpo=SETTING] @@ -65,6 +66,27 @@ FLAGS Enables each object in the bucket to have its own retention settings, which prevents deletion until stored for a specific length of time. + --ip-filter-file=IP_FILTER_FILE + Sets the IP filter for the bucket. The IP filter is a list of ip ranges + that are allowed to access the bucket. For example, The following JSON + document shows the IP filter configuration with mode enabled and list + of public network sources and vpc network sources: + + { + "mode": "Enabled", + "publicNetworkSource": { "allowedIpCidrRanges": ["0.0.0.0/0"] }, + "vpcNetworkSources": [ + { + "network": "projects/PROJECT_NAME/global/networks/NETWORK_NAME", + "allowedIpCidrRanges": ["0.0.0.0/0"] + }, + ] + } + + For more information about supported configurations, see Cloud Storage + bucket IP filtering configurations + (https://cloud.google.com/storage/docs/create-ip-filter#ip-filtering-configurations) + --lifecycle-file=LIFECYCLE_FILE Sets the lifecycle management configuration on a bucket. For example, The following lifecycle management configuration JSON document diff --git a/gcloud/storage/buckets/update b/gcloud/storage/buckets/update index fd888d78e..fadc31724 100644 --- a/gcloud/storage/buckets/update +++ b/gcloud/storage/buckets/update @@ -20,6 +20,7 @@ SYNOPSIS [--clear-cors | --cors-file=CORS_FILE] [--clear-default-encryption-key | --default-encryption-key=DEFAULT_ENCRYPTION_KEY] + [--clear-ip-filter | --ip-filter-file=IP_FILTER_FILE] [--clear-labels | --labels-file=LABELS_FILE | --remove-labels=[LABEL_KEYS,...] --update-labels=[LABEL_KEYS_AND_VALUES,...]] @@ -195,6 +196,32 @@ FLAGS --default-encryption-key=DEFAULT_ENCRYPTION_KEY Set the default KMS key for the bucket. + At most one of these can be specified: + + --clear-ip-filter + Disables and clears IP filter configuration of the bucket. + + --ip-filter-file=IP_FILTER_FILE + Sets the IP filter for the bucket. The IP filter is a list of ip + ranges that are allowed to access the bucket. For example, The + following JSON document shows the IP filter configuration with mode + enabled and list of public network sources and vpc network sources: + + { + "mode": "Enabled", + "publicNetworkSource": { "allowedIpCidrRanges": ["0.0.0.0/0"] }, + "vpcNetworkSources": [ + { + "network": "projects/PROJECT_NAME/global/networks/NETWORK_NAME", + "allowedIpCidrRanges": ["0.0.0.0/0"] + }, + ] + } + + For more information about supported configurations, see Cloud + Storage bucket IP filtering configurations + (https://cloud.google.com/storage/docs/create-ip-filter#ip-filtering-configurations) + At most one of these can be specified: --clear-labels