Google Cloud SDK - Release Notes

Copyright 2014-2021 Google Inc. All rights reserved.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

362.0.0 (2021-10-26)

Breaking Changes

  • (Cloud SQL) Backups are disabled by default when creating new database instances. This was enabled by default in the previous release.
  • (Cloud SQL) Backup start time will not be randomly selected. This was enabled in the previous release. Use --backup-start-time to specify the start time for backups.

Cloud Build

  • gcloud builds submit --tag fails early if a Dockerfile is not found when source is not a directory.

Cloud DNS

  • Added support for the SVCB and HTTPS record types.

Cloud Dataflow

  • Added --gcs-log-dir flag to gcloud dataflow flex-template build command to allow users the ability to specify path to a Google Cloud Storage directory for their build log.

Cloud On Demand Scanning

  • Add ARM64 support for local-extract.

Cloud Run

  • Promoted --execution-environment of gcloud run from alpha to beta.

Compute Engine

  • Promoted --add-share-with and --remove-share-with flags of glcloud compute reservations update to GA.

Managed Active Directory

  • Adding support for gcloud beta active-directory domains backups and gcloud beta active-directory domains restore for domain backup and restore.

Miscellaneous

  • Fixed an issue where non-interactive commands could exit with the error 'ValueError: invalid width 0'.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

361.0.0 (2021-10-19)

Breaking Changes

  • (Cloud SQL) Enable backups by default when creating new database instances. Use --no-backup to disable backups.
  • (Cloud SQL) Backup start time will be randomly select if not specified. Use --backup-start-time to specify the start time for backups.

Cloud SDK

  • gcloud command-line tool supports authentication using an access token from a file which can be specified in the global flag --access-token-file or the property auth/access_token_file.

AI

  • Added --analysis-instance-schema flag in gcloud beta ai model-monitoring-jobs update.
  • Renamed --work-dir flag of gcloud beta ai custom-jobs local-run as --local-package-path. Deprecated --work-dir flag.
  • Renamed --base-image flag of gcloud beta ai custom-jobs local-run as --executor-image-uri. Deprecated --base-image flag.

Artifact Registry

  • Added --show-provenance flag in gcloud artifacts docker images describe command to show build provenance.
  • Removed the auth token placeholder from the output of gcloud artifacts print-settings npm.
  • Fixed issue where gcloud artifacts tags list errors when the package name has slashes.

Cloud Code

  • Support specifying a service yaml file in gcloud beta code dev.
  • Support building with a Buildpack instead of a Dockerfile in gcloud beta code dev.

Cloud Domains

  • Promoted gcloud domains registrations to GA. Cloud Domains enables registering new domain names, transferring already registered domains from 3rd-party domains registrars and managing the domains.

Cloud Healthcare

  • Promoted gcloud healthcare hl7v2-stores <import|export> command groups to GA.

Cloud Key Management Service

  • Added support for the following RSA OAEP+SHA1 algorithms to gcloud kms keys create|update and gcloud kms keys versions import:
    • rsa-decrypt-oaep-2048-sha1
    • rsa-decrypt-oaep-3072-sha1
    • rsa-decrypt-oaep-4096-sha1

Cloud SQL

  • Added the following flags to gcloud sql instances create and gcloud sql instances patch for GA:
    • --password-policy-min-length
    • --password-policy-complexity
    • --password-policy-reuse-interval
    • --password-policy-disallow-username-substring
    • --password-policy-password-change-interval
    • --clear-password-policy

Cloud Scheduler

  • Updated gcloud scheduler jobs commands to accept a location flag to manually specify a Cloud region.

Cloud Storage

  • Updated gsutil component to 5.4.

Cloud Tasks

  • Added --location flag for gcloud tasks and gcloud tasks queues in beta & GA to enable users to specify a GCP location when managing queues and tasks.

Compute Engine

  • Promoted --network flag of gcloud compute target-instances create to GA.
  • Promoted --subsetting-policy of gcloud compute backend-services create and gcloud compute backend-services update to GA.
  • Added --description flag to compute service-attachments update.
  • Add --add-share-with and --remove-share-with flags to reservations update to make it easier to add and remove items in the share-with list without having to specify existing items.
  • Promoted --type flag of gcloud compute commitments create to GA.
  • Promoted --share-setting and --share-with flags of glcloud compute reservations create to GA.
  • Promoted compute routers nats rules command group to beta.
  • Promoted --rules flag of compute routers nats create and compute routers nats update to beta.
  • Promoted --tcp-time-wait-timeout flag of compute routers nats create and compute routers nats update to beta.
  • Promoted --clear-tcp-time-wait-timeout flag of compute routers nats update to beta.

Compute OS Config

  • Allow instance name in gcloud compute os-config vulnerability-reports describe and gcloud compute os-config inventories describe.
  • Promoted gcloud compute os-config os-policy-assignments to GA.

Config Connector

Config Controller

  • Promoted gcloud anthos config controller to GA.

Container Registry

  • Added support for pulling results with image names that use tags instead of sha256.
  • Added warning in a case where a user pulls results with tags instead of sha256.

Kpt

  • Updated kpt from v1.0.0-beta.5 to v1.0.0-beta.6.
    • Fixed yaml schema and added json schema for Kptfile.
    • Added support for .krmignore files in subpackages in kpt fn commands.
    • Added support for updating subpackages in kpt pkg update.
    • Added support to show pipeline execution duration in kpt fn render.
    • Fixed issue when parsing bare sequence nodes in yaml.
    • kpt fn render executes pipeline even when there are no input resources.
    • kpt pkg get no longer copies the entire repo if path is specified.

Pubsub Emulator

  • Added support for topic retention.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

360.0.0 (2021-10-05)

Artifact Registry

  • Updated gcloud beta artifacts print-settings mvn|gradle to add release and snapshot details for maven and gradle surfaces.
  • Promoted gcloud artifacts create repository to GA.
  • Updated gcloud artifacts print-settings mvn|gradle with release and snapshot policies for maven and gradle to GA.

Bare Metal Solution

  • Fixed issue where gcloud bms instances list would not show permissions errors properly.

Cloud Composer

  • Added --enable-privately-used-public-ips flag to gcloud beta composer environments command to enable using privately used public IP address ranges feature in the GKE cluster.
  • Added --enable-ip-masq-agent flag to gcloud beta composer environments command to enable IP address masquerading in the GKE cluster.
  • Added --scheduler-count flag to gcloud composer environments create and gcloud composer environments update commands.

Cloud Data Fusion

  • Added --enable_rbac optional argument to
    gcloud beta data-fusion instances update to toggle granular
    role-based access control in enterprise instances with version >= 6.5.0.

Cloud SQL

  • Added support for users to select minor versions for MySQL 8.0 instances, when they are available in the API.

Cloud Storage

  • Updated gsutil component to 5.3.

Compute Engine

  • Added debian-11 and rocky-8 options to --os flag for:
    • gcloud compute images import in GA,
    • gcloud compute instances import in GA
    • gcloud compute machine-images import in beta
  • Added --service-directory-registration flag to compute forwarding-rules create NAME --target-service-attachment to support Service Directory integration with PSC ILB.
  • Promoted --redundant-interface, --subnetwork and --subnetwork-region flags of gcloud compute routers add-interface to GA.
  • Promoted --instance and --instance-zone flags of gcloud compute routers add-bgp-peer to GA.
  • Promoted --interface-names of gcloud compute routers remove-interface to GA.
  • Promoted --peer-names of gcloud compute routers remove-bgp-peer to GA.
  • Promoted --provisioning-model and --instance-termination-action flags for gcloud beta compute <instances|instances bulk|instance-templates> create commands.

Dataproc Metastore

  • Promoted --encryption-kms-key flag of gcloud metastore services create to GA.

Kubernetes Engine

  • Added --database-encryption-key flag to gcloud container clusters create-auto to allow enabling Database Encryption on Autopilot clusters at creation time.
  • Added --boot-disk-kms-key flag to gcloud container clusters create-auto to allow enabling CMEK protected boot disk on Autopilot clusters at creation time.
  • Added --spot flag to gcloud beta container clusters/node-pools create to allow creating spot VM for node pools.

Managed Active Directory

  • Adding gcloud active-directory peerings for Multi Project Support v1 release. Currently supporting up to 10 domain peerings per domain.

Network Connectivity

  • Promoted gcloud network-connectivity hubs command group to GA.
  • Promoted gcloud network-connectivity spokes command group to GA. Added gcloud network-connectivity spokes linked-vpn-tunnels, gcloud network-connectivity spokes linked-interconnect-attachments, and gcloud network-connectivity spokes linked-router-appliances command groups. Moved create and update commands to these command groups.

Network Security

  • Promoted gcloud network-security client-tls-policies to GA.
  • Promoted gcloud network-security authorization-policies to GA.

Network Services

  • Promoted gcloud network-services endpoint-policies to GA.

Secret Manager

  • Added support in gcloud secrets command group for specifying projects by project number, rather than project id.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

359.0.0 (2021-09-28)

Breaking Changes

  • (AI) Removed 'python-image-uri' field from --work-pool-spec flag of gcloud beta ai custom-jobs create. Use 'executor-image-uri' field instead.

Cloud SDK

  • Use pyca/cryptography to decode p12 service account keys if available. Otherwise, fall back to using PyOpenSSL.

AI

  • Fixed issue where gcloud ai custom-jobs list and gcloud ai hp-tuning-jobs list didn't show results with --uri flag.
  • Promoted gcloud ai endpoints raw-predict to beta and GA.

Artifact Registry

  • Fixed typos for gcloud beta artifacts repositories create help text.

Bare Metal Solution

  • Promoted gcloud bms instances list and gcloud bms instances describe to GA.

Cloud Bigtable

  • Added --restrict-to flags to gcloud bigtable app-profiles create and gcloud bigtable app-profiles update, which restricts multi-cluster routing to a specified list of cluster ids.

Cloud Data Fusion

  • Added --enable_rbac optional argument to
    gcloud beta data-fusion instances create to enable granular
    role-based access control in enterprise instances with version >= 6.5.0.

Cloud Dataflow

  • Corrected --snapshot-ttl lower/upper bound of gcloud dataflow snapshots create command.

Cloud Pub/Sub

  • Added --event-time flag to gcloud beta pubsub lite-topics publish to allow users to specify an event time when publishing a message.

Cloud Run

  • Promoted --key, --clear-key, --post-key-revocation-action-type and --clear-post-key-revocation-action-type flags of gcloud run deploy and gcloud run services update to GA for --platform=managed.
  • Deployments that change only the service metadata will no longer create new revisions. For example, gcloud run services my-service update --ingress=all.

Cloud Scheduler

  • Promoted gcloud scheduler locations command group to GA. Commands in this group provide information for locations where Cloud Scheduler is available.

Cloud Storage

  • Updated gsutil component to 5.2.

Compute Engine

  • Added --network-performance-configs flag to gcloud compute instance-templates create to both alpha and beta.
  • Modified --load-balancing-scheme flag of gcloud compute backend-services create and gcloud compute forwarding-rules create to accept choice 'EXTERNAL_MANAGED' in beta.
  • Modified --purpose flag of gcloud compute networks subnets create to accept choice REGIONAL_MANAGED_PROXY in beta.
  • Added new --share-setting=local to compute commitments create, compute future-reservations create, and compute reservations create.

Config Connector

Identity and Access Management

  • Added command gcloud iam workforce-pools create-cred-config to enable Workforce Pools configuration creation.

Kpt

  • Updated kpt from v1.0.0-beta.4 to v1.0.0-beta.5.
    • Added support for resolving top level pkg symlink.
    • Added support for preserving the ordering of fields with null values.
    • Improved the parsing logic for GitHub http package URL in kpt pkg get.

Kubernetes Engine

  • Hid --disable-autopilot flag from gcloud container clusters update.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

358.0.0 (2021-09-21)

Breaking Changes

  • (Compute Engine) Deprecated redirect-to-recaptcha choice of --action flag under gcloud compute security-policies rules.

AI

  • Added --enable-web-access flag to gcloud ai custom-jobs create and gcloud ai hp-tuning-jobs create to allow enabling interactive shell terminal access.

Apigee

  • Promoted gcloud apigee archives command group to beta.

Artifact Registry

  • Added --version-policy and --allow-snapshot-overwrites flags to gcloud beta artifacts repositories create to add version policy and snapshot overwrites to maven repositories.

Cloud Composer

  • Added gcloud composer environments run my-environment upgrade_check to run upgrade check to Airflow 2.0 for Composer environments with Airflow 1.10.15+.
  • Added support of CLI commands for Airflow 2.0 to gcloud composer environments run.

Cloud Dataproc

  • Fixed bug in gcloud dataproc clusters enable-personal-auth-session where the command would fail if the flag --access-boundary was provided.

Cloud Filestore

  • Added gcloud beta filestore instances snapshots command group, which is used to create and manage Filestore snapshots.
  • Added --force flag to gcloud beta filestore instances delete, which forces the deletion of an instance and its child resources, such as snapshots.
  • Added --kms-key flag to gcloud beta filestore instances create command to specify the customer-managed KMS key name to use for encrypting the filestore instance.

Cloud Run

  • Promoted --binary-authorization and --breakglass flags to GA. These commands may now be used with gcloud run deploy and gcloud run update.

Cloud SQL

  • Add --allocated-ip-range-name flag of gcloud sql instances patch in beta.

Cloud Storage

  • Updated gsutil component to 4.68.

Compute Engine

  • Added --clear-scale-down-control flag to gcloud alpha|beta compute instance-groups managed update-autoscaling.
  • Promoted --share-setting and --share-with of 'gcloud compute commitments create` to beta.
  • Promoted the following flags of gcloud compute routers add-bgp-peer and gcloud compute routers update-bgp-peer to GA:
    • --bfd-min-receive-interval
    • --bfd-min-transmit-interval
    • --bfd-multiplier
    • --bfd-session-initialization-mode
  • Promoted --enable-layer7-ddos-defense and --layer7-ddos-defense-rule-visibility of 'gcloud compute security-policies update` to GA.

Compute OS Config

  • Promoted gcloud compute os-config vulnerability-reports describe and gcloud compute os-config vulnerability-reports list to GA.
  • Promoted gcloud compute os-config inventories commands describe and list to GA.

Config Connector

Config Controller

  • The create command will automatically update the kubeconfig to point to the newly created config controller cluster.

Kubernetes Engine

  • Updates default kubectl from 1.18 to 1.20.
  • Additional kubectl versions:
    • kubectl.1.17 (1.17.17)
    • kubectl.1.18 (1.18.20)
    • kubectl.1.19 (1.19.14)
    • kubectl.1.20 (1.20.10)
    • kubectl.1.21 (1.21.4)
    • kubectl.1.22 (1.22.1)
  • darwin/386 version of kubectl is no longer supported.
  • Deprecated and hid --logging and --monitoring flags from gcloud container clusters create-auto.

Recaptcha

  • Added --allowAllPackageNames and --allowAllBundleIds flags to gcloud recaptcha keys <create|update> to create/modify keys without specifying package names.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

357.0.0 (2021-09-14)

AI

  • Added --kms-key flag to gcloud beta ai model-monitoring-jobs create to support configuring Customer-managed encryption key spec.
  • Fixed issue where gcloud beta ai custom-jobs local-run unexpectedly used python2 with Vertex AI pre-built training images.

AI Platform

  • Added --enable-web-access to gcloud ai-platform jobs submit training to allow enabling interactive shell terminal access for a training job.

App Engine Flexible Environment

  • Added support for specifying the instance IP mode for each App Engine Flexible version during deployment. This can be done by adding 'instance_ip_mode: INTERNAL|EXTERNAL' in the Network field of the app.yaml file.

Cloud Dataflow

  • Added runtime environment parameter temp-location support in gcloud dataflow flex-template run/build. When this parameter is not set, defaults to value of staging-location.
  • Updated --additional-experiments parser used by run command gcloud dataflow flex-template run so the option can be specified multiple times and their values are concatenated.

Cloud Dataproc

  • Added --action-on-failed-primary-workers enum flag to gcloud dataproc clusters create to allow users to delete the failed primary workers during cluster creation.

Cloud Key Management Service

  • Added gcloud kms mac-sign and gcloud kms mac-verify which allow users to perform MAC signing and verification.
  • Added --import-only and --destroy-scheduled-duration to gcloud kms keys create to support import-only keys and user-specified variable key destruction.
  • Added --version to gcloud kms keys versions import to add key reimport functionality.

Cloud Pub/Sub

  • Promoted gcloud pubsub lite-reservations to GA.

Cloud Run

  • Promoted gcloud run replace to GA. This command supports deploying from a yaml file.

Cloud SQL

  • Promoted --allocated-ip-range-name flag of gcloud sql instances create to beta.

Cloud Services

  • Added support for additional services in services identity create.

Cloud Workflows

  • Added --call-log-level flag to gcloud workflows <execute|run> to enable automatic call logging.

Compute Engine

  • Changed the behavior of gcloud compute target-http-proxy import and gcloud compute target-https-proxy import to wait for the import operation to finish.
  • Updated --set-filter-protocols, --add-filter-protocols and --remove-filter-protocols to accept numeric protocols for all packet-mirrorings update commands.
  • Added --service-project flag to gcloud beta compute networks subnets list-usable.

Eventarc

  • Modified gcloud beta eventarc attributes types list to include Google Cloud Storage CloudEvent types and updated the descriptions for the existing event types.

Kpt

  • Added autocomplete image completion support in kpt fn eval.
  • Relaxed KRM check for kustomization files.
  • Added json output format for kpt live status command.
  • Added support for preserving field order/indendation kpt fn eval and kpt fn render.
  • Added support for referring SHA in image tags in kpt fn eval and kpt fn render.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

356.0.0 (2021-09-08)

Assured Workloads

  • Added CA_REGIONS_AND_SUPPORT as compliance regime options for gcloud assured workloads create command.
  • ResourceType CONSUMER_PROJECT is deprecated.
  • ResourceType CONSUMER_FOLDER and KEYRING are added.
  • display_name is added to ResourceSettings.
  • billing_account is now optional in Workload.
  • resource_settings is added to CreateWorkloadOperationMetadata.

Cloud API Gateway

Cloud Composer

  • Added --composer-network-ipv4-cidr to gcloud beta composer create to be used with Cloud Composer 2.
  • Added the following flags to gcloud beta composer create and gcloud beta composer update to be used with Cloud Composer 2:
    • --environment-size
    • --min-workers
    • --max-workers
    • --scheduler-cpu
    • --scheduler-memory
    • --scheduler-storage
    • --web-server-cpu
    • --web-server-memory
    • --web-server-storage
    • --worker-cpu
    • --worker-memory
    • --worker-storage

Cloud Run

  • Updated gcloud run deploy to include Cloud Run for Anthos enabled clusters on cluster suggestions.
  • Promoted --no-cpu-throttling flag of gcloud run to beta.

Compute Engine

  • Promoted --source-ip-ranges flag of gcloud compute forwarding-rules create and gcloud compute forwarding-rules update to beta.

Config Connector

GKE Hub

  • Running gcloud container hub memberships get-credentials with connectgateway.googleapis.com disabled now prompts the user to enable the API, and throws an error if the user declines to enable the API.

Kubernetes Engine

  • Added --addons=GcpFilestoreCsiDriver to gcloud container clusters create and --update-addons=GcpFilestoreCsiDriver to gcloud container clusters update to enable/disable the GCP Filestore Container Storage Interface (CSI) Driver.
  • Deprecated --enable-stackdriver-kubernetes, --enable-logging-monitoring-system-only, --monitoring-service, --logging-service, --master-logs, --no-master-logs, and --enable-master-metrics flags from gcloud container clusters create/update.

Network Security

  • Promoted gcloud network-security client-tls-policies to GA.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

355.0.0 (2021-08-31)

Anthos Identity Service

  • Promoted gcloud container hub identity-service to beta.

Artifact Registry

  • Added gcloud beta artifacts settings for enabling/disabling/finalizing redirection.

Cloud Deploy

  • Promoted gcloud deploy to beta.

Cloud Pub/Sub

  • Promoted --message-retention-duration flag of gcloud pubsub topics create to GA.
  • Promoted --message-retention-duration flag of gcloud pubsub topics update to GA.
  • Promoted --clear-message-retention-duration flag of gcloud pubsub topics update to GA.

Compute Engine

  • Promoted skip-instances-on-validation-error in gcloud compute instance-groups managed delete-instances to GA.
  • Promoted --image-family-scope flag to GA for gcloud compute instances create and gcloud compute disks create.

Config Connector

GKE Hub

  • Promoted the following commands to beta:
    • gcloud container hub mesh describe.
    • gcloud container hub mesh disable.
    • gcloud container hub mesh enable.

Game Servers

  • Added --view=(basic|full) arg (default to basic) to game servers clusters get and game servers clusters list commands to optionally turn off/on Agones and Kubernetes version reporting.

Kubernetes Engine

  • Added --security-group flag to gcloud container clusters create-auto to allow enabling Google Groups for RBAC on Autopilot clusters at creation time.

  • Promoted gpu-partition-size field within --accelerator flag to enable partitioning of A100 GPUs to GA.

Network Security

  • Promoted gcloud network-security server-tls-policies to GA.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

354.0.0 (2021-08-24)

Breaking Changes

  • (AI) Disable --analysis-instance-schema flag in gcloud beta ai model-monitoring-jobs update.

App Engine

Artifact Registry

  • Fixed print-settings command for Python repositories.

Cloud Asset Inventory

  • Added --relationship-type flag to gcloud asset get-history to enable getting relationship history.

Cloud Bigtable

  • Updated cbt_linux_arm name to cbt_linux_aarch64-x.x.x.tar.

Cloud Build

  • Added --require-approval flag to the following commands:
    • gcloud beta builds triggers create cloud-source-repositories
    • gcloud beta builds triggers create github
  • Added require-approval flag to gcloud builds triggers create.
  • Promoted gcloud builds approve and gcloud builds reject commands to beta.
  • Added the flag --suppress-logs to the command gcloud builds submit.

Cloud IAM

  • Promoted gcloud iam service-accounts keys disable|enable to beta and GA.

Cloud Run

  • Promoted --source flag of gcloud run deploy to GA. This flag supports deploying from source code through integration with Cloud Build.

Cloud Storage

  • Updated gsutil component to 4.67.

Compute Engine

  • Added --auto-renew flag to gcloud compute commitments create and gcloud compute commitments update for alpha.
  • Added the following flags to gcloud beta compute instances update:
    • --clear-node-affinities
    • --node-affinity-file
    • --node-group
    • --node
  • Promoted gcloud compute instances send-diagnostic-interrupt to beta and GA.
  • Added --host-error-timeout-seconds to specify the timeout in seconds for host error detection to both alpha and beta for:
    • gcloud compute instances create
    • gcloud compute instances create-with-container
    • gcloud compute instance-templates create
    • gcloud compute instances bulk create
    • gcloud compute instances set-scheduling
    • gcloud compute instances update-from-file

Config Connector

Essential Contacts

  • Promoted gcloud essential-contacts to GA.

Managed Active Directory

  • Promoted --enable-audit-logs flag in gcloud active-directory domains create and gcloud active-directory domains update to GA.
  • Promoted AUDIT_LOGS_ENABLED parameter to gcloud active-directory domains list to GA.
  • Updated gcloud active-directory domains list to include value for auditLogsEnabled in output.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

353.0.0 (2021-08-17)

Breaking Changes

  • (Compute Engine) Update gcloud compute instance-groups managed create to throw an error when creating a stateful regional managed instance group, if --instance-redistribution-type=NONE is not specified.

AI

  • Added more available regions to gcloud ai hp-tuning-jobs.

BigQuery

  • Added autoscale_preview as a new api_version for autoscaler.
  • Added support for creating an external dataset.
  • Minor bug fixes.

Cloud Asset Inventory

  • Added --relationship-type flag to the following commands:
    • gcloud asset list
    • gcloud asset feed create
    • gcloud asset feed update
  • Promoted --relationship-type flag to GA:
    • gcloud asset export
  • Added new content type RELATIONSHIP to:
    • gcloud asset get-history

Cloud Build

  • Fixed bug breaking gcloud beta builds triggers commands.

Cloud DNS

  • Update output format for gcloud dns record-sets.

Cloud Functions

  • Promoted --min-instances and --clear-min-instances flags of gcloud functions to beta.

Cloud Logging

  • Updated gcloud logging buckets create, gcloud logging buckets list, and gcloud logging buckets update to support restricted fields.

Cloud Pub/Sub

  • Renamed --zone flag as --location. Deprecated zone variants.
  • Added gcloud pubsub lite-subscriptions seek which initiates a seek operation for a Pub/Sub Lite subscription.
  • Added gcloud pubsub lite-operations command group which allows describing and listing Pub/Sub Lite long-running operations.

Cloud Services

  • Promoted gcloud services api-keys describe to GA.

Compute Engine

  • Added targetService to the output of gcloud compute service-attachments commands.

Database Migration

  • Fixed autocomplete issues in database migration commands.
  • Added "REGION" column in the output of gcloud database-migration connection-profiles list and gcloud database-migration migration-jobs list.
  • Added separate fields to display both the id and display name.
    • Added "CONNECTION_PROFILE_ID" in the output of gcloud database-migration connection-profiles list.
    • Added "MIGRATION_JOB_ID" and renamed "NAME" to "DISPLAY_NAME" in the output of gcloud database-migration migration-jobs list.
  • Some changes in gcloud connection profile list:
    • Fixed the value presented in ENGINE field to always display the DB engine.
    • Added a separate field for (cloud) PROVIDER to be distinguished from ENGINE.

Kubernetes Engine

  • Added --enable-gvnic flag of gcloud container clusters create, gcloud container nodepools create and gcloud container nodepools update to alpha, beta, GA.
  • Remove --enable-gvnic flag of gcloud container clusters update in alpha, beta.
  • Promoted --create-pod-ipv4-range and --pod-ipv4-range flags of gcloud container node-pools create for configuring pod ranges for node pools to GA.
  • Added --logging and --monitoring flags to gcloud container clusters create, gcloud container clusters update, and gcloud container clusters create-auto for users to configure the components that should have logging and/or monitoring turned on.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

352.0.0 (2021-08-10)

Access Approval

  • Promoted gcloud access-appoval command group to GA.

Apigee

  • Add archive deployment status column to archives list and archives describe commands.

Cloud Build

  • Added --region flag to gcloud beta builds triggers commands.

Cloud Composer

  • Removed Composer image versions with different major version of Airflow from list of suggested image versions of gcloud beta composer environments list-upgrades command.

Cloud On Demand Scanning

  • Updated local-extract to version 1.3.1 to fix various bugs.

Compute Engine

  • Added two new key types http-header and xff-ip to --enforce-on-key in 'gcloud compute security-policies rules'
  • Added --enforce-on-key-name to 'gcloud compute security-policies rules' in order to be able to specify the HTTP header name whose value becomes the rate limiting key forhttp-header` key type.
  • Modified gcloud compute ssh to also use IPv6 addresses if IPv4 addresses are unavailable.

Config Connector

Dataproc Metastore

  • Added --encryption-kms-key flag to gcloud beta metastore services create to specify the Customer-managed KMS key name to use for encrypting the Dataproc Metastore service.

GKE Hub

  • Removed the hidden label for --has-private-issuer flag in alpha and beta.
  • Promoted gcloud container hub memberships register --enable-workload-identity --has-private-issuer to GA.

Kubernetes Engine

  • Promoted --autoscaling-profile flag of gcloud container clusters create and gcloud container clusters update to GA.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

351.0.0 (2021-08-03)

AI

  • Promoted the GPU configuration fields in --worker-pool-spec flag of gcloud ai custom-jobs create to GA.

Artifact Registry

  • Promoted gcloud artifacts apt to beta.
  • Promoted gcloud artifacts yum to beta.
  • Promoted gcloud artifacts print-settings apt and gcloud artifacts print-settings yum to beta.
  • Changed com.google.cloud.artifactregistry.gradle-plugin from 2.1.0 to 2.1.1 in gcloud print-settings.

Assured Workloads

  • Added EU_REGIONS_AND_SUPPORT as compliance regime options for gcloud assured workloads create command.

Cloud Functions

  • Promoted --build-worker-pool and --clear-build-worker-pool flag of gcloud functions deploy to GA.

Cloud Healthcare

  • Added --send-for-bulk-import flag to the following commands:
    • gcloud beta healthcare dicom-stores create
    • gcloud beta healthcare dicom-stores update

Cloud Storage

  • Updated gsutil component to 4.66.

Compute Engine

  • Modified --network-interface flag of gcloud compute instances create and gcloud compute instance-templates create command to support IPv6 fields.
  • Promoted user_license flag of gcloud compute disks insert to beta.

Config Connector

GKE Hub

  • Promoted gcloud container hub memberships get-credentials to GA.

Miscellaneous

  • Binary Size input can contain decimal digits, provided the amount is a whole multiple of a Byte.

Policy Analyzer

  • Added gcloud policy-intelligence query-activity which queries activities. Supported activity types are service account last authentication and service account key last authentication.

Recaptcha

  • Promoted gcloud recaptcha keys to GA.

Secret Manager

  • Added --etag flag to the following commands:
    • gcloud secrets delete
    • gcloud secrets update
    • gcloud secrets versions destroy
    • gcloud secrets versions disable
    • gcloud secrets versions enable

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

350.0.0 (2021-07-27)

Cloud SDK

  • Fixed issue where the gcloud command-line tool would fail to tab complete flags specified after positional arguments.

Cloud Build

  • Added --service-account flag to gcloud beta builds triggers create command.

Cloud Filestore

  • Added connect-mode param to --network flag of gcloud filestore instances create for alpha and beta.

Cloud Services

  • Promoted gcloud services api-keys list to GA.

Compute Engine

  • Modified --source-ranges and --destination-ranges for gcloud compute firewall-rules create and gcloud compute firewall-rules update to accept IPv6 address ranges in addition to IPv4 address ranges.
  • Promoted rsa_encrypted_key in gcloud compute disks snapshot to GA.
  • Promoted rsa_encrypted_key in gcloud compute disks create and gcloud compute images create to GA.
  • Promoted type flag of gcloud compute security-policies create to beta.

Firebase Test Lab

  • Added --resign flag to gcloud beta firebase test android run. This flag allows clients to specify if Robo should re-sign the app-under-test APK.

Network Management

  • Added gkeMasterCluster and cloudSqlInstance arguments for source and destination in gcloud network-management connectivity-tests. This allows the user to run tests using Google Managed Services (GKE and Cloud SQL) endpoint types as source or destination.

Secret Manager

  • Updated --filter flag to be passed to the backend in
    • gcloud beta secrets list
    • gcloud secrets versions list

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

349.0.0 (2021-07-20)

Breaking Changes

AI

  • Added --network flag to gcloud beta ai endpoints create.

Certificate Authority Service

  • Changed certificate chain output format to remove extra newline between -----END CERTIFICATE----- and -----BEGIN CERTIFICATE-----. This affects certificate outputs of gcloud privateca certificates create, gcloud privateca certificates export and gcloud privateca pools get-ca-certs.

Cloud Asset Inventory

  • Promote gcloud asset list CLI to GA.

Cloud Build

  • Add --no-public-egress to gcloud builds worker-pools create.
  • Add --public-egress and a hidden --no-public-egress flags to gcloud builds worker-pools update.

Cloud Composer

  • Added support of --scheduler-count flag for gcloud beta composer environments {create,update} commands.

Cloud DNS

  • Added DNS Routing Policies support for gcloud beta dns record-sets.

Cloud Dataflow

  • Added Google Artifact Registry support in build command gcloud beta dataflow flex-template build.

Cloud Datastream

  • Allow using project numbers in command arguments.
  • Update help text files for gcloud beta datastream streams create/update.

Cloud Functions

  • Remove incorrect client-side validation for --entrypoint flag of gcloud functions deploy.

Cloud Healthcare

  • Added gcloud command-line tool support for healthcare NL
    • gcloud beta healthcare nlp analyze-entities

Cloud Key Management Service

  • Added ec-sign-secp256k1-sha256 to the list of supported algorithms.

Cloud Spanner

  • Added --processing-units flag to spanner create instance and spanner update instance to add ability to create granular instances in beta.

Cloud TPU

  • Added Cloud AI Notebooks support to gcloud compute tpus execution-groups create by adding flag --use-with-notebook.

Compute Engine

  • Added --redirect-type and --redirect-target to gcloud compute security-policies rules create|update in alpha and beta.
  • Add share_type to output of gcloud compute reservations list.
  • Added custom response headers to regional gcloud compute backend-services create requests.
  • Promoted user_license flag of gcloud compute images insert to beta.
  • Added an example of gcloud compute instances list to display IPv6 related fields.
  • Promoted --target-service-attachment flag of gcloud compute forwarding-rules create to GA.
  • Promoted --purpose=private-service-connect flag of gcloud compute networks subnets create to GA.
  • Promoted gcloud compute service-attachments to GA.
  • Added --mesh to gcloud compute instance-templates create in alpha and beta.

Config Connector

Dataproc Metastore

  • Promoted backups command group to GA.
  • Promoted Service restore command to GA.

GKE Hub

  • Promoted the following commands to GA:
    • gcloud container hub features list
    • gcloud container hub ingress describe
    • gcloud container hub ingress disable
    • gcloud container hub ingress enable
    • gcloud container hub ingress update
    • gcloud container hub multi-cluster-services describe
    • gcloud container hub multi-cluster-services disable
    • gcloud container hub multi-cluster-services enable

Kpt

  • Updated kpt to v1.0.0-beta.1. Look at the documentation at https://kpt.dev for more details.

Pubsub Emulator

  • Added support for subscriptions with both dead letter topics and ordered delivery enabled in the Pub/Sub emulator.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

348.0.0 (2021-07-13)

Cloud SDK

  • Added --locked flag to gcloud compute images create.

AI

  • Added more available regions to gcloud ai custom-job.

App Engine

BigQuery

  • Added --autoscale_budget_slot_hours flag to mk and update to support budget based reservation autoscaling.
  • Added flags: --create_session and --session_id to query to support session creation and using existing sessions.
  • Added --connection_property flag to query to set connection properties.
  • Minor bug fixes.

Cloud Bigtable

  • Added support to cbt to drop all rows from a table.
  • Added --auth-token flag to use IAM Auth Token for requests.

Cloud Build

  • Promoted gcloud builds worker-pools command group to GA.

Cloud Composer

  • Added gcloud beta composer environments list-packages command. It lists all PyPI modules installed in an Airflow worker.

Cloud DNS

  • Added --gkeclusters to gcloud beta dns response-policies create to support binding GKE clusters to the response policy.
  • Added --gkeclusters to gcloud beta dns response-policies update to support updating response policy with GKE clusters.

Cloud Datastream

  • Modified output formatting for gcloud beta datastream streams list to include stream creation and update times.
  • Added gcloud beta routes create which creates a datastream private connection route.
  • Added gcloud beta routes delete which deletes a datastream private connection route.
  • Added gcloud beta streams update which updates an existing datastream stream.

Cloud Key Management Service

  • Added client-side request and response integrity verification to gcloud kms encrypt, gcloud kms decrypt, gcloud kms asymmetric-sign, and gcloud kms asymmetric-decrypt. For more information about Cloud KMS's integrity verification API, visit https://cloud.google.com/kms/docs/data-integrity-guidelines.
  • Added --skip-integrity-verification flag to gcloud kms encrypt, gcloud kms decrypt, gcloud kms asymmetric-sign, and gcloud kms asymmetric-decrypt.

Cloud On Demand Scanning

  • Added --additional-package-types=MAVEN flag to scan Maven packages for vulnerabilities.
  • Updated local-extract to version 1.2.0 in order to support the scanning of CentOS and RHEL images.

Cloud Scheduler

  • Added gcloud scheduler locations command group [ALPHA, BETA]. Commands in this group provide information for locations where Cloud Scheduler is available.

Cloud Storage

  • Updated gsutil component to 4.65.

Compute Engine

  • Removed IPv6 support from gcloud compute instances create-with-container and gcloud compute instance-templates create-with-container until it's ready.
  • Added --description flag on compute instance-groups managed update to add possibility to update descriptions.
  • Changed the behavior of gcloud compute url-maps import to wait for the import operation to finish.
  • Added KMS args (--boot-disk-kms-project, --boot-disk-kms-location, --boot-disk-kms-keyring, --boot-disk-kms-key, and kms-project, kms-location, kms-keyring, kms-key properties of --create-disk) to gcloud compute instances bulk create to allow specifying a customer-managed encryption key.
  • Promoted --request-headers-to-add to beta for gcloud compute security-policies rules create|update.

Config Connector

Dataproc Metastore

  • Added the following alpha and beta commands to work with Dataproc Metastore service backups:
    • metastore services backups get-iam-policy
    • metastore services backups set-iam-policy
    • metastore services backups add-iam-policy-binding
    • metastore services backups remove-iam-policy-binding

GKE Hub

  • Fixed issue where --config-membership of gcloud container hub ingress enable and gcloud container hub ingress update did not properly handle full Membership resource paths.

Kubernetes Engine

  • Added --enable-identity-service flag to alpha, beta.
  • Mark --enable-gke-oidc flag as deprecated.
  • Added --security-group to gcloud container clusters create and gcloud container clusters update. This flag is used to enable the Authenticator Groups Config for group authentication.

Miscellaneous

  • Fixed issue where special characters were improperly escaped during command completion when using zsh or fish.
    • The previous behavior can be restored by setting the environment variable _ARGCOMPLETE_SHELL to 'bash'.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

347.0.0 (2021-06-29)

Breaking Changes

  • (Assured Workloads) Removed 'consumer-project-id' and 'consumer-project-name' as possible values for resource-settings in gcloud assured workloads delete command in alpha and beta, as they are now deprecated.
  • (Cloud SQL) Modified gcloud beta sql users list to include 'IAM_EMAIL' column in the output. It will display full email address for a CloudSQL MySQL IAM database user account.
  • (Kpt) Binary for Windows will no longer be provided. If you want to use kpt with windows, the source code is available at github.com/GoogleContainerTools/kpt.

AI

  • Promoted gcloud ai hp-tuning-jobs to GA.
  • Fixed issue where gcloud beta ai custom-jobs create failed to install dependencies in requirements.txt when packaging from local files.
  • Added --feature-attribution-thresholds flag to gcloud beta ai model-monitoring-jobs <create|update> to support configuring feature attribution score thresholds.

App Engine

  • Added support for 'egress_setting' field in 'vpc_access_connector' section of app.yaml.

Certificate Authority Service

  • Added gcloud privateca pools get-ca-certs to get the root CA certs for all active CAs in the CA pool.

Cloud Asset Inventory

  • Added --read-mask flag to gcloud asset search-all-resources to specify which fields to be returned.
  • Updated gcloud asset search-all-resources to return the full metadata (versionedResources) of resources when requested with flag --read-mask.

Cloud Datastream

  • Added gcloud beta connection-profiles update which updates an existing datastream connection profile.
  • Added gcloud beta streams create which creates a datastream stream.

Cloud Firestore Emulator

  • Release Cloud Firestore emulator v1.13.0
    • Add WebSocket endpoint for monitoring rules requests.

Cloud Pub/Sub

  • Promoted gcloud pubsub lite-topics publish to GA.
  • Promoted gcloud pubsub lite-subscriptions subscribe to GA.
  • Promoted gcloud pubsub lite-subscriptions ack-up-to to GA.

Cloud Run

  • gcloud beta run deploy now defaults to deploy from source if --image is not provided.

Cloud SQL

  • Promoted --active-directory-domain flag of gcloud sql instances create and gcloud sql instances patch to GA.

Cloud Storage

  • Updated gsutil component to 4.64.

Compute Engine

  • Changed the behavior of gcloud compute backend-services import to wait for the import operation to finish.
  • Promote share-setting and share-with for glcloud compute reservations create to beta.
  • Fixed gcloud compute forwarding-rules import to remove top-level properties of an existing forwarding rule when they are not specified in the YAML file.
  • Changed the list format of gcloud compute networks subnets list to include IPv6 related fields.
  • Changed --custom-cpu type from int to string to allow E2 shared-core instances to be specified as a custom value.

GKE Hub

  • Promoted the following commands to beta:
    • gcloud container hub config-management apply
    • gcloud container hub config-management disable
    • gcloud container hub config-management enable
    • gcloud container hub config-management status
    • gcloud container hub config-management unmanage
    • gcloud container hub config-management upgrade
    • gcloud container hub config-management version
    • gcloud container hub features list
    • gcloud container hub ingress describe
    • gcloud container hub ingress disable
    • gcloud container hub ingress enable
    • gcloud container hub ingress update
    • gcloud container hub multi-cluster-services describe
    • gcloud container hub multi-cluster-services disable
    • gcloud container hub multi-cluster-services enable

Identity Groups

  • Promoted --posix-group flag of gcloud identity groups create to beta.
  • Promoted --add-posix-group, --remove-posix-groups, and --clear-posix-groups flags of gcloud identity groups update to beta.

Kpt

  • Removed Windows binary.

Kubernetes Engine

  • Promoted --enable-l4-ilb-subsetting flag of gcloud container clusters create and gcloud container clusters update to GA.
  • Promoted --enable-service-externalips flag to beta.

Managed Active Directory

  • Promoted gcloud active-directory domains update-ldaps-settings to beta and GA.
  • Promoted gcloud active-directory domains describe-ldaps-settings to beta and GA.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

346.0.0 (2021-06-22)

Breaking Changes

  • (Cloud SDK) Removed the deprecated flag --add-quota-project in gcloud auth application-default login. --add-quota-project is the default.
  • (Certificate Authority Service) Renamed --location flag on gcloud privateca certificates create as --template-location, and updated it to default to the same location as the issuing CA Pool.
  • (Certificate Authority Service) Added an explicit check to gcloud privateca certificates create to verify that any certificate templates are in the same location as the issuing CA Pool.

AI

  • Added gcloud beta ai custom-jobs local-run which creates a custom training container image from your code and runs it locally.
  • Supported training with local files in gcloud beta custom-job create command.

Access Approval

  • Promoted gcloud access-appoval command group to beta.

Cloud Asset Inventory

  • Updated gcloud asset search-all-iam-policies with new searchable fields (memberTypes, roles, project, folders, and organizations), new request fields (assetTypes and orderBy), and new response fields (assetType, folders, and organization).

Cloud Build

  • Updated gcloud builds triggers create ... with require-approval flag.

Cloud Composer

  • Added gcloud beta composer environments check-upgrade command. It checks that an environment upgrade does not fail because of PyPI module conflicts.

Cloud DNS

  • Added --gkeclusters to gcloud beta dns managed-zones create to support binding GKE clusters to the zone.

Cloud Datastream

  • Added gcloud beta operations cancel which cancels a datastream operation.
  • Added gcloud beta private-connections create which creates a datastream private connection.

Cloud Pub/Sub

  • Promoted gcloud pubsub schemas to GA.
  • Promoted --schema and --encoding flags of gcloud pubsub topics create to GA.

Cloud SQL

  • Added SQL Server 2019 options to --database-version flag of gcloud sql instances create and gcloud sql flags list.

Compute Engine

  • Added debian-10 option to --os flag for:
    • gcloud compute images import in GA,
    • gcloud compute instances import in GA
    • gcloud compute machine-images import in beta
    • gcloud compute routers update
  • Promoted support for stack-type and ipv6-network-tier for gcloud compute instances network-interfaces update to GA.
  • Added staged progress tracker to gcloud beta compute networks update --switch-to-custom-subnet-mode when updating a legacy network.

Config Connector

Kpt

  • Updated kpt from v0.39.2 to v0.39.3.

Miscellaneous

  • Updated lazy module loader to correctly set module.file to the file name, rather than the file handle, to properly support debugging with Pdb++ (https://issuetracker.google.com/issues/190741410).

VPC Access

  • Promoted following flags in gcloud compute networks vpc-access connectors create to GA:
    • --machine-type

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

345.0.0 (2021-06-15)

AI

  • Updated --worker-pool-spec flag of gcloud beta ai custom-jobs create to support configuring GPUs.

Certificate Authority Service

  • Added gcloud privateca which enables creating and managing private CA pools, certificate authorities, certificates and certificate templates through the v1 API.

Cloud Composer

  • Fixed exception on executing gcloud composer environments run env-name delete_dag command without Airflow command arguments.

Cloud Dataflow

  • Updated build command to fuse multiple dependencies COPY docker commands into a single COPY command.

Cloud Datastream

  • Added gcloud beta connection-profiles discover which performs discovery on a datastream connection profile.

Cloud Firestore Emulator

  • Release Cloud Firestore emulator v1.12.0
    • Support partially clearing data via API.

Cloud Run

  • Modified gcloud beta run deploy --source to use Artifact Registry for build artifacts. Users will be prompted prior to automatic creation of an Artifact Registry repository named "cloud-run-source-deploy".
  • Promoted --use-http2 flag to GA for Cloud Run (fully managed).

Cloud SQL

  • Added support for - as a wildcard in place of an instance name for gcloud sql backups list.

Cloud Storage

  • Updated gsutil component to 4.63.

Compute Engine

  • Promoted --byol flag of:
    • gcloud compute images import to GA
    • gcloud compute instances import to GA
  • Promoted following flags in gcloud compute instances create and gcloud compute instances update-access-config to GA:
    • --ipv6-public-ptr-domain
    • --no-ipv6-public-ptr
  • Added --all-instances flag on compute managed update-instances to reflect the instances selection options available in the REST API.
  • Add --source-disk-project flag to image creation. It is used to specify source disk project when creating image from disk.
  • Promoted support for stack-type and ipv6-access-type for gcloud compute networks subnets create to GA.
  • Promoted --enable flag to GA for the following commands:
    • gcloud compute routers add-bgp-peer
    • gcloud compute routers update-bgp-peer
  • Promoted --keepalive-interval flag to GA for the following commands:
    • gcloud compute routers create
    • gcloud compute routers update
  • Promoted support for stack-type and ipv6-network-tier for gcloud compute instances <create|create-with-container> to GA.
  • Promoted support for stack-type and ipv6-network-tier for gcloud compute instance-templates <create|create-with-container> to GA.
  • Promoted support for stack-type and ipv6-access-type for gcloud compute networks subnets update to GA.

Kubernetes Engine

  • Added --enable-service-externalips flag to gcloud alpha and beta to allow or deny services to set the ExternalIPs field.
  • Added --autoprovisioning-image-type flag to gcloud container clusters create and gcloud container clusters update to specify the image type for node autoprovisioning.

Network Services

  • Promoted gcloud network-services endpoint-policies to beta.

VPC Access

  • Promoted following flags in gcloud compute networks vpc-access connectors create to GA:
    • --min-instances
    • --max-instances
    • --machine-type

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

344.0.0 (2021-06-08)

Breaking Changes

  • (AI) Renamed --drift-thresholds flag in gcloud beta ai model-monitoring-jobs create and gcloud beta ai model-monitoring-jobs update to --feature-thresholds.

App Engine

  • Updated the Python SDK to version 1.9.93.

Cloud Asset Inventory

  • Added new content type org-policy, access-policy, os-inventory to gcloud beta asset list.

Cloud Pub/Sub

  • Added gcloud beta pubsub lite-subscriptions subscribe which allows the user to receive messages on a Pub/Sub Lite subscription.

Compute Engine

  • Added --json-parsing and --log-level flags to gcloud compute security-policies update.
  • Promoted --json-parsing and --log-level flags to GA for gcloud compute security-policies update.

Config Connector

GKE Hub

  • Promoted gcloud container hub memberships get-credentials to GA.

Managed Active Directory

  • Adding support for gcloud active-directory peerings for Multi Project Support release.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

343.0.0 (2021-06-02)

Breaking Changes

  • (Certificate Authority Service) Updated gcloud beta privateca to only allow managing resources in the 6 supported locations. For more information, see https://cloud.google.com/certificate-authority-service/docs/locations.
  • (Cloud Run) If platform is not specified via flags or config, gcloud run commands that require a platform will now default to managed instead of prompting to select a platform.

AI

  • Promoted gcloud ai custom-jobs to GA.

Artifact Registry

  • Added Python repo creation with gcloud artifacts repositories create.
  • Added print-settings command for Python repositories.

BigQuery

  • Disable non-fedarated AWS connection type.
  • New module credential_loader encapsulate credential and auth related functions for BQCLI. The main entrypoint for these functions is credential_loader.GetCredentialsFromFlags (moved from _GetCredentialsFromFlags). Note the removed underscore in addition to the module path change.
  • Minor bug fixes and dependency updates.

Cloud Datastream

  • Added gcloud beta connection-profiles which contains create, delete, describe and list for Datastream connection profile objects.
  • Added gcloud beta locations fetch-static-ips which returns a list of static IPs used by Datastream for a specific location.
  • Fixed issue where gcloud beta connection-profiles list returned partial information in the list formatting.

Cloud Functions

  • Update logging message for gcloud functions deploy to print Cloud Build log URL.

Cloud Pub/Sub

  • Modified the output of gcloud beta pubsub schemas validate-schema on the successful validation of a schema to text indicating the success rather than the empty response returned by the service.
  • Modified the output of gcloud beta pubsub schemas validate-message on the successful validation of a message to text indicating the success rather than the empty response returned by the service.
  • Added gcloud beta pubsub lite-subscriptions ack-up-to which allows the user to acknowledge messages on a specified Pub/Sub Lite subscription.

Compute Engine

  • Promoted --scopes, --no-scopes,, --service-account and --no-service-account flags to GA for gcloud compute instances import.
  • Updated gcloud beta compute service-attachment to fix the default values of --enable-proxy-protocol and --connection-preference.

Config Connector

Kubernetes Engine

  • Added --threads-per-core flag to gcloud container clusters create and gcloud container node-pools create commands.
  • Fixed issue for 0 node clusters relating to misleading output of node versioning in gcloud container clusters list.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

342.0.0 (2021-05-25)

App Engine

  • Added support for specifying a service account for each App Engine version during deployment. This can be done by either running gcloud app deploy --service-account=<SERVICE_ACCOUNT> or by specifying 'service_account: ' in app.yaml file. If both are specified, the CLI parameter will override the app.yaml spec.
  • Updated the Java SDK to version 1.9.89. Please visit the following release notes for details: https://cloud.google.com/appengine/docs/java/release-notes.

App Engine Flexible Environment

  • Added support for specifying a service account for each App Engine Flexible version during deployment. This can be done by either running gcloud app deploy --service-account=<SERVICE_ACCOUNT> or by specifying 'service_account: ' in app.yaml file. If both are specified, the CLI parameter will override the app.yaml spec.

Certificate Authority Service

  • Added support for key generation in certificates create using newer versions (3.4 and above) of the Python cryptography package.

Cloud Build

  • Update gcloud beta builds triggers run for repoless triggers.

Cloud Datastream

  • Added gcloud beta datastream locations command group - contains describe and list for Datastream locations objects.
  • Added gcloud beta datastream routes command group - contains describe and list for Datastream routes objects.
  • Deprecated --region flag of gcloud beta datastream. Use --location instead.

Cloud Pub/Sub

  • Added --definition-file to gcloud beta pubsub schemas validate-message, gcloud beta pubsub schemas validate-schema, and gcloud beta pubsub schemas create to specify a schema stored in a file.

Compute Engine

  • Updated gcloud compute instance-groups managed abandon-instances, delete-instances, recreate-instances, and update-instances to return unresolved instance names for regional groups with status MEMBER_NOT_FOUND.
  • Updated gcloud beta compute service-attachment update to allow users to clear the consumer-accept-list and consumer-reject-list.
  • Added --threads-per-core flag to specify number of visible threads per physical core to both beta and GA for:
    • gcloud compute instances create
    • gcloud compute instances create-with-container
    • gcloud compute instance-templates create
    • gcloud compute instances bulk create

Config Connector

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

341.0.0 (2021-05-18)

AI Platform

  • Added beta commands for the AI platform tensorboard suite.
  • Added gcloud beta ai tensorboards commands to manage a Tensorboard on the unified AI platform.
  • Added gcloud beta ai tensorboard-experiments commands to manage a Tensorboard Experiment on the unified AI platform.
  • Added gcloud beta ai tensorboard-runs commands to manage a Tensorboard Run on the unified AI platform.
  • Added gcloud beta ai tensorboard-time-series commands to manage a Tensorboard Time Series on the unified AI platform.

App Engine

  • Added a deprecation warning to gcloud app deploy dos.yaml.

App Engine Flexible Environment

  • Added a deprecation warning to gcloud app deploy dos.yaml.

Assured Workloads

  • Added option to specify custom project names in --resource-settings by using consumer-project-name or encryption-keys-project-name key in gcloud assured workloads create command.

BigQuery

  • Support displaying TVF return table signature.
  • Adds enable_queuing_and_priorities reservation flag (only for whitelisted reservations).
  • Adds support for reservation assignment priority (only for whitelisted reservations).

Cloud Asset Inventory

  • Added gcloud asset analyze-move commands to analyze a GCP Project Migration.

Cloud Pub/Sub

  • Added gcloud beta pubsub lite-topics publish which allows the user to publish a message to their specified Pub/Sub Lite topic.

Cloud Storage

  • Updated gsutil component to 4.62.

Compute Engine

  • Promoteddisk-resource-policykey of flag--create-diskfor allcompute instances` create commands.
  • Updated help text for --enable-endpoint-independent-mapping on compute routers nats create and compute routers nats update to reflect the new default.

Kubernetes Engine

  • Added --threads-per-core flag to gcloud container clusters create and gcloud container node-pools create commands.
  • Promoted --cluster-dns-* flags of gcloud container clusters create and gcloud container clusters update to beta.
  • Updates default kubectl from 1.17 to 1.18.
  • Additional kubectl versions:
    • kubectl.1.17 (1.17.17)
    • kubectl.1.18 (1.18.19)
    • kubectl.1.19 (1.19.11)
    • kubectl.1.20 (1.20.7)
    • kubectl.1.21 (1.21.1)

Pubsub Emulator

  • Fixed issue where subscription retention was not being respected upon subscription creation.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

340.0.0 (2021-05-11)

Cloud Asset Inventory

  • Updated gcloud asset search-all-resources to support date-time string in queries on timestamp fields (createTime and updateTime).

Cloud Bigtable

  • Promoted the IAM Conditions flags --condition and --condition-from to GA.

Cloud Billing

  • Added optional --calendar-period, --start-date, and --end-date flags to gcloud billing budgets [create | update] to support a wider array of options for the budget's timeframe, which was previously always one month.

Cloud Memorystore

  • Promoted gcloud beta redis reschedule-maintenance to beta.
  • Added --maintenance-window-day flag and --maintenance-window-hour flag to gcloud beta redis instances create to allow specifying a maintenance policy when creating a new instance.
  • Added --maintenance-window-day flag, --maintenance-window-hour flag and --maintenance-window-any flag to gcloud beta redis instances update to allow updating a maintenance policy when updating an instance.

Cloud Run

  • Modified gcloud beta run deploy --source to suggest a default service name based on the source path when one isn't provided.

Compute Engine

  • Promoted gcloud compute service-attachments to beta.
  • Added --target-service-attachment flag to gcloud beta compute forwarding-rules create.
  • Added --purpose=private-service-connect to gcloud beta compute networks subnets create.

Config Connector

Database Migration

  • Added MYSQL_8_0, POSTGRES_10, POSTGRES_12, and POSTGRES_13 database version options for --database-version flag to database-migration connection-profiles create cloudsql.

Kubernetes Engine

  • Promoted --enable-dataplane-v2 to GA.

Notebooks

  • Added gcloud notebooks instances rollback to rollback a notebook's boot disk.
  • Added gcloud notebooks instances get-health to verify instance health.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

339.0.0 (2021-05-04)

Breaking Changes

  • (Certificate Authority Service) Updated default value for --max-chain-length flag of gcloud beta privateca roots create. Now, no max chain length will be added to newly created root CAs unless they are explicitly specified through --max-chain-length, or (indirectly) through a --reusable-config resource argument.

AI

  • Added executor-image-uri field to --worker-pool-spec flag of gcloud beta ai custom-jobs create, as an alias of python-image-uri field. python-image-uri will be deprecated soon.
  • Accepted empty value for --worker-pool-spec flag, which means to create an empty worker pool.

Assured Workloads

  • Added option to specify custom keyring name in --resource-settings by using keyring-id key in gcloud assured workloads create command.

Cloud Composer

  • Added links to the documentation pages when the request fails on missing required permissions.

Cloud On Demand Scanning

  • Upgrade local-extract to version 1.0.0. This version replaces memory-intensive extraction with disk-based extraction.

Cloud SQL

  • The output of gcloud sql backups list --instance="my-instance-1" will now include the instance name.

Compute Engine

  • Added --request-coalescing to gcloud compute backend-services create, gcloud compute backend-services update, gcloud compute backend-buckets create and gcloud compute backend-buckets update.
  • Added cdnPolicy.requestCoalescing field support to gcloud compute backend-services import.
  • Added --minimal-action and --most-disruptive-allowed-action flags to gcloud beta compute instance-groups managed rolling-action start-update.

Config Connector

Kpt

  • Updated kpt from v0.39.0 to v0.39.2.
  • Updated import of cli-utils from v0.24.0 to v0.25.0.
  • Updated import of kyaml from v0.10.15 to v0.10.17.
  • Updated import of cmd/config from v0.9.7 to v0.9.10.

Kubernetes Engine

  • Added --disable-autopilot flag of gcloud container clusters update to convert cluster from Autopilot mode to Standard mode.

Network Security

  • Modified gcloud network-security client-tls-policies to accept empty serverValidationCa which signals to the client to do un-authenticated TLS.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

338.0.0 (2021-04-27)

Breaking Changes

  • (Cloud Run) Deprecated all choice of --vpc-egress flag of gcloud run deploy and gcloud run services update. A new all-traffic choice provides the same functionality with a more specific name. all will continue to be supported, but prefer to use all-traffic.
  • (Cloud Run) Modified gcloud beta run deploy to accept either --image or --source, but not both.

Cloud Dataproc

  • Added --confidential-compute boolean flag to gcloud dataproc clusters create to allow users to configure Compute Engine Confidential VMs on Dataproc clusters.
  • Added --confidential-compute boolean flags to gcloud dataproc workflow-templates set-managed-cluster to allow users to configure Compute Engine Confidential VMs on Dataproc managed clusters.

Cloud Firestore Emulator

  • Release Cloud Firestore emulator v1.11.15
    • Fixes issue with parsing empty headers which caused some valid requests to be rejected.

Cloud Key Management Service

  • Promote get-certificate-chain command to GA.

Cloud Memorystore

  • Added timeout key to --redis-config flag of redis instances create.
  • Added timeout key to --redis-config flag of redis instances update.

Cloud Pub/Sub

  • Promoted --starting-offset flag of gcloud pubsub lite-subscriptions create to GA.

Cloud Run

  • Added all-traffic choice to --vpc-egress flag of gcloud run deploy and gcloud run services update. all-traffic provides the same functionality as the existing all choice with a more specific name. all is now deprecated but will continue to be supported. Prefer to use all-traffic.
  • Promoted --binary-authorization and --breakglass flags of gcloud run deploy and gcloud run services update to beta.

Cloud Services

  • Promoted gcloud services vpc-peerings delete to GA.

Cloud Tasks

  • Updated gcloud tasks queues update [QUEUE_NAME] --clear-routing-override to remove appEngineRoutingOverride values instead of setting them to empty strings.

Compute Engine

  • Promoted --iap-tunnel-disable-connection-check flag of gcloud compute start-iap-tunnel to GA.
  • Promoted --cpu-utilization-predictive-autoscaling flag of gcloud compute instance-groups managed set-autoscaling and gcloud compute instance-groups managed update-autoscaling to GA.

Config Connector

Network Security

  • Promoted gcloud network-security authorization-policies to beta.
  • Promoted gcloud network-security server-tls-policies to beta.
  • Promoted gcloud network-security client-tls-policies to beta.

Secret Manager

  • Added --etag flag to the following commands:
    • gcloud beta secrets update
    • gcloud beta secrets delete
    • gcloud beta secrets versions enable
    • gcloud beta secrets versions disable
    • gcloud beta secrets versions destroy

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

337.0.0 (2021-04-20)

Assured Workloads

  • Added HIPAA and HITRUST as compliance regime options for gcloud assured workloads create command in GA.

BigQuery

  • Added bq truncate command. This command will only be available to selected customers in private preview.
  • Added --job to bq delete.

Cloud Access Context Manager

  • Changed behavior of perimeters dry-run describe:
    • Not displaying unset fields.
    • +/- signs now are displayed at the very beginning of the line, instead of being displayed right in front of the resource text.
    • Extra space added in front of top-level fields like names/title/type to align text.

Cloud Dataflow

  • Promoted gcloud dataflow snapshots to GA.

Cloud Domains

  • Fixed issue where multiple address line fields were not supported in commands with interactive prompts:
    • gcloud beta domains registrations register
    • gcloud beta domains registrations configure contacts

Cloud Filestore

  • Promoted gcloud filestore backups to GA.
  • Added gcloud filestore instances restore to enable restoring a Cloud Filestore instance from a backup.
  • Added support for creating Filestore instances from backup using gcloud filestore instances create.
  • Promoted --source-backup and --source-backup-region flags to GA to specify backup details; these flags should be used in conjunction with --file-share flag.

Cloud Memorystore

  • Added support for Redis 6.x.

Cloud Resource Settings

  • Promoted gcloud resource-settings to GA.

Cloud Services

  • Promoted gcloud services vpc-peerings delete to beta.

Compute Engine

  • Promoted --redundant-interface, --subnetwork and --subnetwork-region flags of gcloud compute routers add-interface to beta.
  • Promoted --instance and --instance-zone flags of gcloud compute routers add-bgp-peer to beta.
  • Promoted --interface-names of gcloud compute routers remove-interface to beta.
  • Promoted --peer-names of gcloud compute routers remove-bgp-peer to beta.

Essential Contacts

  • Promoted gcloud essential-contacts to beta.

Service Directory

  • Added --network flag to gcloud service-directory endpoints create command in beta.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

336.0.0 (2021-04-13)

Assured Workloads

  • Promoted --resource-settings of gcloud assured workloads create to GA.

Cloud Composer

  • Added support of Airflow 2.0 CLI nested commands to gcloud composer environments run.
  • Updated gcloud beta composer environments run my-environment upgrade_check to run upgrade check to Airflow 2.0 for Composer environments with Airflow 1.10.15+.

Cloud Firestore Emulator

  • Release Cloud Firestore emulator v1.11.14
    • Fix header parsing causing permission denined errors with Firestore JS SDK v8.3.2.

Cloud Storage

  • Updated gsutil component to 4.61.

Compute Engine

  • Added --request-coalescing to gcloud beta compute backend-services create, gcloud beta compute backend-services update, gcloud beta compute backend-buckets create and gcloud beta compute backend-buckets update.
  • Added cdnPolicy.requestCoalescing field support to gcloud beta compute backend-services import.
  • Promoted --target_distribution_shape flag of gcloud compute instance-groups managed create and update to GA. Added --compute-service-account flag to gcloud compute instances import.
  • Removed unneeded curl progress output from gcloud compute ssh with `--internal-ip flag.
  • Promoted --zone flag to gcloud beta compute images describe-from-family.

Config Connector

Kpt

  • Updated kpt from v0.38.1 to v0.39.0.
  • Updated import of cli-utils from v0.23.5 to v0.24.0.
  • Updated import of kyaml from v0.10.13 to v0.10.15.
  • Updated import of cmd/config from v0.9.5 to v0.9.7.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

335.0.0 (2021-04-06)

Breaking Changes

  • (Cloud Bigtable) Deprecated --cluster, --cluster-num-nodes and --cluster-zone flags of
  • (Cloud Bigtable) gcloud bigtable instances create. Use --cluster-config instead.
  • (Cloud Bigtable) Deprecated --instance-type flag of gcloud bigtable instances create. All
  • (Cloud Bigtable) instances are now of type PRODUCTION.

App Engine

Cloud Access Context Manager

  • Promoted ingress-policies and egress-policies flags of gcloud access-context-manager perimeters to GA.
  • Support displaying Ingress and EgressPolicies for:
    • gcloud access-context-manager perimeters describe.
    • gcloud access-context-manager perimeters dry-run describe.

Cloud Asset Inventory

  • Added --access-time flag to gcloud asset analyze-iam-policy and gcloud asset analyze-iam-policy-longrunning.

Cloud Bigtable

  • Added --kms-key, --kms-keyring, --kms-location and --kms-project flags to gcloud bigtable clusters create for alpha, beta and GA for creating CMEK-protected clusters.
  • Added key kms-key to --cluster-config flag of gcloud bigtable instances create, for creating CMEK-protected clusters.
  • Promoted --cluster-config flag of gcloud bigtable instances create to beta and GA.
  • Promoted gcloud bigtable instances tables describe to beta and GA.

Cloud Firestore Emulator

  • Release Cloud Firestore emulator v1.11.13
    • Reset document create time when a document is deleted and re-created in a single transaction.

Compute Engine

  • Promoted the following flags in gcloud compute backend-services create, gcloud compute backend-services update, gcloud compute backend-buckets create and gcloud compute backend-buckets update to GA:
    • --[no-]negative-caching
    • --[no-]negative-caching-policy
    • --[no-]serve-while-stale
    • --[no-]bypass-cache-on-request-headers
  • Added the following fields to gcloud compute backend-services import and gcloud compute backend-services export:
    • cdnPolicy:
    • negativeCaching
    • negativeCachingPolicy
    • bypassCacheOnRequestHeaders
    • serveWhileStale
  • Added support for authorizationPolicy and serverTlsPolicy for gcloud compute target-https-proxies import command.
  • Added --iap-tunnel-disable-connection-check flag to gcloud compute start-iap-tunnel to disable the initial connection check in alpha and beta.
  • Promoted gcloud compute public-delegated-prefixes to GA.
  • Added --network-interface=nic-type flag to gcloud compute instance-templates create for beta and GA.
  • Promoted --image-family-scope flag to gcloud beta compute instances create and gcloud beta compute disks create.

Policy Simulator

  • Added gcloud iam simulator replay-recent-access which simulates policy changes by replaying policy overlay on recent access.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

334.0.0 (2021-03-30)

Breaking Changes

  • (Cloud Build) Modified the positional argument WORKER_POOL to be required for commands in the command group gcloud builds worker-pools (except for gcloud builds worker-pools list).
  • (Cloud Run) Deprecated --connectivity flag of gcloud run deploy and gcloud run services update. --connectivity will continue to be supported. --connectivity only applies to --platform=gke and --platform=kubernetes. The new --ingress flag applies to all platforms and provides equivalent functionality. Prefer to use --ingress. Use --ingress=all in place of --connectivity=external. Use --ingress=internal in place of --connectivity=internal.
  • (Dataproc Metastore) Deprecated gcloud beta metastore services imports command group. Use gcloud beta metastore services import command group instead.

Cloud SDK

  • Cloud SDK supports Apple Silicon. Some native components currently rely on Rosetta 2.

AI

  • Modified --region flag of gcloud beta ai endpoints to include new online prediction regions.
  • Modified --region flag of gcloud beta ai models to include new online prediction regions.

BigQuery

  • Added --max_concurrency flag to mk and update reservation commands.
  • Added --parquet_enum_as_string and --parquet_enable_list_inference flags to load and mk --table commands for Parquet format. Run bq load --help or bq mk --help for details.
  • Removed old oauth2client_4_0 compatibility shim.

Cloud On Demand Scanning

  • Promoted the On-Demand Scanning API commands to GA.
    • gcloud artifacts docker images scan to scan a container image.
    • gcloud artifacts docker images get-operation to retrieve an operation.
    • gcloud artifacts docker images list-vulnerabilities to retrieve scan results.
  • Improved error messages for local-extract.

Cloud Run

  • Promoted --ingress flag of gcloud run deploy and gcloud run services update to GA.

Cloud SQL

  • Promoted Active Directory integration to beta.

Cloud Security Command Center

  • Updated the following commands to support project/folder parent types:
    • gcloud scc findings create
    • gcloud scc findings group
    • gcloud scc findings list
    • gcloud scc findings list-marks
    • gcloud scc findings update
    • gcloud scc findings update-marks
    • gcloud scc assets describe
    • gcloud scc assets group
    • gcloud scc assets list
    • gcloud scc assets list-marks
    • gcloud scc assets update-marks
  • Assets and findings will now have canonicalName field in their response.

Compute Engine

  • Added --service-account, --no-service-account, --scopes and --no-scopes flags to gcloud beta compute instances import.
  • Added --service-directory-registration flag to gcloud compute forwarding-rules create --global --target-google-apis-bundle=<bundle> in beta and GA.
  • Added --target-google-apis-bundle to gcloud compute forwarding-rules create.
  • Added PRIVATE_SERVICE_CONNECT as a global address purpose to gcloud compute addresses create.
  • Promoted --post-key-reservation-action-type flag to beta for gcloud compute instances create.
  • Promoted --post-key-reservation-action-type flag to beta for gcloud compute instance-templates create.
  • Added --resource-policies flag for gcloud compute instance-templates create command in alpha, beta, and GA.
  • Added --service-account, --no-service-account, --scopes and --no-scopes flags for gcloud compute machine-images import in beta.
  • Fixed failure to pipe into ssh when --internal-ip flag is specified.
  • Added gcloud compute target-https-proxies import method which creates or updates a target HTTPS proxy resource in Compute Engine
  • Promoted gcloud compute public-advertised-prefixes to GA.

Config Connector

Database Migration

  • Launched Database Migration.

Dataproc Metastore

  • Added --dump-type flag to gcloud beta metastore services export gcs to allow specification of the database dump type to export.
  • Added --release-channel flag to gcloud beta metastore services create.
  • Added the following commands to work with Dataproc Metastore services:
    • gcloud beta metastore services import
    • gcloud beta metastore services restore
    • gcloud beta metastore services backups describe
    • gcloud beta metastore services backups list
    • gcloud beta metastore services backups create
    • gcloud beta metastore services backups delete
  • Promoted gcloud metastore to GA.

Secret Manager

  • Added --next-rotation-time flag to gcloud beta secrets create, gcloud secrets create gcloud beta secrets update and gcloud secrets update commands to specify the timestamp at which to send SECRET_ROTATE notification.
  • Added --rotation-period flag to gcloud beta secrets create, gcloud secrets create gcloud beta secrets update and gcloud secrets update commands to specify a duration between secret rotation notifications.
  • Added --remove-next-rotation-time flag to gcloud beta secrets update and gcloud secrets update command to remove scheduled rotation time from a secret if it has one.
  • Added --remove-rotation-period flag to gcloud beta secrets update and gcloud secrets update command to remove a set rotation period if it has one.
  • Added --remove-rotation-schedule flag to gcloud beta secrets update and gcloud secrets update command to remove the rotation policy from a secret if it has one.
  • Promoted --expire-time flag of gcloud secrets create and gcloud secrets update to GA.
  • Promoted --ttl flag of gcloud secrets create and gcloud secrets update to GA.
  • Promoted --remove-expiration flag of gcloud secrets update to GA.
  • Promoted --topics flag of gcloud secrets create to GA.
  • Promoted the following flags to GA for gcloud secrets update:
    • --add-topics
    • --remove-topics
    • --clear-topics

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

333.0.0 (2021-03-23)

Cloud SDK

  • --impersonate-service-account flag can accept a list of service accounts for impersonation delegation.

Assured Workloads

  • Added --resource-settings flag to gcloud assured workloads create command.
  • Added US_REGIONAL_ACCESS as compliance regime option for gcloud assured workloads create command.
  • Added HIPAA and HITRUST as compliance regime options for gcloud assured workloads create command.

Cloud Build

  • Updated gcloud builds submit and gcloud builds log to tell users when they cannot read the default logs bucket because of VPC-SC.

Cloud Dataflow

  • Added flex template docker container building support for python in build command gcloud beta dataflow flex-template build.

Cloud Dataproc

  • Added gcloud dataproc clusters stop and gcloud dataproc clusters start which stop and start clusters.
  • Promoted --dataproc-metastore flag of gcloud dataproc clusters create to GA.
  • Promoted --dataproc-metastore flag of gcloud dataproc workflow-templates set-managed-cluster to GA.
  • Added --secure-multi-tenancy-user-mapping and --identity-config-file flags to gcloud dataproc clusters create and gcloud dataproc workflow-templates set-managed-cluster.

Cloud Logging

  • Promoted gcloud logging views command group to GA.

Cloud On Demand Scanning

  • Improved error messages for local-extract.

Cloud Pub/Sub

  • Added --starting-offset flag to gcloud pubsub lite-subscriptions create to allow subscriptions to be created at HEAD.

Cloud Storage

  • Updated gsutil component to 4.60.

Compute Engine

  • Fixed gcloud compute url-maps import for correctly removing top-level properties of an existing Url map, when they are not specified in the YAML file.
  • Updated import and export schemas for:
    • gcloud compute forwarding-rules.
    • gcloud compute backend-services.
  • Added --compute-service-account flag for gcloud compute instances import in beta.
  • Added --compute-service-account flag for gcloud compute machine-images import in beta.
  • Promoted --description and --family flags of gcloud compute images update to GA.
  • Promoted the following flags in gcloud compute instance-groups managed set-autoscaling to GA:
    • --set-schedule
    • --schedule-cron
    • --schedule-duration-sec
    • --schedule-min-required-replicas
    • --schedule-time-zone
    • --schedule-description For more information see <https://cloud.google.com/compute/docs/autoscaler/scaling-schedules>.
  • Promoted the following flags in gcloud compute instance-groups managed update-autoscaling to GA:
    • --min-num-replicas
    • --max-num-replicas
    • --set-schedule
    • --update-schedule
    • --disable-schedule
    • --enable-schedule
    • --remove-schedule
    • --schedule-cron
    • --schedule-duration-sec
    • --schedule-min-required-replicas
    • --schedule-time-zone
    • --schedule-description For more information see <https://cloud.google.com/compute/docs/autoscaler/scaling-schedules>.

Config Connector

Kpt

  • Updated kpt from v0.37.1 to v0.38.1.
  • Updated import of cli-utils from v0.21.1 to v0.23.5.
  • Updated import of kyaml from v0.9.5 to v0.10.13.
  • Updated import of cmd/config from v0.8.5 to v0.9.5.

Miscellaneous

  • Reordered contents of help text pages to make "Examples" section more prominent.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

332.0.0 (2021-03-16)

Breaking Changes

  • (App Engine) Updated backend when using gcloud app deploy <queue|cron>.yaml. The only noticeable change is that when removing queues from the queues YAML file, previously the queues were marked as "DISABLED" but now they are marked "PAUSED". In terms of functionality, there is no difference between the two.

Cloud SDK

  • Added support for environment variable CLOUDSDK_ENCODING to set the IO encoding for gcloud. UTF-8 will be the default IO encoding on Unix.

App Engine

Artifact Registry

  • Promoted PyPI repo creation with gcloud artifacts repositories create to beta and GA.
  • Promoted gcloud artifacts print-settings pypi to beta and GA.

Cloud Dataflow

  • Added default runtime environment parameters support in gcloud dataflow flex-template build.

Cloud Functions

  • Promoted --security-level flag of gcloud functions deploy to GA.
  • Modified --limit of gcloud functions logs read such that the most recent entries in the given time range up to the limit are returned rather than the earliest.

Cloud Org Policy

  • Promoted gcloud org-policies command group to GA.

Cloud Run

  • Promoted --tag flag of gcloud run deploy to GA.
  • Promoted --tag flag of gcloud run services update to GA.
  • Promoted --to-tags, --set-tags, --update-tags, --remove-tags, and --clear-tags flags of gcloud run services update-traffic to GA.

Cloud Spanner

  • Promoted CMEK flags to beta and GA in gcloud spanner commands.

Compute Engine

  • Added --byol flag for:
    • gcloud compute images import in beta
    • gcloud compute instances import in beta
    • gcloud compute machine-images import in beta
  • Promoted gcloud compute instances remove-resource-policies command to GA.
  • Added --boot-disk-provisioned-iops to gcloud compute instances create and gcloud compute instance-templates create to allow specifying provisioned IOPS for attached disks.
  • Promoted gcloud compute instances create --network-performance-configs flag to beta.
  • Promoted gcloud compute instances bulk create to beta and GA.

Dataproc Metastore

  • Added --database-dump-type flag to gcloud beta metastore services imports create to set the database dump type.
  • Deprecated --database-type flag gcloud beta metastore services imports create. Use --database-dump-type flag to specify the database dump type.
  • Added gcloud beta metastore services imports update which updates a metadata import.
  • Added --data-catalog-sync flag for gcloud metastore services in beta.

Identity Groups

  • Added --group-type flag to gcloud identity groups create to automatically set group labels based on the type of group being created.

Kubernetes Engine

  • Promoted --enable-l4-ilb-subsetting of gcloud container clusters create and gcloud container clusters update to beta.
  • Added --node-labels, --node-taints, and --tags flags to gcloud beta container node-pools update to update the node labels, node taints and network tags on an existing node pool.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

331.0.0 (2021-03-09)

AI

  • Added --autoscaling-metric-specs flag to gcloud beta ai endpoints deploy-model.

App Engine

  • Updated gcloud app instances list and gcloud app instances describe to return the auto healer health check (i.e. liveness) for the flexible environment.

Assured Workloads

  • Promoted gcloud assured command group to GA. Commands in this group provide the ability to read and modify Assured data controls.
  • Promoted gcloud assured workloads command group to GA. Commands in this group provide the ability to manage Assured Workloads environment resources.
  • Promoted gcloud assured operations command group to GA. Commands in this group provide the ability to view Assured Workloads operation resources.

Cloud Build

  • Fixed issue where gcloud beta builds worker-pools commands fail to wait for long-running operations to finish.

Cloud Dataproc

  • Added a confirmation prompt to gcloud datapoc clusters enable-personal-auth-session and gcloud beta datapoc clusters enable-personal-auth-session.

Cloud Healthcare

  • Promoted gcloud healthcare consent-stores to GA.

Cloud On Demand Scanning

  • Updated the local-extract component to version 0.1.5, to improve error handling in certain cases.

Cloud Resource Manager

  • Updated gcloud resource-manager org-policies describe to throw an error for unsupported policy versions.

Cloud Run

  • Promoted --min-instances flag of gcloud run deploy and gcloud run services update to GA for --platform=managed.

Cloud Services

  • Support service usage check on gcloud services disable command.

Compute Engine

  • Promoted --provisioned-iops flag of gcloud compute disks create to GA.
  • Promoted gcloud compute public-delegated-prefixes to beta.

Config Connector

Identity and Access Management

  • Added gcloud iam workload-identity-pools which enables granting on-premises or multi-cloud workloads access to Google Cloud resources, without using a service account key.

Kubernetes Engine

  • Added gcloud container clusters create-auto for creating Autopilot clusters to the beta and GA tracks.

Network Management

  • Added IPv6 support for Network Load balancers to gcloud compute forwarding-rules command group.

Secret Manager

  • Promoted gcloud secrets replication command group to GA.
  • Added --replication-policy-file flag to gcloud secrets create command to specify replication policy using a JSON or YAML file.
  • Added --kms-key-name flag to gcloud secrets create command to specify a KMS key when creating an automatic secret.

VPC Access

  • Promoted VPC connector --subnet flag from beta to GA.
  • Modified gcloud compute networks vpc-access connectors create to accept an optional --subnet flag to specify a subnet to house the connector rather than requiring --network and --range flags.
    • If the provided subnet is a shared subnet, use the flag --subnet-project to specify the VPC host project ID.

Workspace Add Ons

  • Promoted gcloud workspace-add-ons commands to GA.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

330.0.0 (2021-03-02)

Breaking Changes

  • (Cloud Code) Downgraded --env-vars and --env-vars-file to alpha.

Cloud SDK

  • Added bundled Python 3 option for macOS installations. See gcloud topics startup and https://cloud.google.com/sdk/docs/install#mac.
  • Fixed issue where gcloud emulators ... start commands would leave behind emulator processes when Ctrl+C was pressed.

Cloud Dataproc

  • Added --cluster-labels flag to gcloud dataproc jobs submit to allow jobs to be placed on a cluster matching specified cluster labels.

Cloud Healthcare

  • Added --filter-config-gcs-uri flag to the following commands:
    • gcloud beta healthcare dicoms-stores export gcs
    • gcloud beta healthcare dicoms-stores export bq

Cloud On Demand Scanning

  • Updated some error messages to be more clear.
  • Added a prompt to the beginning of gcloud beta artifacts docker images scan to install the local-extract component.

Cloud Pub/Sub

  • Promoted --partitions flag in gcloud pubsub lite-topics update to GA.
  • Added --view flag to gcloud beta schemas list to allow retrieval of schema definitions.

Cloud Run

  • Fixed bug on force-override prompt for gcloud beta run domain-mappings create where it would fail to re-create the domain mapping after deleting the one without the override.

Compute Engine

  • Promoted gcloud compute public-advertised-prefixes to beta.
  • Added --request-coalescing to gcloud beta compute backend-services create, gcloud beta compute backend-services update, gcloud beta compute backend-buckets create and gcloud beta compute backend-buckets update.
  • Promoted support for gce-vm-ip for --network-endpoint-type for gcloud compute network-endpoint-groups create and gcloud compute network-endpoint-groups update to GA.

Config Connector

Kubernetes Engine

  • Added --pod-ipv4-range and --create-pod-ipv4-range flags to gcloud beta container node-pools create to configure pod ranges for the node pools.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

329.0.0 (2021-02-23)

Breaking Changes

  • (Container Registry) Fixed issue where gcloud containers images list-tags doesn't show occurrence metadata.

AI

  • Added --network and --service-account to gcloud beta ai <custom-jobs|hp-tuning-jobs> create to allow specifying a peering network and user service account.

Cloud Asset Inventory

  • Added --relationship-type flag to gcloud beta asset export.

Cloud Code

  • Promoted gcloud code dev and gcloud code clean-up to beta.

Cloud Composer

  • Added --kms-key flag to gcloud composer environments command to specify the Customer-managed KMS key name to use for encrypting the Composer environment.

Cloud Functions

  • Fixed a performance issue in gcloud functions logs read by adding a default value of 1 week ago for --start-time.

Cloud Memorystore

  • Added --transit-encryption-mode flag to gcloud redis instances create to allow enabling Redis TLS with server authentication when creating a new instance.
  • Modified --region flag to be optional in gcloud memcache. If not specified, use the value in memcache/region property.

Cloud Pub/Sub

  • Added gcloud beta pubsub schemas validate-schema to allow validation of PROTOCOL_BUFFER and AVRO schemas.
  • Added gcloud beta pubsub schemas validate-message to allow validation of messages against an existing or inline schema.

Compute Engine

  • Promoted --provisioned-iops flag of gcloud compute disks create to beta.
  • Promoted gcloud compute url-maps validate to GA.
  • Promoted labels-related flags for gcloud compute forwarding-rules update to GA.
  • Modified --short-name of gcloud compute firewall-policies create to be a required flag.
  • Promoted --proxy-bind flag of gcloud compute target-tcp-proxies create to GA.
  • Allow --target-tcp-proxy for gcloud compute forwarding-rules create and set-target with specified -load-balancing-scheme=INTERNAL_SELF_MANAGED.
  • Added functionality in gcloud beta compute images import to import images from AWS.
  • Promoted gcloud compute resource-policies create instance-schedule command to GA.

Identity Groups

  • Added --dynamic-user-query flag to gcloud identity update.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

328.0.0 (2021-02-16)

Breaking Changes

  • (App Engine) Changed error message for Permissions error fetching application to indicate which account might be missing roles/appengine.deployer.
  • (Miscellaneous) Added support for colored output using ANSI escape sequences on modern versions of Windows. Use gcloud config set disable_color true to disable this behavior.

App Engine

Artifact Registry

  • Modified gcloud artifacts docker images describe to group vulnerability occurrences by effective severity instead of severity.

BigQuery

  • Expose json_extension flag in CLI which can be used to load newline-delimited GeoJSON files (in combination with source_format=NEWLINE_DELIMITED_JSON).

Cloud Composer

  • Modified --image-version and --airflow-version flags of gcloud beta composer environments update to be mutually exclusive.
  • Added the following flags to gcloud composer environments create and gcloud composer environments update to manage machine types for web server and Cloud SQL:
    • --cloud-sql-machine-type
    • --web-server-machine-type

Cloud Logging

  • Promoted the gcloud alpha logging tail command to beta.

Cloud Memorystore

  • Promoted gcloud memcache to GA.
  • Added apply-software-update command to apply latest available software update to Memcached instance and nodes.

Cloud Pub/Sub

  • Added gcloud pubsub schemas to beta which allows creating and managing schemas. Schemas can be used to validate messages published to Cloud Pub/Sub topics.
  • Added --schema and --message-encoding flags to gcloud beta pubsub topics create. Messages published to the topic with the given message encoding will be validated against the specified schema.
  • Added --partitions flag to gcloud beta pubsub lite_topics update to allow increasing partitions in a Pub/Sub Lite topic.

Cloud SQL

  • Added --secondary-zone flag to gcloud sql instances <create|patch> that allows users to choose the secondary zone during create|patch of High Availability instances.

Cloud Spanner

  • Added --version-time flag to gcloud spanner backups create to allow specifying the timestamp of the data contained in the backup.
  • Added version time to the output of gcloud spanner backups list.
  • Added version retention period and earliest version time to the output of gcloud spanner databases list.

Cloud Spanner Emulator

  • Promoted gcloud emulators spanner to GA.

Cloud Storage

  • Updated gsutil component to 4.59.

Cloud TPU

  • Promoted gcloud compute tpus execution-groups to GA. Commands in this group allow convenient orchestration of TPU nodes and Compute VMs. This replaces the standalone tool ctpu.

Compute Engine

  • Promoted --provisioned-iops flag of gcloud compute disks create to beta.
  • Promoted gcloud compute url-maps validate to GA.
  • Promoted labels-related flags for gcloud compute forwarding-rules update to GA.

Config Connector

Container Analysis

  • Modified gcloud container images describe to group vulnerability occurrences by effective severity instead of severity.

Identity Groups

  • Promoted --dynamic-user-query flag of gcloud identity create to GA.

Kubernetes Engine

  • Promoted --notification-config of gcloud container clusters <create|update> to GA. This flag is used to enable notifications on a cluster. Currently Pub/Sub notifications are supported.
  • Node System Config is now GA. Added --system-config-from-file flag to gcloud container clusters create, gcloud container node-pools create, and gcloud node-pools update to configure kubelet and Linux configuration settings on nodes.

Pubsub Emulator

  • Added schema support to the Pub/Sub emulator, which allows the association of topics with schemas and the validation of published messages against them.

Secret Manager

  • Added --topics flag to gcloud beta secrets create command to specify a list of Pub/Sub topics to configure on the secret.
  • Added --add-topics flag to gcloud beta secrets update command to specify a list of Pub/Sub topics to add to the secret.
  • Added --remove-topics flag to gcloud beta secrets update command to specify a list of Pub/Sub topics to remove from the secret.
  • Added --clear-topics flag to gcloud beta secrets update command to remove all Pub/Sub topics from the secret.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

327.0.0 (2021-02-09)

AI

  • Added KMS args (--kms-project, --kms-location, --kms-keyring, --kms-key) to gcloud <alpha|beta> ai custom-jobs create and gcloud <alpha|beta> ai hp-tuning-jobs create to allow specifying a customer-managed encryption key.

App Engine

Artifact Registry

  • Fixed a bug that prevented users from creating an encrypted repository with a custom kms key.

Cloud DNS

  • Added gcloud beta dns response-policies create to create a new Cloud DNS response policy.
  • Added gcloud beta dns response-policies update to update a Cloud DNS response policy.
  • Added gcloud beta dns response-policies list to list all Cloud DNS response policies in a given project.
  • Added gcloud beta dns response-policies describe to describe details of a Cloud DNS response policy.
  • Added gcloud beta dns response-policies delete to delete a Cloud DNS response policy.

Cloud Functions

  • Promoted --security-level flag of gcloud functions deploy to beta.
  • Added support for google.firebase.remoteconfig.update as an event type. The full set of supported event types can be listed using gcloud functions event-types list.

Cloud Healthcare

  • Added --write-disposition flag to the following commands:
    • gcloud healthcare fhir-stores export bq
    • gcloud beta healthcare fhir-stores export bq
    • gcloud beta healthcare dicom-stores export bq
    • gcloud beta healthcare annotation-stores export bq
    • gcloud beta healthcare annotation-stores evaluate bq

Cloud Logging

  • Promoted the following commands that support Logs Buckets to GA:
    • gcloud logging buckets
    • gcloud logging read
    • gcloud logging locations describe
    • gcloud logging locations list
    • gcloud logging sinks
    • gcloud logging cmek-settings
  • Promoted --location, --bucket, and --view of gcloud logging read to GA.
  • Promoted --description and --log-filter of gcloud logging metrics to GA.
  • Promoted --use-partitioned-tables of gcloud logging sinks to GA.

Compute Engine

  • Added support for short-name=windows for --os-type flag for gcloud beta compute instances ops-agents policies. This is only valid when --agent-rules=type=ops-agent.
  • Promoted --cpu-utilization-predictive-method flag of gcloud compute instance-groups managed <set-autoscaling|update-autoscaling> to beta.
  • Added support for --asn flag for gcloud compute routers update.
  • Promoted gcloud compute security-policies update to beta.
  • Added --enable-layer7-ddos-defense flag and --layer7-ddos-defense-rule-visibility flag to gcloud beta compute security-policies update.

Events

  • Added --authentication flag to gcloud events init command.
  • Added --authentication flag to gcloud events namespaces init command.
  • Added workload-identity-gsa support to --authentication flag for gcloud events init command.
  • Modifed gcloud events namespaces init command to create namespace if it is missing.

Identity Groups

  • Added --labels flag to gcloud identity groups update to allow updating the labels for a group.

Identity Groups Memberships

  • Promoted --expiration flag of gcloud identity groups memberships add to GA.
  • Promoted --update-roles-param flag of gcloud identity groups memberships modify-membership-roles to GA.

Kubernetes Engine

  • Adds new kubectl delegate version 1.19.7 for rapid channel
  • Updated default kubectl version from 1.17.14 to 1.17.17
  • Additional kubectl delegate versions:
    • kubectl.1.15 (1.15.12)
    • kubectl.1.16 (1.16.15)
    • kubectl.1.17 (1.17.17)
    • kubectl.1.18 (1.18.15)
  • Corrected passing URIs and full resource names to work with paths in the form projects/<project>/locations/<location> (in addition to the deprecated form projects/<project>/zones/<location>).

Pubsub Emulator

  • Added retry policy feature to the emulator.
  • Updated emulator to deliver dead lettered messages to original subscription in case of publishing failure to dead letter topic.
  • Added subscription name, project name, and publish time properties to dead lettered messages.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

326.0.0 (2021-02-02)

App Engine

  • Updated backend when using gcloud app deploy <queue|cron>.yaml. The only noticeable change is that when removing queues from the queues YAML file, previously the queues were marked as "PAUSED" but now they are marked "DISABLED". In terms of functionality, there is no difference between the two.

Artifact Registry

  • Fixed issue where gcloud docker images delete failed if the image is referenced by a tag.

Cloud Asset Inventory

  • Added new searchable fields (kmsKey, state, createTime and updateTime) to gcloud asset search-all-resources.

Cloud Composer

  • Added gcloud beta composer environments run my-environment upgrade_check to run upgrade check to Airflow 2.0 for Composer environments with Airflow 1.10.14+.
  • Added support of CLI commands for Airflow 2.0 to gcloud beta composer environments run.

Cloud Dataflow

  • Added streaming update and flexrs support to flex-template run command gcloud dataflow flex-template run.
  • Updated gcloud dataflow sql query command to use Dataflow Flex Templates.
  • Added --additional-experiments flag to gcloud beta dataflow jobs run.
  • Added --additional-experiments flag to gcloud dataflow jobs run.

Cloud Firestore Emulator

  • Release Cloud Firestore emulator v1.11.12
    • Fix onCreate/onWrite events triggering when deleting nonexistent documents.

Cloud On Demand Scanning

  • Launched commands for the On-Demand Scanning API in the Artifact Registry command group.
    • gcloud beta artifacts docker images scan to scan an image.
    • gcloud beta artifacts docker images get-operation to poll an ongoing scan.
    • gcloud beta artifacts docker images list-vulnerabilities to retrieve scan results.
  • Introduced a new component called local-extract to aid in the commands for the On-Demand Scanning API.

Compute Engine

  • Added --compute-service-account to gcloud beta compute images import.
  • Changed --os flag to be optional for gcloud compute images import.
  • Added --enable-nested-virtualization flag to enable or disable nested virtualization to both beta and GA for:
    • gcloud compute instances create
    • gcloud compute instances create-with-container
    • gcloud compute instance-templates create
  • Fixed issue where policies created or updated via gcloud beta compute instances ops-agents policies [create|update] that included short-name values of 'debian' or 'ubuntu' in --os-types had trouble locating packages due to a missing call to apt-get update.
  • Updated Windows PuTTY executables to version 0.74.

Config Connector

Eventarc

  • Promoted gcloud eventarc triggers to GA. Renamed --matching-criteria flag as --event-filters in GA.
  • Promoted gcloud eventarc locations to GA.

GKE Hub

  • Promoted gcloud container hub memberships register --enable-workload-identity --public-issuer-url=$URL to GA.

Notebooks

  • Promoted gcloud notebooks to GA.

VPC Access

  • Added --machine-type to gcloud beta compute networks vpc-access connectors create to support machine type configuration of the managed instance group underlying the connector.
  • Added --min-instances and --max-instances to gcloud beta compute networks vpc-access connectors create to allow users to configure the scaling bounds of the underlying managed instance group.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

325.0.0 (2021-01-26)

Breaking Changes

  • (Compute Engine) Modified enable-autoupgrade field belonging to flag --agent-rules in gcloud beta compute instances ops-agents policies create and gcloud beta compute instances ops-agents policies update from optional to required.
  • (Container Registry) Updated gcloud container images list-tags and gcloud container images describe to use ContainerAnalysis V1 API in beta.
    • Changed occurrence kind PACKAGE_VULNERABILITY to VULNERABILITY, DEPLOYABLE to DEPLOYMENT, BUILD_DETAILS to BUILD and IMAGE_BASIS to IMAGE. To construct filters on kinds, new names should be used. For example, kind="VULNERABILITY.
    • Occurrence kind names are changed in output accordingly.

App Engine

  • Updated backend when using gcloud app deploy <queue|cron>.yaml. The only noticeable change is that when removing queues from the queues YAML file, previously the queues were marked as "DISABLED" but now they are marked "PAUSED". In terms of functionality, there is no difference between the two.

Certificate Authority Service

  • Added --ignore-active-certificates flag to gcloud beta privateca roots delete and gcloud beta privateca subordinates delete to allow a Certificate Authority to be scheduled for deletion even if the Certificate Authority has un-revoked or un-expired certificates.

Cloud Composer

  • Added gcloud beta composer environments run my-environment upgrade_check to run upgrade check to Airflow 2.0 for Composer environments with Airflow 1.10.14+.

Cloud Storage

  • Updated gsutil component to 4.58.

Compute Engine

  • Promoted gcloud compute networks get-effective-firewalls command to GA.
  • Promoted gcloud compute instances network-interfaces get-effective-firewalls command to GA.
  • Promoted gcloud compute instance ops-agents to beta.
  • Promoted --compute-service-account flag to GA for gcloud compute images import.

Eventarc

  • Added --transport-topic flag to gcloud beta eventarc triggers create, to allow the use of an existing Pub/Sub topic for a trigger's transport intermediary.

Miscellaneous

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

324.0.0 (2021-01-19)

Breaking Changes

  • (Cloud Run) Updated gcloud run to require that --platform and --region be passed after all positional arguments. For example: gcloud run services describe SERVICE --platform=managed --region=us-central1. This change first appeared in version 322.0.0.

AI Platform

  • Added support for maxNodes to gcloud ai-platform versions update --config.
  • Added --bigquery-table-name and sampling-percentage to gcloud ai-platform versions update to update request logging config.

Cloud API Gateway

  • Promoted gcloud api-gateway to GA.

Cloud DNS

  • Promoted gcloud dns managed-zones to GA.
  • Added --service-directory-namespace to gcloud beta dns managed-zones create to support providing a Service Directory namespace that should be associated with the zone.

Cloud Machine Learning Engine

  • Added support for maxNodes to gcloud ml-engine versions update --config.
  • Added --bigquery-table-name and sampling-percentage to gcloud ml-engine versions update to update request logging config.

Cloud Run

  • For Cloud Run (fully managed), changed gcloud run services delete to wait until the service is no longer returned and account for the possibility of a deletion failing before reporting success. To use the previous behavior and exit without waiting for deletion to complete, use --async.

Cloud Speech API

  • Promoted --separate-channel-recognition and --audio-channel-count flags of gcloud ml speech recognize and gcloud ml speech recognize-long-running to GA.

Cloud Workflows

  • Added gcloud workflows and gcloud workflows executions commands to GA.

Compute Engine

  • Added --compute-service-account to gcloud beta compute images import.
  • Added the following flags to gcloud beta compute backend-services create, gcloud beta compute backend-services update, gcloud beta compute backend-buckets create and gcloud beta compute backend-buckets update:
    • --[no-]serve-while-stale
    • --[no-]bypass-cache-on-request-headers
  • Added the following fields to gcloud beta compute backend-services import and gcloud beta compute backend-services export:
    • cdnPolicy:
    • bypassCacheOnRequestHeaders
    • serveWhileStale
  • Promoted --compute-service-account flag to GA for gcloud compute images export.
  • Added org-firewall-policies command group.

Config Connector

Kpt

  • Updated kpt from v0.36.1 to v0.37.1.
  • Updated import of cli-utils from v0.21.0 to v0.21.1.
  • Updated import of kyaml from v0.9.3 to v0.9.5.
  • Updated import of cmd/config from v0.8.4 to v0.8.5.

Secret Manager

  • Added --expire-time flag to gcloud beta secrets create and gcloud beta secrets update commands to specify timestamp for the secret to expire.
  • Added --ttl flag to gcloud beta secrets create and gcloud beta secrets update commands to specify a duration until the secret should expire.
  • Added --remove-expiration flag to gcloud beta secrets update command to remove scheduled expiration from a secret if it has one.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

323.0.0 (2021-01-12)

Cloud Asset Inventory

  • Promote gcloud asset list command to beta.

Cloud Dataproc

  • Added --shielded-secure-boot, --shielded-vtpm, and --shielded-integrity-monitoring boolean flags to gcloud dataproc clusters create to allow users to configure Compute Engine Shielded VMs on Dataproc clusters.
  • Added --shielded-secure-boot, --shielded-vtpm, and --shielded-integrity-monitoring boolean flags to gcloud dataproc workflow-templates set-managed-cluster to allow users to configure Compute Engine Shielded VMs on Dataproc managed clusters.

Cloud Filestore

  • Added --description flag to gcloud beta filestore backups create command.

Cloud Run

  • Promoted --use-http2 flag to beta for Cloud Run (fully managed).

Config Connector

Identity Groups Memberships

  • Added gcloud identity groups memberships check-transitive-membership for ALPHA, beta and GA.
  • Added gcloud identity groups memberships get-membership-graph for ALPHA, beta and GA.
  • Added gcloud identity groups memberships search-transitive-groups for ALPHA, beta and GA.
  • Added gcloud identity groups memberships search-transitive-memberships for ALPHA, beta and GA.

Managed Active Directory

  • Added --enable-audit-logs flag to gcloud beta active-directory domains create and gcloud beta active-directory domains update.
  • Added AUDIT_LOGS_ENABLED parameter to gcloud beta active-directory domains list.
  • Added auditLogsEnabled parameter to gcloud beta active-directory domains describe.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

322.0.0 (2021-01-07)

Breaking Changes

  • (Miscellaneous) Updated --format=flattened and --format=text to print labels if provided. If a key is specified inside either of these formats but a label is not, the child key will be printed in lower snake case. This is different than done previously when the entire dotted key path was printed. Note that this change does not apply to keys whose values are objects or lists.
  • (Miscellaneous) If you would like to use the legacy version of --format=flattened or --format=text, set the following configuration: gcloud config set core/use_legacy_flattened_format true Please note that this option will not be supported indefinitely.

Cloud API Gateway

  • Promote support for gRPC scoped api-config configurations via grpc-files flag to beta.

Cloud Composer

  • Added --max-pods-per-node option to gcloud beta environment create operation. It allows to limit the number of pods that can be assigned to a single GKE node and reduce the size of IP range assigned to it.
  • Added maintenance window flags for environment creation:
    • --maintenance-window-start
    • --maintenance-window-end
    • --maintenance-window-recurrence.
  • Added maintenance window flags for environment update:
    • --maintenance-window-start
    • --maintenance-window-end
    • --maintenance-window-recurrence
    • --clear-maintenance-window.
  • Added gcloud beta composer environments restart-web-server to restart web server for a Cloud Composer environment.

Cloud Dataflow

  • Added --enable-streaming-engine flag to gcloud beta dataflow jobs run.
  • Added --enable-streaming-engine flag to gcloud dataflow jobs run.

Cloud Filestore

  • Promoted nfs-export-options key of --file-shares flag in gcloud filestore instances to GA.

Cloud Run

  • Fixed an issue with using --clear-vpc-connector when deploying new services.

Compute Engine

  • Promoted --mtu flag to beta and GA for gcloud compute interconnects attachments <dedicated|partner> <create|update>.
  • Changed --os flag to be optional for:
    • gcloud compute images import in beta
    • gcloud compute instances import in beta
    • gcloud compute machine-images import in beta
  • Promoted --maintenance-window-start-time flag in gcloud compute sole-tenancy node-groups create command to GA.
  • Added --compute-service-account to gcloud compute images export in beta.
  • Added --service-directory-registration to gcloud compute forwarding-rules create in beta.
  • Promoted --no-address flag to GA for gcloud compute images import.

Config Connector

Eventarc

  • Added gcloud beta eventarc locations list which lists locations available for Eventarc.

Miscellaneous

  • Updated gcloud to not attempt reauthentication if running in non-interactive mode.

Service Directory

  • Promoted gcloud service-directory locations to beta. Added a commands to describe/list locations.
  • Promoted gcloud service-directory namespaces to GA. Added commands to create/delete/describe/list/update/add-iam-policy-binding/get-iam-policy/set-iam-policy/remove-iam-policy-binding.
  • Promoted gcloud service-directory services to GA. Added commands to create/delete/describe/list/resolve/update/add-iam-policy-binding/get-iam-policy/set-iam-policy/remove-iam-policy-binding.
  • Promoted gcloud service-directory endpoints to GA. Added commands to create/delete/describe/list/resolve/update.
  • Updated --metadata flag to --annotations flag in GA only.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

321.0.0 (2020-12-15)

Breaking Changes

  • (Dataproc Metastore) Renamed gcloud beta metastore services update --kerberos_principal flag as --kerberos-principal.

Cloud SDK

  • Added new regions for Artifact Registry: europe-west5, asia-northeast3, us-west3, us-west4, asia-southeast2.

AI

  • Added parameters args and command to gcloud beta ai custom-jobs create which provides ability to pass the parameters to containers or python tasks.

Cloud Access Context Manager

  • Added ingress-policies and egress-policies optional flags to the following commands:
    • gcloud beta access-context-manager perimeters create.
    • gcloud beta access-context-manager perimeters update.
    • gcloud beta access-context-manager perimeters dry-run create.
    • gcloud beta access-context-manager perimeters dry-run update.
  • The ingress-policies and egress-policies flags accept paths to yaml files. The content of the yaml files should contain valid representations of IngressPolicies and EgressPolicies.
  • Added support for displaying the contents of Ingress and EgressPolicies for following commands:
    • gcloud beta access-context-manager perimeters describe.
    • gcloud beta access-context-manager perimeters dry-run describe.

Cloud Composer

  • Added the following flags to gcloud composer environments create to manage Airflow web server network access control:
    • --web-server-allow-ip
    • --web-server-deny-all
    • --web-server-allow-all
  • Added the following flags to gcloud composer environments update to manage Airflow web server network access control:
    • --update-web-server-allow-ip
    • --web-server-deny-all
    • --web-server-allow-all

Cloud Dataproc

  • Promoted --dag-timeout flag of gcloud dataproc workflow-templates create to GA.
  • Promoted gcloud dataproc workflow-templates set-dag-timeout to GA.
  • Promoted gcloud dataproc workflow-templates remove-dag-timeout to GA.
  • Added gcloud beta dataproc clusters stop and gcloud beta dataproc clusters start commands to enable stopping and starting Dataproc clusters.

Cloud Firestore Emulator

  • Release Cloud Firestore emulator v1.11.11
    • Fix listCollectionId not returning collections with nested docs.
    • Fix listDocuments with showMissing returning 500 errors.

Cloud Run

  • Added multitenancy support to gcloud run commands https://cloud.google.com/run/docs/gke/multi-tenancy.
  • Promoted --vpc-egress flag of gcloud run deploy and gcloud run services update to GA.
  • Promoted --ingress flag of gcloud run deploy and gcloud run services update to beta.

Cloud SQL

  • Promoted --type flag of gcloud sql users create to GA to support the creation of Cloud SQL database users for login using IAM database authentication.

Cloud Services

  • Promoted gcloud services peered-dns-domains <create|delete|list> to GA.
  • Promoted gcloud services vpc-peerings <enable-vpc-service-controls|disable-vpc-service-controls> to GA.

Cloud Storage

  • Updated gsutil component to 4.57.

Compute Engine

  • Removed centos-6 option from --os flag for gcloud compute images import, gcloud compute instances import, and gcloud compute machine-images import.
  • Promoted TrafficDirector proxyBind property to v1 for:
    • gcloud compute target-http-proxies import
    • gcloud compute target-http-proxies export
    • gcloud compute target-https-proxies import
    • gcloud compute target-https-proxies export
  • Added no-address flag to:
    • gcloud beta compute images import
    • gcloud beta compute machine-images import
  • Promoted --disk and --accelerator flags in gcloud compute sole-tenancy node-templates create command to GA.
  • Added --shielded-vtpm, --shielded-secure-boot, and --shielded-integrity-monitoring flags to gcloud compute instances create-with-container command.
  • Added --shielded-vtpm, --shielded-secure-boot, and --shielded-integrity-monitoring flags to gcloud compute instance-templates create-with-container command.
  • Added --shielded-vtpm, --shielded-secure-boot, --shielded-integrity-monitoring, and --shielded-learn-integrity-policy flags to gcloud compute instances update-container command.
  • Promoted the following flags in gcloud compute backend-services create, gcloud compute backend-services update, gcloud compute backend-buckets create and gcloud compute backend-buckets update to GA:
    • --cache-mode
    • --[no-]client-ttl
    • --[no-]default-ttl
    • --[no-]max-ttl
    • --[no-]custom-response-header
  • Added the following fields to gcloud compute backend-services import and gcloud compute backend-services export:
    • customResponseHeader
    • cdnPolicy:
    • cacheMode
    • clientTtl
    • defaultTtl
    • maxTtl

Events

  • Added URI support to --target-service of gcloud events triggers create.
  • Modify --type flag of gcloud events triggers create to be optional for ApiServerSource.

Kubernetes Engine

  • Added --addons=GcePersistentDiskCsiDriver to gcloud container clusters create and --update-addons=GcePersistentDiskCsiDriver to gcloud container clusters update to enable/disable the GCP Compute Persistent Disk Container Storage Interface (CSI) Driver.

Miscellaneous

  • Informational messages printed during installation are now printed to stderr, rather than stdout.

Pubsub Emulator

  • Added dead letter queue feature to the emulator.

Transcoder

  • Promoted gcloud transcoder to beta.

VPC Access

  • Added a new subnet flag to gcloud compute networks vpc-access connectors create which can be used to specify a subnet to house the connector rather than specifying network and range flags.
    • If the provided subnet is a shared subnet, the flag subnet-project has been added to specify the host project id.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

320.0.0 (2020-12-08)

AI Platform

  • Updated the following command groups to display a choice of available regions if a region hasn't been specified:

App Engine

  • Updated gcloud beta app instances list and gcloud beta app instances describe to return the auto healer health check (i.e. liveness) for the flexible environment.
  • Updated the Java SDK to version 1.9.84. Please visit the following release notes for details: https://cloud.google.com/appengine/docs/java/release-notes.

Assured Workloads

  • Change --next-rotation-time and --rotation-period flags of gcloud assured workloads create to be optional.
  • Add --provisioned-resources-parent flag to gcloud assured workloads create command.

BigQuery

  • Added schema to jobs.query dry run reply.
  • Supported bq partition command for HOUR/MONTH/YEAR time partitioning types.
  • Supported Avro logical types for creating new external tables.
  • Added PARQUET as option for export type. This feature is still experimental.

Cloud Asset Inventory

  • Added gcloud asset bulk-export command to beta which enables the user to export GCP resource configurations in Kubernetes Resource Model or Terraform formats.

Cloud Billing

  • Promoted gcloud billing budgets to GA.
    • Renamed all-updates-rule-* flags as notifications-rule-* flags in GA.

Cloud Build

  • Added flag --no-external-ip to gcloud beta builds worker-pools <create|update> commands.

Cloud Composer

  • Added --kms-key-name flag to gcloud beta composer environments command to specify the Customer-managed KMS key name to use for encrypting the Composer environment.

Cloud DNS

Cloud Dataproc

  • Added --max-failures-total flag to gcloud dataproc jobs submit to allow jobs to be restarted in event of a failure during job execution.

Cloud Filestore

  • Removed deprecation warning of --location flag from the gcloud filestore command group.
  • Added gcloud filestore operations cancel to cancel a Filestore operation.

Cloud Functions

Cloud Key Management Service

  • Added client-side request and response integrity verification to gcloud kms encrypt, gcloud kms decrypt, gcloud kms asymmetric-sign, gcloud kms asymmetric-decrypt in beta. For more information about Cloud KMS's integrity verification API, visit https://cloud.google.com/kms/docs/data-integrity-guidelines.
  • Added --skip-integrity-verification flag to gcloud kms encrypt, gcloud kms decrypt, gcloud kms asymmetric-sign, gcloud kms asymmetric-decrypt in beta.

Cloud Logging

  • Promoted the following commands that support Logs Buckets and Logs Views to beta:
    • gcloud logging buckets
    • gcloud logging sinks
    • gcloud logging read
    • gcloud logging locations
    • gcloud logging cmek-settings Logs Buckets are GA, while Logs Views and Regionalized Logs Buckets are in Preview.
  • Promoted --use-partitioned-tables of gcloud logging sinks to beta. BigQuery sinks with partitioned tables are GA.

Cloud Memorystore

  • Added --transit-encryption-mode flag to gcloud beta redis instances create to allow enabling Redis TLS with server authentication when creating a new instance.

Cloud Source Repositories

Cloud Spanner

  • Added --strong and --read-timestamp flags to gcloud spanner databases execute-sql to give more control over the timestamp of a read-only query.
  • Added throttling state to the output of gcloud spanner operations list.

Compute Engine

  • Promoted the following flags in gcloud compute instance-groups managed set-autoscaling to GA:
    • --stackdriver-metric-single-instance-assignment
    • --stackdriver-metric-utilization-target-type
    • --stackdriver-metric-utilization-target
    • --stackdriver-metric-filter
    • --update-stackdriver-metric
    • --remove-stackdriver-metric For more information see <https://cloud.google.com/compute/docs/autoscaler/scaling-stackdriver-monitoring-metrics#per_group_metrics>.
  • Promoted --distribution-target-shape flag in gcloud compute instance-groups managed create command to beta.
  • Promoted --distribution-target-shape flag in gcloud compute instance-groups managed update command to beta.
  • Promoted --network, --subnetwork, and --private-network-ip flags of gcloud compute instances network-interfaces update to GA.
  • Promoted --enable-endpoint-independent-mapping flag of compute routers nats create and compute routers nats update to GA.
  • Promoted the following flags in gcloud compute instance-groups managed set-autoscaling to Beta:
    • --set-schedule
    • --schedule-cron
    • --schedule-duration-sec
    • --schedule-min-required-replicas
    • --schedule-time-zone
    • --schedule-description
  • Promoted the following flags in gcloud compute instance-groups managed update-autoscaling to Beta:
    • --set-schedule
    • --remove-schedule
    • --enable-schedule
    • --disable-schedule
    • --update-schedule
    • --schedule-cron
    • --schedule-duration-sec
    • --schedule-min-required-replicas
    • --schedule-time-zone
    • --schedule-description
  • Promoted --[no-]enable-logging flag of gcloud compute health-checks command group to GA.
  • Promoted gcloud compute instance-groups managed describe-instance to GA.
  • Extended gcloud beta compute target-tcp-proxies create command with --proxy-bind flag.
  • Allow --target-tcp-proxy for gcloud beta compute forwarding-rules create and set-target with specified -load-balancing-scheme=INTERNAL_SELF_MANAGED.
  • Promoted --no-address flag in gcloud beta compute instances import command to GA.

Config Connector

Dataproc Metastore

  • Added gcloud metastore services export gcs which exports metadata from a Dataproc Metastore service.
  • Removed --maintenance-window-day-of-week and --maintenance-window-hour-of-day. Use --maintenance-window-day and --maintenance-window-hour instead.
  • Fixed issue where --maintenance-window-day-of-week and --maintenance-window-hour-of-day flags were not both required in gcloud metastore services update.
  • Promoted gcloud metastore services to beta.
  • Promoted gcloud metastore imports to beta.
  • Promoted gcloud metastore operations to beta.
  • Promoted gcloud metastore locations to beta.

Events

  • Added URI support to --target-service of gcloud events triggers create.
  • Updated gcloud beta events init to set the roles monitoring.metricWriter and cloudtrace.agent for the data plane service account.

GKE Hub

  • Promoted gcloud container hub memberships get-credentials to beta.

Kubernetes Engine

  • Promoted --private-ipv6-google-access-type to GA.
  • Fixed behavior of --no-enable-stackdriver-kubernetes flag of gcloud container clusters update command group.
  • Updates default kubectl from 1.16 to 1.17.
  • Additional kubectl versions:
    • kubectl.1.15 (1.15.12)
    • kubectl.1.16 (1.16.15)
    • kubectl.1.17 (1.17.14)
    • kubectl.1.18 (1.18.12)

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

319.0.0 (2020-11-17)

Breaking Changes

  • (Secret Manager) Modified gcloud secrets commands to send action taken (e.g. Created secret [my-secret].) to stderr instead of stdout.

Assured Workloads

  • Add --provisioned-resources-parent flag to gcloud assured workloads create command.

Cloud Asset Inventory

  • Added new content type os-inventory to gcloud asset export and gcloud asset get-history.

Cloud Healthcare

  • Promoted gcloud healthcare hl7v2-stores export to beta.

Cloud Pub/Sub

  • Promoted --message-filter flag of gcloud pubsub subscriptions create to GA. This feature allows users to specify a filter expression on a Cloud Pub/Sub subscription which will automatically drop messages.

Cloud Resource Manager

  • Updated the following commands to accept a domain name (e.g. "example.com") for organization in addition to the ID (e.g. 1234567890):
    • gcloud organizations describe
    • gcloud organizations get-iam-policy
    • gcloud organizations set-iam-policy

Cloud SQL

  • Added following flags to gcloud sql instances <create|patch>:
    • --retained-backups-count
    • --retained-transaction-log-days

Cloud Storage

  • Updated gsutil component to 4.55.

Compute Engine

  • Promoted --filter-direction flag in gcloud compute packet-mirrorings create/update commands to beta and GA.

Config Connector

Identity Groups

  • Updated --organization flag for gcloud identity groups create and gcloud identity groups search to accept domain names (e.g. example.com) in addition to organization IDs (e.g. 1234567890).

Kubernetes Engine

  • Added pd-balanced disk type to --disk-type of gcloud container command group.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

318.0.0 (2020-11-10)

AI

  • Updated --min-replica-count in gcloud beta ai endpoints deploy-model to be a non-required flag.
  • Added --enable-access-logging, --enable-container-logging, and --service-account flags to gcloud beta ai endpoints deploy-model.

App Engine

App Engine Flexible Environment

  • Promoted gcloud app services update to GA.

Artifact Registry

  • Added --show-occurrences flag to gcloud artifacts docker images list command that enables showing metadata from Container Analysis API.

Cloud SQL

  • Added following flags of gcloud sql instances create and gcloud sql instances update to GA:
    • --insights-config-query-insights-enabled
    • --insights-config-query-string-length
    • --insights-config-record-application-tags
    • --insights-config-record-client-address

Compute Engine

  • Added --chain-name to flag gcloud compute disks snapshot.
  • Added PRIVATE_SERVICE_CONNECT as a global address purpose to gcloud beta compute forwarding-rules create.
  • Added --target-google-apis-bundle to gcloud beta compute forwarding-rules create.
  • Added --no-address flag to gcloud beta compute instances import.

Kpt

  • Updated kpt from v0.35.0 to v0.36.1.
  • Updated import of cli-utils from v0.21.0 to v0.20.6.
  • Updated import of kyaml from v0.9.2 to v0.9.3.
  • Updated import of cmd/config from v0.8.3 to v0.8.4.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

317.0.0 (2020-11-03)

Breaking Changes

  • (App Engine Flexible Environment) Modified deployment prerequisites such that app.yaml is now required for all deployments and can no longer be added to .gcloudignore list.

AI

  • Added gcloud beta ai endpoints explain to send explanation requests to AI Platform endpoints.

Artifact Registry

  • Updated Maven print-settings with service account key to use preemptive for HEAD requests.
  • Promoted gcloud artifacts command group to GA.

Cloud Asset Inventory

  • Promoted Cloud assets analysis commands gcloud asset analyze-iam-policy and gcloud asset analyze-iam-policy-longrunning to GA.

Cloud Billing

  • Promoted gcloud billing budgets to beta.

Cloud Build

  • Added the flag --pack to the command gcloud builds submit.

Cloud Functions

  • Promoted build-env-vars flags of gcloud functions to GA.

Cloud IAM

  • Updated gcloud iam service-accounts keys list to remove the non-functional --uri flag.

Cloud Run

  • Added gcloud run regions list command to list supported Cloud Run (fully managed) regions.

Compute Engine

  • Enabled Patch support for target-http-proxies import command in GA.

Eventarc

  • Added gcloud beta eventarc which manages Eventarc resources.

Firebase Test Lab

  • Promoted --testing-special-entitlements flag of gcloud firebase test ios run to GA.
  • Increased the maximum number of test shards from 250 to 500 when using Android virtual devices.

Identity and Access Management

  • Added gcloud beta iam workload-identity-pools create-cred-config to create a credential config file that can grant non-Google Cloud workloads access to Google Cloud resources, without using a service account key.

Kubernetes Engine

  • Added --ephemeral-storage to gcloud beta container clusters create and gcloud beta container node-pools create. This flag is used to configure nodes' ephemeral storage to be backed by local SSDs.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

316.0.0 (2020-10-27)

Breaking Changes

  • (Cloud Spanner) Modified gcloud spanner operations list to disallow --database or --backup flags used in combination with --type=INSTANCE.
  • (Vmware Engine) Renamed gcloud config vmware/location to gcloud config vmware/region.

AI

  • Added gcloud beta ai hp-tuning-jobs stream-logs which provides the ability to stream logs of hyperparameter tuning jobs in AI Platform.

AI Platform

  • Added --service-account to gcloud beta ai-platform jobs submit training to allow specifying a service account to use when running the training appplication for a training job.
  • Updated --region flag of gcloud ai-platform command to include new CAIP regions.

App Engine

Artifact Registry

  • Disallowed creating CMEK-enabled repositories if Artifact Registry service account is not granted sufficient permissions.
  • Added a new command gcloud beta artifacts docker images describe that shows information of a docker image and optionally the metadata of the image from Container Analysis API.
  • Command gcloud beta artifacts docker images list will now show metadata of images from Container Analysis API as well.

Cloud Access Context Manager

  • Promoted gcloud access-context-manager cloud-bindings to GA.

Cloud Build

  • Updated cloud-build-local to version 0.5.2. This version allows cloud-build-local to execute without a GCP account, providing a warning rather than an error.

Cloud SQL

  • Promoted Postgres 13 to GA.

Cloud Shell

  • Promoted gcloud cloud-shell command group to GA.

Cloud Storage

  • Updated gsutil component to 4.54.

Cloud Workflows

  • Added gcloud workflows executions describe-last to beta which describes the last executed workflow execution that has been cached locally.
  • Added gcloud workflows executions wait-last to beta which waits for the last cached workflow execution to complete.
  • Added gcloud workflows run to beta which executes a workflow and waits for it to complete.

Compute Engine

  • Promoted --mtu flag to beta and GA for gcloud compute networks <create|update>.
  • Promoted gcloud compute instances set-name command to beta.
  • Promoted scope option for --disk flag for gcloud compute instances create to GA.
  • Fixed incorrect error message for gcloud compute target-http-proxies.
  • Added --user-licenses flag to disk create and update command for alpha. ' when the resource already exists.
  • Added gcloud beta compute snapshots create command. It allows to create snapshots of disks.
  • Added --[no-]negative-caching and --[no-]negative-caching-policy to gcloud beta compute backend-services create, gcloud beta compute backend-services update, gcloud beta compute backend-buckets create and gcloud beta compute backend-buckets update.
  • Added cdnPolicy.negativeCaching and cdnPolicy.negativeCachingPolicy to gcloud beta compute backend-services import and gcloud beta compute backend-services export.
  • Promoted HTTP Filter related resource properties to beta for:
    • gcloud compute target-http-proxies import
    • gcloud compute target-http-proxies export
    • gcloud compute target-https-proxies import
    • gcloud compute target-https-proxies export
    • gcloud compute url-maps import
    • gcloud compute url-maps export

Config Connector

Events

  • Updated gcloud beta events triggers create to reference the serving.knative.dev/v1 APIVersion in the subscriber reference of created triggers.

Firebase Test Lab

  • Promoted --testing-special-entitlements flag of gcloud firebase test ios run to GA.

Kpt

  • Updated kpt from v0.34.0 to v0.35.0.
  • Updated import of cli-utils from v0.20.1 to v0.20.6.
  • Updated import of kyaml from v0.8.0 to v0.9.2.
  • Updated import of cmd/config from v0.8.0 to v0.8.3.

Kubernetes Engine

  • Added --release-channel=None option to gcloud container clusters create. This option is used to explicitly opt-out of release channels.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

315.0.0 (2020-10-20)

AI

  • Added gcloud beta ai custom-jobs stream-logs which provides ability to stream logs of custom jobs in AI Platform.
  • Fixed a bug where config.yaml was parsed incorrectly for command gcloud ai custom-jobs create in AI Platform.

Artifact Registry

  • Removed GCR repositories from artifacts repositories list result.

Cloud Firestore Emulator

  • Release Cloud Firestore emulator v1.11.9
    • Fix handling of != and not-in operators.

Compute Engine

  • Added sles-12, sles-sap-12, sles-sap-12-byol, sles-15, sles-sap-15, and sles-sap-15-byol options to --os flag for gcloud compute images import in GA, gcloud compute instances import in GA, and gcloud compute machine-images import in beta.
  • Promoted --disable-default-snat flag for gcloud container clusters update command to GA.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

314.0.0 (2020-10-13)

Breaking Changes

  • (Cloud Build) cloud-build-local is no longer supported on 32-bit MacOS. The executable has been deleted from this release. The prior release, v0.5.0 included a 32-bit MacOS executable that may continue to work for some users.

Apigee

  • Added apigee surface to GA which provides access to Apigee Hybrid.
  • Added apigee organizations command group which provides access to Apigee organizations.
  • Added apigee apis command group which allows management and deployment of Apigee API proxies.
  • Added apigee environments command group which provides access to Apigee environments.
  • Added apigee deployments command group which provides access to Apigee API proxy deployments.
  • Added apigee product command group which allows creation and management of Apigee API products.
  • Added apigee developer command group which provides access to Apigee developers.
  • Added apigee applications command group which provides access to Apigee developer applications.

BigQuery

  • Fixed 'TableSnapshot with expiration' issue.

Certificate Authority Service

  • Added gcloud beta privateca certificates export command which simplifies the process of writing a PEM certificate to a file.

Cloud Build

Cloud Dataproc

  • Removed prompt from gcloud dataproc clusters stop and gcloud dataproc clusters start. The commands now run without requiring confirmation.

Cloud Domains

  • Promoted gcloud domains registrations to beta. Enables the registering and managing of domains.

Cloud Run

  • Promoted --vpc-egress flag of gcloud run deploy and gcloud run services update to beta.

Cloud Shell

  • Removed --boosted flag. An upgraded VM type is available by default.

Firebase Test Lab

  • Added --other-files flag to gcloud beta firebase test ios run. This flag lets you specify files that are pushed onto the iOS test device prior to testing.
  • Added --directories-to-pull flag to gcloud beta firebase test ios run. This flag lets you specify directories on the device that are pulled after testing and included in the test results.

Identity Groups

  • Promoted gcloud identity groups update to GA.

Identity Groups Memberships

  • Promoted gcloud identity groups memberships add to GA.
  • Promoted gcloud identity groups memberships modify-membership-roles to GA.

Notebooks

  • Fixed CMEK support and add PD_BALANCED disk support.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

313.0.1 (2020-10-07)

Cloud Dataflow

  • Fixed bug with gcloud dataflow flex-template build.

313.0.0 (2020-10-06)

Anthos

  • Fixed issue where v2alpha1 Login-Config could not be read from URL in gcloud anthos auth login command.

Artifact Registry

  • Added gcloud beta artifacts repositories update to enable changing the description and labels on an existing repository.

Certificate Authority Service

  • Added gcloud beta privateca command group which enables creating and managing private certificate authorities and certificates. For more information, see <https://cloud.google.com/certificate-authority-service/>.

Cloud API Gateway

  • Added gcloud api-gateway to beta, which adds commands for managing APIs, API Configs, and the Gateways that serve those APIs.

Cloud Build

Cloud Data Catalog

  • Promoted gcloud data-catalog taxonomies to GA release track.

Cloud Dataflow

  • Added runtime environment parameters support in gcloud dataflow flex-template run.

Cloud Memorystore

  • Added --enable-auth flag to gcloud beta redis instances create to allow enabling Redis AUTH when creating a new instance.

Added --[no-]enable-auth flag to gcloud beta redis instances update to allow enabling and disabling Redis AUTH when updating an instance.

Added gcloud beta redis instances get-auth-string command to allow viewing the AUTH string for an instance.

Cloud Pub/Sub

Cloud Run

  • Promoted --min-instances flag of gcloud run deploy and gcloud run services update to beta for --platform=managed.

Cloud SQL

  • Promoted server-level --deny-maintenance-period-start-date, --deny-maintenance-period-end-date, --deny-maintenance-period-time and --remove-deny-maintenance-period flags of gcloud sql instances create/patch to GA.

Cloud Services

  • Promoted gcloud services peered-dns-domains <create|delete|list> to beta.

Compute Engine

  • Promoted --mtu flag to beta and GA for gcloud compute networks <create|update>.
  • Promoted gcloud compute instances set-name command to beta.
  • Promoted scope option for --disk flag for gcloud compute instances create to GA.
  • Fixes incorrect error message for 'gcloud compute target-http-proxies ' when the resource already exists.

Config And Policy Automation

  • Added pkg as a gcloud component. pkg installs a group of Kubernetes Resource Model (KRM) package management tools including: kustomize, kpt, appctl and nomos.

Firebase Test Lab

  • Added --other-files flag to gcloud beta firebase test ios run. This flag lets you specify files that are pushed onto the iOS test device prior to testing.

Identity Groups

  • Promoted gcloud identity groups create to GA.
  • Promoted gcloud identity groups search to GA.

Identity Groups Memberships

  • Promoted gcloud identity groups memberships describe to GA.

Identity and Access Management

  • Added gcloud beta iam workload-identity-pools which enables you to grant on-premises or multi-cloud workloads access to Google Cloud resources, without using a service account key.

Pubsub Emulator

  • Increased server gRPC max message size to 10 MB with some buffer. Allows for publishing 10 MB messages.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

312.0.0 (2020-09-29)

Breaking Changes

  • (Stackdriver Debugger) Removed gcloud beta debug source upload command.

Cloud SDK

  • Modified the --billing-project flag and billing/quota_project property to accept service accounts when specifying a Google Cloud project for billing and quota purposes.

AI

  • Added gcloud ai surface to beta which provides access to manage entities in AI Platform.
  • Added gcloud ai custom-jobs command group which provides access to custom jobs in AI Platform.
  • Added gcloud ai hp-tuning-jobs command group which provides access to hyperparameter tuning jobs in AI Platform.
  • Added gcloud ai endpoints command group which provides access to endpoints in AI Platform.
  • Added gcloud ai models command group which provides access to models in AI Platform.

Artifact Registry

  • Added --labels flag to gcloud beta artifacts repositories create to allow labels to be added to a repository during creation.

Assured Workloads

  • Removed option limitations for --location flag of gcloud assured workloads create.

BigQuery

  • Fixed 'RedirectMissingLocation' issue.

Cloud Asset Inventory

  • Added --partition-key and --per-asset-type flags to gcloud asset export to support partitioned per-type BigQuery export.
  • Removed gcloud alpha asset analyze-iam-policy. Please use gcloud beta asset analyzer-iam-policy instead.

Cloud Billing

  • Added gcloud beta billing accounts add-iam-policy-binding and gcloud beta billing accounts remove-iam-policy-binding commands to manage IAM policy bindings on a Cloud Billing account.

Cloud Dataflow

  • Modified gcloud dataflow sql query to allow "project.dataset.table" and "dataset.table" formats for --bigquery-table argument.

Cloud Dataproc

  • Added --node-group flag to gcloud dataproc clusters create to allow clusters to be created on a Compute Engine sole-tenant node group.
  • Added --node-group flag to gcloud dataproc workflow-templates set-managed-cluster to allow managed clusters to be created on a Compute Engine sole-tenant node group.

Cloud Healthcare

  • Promoted gcloud healthcare consent-stores to beta.

Cloud Pub/Sub

  • Promoted --enable-message-ordering flag of gcloud pubsub subscriptions create and --ordering-key flag of gcloud pubsub topics publish to GA.

Cloud Workflows

  • Added gcloud beta workflows executions wait which allows the user to wait for a workflow execution to complete.

Compute Engine

  • Modified gcloud compute os-login to use the current gcloud project for quota by default. See help for billing/quota_project property or --billing-project flag for more details on how to control this behavior.
  • Added ubuntu-2004 option of --os flag for gcloud compute images import in GA, gcloud compute instances import in GA, and gcloud compute machine-images import in beta.
  • Promoted --service-proxy and --service-proxy-labels flags to GA for gcloud compute instance-templates create.

Events

  • Allow non-default brokers for events brokers create command.
  • Added brokers describe/list/delete commands.

GKE Hub

  • Promoted gcloud container hub memberships <register|unregister> commands to beta. Modified command to unsupport manage-workload-identity-bucket flag.

Identity Groups

  • Promoted gcloud identity groups describe to GA.

Identity Groups Memberships

  • Added --update-roles-params to gcloud beta identity groups memberships modify-membership-roles.
  • Promoted gcloud identity groups memberships delete to GA.
  • Promoted gcloud identity groups memberships list to GA.

Kubernetes Engine

  • Promoted --validate flag of gcloud container binauthz attestations create and gcloud container binauthz attestations sign-and-create to GA and beta, respectively.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

311.0.0 (2020-09-22)

Breaking Changes

  • (Assured Workloads) Updated gcloud assured workloads list and gcloud assured operations list commands to use separate flags for organization and location.

App Engine

  • Added gcloud beta app services update to allow management of incoming traffic to an app on a per-service basis.
  • Promoted --no-cache flag of gcloud app deploy to GA. This flag disables the build cache when deploying an app.
  • Added a warning that <application> or <version> elements within appengine-web.xml are not respected.
  • Modified the behavior of gcloud app deploy with --promote. Previously, attempting to deploy and promote a version that was already deployed, but stopped, would result in an error. Now a stopped version will be started before it is promoted.

App Engine Flexible Environment

  • Added gcloud beta app services update to allow management of incoming traffic to an app on a per-service basis.
  • Promoted --no-cache flag of gcloud app deploy to GA. This flag disables the build cache when deploying an app.
  • Modified the behavior of gcloud app deploy with --promote. Previously, attempting to deploy and promote a version that was already deployed, but stopped, would result in an error. Now a stopped version will be started before it is promoted.

Assured Workloads

  • Added multiple input format support to resource arguments for the following commands: gcloud assured workloads describe, gcloud assured workloads delete, gcloud assured workloads update, and gcloud assured operations describe.

Cloud Dataproc

  • Added --private-ipv6-google-access-type flag to gcloud dataproc clusters create and gcloud dataproc workflow-templates set-managed-cluster to allow users to configure the private IPv6 Google access type for the cluster.

Cloud Resource Manager

  • Added gcloud folders get-ancestors-iam-policy for retrieving IAM policies for a given folder and its ancestors.

Identity Groups

  • Promoted gcloud identity to GA.
  • Promoted gcloud identity groups delete to GA.

Kpt

  • Updated kpt from v0.33.0 to v0.34.0.
  • Updated import of cli-utils from v0.18.1 to v0.20.1.
  • Updated import of kyaml from v0.6.0 to v0.8.0.
  • Updated import of cmd/config from v0.6.0 to v0.8.0.

Secret Manager

  • Promoted gcloud secrets replication command group to beta.
  • Added --replication-policy-file flag to gcloud beta secrets create command to specify replication policy using a JSON or YAML file.
  • Added --kms-key-name flag to gcloud beta secrets create command to specify a KMS key when creating an automatic secret.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

310.0.0 (2020-09-15)

Assured Workloads

  • Added confirmation text to gcloud assured workloads delete command.

Cloud IAM

  • Changed default format for gcloud iam service-accounts list to refer to the display name of the service account as "DISPLAY NAME" instead of "NAME".

Cloud Resource Manager

  • Added a command gcloud projects get-ancestors-iam-policy for retrieving IAM policies for a given project and its ancestors.

Cloud Run

  • Added support for --format to gcloud run deploy, gcloud run services update, and gcloud run replace.

Compute Engine

  • Promoted --disk flag of gcloud compute sole-tenancy node-templates create to beta.
  • Added --accelerator flag of gcloud compute sole-tenancy node-templates create to beta.

Events

  • Added gcloud events command group to beta to allow the configuration of event-based triggers on Cloud Run for Anthos services..

Kubernetes Engine

  • Added --cloud-run-config to gcloud container clusters create and gcloud container clusters update. This flag is used to enable internal load balancer for Cloud Run cluster.
  • Enabled auto repair by default on UBUNTU and UBUNTU_CONTAINERD image.
  • Added --enable-gke-oidc to gcloud container clusters create and gcloud container clusters update. This flag is used to enable the GKE OIDC component for authentication using OIDC.
  • Added new fields to specify disk type and size configuration, shielded instance settings, and customer-managed encryption keys when using --autoprovisioning-config-file with gcloud container clusters create and gcloud container clusters update.
  • Promoted --autoprovisioning-min-cpu-platform flag of gcloud container clusters create and gcloud container clusters update to GA.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

309.0.0 (2020-09-08)

Assured Workloads

  • Added gcloud assured command group to beta. Commands in this group provide the ability to read and modify Assured data controls.
  • Added gcloud assured workloads command group to beta. Commands in this group allow you to manage Assured Workloads environment resources.
  • Added gcloud assured operations command group to beta. Commands in this group allow you to view Assured Workloads operation resources.

Cloud API Gateway

  • Promoted gcloud api-gateway to beta.
    • Modified gcloud api-gateway api-configs create. Removed --grpc-files temporarily since Cloud API Gateway does not support gRPC.
    • Modified gcloud apis create. Added the optional --managed-service flag to specify a pre-existing Google Managed Service.

Cloud Firestore

  • Promoted gcloud firestore databases to beta and GA.
  • Promoted gcloud datastore databases to beta and GA.

Cloud SQL

Compute Engine

  • Added the following flags to gcloud beta compute backend-services create, gcloud beta compute backend-services update, gcloud beta compute backend-buckets create and gcloud beta compute backend-buckets update:
    • --cache-mode
    • --[no-]client-ttl
    • --[no-]default-ttl
    • --[no-]max-ttl
    • --[no-]negative-caching
    • --[no-]negative-caching-policy
    • --[no-]custom-response-header
  • Added the following fields to gcloud beta compute backend-services import and gcloud beta compute backend-services export:
    • customResponseHeader
    • cdnPolicy:
    • cacheMode
    • clientTtl
    • defaultTtl
    • maxTtl
    • negativeCaching
    • negativeCachingPolicy

Kubernetes Engine

  • Added --notification-config to gcloud <alpha|beta> container clusters <create|update>. This flag is used to enable notifications on a cluster. Currently Pub/Sub notifications are supported.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

308.0.0 (2020-09-01)

BigQuery

  • Added 'creationTime', 'updateTime' columns for creating reservation.
  • Added 'ignore_idle_slots' flag for managing reservations idle slots behavior.
  • Supported table snapshot and restoration operation.
  • Added manual instruction for Azure connection setup.
  • Removed requirements of specifying destination table and target dataset if the scheduling query using DML or DDL with command bq query --schedule.

Cloud Data Catalog

  • Implemented the following commands for gcloud data-catalog taxonomies and gcloud data-catalog taxonomies policy-tags in beta.
    • list
    • describe
    • get-iam-policy
    • set-iam-policy
    • add-iam-policy-bindings
    • remove-iam-policy-bindings
  • Implemented export command for gcloud data-catalog taxonomies in beta.
  • Implemented import command for gcloud data-catalog taxonomies in beta.

Cloud Dataproc

  • Added --enable-kerberos flag to gcloud dataproc clusters create and gcloud dataproc workflow-templates set-managed-cluster to allow users to enable Kerberos directly without specifying --kerberos-root-principal-password-uri or --kerberos-kms-key-uri.

Cloud Firestore

  • Promoted gcloud filestore backups to beta.
  • Added gcloud beta filestore instances restore to enable restoring a Cloud Filestore instance from a backup.
  • Promoted --source-backup and --source-backup-region flags to beta to specify backup details; these flags should be used in conjunction with --file-share flag.

Cloud Healthcare

  • Promoted gcloud healthcare hl7v2-stores import to beta.

Cloud Run

  • Fixed issue when updating labels on a cluster with private visibility failed.
  • Added service endpoint visibility to gcloud run services describe output for services deployed with --platform=gke or --platform=kubernetes. Cluster-local services show Ingress: internal. Services that are not cluster-local show Ingress: all. Use --connectivity flag of gcloud run deploy or gcloud run services update to update service endpoint visibility.

Cloud Shell

  • Promoted gcloud cloud-shell command group to beta.

Compute Engine

  • Promoted compute instances get-screenshot to GA.

Notebooks

  • Added gcloud beta notebooks instances upgrade to upgrade Notebooks instance.
  • Added gcloud beta notebooks instances is-upgradeable to verify if Notebooks instance can be upgraded to a newer image.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

307.0.0 (2020-08-25)

App Engine

Cloud Dataflow

  • Promoted gcloud dataflow flex-template build to GA. Promoted gcloud dataflow flex-template run to GA.

Cloud Run

  • Changed the generation of revision names. If the generated revision name is longer than the knative resource name length limit (63 characters), shorten the part of the service name used as a prefix until the revision name is no longer than the maximum knative resource name.

Cloud SQL

  • Promoted MySQL 8 to GA.

Cloud Security Command Center

  • Promoted gcloud scc notifications command group to beta and GA.
  • Promote gcloud scc [operations|sources|findings] to beta and GA.

Cloud Storage

  • Updated gsutil component to 4.53.

Compute Engine

  • Promoted 'SHARED_LOADBALANCER_VIP' option of --purpose flag of gcloud compute addresses create to GA.
  • Promoted --logging-metadata flag to GA for
    • gcloud compute firewall-rules create
    • gcloud compute firewall-rules update.
  • Promoted --network, --subnetwork, and --private-network-ip flags of gcloud compute instances network-interfaces update to beta.

Firebase Test Lab

  • Added --additional-ipas flag to gcloud beta firebase test ios run. This flag allows you to specify additional iOS apps that should be installed on the device prior to testing.

Kpt

  • Updated kpt from v0.30.1 to v0.33.0.
  • Updated import of cli-utils from v0.15.0 to v0.18.1.
  • Updated import of kyaml from v0.3.1 to v0.6.0.
  • Updated import of cmd/config from v0.3.0 to v0.6.0.

Kubernetes Engine

  • Promoted --enable-master-global-access flag of gcloud container clusters <create|update> to GA.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

306.0.0 (2020-08-18)

BigQuery

  • Fixed issue where ls --reservation command randomly failed with internal error.
  • Added add-iam-policy-binding and remove-iam-policy-binding commands, with support for modifying IAM policies for tables and views.

Cloud Dataproc

  • Added --dataproc-metastore flag to gcloud beta dataproc clusters create to allow clusters to be created with a Dataproc Metastore service.
  • Added --dataproc-metastore flag to gcloud beta dataproc workflow-templates set-managed-cluster to allow managed clusters to be created with a Dataproc Metastore service.

Cloud Firestore Emulator

  • Release Cloud Firestore emulator v1.11.7
    • Includes latest features and improvements from production.

Cloud Key Management Service

  • Added gcloud beta kms keys versions get-certificate-chain to retrieve HSM attestation certificate chains.

Cloud Pub/Sub

  • Promoted gcloud pubsub topics detach-subscription to GA.

Cloud Resource Manager

  • Fixed issue where gcloud resource-manager org-policies <allow|deny> gave an error when a restore default policy exists.

Cloud Security Command Center

  • Promoted gcloud scc notifications command group to beta and GA.

Cloud TPU

  • Added --use-service-networking flag to gcloud beta compute tpus create.

Compute Engine

  • Added gcloud beta compute os-config os-upgrade to enable major OS version updates on support distributions.
  • Promoted --condition flag to GA for
    • gcloud compute instances add-iam-policy-binding
    • gcloud compute instances remove-iam-policy-binding.
  • Promoted Regional Network Endpoint Groups to GA.
  • Promoted Hybrid Network Endpoint Groups to GA.
  • Promoted gcloud compute commitments create-license to beta and GA.
  • Promoted the following commands to GA:
    • gcloud compute instance-groups managed instance-configs create
    • gcloud compute instance-groups managed instance-configs update
    • gcloud compute instance-groups managed instance-configs list
    • gcloud compute instance-groups managed instance-configs delete
  • Promoted --stateful-disk and --stateful-metadata for gcloud compute instance-groups managed create-instance to GA.
  • Added --network flag to gcloud beta compute target-instances create.

Game Servers

  • Promoted gcloud game servers to GA.

Notebooks

  • Added n1-standard-1 as the default for notebook instances.
  • Added deeplearning-platform as the default for notebook instance project and environment project.

Secret Manager

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

305.0.0 (2020-08-11)

Artifact Registry

  • Added --json-key flag to gcloud beta artifacts print-settings.
  • Added bearer auth for npm support to gcloud beta artifacts print-settings.

Cloud Build

  • Added the flag --worker-pool to the command gcloud builds submit.

Cloud Dataflow

  • Added flex template docker container building support in build command gcloud beta dataflow flex-template build.

Cloud Pub/Sub

  • Replaced --scale in gcloud beta pubsub lite-topics create and gcloud beta pubsub lite-topics update with --per-partition-publish-mib and --per-partition-subscribe-mib flags.

Cloud Run

  • Added --image flag to gcloud run services update command in beta and GA to support updating container image.

Cloud Security Command Center

  • Promoted gcloud scc assets command group to beta and GA.

Compute Engine

  • Promoted cpu-overcommit-type flag of gcloud beta compute sole-tenancy node-templates create to GA.
  • Promoted --stateful-disk flag for gcloud compute instance-groups managed create to GA.
  • Promoted --stateful-disk, --remove-stateful-disk flags for gcloud compute instance-groups managed update to GA.
  • Promoted --scale-in-control flag of gcloud compute instance-groups managed set-autoscaling to GA.
  • Promoted --scale-in-control and --clear-scale-in-control flags of gcloud compute instance-groups managed update-autoscaling to GA.

Deployment Manager

  • Added --custom-certificate-authority-roots flag to gcloud deployment-manager type-providers <create|update>.

Kubernetes Engine

  • Promoted the GKE add-on ConfigConnector of gcloud container clusters <create|update> to GA. This add-on is disabled by default.
    • Use --addons=ConfigConnector to enable the add-on during cluster creation.
    • Use --update-addons=ConfigConnector=ENABLED|DISABLED to enable/disable the add-on for existing GKE clusters.
  • Updates default kubectl from 1.15 to 1.16.
  • Additional kubectl versions:
    • kubectl.1.14 (1.14.10)
    • kubectl.1.15 (1.15.12)
    • kubectl.1.16 (1.16.13)
    • kubectl.1.17 (1.17.9)
    • kubectl.1.18 (1.18.6)
  • Promoted --disable-default-snat flag of gcloud container clusters <create|update> to GA.
  • Modified GKE nodes to have serial port output logging enabled by default. To disable, use --metadata serial-port-logging-enable=false.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

304.0.0 (2020-08-04)

Cloud Build

  • Modifed the command group gcloud beta builds worker-pools such that all underlying commands now use a regional Cloud Build API endpoint (instead of the global one).
  • Modifed the command group gcloud builds such that all underlying commands may optionally use a regional Cloud Build API endpoint (instead of the global one). This is controlled by the new flag --region, as well as the configuration of submitted builds.

Cloud Composer

  • Fixed a bug where an argument added to backfill subcommand of gcloud composer environments run fails in older Airflow versions.
  • Added --web-server-machine-type flag to gcloud beta composer environments commands to specify the machine type used by the Airflow web server.

Cloud IAM

  • Promoted gcloud iam service-accounts keys upload to GA.

Compute Engine

  • Added gcloud beta compute os-config os-upgrade to enable major OS version updates on support distributions.
  • Promoted gcloud compute diagnose export-logs to GA.

Firebase Test Lab

  • Added the command gcloud [alpha|beta] firebase test ip-blocks list, which retrieves a catalog of IP blocks used by Firebase Test Lab devices.

Kubernetes Engine

  • Added --node-group to gcloud container node-pools create. This flag is used to enable the Compute Engine sole tenant node feature on Kubernetes Engine node pools.

Secret Manager

  • Updated the following commands to better support IAM Conditions:
    • gcloud secrets get-iam-policy outputs conditions associated with each binding.
    • gcloud secrets set-iam-policy accepts policies with conditional bindings.
    • gcloud secrets <add|remove>-iam-policy-binding accepts conditional bindings.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

303.0.0 (2020-07-28)

AI Platform

  • Promoted --kms-key flag of gcloud ai-platform jobs submit training to GA.

Cloud Bigtable

  • Promoted gcloud bigtable backups commands group to GA.
  • Promated gcloud bigtable instances tables restore and gcloud bigtable instances tables list to GA.

Cloud Build

  • Added --comment-control flag option COMMENTS_ENABLED_FOR_EXTERNAL_CONTRIBUTORS_ONLY to gcloud builds triggers create github in alpha and beta.

Cloud Composer

  • Added --cloud-sql-machine-type flag to gcloud beta composer environments commands to specify the Cloud SQL machine type used by the Airflow database.

Cloud Data Catalog

  • Added --restricted-locations to gcloud data-catalog search to enable regional search.

Compute Engine

  • Added --log-location flag to gcloud compute instances import and gcloud beta compute machine-images import.
  • Promoted --condition flag for
    • gcloud compute images add-iam-policy-binding
    • gcloud compute images remove-iam-policy-binding to GA.
  • Promoted --rollout-mode, --rollout-disruption-budget, and --rollout-disruption-budget-percent flags of gcloud compute os-config patch-jobs execute to GA.
  • Allowed using user-data key in metadata with gcloud compute instances create-with-container.
  • Promoted --condition flag to GA for
    • gcloud compute images add-iam-policy-binding
    • gcloud compute images remove-iam-policy-binding
    • gcloud compute snapshots add-iam-policy-binding
    • gcloud compute snapshots remove-iam-policy-binding.

Kubernetes Engine

  • Added --identity-provider to gcloud beta container clusters create and gcloud beta container clusters update. This flag is used to enable a 3P identity provider on a cluster.
  • Added flag --enable-dataplane-v2 to gcloud <alpha|beta> container clusters create. This flag allows GKE clusters to use the new and improved datapath with additional visibility and observability features.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

302.0.0 (2020-07-21)

AI Platform

App Engine

  • Added support for directly deploying the Gradle project 'build.gradle' file.

Cloud Asset Inventory

  • Modified gcloud asset search-all-resources and gcloud asset search-all-iam-policies to apply --page-size=20 by default.

Cloud Dataproc

  • Added --dag-timeout flag to gcloud dataproc workflow-templates create to allow timeouts to be set on Workflow jobs DAGs.
  • Added gcloud dataproc workflow-templates set-dag-timeout to allow DAG timeouts to be updated or set on existing Workflows.
  • Added gcloud dataproc workflow-templates remove-dag-timeout to allow DAG timeouts to be removed from Workflows.

Cloud Firestore Emulator

  • Release Cloud Firestore emulator v1.11.5
    • Bug fix for camel case query parameters
    • Add support for != style queries

Cloud Pub/Sub

  • Promoted --enable-message-ordering flag of gcloud pubsub subscriptions create and --ordering-key flag of gcloud pubsub topics publish to beta.

Cloud Resource Manager

  • Promoted gcloud resource-manager org-policies command group to GA.

Cloud Run

  • Promoted --tag flag of gcloud run deploy to beta.
  • Promoted --tag flag of gcloud run services update to beta.
  • Promoted --to-tags, --set-tags, --update-tags, --remove-tags, and --clear-tags flags of gcloud run services update-traffic to beta.

Cloud SQL

  • Promoted server-level --collation flag of gcloud sql instances create to GA.

Cloud Storage

  • Updated gsutil component to 4.52.

Compute Engine

  • Promoted --rollout-mode, --rollout-disruption-budget, and --rollout-disruption-budget-percent flags of gcloud compute os-config patch-jobs execute to beta.
  • Promoted gcloud compute health-checks <create|update> grpc commands to GA.

Firebase Test Lab

  • Added --grant-permissions flag to gcloud beta firebase test android run. This flag allows you to specify if runtime permissions should be granted prior to running a test.
  • Modified the limit for --num-uniform-shards and --test-targets-for-shard to be 250 when no physical devices are selected.

Kubernetes Engine

  • Added flag --private-ipv6-access-type of gcloud container clusters create and gcloud container clusters update to beta. This flag is used to allow GKE pods to connect to Google services over a low latency, secure, IPv6 network path.
  • Promoted --release-channel of gcloud container clusters create and gcloud container clusters update to GA. This flag is used to configure the cluster release channel.

Secret Manager

  • Updated gcloud secrets create command to default to an automatic replication policy if a replication policy is not provided.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

301.0.0 (2020-07-14)

Cloud SDK

  • Prefer Python 3 for deb and rpm package installations. The Cloud SDK now prefers Python 3 for bq, gcloud, and gsutil on all installation paths. See gcloud topic startup for information on configuring the Python interpreter used by the Cloud SDK.

Anthos

  • Upgraded anthos-auth component to version 1.1.2.
  • Added ldap support to gcloud anthos auth login.

App Engine

Artifact Registry

  • Added support for CMEK repository creation with customer managed encryption key.
  • Added gcloud beta artifacts repositories describe.

Compute Engine

  • Promoted --description and --family flags of gcloud compute images update to beta.
  • Promoted --target-grpc-proxy for gcloud compute forwarding-rules <create|set-target> to GA.
  • Promoted documentation for --protocol to include GRPC for gcloud compute backend-services <create|update> to GA.
  • Promoted gcloud compute target-grpc-proxies <create|delete|describe|list> to GA.
  • Added only-scale-out mode enum value to gcloud compute instance-groups managed <set|update>-autoscaling . The only-scale-out value directly replaces and deprecates the only-up value.

Kubernetes Engine

  • Promoted NodeLocalDNS Addon to GA. Use NodeLocalDNS addons with gcloud container clusters create and gcloud container clusters update.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

300.0.0 (2020-07-08)

Breaking Changes

  • (Recommender) Modified headers in output of gcloud recommender recommendations list.
    • Renamed ID to RECOMMENDATION_ID and STATE to RECOMMENDATION_STATE.
  • (Recommender) Modified headers in output of gcloud recommender insights list.
    • Renamed ID to INSIGHT_ID and STATE to INSIGHT_STATE.

Cloud Dataproc

  • Added --temp-bucket flag to gcloud dataproc clusters create and gcloud dataproc workflow-templates set-managed-cluster to allow users to configure a Cloud Storage bucket that stores ephemeral cluster and jobs data, such as Spark and MapReduce history files.

Cloud SQL

  • Promoted --enable-point-in-time-recovery flag of gcloud sql instances create and gcloud sql instances patch to GA.
  • Promoted --point-in-time flag of gcloud sql instances clone to GA.

Compute Engine

  • Promoted --source-disk flag of gcloud compute disks create to GA.

Kpt

  • Updated kpt from v0.24.0 to v0.30.1.
  • Updated import of cli-utils from v0.8.0 to v0.15.0.
  • Updated import of kyaml from v0.1.8 to v0.3.1.
  • Updated import of cmd/config from v0.1.7 to v0.3.0.

Kubernetes Engine

  • Added --system-config-from-file flag to gcloud beta container clusters create, gcloud beta container node-pools create, and gcloud beta container node-pools update to configure kubelet and Linux configuration settings on nodes.

Recommender

  • Promoted gcloud recommender insights to GA.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

299.0.0 (2020-06-30)

Cloud SDK

Anthos

  • Added gcloud anthos create-login-config command to GA.

Cloud Asset Inventory

  • Promoted Cloud assets search commands gcloud asset search-all-resources and gcloud asset search-all-iam-policies to GA.

Cloud Data Catalog

  • Added possibility to rename enum values using gcloud data-catalog tag-templates fields enum-values rename.

Cloud Dataproc

  • Promoted --enable-component-gateway flag of gcloud dataproc clusters create and gcloud dataproc workflow-templates set-managed-cluster to GA.

Cloud Run

  • Updated --service-account flag to accept a Kubernetes service account for --platform=gke and --platform=kubernetes.

Compute Engine

  • Added --interface flag to gcloud beta compute disks create.
  • Removed interface key from --disk key of gcloud beta compute instances create.
  • Promoted gcloud compute security-policies list-preconfigured-expression-sets to GA.
  • Promote --condition flag to GA for the following commands:
    • gcloud compute disks add-iam-policy-binding
    • gcloud compute disks remove-iam-policy-binding
    • gcloud compute instance-templates add-iam-policy-binding
    • gcloud compute instance-templates remove-iam-policy-binding.
  • Added --service-proxy and '--service-proxy-labels' flags to gcloud beta compute instance-templates create to populate the fields in Instance Template required to automatically deploy and configure the service proxy and service-proxy-agent.
  • Added --chain-name flag gcloud beta compute disks snapshot.
  • Promoted Regional Network Endpoint Groups to beta.

Kubernetes Engine

  • Promoted NodeLocalDNS Addon to GA. Use NodeLocalDNS addons with gcloud container clusters create and gcloud container clusters update.

VPC Access

  • Added --vpc-connector flag to gcloud run deploy and gcloud run services update which allows cloud run services to connect to a VPC Connector.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

298.0.0 (2020-06-23)

Breaking Changes

  • (Cloud Data Catalog) Removed add-enum-values flag from gcloud data-catalog tag-templates fields update.

Cloud SDK

  • Changed the bq and gcloud command-line tools to prefer Python 3 for component-based Cloud SDK installs on Unix. See gcloud topic startup for information on configuring the Python interpreter used by the Cloud SDK.

AI Platform

  • Added --network flag to gcloud ml-engine jobs submit training and gcloud ai-platform jobs submit training.

App Engine

  • Added an optional --appyaml flag to change the app.yaml file location for an application.

Cloud Data Catalog

  • Added enum-values flag in gcloud data-catalog tag-templates fields update.

Compute Engine

  • Promote --condition flag for

    • gcloud compute disks add-iam-policy-binding
    • gcloud compute disks remove-iam-policy-binding to GA.
  • Promote --condition flag for

    • gcloud compute reservations add-iam-policy-binding
    • gcloud compute reservations remove-iam-policy-binding to GA.

Secret Manager

  • Updated the following beta commands to better support IAM Conditions:
    • gcloud beta secrets get-iam-policy outputs conditions associated with each binding.
    • gcloud beta secrets set-iam-policy accepts policies with conditional bindings.
    • gcloud beta secrets <add|remove>-iam-policy-binding accepts conditional bindings.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

297.0.1 (2020-06-17)

297.0.0 (2020-06-16)

Anthos

  • Added support for preferred authentication methods to anthos auth login command.

BigQuery

  • Added support for splitting/merging capacity commitments.
  • Added support for autoscale based on reservations.
  • Fixed CLI json.loads error for Python 3.5.

Compute Engine

  • Added --preemptible flag to gcloud compute instances set-scheduling.
  • Promoted --multi-writer flag of gcloud compute disks create to beta.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

296.0.1 (2020-06-10)

Anthos

  • Fixed blocking bug in anthos auth login command.

296.0.0 (2020-06-09)

Cloud SDK

  • Updated bundled Python executable to 3.7.5.

Cloud Composer

  • Fixed a bug that causes backfill subcommand of gcloud composer environments run to be stuck indefinitely.
  • Updated gcloud composer environments run command to prefer GKE pods with 'Ready: true' condition state.

Cloud Filestore

  • Updated gcloud beta filestore instances create and gcloud beta filestore instances update to include:
    • Added HIGH_SCALE_SSD, BASIC_HDD and BASIC_SSD tiers.
    • Added nfs-export-options to --file-share flag.
    • Support for NfsExportOptions. Run gcloud filestore --help or visit https://cloud.google.com/filestore/docs/ to learn more.

Cloud Firestore Emulator

  • Release Cloud Firestore emulator v1.11.4
    • Fixes bug for evaluating rules in query listening.
    • Fixes support for ?show_missing in listing collection.

Cloud Resource Manager

  • Promoted gcloud projects create to beta.

Cloud Run

  • Modified --vpc-connector and --clear-vpc-connector flags to be applicable for --platform=managed only.
  • Added --format export option to gcloud run services describe and gcloud run revisions describe, to output resources without deployment-specific metadata or status information.

Compute Engine

  • Replaced coreos-cloud with fedora-coreos-cloud in the list of public image projects for --standard-images flag of gcloud compute images list.
  • Promoted gcloud compute commitments create-license to beta.
  • Added flag --instance-update-minimal-action flag to gcloud beta compute instance-groups managed instance-configs <create|update|delete>.

Kubernetes Engine

  • Added --master-logs and '--enable-master-metrics' flags to gcloud beta container clusters to enable sending master logs and metrics to Cloud Operations (fka Stackdriver).

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

295.0.0 (2020-06-02)

Anthos

  • Added gcloud anthos apply command to beta. This command declaratively applies Config Connector resource configurations.
  • Added gcloud anthos export command to beta. This command exports Config Connector resource configurations of existing Google Kubernetes Engine clusters.

Cloud Memorystore

  • Enabled support for Redis version 5.0. Added redis_5_0 as a new option for --redis_version flag of gcloud redis instances create.
  • Added gcloud redis instances upgrade to upgrade a Memorystore Redis instance to a specified Redis version.

Cloud Pub/Sub

  • Rename --filter flag of gcloud pubsub subscriptions create to --message-filter. This is done to avoid confusion with --filter flag of https://cloud.google.com/sdk/gcloud/reference/topic/filters.
  • Promoted --message-filter flag of gcloud pubsub subscriptions create to beta. This feature allows users to specify a filter expression on a Cloud Pub/Sub subscription which will automatically drop messages.

Compute Engine

  • Promoted gcloud compute instance-groups managed describe-instance to beta.
  • Added --accelerator flag to gcloud beta compute instances create-with-container.
  • Promoted --private-ipv6-google-access-type flag of gcloud compute instances <create|create-with-container> to GA.
  • Promoted --private-ipv6-google-access-type flag of gcloud compute instance-templates <create|create-with-container> to GA.
  • Promoted --private-ipv6-google-access-type flag of gcloud compute networks subnets <create|update> to GA.
  • Added --interface flag to gcloud beta compute disks create.
  • Added --interface flag to gcloud beta compute instances attach-disk.
  • Added interface key to --disk key of gcloud beta compute instances create.

Game Servers

  • Added --description to gcloud <alpha|beta> game servers <clusters/realms/deployments> update to allow updating description for resources.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

294.0.0 (2020-05-27)

Breaking Changes

  • (Secret Manager) Modified gcloud secrets beta command group to use the Secret Manager v1 API. The --uri flag now formats output to begin with https://secretmanager.googleapis.com/v1/ instead of https://secretmanager.googleapis.com/v1beta1/ when used with the following commands:
    • gcloud beta secrets list
    • gcloud beta locations list
    • gcloud beta secrets versions list

AI Platform

  • Added --kms-key to gcloud <alpha|beta> ai-platform jobs submit training to allow specifying a customer-managed encryption key for a training job.

Cloud Pub/Sub

  • Promoted configurable retry-related flags in gcloud pubsub subscriptions create and gcloud pubsub subscriptions update to GA.

Cloud Run

  • Change gcloud run services get-iam-policy, gcloud run services set-iam-policy, gcloud run services add-iam-policy-binding, and gcloud run services remove-iam-policy-binding to use the v1 api.

Cloud Storage

  • Updated gsutil component to 4.51.

Cloud Tasks

  • Promoted gcloud tasks queues create-pull-queue to beta.

Compute Engine

  • Changed default action from RESTART to REPLACE for --update-instance flag of gcloud compute instance-groups managed instance-configs create|update.
  • Promoted --maintenance-policy of gcloud compute sole-tenancy node-groups create to GA.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

293.0.0 (2020-05-19)

App Engine

Cloud SQL

  • Promoted Postgres 12 to GA.

Compute Engine

  • Promoted gcloud compute instance-groups managed list-errors to GA.
  • Added gcloud beta compute instances get-screenshot command to beta.

Firebase Test Lab

  • Promoted --additional-apks, --other-files, --network-profile, and --robo-script flags of gcloud firebase test android run to GA.

Kubernetes Engine

  • Promoted --disable-default-snat flag of gcloud container clusters <create|update> to beta.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

292.0.0 (2020-05-12)

Breaking Changes

  • (Cloud SDK) Modified gcloud auth application-default login to add a quota project by default. Use --disable-quota-project to skip setting the quota project.
  • (Cloud SDK) Modified gcloud auth application-default login and gcloud auth application-default set-quota-project so that a quota project is added to the application default credentials only when the credentials have the permission to bill the project.

Cloud SDK

App Engine Flexible Environment

  • Fixed issue where CloudBuild timeout value without 's' suffix was rejected sometimes.

Cloud DNS

  • Promoted Non-RFC 1918 Cloud DNS features to GA.

Cloud Dataproc

  • Fixed bug in gcloud dataproc clusters list where Google Kubernetes Engine-based clusters are listed with PLATFORM as GCE when accessed by the GA command.

Cloud Key Management Service

  • Promoted --condition flag to GA for the following commands:
    • gcloud kms keyrings add-iam-policy-binding
    • gcloud kms keyrings remove-iam-policy-binding
    • gcloud kms keys add-iam-policy-binding
    • gcloud kms keys remove-iam-policy-binding

Compute Engine

  • Added import and export commands to gcloud compute <target-http-proxies|target-https-proxies>.
  • Promoted --private-ipv6-google-access-type flag of gcloud compute instances <create|create-with-container> to beta.
  • Promoted --private-ipv6-google-access-type flag of gcloud compute instance-templates <create|create-with-container> to beta.
  • Promoted --autoscaler-mode, --min-nodes, and --max-nodes flags of command gcloud compute sole-tenancy node-groups create to GA.

Kubernetes Engine

  • gcloud container now respects compute/region property.

Subscribe to these release notes at https://groups.google.com/forum/#!forum/google-cloud-sdk-announce.

291.0.0 (2020-05-05)

AI Platform

  • Added --config to gcloud beta ai-platform versions update and gcloud beta ai-platform versions update to allow specifying manual and auto-scaling parameters.

App Engine

BigQuery

  • Enabled purchasing capacity commitments through t