Google Cloud SDK 208.0.0 introduces several new beta features, including Cloud Filestore and gcloud compute network-endpoint-groups commands, along with numerous new flags for Compute Engine and Cloud Functions. Key changes include a warning about the default --enable-ip-alias behavior in Kubernetes Engine and the removal of the container/use_v1_api property. Significant internal groundwork was laid for new APIs like Cloud Composer, Service Networking, VPC Access, and a migration to v1beta1 for Binary Authorization attestors.
Jump to: Annotated Release Notes | Unannounced Changes 🕵️ | Stats 📊
Breaking Changes
- A warning was added that the default value of
--enable-ip-aliaswill change forgcloud container clusters createcommand, making VPC native (IP alias enabled) clusters the default in the future. Users are advised to use--[no-]enable-ip-aliasto suppress this warning.- File: RELEASE_NOTES:10
- The
gcloudpropertycontainer/use_v1_apiand its aliascontainer/use_v1_api_clientwere removed.- File: properties.py:24
- The
servicenetworkingAPI has been promoted fromv1alphatov1beta. ThePeerApiCallfunction inpeering.pyhas been renamed toCreateConnectionand the underlying API method and request messages have changed (e.g.,ServicenetworkingServicesPeerRequesttoServicenetworkingServicesConnectionsCreateRequest). This might affect any code directly interacting with thev1alphaAPI for service peering.- File: peering.py:22
- The Cloud TPU
v1andv1alpha1APIs, along with their corresponding clients and messages, have been entirely removed from the SDK. This indicates that these specific API versions are no longer supported.- File: tpu_v1_client.py
- Removed internal functions
AddListAttestationsFlagsandAddCreateAttestationFlagsfor Binary Authorization, which may indicate changes to the CLI commands that previously used these to define flags.- File: flags.py
- Removed constants and logic related to forcing Kubernetes Engine v1 API usage via
container/use_v1_apiproperties, indicating deprecation or removal of this compatibility mechanism.- File: constants.py
- Removed
ValidateIstioConfigUpdateArgsfunction, suggesting changes in how Istio config updates are handled, potentially breaking existing update workflows for Istio.- File: flags.py
- The
--trigger-eventflag for Cloud Functions no longer has explicitly listed choices in the help text, which might affect users relying on this for discoverability.- File: flags.py
- The internal utility function
AddIdArgfor creating resource ID flags has been removed fromcommand_lib/tasks/flags.py.- File: flags.py:41
- Deprecated properties
container.use_v1_apiandcontainer.use_v1_api_clienthave been removed. Any scripts or internal logic relying on these properties will now fail.- File: properties.py:786
- The
orderByquery parameter was removed from thecloudtasks.projects.locations.queues.tasks.listmethod in Cloud Tasks v2beta2. This means tasks can no longer be explicitly sorted byschedule_timeorpull_message.tagusing this parameter. - The
AttachedDisk.TypeValueValuesEnumenum in the Compute alpha API has a new valueNVDIMM. This has shifted the integer values forNVMEandSCSI(from 0 to 1, and 1 to 2 respectively). Clients relying on the integer representation of these enum values may break. - The
indexfield has been removed from theNodeGroupNodemessage in the Compute alpha API. - The
nodeIndexesfield has been removed from theNodeGroupsDeleteNodesRequestmessage in the Compute alpha API. Clients should now use thenodesfield, which has been re-indexed. - In the
RouterNatSubnetworkToNatmessage in the Compute alpha API, the enumSourceIpRangesToNatsValueListEntryValuesEnumhas been renamed toSourceIpRangesToNatValueListEntryValuesEnum, and the fieldsourceIpRangesToNatshas been renamed tosourceIpRangesToNat. - The
ComputeProjectsDisableXpnHostRequestandComputeProjectsDisableXpnResourceRequestmessage classes have been removed from thecompute/v1API. Functionality for Node Group management has been introduced in new message classes. - The
indexfield has been removed from theNodeGroupNodeschema incompute_alpha.json.- File: compute_alpha.json:13581
- The
nodeIndexesfield has been removed from theNodeGroupsDeleteNodesRequestschema incompute_alpha.json. Thenodesfield should be used instead.- File: compute_alpha.json:13632
- The field
sourceIpRangesToNatsin theRouterNatSubnetworkToNatschema has been renamed tosourceIpRangesToNatincompute_alpha.json.- File: compute_alpha.json:18243
- The
Resetmethod andResetNodeRequestschema have been removed from the TPU API (tpu/v1andtpu/v1alpha1). This means users can no longer programmatically reset TPU nodes using this method.- File: tpu_v1_client.py:251
- The
Resetmethod andResetNodeRequestschema have been removed from the TPU API (tpu/v1andtpu/v1alpha1). This means users can no longer programmatically reset TPU nodes using this method.
New Features by Service
Cloud SDK
- TAB completion for commands, flags, and constant flag value choices is now approximately 10x faster.
- File: RELEASE_NOTES:18
App Engine
- The Python SDK was updated to version 1.9.72.
- File: RELEASE_NOTES:24
Cloud Dataproc
- Added
gcloud beta dataproc workflow-templates importto enable creating and updating workflow templates using a YAML file.- File: RELEASE_NOTES:30
- Added
gcloud beta dataproc workflow-templates exportto enable exporting a workflow template to a YAML file.- File: RELEASE_NOTES:28
- Added
--parametersflag togcloud beta dataproc workflow-templates instantiateto enable parameterization of workflow templates.- Flags:
--parameters - File: RELEASE_NOTES:32
- Flags:
- Introduced support for Dataproc Workflow Templates v1beta2, enabling the definition and management of complex job sequences through a new YAML schema.
Cloud Datastore Emulator
- Released Cloud Datastore Emulator version 2.0.1, with improved backward compatibility with App Engine local development by allowing special entity kinds to be whitelisted for App Engine.
- File: RELEASE_NOTES:37
Cloud Filestore
- The
gcloud filestorecommand group is now available in beta, allowing creation, configuration, and manipulation of Cloud Filestore instances.- File: RELEASE_NOTES:44
- Ability to update Cloud Filestore instances, including resizing file share capacity, updating descriptions, and labels. This functionality is primarily available for the
v1beta1API version.- File: filestore_client.py:194
- Introduced the
v1beta1API for managing Cloud Filestore instances, including new client methods forCreate,Delete,Get,List, andPatchoperations onprojects.locations.instances. This also includes comprehensive new message types forInstance,FileShareConfig,NetworkConfig,Export,NfsExport,SmbExport, andClientList. - Introduced the
v1beta1API for Cloud Filestore, enabling management of instances, file shares, and network configurations. New API methods includefile.projects.locations.instances.list,get,create,patch, anddeletefor Filestore instances, along with new message types likeInstance,FileShareConfig,NetworkConfig,Export,ClientList,NfsExport, andSmbExport.- File: file_v1beta1.json:206
Cloud Functions
- Added
--runtimeflag togcloud beta functions deploy.- Flags:
--runtime - File: RELEASE_NOTES:52
- Flags:
- Added flags (
--clear-env-vars,--set-env-vars,--env-vars-file,--remove-env-vars,--update-env-vars) togcloud beta functions deployfor setting custom environment variables.- Flags:
--clear-env-vars,--set-env-vars,--env-vars-file,--remove-env-vars,--update-env-vars - File: RELEASE_NOTES:54
- Flags:
- New functionality to manage environment variables for Cloud Functions during deployment. This includes setting, clearing, and removing variables.
- Flags:
--build-env-vars,--set-env-vars,--clear-env-vars,--remove-env-vars - File: flags.py:206
- Flags:
- Added support for new event triggers from Firebase Realtime Database, Cloud Firestore, and Firebase Analytics.
- File: triggers.py:93
- Introduced utilities for managing environment variables during deployment using
--update-env-vars,--remove-env-vars, and--clear-env-varsflags.- Flags:
--update-env-vars,--remove-env-vars,--clear-env-vars - File: env_vars_util.py
- Flags:
- Enhanced event trigger validation and creation logic to support new resource types like Firebase Database, Firestore Document, and Firebase Analytics Events.
- File: trigger_util.py
Cloud Machine Learning Engine
- The
--python-versionflag ofgcloud ml-engine versions createwas promoted to GA.- Flags:
--python-version - File: RELEASE_NOTES:64
- Flags:
Cloud Storage
- The
gsutilcomponent was updated to version 4.33.- File: RELEASE_NOTES:70
Compute Engine
- Added KMS integration flags (
--boot-disk-kms-key,--boot-disk-kms-keyring,--boot-disk-kms-location,--boot-disk-kms-project) togcloud compute instance-templates create.- Flags:
--boot-disk-kms-key,--boot-disk-kms-keyring,--boot-disk-kms-location,--boot-disk-kms-project - File: RELEASE_NOTES:75
- Flags:
- Added
--use-serving-portflag togcloud compute health-checks http create,https create,http2 create, andssl createcommands.- Flags:
--use-serving-port - File: RELEASE_NOTES:92
- Flags:
- The
source-instanceflags (--source-instance,--source-instance-zone,--configure-disk) ofgcloud compute instance-templates createcommand were promoted to GA.- Flags:
--source-instance,--source-instance-zone,--configure-disk - File: RELEASE_NOTES:97
- Flags:
- The
gcloud compute network-endpoint-groupscommand group was promoted to beta.- File: RELEASE_NOTES:80
- The
--network-endpoint-groupand--network-endpoint-group-zoneflags were promoted to beta forgcloud compute backend-services add-backend,remove-backend, andupdate-backend.- Flags:
--network-endpoint-group,--network-endpoint-group-zone - File: RELEASE_NOTES:83
- Flags:
- The
--max-connections-per-endpointand--max-rate-per-endpointflags were promoted to beta forgcloud compute backend-services add-backendandupdate-backend.- Flags:
--max-connections-per-endpoint,--max-rate-per-endpoint - File: RELEASE_NOTES:89
- Flags:
- Added support to specify the IP type (
INTERNALorEXTERNAL) forgcloud compute scpoperations, allowingscpto use internal IP addresses.- File: scp_utils.py
- Added support for a new disk interface type
NVDIMMin theAttachedDiskmessage in the Compute alpha API. - Introduced new API to list internal IP addresses for a network, including new messages
ComputeNetworksListIpAddressesRequest,InternalIpAddress, andIpAddressesListin the Compute alpha API. - Added
requestIdfield toComputeRegionInstanceGroupManagersUpdatePerInstanceConfigsRequestfor idempotency in the Compute alpha API. - Added
drainTimeoutSecondsfield toComputeSubnetworksPatchRequestfor managing connection draining during subnetwork role swaps (e.g., for internal HTTP(S) Load Balancers) in the Compute alpha API. - Introduced new API for aggregated listing of URL maps, including new messages
ComputeUrlMapsAggregatedListRequest,UrlMapsAggregatedList, andUrlMapsScopedListin the Compute alpha API. - Added an
output-onlystatusfield, of typeInstanceGroupManagerStatus(which includes anisStablefield), to theInstanceGroupManagermessage in the Compute alpha API, to provide information about the manager’s operational state. - Added an
output-onlysizefield to theNodeGroupmessage in the Compute alpha API, indicating the total number of nodes in the group. - Added an
output-onlystatefield, of typeStateValueValuesEnum(withDRAININGandREADYvalues), to theSubnetworkmessage in the Compute alpha API, indicating the subnetwork’s operational state. - Added new IAM policy methods (
GetIamPolicy,SetIamPolicy) for Disks, Images, Instance Templates, Instances, and Snapshots in the Compute beta API, enabling fine-grained access control management for these resources. - Introduced comprehensive API support for managing Node Groups, Node Templates, and Node Types in the
v1API. This includes new servicesNodeGroupsService,NodeTemplatesService, andNodeTypesServicewith methods likeAddNodes,DeleteNodes,SetNodeTemplatefor Node Groups, andInsert,Delete,Get,Listoperations for all three resource types.- File: compute_v1_client.py:65
- Added
GetIamPolicyandSetIamPolicyAPI request messages forDisks,Images,Instance Templates,Instances, andSnapshotsin thebetaAPI, enabling IAM policy management for these Compute Engine resources. - Added a new
portSpecificationfield andPortSpecificationValueValuesEnumto theTCPHealthCheckmessage in thebetaAPI, allowing more flexible port selection for health checks (options includeUSE_FIXED_PORT,USE_NAMED_PORT,USE_SERVING_PORT). - New API methods and schemas for Node Group management have been introduced, including
ComputeNodeGroupsAddNodesRequestandComputeNodeGroupsAggregatedListRequest, along with new resource collectionsNODEGROUPS,NODETEMPLATES, andNODETYPES.- File: resources.py:222
- Added new API method
compute.networks.listIpAddressesto list internal IP addresses in a specified network, supporting various filter types (SUBNETWORK,RESERVED, etc.).- File: compute_alpha.json:37038
- Added new API method
compute.urlMaps.aggregatedListto retrieve allUrlMapresources (regional and global) for a project.- File: compute_alpha.json:49007
- The
compute.subnetworks.patchmethod now supports adrainTimeoutSecondsparameter to specify the time allowed for draining connections from a subnetwork when transitioning its role.- File: compute_alpha.json:46293
- The
InstanceGroupManagerresource now includes anOutput Onlystatusfield, providing detailed information about the stability of the managed instance group through the newInstanceGroupManagerStatusschema.- File: compute_alpha.json:8094
- The
NodeGroupresource now includes anOutput Onlysizefield, indicating the total number of nodes in the group.- File: compute_alpha.json:13503
- The
Subnetworkresource now includes anOutput Onlystatefield, which can beREADYorDRAINING.- File: compute_alpha.json:20432
- IAM policy management has been added for
disks,images,instanceTemplates,instances, andsnapshotsresources, with newgetIamPolicyandsetIamPolicymethods.- File: compute_beta.json
- The
NodeGroupresource now includes ansizefield to report the total number of nodes in the group.- File: compute_beta.json:11402
- The
TcpHealthCheckresource now includes aportSpecificationfield, allowing explicit control over how ports are selected for health checking, with options likeUSE_FIXED_PORT,USE_NAMED_PORT, andUSE_SERVING_PORT.- File: compute_beta.json:17821
Service Usage
- Introduced programmatic API calls to enable, batch enable, disable, and list Google Cloud services.
- File: serviceusage.py:23
Compute Engine (Load Balancing)
- The
--load-balancing-schemeflag for backend services and forwarding rules now supportsINTERNAL_SELF_MANAGED(alpha), likely for Traffic Director integration.- Flags:
--load-balancing-scheme - File: flags.py:181
- Flags:
- The
--portsflag for forwarding rules now supports a more flexible input, including the keywordALLand multiple comma-separated port ranges (alpha).- Flags:
--ports - File: flags.py:365
- Flags:
Compute Engine (VPC Network Peering)
- Added new flags for configuring custom route import and export in VPC network peering connections.
- Flags:
--import-custom-routes,--export-custom-routes - File: flags.py:19
- Flags:
Cloud SQL
- A comprehensive set of new flags to configure various aspects of Cloud SQL instances, including private IP, maintenance windows, replica settings, binary logging, instance resources, and database versions.
- Flags:
--assign-private-ip,--no-assign-private-ip,--connect-mode,--enable-google-root-certificates,--maintenance-window-day,--maintenance-window-hour,--network,--private-ip-address,--recreate-replica,--replica-activation-policy,--root-password,--enable-binlog,--force-restart,--instance-maintenance-version,--no-enable-binlog,--availability-type,--cpu-type,--memory-type,--storage-size,--database-version,--storage-auto-increase,--no-storage-auto-increase - File: flags.py:360
- Flags:
- Added a new group of flags (
--source-ip-address,--source-port,--master-username,--master-password,--prompt-for-master-password,--master-dump-file-path,--master-ca-certificate-path,--client-certificate-path,--client-key-path) for configuring external primary instances and creating replicas of them.- Flags:
--source-ip-address,--source-port,--master-username,--master-password,--prompt-for-master-password,--master-dump-file-path,--master-ca-certificate-path,--client-certificate-path,--client-key-path - File: flags.py
- Flags:
- Added the
--networkflag for specifying the VPC network an instance will be part of.- Flags:
--network - File: flags.py
- Flags:
VPC Access
- New API client and message definitions (
v1alpha1) are added, indicating the introduction of the Cloud VPC Access service, which allows serverless environments to connect to VPC networks. - Initial groundwork for VPC Access API (
vpcaccess) atv1alpha1has been added to the SDK.- File: apis_map.py:737
Binary Authorization
- Added new resource specifications and presentation for
attestors, laying groundwork for newgcloud container binauthz attestorscommands (beta).- File: flags.py
- Added client library for Binary Authorization API
v1beta1, enabling management ofattestorsand project-levelpolicies. This includes operations such as creating, deleting, getting, listing, and updatingattestors, as well as getting and updating the projectpolicy. - Initial release of the Binary Authorization API (v1beta1), enabling the creation and management of policies, admission rules, attestors, and public keys for enforcing container image deployment policies.
- Registers the
v1beta1API for Binary Authorization, alongside the existingv1alpha1.- File: regen_apis_config.yaml
Kubernetes Engine
- The
--addonsflag now supports different addon options based on the release track (alpha vs. beta/GA).- Flags:
--addons - File: flags.py
- Flags:
- Added the
desiredLoggingServicefield toClusterUpdatemessages, allowing users to configure the logging service for a cluster with options likelogging.googleapis.com/kubernetes,logging.googleapis.com, ornone. - Expanded the description for the
desiredMonitoringServicefield inClusterUpdatemessages to explicitly mentionmonitoring.googleapis.com/kubernetesfor Kubernetes-native resource model in Stackdriver. - Added the
desiredLoggingServicefield toClusterUpdatemessages (v1beta1), allowing users to configure the logging service for a cluster with options likelogging.googleapis.com/kubernetes,logging.googleapis.com, ornone. - Expanded the description for the
desiredMonitoringServicefield inClusterUpdatemessages (v1beta1) to explicitly mentionmonitoring.googleapis.com/kubernetesfor Kubernetes-native resource model in Stackdriver.
Dataproc
- Introduced
--sourceand--destinationflags for workflow templates, enabling importing and exporting of templates from/to YAML files.- Flags:
--source,--destination - File: flags.py
- Flags:
- The
--parametersflag for workflow templates is no longer hidden, making it generally available.- Flags:
--parameters - File: flags.py
- Flags:
Filestore
- Updated the list format for Filestore instances to use
FILE_SHARE_NAMEinstead ofVOLUME_NAMEand adjusted the upper bound for file share capacity.- File: flags.py
- Added new functions
AddInstanceCreateArgsandAddInstanceUpdateArgsto simplify adding arguments for creating and updating Filestore instances, including description, tier, file share, network, and labels.- File: flags.py
Core/Framework
- Introduced a new abstraction (
ProgressTrackerSymbols) for console spinner characters, enabling the use of Unicode spinner characters (e.g.,⠏,⠛) when supported by the terminal. Otherwise, ASCII characters (|,/,-,\) are used.- File: console_attr.py:161
Cloud Composer
- Initial client library for the Cloud Composer API (v1) was added, providing programmatic methods for creating, deleting, getting, listing, and patching environments, as well as managing long-running operations.
- File: composer_v1_client.py:1
- Introduction of the Cloud Composer v1 API, providing programmatic management of Apache Airflow environments. This includes operations for creating, getting, listing, updating, and deleting environments, as well as managing environment configurations (e.g., node configuration, software packages, Airflow overrides, environment variables).
- Registers the
v1API as the default version for Cloud Composer.- File: regen_apis_config.yaml
Service Networking
- Introduced the new
v1betaAPI for Service Networking. This includes new client services for operations, service connections, and services, offering methods such asservicenetworking.operations.get,servicenetworking.services.connections.create,servicenetworking.services.connections.list, andservicenetworking.services.addSubnetworkto manage VPC network peering connections and subnets. - Introduced messages for the
v1betaversion of the Service Networking API, includingAddSubnetworkRequestandAddSubnetworkResponse, indicating new functionality for managing (adding) subnetworks in peered service networks. - Introduction of the Service Networking API (v1beta), enabling automatic management of network configurations for certain services.
- Registers the
v1betaAPI as the default version for Service Networking.- File: regen_apis_config.yaml
Serverless VPC Access
- Introduction of the Serverless VPC Access API (v1alpha1) for managing VPC Access connectors, including operations like creating, deleting, getting, and listing connectors.
- Introduces the
v1alpha1API for Serverless VPC Access, enabling the creation, retrieval, listing, and deletion of VPC access connectors.- File: vpcaccess_v1alpha1.json
Credential & Auth Changes
- The
http.Httpclient, used for making API requests, now supports specifying custom CA certificates through a newca_certsargument. This allows for more flexible certificate trust store configurations, potentially for enterprise environments or custom proxies.- File: http.py:8
- Introduced flags for specifying master credentials (
--master-username,--master-password,--prompt-for-master-password) and SSL certificates (--master-ca-certificate-path,--client-certificate-path,--client-key-path) when configuring Cloud SQL external primary instances and their replicas.- File: flags.py
- The core HTTP client now supports explicit CA certificate file specification via a new
ca_certsparameter, which is overridden by thecore/custom_ca_certs_filegcloud configuration property.- File: http.py:41
- The HTTP client used for credentials now also accepts an explicit
ca_certsargument.- File: http.py:36
API Changes
Compute Engine
- Extensive updates to Compute Engine API messages for alpha, beta, and v1, supporting new features like KMS integration for boot disks, network endpoint groups, and health check configurations.
- Significant updates to
compute_v1_messages.pyandcompute_v1.json, indicating changes to the Compute Engine v1 API, alongside updates to alpha and beta clients/messages.- File: compute_v1_messages.py
- Clarified the descriptions for
signedUrlCacheMaxAgeSecandsignedUrlKeyNamesfields inBackendBucketCdnPolicyandBackendServiceCdnPolicymessages in the Compute alpha API for better understanding of Cloud CDN signed URL behavior. - Updated the description for the
conditionfield in theBindingmessage in the Compute alpha API, explicitly marking it asUnimplementedand removing mentions of internal visibility. - Expanded and clarified the descriptions for
filter,maxResults,order_by, andpageTokenquery parameters in several list request messages (ComputeInstanceGroupManagersListManagedInstancesRequest,ComputeProjectsGetXpnResourcesRequest,ComputeProjectsListXpnHostsRequest,ComputeRegionInstanceGroupManagersListManagedInstancesRequest) in the Compute alpha API. - Updated the docstrings for
BackendBucketsService.AddSignedUrlKeyandBackendBucketsService.DeleteSignedUrlKeymethods in the Compute beta API for clarity on adding/deleting keys for signed URL validation. - Updated the docstrings for
BackendServicesService.AddSignedUrlKeyandBackendServicesService.DeleteSignedUrlKeymethods in the Compute beta API for clarity on adding/deleting keys for signed URL validation. - Added the
sizefield (output only, integer) to theNodeGroupmessage in thebetaAPI, indicating the total number of nodes in the node group. - Descriptions for
signedUrlCacheMaxAgeSecandsignedUrlKeyNamesinBackendBucketCdnPolicyandBackendServiceCdnPolicyhave been clarified for better understanding of Cloud CDN signed URL caching behavior. - Expanded and clarified descriptions for common list request parameters (
filter,maxResults,order_by,pageToken) across several Compute Engine API methods, includingcompute.instanceGroupManagers.listManagedInstances. - Added
NVDIMMas a new supported disk interface type within thecompute_alpha.jsonAPI.- File: compute_alpha.json:1064
- The description for
Binding.conditionin IAM policies has been updated to explicitly state that it is ‘Unimplemented’ incompute_alpha.json.- File: compute_alpha.json:2752
- Clarified descriptions for the
addSignedUrlKeyanddeleteSignedUrlKeymethods on backend buckets and backend services.- File: compute_alpha.json:25891
- The Compute Engine Beta API revision has been updated from
20180620to20180701.- File: compute_beta.json:7
- Descriptions for
signedUrlCacheMaxAgeSecandsignedUrlKeyNamesinBackendBucketandBackendServiceresources have been clarified to better explain their function in Cloud CDN Signed URLs.- File: compute_beta.json:1891
- The description for the
conditionfield within IAMBindinghas been updated to mark it as ‘Unimplemented’, changing from a previous internal visibility note.- File: compute_beta.json:2563
- A new schema
GlobalSetPolicyRequesthas been introduced, includingbindings,etag, and a primarypolicyfield for setting IAM policies globally, withbindingsandetagdeprecated in favor ofpolicy.- File: compute_beta.json:4988
- The
SecurityPolicydescription has been updated with an internal tag reference(== resource_for beta.securityPolicies ==).- File: compute_beta.json:16341
- Descriptions for
addSignedUrlKeyanddeleteSignedUrlKeymethods onbackendBucketsandbackendServiceshave been updated for clarity.- File: compute_beta.json:22082
- Expanded descriptions and examples have been added for common list query parameters (
filter,maxResults,order_by,pageToken) across multiple Compute Engine list methods.- File: compute_beta.json:26340
- Clarified the descriptions for
signedUrlCacheMaxAgeSecandsignedUrlKeyNameswithinBackendBucketCdnPolicyandBackendServiceCdnPolicyto improve accuracy regarding Cloud CDN Signed URL behavior.- File: compute_v1.json:1740
- Introduced a new
NodeGroupAPI resource schema, defining properties such ascreationTimestamp,description,id,kind,name,nodeTemplate,selfLink, andsize.- File: compute_v1.json:9925
Cloud Functions
cloudfunctions_v1_messages.pywas updated to includeenvironmentVariablessupport for Cloud Functions.- Updates to
cloudfunctions_v1_messages.pyandcloudfunctions_v1.json, indicating changes to the Cloud Functions v1 API. - Added new fields
environmentVariablesandnetworkto theCloudFunctionmessage forcloudfunctions/v1. TheenvironmentVariablesfield allows setting runtime environment variables, and thenetworkfield enables VPC network connectivity for functions.
Cloud Filestore
- Introduction of the
file/v1beta1API client, messages, and schema, enabling management of Filestore instances.- File: file_v1beta1_client.py:1
- Full API client and message definitions for Cloud Filestore
v1beta1are added, indicating its promotion to beta. This also includes a change in attribute name frominstance.volumestoinstance.fileSharesfor file share configurations.- File: file_v1beta1_client.py
Cloud Composer
- Introduction of the
composer/v1API client, messages, and schema.- File: composer_v1_client.py:1
- New API client, messages, and resources (
composer/v1) were generated for Cloud Composer.- File: init.py
- Added the
composer/v1API client (ComposerV1) and its associated messages and resources, defining the API for managing Cloud Composer environments and operations.- File: composer_v1_client.py:1
- Added new API definitions for Cloud Composer v1, including message classes such as
Environment,EnvironmentConfig,NodeConfig,SoftwareConfig,Operation,OperationMetadata, and request/response messages for environment and operation management. This also introduces resource collections forprojects,projects.locations,projects.locations.environments, andprojects.locations.operations. - Added the entire API definition for Cloud Composer v1, enabling management of Apache Airflow environments. This includes schemas for
Environment,EnvironmentConfig,SoftwareConfig,NodeConfig, and methods for creating, getting, listing, patching, and deleting environments, as well as listing, getting, and deleting operations.- File: composer_v1.json:1
- Updated
regen_apis_config.yamlto register and setcomposer:v1as the default API version.- File: regen_apis_config.yaml
Service Networking
- Introduction of the
servicenetworking/v1betaAPI client, messages, and schema. - Full API client and message definitions for Service Networking
v1betaare added, confirming its promotion from alpha. The API method for creating connections has changed fromservices.Peertoservices_connections.Create. - New API client, messages, and resources (
servicenetworking/v1beta) were generated, indicating the introduction or significant update of the Service Networking API.- File: init.py
- Service Networking API
v1betahas been added and set as the new default API version.v1alphais no longer the default.- File: apis_map.py:594
- The
MetricDescriptorschema in theservicenetworking/v1alphaAPI has been updated to include an optionalmetadatafield, which references a newMetricDescriptorMetadatamessage type. This new metadata structure provides fields foringestDelay,launchStage, andsamplePeriodto guide metric usage. - Introduced the
v1betaversion of the Service Networking API by adding new message definitions inservicenetworking_v1beta_messages.py. This new API version includes messages for operations such asAddSubnetworkRequest,AddSubnetworkResponse, and general API definition components likeApiandAuthProvider. - Updated the
v1alphaService Networking API schema (servicenetworking_v1alpha.json) to include ametadatafield withinMetricDescriptorand introduced the newMetricDescriptorMetadataschema. This new metadata includeslaunchStage,samplePeriod, andingestDelayfor providing richer context about API metrics. - Updated
regen_apis_config.yamlto register and setservicenetworking:v1betaas the default API version.- File: regen_apis_config.yaml
VPC Access
- Introduction of the
vpcaccess/v1alpha1API client, messages, and schema. - New API client and message definitions (
v1alpha1) are added for the Cloud VPC Access service, signifying its introduction. - New API client, messages, and resources (
vpcaccess/v1alpha1) were generated for VPC Access, indicating a new VPC Access API version.- File: init.py
Binary Authorization
- The Binary Authorization API introduced a
v1beta1version for attestors, including new client and message definitions. This updates resource names fromattestationAuthoritiestoattestorsin API calls.- File: authorities.py:28
- New API client, messages, and resources (
binaryauthorization/v1beta1) were generated, indicating the introduction or significant update of the Binary Authorization API.- File: init.py
- Added API definition for
binaryauthorization/v1beta1.- File: apis_map.py:140
- Introduced new
binaryauthorization_v1beta1_client.pywith methods forprojects.attestors(Create, Delete, Get, GetIamPolicy, List, SetIamPolicy, TestIamPermissions, Update) andprojects.policy(GetIamPolicy, SetIamPolicy, TestIamPermissions, GetPolicy, UpdatePolicy). - Added new API message classes for
binaryauthorization/v1beta1, includingAdmissionRule,Attestor,Policy,UserOwnedDrydockNote, and IAM-related messages (IamPolicy,Binding). - Added resource definitions for
binaryauthorization/v1beta1, defining collections forPROJECTS,PROJECTS_ATTESTORS, andPROJECTS_POLICY.- File: resources.py:27
- Introduced the complete
binaryauthorization:v1beta1API definition, including new schemas forPolicy,AdmissionWhitelistPattern,AdmissionRule,Attestor,UserOwnedDrydockNote,AttestorPublicKey, and resource methods forprojects.policyandprojects.attestors(e.g.,create,get,update,delete,list,setIamPolicy,getIamPolicy,testIamPermissions). - Updated
regen_apis_config.yamlto registerbinaryauthorization:v1beta1.- File: regen_apis_config.yaml
Filestore
- New API client, messages, and resources (
file/v1beta1) were generated for Filestore, suggesting a new Filestore API version.- File: file_v1beta1_client.py
Cloud Tasks
- Updates to
cloudtasks_v2beta2_client.pyandcloudtasks_v2beta2_messages.py, indicating changes to the Cloud Tasks v2beta2 API. - Removed the
orderByquery parameter from thecloudtasks.projects.locations.queues.tasks.listmethod forcloudtasks/v2beta2.
Container Engine
- Updates to
container_v1alpha1_messages.pyandcontainer_v1beta1_messages.py, indicating changes to Container Engine alpha and beta APIs.
Composer
- Composer API
v1has been added and set as the new default API version.v1beta1is no longer the default.- File: apis_map.py:284
Compute Engine (Alpha)
- Added a new
compute.networks.ListIpAddressesmethod to list internal IP addresses in a specified network. - Added
requestIdas a query parameter for thecompute.regionInstanceGroupManagers.updatePerInstanceConfigsmethod. - Added
drainTimeoutSecondsas a query parameter for thecompute.subnetworks.patchmethod. - Added a new
compute.urlMaps.AggregatedListmethod to retrieve a list of all UrlMap resources, both regional and global.
Cloud Logging
- The
MetricDescriptorschema in thelogging/v2API has been updated to include an optionalmetadatafield, which references a newMetricDescriptorMetadatamessage type. This new metadata structure provides fields foringestDelay,launchStage, andsamplePeriodto guide metric usage.
Service Management
- The
MetricDescriptorschema in theservicemanagement/v1API has been updated to include an optionalmetadatafield, which references a newMetricDescriptorMetadatamessage type. This new metadata structure provides fields foringestDelay,launchStage, andsamplePeriodto guide metric usage.
Service User
- The
MetricDescriptorschema in the Service User API (v1) now includes an optionalmetadatafield, which references a newMetricDescriptorMetadataobject. This metadata object provides fields foringestDelay,launchStage, andsamplePeriodto guide metric usage.
SQL Admin
- Minor API revision update for
sqladmin_v1beta4.- File: sqladmin_v1beta4.json:7
Cloud Storage
- Minor API revision update for
storage_v1.- File: storage_v1.json:4
Cloud Tool Results
- Minor API revision update for
toolresults_v1beta3.
Serverless VPC Access
- Added the new
vpcaccess:v1alpha1API definition and registered it in the API configuration.- File: vpcaccess_v1alpha1.json
Unannounced Changes
Changes found in code but not mentioned in official release notes: 🕵️
Hidden Feature
- The
SERVERLESSaddon (which auto-enables Istio if not specified) was added as an alpha addon option for Kubernetes Engine clusters.- File: api_adapter.py:125
- Added a hidden flag
--resource-usage-bigquery-datasetto export cluster resource usage to BigQuery for Kubernetes Engine.- File: flags.py
- Added a hidden flag
--connected-vpcto specify the VPC network for Cloud Functions.- File: flags.py
- Added hidden flags
--max-instancesand--clear-max-instancesfor Cloud Functions to control the maximum number of function instances.- File: flags.py
- The
environmentVariablesfield was added to theCloudFunctionmessage incloudfunctions/v1, explicitly described in the API definition as a ‘Beta Feature’. - The
networkfield was added to theCloudFunctionmessage incloudfunctions/v1, explicitly described in the API definition as an ‘Alpha feature, available only for whitelisted users’. - Added new
getIamPolicyandsetIamPolicymethods fordisks, allowing granular IAM policy management for individual disks.- File: compute_beta.json:23278
- Added new
getIamPolicyandsetIamPolicymethods forimages, allowing granular IAM policy management for individual images.- File: compute_beta.json:25969
- Added new
getIamPolicyandsetIamPolicymethods forinstanceTemplates, allowing granular IAM policy management for individual instance templates.- File: compute_beta.json:27579
- Added new
getIamPolicyandsetIamPolicymethods forinstances, allowing granular IAM policy management for individual instances.- File: compute_beta.json:28132
- Added new
getIamPolicyandsetIamPolicymethods forsnapshots, allowing granular IAM policy management for individual snapshots.- File: compute_beta.json:37035
- Added
sizefield to theNodeGroupresource.- File: compute_beta.json:11402
- Added
portSpecificationfield toTcpHealthCheckfor advanced port selection in health checks.- File: compute_beta.json:17821
- The API description for
GoogleCloudMlV1TrainingInput.masterTypeandGoogleCloudMlV1TrainingInput.scaleTierin theml/v1API has been updated to remove mentions of Cloud TPU being in theBetalaunch stage, suggesting a potential move to General Availability.- File: ml_v1_messages.py:962
Groundwork
- Added
resource_usage_bigquery_datasetoption toCreateClusterOptionsin Kubernetes Engine, allowing configuration of BigQuery export for cluster resource usage.- File: api_adapter.py:352
- A new
serviceusage.pymodule was introduced with substantial additions, indicating groundwork for new service management capabilities.- File: serviceusage.py:1
- A new
ssh/ip.pymodule was added, likely providing improved utilities for SSH IP address handling.- File: ip.py:1
- Added new YAML schema definition for Dataproc Workflow Templates v1beta2, detailing the structure for jobs, labels, placement, and parameters. This is groundwork for the new Workflow Template feature.
- Changes to Calliope’s concept dependency resolution (
deps.py) to allow more explicit control and better type handling for plural (list) values in fallthroughs for resource arguments.- File: deps.py:60
- New module structure for
gcloud compute networks peeringscommands.- File: init.py
- Addition of
AddCreateRouterArgsForAlphasuggests future alpha features for router creation, mirroring the existingAddCreateRouterArgs.- File: flags.py:98
- Addition of
ClearScreenfunction for console manipulation, potentially for interactive commands or visual output.- File: console_attr.py:287
- New modules
command_lib/functions/deploy/env_vars_util.pywere added to manage environment variables for Cloud Functions, indicating new functionality not yet fully announced.- File: env_vars_util.py
- Introduced new files and updated existing ones to generate static completion CLI trees, which is an internal improvement for gcloud’s tab completion.
- File: generate.py
- New file
export.pyintroduces utilities for generating YAML schemas forgcloud export/importcommands, providing a standardized way to define and validate resource configurations.- File: export.py:0
- New file
map_util.pyintroduces utility functions (AddMapUpdateFlag,AddMapRemoveFlag,AddMapClearFlag,AddMapSetFlag,AddMapSetFileFlag) to standardize handling of dictionary-like arguments on the command line (e.g.,--update-labels=KEY=VALUE).- File: map_util.py:0
- New file
ip.pyintroduces anIpTypeEnumforINTERNALandEXTERNALIP addresses, likely for future use in networking-related commands.- File: ip.py:0
- The
data/clidirectory, which likely contains the static completion CLI tree, is now included in the SDK’s Python compilation process.- File: local_state.py:605
- Complete new API client, messages, and resource definitions for the
Binary Authorization v1beta1service have been added, providing functionality for managing attestors and policies. - Initial groundwork for the new Cloud Composer service API includes the creation of the
composer/v1package marker and theComposerV1client library.- File: composer_v1_client.py:1
- New API client and message definitions for Cloud Composer v1 have been added. This groundwork enables comprehensive programmatic control over Composer environments, including detailed configuration options for nodes and software within the environment. This is a significant addition not mentioned in the release notes.
- An internal annotation was added to the
SecurityPolicyclass description in the Compute alpha API ((== resource_for beta.securityPolicies ==)). - Introduced the
GlobalSetPolicyRequestmessage in thebetaAPI, defining fields forbindings,etag, andpolicy, which serves as groundwork for the new IAM policy management functionality. - The
compute_alpha.jsonAPI revision has been updated to20180701.- File: compute_alpha.json:7
- The
requestIdparameter has been added to thecompute.nodeGroups.addNodesmethod for idempotency.- File: compute_alpha.json:41694
- Minor description clarification for the
SecurityPolicyschema.- File: compute_alpha.json:18720
- New
GlobalSetPolicyRequestschema with deprecatedbindingsandetagfields in favor of a newpolicyfield for more unified IAM policy setting.- File: compute_beta.json:4988
- Updated the Compute Engine API
v1revision from20180620to20180701.- File: compute_v1.json:4
- Updated Kubernetes Engine API
v1alpha1andv1beta1revisions from20180620to20180701.- File: v1alpha1.json:4
- Updated Deployment Manager API revisions (
alpha,v2,v2beta) from20180620to20180622. - Updated DNS API revisions (
v1,v1alpha2,v1beta1,v1beta2,v2beta1) from20180620to20180622.- File: dns_v1.json:4
- Added new
v1betaAPI definitions for the Service Networking API, including message classes such asAddSubnetworkRequest,AddSubnetworkResponse,Api, andAuthProvider. This is foundational work for new features in service networking. - Updated the
v1alphaService Networking API schema by addingmetadatatoMetricDescriptorand defining a newMetricDescriptorMetadataobject with fields likelaunchStage,samplePeriod, andingestDelay. This enhances metric reporting capabilities. - Added new Python package structures for the
vpcaccessAPI, including__init__.pyandresources.pyfiles forv1alpha1.- File: init.py:1
- Updated
regen_apis_config.yamlto includevpcaccess: v1alpha1andservicenetworking: v1beta, indicating these APIs are now part of the SDK’s auto-generated API clients.- File: regen_apis_config.yaml:1
- Complete addition of the
vpcaccess:v1alpha1API, including schemas for connectors, operations, and locations, indicating the introduction of Serverless VPC Access functionality.- File: vpcaccess_v1alpha1.json
- Registration of
composer:v1as the default API version for Cloud Composer inregen_apis_config.yaml.- File: regen_apis_config.yaml
- Registration of
servicenetworking:v1betaas the default API version for Service Networking inregen_apis_config.yaml.- File: regen_apis_config.yaml
- Registration of the
binaryauthorization:v1beta1API inregen_apis_config.yaml.- File: regen_apis_config.yaml
Refactoring
- The internal
Createmethod forNetworkEndpointGroupsClientin Compute Engine was refactored, removing theneg_typeparameter. - Deletions were observed in Cloud TPU API client, messages, and JSON files (
tpu/v1andv1alpha1), indicating internal cleanup or re-organization of the API definitions.- File: tpu_v1_client.py:27
- Refactored
dataproc/util.pyto support schema-based YAML validation usingjsonschema(via_ValidateYamlfunction) and introduced stream-based YAML reading and writing (ReadYaml,WriteYaml,MessageToYaml). This enhances flexibility for handling Dataproc configurations, especially for the new Workflow Templates.- File: util.py:17
- Minor refactoring in
datastore/operations.pyto simplify the instantiation ofwaiter.CloudOperationPollerNoResourcesby removing a redundant lambda function.- File: operations.py:87
- Refactored
dns/transaction_util.pyto usegooglecloudsdk.core.util.files.FileReaderandfiles.FileWriterfor transaction file handling, standardizing file I/O operations.- File: transaction_util.py:142
- Extensive refactoring in the Cloud Filestore client (
filestore_client.py) to support multiple API versions (alpha, beta) using an adapter pattern. New internal constants and utility functions for API client retrieval were introduced.- File: filestore_client.py:18
- Improved error messages for
403 Forbiddenerrors in Cloud Functions by extracting and displaying specific permission details.- File: util.py:120
- The
subprocess.check_outputcall forgit versionis now wrapped withencoding.Decodeto prevent UnicodeDecodeErrors.- File: git.py:99
- Added a warning for unspecified IP allocation policy (
--enable-ip-alias) during Kubernetes Engine cluster creation, indicating a future default change.- File: flags.py
- Refactored
RowDataParserand added_StripQuotesfor more robust parsing of column values in Spanner write operations.- File: write_util.py
- Refactored the static completion lookup logic, changing
FLAG_*constants from integers to strings and removing_GetFlagModefunction. This includes internal changes to_FindCompletionsand new helper functions for loading completion data.- File: lookup.py:20
- Internal refactoring in
ResourceInfofor concept fallthroughs, ensuringpluralis consistently set andcopy.deepcopyis used for fallthroughs.- File: info_holders.py:17
- Internal changes to
_ConsoleWriterto allow immediate flushing of output, which is now enabled forstderr_writerto ensure critical errors are displayed promptly.- File: log.py:140
- Refinements to
resource_expr.pyto disable deprecated diff warnings for dictionary attributes during resource expression matching, improving stability.- File: resource_expr.py:119
- Major internal refactoring in
resource_projector.pyto improve recursive object detection during resource projection by switching from a list to a set and using objectid()s.- File: resource_projector.py:65
- Improved precision and consistency for
DateTimefractional second formatting intimes.pyby using integer-based rounding, addressing potential floating-point discrepancies.- File: times.py:330
- Refined descriptions for
AddSignedUrlKeyandDeleteSignedUrlKeymethods inbackendBucketsandbackendServicesto clarify their purpose for validating requests with signed URLs. - Expanded the descriptions for common listing parameters (
filter,maxResults,order_by,pageToken) across variousComputeAPI request messages (e.g.,ComputeInstanceGroupManagersListManagedInstancesRequest,ComputeProjectsGetXpnResourcesRequest), providing more detailed guidance on their usage. - Clarified the description of the
conditionfield within theBindingmessage, explicitly stating it is ‘Unimplemented’ and removing previous notes about internal or trusted tester visibility. - Minor rewording of descriptions for
AddSignedUrlKeyandDeleteSignedUrlKeymethods in bothBackendBucketsServiceandBackendServicesService(v1client) to be more precise about ‘validating requests with signed URLs’.- File: compute_v1_client.py:521
- Added an internal
resource_fortag to the description of theSecurityPolicymessage in thebetaAPI, likely for tooling or metadata purposes. - Expanded and clarified descriptions for common list query parameters (
filter,maxResults,order_by,pageToken) in various Compute Engine list methods.- File: compute_beta.json:26340
- Removed the generic
Operationschema definition fromcompute_v1.json. This is likely a refactoring to consolidateOperationdefinitions or to generate them differently.- File: compute_v1.json:9925
- The
replicapoolupdater_v1beta1.jsonAPI definition received a minor revision update from20180620to20180622.
Feature Flag
- The
--neg-typeflag in network endpoint groups is now conditionally added, hinting at feature gating for different API versions or tracks. It remains hidden and defaults to ’load-balancing’.- File: flags.py:28
Stats
- Files changed: 157
- Inserted lines: +35,295
- Deleted lines: -13,356
Generated by Gemini - View full diff
Google, Google Cloud, and gcloud are trademarks of Google LLC. This analysis was automatically generated by an AI agent examining only public release artifacts, without access to internal or non-public information from Google Cloud.