diff --git a/docs/_static/custom.css b/docs/_static/custom.css index 9a6f9f8d..0abaf229 100644 --- a/docs/_static/custom.css +++ b/docs/_static/custom.css @@ -1,4 +1,4 @@ div#python2-eol { border-color: red; border-width: medium; -} \ No newline at end of file +} \ No newline at end of file diff --git a/docs/_templates/layout.html b/docs/_templates/layout.html index de457b2c..228529ef 100644 --- a/docs/_templates/layout.html +++ b/docs/_templates/layout.html @@ -1,3 +1,4 @@ + {% extends "!layout.html" %} {%- block content %} {%- if theme_fixed_sidebar|lower == 'true' %} diff --git a/google/cloud/container_v1/gapic/cluster_manager_client.py b/google/cloud/container_v1/gapic/cluster_manager_client.py index dec1e8ac..c7894cd2 100644 --- a/google/cloud/container_v1/gapic/cluster_manager_client.py +++ b/google/cloud/container_v1/gapic/cluster_manager_client.py @@ -16,6 +16,7 @@ """Accesses the google.container.v1 ClusterManager API.""" +import functools import pkg_resources import warnings @@ -26,6 +27,7 @@ import google.api_core.gapic_v1.method import google.api_core.gapic_v1.routing_header import google.api_core.grpc_helpers +import google.api_core.page_iterator import grpc from google.cloud.container_v1.gapic import cluster_manager_client_config @@ -211,10 +213,10 @@ def list_clusters( >>> response = client.list_clusters(project_id, zone) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the parent field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the parent field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides, or "-" for all zones. This field has been deprecated and replaced by the parent field. @@ -301,14 +303,14 @@ def get_cluster( >>> response = client.get_cluster(project_id, zone, cluster_id) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster to retrieve. + cluster_id (str): Required. Deprecated. The name of the cluster to retrieve. This field has been deprecated and replaced by the name field. name (str): The name (project, location, cluster) of the cluster to retrieve. Specified in the format 'projects/*/locations/*/clusters/\*'. @@ -380,11 +382,11 @@ def create_cluster( network `__. One firewall is added for the cluster. After cluster creation, the - cluster creates routes for each node to allow the containers on that + Kubelet creates routes for each node to allow the containers on that node to communicate with all other instances in the cluster. Finally, an entry is added to the project's global metadata indicating - which CIDR range is being used by the cluster. + which CIDR range the cluster is using. Example: >>> from google.cloud import container_v1 @@ -403,14 +405,14 @@ def create_cluster( >>> response = client.create_cluster(project_id, zone, cluster) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the parent field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the parent field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the parent field. - cluster (Union[dict, ~google.cloud.container_v1.types.Cluster]): A `cluster + cluster (Union[dict, ~google.cloud.container_v1.types.Cluster]): Required. A `cluster resource `__ If a dict is provided, it must be of the same form as the protobuf @@ -501,16 +503,16 @@ def update_cluster( >>> response = client.update_cluster(project_id, zone, cluster_id, update) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster to upgrade. + cluster_id (str): Required. Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field. - update (Union[dict, ~google.cloud.container_v1.types.ClusterUpdate]): A description of the update. + update (Union[dict, ~google.cloud.container_v1.types.ClusterUpdate]): Required. A description of the update. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.container_v1.types.ClusterUpdate` @@ -584,7 +586,7 @@ def update_node_pool( metadata=None, ): """ - Updates the version and/or image type for a specific node pool. + Updates the version and/or image type for the specified node pool. Example: >>> from google.cloud import container_v1 @@ -612,18 +614,18 @@ def update_node_pool( >>> response = client.update_node_pool(project_id, zone, cluster_id, node_pool_id, node_version, image_type) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster to upgrade. + cluster_id (str): Required. Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field. - node_pool_id (str): Deprecated. The name of the node pool to upgrade. + node_pool_id (str): Required. Deprecated. The name of the node pool to upgrade. This field has been deprecated and replaced by the name field. - node_version (str): The Kubernetes version to change the nodes to (typically an + node_version (str): Required. The Kubernetes version to change the nodes to (typically an upgrade). Users may specify either explicit versions offered by Kubernetes Engine or @@ -634,7 +636,7 @@ def update_node_pool( - "1.X.Y": picks the highest valid gke.N patch in the 1.X.Y version - "1.X.Y-gke.N": picks an explicit Kubernetes version - "-": picks the Kubernetes master version - image_type (str): The desired image type for the node pool. + image_type (str): Required. The desired image type for the node pool. name (str): The name (project, location, cluster, node pool) of the node pool to update. Specified in the format 'projects/*/locations/*/clusters/*/nodePools/*'. @@ -707,7 +709,7 @@ def set_node_pool_autoscaling( metadata=None, ): """ - Sets the autoscaling settings for a specific node pool. + Sets the autoscaling settings for the specified node pool. Example: >>> from google.cloud import container_v1 @@ -732,18 +734,18 @@ def set_node_pool_autoscaling( >>> response = client.set_node_pool_autoscaling(project_id, zone, cluster_id, node_pool_id, autoscaling) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster to upgrade. + cluster_id (str): Required. Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field. - node_pool_id (str): Deprecated. The name of the node pool to upgrade. + node_pool_id (str): Required. Deprecated. The name of the node pool to upgrade. This field has been deprecated and replaced by the name field. - autoscaling (Union[dict, ~google.cloud.container_v1.types.NodePoolAutoscaling]): Autoscaling configuration for the node pool. + autoscaling (Union[dict, ~google.cloud.container_v1.types.NodePoolAutoscaling]): Required. Autoscaling configuration for the node pool. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.container_v1.types.NodePoolAutoscaling` @@ -839,17 +841,17 @@ def set_logging_service( >>> response = client.set_logging_service(project_id, zone, cluster_id, logging_service) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster to upgrade. + cluster_id (str): Required. Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field. - logging_service (str): The logging service the cluster should use to write metrics. Currently - available options: + logging_service (str): Required. The logging service the cluster should use to write metrics. + Currently available options: - "logging.googleapis.com" - the Google Cloud Logging service - "none" - no metrics will be exported from the cluster @@ -943,18 +945,20 @@ def set_monitoring_service( >>> response = client.set_monitoring_service(project_id, zone, cluster_id, monitoring_service) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster to upgrade. + cluster_id (str): Required. Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field. - monitoring_service (str): The monitoring service the cluster should use to write metrics. - Currently available options: + monitoring_service (str): Required. The monitoring service the cluster should use to write + metrics. Currently available options: + - "monitoring.googleapis.com/kubernetes" - the Google Cloud Monitoring + service with Kubernetes-native resource model - "monitoring.googleapis.com" - the Google Cloud Monitoring service - "none" - no metrics will be exported from the cluster name (str): The name (project, location, cluster) of the cluster to set monitoring. @@ -1047,16 +1051,16 @@ def set_addons_config( >>> response = client.set_addons_config(project_id, zone, cluster_id, addons_config) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster to upgrade. + cluster_id (str): Required. Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field. - addons_config (Union[dict, ~google.cloud.container_v1.types.AddonsConfig]): The desired configurations for the various addons available to run in the + addons_config (Union[dict, ~google.cloud.container_v1.types.AddonsConfig]): Required. The desired configurations for the various addons available to run in the cluster. If a dict is provided, it must be of the same form as the protobuf @@ -1151,17 +1155,17 @@ def set_locations( >>> response = client.set_locations(project_id, zone, cluster_id, locations) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster to upgrade. + cluster_id (str): Required. Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field. - locations (list[str]): The desired list of Google Compute Engine - `locations `__ in + locations (list[str]): Required. The desired list of Google Compute Engine + `zones `__ in which the cluster's nodes should be located. Changing the locations a cluster is in will result in nodes being either created or removed from the cluster, depending on whether locations are being added or removed. @@ -1257,16 +1261,16 @@ def update_master( >>> response = client.update_master(project_id, zone, cluster_id, master_version) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster to upgrade. + cluster_id (str): Required. Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field. - master_version (str): The Kubernetes version to change the master to. + master_version (str): Required. The Kubernetes version to change the master to. Users may specify either explicit versions offered by Kubernetes Engine or version aliases, which have the following behavior: @@ -1345,9 +1349,9 @@ def set_master_auth( metadata=None, ): """ - Used to set master auth materials. Currently supports :- - Changing the admin password for a specific cluster. - This can be either via password generation or explicitly set the password. + Sets master auth materials. Currently supports changing the admin password + or a specific cluster, either via password generation or explicitly setting + the password. Example: >>> from google.cloud import container_v1 @@ -1373,17 +1377,17 @@ def set_master_auth( >>> response = client.set_master_auth(project_id, zone, cluster_id, action, update) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster to upgrade. + cluster_id (str): Required. Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field. - action (~google.cloud.container_v1.types.Action): The exact form of action to be taken on the master auth. - update (Union[dict, ~google.cloud.container_v1.types.MasterAuth]): A description of the update. + action (~google.cloud.container_v1.types.Action): Required. The exact form of action to be taken on the master auth. + update (Union[dict, ~google.cloud.container_v1.types.MasterAuth]): Required. A description of the update. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.container_v1.types.MasterAuth` @@ -1461,9 +1465,9 @@ def delete_cluster( Firewalls and routes that were configured during cluster creation are also deleted. - Other Google Compute Engine resources that might be in use by the cluster - (e.g. load balancer resources) will not be deleted if they weren't present - at the initial create time. + Other Google Compute Engine resources that might be in use by the cluster, + such as load balancer resources, are not deleted if they weren't present + when the cluster was initially created. Example: >>> from google.cloud import container_v1 @@ -1482,14 +1486,14 @@ def delete_cluster( >>> response = client.delete_cluster(project_id, zone, cluster_id) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster to delete. + cluster_id (str): Required. Deprecated. The name of the cluster to delete. This field has been deprecated and replaced by the name field. name (str): The name (project, location, cluster) of the cluster to delete. Specified in the format 'projects/*/locations/*/clusters/\*'. @@ -1569,10 +1573,10 @@ def list_operations( >>> response = client.list_operations(project_id, zone) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the parent field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the parent field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ to return operations for, or ``-`` for all zones. This field has been deprecated and replaced by the parent field. @@ -1659,15 +1663,15 @@ def get_operation( >>> response = client.get_operation(project_id, zone, operation_id) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - operation_id (str): Deprecated. The server-assigned ``name`` of the operation. This field - has been deprecated and replaced by the name field. + operation_id (str): Required. Deprecated. The server-assigned ``name`` of the operation. + This field has been deprecated and replaced by the name field. name (str): The name (project, location, operation id) of the operation to get. Specified in the format 'projects/*/locations/*/operations/\*'. retry (Optional[google.api_core.retry.Retry]): A retry object used @@ -1750,15 +1754,15 @@ def cancel_operation( >>> client.cancel_operation(project_id, zone, operation_id) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the operation resides. This field has been deprecated and replaced by the name field. - operation_id (str): Deprecated. The server-assigned ``name`` of the operation. This field - has been deprecated and replaced by the name field. + operation_id (str): Required. Deprecated. The server-assigned ``name`` of the operation. + This field has been deprecated and replaced by the name field. name (str): The name (project, location, operation id) of the operation to cancel. Specified in the format 'projects/*/locations/*/operations/\*'. retry (Optional[google.api_core.retry.Retry]): A retry object used @@ -1818,7 +1822,7 @@ def get_server_config( metadata=None, ): """ - Returns configuration info about the Kubernetes Engine service. + Returns configuration info about the Google Kubernetes Engine service. Example: >>> from google.cloud import container_v1 @@ -1834,15 +1838,15 @@ def get_server_config( >>> response = client.get_server_config(project_id, zone) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ to return operations for. This field has been deprecated and replaced by the name field. - name (str): The name (project and location) of the server config to get Specified in - the format 'projects/*/locations/*'. + name (str): The name (project and location) of the server config to get, specified + in the format 'projects/*/locations/*'. retry (Optional[google.api_core.retry.Retry]): A retry object used to retry requests. If ``None`` is specified, requests will be retried using a default configuration. @@ -1923,14 +1927,15 @@ def list_node_pools( >>> response = client.list_node_pools(project_id, zone, cluster_id) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. This field has been deprecated and replaced by the parent field. - zone (str): Deprecated. The name of the Google Compute Engine + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the parent field. - cluster_id (str): Deprecated. The name of the cluster. + cluster_id (str): Required. Deprecated. The name of the cluster. This field has been deprecated and replaced by the parent field. parent (str): The parent (project, location, cluster id) where the node pools will be listed. Specified in the format 'projects/*/locations/*/clusters/\*'. @@ -1996,7 +2001,7 @@ def get_node_pool( metadata=None, ): """ - Retrieves the node pool requested. + Retrieves the requested node pool. Example: >>> from google.cloud import container_v1 @@ -2018,16 +2023,17 @@ def get_node_pool( >>> response = client.get_node_pool(project_id, zone, cluster_id, node_pool_id) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. This field has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster. + cluster_id (str): Required. Deprecated. The name of the cluster. This field has been deprecated and replaced by the name field. - node_pool_id (str): Deprecated. The name of the node pool. + node_pool_id (str): Required. Deprecated. The name of the node pool. This field has been deprecated and replaced by the name field. name (str): The name (project, location, cluster, node pool id) of the node pool to get. Specified in the format @@ -2120,16 +2126,17 @@ def create_node_pool( >>> response = client.create_node_pool(project_id, zone, cluster_id, node_pool) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. This field has been deprecated and replaced by the parent field. - zone (str): Deprecated. The name of the Google Compute Engine + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the parent field. - cluster_id (str): Deprecated. The name of the cluster. + cluster_id (str): Required. Deprecated. The name of the cluster. This field has been deprecated and replaced by the parent field. - node_pool (Union[dict, ~google.cloud.container_v1.types.NodePool]): The node pool to create. + node_pool (Union[dict, ~google.cloud.container_v1.types.NodePool]): Required. The node pool to create. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.container_v1.types.NodePool` @@ -2223,16 +2230,17 @@ def delete_node_pool( >>> response = client.delete_node_pool(project_id, zone, cluster_id, node_pool_id) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. This field has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster. + cluster_id (str): Required. Deprecated. The name of the cluster. This field has been deprecated and replaced by the name field. - node_pool_id (str): Deprecated. The name of the node pool to delete. + node_pool_id (str): Required. Deprecated. The name of the node pool to delete. This field has been deprecated and replaced by the name field. name (str): The name (project, location, cluster, node pool id) of the node pool to delete. Specified in the format @@ -2303,8 +2311,8 @@ def rollback_node_pool_upgrade( metadata=None, ): """ - Roll back the previously Aborted or Failed NodePool upgrade. - This will be an no-op if the last upgrade successfully completed. + Rolls back a previously Aborted or Failed NodePool upgrade. + This makes no changes if the last upgrade successfully completed. Example: >>> from google.cloud import container_v1 @@ -2326,16 +2334,16 @@ def rollback_node_pool_upgrade( >>> response = client.rollback_node_pool_upgrade(project_id, zone, cluster_id, node_pool_id) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster to rollback. + cluster_id (str): Required. Deprecated. The name of the cluster to rollback. This field has been deprecated and replaced by the name field. - node_pool_id (str): Deprecated. The name of the node pool to rollback. + node_pool_id (str): Required. Deprecated. The name of the node pool to rollback. This field has been deprecated and replaced by the name field. name (str): The name (project, location, cluster, node pool id) of the node poll to rollback upgrade. Specified in the format @@ -2432,18 +2440,18 @@ def set_node_pool_management( >>> response = client.set_node_pool_management(project_id, zone, cluster_id, node_pool_id, management) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster to update. + cluster_id (str): Required. Deprecated. The name of the cluster to update. This field has been deprecated and replaced by the name field. - node_pool_id (str): Deprecated. The name of the node pool to update. + node_pool_id (str): Required. Deprecated. The name of the node pool to update. This field has been deprecated and replaced by the name field. - management (Union[dict, ~google.cloud.container_v1.types.NodeManagement]): NodeManagement configuration for the node pool. + management (Union[dict, ~google.cloud.container_v1.types.NodeManagement]): Required. NodeManagement configuration for the node pool. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.container_v1.types.NodeManagement` @@ -2543,17 +2551,18 @@ def set_labels( >>> response = client.set_labels(project_id, zone, cluster_id, resource_labels, label_fingerprint) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. This field has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster. + cluster_id (str): Required. Deprecated. The name of the cluster. This field has been deprecated and replaced by the name field. - resource_labels (dict[str -> str]): The labels to set for that cluster. - label_fingerprint (str): The fingerprint of the previous set of labels for this resource, + resource_labels (dict[str -> str]): Required. The labels to set for that cluster. + label_fingerprint (str): Required. The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Kubernetes Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash when @@ -2650,16 +2659,16 @@ def set_legacy_abac( >>> response = client.set_legacy_abac(project_id, zone, cluster_id, enabled) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster to update. + cluster_id (str): Required. Deprecated. The name of the cluster to update. This field has been deprecated and replaced by the name field. - enabled (bool): Whether ABAC authorization will be enabled in the cluster. + enabled (bool): Required. Whether ABAC authorization will be enabled in the cluster. name (str): The name (project, location, cluster id) of the cluster to set legacy abac. Specified in the format 'projects/*/locations/*/clusters/\*'. retry (Optional[google.api_core.retry.Retry]): A retry object used @@ -2728,7 +2737,7 @@ def start_i_p_rotation( metadata=None, ): """ - Start master IP rotation. + Starts master IP rotation. Example: >>> from google.cloud import container_v1 @@ -2747,14 +2756,15 @@ def start_i_p_rotation( >>> response = client.start_i_p_rotation(project_id, zone, cluster_id) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. This field has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster. + cluster_id (str): Required. Deprecated. The name of the cluster. This field has been deprecated and replaced by the name field. name (str): The name (project, location, cluster id) of the cluster to start IP rotation. Specified in the format 'projects/*/locations/*/clusters/\*'. @@ -2843,14 +2853,15 @@ def complete_i_p_rotation( >>> response = client.complete_i_p_rotation(project_id, zone, cluster_id) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. This field has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster. + cluster_id (str): Required. Deprecated. The name of the cluster. This field has been deprecated and replaced by the name field. name (str): The name (project, location, cluster id) of the cluster to complete IP rotation. Specified in the format 'projects/*/locations/*/clusters/\*'. @@ -2942,18 +2953,18 @@ def set_node_pool_size( >>> response = client.set_node_pool_size(project_id, zone, cluster_id, node_pool_id, node_count) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project - number `__. This field - has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. + This field has been deprecated and replaced by the name field. + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster to update. + cluster_id (str): Required. Deprecated. The name of the cluster to update. This field has been deprecated and replaced by the name field. - node_pool_id (str): Deprecated. The name of the node pool to update. + node_pool_id (str): Required. Deprecated. The name of the node pool to update. This field has been deprecated and replaced by the name field. - node_count (int): The desired node count for the pool. + node_count (int): Required. The desired node count for the pool. name (str): The name (project, location, cluster, node pool id) of the node pool to set size. Specified in the format 'projects/*/locations/*/clusters/*/nodePools/*'. @@ -3024,7 +3035,7 @@ def set_network_policy( metadata=None, ): """ - Enables/Disables Network Policy for a cluster. + Enables or disables Network Policy for a cluster. Example: >>> from google.cloud import container_v1 @@ -3046,16 +3057,17 @@ def set_network_policy( >>> response = client.set_network_policy(project_id, zone, cluster_id, network_policy) Args: - project_id (str): Deprecated. The Google Developers Console `project ID or project + project_id (str): Required. Deprecated. The Google Developers Console `project ID or + project number `__. This field has been deprecated and replaced by the name field. - zone (str): Deprecated. The name of the Google Compute Engine + zone (str): Required. Deprecated. The name of the Google Compute Engine `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. - cluster_id (str): Deprecated. The name of the cluster. + cluster_id (str): Required. Deprecated. The name of the cluster. This field has been deprecated and replaced by the name field. - network_policy (Union[dict, ~google.cloud.container_v1.types.NetworkPolicy]): Configuration options for the NetworkPolicy feature. + network_policy (Union[dict, ~google.cloud.container_v1.types.NetworkPolicy]): Required. Configuration options for the NetworkPolicy feature. If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.container_v1.types.NetworkPolicy` @@ -3150,13 +3162,13 @@ def set_maintenance_policy( >>> response = client.set_maintenance_policy(project_id, zone, cluster_id, maintenance_policy) Args: - project_id (str): The Google Developers Console `project ID or project + project_id (str): Required. The Google Developers Console `project ID or project number `__. - zone (str): The name of the Google Compute Engine + zone (str): Required. The name of the Google Compute Engine `zone `__ in which the cluster resides. - cluster_id (str): The name of the cluster to update. - maintenance_policy (Union[dict, ~google.cloud.container_v1.types.MaintenancePolicy]): The maintenance policy to be set for the cluster. An empty field + cluster_id (str): Required. The name of the cluster to update. + maintenance_policy (Union[dict, ~google.cloud.container_v1.types.MaintenancePolicy]): Required. The maintenance policy to be set for the cluster. An empty field clears the existing maintenance policy. If a dict is provided, it must be of the same form as the protobuf @@ -3217,3 +3229,110 @@ def set_maintenance_policy( return self._inner_api_calls["set_maintenance_policy"]( request, retry=retry, timeout=timeout, metadata=metadata ) + + def list_usable_subnetworks( + self, + parent=None, + filter_=None, + page_size=None, + retry=google.api_core.gapic_v1.method.DEFAULT, + timeout=google.api_core.gapic_v1.method.DEFAULT, + metadata=None, + ): + """ + Lists subnetworks that are usable for creating clusters in a project. + + Example: + >>> from google.cloud import container_v1 + >>> + >>> client = container_v1.ClusterManagerClient() + >>> + >>> # Iterate over all results + >>> for element in client.list_usable_subnetworks(): + ... # process element + ... pass + >>> + >>> + >>> # Alternatively: + >>> + >>> # Iterate over results one page at a time + >>> for page in client.list_usable_subnetworks().pages: + ... for element in page: + ... # process element + ... pass + + Args: + parent (str): The parent project where subnetworks are usable. Specified in the format + 'projects/\*'. + filter_ (str): Filtering currently only supports equality on the networkProjectId and + must be in the form: "networkProjectId=[PROJECTID]", where + ``networkProjectId`` is the project which owns the listed subnetworks. + This defaults to the parent project ID. + page_size (int): The maximum number of resources contained in the + underlying API response. If page streaming is performed per- + resource, this parameter does not affect the return value. If page + streaming is performed per-page, this determines the maximum number + of resources in a page. + retry (Optional[google.api_core.retry.Retry]): A retry object used + to retry requests. If ``None`` is specified, requests will + be retried using a default configuration. + timeout (Optional[float]): The amount of time, in seconds, to wait + for the request to complete. Note that if ``retry`` is + specified, the timeout applies to each individual attempt. + metadata (Optional[Sequence[Tuple[str, str]]]): Additional metadata + that is provided to the method. + + Returns: + A :class:`~google.api_core.page_iterator.PageIterator` instance. + An iterable of :class:`~google.cloud.container_v1.types.UsableSubnetwork` instances. + You can also iterate over the pages of the response + using its `pages` property. + + Raises: + google.api_core.exceptions.GoogleAPICallError: If the request + failed for any reason. + google.api_core.exceptions.RetryError: If the request failed due + to a retryable error and retry attempts failed. + ValueError: If the parameters are invalid. + """ + # Wrap the transport method to add retry and timeout logic. + if "list_usable_subnetworks" not in self._inner_api_calls: + self._inner_api_calls[ + "list_usable_subnetworks" + ] = google.api_core.gapic_v1.method.wrap_method( + self.transport.list_usable_subnetworks, + default_retry=self._method_configs["ListUsableSubnetworks"].retry, + default_timeout=self._method_configs["ListUsableSubnetworks"].timeout, + client_info=self._client_info, + ) + + request = cluster_service_pb2.ListUsableSubnetworksRequest( + parent=parent, filter=filter_, page_size=page_size + ) + if metadata is None: + metadata = [] + metadata = list(metadata) + try: + routing_header = [("parent", parent)] + except AttributeError: + pass + else: + routing_metadata = google.api_core.gapic_v1.routing_header.to_grpc_metadata( + routing_header + ) + metadata.append(routing_metadata) + + iterator = google.api_core.page_iterator.GRPCIterator( + client=None, + method=functools.partial( + self._inner_api_calls["list_usable_subnetworks"], + retry=retry, + timeout=timeout, + metadata=metadata, + ), + request=request, + items_field="subnetworks", + request_token_field="page_token", + response_token_field="next_page_token", + ) + return iterator diff --git a/google/cloud/container_v1/gapic/cluster_manager_client_config.py b/google/cloud/container_v1/gapic/cluster_manager_client_config.py index cf96a732..1a761ab1 100644 --- a/google/cloud/container_v1/gapic/cluster_manager_client_config.py +++ b/google/cloud/container_v1/gapic/cluster_manager_client_config.py @@ -18,12 +18,12 @@ }, "methods": { "ListClusters": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "idempotent", "retry_params_name": "default", }, "GetCluster": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "idempotent", "retry_params_name": "default", }, @@ -33,140 +33,145 @@ "retry_params_name": "default", }, "UpdateCluster": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "UpdateNodePool": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "SetNodePoolAutoscaling": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "SetLoggingService": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "SetMonitoringService": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "SetAddonsConfig": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "SetLocations": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "UpdateMaster": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "SetMasterAuth": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "DeleteCluster": { - "timeout_millis": 20000, - "retry_codes_name": "idempotent", + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "ListOperations": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "idempotent", "retry_params_name": "default", }, "GetOperation": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "idempotent", "retry_params_name": "default", }, "CancelOperation": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "GetServerConfig": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "idempotent", "retry_params_name": "default", }, "ListNodePools": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "idempotent", "retry_params_name": "default", }, "GetNodePool": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "idempotent", "retry_params_name": "default", }, "CreateNodePool": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "DeleteNodePool": { - "timeout_millis": 20000, - "retry_codes_name": "idempotent", + "timeout_millis": 60000, + "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "RollbackNodePoolUpgrade": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "SetNodePoolManagement": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "SetLabels": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "SetLegacyAbac": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "StartIPRotation": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "CompleteIPRotation": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "SetNodePoolSize": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "SetNetworkPolicy": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, "SetMaintenancePolicy": { - "timeout_millis": 20000, + "timeout_millis": 60000, "retry_codes_name": "non_idempotent", "retry_params_name": "default", }, + "ListUsableSubnetworks": { + "timeout_millis": 60000, + "retry_codes_name": "idempotent", + "retry_params_name": "default", + }, }, } } diff --git a/google/cloud/container_v1/gapic/enums.py b/google/cloud/container_v1/gapic/enums.py index 8acee051..91a90e6e 100644 --- a/google/cloud/container_v1/gapic/enums.py +++ b/google/cloud/container_v1/gapic/enums.py @@ -48,6 +48,23 @@ class Status(enum.IntEnum): DEGRADED = 6 +class DatabaseEncryption(object): + class State(enum.IntEnum): + """ + State of etcd encryption. + + Attributes: + UNKNOWN (int): Should never be set + ENCRYPTED (int): Secrets in etcd are encrypted. + DECRYPTED (int): Secrets in etcd are stored in plain text (at etcd level) - this is + unrelated to GCE level full disk encryption. + """ + + UNKNOWN = 0 + ENCRYPTED = 1 + DECRYPTED = 2 + + class NetworkPolicy(object): class Provider(enum.IntEnum): """ @@ -93,6 +110,24 @@ class Status(enum.IntEnum): ERROR = 6 +class NodeTaint(object): + class Effect(enum.IntEnum): + """ + Possible values for Effect in taint. + + Attributes: + EFFECT_UNSPECIFIED (int): Not set + NO_SCHEDULE (int): NoSchedule + PREFER_NO_SCHEDULE (int): PreferNoSchedule + NO_EXECUTE (int): NoExecute + """ + + EFFECT_UNSPECIFIED = 0 + NO_SCHEDULE = 1 + PREFER_NO_SCHEDULE = 2 + NO_EXECUTE = 3 + + class Operation(object): class Status(enum.IntEnum): """ @@ -174,3 +209,52 @@ class Action(enum.IntEnum): SET_PASSWORD = 1 GENERATE_PASSWORD = 2 SET_USERNAME = 3 + + +class StatusCondition(object): + class Code(enum.IntEnum): + """ + Code for each condition + + Attributes: + UNKNOWN (int): UNKNOWN indicates a generic condition. + GCE_STOCKOUT (int): GCE\_STOCKOUT indicates a Google Compute Engine stockout. + GKE_SERVICE_ACCOUNT_DELETED (int): GKE\_SERVICE\_ACCOUNT\_DELETED indicates that the user deleted their + robot service account. + GCE_QUOTA_EXCEEDED (int): Google Compute Engine quota was exceeded. + SET_BY_OPERATOR (int): Cluster state was manually changed by an SRE due to a system logic error. + CLOUD_KMS_KEY_ERROR (int): Unable to perform an encrypt operation against the CloudKMS key used for + etcd level encryption. + More codes TBA + """ + + UNKNOWN = 0 + GCE_STOCKOUT = 1 + GKE_SERVICE_ACCOUNT_DELETED = 2 + GCE_QUOTA_EXCEEDED = 3 + SET_BY_OPERATOR = 4 + CLOUD_KMS_KEY_ERROR = 7 + + +class UsableSubnetworkSecondaryRange(object): + class Status(enum.IntEnum): + """ + Status shows the current usage of a secondary IP range. + + Attributes: + UNKNOWN (int): UNKNOWN is the zero value of the Status enum. It's not a valid status. + UNUSED (int): UNUSED denotes that this range is unclaimed by any cluster. + IN_USE_SERVICE (int): IN\_USE\_SERVICE denotes that this range is claimed by a cluster for + services. It cannot be used for other clusters. + IN_USE_SHAREABLE_POD (int): IN\_USE\_SHAREABLE\_POD denotes this range was created by the network + admin and is currently claimed by a cluster for pods. It can only be + used by other clusters as a pod range. + IN_USE_MANAGED_POD (int): IN\_USE\_MANAGED\_POD denotes this range was created by GKE and is + claimed for pods. It cannot be used for other clusters. + """ + + UNKNOWN = 0 + UNUSED = 1 + IN_USE_SERVICE = 2 + IN_USE_SHAREABLE_POD = 3 + IN_USE_MANAGED_POD = 4 diff --git a/google/cloud/container_v1/gapic/transports/cluster_manager_grpc_transport.py b/google/cloud/container_v1/gapic/transports/cluster_manager_grpc_transport.py index cb838808..e0a6e5b8 100644 --- a/google/cloud/container_v1/gapic/transports/cluster_manager_grpc_transport.py +++ b/google/cloud/container_v1/gapic/transports/cluster_manager_grpc_transport.py @@ -145,11 +145,11 @@ def create_cluster(self): network `__. One firewall is added for the cluster. After cluster creation, the - cluster creates routes for each node to allow the containers on that + Kubelet creates routes for each node to allow the containers on that node to communicate with all other instances in the cluster. Finally, an entry is added to the project's global metadata indicating - which CIDR range is being used by the cluster. + which CIDR range the cluster is using. Returns: Callable: A callable which accepts the appropriate @@ -175,7 +175,7 @@ def update_cluster(self): def update_node_pool(self): """Return the gRPC stub for :meth:`ClusterManagerClient.update_node_pool`. - Updates the version and/or image type for a specific node pool. + Updates the version and/or image type for the specified node pool. Returns: Callable: A callable which accepts the appropriate @@ -188,7 +188,7 @@ def update_node_pool(self): def set_node_pool_autoscaling(self): """Return the gRPC stub for :meth:`ClusterManagerClient.set_node_pool_autoscaling`. - Sets the autoscaling settings for a specific node pool. + Sets the autoscaling settings for the specified node pool. Returns: Callable: A callable which accepts the appropriate @@ -266,9 +266,9 @@ def update_master(self): def set_master_auth(self): """Return the gRPC stub for :meth:`ClusterManagerClient.set_master_auth`. - Used to set master auth materials. Currently supports :- - Changing the admin password for a specific cluster. - This can be either via password generation or explicitly set the password. + Sets master auth materials. Currently supports changing the admin password + or a specific cluster, either via password generation or explicitly setting + the password. Returns: Callable: A callable which accepts the appropriate @@ -287,9 +287,9 @@ def delete_cluster(self): Firewalls and routes that were configured during cluster creation are also deleted. - Other Google Compute Engine resources that might be in use by the cluster - (e.g. load balancer resources) will not be deleted if they weren't present - at the initial create time. + Other Google Compute Engine resources that might be in use by the cluster, + such as load balancer resources, are not deleted if they weren't present + when the cluster was initially created. Returns: Callable: A callable which accepts the appropriate @@ -341,7 +341,7 @@ def cancel_operation(self): def get_server_config(self): """Return the gRPC stub for :meth:`ClusterManagerClient.get_server_config`. - Returns configuration info about the Kubernetes Engine service. + Returns configuration info about the Google Kubernetes Engine service. Returns: Callable: A callable which accepts the appropriate @@ -367,7 +367,7 @@ def list_node_pools(self): def get_node_pool(self): """Return the gRPC stub for :meth:`ClusterManagerClient.get_node_pool`. - Retrieves the node pool requested. + Retrieves the requested node pool. Returns: Callable: A callable which accepts the appropriate @@ -406,8 +406,8 @@ def delete_node_pool(self): def rollback_node_pool_upgrade(self): """Return the gRPC stub for :meth:`ClusterManagerClient.rollback_node_pool_upgrade`. - Roll back the previously Aborted or Failed NodePool upgrade. - This will be an no-op if the last upgrade successfully completed. + Rolls back a previously Aborted or Failed NodePool upgrade. + This makes no changes if the last upgrade successfully completed. Returns: Callable: A callable which accepts the appropriate @@ -459,7 +459,7 @@ def set_legacy_abac(self): def start_i_p_rotation(self): """Return the gRPC stub for :meth:`ClusterManagerClient.start_i_p_rotation`. - Start master IP rotation. + Starts master IP rotation. Returns: Callable: A callable which accepts the appropriate @@ -498,7 +498,7 @@ def set_node_pool_size(self): def set_network_policy(self): """Return the gRPC stub for :meth:`ClusterManagerClient.set_network_policy`. - Enables/Disables Network Policy for a cluster. + Enables or disables Network Policy for a cluster. Returns: Callable: A callable which accepts the appropriate @@ -519,3 +519,16 @@ def set_maintenance_policy(self): deserialized response object. """ return self._stubs["cluster_manager_stub"].SetMaintenancePolicy + + @property + def list_usable_subnetworks(self): + """Return the gRPC stub for :meth:`ClusterManagerClient.list_usable_subnetworks`. + + Lists subnetworks that are usable for creating clusters in a project. + + Returns: + Callable: A callable which accepts the appropriate + deserialized request object and returns a + deserialized response object. + """ + return self._stubs["cluster_manager_stub"].ListUsableSubnetworks diff --git a/google/cloud/container_v1/proto/cluster_service.proto b/google/cloud/container_v1/proto/cluster_service.proto index db7744d0..86475baa 100644 --- a/google/cloud/container_v1/proto/cluster_service.proto +++ b/google/cloud/container_v1/proto/cluster_service.proto @@ -1,4 +1,4 @@ -// Copyright 2018 Google LLC. +// Copyright 2019 Google LLC. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -18,18 +18,23 @@ syntax = "proto3"; package google.container.v1; import "google/api/annotations.proto"; +import "google/api/client.proto"; +import "google/api/field_behavior.proto"; import "google/protobuf/empty.proto"; +import "google/protobuf/timestamp.proto"; +option csharp_namespace = "Google.Cloud.Container.V1"; option go_package = "google.golang.org/genproto/googleapis/container/v1;container"; option java_multiple_files = true; option java_outer_classname = "ClusterServiceProto"; option java_package = "com.google.container.v1"; -option csharp_namespace = "Google.Cloud.Container.V1"; option php_namespace = "Google\\Cloud\\Container\\V1"; - // Google Kubernetes Engine Cluster Manager v1 service ClusterManager { + option (google.api.default_host) = "container.googleapis.com"; + option (google.api.oauth_scopes) = "https://www.googleapis.com/auth/cloud-platform"; + // Lists all clusters owned by a project in either the specified zone or all // zones. rpc ListClusters(ListClustersRequest) returns (ListClustersResponse) { @@ -39,6 +44,7 @@ service ClusterManager { get: "/v1/projects/{project_id}/zones/{zone}/clusters" } }; + option (google.api.method_signature) = "project_id,zone"; } // Gets the details of a specific cluster. @@ -49,6 +55,7 @@ service ClusterManager { get: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id"; } // Creates a cluster, consisting of the specified number and type of Google @@ -58,12 +65,12 @@ service ClusterManager { // [default network](/compute/docs/networks-and-firewalls#networks). // // One firewall is added for the cluster. After cluster creation, - // the cluster creates routes for each node to allow the containers + // the Kubelet creates routes for each node to allow the containers // on that node to communicate with all other instances in the // cluster. // // Finally, an entry is added to the project's global metadata indicating - // which CIDR range is being used by the cluster. + // which CIDR range the cluster is using. rpc CreateCluster(CreateClusterRequest) returns (Operation) { option (google.api.http) = { post: "/v1/{parent=projects/*/locations/*}/clusters" @@ -73,6 +80,7 @@ service ClusterManager { body: "*" } }; + option (google.api.method_signature) = "project_id,zone,cluster"; } // Updates the settings of a specific cluster. @@ -85,9 +93,10 @@ service ClusterManager { body: "*" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id,update"; } - // Updates the version and/or image type for a specific node pool. + // Updates the version and/or image type for the specified node pool. rpc UpdateNodePool(UpdateNodePoolRequest) returns (Operation) { option (google.api.http) = { put: "/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}" @@ -99,7 +108,7 @@ service ClusterManager { }; } - // Sets the autoscaling settings for a specific node pool. + // Sets the autoscaling settings for the specified node pool. rpc SetNodePoolAutoscaling(SetNodePoolAutoscalingRequest) returns (Operation) { option (google.api.http) = { post: "/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:setAutoscaling" @@ -121,6 +130,7 @@ service ClusterManager { body: "*" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id,logging_service"; } // Sets the monitoring service for a specific cluster. @@ -133,6 +143,7 @@ service ClusterManager { body: "*" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id,monitoring_service"; } // Sets the addons for a specific cluster. @@ -145,6 +156,7 @@ service ClusterManager { body: "*" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id,addons_config"; } // Sets the locations for a specific cluster. @@ -157,6 +169,7 @@ service ClusterManager { body: "*" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id,locations"; } // Updates the master for a specific cluster. @@ -169,11 +182,12 @@ service ClusterManager { body: "*" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id,master_version"; } - // Used to set master auth materials. Currently supports :- - // Changing the admin password for a specific cluster. - // This can be either via password generation or explicitly set the password. + // Sets master auth materials. Currently supports changing the admin password + // or a specific cluster, either via password generation or explicitly setting + // the password. rpc SetMasterAuth(SetMasterAuthRequest) returns (Operation) { option (google.api.http) = { post: "/v1/{name=projects/*/locations/*/clusters/*}:setMasterAuth" @@ -191,9 +205,9 @@ service ClusterManager { // Firewalls and routes that were configured during cluster creation // are also deleted. // - // Other Google Compute Engine resources that might be in use by the cluster - // (e.g. load balancer resources) will not be deleted if they weren't present - // at the initial create time. + // Other Google Compute Engine resources that might be in use by the cluster, + // such as load balancer resources, are not deleted if they weren't present + // when the cluster was initially created. rpc DeleteCluster(DeleteClusterRequest) returns (Operation) { option (google.api.http) = { delete: "/v1/{name=projects/*/locations/*/clusters/*}" @@ -201,6 +215,7 @@ service ClusterManager { delete: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id"; } // Lists all operations in a project in a specific zone or all zones. @@ -211,6 +226,7 @@ service ClusterManager { get: "/v1/projects/{project_id}/zones/{zone}/operations" } }; + option (google.api.method_signature) = "project_id,zone"; } // Gets the specified operation. @@ -221,6 +237,7 @@ service ClusterManager { get: "/v1/projects/{project_id}/zones/{zone}/operations/{operation_id}" } }; + option (google.api.method_signature) = "project_id,zone,operation_id"; } // Cancels the specified operation. @@ -233,9 +250,10 @@ service ClusterManager { body: "*" } }; + option (google.api.method_signature) = "project_id,zone,operation_id"; } - // Returns configuration info about the Kubernetes Engine service. + // Returns configuration info about the Google Kubernetes Engine service. rpc GetServerConfig(GetServerConfigRequest) returns (ServerConfig) { option (google.api.http) = { get: "/v1/{name=projects/*/locations/*}/serverConfig" @@ -243,6 +261,7 @@ service ClusterManager { get: "/v1/projects/{project_id}/zones/{zone}/serverconfig" } }; + option (google.api.method_signature) = "project_id,zone"; } // Lists the node pools for a cluster. @@ -253,9 +272,10 @@ service ClusterManager { get: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id"; } - // Retrieves the node pool requested. + // Retrieves the requested node pool. rpc GetNodePool(GetNodePoolRequest) returns (NodePool) { option (google.api.http) = { get: "/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}" @@ -263,6 +283,7 @@ service ClusterManager { get: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id,node_pool_id"; } // Creates a node pool for a cluster. @@ -275,6 +296,7 @@ service ClusterManager { body: "*" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id,node_pool"; } // Deletes a node pool from a cluster. @@ -285,10 +307,11 @@ service ClusterManager { delete: "/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/nodePools/{node_pool_id}" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id,node_pool_id"; } - // Roll back the previously Aborted or Failed NodePool upgrade. - // This will be an no-op if the last upgrade successfully completed. + // Rolls back a previously Aborted or Failed NodePool upgrade. + // This makes no changes if the last upgrade successfully completed. rpc RollbackNodePoolUpgrade(RollbackNodePoolUpgradeRequest) returns (Operation) { option (google.api.http) = { post: "/v1/{name=projects/*/locations/*/clusters/*/nodePools/*}:rollback" @@ -298,6 +321,7 @@ service ClusterManager { body: "*" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id,node_pool_id"; } // Sets the NodeManagement options for a node pool. @@ -334,9 +358,10 @@ service ClusterManager { body: "*" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id,enabled"; } - // Start master IP rotation. + // Starts master IP rotation. rpc StartIPRotation(StartIPRotationRequest) returns (Operation) { option (google.api.http) = { post: "/v1/{name=projects/*/locations/*/clusters/*}:startIpRotation" @@ -346,6 +371,7 @@ service ClusterManager { body: "*" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id"; } // Completes master IP rotation. @@ -358,6 +384,7 @@ service ClusterManager { body: "*" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id"; } // Sets the size for a specific node pool. @@ -372,7 +399,7 @@ service ClusterManager { }; } - // Enables/Disables Network Policy for a cluster. + // Enables or disables Network Policy for a cluster. rpc SetNetworkPolicy(SetNetworkPolicyRequest) returns (Operation) { option (google.api.http) = { post: "/v1/{name=projects/*/locations/*/clusters/*}:setNetworkPolicy" @@ -382,6 +409,7 @@ service ClusterManager { body: "*" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id,network_policy"; } // Sets the maintenance policy for a cluster. @@ -394,6 +422,14 @@ service ClusterManager { body: "*" } }; + option (google.api.method_signature) = "project_id,zone,cluster_id,maintenance_policy"; + } + + // Lists subnetworks that are usable for creating clusters in a project. + rpc ListUsableSubnetworks(ListUsableSubnetworksRequest) returns (ListUsableSubnetworksResponse) { + option (google.api.http) = { + get: "/v1/{parent=projects/*}/aggregated/usableSubnetworks" + }; } } @@ -443,6 +479,7 @@ message NodeConfig { // "cluster-name" // "cluster-uid" // "configure-sh" + // "containerd-configure-sh" // "enable-os-login" // "gci-update-strategy" // "gci-ensure-gke-docker" @@ -450,6 +487,13 @@ message NodeConfig { // "kube-env" // "startup-script" // "user-data" + // "disable-address-manager" + // "windows-startup-script-ps1" + // "common-psm1" + // "k8s-node-setup-psm1" + // "install-ssh-psm1" + // "user-profile-psm1" + // "serial-port-logging-enable" // // Values are free-form strings, and only have meaning as interpreted by // the image running in the instance. The only restriction placed on them is @@ -474,9 +518,9 @@ message NodeConfig { // The number of local SSD disks to be attached to the node. // - // The limit for this value is dependant upon the maximum number of + // The limit for this value is dependent upon the maximum number of // disks available on a machine per zone. See: - // https://cloud.google.com/compute/docs/disks/local-ssd#local_ssd_limits + // https://cloud.google.com/compute/docs/disks/local-ssd // for more information. int32 local_ssd_count = 7; @@ -509,6 +553,64 @@ message NodeConfig { // information, read [how to specify min CPU // platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform) string min_cpu_platform = 13; + + // List of kubernetes taints to be applied to each node. + // + // For more information, including usage and the valid values, see: + // https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/ + repeated NodeTaint taints = 15; + + // Shielded Instance options. + ShieldedInstanceConfig shielded_instance_config = 20; +} + +// A set of Shielded Instance options. +message ShieldedInstanceConfig { + // Defines whether the instance has Secure Boot enabled. + // + // Secure Boot helps ensure that the system only runs authentic software by + // verifying the digital signature of all boot components, and halting the + // boot process if signature verification fails. + bool enable_secure_boot = 1; + + // Defines whether the instance has integrity monitoring enabled. + // + // Enables monitoring and attestation of the boot integrity of the instance. + // The attestation is performed against the integrity policy baseline. This + // baseline is initially derived from the implicitly trusted boot image when + // the instance is created. + bool enable_integrity_monitoring = 2; +} + +// Kubernetes taint is comprised of three fields: key, value, and effect. Effect +// can only be one of three types: NoSchedule, PreferNoSchedule or NoExecute. +// +// For more information, including usage and the valid values, see: +// https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/ +message NodeTaint { + // Possible values for Effect in taint. + enum Effect { + // Not set + EFFECT_UNSPECIFIED = 0; + + // NoSchedule + NO_SCHEDULE = 1; + + // PreferNoSchedule + PREFER_NO_SCHEDULE = 2; + + // NoExecute + NO_EXECUTE = 3; + } + + // Key for taint. + string key = 1; + + // Value for taint. + string value = 2; + + // Effect for taint. + Effect effect = 3; } // The authentication information for accessing the master endpoint. @@ -516,8 +618,8 @@ message NodeConfig { // certificates. message MasterAuth { // The username to use for HTTP basic authentication to the master endpoint. - // For clusters v1.6.0 and later, you can disable basic authentication by - // providing an empty username. + // For clusters v1.6.0 and later, basic authentication can be disabled by + // leaving username unspecified (or setting it to the empty string). string username = 1; // The password to use for HTTP basic authentication to the master endpoint. @@ -563,12 +665,20 @@ message AddonsConfig { HorizontalPodAutoscaling horizontal_pod_autoscaling = 2; // Configuration for the Kubernetes Dashboard. - KubernetesDashboard kubernetes_dashboard = 3; + // This addon is deprecated, and will be disabled in 1.15. It is recommended + // to use the Cloud Console to manage and monitor your Kubernetes clusters, + // workloads and applications. For more information, see: + // https://cloud.google.com/kubernetes-engine/docs/concepts/dashboards + KubernetesDashboard kubernetes_dashboard = 3 [deprecated = true]; // Configuration for NetworkPolicy. This only tracks whether the addon // is enabled or not on the Master, it does not track whether network policy // is enabled for the nodes. NetworkPolicyConfig network_policy_config = 4; + + // Configuration for the Cloud Run addon, which allows the user to use a + // managed Knative service. + CloudRunConfig cloud_run_config = 7; } // Configuration options for the HTTP (L7) load balancing controller addon, @@ -627,6 +737,23 @@ message PrivateClusterConfig { string public_endpoint = 5; } +// Configuration for returning group information from authenticators. +message AuthenticatorGroupsConfig { + // Whether this cluster should return group membership lookups + // during authentication using a group of security groups. + bool enabled = 1; + + // The name of the security group-of-groups to be used. Only relevant + // if enabled = true. + string security_group = 2; +} + +// Configuration options for the Cloud Run feature. +message CloudRunConfig { + // Whether Cloud Run addon is enabled for this cluster. + bool disabled = 1; +} + // Configuration options for the master authorized networks feature. Enabled // master authorized networks will disallow all external traffic to access // Kubernetes master through HTTPS except traffic from the given CIDR blocks, @@ -644,7 +771,7 @@ message MasterAuthorizedNetworksConfig { // Whether or not master authorized networks is enabled. bool enabled = 1; - // cidr_blocks define up to 10 external networks that could access + // cidr_blocks define up to 50 external networks that could access // Kubernetes master through HTTPS. repeated CidrBlock cidr_blocks = 2; } @@ -678,6 +805,13 @@ message NetworkPolicy { bool enabled = 2; } +// Configuration for Binary Authorization. +message BinaryAuthorization { + // Enable Binary Authorization for this cluster. If enabled, all container + // images will be validated by Binary Authorization. + bool enabled = 1; +} + // Configuration for controlling how IPs are allocated in the cluster. message IPAllocationPolicy { // Whether alias IPs will be used for pod IPs in the cluster. @@ -769,6 +903,23 @@ message IPAllocationPolicy { // `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range // to use. string services_ipv4_cidr_block = 11; + + // The IP address range of the Cloud TPUs in this cluster. If unspecified, a + // range will be automatically chosen with the default size. + // + // This field is only applicable when `use_ip_aliases` is true. + // + // If unspecified, the range will use the default size. + // + // Set to /netmask (e.g. `/14`) to have a range chosen with a specific + // netmask. + // + // Set to a + // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g. + // `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range + // to use. + string tpu_ipv4_cidr_block = 13; } // A Google Kubernetes Engine cluster. @@ -803,7 +954,8 @@ message Cluster { } // The name of this cluster. The name must be unique within this project - // and zone, and can be up to 40 characters with the following restrictions: + // and location (e.g. zone or region), and can be up to 40 characters with + // the following restrictions: // // * Lowercase letters, numbers, and hyphens only. // * Must start with a letter. @@ -821,26 +973,35 @@ message Cluster { // "node_pool" object, since this configuration (along with the // "node_config") will be used to create a "NodePool" object with an // auto-generated name. Do not use this and a node_pool at the same time. - int32 initial_node_count = 3; + // + // This field is deprecated, use node_pool.initial_node_count instead. + int32 initial_node_count = 3 [deprecated = true]; // Parameters used in creating the cluster's nodes. - // See `nodeConfig` for the description of its properties. // For requests, this field should only be used in lieu of a // "node_pool" object, since this configuration (along with the // "initial_node_count") will be used to create a "NodePool" object with an // auto-generated name. Do not use this and a node_pool at the same time. // For responses, this field will be populated with the node configuration of - // the first node pool. + // the first node pool. (For configuration of each node pool, see + // `node_pool.config`) // // If unspecified, the defaults are used. - NodeConfig node_config = 4; + // This field is deprecated, use node_pool.config instead. + NodeConfig node_config = 4 [deprecated = true]; // The authentication information for accessing the master endpoint. + // If unspecified, the defaults are used: + // For clusters before v1.12, if master_auth is unspecified, `username` will + // be set to "admin", a random password will be generated, and a client + // certificate will be issued. MasterAuth master_auth = 5; // The logging service the cluster should use to write logs. // Currently available options: // + // * "logging.googleapis.com/kubernetes" - the Google Cloud Logging + // service with Kubernetes-native resource model // * `logging.googleapis.com` - the Google Cloud Logging service. // * `none` - no logs will be exported from the cluster. // * if left as an empty string,`logging.googleapis.com` will be used. @@ -880,7 +1041,7 @@ message Cluster { repeated NodePool node_pools = 12; // The list of Google Compute Engine - // [locations](/compute/docs/zones#available) in which the cluster's nodes + // [zones](/compute/docs/zones#available) in which the cluster's nodes // should be located. repeated string locations = 13; @@ -914,12 +1075,36 @@ message Cluster { // Configure the maintenance policy for this cluster. MaintenancePolicy maintenance_policy = 23; + // Configuration for Binary Authorization. + BinaryAuthorization binary_authorization = 24; + + // Cluster-level autoscaling configuration. + ClusterAutoscaling autoscaling = 26; + // Configuration for cluster networking. NetworkConfig network_config = 27; + // The default constraint on the maximum number of pods that can be run + // simultaneously on a node in the node pool of this cluster. Only honored + // if cluster created with IP Alias support. + MaxPodsConstraint default_max_pods_constraint = 30; + + // Configuration for exporting resource usages. Resource usage export is + // disabled when this config is unspecified. + ResourceUsageExportConfig resource_usage_export_config = 33; + + // Configuration controlling RBAC group membership information. + AuthenticatorGroupsConfig authenticator_groups_config = 34; + // Configuration for private cluster. PrivateClusterConfig private_cluster_config = 37; + // Configuration of etcd encryption. + DatabaseEncryption database_encryption = 38; + + // Cluster-level Vertical Pod Autoscaling configuration. + VerticalPodAutoscaling vertical_pod_autoscaling = 39; + // [Output only] Server-defined URL for the resource. string self_link = 100; @@ -956,7 +1141,7 @@ message Cluster { string current_master_version = 104; // [Output only] Deprecated, use - // [NodePool.version](/kubernetes-engine/docs/reference/rest/v1/projects.zones.clusters.nodePool) + // [NodePools.version](/kubernetes-engine/docs/reference/rest/v1/projects.zones.clusters.nodePools) // instead. The current version of the node software components. If they are // currently at multiple versions because they're in the process of being // upgraded, this reflects the minimum version of all nodes. @@ -975,7 +1160,8 @@ message Cluster { // [Output only] The size of the address space on each node for hosting // containers. This is provisioned from within the `container_ipv4_cidr` - // range. + // range. This field will only be set when cluster is in route-based network + // mode. int32 node_ipv4_cidr_size = 109; // [Output only] The IP address range of the Kubernetes services in @@ -988,8 +1174,9 @@ message Cluster { // Deprecated. Use node_pools.instance_group_urls. repeated string instance_group_urls = 111 [deprecated = true]; - // [Output only] The number of nodes currently in the cluster. - int32 current_node_count = 112; + // [Output only] The number of nodes currently in the cluster. Deprecated. + // Call Kubernetes API directly to retrieve node information. + int32 current_node_count = 112 [deprecated = true]; // [Output only] The time the cluster will be automatically // deleted in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. @@ -1000,6 +1187,17 @@ message Cluster { // [region](/compute/docs/regions-zones/regions-zones#available) in which // the cluster resides. string location = 114; + + // Enable the ability to use Cloud TPUs in this cluster. + bool enable_tpu = 115; + + // [Output only] The IP address range of the Cloud TPUs in this cluster, in + // [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) + // notation (e.g. `1.2.3.4/29`). + string tpu_ipv4_cidr_block = 116; + + // Which conditions caused the current cluster state. + repeated StatusCondition conditions = 118; } // ClusterUpdate describes an update to the cluster. Exactly one update can @@ -1022,6 +1220,8 @@ message ClusterUpdate { // The monitoring service the cluster should use to write metrics. // Currently available options: // + // * "monitoring.googleapis.com/kubernetes" - the Google Cloud Monitoring + // service with Kubernetes-native resource model // * "monitoring.googleapis.com" - the Google Cloud Monitoring service // * "none" - no metrics will be exported from the cluster string desired_monitoring_service = 5; @@ -1039,6 +1239,9 @@ message ClusterUpdate { // NOTE: Set the "desired_node_pool" field as well. string desired_image_type = 8; + // Configuration of etcd encryption. + DatabaseEncryption desired_database_encryption = 46; + // Autoscaler configuration for the node pool specified in // desired_node_pool_id. If there is only one pool in the // cluster and desired_node_pool_id is not provided then @@ -1046,7 +1249,7 @@ message ClusterUpdate { NodePoolAutoscaling desired_node_pool_autoscaling = 9; // The desired list of Google Compute Engine - // [locations](/compute/docs/zones#available) in which the cluster's nodes + // [zones](/compute/docs/zones#available) in which the cluster's nodes // should be located. Changing the locations a cluster is in will result // in nodes being either created or removed from the cluster, depending on // whether locations are being added or removed. @@ -1057,6 +1260,30 @@ message ClusterUpdate { // The desired configuration options for master authorized networks feature. MasterAuthorizedNetworksConfig desired_master_authorized_networks_config = 12; + // Cluster-level autoscaling configuration. + ClusterAutoscaling desired_cluster_autoscaling = 15; + + // The desired configuration options for the Binary Authorization feature. + BinaryAuthorization desired_binary_authorization = 16; + + // The logging service the cluster should use to write logs. + // Currently available options: + // + // * "logging.googleapis.com/kubernetes" - the Google Cloud Logging + // service with Kubernetes-native resource model + // * "logging.googleapis.com" - the Google Cloud Logging service + // * "none" - no logs will be exported from the cluster + string desired_logging_service = 19; + + // The desired configuration for exporting resource usage. + ResourceUsageExportConfig desired_resource_usage_export_config = 21; + + // Cluster-level Vertical Pod Autoscaling configuration. + VerticalPodAutoscaling desired_vertical_pod_autoscaling = 22; + + // The desired config of Intra-node visibility. + IntraNodeVisibilityConfig desired_intra_node_visibility_config = 26; + // The Kubernetes version to change the master to. // // Users may specify either explicit versions offered by @@ -1185,24 +1412,36 @@ message Operation { // [Output only] The time the operation completed, in // [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. string end_time = 11; + + // Which conditions caused the current cluster state. + repeated StatusCondition cluster_conditions = 13; + + // Which conditions caused the current node pool state. + repeated StatusCondition nodepool_conditions = 14; } // CreateClusterRequest creates a cluster. message CreateClusterRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the parent field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the parent field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // A [cluster + // Required. A [cluster // resource](/container-engine/reference/rest/v1/projects.zones.clusters) - Cluster cluster = 3; + Cluster cluster = 3 [(google.api.field_behavior) = REQUIRED]; // The parent (project and location) where the cluster will be created. // Specified in the format 'projects/*/locations/*'. @@ -1211,20 +1450,29 @@ message CreateClusterRequest { // GetClusterRequest gets the settings of a cluster. message GetClusterRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster to retrieve. + // Required. Deprecated. The name of the cluster to retrieve. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; // The name (project, location, cluster) of the cluster to retrieve. // Specified in the format 'projects/*/locations/*/clusters/*'. @@ -1233,23 +1481,32 @@ message GetClusterRequest { // UpdateClusterRequest updates the settings of a cluster. message UpdateClusterRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster to upgrade. + // Required. Deprecated. The name of the cluster to upgrade. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // A description of the update. - ClusterUpdate update = 4; + // Required. A description of the update. + ClusterUpdate update = 4 [(google.api.field_behavior) = REQUIRED]; // The name (project, location, cluster) of the cluster to update. // Specified in the format 'projects/*/locations/*/clusters/*'. @@ -1258,26 +1515,38 @@ message UpdateClusterRequest { // UpdateNodePoolRequests update a node pool's image and/or version. message UpdateNodePoolRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster to upgrade. + // Required. Deprecated. The name of the cluster to upgrade. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the node pool to upgrade. + // Required. Deprecated. The name of the node pool to upgrade. // This field has been deprecated and replaced by the name field. - string node_pool_id = 4 [deprecated = true]; + string node_pool_id = 4 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // The Kubernetes version to change the nodes to (typically an + // Required. The Kubernetes version to change the nodes to (typically an // upgrade). // // Users may specify either explicit versions offered by Kubernetes Engine or @@ -1288,10 +1557,10 @@ message UpdateNodePoolRequest { // - "1.X.Y": picks the highest valid gke.N patch in the 1.X.Y version // - "1.X.Y-gke.N": picks an explicit Kubernetes version // - "-": picks the Kubernetes master version - string node_version = 5; + string node_version = 5 [(google.api.field_behavior) = REQUIRED]; - // The desired image type for the node pool. - string image_type = 6; + // Required. The desired image type for the node pool. + string image_type = 6 [(google.api.field_behavior) = REQUIRED]; // The name (project, location, cluster, node pool) of the node pool to // update. Specified in the format @@ -1301,27 +1570,39 @@ message UpdateNodePoolRequest { // SetNodePoolAutoscalingRequest sets the autoscaler settings of a node pool. message SetNodePoolAutoscalingRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster to upgrade. + // Required. Deprecated. The name of the cluster to upgrade. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the node pool to upgrade. + // Required. Deprecated. The name of the node pool to upgrade. // This field has been deprecated and replaced by the name field. - string node_pool_id = 4 [deprecated = true]; + string node_pool_id = 4 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Autoscaling configuration for the node pool. - NodePoolAutoscaling autoscaling = 5; + // Required. Autoscaling configuration for the node pool. + NodePoolAutoscaling autoscaling = 5 [(google.api.field_behavior) = REQUIRED]; // The name (project, location, cluster, node pool) of the node pool to set // autoscaler settings. Specified in the format @@ -1331,27 +1612,33 @@ message SetNodePoolAutoscalingRequest { // SetLoggingServiceRequest sets the logging service of a cluster. message SetLoggingServiceRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2; + string zone = 2 [(google.api.field_behavior) = REQUIRED]; - // Deprecated. The name of the cluster to upgrade. + // Required. Deprecated. The name of the cluster to upgrade. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // The logging service the cluster should use to write metrics. + // Required. The logging service the cluster should use to write metrics. // Currently available options: // // * "logging.googleapis.com" - the Google Cloud Logging service // * "none" - no metrics will be exported from the cluster - string logging_service = 4; + string logging_service = 4 [(google.api.field_behavior) = REQUIRED]; // The name (project, location, cluster) of the cluster to set logging. // Specified in the format 'projects/*/locations/*/clusters/*'. @@ -1360,27 +1647,38 @@ message SetLoggingServiceRequest { // SetMonitoringServiceRequest sets the monitoring service of a cluster. message SetMonitoringServiceRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster to upgrade. + // Required. Deprecated. The name of the cluster to upgrade. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // The monitoring service the cluster should use to write metrics. + // Required. The monitoring service the cluster should use to write metrics. // Currently available options: // + // * "monitoring.googleapis.com/kubernetes" - the Google Cloud Monitoring + // service with Kubernetes-native resource model // * "monitoring.googleapis.com" - the Google Cloud Monitoring service // * "none" - no metrics will be exported from the cluster - string monitoring_service = 4; + string monitoring_service = 4 [(google.api.field_behavior) = REQUIRED]; // The name (project, location, cluster) of the cluster to set monitoring. // Specified in the format 'projects/*/locations/*/clusters/*'. @@ -1389,24 +1687,33 @@ message SetMonitoringServiceRequest { // SetAddonsConfigRequest sets the addons associated with the cluster. message SetAddonsConfigRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster to upgrade. + // Required. Deprecated. The name of the cluster to upgrade. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // The desired configurations for the various addons available to run in the + // Required. The desired configurations for the various addons available to run in the // cluster. - AddonsConfig addons_config = 4; + AddonsConfig addons_config = 4 [(google.api.field_behavior) = REQUIRED]; // The name (project, location, cluster) of the cluster to set addons. // Specified in the format 'projects/*/locations/*/clusters/*'. @@ -1415,29 +1722,38 @@ message SetAddonsConfigRequest { // SetLocationsRequest sets the locations of the cluster. message SetLocationsRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster to upgrade. + // Required. Deprecated. The name of the cluster to upgrade. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // The desired list of Google Compute Engine - // [locations](/compute/docs/zones#available) in which the cluster's nodes + // Required. The desired list of Google Compute Engine + // [zones](/compute/docs/zones#available) in which the cluster's nodes // should be located. Changing the locations a cluster is in will result // in nodes being either created or removed from the cluster, depending on // whether locations are being added or removed. // // This list must always include the cluster's primary zone. - repeated string locations = 4; + repeated string locations = 4 [(google.api.field_behavior) = REQUIRED]; // The name (project, location, cluster) of the cluster to set locations. // Specified in the format 'projects/*/locations/*/clusters/*'. @@ -1446,22 +1762,31 @@ message SetLocationsRequest { // UpdateMasterRequest updates the master of the cluster. message UpdateMasterRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster to upgrade. + // Required. Deprecated. The name of the cluster to upgrade. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // The Kubernetes version to change the master to. + // Required. The Kubernetes version to change the master to. // // Users may specify either explicit versions offered by Kubernetes Engine or // version aliases, which have the following behavior: @@ -1471,7 +1796,7 @@ message UpdateMasterRequest { // - "1.X.Y": picks the highest valid gke.N patch in the 1.X.Y version // - "1.X.Y-gke.N": picks an explicit Kubernetes version // - "-": picks the default Kubernetes version - string master_version = 4; + string master_version = 4 [(google.api.field_behavior) = REQUIRED]; // The name (project, location, cluster) of the cluster to update. // Specified in the format 'projects/*/locations/*/clusters/*'. @@ -1498,26 +1823,35 @@ message SetMasterAuthRequest { SET_USERNAME = 3; } - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster to upgrade. + // Required. Deprecated. The name of the cluster to upgrade. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // The exact form of action to be taken on the master auth. - Action action = 4; + // Required. The exact form of action to be taken on the master auth. + Action action = 4 [(google.api.field_behavior) = REQUIRED]; - // A description of the update. - MasterAuth update = 5; + // Required. A description of the update. + MasterAuth update = 5 [(google.api.field_behavior) = REQUIRED]; // The name (project, location, cluster) of the cluster to set auth. // Specified in the format 'projects/*/locations/*/clusters/*'. @@ -1526,20 +1860,29 @@ message SetMasterAuthRequest { // DeleteClusterRequest deletes a cluster. message DeleteClusterRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster to delete. + // Required. Deprecated. The name of the cluster to delete. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; // The name (project, location, cluster) of the cluster to delete. // Specified in the format 'projects/*/locations/*/clusters/*'. @@ -1548,16 +1891,22 @@ message DeleteClusterRequest { // ListClustersRequest lists clusters. message ListClustersRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the parent field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides, or "-" for all zones. // This field has been deprecated and replaced by the parent field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; // The parent (project and location) where the clusters will be listed. // Specified in the format 'projects/*/locations/*'. @@ -1578,20 +1927,29 @@ message ListClustersResponse { // GetOperationRequest gets a single operation. message GetOperationRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The server-assigned `name` of the operation. + // Required. Deprecated. The server-assigned `name` of the operation. // This field has been deprecated and replaced by the name field. - string operation_id = 3 [deprecated = true]; + string operation_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; // The name (project, location, operation id) of the operation to get. // Specified in the format 'projects/*/locations/*/operations/*'. @@ -1600,15 +1958,21 @@ message GetOperationRequest { // ListOperationsRequest lists operations. message ListOperationsRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the parent field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) to return operations for, or `-` for // all zones. This field has been deprecated and replaced by the parent field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; // The parent (project and location) where the operations will be listed. // Specified in the format 'projects/*/locations/*'. @@ -1618,19 +1982,28 @@ message ListOperationsRequest { // CancelOperationRequest cancels a single operation. message CancelOperationRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the operation resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The server-assigned `name` of the operation. + // Required. Deprecated. The server-assigned `name` of the operation. // This field has been deprecated and replaced by the name field. - string operation_id = 3 [deprecated = true]; + string operation_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; // The name (project, location, operation id) of the operation to cancel. // Specified in the format 'projects/*/locations/*/operations/*'. @@ -1649,18 +2022,24 @@ message ListOperationsResponse { // Gets the current Kubernetes Engine service configuration. message GetServerConfigRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) to return operations for. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // The name (project and location) of the server config to get - // Specified in the format 'projects/*/locations/*'. + // The name (project and location) of the server config to get, + // specified in the format 'projects/*/locations/*'. string name = 4; } @@ -1684,23 +2063,32 @@ message ServerConfig { // CreateNodePoolRequest creates a node pool for a cluster. message CreateNodePoolRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://developers.google.com/console/help/new/#projectnumber). // This field has been deprecated and replaced by the parent field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the parent field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster. + // Required. Deprecated. The name of the cluster. // This field has been deprecated and replaced by the parent field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // The node pool to create. - NodePool node_pool = 4; + // Required. The node pool to create. + NodePool node_pool = 4 [(google.api.field_behavior) = REQUIRED]; // The parent (project, location, cluster id) where the node pool will be // created. Specified in the format @@ -1710,24 +2098,36 @@ message CreateNodePoolRequest { // DeleteNodePoolRequest deletes a node pool for a cluster. message DeleteNodePoolRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://developers.google.com/console/help/new/#projectnumber). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster. + // Required. Deprecated. The name of the cluster. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the node pool to delete. + // Required. Deprecated. The name of the node pool to delete. // This field has been deprecated and replaced by the name field. - string node_pool_id = 4 [deprecated = true]; + string node_pool_id = 4 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; // The name (project, location, cluster, node pool id) of the node pool to // delete. Specified in the format @@ -1737,20 +2137,29 @@ message DeleteNodePoolRequest { // ListNodePoolsRequest lists the node pool(s) for a cluster. message ListNodePoolsRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://developers.google.com/console/help/new/#projectnumber). // This field has been deprecated and replaced by the parent field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the parent field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster. + // Required. Deprecated. The name of the cluster. // This field has been deprecated and replaced by the parent field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; // The parent (project, location, cluster id) where the node pools will be // listed. Specified in the format 'projects/*/locations/*/clusters/*'. @@ -1759,24 +2168,36 @@ message ListNodePoolsRequest { // GetNodePoolRequest retrieves a node pool for a cluster. message GetNodePoolRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://developers.google.com/console/help/new/#projectnumber). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster. + // Required. Deprecated. The name of the cluster. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the node pool. + // Required. Deprecated. The name of the node pool. // This field has been deprecated and replaced by the name field. - string node_pool_id = 4 [deprecated = true]; + string node_pool_id = 4 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; // The name (project, location, cluster, node pool id) of the node pool to // get. Specified in the format @@ -1858,6 +2279,16 @@ message NodePool { // NodeManagement configuration for this NodePool. NodeManagement management = 5; + + // The constraint on the maximum number of pods that can be run + // simultaneously on a node in the node pool. + MaxPodsConstraint max_pods_constraint = 6; + + // Which conditions caused the current node pool state. + repeated StatusCondition conditions = 105; + + // [Output only] The pod CIDR block size per node in this node pool. + int32 pod_ipv4_cidr_size = 7; } // NodeManagement defines the set of node management services turned on for the @@ -1895,6 +2326,13 @@ message AutoUpgradeOptions { message MaintenancePolicy { // Specifies the maintenance window in which maintenance may be performed. MaintenanceWindow window = 1; + + // A hash identifying the version of this policy, so that updates to fields of + // the policy won't accidentally undo intermediate changes (and so that users + // of the API unaware of some fields won't accidentally remove other fields). + // Make a get() request to the cluster to get the current + // resource version and include it with requests to set the policy. + string resource_version = 3; } // MaintenanceWindow defines the maintenance window to be used for the cluster. @@ -1902,14 +2340,68 @@ message MaintenanceWindow { oneof policy { // DailyMaintenanceWindow specifies a daily maintenance operation window. DailyMaintenanceWindow daily_maintenance_window = 2; + + // RecurringWindow specifies some number of recurring time periods for + // maintenance to occur. The time windows may be overlapping. If no + // maintenance windows are set, maintenance can occur at any time. + RecurringTimeWindow recurring_window = 3; } + + // Exceptions to maintenance window. Non-emergency maintenance should not + // occur in these windows. + map maintenance_exclusions = 4; +} + +// Represents an arbitrary window of time. +message TimeWindow { + // The time that the window first starts. + google.protobuf.Timestamp start_time = 1; + + // The time that the window ends. The end time should take place after the + // start time. + google.protobuf.Timestamp end_time = 2; +} + +// Represents an arbitrary window of time that recurs. +message RecurringTimeWindow { + // The window of the first recurrence. + TimeWindow window = 1; + + // An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how + // this window reccurs. They go on for the span of time between the start and + // end time. + // + // For example, to have something repeat every weekday, you'd use: + // FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR + // To repeat some window daily (equivalent to the DailyMaintenanceWindow): + // FREQ=DAILY + // For the first weekend of every month: + // FREQ=MONTHLY;BYSETPOS=1;BYDAY=SA,SU + // This specifies how frequently the window starts. Eg, if you wanted to have + // a 9-5 UTC-4 window every weekday, you'd use something like: + // + // start time = 2019-01-01T09:00:00-0400 + // end time = 2019-01-01T17:00:00-0400 + // recurrence = FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR + // + // Windows can span multiple days. Eg, to make the window encompass every + // weekend from midnight Saturday till the last minute of Sunday UTC: + // + // start time = 2019-01-05T00:00:00Z + // end time = 2019-01-07T23:59:00Z + // recurrence = FREQ=WEEKLY;BYDAY=SA + // + // Note the start and end time's specific dates are largely arbitrary except + // to specify duration of the window and when it first starts. + // The FREQ values of HOURLY, MINUTELY, and SECONDLY are not supported. + string recurrence = 2; } // Time window specified for daily maintenance operations. message DailyMaintenanceWindow { // Time within the maintenance window to start the maintenance operations. // Time format should be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) - // format "HH:MM”, where HH : [00-23] and MM : [00-59] GMT. + // format "HH:MM", where HH : [00-23] and MM : [00-59] GMT. string start_time = 2; // [Output only] Duration of the time window, automatically chosen to be @@ -1922,27 +2414,39 @@ message DailyMaintenanceWindow { // SetNodePoolManagementRequest sets the node management properties of a node // pool. message SetNodePoolManagementRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster to update. + // Required. Deprecated. The name of the cluster to update. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the node pool to update. + // Required. Deprecated. The name of the node pool to update. // This field has been deprecated and replaced by the name field. - string node_pool_id = 4 [deprecated = true]; + string node_pool_id = 4 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // NodeManagement configuration for the node pool. - NodeManagement management = 5; + // Required. NodeManagement configuration for the node pool. + NodeManagement management = 5 [(google.api.field_behavior) = REQUIRED]; // The name (project, location, cluster, node pool id) of the node pool to set // management properties. Specified in the format @@ -1953,27 +2457,39 @@ message SetNodePoolManagementRequest { // SetNodePoolSizeRequest sets the size a node // pool. message SetNodePoolSizeRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster to update. + // Required. Deprecated. The name of the cluster to update. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the node pool to update. + // Required. Deprecated. The name of the node pool to update. // This field has been deprecated and replaced by the name field. - string node_pool_id = 4 [deprecated = true]; + string node_pool_id = 4 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // The desired node count for the pool. - int32 node_count = 5; + // Required. The desired node count for the pool. + int32 node_count = 5 [(google.api.field_behavior) = REQUIRED]; // The name (project, location, cluster, node pool id) of the node pool to set // size. @@ -1985,24 +2501,36 @@ message SetNodePoolSizeRequest { // NodePool upgrade. This will be an no-op if the last upgrade successfully // completed. message RollbackNodePoolUpgradeRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster to rollback. + // Required. Deprecated. The name of the cluster to rollback. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the node pool to rollback. + // Required. Deprecated. The name of the node pool to rollback. // This field has been deprecated and replaced by the name field. - string node_pool_id = 4 [deprecated = true]; + string node_pool_id = 4 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; // The name (project, location, cluster, node pool id) of the node poll to // rollback upgrade. @@ -2016,6 +2544,52 @@ message ListNodePoolsResponse { repeated NodePool node_pools = 1; } +// ClusterAutoscaling contains global, per-cluster information +// required by Cluster Autoscaler to automatically adjust +// the size of the cluster and create/delete +// node pools based on the current needs. +message ClusterAutoscaling { + // Enables automatic node pool creation and deletion. + bool enable_node_autoprovisioning = 1; + + // Contains global constraints regarding minimum and maximum + // amount of resources in the cluster. + repeated ResourceLimit resource_limits = 2; + + // AutoprovisioningNodePoolDefaults contains defaults for a node pool + // created by NAP. + AutoprovisioningNodePoolDefaults autoprovisioning_node_pool_defaults = 4; + + // The list of Google Compute Engine [zones](/compute/docs/zones#available) + // in which the NodePool's nodes can be created by NAP. + repeated string autoprovisioning_locations = 5; +} + +// AutoprovisioningNodePoolDefaults contains defaults for a node pool created +// by NAP. +message AutoprovisioningNodePoolDefaults { + // Scopes that are used by NAP when creating node pools. If oauth_scopes are + // specified, service_account should be empty. + repeated string oauth_scopes = 1; + + // The Google Cloud Platform Service Account to be used by the node VMs. If + // service_account is specified, scopes should be empty. + string service_account = 2; +} + +// Contains information about amount of some resource in the cluster. +// For memory, value should be in GB. +message ResourceLimit { + // Resource name "cpu", "memory" or gpu-specific string. + string resource_type = 1; + + // Minimum amount of the resource in the cluster. + int64 minimum = 2; + + // Maximum amount of the resource in the cluster. + int64 maximum = 3; +} + // NodePoolAutoscaling contains information required by cluster autoscaler to // adjust the size of the node pool to the current cluster usage. message NodePoolAutoscaling { @@ -2029,37 +2603,49 @@ message NodePoolAutoscaling { // Maximum number of nodes in the NodePool. Must be >= min_node_count. There // has to enough quota to scale up the cluster. int32 max_node_count = 3; + + // Can this node pool be deleted automatically. + bool autoprovisioned = 4; } // SetLabelsRequest sets the Google Cloud Platform labels on a Google Container // Engine cluster, which will in turn set them for Google Compute Engine // resources used by that cluster message SetLabelsRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://developers.google.com/console/help/new/#projectnumber). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster. + // Required. Deprecated. The name of the cluster. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // The labels to set for that cluster. - map resource_labels = 4; + // Required. The labels to set for that cluster. + map resource_labels = 4 [(google.api.field_behavior) = REQUIRED]; - // The fingerprint of the previous set of labels for this resource, + // Required. The fingerprint of the previous set of labels for this resource, // used to detect conflicts. The fingerprint is initially generated by // Kubernetes Engine and changes after every request to modify or update // labels. You must always provide an up-to-date fingerprint hash when // updating or changing labels. Make a get() request to the // resource to get the latest fingerprint. - string label_fingerprint = 5; + string label_fingerprint = 5 [(google.api.field_behavior) = REQUIRED]; // The name (project, location, cluster id) of the cluster to set labels. // Specified in the format 'projects/*/locations/*/clusters/*'. @@ -2069,23 +2655,32 @@ message SetLabelsRequest { // SetLegacyAbacRequest enables or disables the ABAC authorization mechanism for // a cluster. message SetLegacyAbacRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster to update. + // Required. Deprecated. The name of the cluster to update. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Whether ABAC authorization will be enabled in the cluster. - bool enabled = 4; + // Required. Whether ABAC authorization will be enabled in the cluster. + bool enabled = 4 [(google.api.field_behavior) = REQUIRED]; // The name (project, location, cluster id) of the cluster to set legacy abac. // Specified in the format 'projects/*/locations/*/clusters/*'. @@ -2095,20 +2690,29 @@ message SetLegacyAbacRequest { // StartIPRotationRequest creates a new IP for the cluster and then performs // a node upgrade on each node pool to point to the new IP. message StartIPRotationRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://developers.google.com/console/help/new/#projectnumber). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster. + // Required. Deprecated. The name of the cluster. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; // The name (project, location, cluster id) of the cluster to start IP // rotation. Specified in the format 'projects/*/locations/*/clusters/*'. @@ -2120,20 +2724,29 @@ message StartIPRotationRequest { // CompleteIPRotationRequest moves the cluster master back into single-IP mode. message CompleteIPRotationRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://developers.google.com/console/help/new/#projectnumber). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster. + // Required. Deprecated. The name of the cluster. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; // The name (project, location, cluster id) of the cluster to complete IP // rotation. Specified in the format 'projects/*/locations/*/clusters/*'. @@ -2146,29 +2759,38 @@ message AcceleratorConfig { int64 accelerator_count = 1; // The accelerator type resource name. List of supported accelerators - // [here](/compute/docs/gpus/#Introduction) + // [here](/compute/docs/gpus) string accelerator_type = 2; } // SetNetworkPolicyRequest enables/disables network policy for a cluster. message SetNetworkPolicyRequest { - // Deprecated. The Google Developers Console [project ID or project + // Required. Deprecated. The Google Developers Console [project ID or project // number](https://developers.google.com/console/help/new/#projectnumber). // This field has been deprecated and replaced by the name field. - string project_id = 1 [deprecated = true]; + string project_id = 1 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the Google Compute Engine + // Required. Deprecated. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. // This field has been deprecated and replaced by the name field. - string zone = 2 [deprecated = true]; + string zone = 2 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Deprecated. The name of the cluster. + // Required. Deprecated. The name of the cluster. // This field has been deprecated and replaced by the name field. - string cluster_id = 3 [deprecated = true]; + string cluster_id = 3 [ + deprecated = true, + (google.api.field_behavior) = REQUIRED + ]; - // Configuration options for the NetworkPolicy feature. - NetworkPolicy network_policy = 4; + // Required. Configuration options for the NetworkPolicy feature. + NetworkPolicy network_policy = 4 [(google.api.field_behavior) = REQUIRED]; // The name (project, location, cluster id) of the cluster to set networking // policy. Specified in the format 'projects/*/locations/*/clusters/*'. @@ -2177,21 +2799,21 @@ message SetNetworkPolicyRequest { // SetMaintenancePolicyRequest sets the maintenance policy for a cluster. message SetMaintenancePolicyRequest { - // The Google Developers Console [project ID or project + // Required. The Google Developers Console [project ID or project // number](https://support.google.com/cloud/answer/6158840). - string project_id = 1; + string project_id = 1 [(google.api.field_behavior) = REQUIRED]; - // The name of the Google Compute Engine + // Required. The name of the Google Compute Engine // [zone](/compute/docs/zones#available) in which the cluster // resides. - string zone = 2; + string zone = 2 [(google.api.field_behavior) = REQUIRED]; - // The name of the cluster to update. - string cluster_id = 3; + // Required. The name of the cluster to update. + string cluster_id = 3 [(google.api.field_behavior) = REQUIRED]; - // The maintenance policy to be set for the cluster. An empty field + // Required. The maintenance policy to be set for the cluster. An empty field // clears the existing maintenance policy. - MaintenancePolicy maintenance_policy = 4; + MaintenancePolicy maintenance_policy = 4 [(google.api.field_behavior) = REQUIRED]; // The name (project, location, cluster id) of the cluster to set maintenance // policy. @@ -2199,6 +2821,40 @@ message SetMaintenancePolicyRequest { string name = 5; } +// StatusCondition describes why a cluster or a node pool has a certain status +// (e.g., ERROR or DEGRADED). +message StatusCondition { + // Code for each condition + enum Code { + // UNKNOWN indicates a generic condition. + UNKNOWN = 0; + + // GCE_STOCKOUT indicates a Google Compute Engine stockout. + GCE_STOCKOUT = 1; + + // GKE_SERVICE_ACCOUNT_DELETED indicates that the user deleted their robot + // service account. + GKE_SERVICE_ACCOUNT_DELETED = 2; + + // Google Compute Engine quota was exceeded. + GCE_QUOTA_EXCEEDED = 3; + + // Cluster state was manually changed by an SRE due to a system logic error. + SET_BY_OPERATOR = 4; + + // Unable to perform an encrypt operation against the CloudKMS key used for + // etcd level encryption. + // More codes TBA + CLOUD_KMS_KEY_ERROR = 7; + } + + // Machine-friendly representation of the condition + Code code = 1; + + // Human-friendly representation of the condition + string message = 2; +} + // NetworkConfig reports the relative names of network & subnetwork. message NetworkConfig { // Output only. The relative name of the Google Compute Engine @@ -2211,4 +2867,175 @@ message NetworkConfig { // [subnetwork](/compute/docs/vpc) to which the cluster is connected. // Example: projects/my-project/regions/us-central1/subnetworks/my-subnet string subnetwork = 2; + + // Whether Intra-node visibility is enabled for this cluster. + // This makes same node pod to pod traffic visible for VPC network. + bool enable_intra_node_visibility = 5; +} + +// IntraNodeVisibilityConfig contains the desired config of the intra-node +// visibility on this cluster. +message IntraNodeVisibilityConfig { + // Enables intra node visibility for this cluster. + bool enabled = 1; +} + +// Constraints applied to pods. +message MaxPodsConstraint { + // Constraint enforced on the max num of pods per node. + int64 max_pods_per_node = 1; +} + +// Configuration of etcd encryption. +message DatabaseEncryption { + // State of etcd encryption. + enum State { + // Should never be set + UNKNOWN = 0; + + // Secrets in etcd are encrypted. + ENCRYPTED = 1; + + // Secrets in etcd are stored in plain text (at etcd level) - this is + // unrelated to GCE level full disk encryption. + DECRYPTED = 2; + } + + // Denotes the state of etcd encryption. + State state = 2; + + // Name of CloudKMS key to use for the encryption of secrets in etcd. + // Ex. projects/my-project/locations/global/keyRings/my-ring/cryptoKeys/my-key + string key_name = 1; +} + +// ListUsableSubnetworksRequest requests the list of usable subnetworks +// available to a user for creating clusters. +message ListUsableSubnetworksRequest { + // The parent project where subnetworks are usable. + // Specified in the format 'projects/*'. + string parent = 1; + + // Filtering currently only supports equality on the networkProjectId and must + // be in the form: "networkProjectId=[PROJECTID]", where `networkProjectId` + // is the project which owns the listed subnetworks. This defaults to the + // parent project ID. + string filter = 2; + + // The max number of results per page that should be returned. If the number + // of available results is larger than `page_size`, a `next_page_token` is + // returned which can be used to get the next page of results in subsequent + // requests. Acceptable values are 0 to 500, inclusive. (Default: 500) + int32 page_size = 3; + + // Specifies a page token to use. Set this to the nextPageToken returned by + // previous list requests to get the next page of results. + string page_token = 4; +} + +// ListUsableSubnetworksResponse is the response of +// ListUsableSubnetworksRequest. +message ListUsableSubnetworksResponse { + // A list of usable subnetworks in the specified network project. + repeated UsableSubnetwork subnetworks = 1; + + // This token allows you to get the next page of results for list requests. + // If the number of results is larger than `page_size`, use the + // `next_page_token` as a value for the query parameter `page_token` in the + // next request. The value will become empty when there are no more pages. + string next_page_token = 2; +} + +// Secondary IP range of a usable subnetwork. +message UsableSubnetworkSecondaryRange { + // Status shows the current usage of a secondary IP range. + enum Status { + // UNKNOWN is the zero value of the Status enum. It's not a valid status. + UNKNOWN = 0; + + // UNUSED denotes that this range is unclaimed by any cluster. + UNUSED = 1; + + // IN_USE_SERVICE denotes that this range is claimed by a cluster for + // services. It cannot be used for other clusters. + IN_USE_SERVICE = 2; + + // IN_USE_SHAREABLE_POD denotes this range was created by the network admin + // and is currently claimed by a cluster for pods. It can only be used by + // other clusters as a pod range. + IN_USE_SHAREABLE_POD = 3; + + // IN_USE_MANAGED_POD denotes this range was created by GKE and is claimed + // for pods. It cannot be used for other clusters. + IN_USE_MANAGED_POD = 4; + } + + // The name associated with this subnetwork secondary range, used when adding + // an alias IP range to a VM instance. + string range_name = 1; + + // The range of IP addresses belonging to this subnetwork secondary range. + string ip_cidr_range = 2; + + // This field is to determine the status of the secondary range programmably. + Status status = 3; +} + +// UsableSubnetwork resource returns the subnetwork name, its associated network +// and the primary CIDR range. +message UsableSubnetwork { + // Subnetwork Name. + // Example: projects/my-project/regions/us-central1/subnetworks/my-subnet + string subnetwork = 1; + + // Network Name. + // Example: projects/my-project/global/networks/my-network + string network = 2; + + // The range of internal addresses that are owned by this subnetwork. + string ip_cidr_range = 3; + + // Secondary IP ranges. + repeated UsableSubnetworkSecondaryRange secondary_ip_ranges = 4; + + // A human readable status message representing the reasons for cases where + // the caller cannot use the secondary ranges under the subnet. For example if + // the secondary_ip_ranges is empty due to a permission issue, an insufficient + // permission message will be given by status_message. + string status_message = 5; +} + +// Configuration for exporting cluster resource usages. +message ResourceUsageExportConfig { + // Parameters for using BigQuery as the destination of resource usage export. + message BigQueryDestination { + // The ID of a BigQuery Dataset. + string dataset_id = 1; + } + + // Parameters for controlling consumption metering. + message ConsumptionMeteringConfig { + // Whether to enable consumption metering for this cluster. If enabled, a + // second BigQuery table will be created to hold resource consumption + // records. + bool enabled = 1; + } + + // Configuration to use BigQuery as usage export destination. + BigQueryDestination bigquery_destination = 1; + + // Whether to enable network egress metering for this cluster. If enabled, a + // daemonset will be created in the cluster to meter network egress traffic. + bool enable_network_egress_metering = 2; + + // Configuration to enable resource consumption metering. + ConsumptionMeteringConfig consumption_metering_config = 3; +} + +// VerticalPodAutoscaling contains global, per-cluster information +// required by Vertical Pod Autoscaler to automatically adjust +// the resources of pods controlled by it. +message VerticalPodAutoscaling { + // Enables vertical pod autoscaling. + bool enabled = 1; } diff --git a/google/cloud/container_v1/proto/cluster_service_pb2.py b/google/cloud/container_v1/proto/cluster_service_pb2.py index 8e0e829a..cc473062 100644 --- a/google/cloud/container_v1/proto/cluster_service_pb2.py +++ b/google/cloud/container_v1/proto/cluster_service_pb2.py @@ -17,7 +17,10 @@ from google.api import annotations_pb2 as google_dot_api_dot_annotations__pb2 +from google.api import client_pb2 as google_dot_api_dot_client__pb2 +from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2 +from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2 DESCRIPTOR = _descriptor.FileDescriptor( @@ -28,15 +31,52 @@ "\n\027com.google.container.v1B\023ClusterServiceProtoP\001Z\n\x16\x44\x61ilyMaintenanceWindow\x12\x12\n\nstart_time\x18\x02 \x01(\t\x12\x10\n\x08\x64uration\x18\x03 \x01(\t"\xc1\x01\n\x1cSetNodePoolManagementRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x18\n\x0cnode_pool_id\x18\x04 \x01(\tB\x02\x18\x01\x12\x37\n\nmanagement\x18\x05 \x01(\x0b\x32#.google.container.v1.NodeManagement\x12\x0c\n\x04name\x18\x07 \x01(\t"\x96\x01\n\x16SetNodePoolSizeRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x18\n\x0cnode_pool_id\x18\x04 \x01(\tB\x02\x18\x01\x12\x12\n\nnode_count\x18\x05 \x01(\x05\x12\x0c\n\x04name\x18\x07 \x01(\t"\x8a\x01\n\x1eRollbackNodePoolUpgradeRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x18\n\x0cnode_pool_id\x18\x04 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x06 \x01(\t"J\n\x15ListNodePoolsResponse\x12\x31\n\nnode_pools\x18\x01 \x03(\x0b\x32\x1d.google.container.v1.NodePool"V\n\x13NodePoolAutoscaling\x12\x0f\n\x07\x65nabled\x18\x01 \x01(\x08\x12\x16\n\x0emin_node_count\x18\x02 \x01(\x05\x12\x16\n\x0emax_node_count\x18\x03 \x01(\x05"\x88\x02\n\x10SetLabelsRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12R\n\x0fresource_labels\x18\x04 \x03(\x0b\x32\x39.google.container.v1.SetLabelsRequest.ResourceLabelsEntry\x12\x19\n\x11label_fingerprint\x18\x05 \x01(\t\x12\x0c\n\x04name\x18\x07 \x01(\t\x1a\x35\n\x13ResourceLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"w\n\x14SetLegacyAbacRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0f\n\x07\x65nabled\x18\x04 \x01(\x08\x12\x0c\n\x04name\x18\x06 \x01(\t"\x84\x01\n\x16StartIPRotationRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x06 \x01(\t\x12\x1a\n\x12rotate_credentials\x18\x07 \x01(\x08"k\n\x19\x43ompleteIPRotationRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12\x0c\n\x04name\x18\x07 \x01(\t"H\n\x11\x41\x63\x63\x65leratorConfig\x12\x19\n\x11\x61\x63\x63\x65lerator_count\x18\x01 \x01(\x03\x12\x18\n\x10\x61\x63\x63\x65lerator_type\x18\x02 \x01(\t"\xa5\x01\n\x17SetNetworkPolicyRequest\x12\x16\n\nproject_id\x18\x01 \x01(\tB\x02\x18\x01\x12\x10\n\x04zone\x18\x02 \x01(\tB\x02\x18\x01\x12\x16\n\ncluster_id\x18\x03 \x01(\tB\x02\x18\x01\x12:\n\x0enetwork_policy\x18\x04 \x01(\x0b\x32".google.container.v1.NetworkPolicy\x12\x0c\n\x04name\x18\x06 \x01(\t"\xa5\x01\n\x1bSetMaintenancePolicyRequest\x12\x12\n\nproject_id\x18\x01 \x01(\t\x12\x0c\n\x04zone\x18\x02 \x01(\t\x12\x12\n\ncluster_id\x18\x03 \x01(\t\x12\x42\n\x12maintenance_policy\x18\x04 \x01(\x0b\x32&.google.container.v1.MaintenancePolicy\x12\x0c\n\x04name\x18\x05 \x01(\t"4\n\rNetworkConfig\x12\x0f\n\x07network\x18\x01 \x01(\t\x12\x12\n\nsubnetwork\x18\x02 \x01(\t2\xcb\x39\n\x0e\x43lusterManager\x12\xcc\x01\n\x0cListClusters\x12(.google.container.v1.ListClustersRequest\x1a).google.container.v1.ListClustersResponse"g\x82\xd3\xe4\x93\x02\x61\x12,/v1/{parent=projects/*/locations/*}/clustersZ1\x12//v1/projects/{project_id}/zones/{zone}/clusters\x12\xc8\x01\n\nGetCluster\x12&.google.container.v1.GetClusterRequest\x1a\x1c.google.container.v1.Cluster"t\x82\xd3\xe4\x93\x02n\x12,/v1/{name=projects/*/locations/*/clusters/*}Z>\x12*/v1/{name=projects/*/locations/*/clusters/*}:setResourceLabels:\x01*ZP"K/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/resourceLabels:\x01*\x12\xf1\x01\n\rSetLegacyAbac\x12).google.container.v1.SetLegacyAbacRequest\x1a\x1e.google.container.v1.Operation"\x94\x01\x82\xd3\xe4\x93\x02\x8d\x01":/v1/{name=projects/*/locations/*/clusters/*}:setLegacyAbac:\x01*ZL"G/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/legacyAbac:\x01*\x12\xfc\x01\n\x0fStartIPRotation\x12+.google.container.v1.StartIPRotationRequest\x1a\x1e.google.container.v1.Operation"\x9b\x01\x82\xd3\xe4\x93\x02\x94\x01"\n\x16\x44\x61ilyMaintenanceWindow\x12\x12\n\nstart_time\x18\x02 \x01(\t\x12\x10\n\x08\x64uration\x18\x03 \x01(\t"\xd2\x01\n\x1cSetNodePoolManagementRequest\x12\x19\n\nproject_id\x18\x01 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x13\n\x04zone\x18\x02 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x19\n\ncluster_id\x18\x03 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x1b\n\x0cnode_pool_id\x18\x04 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12<\n\nmanagement\x18\x05 \x01(\x0b\x32#.google.container.v1.NodeManagementB\x03\xe0\x41\x02\x12\x0c\n\x04name\x18\x07 \x01(\t"\xa7\x01\n\x16SetNodePoolSizeRequest\x12\x19\n\nproject_id\x18\x01 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x13\n\x04zone\x18\x02 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x19\n\ncluster_id\x18\x03 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x1b\n\x0cnode_pool_id\x18\x04 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x17\n\nnode_count\x18\x05 \x01(\x05\x42\x03\xe0\x41\x02\x12\x0c\n\x04name\x18\x07 \x01(\t"\x96\x01\n\x1eRollbackNodePoolUpgradeRequest\x12\x19\n\nproject_id\x18\x01 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x13\n\x04zone\x18\x02 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x19\n\ncluster_id\x18\x03 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x1b\n\x0cnode_pool_id\x18\x04 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x0c\n\x04name\x18\x06 \x01(\t"J\n\x15ListNodePoolsResponse\x12\x31\n\nnode_pools\x18\x01 \x03(\x0b\x32\x1d.google.container.v1.NodePool"\xff\x01\n\x12\x43lusterAutoscaling\x12$\n\x1c\x65nable_node_autoprovisioning\x18\x01 \x01(\x08\x12;\n\x0fresource_limits\x18\x02 \x03(\x0b\x32".google.container.v1.ResourceLimit\x12\x62\n#autoprovisioning_node_pool_defaults\x18\x04 \x01(\x0b\x32\x35.google.container.v1.AutoprovisioningNodePoolDefaults\x12"\n\x1a\x61utoprovisioning_locations\x18\x05 \x03(\t"Q\n AutoprovisioningNodePoolDefaults\x12\x14\n\x0coauth_scopes\x18\x01 \x03(\t\x12\x17\n\x0fservice_account\x18\x02 \x01(\t"H\n\rResourceLimit\x12\x15\n\rresource_type\x18\x01 \x01(\t\x12\x0f\n\x07minimum\x18\x02 \x01(\x03\x12\x0f\n\x07maximum\x18\x03 \x01(\x03"o\n\x13NodePoolAutoscaling\x12\x0f\n\x07\x65nabled\x18\x01 \x01(\x08\x12\x16\n\x0emin_node_count\x18\x02 \x01(\x05\x12\x16\n\x0emax_node_count\x18\x03 \x01(\x05\x12\x17\n\x0f\x61utoprovisioned\x18\x04 \x01(\x08"\x9b\x02\n\x10SetLabelsRequest\x12\x19\n\nproject_id\x18\x01 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x13\n\x04zone\x18\x02 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x19\n\ncluster_id\x18\x03 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12W\n\x0fresource_labels\x18\x04 \x03(\x0b\x32\x39.google.container.v1.SetLabelsRequest.ResourceLabelsEntryB\x03\xe0\x41\x02\x12\x1e\n\x11label_fingerprint\x18\x05 \x01(\tB\x03\xe0\x41\x02\x12\x0c\n\x04name\x18\x07 \x01(\t\x1a\x35\n\x13ResourceLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"\x85\x01\n\x14SetLegacyAbacRequest\x12\x19\n\nproject_id\x18\x01 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x13\n\x04zone\x18\x02 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x19\n\ncluster_id\x18\x03 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x14\n\x07\x65nabled\x18\x04 \x01(\x08\x42\x03\xe0\x41\x02\x12\x0c\n\x04name\x18\x06 \x01(\t"\x8d\x01\n\x16StartIPRotationRequest\x12\x19\n\nproject_id\x18\x01 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x13\n\x04zone\x18\x02 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x19\n\ncluster_id\x18\x03 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x0c\n\x04name\x18\x06 \x01(\t\x12\x1a\n\x12rotate_credentials\x18\x07 \x01(\x08"t\n\x19\x43ompleteIPRotationRequest\x12\x19\n\nproject_id\x18\x01 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x13\n\x04zone\x18\x02 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x19\n\ncluster_id\x18\x03 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x0c\n\x04name\x18\x07 \x01(\t"H\n\x11\x41\x63\x63\x65leratorConfig\x12\x19\n\x11\x61\x63\x63\x65lerator_count\x18\x01 \x01(\x03\x12\x18\n\x10\x61\x63\x63\x65lerator_type\x18\x02 \x01(\t"\xb3\x01\n\x17SetNetworkPolicyRequest\x12\x19\n\nproject_id\x18\x01 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x13\n\x04zone\x18\x02 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12\x19\n\ncluster_id\x18\x03 \x01(\tB\x05\x18\x01\xe0\x41\x02\x12?\n\x0enetwork_policy\x18\x04 \x01(\x0b\x32".google.container.v1.NetworkPolicyB\x03\xe0\x41\x02\x12\x0c\n\x04name\x18\x06 \x01(\t"\xb9\x01\n\x1bSetMaintenancePolicyRequest\x12\x17\n\nproject_id\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x11\n\x04zone\x18\x02 \x01(\tB\x03\xe0\x41\x02\x12\x17\n\ncluster_id\x18\x03 \x01(\tB\x03\xe0\x41\x02\x12G\n\x12maintenance_policy\x18\x04 \x01(\x0b\x32&.google.container.v1.MaintenancePolicyB\x03\xe0\x41\x02\x12\x0c\n\x04name\x18\x05 \x01(\t"\xea\x01\n\x0fStatusCondition\x12\x37\n\x04\x63ode\x18\x01 \x01(\x0e\x32).google.container.v1.StatusCondition.Code\x12\x0f\n\x07message\x18\x02 \x01(\t"\x8c\x01\n\x04\x43ode\x12\x0b\n\x07UNKNOWN\x10\x00\x12\x10\n\x0cGCE_STOCKOUT\x10\x01\x12\x1f\n\x1bGKE_SERVICE_ACCOUNT_DELETED\x10\x02\x12\x16\n\x12GCE_QUOTA_EXCEEDED\x10\x03\x12\x13\n\x0fSET_BY_OPERATOR\x10\x04\x12\x17\n\x13\x43LOUD_KMS_KEY_ERROR\x10\x07"Z\n\rNetworkConfig\x12\x0f\n\x07network\x18\x01 \x01(\t\x12\x12\n\nsubnetwork\x18\x02 \x01(\t\x12$\n\x1c\x65nable_intra_node_visibility\x18\x05 \x01(\x08",\n\x19IntraNodeVisibilityConfig\x12\x0f\n\x07\x65nabled\x18\x01 \x01(\x08".\n\x11MaxPodsConstraint\x12\x19\n\x11max_pods_per_node\x18\x01 \x01(\x03"\x98\x01\n\x12\x44\x61tabaseEncryption\x12<\n\x05state\x18\x02 \x01(\x0e\x32-.google.container.v1.DatabaseEncryption.State\x12\x10\n\x08key_name\x18\x01 \x01(\t"2\n\x05State\x12\x0b\n\x07UNKNOWN\x10\x00\x12\r\n\tENCRYPTED\x10\x01\x12\r\n\tDECRYPTED\x10\x02"e\n\x1cListUsableSubnetworksRequest\x12\x0e\n\x06parent\x18\x01 \x01(\t\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"t\n\x1dListUsableSubnetworksResponse\x12:\n\x0bsubnetworks\x18\x01 \x03(\x0b\x32%.google.container.v1.UsableSubnetwork\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x80\x02\n\x1eUsableSubnetworkSecondaryRange\x12\x12\n\nrange_name\x18\x01 \x01(\t\x12\x15\n\rip_cidr_range\x18\x02 \x01(\t\x12J\n\x06status\x18\x03 \x01(\x0e\x32:.google.container.v1.UsableSubnetworkSecondaryRange.Status"g\n\x06Status\x12\x0b\n\x07UNKNOWN\x10\x00\x12\n\n\x06UNUSED\x10\x01\x12\x12\n\x0eIN_USE_SERVICE\x10\x02\x12\x18\n\x14IN_USE_SHAREABLE_POD\x10\x03\x12\x16\n\x12IN_USE_MANAGED_POD\x10\x04"\xb8\x01\n\x10UsableSubnetwork\x12\x12\n\nsubnetwork\x18\x01 \x01(\t\x12\x0f\n\x07network\x18\x02 \x01(\t\x12\x15\n\rip_cidr_range\x18\x03 \x01(\t\x12P\n\x13secondary_ip_ranges\x18\x04 \x03(\x0b\x32\x33.google.container.v1.UsableSubnetworkSecondaryRange\x12\x16\n\x0estatus_message\x18\x05 \x01(\t"\xed\x02\n\x19ResourceUsageExportConfig\x12`\n\x14\x62igquery_destination\x18\x01 \x01(\x0b\x32\x42.google.container.v1.ResourceUsageExportConfig.BigQueryDestination\x12&\n\x1e\x65nable_network_egress_metering\x18\x02 \x01(\x08\x12m\n\x1b\x63onsumption_metering_config\x18\x03 \x01(\x0b\x32H.google.container.v1.ResourceUsageExportConfig.ConsumptionMeteringConfig\x1a)\n\x13\x42igQueryDestination\x12\x12\n\ndataset_id\x18\x01 \x01(\t\x1a,\n\x19\x43onsumptionMeteringConfig\x12\x0f\n\x07\x65nabled\x18\x01 \x01(\x08")\n\x16VerticalPodAutoscaling\x12\x0f\n\x07\x65nabled\x18\x01 \x01(\x08\x32\xa1\x42\n\x0e\x43lusterManager\x12\xde\x01\n\x0cListClusters\x12(.google.container.v1.ListClustersRequest\x1a).google.container.v1.ListClustersResponse"y\x82\xd3\xe4\x93\x02\x61\x12,/v1/{parent=projects/*/locations/*}/clustersZ1\x12//v1/projects/{project_id}/zones/{zone}/clusters\xda\x41\x0fproject_id,zone\x12\xe6\x01\n\nGetCluster\x12&.google.container.v1.GetClusterRequest\x1a\x1c.google.container.v1.Cluster"\x91\x01\x82\xd3\xe4\x93\x02n\x12,/v1/{name=projects/*/locations/*/clusters/*}Z>\x12*/v1/{name=projects/*/locations/*/clusters/*}:setResourceLabels:\x01*ZP"K/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/resourceLabels:\x01*\x12\x96\x02\n\rSetLegacyAbac\x12).google.container.v1.SetLegacyAbacRequest\x1a\x1e.google.container.v1.Operation"\xb9\x01\x82\xd3\xe4\x93\x02\x8d\x01":/v1/{name=projects/*/locations/*/clusters/*}:setLegacyAbac:\x01*ZL"G/v1/projects/{project_id}/zones/{zone}/clusters/{cluster_id}/legacyAbac:\x01*\xda\x41"project_id,zone,cluster_id,enabled\x12\x99\x02\n\x0fStartIPRotation\x12+.google.container.v1.StartIPRotationRequest\x1a\x1e.google.container.v1.Operation"\xb8\x01\x82\xd3\xe4\x93\x02\x94\x01"`__ + taints: + List of kubernetes taints to be applied to each node. For + more information, including usage and the valid values, see: + https://kubernetes.io/docs/concepts/configuration/taint-and- + toleration/ + shielded_instance_config: + Shielded Instance options. """, # @@protoc_insertion_point(class_scope:google.container.v1.NodeConfig) ), @@ -7293,6 +9522,61 @@ _sym_db.RegisterMessage(NodeConfig.MetadataEntry) _sym_db.RegisterMessage(NodeConfig.LabelsEntry) +ShieldedInstanceConfig = _reflection.GeneratedProtocolMessageType( + "ShieldedInstanceConfig", + (_message.Message,), + dict( + DESCRIPTOR=_SHIELDEDINSTANCECONFIG, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""A set of Shielded Instance options. + + + Attributes: + enable_secure_boot: + Defines whether the instance has Secure Boot enabled. Secure + Boot helps ensure that the system only runs authentic software + by verifying the digital signature of all boot components, and + halting the boot process if signature verification fails. + enable_integrity_monitoring: + Defines whether the instance has integrity monitoring enabled. + Enables monitoring and attestation of the boot integrity of + the instance. The attestation is performed against the + integrity policy baseline. This baseline is initially derived + from the implicitly trusted boot image when the instance is + created. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.ShieldedInstanceConfig) + ), +) +_sym_db.RegisterMessage(ShieldedInstanceConfig) + +NodeTaint = _reflection.GeneratedProtocolMessageType( + "NodeTaint", + (_message.Message,), + dict( + DESCRIPTOR=_NODETAINT, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""Kubernetes taint is comprised of three fields: key, value, and effect. + Effect can only be one of three types: NoSchedule, PreferNoSchedule or + NoExecute. + + For more information, including usage and the valid values, see: + https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/ + + + Attributes: + key: + Key for taint. + value: + Value for taint. + effect: + Effect for taint. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.NodeTaint) + ), +) +_sym_db.RegisterMessage(NodeTaint) + MasterAuth = _reflection.GeneratedProtocolMessageType( "MasterAuth", (_message.Message,), @@ -7307,8 +9591,9 @@ Attributes: username: The username to use for HTTP basic authentication to the - master endpoint. For clusters v1.6.0 and later, you can - disable basic authentication by providing an empty username. + master endpoint. For clusters v1.6.0 and later, basic + authentication can be disabled by leaving username unspecified + (or setting it to the empty string). password: The password to use for HTTP basic authentication to the master endpoint. Because the master endpoint is open to the @@ -7372,11 +9657,19 @@ replication controller has based on the resource usage of the existing pods. kubernetes_dashboard: - Configuration for the Kubernetes Dashboard. + Configuration for the Kubernetes Dashboard. This addon is + deprecated, and will be disabled in 1.15. It is recommended to + use the Cloud Console to manage and monitor your Kubernetes + clusters, workloads and applications. For more information, + see: https://cloud.google.com/kubernetes- + engine/docs/concepts/dashboards network_policy_config: Configuration for NetworkPolicy. This only tracks whether the addon is enabled or not on the Master, it does not track whether network policy is enabled for the nodes. + cloud_run_config: + Configuration for the Cloud Run addon, which allows the user + to use a managed Knative service. """, # @@protoc_insertion_point(class_scope:google.container.v1.AddonsConfig) ), @@ -7501,6 +9794,46 @@ ) _sym_db.RegisterMessage(PrivateClusterConfig) +AuthenticatorGroupsConfig = _reflection.GeneratedProtocolMessageType( + "AuthenticatorGroupsConfig", + (_message.Message,), + dict( + DESCRIPTOR=_AUTHENTICATORGROUPSCONFIG, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""Configuration for returning group information from authenticators. + + + Attributes: + enabled: + Whether this cluster should return group membership lookups + during authentication using a group of security groups. + security_group: + The name of the security group-of-groups to be used. Only + relevant if enabled = true. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.AuthenticatorGroupsConfig) + ), +) +_sym_db.RegisterMessage(AuthenticatorGroupsConfig) + +CloudRunConfig = _reflection.GeneratedProtocolMessageType( + "CloudRunConfig", + (_message.Message,), + dict( + DESCRIPTOR=_CLOUDRUNCONFIG, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""Configuration options for the Cloud Run feature. + + + Attributes: + disabled: + Whether Cloud Run addon is enabled for this cluster. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.CloudRunConfig) + ), +) +_sym_db.RegisterMessage(CloudRunConfig) + MasterAuthorizedNetworksConfig = _reflection.GeneratedProtocolMessageType( "MasterAuthorizedNetworksConfig", (_message.Message,), @@ -7536,7 +9869,7 @@ enabled: Whether or not master authorized networks is enabled. cidr_blocks: - cidr\_blocks define up to 10 external networks that could + cidr\_blocks define up to 50 external networks that could access Kubernetes master through HTTPS. """, # @@protoc_insertion_point(class_scope:google.container.v1.MasterAuthorizedNetworksConfig) @@ -7589,6 +9922,25 @@ ) _sym_db.RegisterMessage(NetworkPolicy) +BinaryAuthorization = _reflection.GeneratedProtocolMessageType( + "BinaryAuthorization", + (_message.Message,), + dict( + DESCRIPTOR=_BINARYAUTHORIZATION, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""Configuration for Binary Authorization. + + + Attributes: + enabled: + Enable Binary Authorization for this cluster. If enabled, all + container images will be validated by Binary Authorization. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.BinaryAuthorization) + ), +) +_sym_db.RegisterMessage(BinaryAuthorization) + IPAllocationPolicy = _reflection.GeneratedProtocolMessageType( "IPAllocationPolicy", (_message.Message,), @@ -7663,6 +10015,18 @@ RFC-1918 private networks (e.g. ``10.0.0.0/8``, ``172.16.0.0/12``, ``192.168.0.0/16``) to pick a specific range to use. + tpu_ipv4_cidr_block: + The IP address range of the Cloud TPUs in this cluster. If + unspecified, a range will be automatically chosen with the + default size. This field is only applicable when + ``use_ip_aliases`` is true. If unspecified, the range will + use the default size. Set to /netmask (e.g. ``/14``) to have + a range chosen with a specific netmask. Set to a `CIDR + `__ notation (e.g. ``10.96.0.0/14``) from the + RFC-1918 private networks (e.g. ``10.0.0.0/8``, + ``172.16.0.0/12``, ``192.168.0.0/16``) to pick a specific + range to use. """, # @@protoc_insertion_point(class_scope:google.container.v1.IPAllocationPolicy) ), @@ -7690,10 +10054,10 @@ Attributes: name: The name of this cluster. The name must be unique within this - project and zone, and can be up to 40 characters with the - following restrictions: - Lowercase letters, numbers, and - hyphens only. - Must start with a letter. - Must end with a - number or a letter. + project and location (e.g. zone or region), and can be up to + 40 characters with the following restrictions: - Lowercase + letters, numbers, and hyphens only. - Must start with a + letter. - Must end with a number or a letter. description: An optional description of this cluster. initial_node_count: @@ -7704,26 +10068,34 @@ lieu of a "node\_pool" object, since this configuration (along with the "node\_config") will be used to create a "NodePool" object with an auto-generated name. Do not use this and a - node\_pool at the same time. + node\_pool at the same time. This field is deprecated, use + node\_pool.initial\_node\_count instead. node_config: - Parameters used in creating the cluster's nodes. See - ``nodeConfig`` for the description of its properties. For - requests, this field should only be used in lieu of a - "node\_pool" object, since this configuration (along with the + Parameters used in creating the cluster's nodes. For requests, + this field should only be used in lieu of a "node\_pool" + object, since this configuration (along with the "initial\_node\_count") will be used to create a "NodePool" object with an auto-generated name. Do not use this and a node\_pool at the same time. For responses, this field will be populated with the node configuration of the first node pool. - If unspecified, the defaults are used. + (For configuration of each node pool, see + ``node_pool.config``) If unspecified, the defaults are used. + This field is deprecated, use node\_pool.config instead. master_auth: The authentication information for accessing the master - endpoint. + endpoint. If unspecified, the defaults are used: For clusters + before v1.12, if master\_auth is unspecified, ``username`` + will be set to "admin", a random password will be generated, + and a client certificate will be issued. logging_service: The logging service the cluster should use to write logs. - Currently available options: - ``logging.googleapis.com`` - - the Google Cloud Logging service. - ``none`` - no logs will - be exported from the cluster. - if left as an empty string,\ - ``logging.googleapis.com`` will be used. + Currently available options: - + "logging.googleapis.com/kubernetes" - the Google Cloud Logging + service with Kubernetes-native resource model - + ``logging.googleapis.com`` - the Google Cloud Logging service. + - ``none`` - no logs will be exported from the cluster. - if + left as an empty string,\ ``logging.googleapis.com`` will be + used. monitoring_service: The monitoring service the cluster should use to write metrics. Currently available options: - @@ -7754,7 +10126,7 @@ not be set if "node\_config" or "initial\_node\_count" are specified. locations: - The list of Google Compute Engine `locations + The list of Google Compute Engine `zones `__ in which the cluster's nodes should be located. enable_kubernetes_alpha: @@ -7780,10 +10152,28 @@ feature. maintenance_policy: Configure the maintenance policy for this cluster. + binary_authorization: + Configuration for Binary Authorization. + autoscaling: + Cluster-level autoscaling configuration. network_config: Configuration for cluster networking. + default_max_pods_constraint: + The default constraint on the maximum number of pods that can + be run simultaneously on a node in the node pool of this + cluster. Only honored if cluster created with IP Alias + support. + resource_usage_export_config: + Configuration for exporting resource usages. Resource usage + export is disabled when this config is unspecified. + authenticator_groups_config: + Configuration controlling RBAC group membership information. private_cluster_config: Configuration for private cluster. + database_encryption: + Configuration of etcd encryption. + vertical_pod_autoscaling: + Cluster-level Vertical Pod Autoscaling configuration. self_link: [Output only] Server-defined URL for the resource. zone: @@ -7813,9 +10203,9 @@ [Output only] The current software version of the master endpoint. current_node_version: - [Output only] Deprecated, use `NodePool.version `__ - instead. The current version of the node software + [Output only] Deprecated, use `NodePools.version `__ instead. The current version of the node software components. If they are currently at multiple versions because they're in the process of being upgraded, this reflects the minimum version of all nodes. @@ -7830,7 +10220,8 @@ node_ipv4_cidr_size: [Output only] The size of the address space on each node for hosting containers. This is provisioned from within the - ``container_ipv4_cidr`` range. + ``container_ipv4_cidr`` range. This field will only be set + when cluster is in route-based network mode. services_ipv4_cidr: [Output only] The IP address range of the Kubernetes services in this cluster, in `CIDR @@ -7842,6 +10233,8 @@ Deprecated. Use node\_pools.instance\_group\_urls. current_node_count: [Output only] The number of nodes currently in the cluster. + Deprecated. Call Kubernetes API directly to retrieve node + information. expire_time: [Output only] The time the cluster will be automatically deleted in `RFC3339 `__ @@ -7851,6 +10244,15 @@ `__ or `region `__ in which the cluster resides. + enable_tpu: + Enable the ability to use Cloud TPUs in this cluster. + tpu_ipv4_cidr_block: + [Output only] The IP address range of the Cloud TPUs in this + cluster, in `CIDR + `__ notation (e.g. ``1.2.3.4/29``). + conditions: + Which conditions caused the current cluster state. """, # @@protoc_insertion_point(class_scope:google.container.v1.Cluster) ), @@ -7883,6 +10285,8 @@ desired_monitoring_service: The monitoring service the cluster should use to write metrics. Currently available options: - + "monitoring.googleapis.com/kubernetes" - the Google Cloud + Monitoring service with Kubernetes-native resource model - "monitoring.googleapis.com" - the Google Cloud Monitoring service - "none" - no metrics will be exported from the cluster @@ -7897,13 +10301,15 @@ desired_image_type: The desired image type for the node pool. NOTE: Set the "desired\_node\_pool" field as well. + desired_database_encryption: + Configuration of etcd encryption. desired_node_pool_autoscaling: Autoscaler configuration for the node pool specified in desired\_node\_pool\_id. If there is only one pool in the cluster and desired\_node\_pool\_id is not provided then the change applies to that single node pool. desired_locations: - The desired list of Google Compute Engine `locations + The desired list of Google Compute Engine `zones `__ in which the cluster's nodes should be located. Changing the locations a cluster is in will result in nodes being either created or removed from @@ -7913,6 +10319,24 @@ desired_master_authorized_networks_config: The desired configuration options for master authorized networks feature. + desired_cluster_autoscaling: + Cluster-level autoscaling configuration. + desired_binary_authorization: + The desired configuration options for the Binary Authorization + feature. + desired_logging_service: + The logging service the cluster should use to write logs. + Currently available options: - + "logging.googleapis.com/kubernetes" - the Google Cloud Logging + service with Kubernetes-native resource model - + "logging.googleapis.com" - the Google Cloud Logging service - + "none" - no logs will be exported from the cluster + desired_resource_usage_export_config: + The desired configuration for exporting resource usage. + desired_vertical_pod_autoscaling: + Cluster-level Vertical Pod Autoscaling configuration. + desired_intra_node_visibility_config: + The desired config of Intra-node visibility. desired_master_version: The Kubernetes version to change the master to. Users may specify either explicit versions offered by Kubernetes Engine @@ -7968,6 +10392,10 @@ end_time: [Output only] The time the operation completed, in `RFC3339 `__ text format. + cluster_conditions: + Which conditions caused the current cluster state. + nodepool_conditions: + Which conditions caused the current node pool state. """, # @@protoc_insertion_point(class_scope:google.container.v1.Operation) ), @@ -7985,17 +10413,17 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the parent field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the parent field. cluster: - A `cluster resource `__ parent: The parent (project and location) where the cluster will be @@ -8017,18 +10445,18 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster to retrieve. This field - has been deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster to retrieve. + This field has been deprecated and replaced by the name field. name: The name (project, location, cluster) of the cluster to retrieve. Specified in the format @@ -8050,20 +10478,20 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster to upgrade. This field has - been deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster to upgrade. This + field has been deprecated and replaced by the name field. update: - A description of the update. + Required. A description of the update. name: The name (project, location, cluster) of the cluster to update. Specified in the format @@ -8085,33 +10513,33 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster to upgrade. This field has - been deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster to upgrade. This + field has been deprecated and replaced by the name field. node_pool_id: - Deprecated. The name of the node pool to upgrade. This field - has been deprecated and replaced by the name field. + Required. Deprecated. The name of the node pool to upgrade. + This field has been deprecated and replaced by the name field. node_version: - The Kubernetes version to change the nodes to (typically an - upgrade). Users may specify either explicit versions offered - by Kubernetes Engine or version aliases, which have the - following behavior: - "latest": picks the highest valid - Kubernetes version - "1.X": picks the highest valid - patch+gke.N patch in the 1.X version - "1.X.Y": picks the - highest valid gke.N patch in the 1.X.Y version - + Required. The Kubernetes version to change the nodes to + (typically an upgrade). Users may specify either explicit + versions offered by Kubernetes Engine or version aliases, + which have the following behavior: - "latest": picks the + highest valid Kubernetes version - "1.X": picks the highest + valid patch+gke.N patch in the 1.X version - "1.X.Y": picks + the highest valid gke.N patch in the 1.X.Y version - "1.X.Y-gke.N": picks an explicit Kubernetes version - "-": picks the Kubernetes master version image_type: - The desired image type for the node pool. + Required. The desired image type for the node pool. name: The name (project, location, cluster, node pool) of the node pool to update. Specified in the format @@ -8134,23 +10562,23 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster to upgrade. This field has - been deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster to upgrade. This + field has been deprecated and replaced by the name field. node_pool_id: - Deprecated. The name of the node pool to upgrade. This field - has been deprecated and replaced by the name field. + Required. Deprecated. The name of the node pool to upgrade. + This field has been deprecated and replaced by the name field. autoscaling: - Autoscaling configuration for the node pool. + Required. Autoscaling configuration for the node pool. name: The name (project, location, cluster, node pool) of the node pool to set autoscaler settings. Specified in the format @@ -8172,23 +10600,23 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster to upgrade. This field has - been deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster to upgrade. This + field has been deprecated and replaced by the name field. logging_service: - The logging service the cluster should use to write metrics. - Currently available options: - "logging.googleapis.com" - - the Google Cloud Logging service - "none" - no metrics will - be exported from the cluster + Required. The logging service the cluster should use to write + metrics. Currently available options: - + "logging.googleapis.com" - the Google Cloud Logging service - + "none" - no metrics will be exported from the cluster name: The name (project, location, cluster) of the cluster to set logging. Specified in the format @@ -8210,21 +10638,23 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster to upgrade. This field has - been deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster to upgrade. This + field has been deprecated and replaced by the name field. monitoring_service: - The monitoring service the cluster should use to write - metrics. Currently available options: - + Required. The monitoring service the cluster should use to + write metrics. Currently available options: - + "monitoring.googleapis.com/kubernetes" - the Google Cloud + Monitoring service with Kubernetes-native resource model - "monitoring.googleapis.com" - the Google Cloud Monitoring service - "none" - no metrics will be exported from the cluster @@ -8249,21 +10679,21 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster to upgrade. This field has - been deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster to upgrade. This + field has been deprecated and replaced by the name field. addons_config: - The desired configurations for the various addons available to - run in the cluster. + Required. The desired configurations for the various addons + available to run in the cluster. name: The name (project, location, cluster) of the cluster to set addons. Specified in the format @@ -8285,20 +10715,20 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster to upgrade. This field has - been deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster to upgrade. This + field has been deprecated and replaced by the name field. locations: - The desired list of Google Compute Engine `locations + Required. The desired list of Google Compute Engine `zones `__ in which the cluster's nodes should be located. Changing the locations a cluster is in will result in nodes being either created or removed from @@ -8326,27 +10756,28 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. - zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster - resides. This field has been deprecated and replaced by the - name field. - cluster_id: - Deprecated. The name of the cluster to upgrade. This field has - been deprecated and replaced by the name field. - master_version: - The Kubernetes version to change the master to. Users may - specify either explicit versions offered by Kubernetes Engine - or version aliases, which have the following behavior: - - "latest": picks the highest valid Kubernetes version - "1.X": - picks the highest valid patch+gke.N patch in the 1.X version - - "1.X.Y": picks the highest valid gke.N patch in the 1.X.Y - version - "1.X.Y-gke.N": picks an explicit Kubernetes version - - "-": picks the default Kubernetes version + zone: + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster + resides. This field has been deprecated and replaced by the + name field. + cluster_id: + Required. Deprecated. The name of the cluster to upgrade. This + field has been deprecated and replaced by the name field. + master_version: + Required. The Kubernetes version to change the master to. + Users may specify either explicit versions offered by + Kubernetes Engine or version aliases, which have the following + behavior: - "latest": picks the highest valid Kubernetes + version - "1.X": picks the highest valid patch+gke.N patch in + the 1.X version - "1.X.Y": picks the highest valid gke.N + patch in the 1.X.Y version - "1.X.Y-gke.N": picks an explicit + Kubernetes version - "-": picks the default Kubernetes + version name: The name (project, location, cluster) of the cluster to update. Specified in the format @@ -8368,22 +10799,23 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster to upgrade. This field has - been deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster to upgrade. This + field has been deprecated and replaced by the name field. action: - The exact form of action to be taken on the master auth. + Required. The exact form of action to be taken on the master + auth. update: - A description of the update. + Required. A description of the update. name: The name (project, location, cluster) of the cluster to set auth. Specified in the format @@ -8405,18 +10837,18 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster to delete. This field has - been deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster to delete. This + field has been deprecated and replaced by the name field. name: The name (project, location, cluster) of the cluster to delete. Specified in the format @@ -8438,13 +10870,13 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the parent field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides, or "-" for all zones. This field has been deprecated and replaced by the parent field. parent: @@ -8490,18 +10922,19 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. operation_id: - Deprecated. The server-assigned ``name`` of the operation. - This field has been deprecated and replaced by the name field. + Required. Deprecated. The server-assigned ``name`` of the + operation. This field has been deprecated and replaced by the + name field. name: The name (project, location, operation id) of the operation to get. Specified in the format @@ -8523,15 +10956,15 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the parent field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ to return operations for, - or ``-`` for all zones. This field has been deprecated and - replaced by the parent field. + Required. Deprecated. The name of the Google Compute Engine + `zone `__ to return operations + for, or ``-`` for all zones. This field has been deprecated + and replaced by the parent field. parent: The parent (project and location) where the operations will be listed. Specified in the format 'projects/*/locations/*'. @@ -8553,18 +10986,19 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the operation - resides. This field has been deprecated and replaced by the - name field. + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the + operation resides. This field has been deprecated and replaced + by the name field. operation_id: - Deprecated. The server-assigned ``name`` of the operation. - This field has been deprecated and replaced by the name field. + Required. Deprecated. The server-assigned ``name`` of the + operation. This field has been deprecated and replaced by the + name field. name: The name (project, location, operation id) of the operation to cancel. Specified in the format @@ -8607,17 +11041,18 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ to return operations for. - This field has been deprecated and replaced by the name field. + Required. Deprecated. The name of the Google Compute Engine + `zone `__ to return operations + for. This field has been deprecated and replaced by the name + field. name: - The name (project and location) of the server config to get - Specified in the format 'projects/*/locations/*'. + The name (project and location) of the server config to get, + specified in the format 'projects/*/locations/*'. """, # @@protoc_insertion_point(class_scope:google.container.v1.GetServerConfigRequest) ), @@ -8661,20 +11096,20 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number `__. This field has been deprecated and + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the parent field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the parent field. cluster_id: - Deprecated. The name of the cluster. This field has been - deprecated and replaced by the parent field. + Required. Deprecated. The name of the cluster. This field has + been deprecated and replaced by the parent field. node_pool: - The node pool to create. + Required. The node pool to create. parent: The parent (project, location, cluster id) where the node pool will be created. Specified in the format @@ -8696,21 +11131,21 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number `__. This field has been deprecated and + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster. This field has been - deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster. This field has + been deprecated and replaced by the name field. node_pool_id: - Deprecated. The name of the node pool to delete. This field - has been deprecated and replaced by the name field. + Required. Deprecated. The name of the node pool to delete. + This field has been deprecated and replaced by the name field. name: The name (project, location, cluster, node pool id) of the node pool to delete. Specified in the format @@ -8732,18 +11167,18 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number `__. This field has been deprecated and + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the parent field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the parent field. cluster_id: - Deprecated. The name of the cluster. This field has been - deprecated and replaced by the parent field. + Required. Deprecated. The name of the cluster. This field has + been deprecated and replaced by the parent field. parent: The parent (project, location, cluster id) where the node pools will be listed. Specified in the format @@ -8765,21 +11200,21 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number `__. This field has been deprecated and + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster. This field has been - deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster. This field has + been deprecated and replaced by the name field. node_pool_id: - Deprecated. The name of the node pool. This field has been - deprecated and replaced by the name field. + Required. Deprecated. The name of the node pool. This field + has been deprecated and replaced by the name field. name: The name (project, location, cluster, node pool id) of the node pool to get. Specified in the format @@ -8832,6 +11267,14 @@ enabled only if a valid configuration is present. management: NodeManagement configuration for this NodePool. + max_pods_constraint: + The constraint on the maximum number of pods that can be run + simultaneously on a node in the node pool. + conditions: + Which conditions caused the current node pool state. + pod_ipv4_cidr_size: + [Output only] The pod CIDR block size per node in this node + pool. """, # @@protoc_insertion_point(class_scope:google.container.v1.NodePool) ), @@ -8906,6 +11349,13 @@ window: Specifies the maintenance window in which maintenance may be performed. + resource_version: + A hash identifying the version of this policy, so that updates + to fields of the policy won't accidentally undo intermediate + changes (and so that users of the API unaware of some fields + won't accidentally remove other fields). Make a get() request + to the cluster to get the current resource version and include + it with requests to set the policy. """, # @@protoc_insertion_point(class_scope:google.container.v1.MaintenancePolicy) ), @@ -8916,6 +11366,15 @@ "MaintenanceWindow", (_message.Message,), dict( + MaintenanceExclusionsEntry=_reflection.GeneratedProtocolMessageType( + "MaintenanceExclusionsEntry", + (_message.Message,), + dict( + DESCRIPTOR=_MAINTENANCEWINDOW_MAINTENANCEEXCLUSIONSENTRY, + __module__="google.cloud.container_v1.proto.cluster_service_pb2" + # @@protoc_insertion_point(class_scope:google.container.v1.MaintenanceWindow.MaintenanceExclusionsEntry) + ), + ), DESCRIPTOR=_MAINTENANCEWINDOW, __module__="google.cloud.container_v1.proto.cluster_service_pb2", __doc__="""MaintenanceWindow defines the maintenance window to be used for the @@ -8926,11 +11385,80 @@ daily_maintenance_window: DailyMaintenanceWindow specifies a daily maintenance operation window. + recurring_window: + RecurringWindow specifies some number of recurring time + periods for maintenance to occur. The time windows may be + overlapping. If no maintenance windows are set, maintenance + can occur at any time. + maintenance_exclusions: + Exceptions to maintenance window. Non-emergency maintenance + should not occur in these windows. """, # @@protoc_insertion_point(class_scope:google.container.v1.MaintenanceWindow) ), ) _sym_db.RegisterMessage(MaintenanceWindow) +_sym_db.RegisterMessage(MaintenanceWindow.MaintenanceExclusionsEntry) + +TimeWindow = _reflection.GeneratedProtocolMessageType( + "TimeWindow", + (_message.Message,), + dict( + DESCRIPTOR=_TIMEWINDOW, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""Represents an arbitrary window of time. + + + Attributes: + start_time: + The time that the window first starts. + end_time: + The time that the window ends. The end time should take place + after the start time. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.TimeWindow) + ), +) +_sym_db.RegisterMessage(TimeWindow) + +RecurringTimeWindow = _reflection.GeneratedProtocolMessageType( + "RecurringTimeWindow", + (_message.Message,), + dict( + DESCRIPTOR=_RECURRINGTIMEWINDOW, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""Represents an arbitrary window of time that recurs. + + + Attributes: + window: + The window of the first recurrence. + recurrence: + An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) + for how this window reccurs. They go on for the span of time + between the start and end time. For example, to have + something repeat every weekday, you'd use: + FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR To repeat some window daily + (equivalent to the DailyMaintenanceWindow): FREQ=DAILY For the + first weekend of every month: + FREQ=MONTHLY;BYSETPOS=1;BYDAY=SA,SU This specifies how + frequently the window starts. Eg, if you wanted to have a 9-5 + UTC-4 window every weekday, you'd use something like: start + time = 2019-01-01T09:00:00-0400 end time = + 2019-01-01T17:00:00-0400 recurrence = + FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR Windows can span multiple + days. Eg, to make the window encompass every weekend from + midnight Saturday till the last minute of Sunday UTC: start + time = 2019-01-05T00:00:00Z end time = 2019-01-07T23:59:00Z + recurrence = FREQ=WEEKLY;BYDAY=SA Note the start and end + time's specific dates are largely arbitrary except to specify + duration of the window and when it first starts. The FREQ + values of HOURLY, MINUTELY, and SECONDLY are not supported. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.RecurringTimeWindow) + ), +) +_sym_db.RegisterMessage(RecurringTimeWindow) DailyMaintenanceWindow = _reflection.GeneratedProtocolMessageType( "DailyMaintenanceWindow", @@ -8945,7 +11473,7 @@ start_time: Time within the maintenance window to start the maintenance operations. Time format should be in `RFC3339 - `__ format "HH:MM”, + `__ format "HH:MM", where HH : [00-23] and MM : [00-59] GMT. duration: [Output only] Duration of the time window, automatically @@ -8970,23 +11498,23 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster to update. This field has - been deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster to update. This + field has been deprecated and replaced by the name field. node_pool_id: - Deprecated. The name of the node pool to update. This field - has been deprecated and replaced by the name field. + Required. Deprecated. The name of the node pool to update. + This field has been deprecated and replaced by the name field. management: - NodeManagement configuration for the node pool. + Required. NodeManagement configuration for the node pool. name: The name (project, location, cluster, node pool id) of the node pool to set management properties. Specified in the @@ -9008,23 +11536,23 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster to update. This field has - been deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster to update. This + field has been deprecated and replaced by the name field. node_pool_id: - Deprecated. The name of the node pool to update. This field - has been deprecated and replaced by the name field. + Required. Deprecated. The name of the node pool to update. + This field has been deprecated and replaced by the name field. node_count: - The desired node count for the pool. + Required. The desired node count for the pool. name: The name (project, location, cluster, node pool id) of the node pool to set size. Specified in the format @@ -9048,21 +11576,21 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster to rollback. This field - has been deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster to rollback. + This field has been deprecated and replaced by the name field. node_pool_id: - Deprecated. The name of the node pool to rollback. This field - has been deprecated and replaced by the name field. + Required. Deprecated. The name of the node pool to rollback. + This field has been deprecated and replaced by the name field. name: The name (project, location, cluster, node pool id) of the node poll to rollback upgrade. Specified in the format @@ -9091,6 +11619,83 @@ ) _sym_db.RegisterMessage(ListNodePoolsResponse) +ClusterAutoscaling = _reflection.GeneratedProtocolMessageType( + "ClusterAutoscaling", + (_message.Message,), + dict( + DESCRIPTOR=_CLUSTERAUTOSCALING, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""ClusterAutoscaling contains global, per-cluster information required by + Cluster Autoscaler to automatically adjust the size of the cluster and + create/delete node pools based on the current needs. + + + Attributes: + enable_node_autoprovisioning: + Enables automatic node pool creation and deletion. + resource_limits: + Contains global constraints regarding minimum and maximum + amount of resources in the cluster. + autoprovisioning_node_pool_defaults: + AutoprovisioningNodePoolDefaults contains defaults for a node + pool created by NAP. + autoprovisioning_locations: + The list of Google Compute Engine `zones + `__ in which the NodePool's + nodes can be created by NAP. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.ClusterAutoscaling) + ), +) +_sym_db.RegisterMessage(ClusterAutoscaling) + +AutoprovisioningNodePoolDefaults = _reflection.GeneratedProtocolMessageType( + "AutoprovisioningNodePoolDefaults", + (_message.Message,), + dict( + DESCRIPTOR=_AUTOPROVISIONINGNODEPOOLDEFAULTS, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""AutoprovisioningNodePoolDefaults contains defaults for a node pool + created by NAP. + + + Attributes: + oauth_scopes: + Scopes that are used by NAP when creating node pools. If + oauth\_scopes are specified, service\_account should be empty. + service_account: + The Google Cloud Platform Service Account to be used by the + node VMs. If service\_account is specified, scopes should be + empty. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.AutoprovisioningNodePoolDefaults) + ), +) +_sym_db.RegisterMessage(AutoprovisioningNodePoolDefaults) + +ResourceLimit = _reflection.GeneratedProtocolMessageType( + "ResourceLimit", + (_message.Message,), + dict( + DESCRIPTOR=_RESOURCELIMIT, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""Contains information about amount of some resource in the cluster. For + memory, value should be in GB. + + + Attributes: + resource_type: + Resource name "cpu", "memory" or gpu-specific string. + minimum: + Minimum amount of the resource in the cluster. + maximum: + Maximum amount of the resource in the cluster. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.ResourceLimit) + ), +) +_sym_db.RegisterMessage(ResourceLimit) + NodePoolAutoscaling = _reflection.GeneratedProtocolMessageType( "NodePoolAutoscaling", (_message.Message,), @@ -9111,6 +11716,8 @@ Maximum number of nodes in the NodePool. Must be >= min\_node\_count. There has to enough quota to scale up the cluster. + autoprovisioned: + Can this node pool be deleted automatically. """, # @@protoc_insertion_point(class_scope:google.container.v1.NodePoolAutoscaling) ), @@ -9139,23 +11746,23 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number `__. This field has been deprecated and + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster. This field has been - deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster. This field has + been deprecated and replaced by the name field. resource_labels: - The labels to set for that cluster. + Required. The labels to set for that cluster. label_fingerprint: - The fingerprint of the previous set of labels for this - resource, used to detect conflicts. The fingerprint is + Required. The fingerprint of the previous set of labels for + this resource, used to detect conflicts. The fingerprint is initially generated by Kubernetes Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash when updating or @@ -9184,20 +11791,21 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster to update. This field has - been deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster to update. This + field has been deprecated and replaced by the name field. enabled: - Whether ABAC authorization will be enabled in the cluster. + Required. Whether ABAC authorization will be enabled in the + cluster. name: The name (project, location, cluster id) of the cluster to set legacy abac. Specified in the format @@ -9220,18 +11828,18 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number `__. This field has been deprecated and + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster. This field has been - deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster. This field has + been deprecated and replaced by the name field. name: The name (project, location, cluster id) of the cluster to start IP rotation. Specified in the format @@ -9256,18 +11864,18 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number `__. This field has been deprecated and + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster. This field has been - deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster. This field has + been deprecated and replaced by the name field. name: The name (project, location, cluster id) of the cluster to complete IP rotation. Specified in the format @@ -9292,7 +11900,7 @@ The number of the accelerator cards exposed to an instance. accelerator_type: The accelerator type resource name. List of supported - accelerators `here `__ + accelerators `here `__ """, # @@protoc_insertion_point(class_scope:google.container.v1.AcceleratorConfig) ), @@ -9310,20 +11918,20 @@ Attributes: project_id: - Deprecated. The Google Developers Console `project ID or - project number `__. This field has been deprecated and + Required. Deprecated. The Google Developers Console `project + ID or project number `__. This field has been deprecated and replaced by the name field. zone: - Deprecated. The name of the Google Compute Engine `zone - `__ in which the cluster + Required. Deprecated. The name of the Google Compute Engine + `zone `__ in which the cluster resides. This field has been deprecated and replaced by the name field. cluster_id: - Deprecated. The name of the cluster. This field has been - deprecated and replaced by the name field. + Required. Deprecated. The name of the cluster. This field has + been deprecated and replaced by the name field. network_policy: - Configuration options for the NetworkPolicy feature. + Required. Configuration options for the NetworkPolicy feature. name: The name (project, location, cluster id) of the cluster to set networking policy. Specified in the format @@ -9345,17 +11953,17 @@ Attributes: project_id: - The Google Developers Console `project ID or project number - `__. + Required. The Google Developers Console `project ID or project + number `__. zone: - The name of the Google Compute Engine `zone + Required. The name of the Google Compute Engine `zone `__ in which the cluster resides. cluster_id: - The name of the cluster to update. + Required. The name of the cluster to update. maintenance_policy: - The maintenance policy to be set for the cluster. An empty - field clears the existing maintenance policy. + Required. The maintenance policy to be set for the cluster. An + empty field clears the existing maintenance policy. name: The name (project, location, cluster id) of the cluster to set maintenance policy. Specified in the format @@ -9366,6 +11974,27 @@ ) _sym_db.RegisterMessage(SetMaintenancePolicyRequest) +StatusCondition = _reflection.GeneratedProtocolMessageType( + "StatusCondition", + (_message.Message,), + dict( + DESCRIPTOR=_STATUSCONDITION, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""StatusCondition describes why a cluster or a node pool has a certain + status (e.g., ERROR or DEGRADED). + + + Attributes: + code: + Machine-friendly representation of the condition + message: + Human-friendly representation of the condition + """, + # @@protoc_insertion_point(class_scope:google.container.v1.StatusCondition) + ), +) +_sym_db.RegisterMessage(StatusCondition) + NetworkConfig = _reflection.GeneratedProtocolMessageType( "NetworkConfig", (_message.Message,), @@ -9387,57 +12016,334 @@ `subnetwork `__ to which the cluster is connected. Example: projects/my-project/regions/us- central1/subnetworks/my-subnet + enable_intra_node_visibility: + Whether Intra-node visibility is enabled for this cluster. + This makes same node pod to pod traffic visible for VPC + network. """, # @@protoc_insertion_point(class_scope:google.container.v1.NetworkConfig) ), ) _sym_db.RegisterMessage(NetworkConfig) +IntraNodeVisibilityConfig = _reflection.GeneratedProtocolMessageType( + "IntraNodeVisibilityConfig", + (_message.Message,), + dict( + DESCRIPTOR=_INTRANODEVISIBILITYCONFIG, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""IntraNodeVisibilityConfig contains the desired config of the intra-node + visibility on this cluster. + + + Attributes: + enabled: + Enables intra node visibility for this cluster. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.IntraNodeVisibilityConfig) + ), +) +_sym_db.RegisterMessage(IntraNodeVisibilityConfig) + +MaxPodsConstraint = _reflection.GeneratedProtocolMessageType( + "MaxPodsConstraint", + (_message.Message,), + dict( + DESCRIPTOR=_MAXPODSCONSTRAINT, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""Constraints applied to pods. + + + Attributes: + max_pods_per_node: + Constraint enforced on the max num of pods per node. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.MaxPodsConstraint) + ), +) +_sym_db.RegisterMessage(MaxPodsConstraint) + +DatabaseEncryption = _reflection.GeneratedProtocolMessageType( + "DatabaseEncryption", + (_message.Message,), + dict( + DESCRIPTOR=_DATABASEENCRYPTION, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""Configuration of etcd encryption. + + + Attributes: + state: + Denotes the state of etcd encryption. + key_name: + Name of CloudKMS key to use for the encryption of secrets in + etcd. Ex. projects/my-project/locations/global/keyRings/my- + ring/cryptoKeys/my-key + """, + # @@protoc_insertion_point(class_scope:google.container.v1.DatabaseEncryption) + ), +) +_sym_db.RegisterMessage(DatabaseEncryption) + +ListUsableSubnetworksRequest = _reflection.GeneratedProtocolMessageType( + "ListUsableSubnetworksRequest", + (_message.Message,), + dict( + DESCRIPTOR=_LISTUSABLESUBNETWORKSREQUEST, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""ListUsableSubnetworksRequest requests the list of usable subnetworks + available to a user for creating clusters. + + + Attributes: + parent: + The parent project where subnetworks are usable. Specified in + the format 'projects/\*'. + filter: + Filtering currently only supports equality on the + networkProjectId and must be in the form: + "networkProjectId=[PROJECTID]", where ``networkProjectId`` is + the project which owns the listed subnetworks. This defaults + to the parent project ID. + page_size: + The max number of results per page that should be returned. If + the number of available results is larger than ``page_size``, + a ``next_page_token`` is returned which can be used to get the + next page of results in subsequent requests. Acceptable values + are 0 to 500, inclusive. (Default: 500) + page_token: + Specifies a page token to use. Set this to the nextPageToken + returned by previous list requests to get the next page of + results. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.ListUsableSubnetworksRequest) + ), +) +_sym_db.RegisterMessage(ListUsableSubnetworksRequest) + +ListUsableSubnetworksResponse = _reflection.GeneratedProtocolMessageType( + "ListUsableSubnetworksResponse", + (_message.Message,), + dict( + DESCRIPTOR=_LISTUSABLESUBNETWORKSRESPONSE, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""ListUsableSubnetworksResponse is the response of + ListUsableSubnetworksRequest. + + + Attributes: + subnetworks: + A list of usable subnetworks in the specified network project. + next_page_token: + This token allows you to get the next page of results for list + requests. If the number of results is larger than + ``page_size``, use the ``next_page_token`` as a value for the + query parameter ``page_token`` in the next request. The value + will become empty when there are no more pages. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.ListUsableSubnetworksResponse) + ), +) +_sym_db.RegisterMessage(ListUsableSubnetworksResponse) + +UsableSubnetworkSecondaryRange = _reflection.GeneratedProtocolMessageType( + "UsableSubnetworkSecondaryRange", + (_message.Message,), + dict( + DESCRIPTOR=_USABLESUBNETWORKSECONDARYRANGE, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""Secondary IP range of a usable subnetwork. + + + Attributes: + range_name: + The name associated with this subnetwork secondary range, used + when adding an alias IP range to a VM instance. + ip_cidr_range: + The range of IP addresses belonging to this subnetwork + secondary range. + status: + This field is to determine the status of the secondary range + programmably. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.UsableSubnetworkSecondaryRange) + ), +) +_sym_db.RegisterMessage(UsableSubnetworkSecondaryRange) + +UsableSubnetwork = _reflection.GeneratedProtocolMessageType( + "UsableSubnetwork", + (_message.Message,), + dict( + DESCRIPTOR=_USABLESUBNETWORK, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""Network Name. Example: projects/my-project/global/networks/my-network + + + Attributes: + subnetwork: + Subnetwork Name. Example: projects/my-project/regions/us- + central1/subnetworks/my-subnet + ip_cidr_range: + The range of internal addresses that are owned by this + subnetwork. + secondary_ip_ranges: + Secondary IP ranges. + status_message: + A human readable status message representing the reasons for + cases where the caller cannot use the secondary ranges under + the subnet. For example if the secondary\_ip\_ranges is empty + due to a permission issue, an insufficient permission message + will be given by status\_message. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.UsableSubnetwork) + ), +) +_sym_db.RegisterMessage(UsableSubnetwork) + +ResourceUsageExportConfig = _reflection.GeneratedProtocolMessageType( + "ResourceUsageExportConfig", + (_message.Message,), + dict( + BigQueryDestination=_reflection.GeneratedProtocolMessageType( + "BigQueryDestination", + (_message.Message,), + dict( + DESCRIPTOR=_RESOURCEUSAGEEXPORTCONFIG_BIGQUERYDESTINATION, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""Parameters for using BigQuery as the destination of resource usage + export. + + + Attributes: + dataset_id: + The ID of a BigQuery Dataset. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.ResourceUsageExportConfig.BigQueryDestination) + ), + ), + ConsumptionMeteringConfig=_reflection.GeneratedProtocolMessageType( + "ConsumptionMeteringConfig", + (_message.Message,), + dict( + DESCRIPTOR=_RESOURCEUSAGEEXPORTCONFIG_CONSUMPTIONMETERINGCONFIG, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""Parameters for controlling consumption metering. + + + Attributes: + enabled: + Whether to enable consumption metering for this cluster. If + enabled, a second BigQuery table will be created to hold + resource consumption records. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.ResourceUsageExportConfig.ConsumptionMeteringConfig) + ), + ), + DESCRIPTOR=_RESOURCEUSAGEEXPORTCONFIG, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""Configuration for exporting cluster resource usages. + + + Attributes: + bigquery_destination: + Configuration to use BigQuery as usage export destination. + enable_network_egress_metering: + Whether to enable network egress metering for this cluster. If + enabled, a daemonset will be created in the cluster to meter + network egress traffic. + consumption_metering_config: + Configuration to enable resource consumption metering. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.ResourceUsageExportConfig) + ), +) +_sym_db.RegisterMessage(ResourceUsageExportConfig) +_sym_db.RegisterMessage(ResourceUsageExportConfig.BigQueryDestination) +_sym_db.RegisterMessage(ResourceUsageExportConfig.ConsumptionMeteringConfig) + +VerticalPodAutoscaling = _reflection.GeneratedProtocolMessageType( + "VerticalPodAutoscaling", + (_message.Message,), + dict( + DESCRIPTOR=_VERTICALPODAUTOSCALING, + __module__="google.cloud.container_v1.proto.cluster_service_pb2", + __doc__="""VerticalPodAutoscaling contains global, per-cluster information required + by Vertical Pod Autoscaler to automatically adjust the resources of pods + controlled by it. + + + Attributes: + enabled: + Enables vertical pod autoscaling. + """, + # @@protoc_insertion_point(class_scope:google.container.v1.VerticalPodAutoscaling) + ), +) +_sym_db.RegisterMessage(VerticalPodAutoscaling) + DESCRIPTOR._options = None _NODECONFIG_METADATAENTRY._options = None _NODECONFIG_LABELSENTRY._options = None +_ADDONSCONFIG.fields_by_name["kubernetes_dashboard"]._options = None _IPALLOCATIONPOLICY.fields_by_name["cluster_ipv4_cidr"]._options = None _IPALLOCATIONPOLICY.fields_by_name["node_ipv4_cidr"]._options = None _IPALLOCATIONPOLICY.fields_by_name["services_ipv4_cidr"]._options = None _CLUSTER_RESOURCELABELSENTRY._options = None +_CLUSTER.fields_by_name["initial_node_count"]._options = None +_CLUSTER.fields_by_name["node_config"]._options = None _CLUSTER.fields_by_name["zone"]._options = None _CLUSTER.fields_by_name["current_node_version"]._options = None _CLUSTER.fields_by_name["instance_group_urls"]._options = None +_CLUSTER.fields_by_name["current_node_count"]._options = None _OPERATION.fields_by_name["zone"]._options = None _CREATECLUSTERREQUEST.fields_by_name["project_id"]._options = None _CREATECLUSTERREQUEST.fields_by_name["zone"]._options = None +_CREATECLUSTERREQUEST.fields_by_name["cluster"]._options = None _GETCLUSTERREQUEST.fields_by_name["project_id"]._options = None _GETCLUSTERREQUEST.fields_by_name["zone"]._options = None _GETCLUSTERREQUEST.fields_by_name["cluster_id"]._options = None _UPDATECLUSTERREQUEST.fields_by_name["project_id"]._options = None _UPDATECLUSTERREQUEST.fields_by_name["zone"]._options = None _UPDATECLUSTERREQUEST.fields_by_name["cluster_id"]._options = None +_UPDATECLUSTERREQUEST.fields_by_name["update"]._options = None _UPDATENODEPOOLREQUEST.fields_by_name["project_id"]._options = None _UPDATENODEPOOLREQUEST.fields_by_name["zone"]._options = None _UPDATENODEPOOLREQUEST.fields_by_name["cluster_id"]._options = None _UPDATENODEPOOLREQUEST.fields_by_name["node_pool_id"]._options = None +_UPDATENODEPOOLREQUEST.fields_by_name["node_version"]._options = None +_UPDATENODEPOOLREQUEST.fields_by_name["image_type"]._options = None _SETNODEPOOLAUTOSCALINGREQUEST.fields_by_name["project_id"]._options = None _SETNODEPOOLAUTOSCALINGREQUEST.fields_by_name["zone"]._options = None _SETNODEPOOLAUTOSCALINGREQUEST.fields_by_name["cluster_id"]._options = None _SETNODEPOOLAUTOSCALINGREQUEST.fields_by_name["node_pool_id"]._options = None +_SETNODEPOOLAUTOSCALINGREQUEST.fields_by_name["autoscaling"]._options = None _SETLOGGINGSERVICEREQUEST.fields_by_name["project_id"]._options = None +_SETLOGGINGSERVICEREQUEST.fields_by_name["zone"]._options = None _SETLOGGINGSERVICEREQUEST.fields_by_name["cluster_id"]._options = None +_SETLOGGINGSERVICEREQUEST.fields_by_name["logging_service"]._options = None _SETMONITORINGSERVICEREQUEST.fields_by_name["project_id"]._options = None _SETMONITORINGSERVICEREQUEST.fields_by_name["zone"]._options = None _SETMONITORINGSERVICEREQUEST.fields_by_name["cluster_id"]._options = None +_SETMONITORINGSERVICEREQUEST.fields_by_name["monitoring_service"]._options = None _SETADDONSCONFIGREQUEST.fields_by_name["project_id"]._options = None _SETADDONSCONFIGREQUEST.fields_by_name["zone"]._options = None _SETADDONSCONFIGREQUEST.fields_by_name["cluster_id"]._options = None +_SETADDONSCONFIGREQUEST.fields_by_name["addons_config"]._options = None _SETLOCATIONSREQUEST.fields_by_name["project_id"]._options = None _SETLOCATIONSREQUEST.fields_by_name["zone"]._options = None _SETLOCATIONSREQUEST.fields_by_name["cluster_id"]._options = None +_SETLOCATIONSREQUEST.fields_by_name["locations"]._options = None _UPDATEMASTERREQUEST.fields_by_name["project_id"]._options = None _UPDATEMASTERREQUEST.fields_by_name["zone"]._options = None _UPDATEMASTERREQUEST.fields_by_name["cluster_id"]._options = None +_UPDATEMASTERREQUEST.fields_by_name["master_version"]._options = None _SETMASTERAUTHREQUEST.fields_by_name["project_id"]._options = None _SETMASTERAUTHREQUEST.fields_by_name["zone"]._options = None _SETMASTERAUTHREQUEST.fields_by_name["cluster_id"]._options = None +_SETMASTERAUTHREQUEST.fields_by_name["action"]._options = None +_SETMASTERAUTHREQUEST.fields_by_name["update"]._options = None _DELETECLUSTERREQUEST.fields_by_name["project_id"]._options = None _DELETECLUSTERREQUEST.fields_by_name["zone"]._options = None _DELETECLUSTERREQUEST.fields_by_name["cluster_id"]._options = None @@ -9456,6 +12362,7 @@ _CREATENODEPOOLREQUEST.fields_by_name["project_id"]._options = None _CREATENODEPOOLREQUEST.fields_by_name["zone"]._options = None _CREATENODEPOOLREQUEST.fields_by_name["cluster_id"]._options = None +_CREATENODEPOOLREQUEST.fields_by_name["node_pool"]._options = None _DELETENODEPOOLREQUEST.fields_by_name["project_id"]._options = None _DELETENODEPOOLREQUEST.fields_by_name["zone"]._options = None _DELETENODEPOOLREQUEST.fields_by_name["cluster_id"]._options = None @@ -9467,14 +12374,17 @@ _GETNODEPOOLREQUEST.fields_by_name["zone"]._options = None _GETNODEPOOLREQUEST.fields_by_name["cluster_id"]._options = None _GETNODEPOOLREQUEST.fields_by_name["node_pool_id"]._options = None +_MAINTENANCEWINDOW_MAINTENANCEEXCLUSIONSENTRY._options = None _SETNODEPOOLMANAGEMENTREQUEST.fields_by_name["project_id"]._options = None _SETNODEPOOLMANAGEMENTREQUEST.fields_by_name["zone"]._options = None _SETNODEPOOLMANAGEMENTREQUEST.fields_by_name["cluster_id"]._options = None _SETNODEPOOLMANAGEMENTREQUEST.fields_by_name["node_pool_id"]._options = None +_SETNODEPOOLMANAGEMENTREQUEST.fields_by_name["management"]._options = None _SETNODEPOOLSIZEREQUEST.fields_by_name["project_id"]._options = None _SETNODEPOOLSIZEREQUEST.fields_by_name["zone"]._options = None _SETNODEPOOLSIZEREQUEST.fields_by_name["cluster_id"]._options = None _SETNODEPOOLSIZEREQUEST.fields_by_name["node_pool_id"]._options = None +_SETNODEPOOLSIZEREQUEST.fields_by_name["node_count"]._options = None _ROLLBACKNODEPOOLUPGRADEREQUEST.fields_by_name["project_id"]._options = None _ROLLBACKNODEPOOLUPGRADEREQUEST.fields_by_name["zone"]._options = None _ROLLBACKNODEPOOLUPGRADEREQUEST.fields_by_name["cluster_id"]._options = None @@ -9483,9 +12393,12 @@ _SETLABELSREQUEST.fields_by_name["project_id"]._options = None _SETLABELSREQUEST.fields_by_name["zone"]._options = None _SETLABELSREQUEST.fields_by_name["cluster_id"]._options = None +_SETLABELSREQUEST.fields_by_name["resource_labels"]._options = None +_SETLABELSREQUEST.fields_by_name["label_fingerprint"]._options = None _SETLEGACYABACREQUEST.fields_by_name["project_id"]._options = None _SETLEGACYABACREQUEST.fields_by_name["zone"]._options = None _SETLEGACYABACREQUEST.fields_by_name["cluster_id"]._options = None +_SETLEGACYABACREQUEST.fields_by_name["enabled"]._options = None _STARTIPROTATIONREQUEST.fields_by_name["project_id"]._options = None _STARTIPROTATIONREQUEST.fields_by_name["zone"]._options = None _STARTIPROTATIONREQUEST.fields_by_name["cluster_id"]._options = None @@ -9495,15 +12408,22 @@ _SETNETWORKPOLICYREQUEST.fields_by_name["project_id"]._options = None _SETNETWORKPOLICYREQUEST.fields_by_name["zone"]._options = None _SETNETWORKPOLICYREQUEST.fields_by_name["cluster_id"]._options = None +_SETNETWORKPOLICYREQUEST.fields_by_name["network_policy"]._options = None +_SETMAINTENANCEPOLICYREQUEST.fields_by_name["project_id"]._options = None +_SETMAINTENANCEPOLICYREQUEST.fields_by_name["zone"]._options = None +_SETMAINTENANCEPOLICYREQUEST.fields_by_name["cluster_id"]._options = None +_SETMAINTENANCEPOLICYREQUEST.fields_by_name["maintenance_policy"]._options = None _CLUSTERMANAGER = _descriptor.ServiceDescriptor( name="ClusterManager", full_name="google.container.v1.ClusterManager", file=DESCRIPTOR, index=0, - serialized_options=None, - serialized_start=11064, - serialized_end=18435, + serialized_options=_b( + "\312A\030container.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform" + ), + serialized_start=16211, + serialized_end=24692, methods=[ _descriptor.MethodDescriptor( name="ListClusters", @@ -9513,7 +12433,7 @@ input_type=_LISTCLUSTERSREQUEST, output_type=_LISTCLUSTERSRESPONSE, serialized_options=_b( - "\202\323\344\223\002a\022,/v1/{parent=projects/*/locations/*}/clustersZ1\022//v1/projects/{project_id}/zones/{zone}/clusters" + "\202\323\344\223\002a\022,/v1/{parent=projects/*/locations/*}/clustersZ1\022//v1/projects/{project_id}/zones/{zone}/clusters\332A\017project_id,zone" ), ), _descriptor.MethodDescriptor( @@ -9524,7 +12444,7 @@ input_type=_GETCLUSTERREQUEST, output_type=_CLUSTER, serialized_options=_b( - "\202\323\344\223\002n\022,/v1/{name=projects/*/locations/*/clusters/*}Z>\022\022**