lib/google/cloud/container/v1beta1/cluster_manager_client.rb in google-cloud-container-0.7.0 vs lib/google/cloud/container/v1beta1/cluster_manager_client.rb in google-cloud-container-0.8.0

- old
+ new

@@ -439,15 +439,15 @@ # Lists all clusters owned by a project in either the specified zone or all # zones. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides, or "-" for all zones. # This field has been deprecated and replaced by the parent field. # @param parent [String] # The parent (project and location) where the clusters will be listed. @@ -489,20 +489,20 @@ end # Gets the details for a specific cluster. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # 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. # @param name [String] # The name (project, location, cluster) of the cluster to retrieve. # Specified in the format 'projects/*/locations/*/clusters/*'. # @param options [Google::Gax::CallOptions] @@ -550,28 +550,28 @@ # # By default, the cluster is created in the project's # [default network](https://cloud.google.com/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. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the parent field. # @param cluster [Google::Container::V1beta1::Cluster | Hash] - # A [cluster + # Required. A [cluster # resource](/container-engine/reference/rest/v1beta1/projects.zones.clusters) # A hash of the same form as `Google::Container::V1beta1::Cluster` # can also be provided. # @param parent [String] # The parent (project and location) where the cluster will be created. @@ -617,23 +617,23 @@ end # Updates the settings for a specific cluster. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # 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. # @param update [Google::Container::V1beta1::ClusterUpdate | Hash] - # A description of the update. + # Required. A description of the update. # A hash of the same form as `Google::Container::V1beta1::ClusterUpdate` # can also be provided. # @param name [String] # The name (project, location, cluster) of the cluster to update. # Specified in the format 'projects/*/locations/*/clusters/*'. @@ -683,26 +683,26 @@ end # Updates the version and/or image type of a specific node pool. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # 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. # @param node_pool_id [String] - # 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. # @param node_version [String] - # 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 # version aliases, which have the following behavior: # @@ -710,11 +710,15 @@ # * "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 # @param image_type [String] + # Required. The desired image type for the node pool. + # @param workload_metadata_config [Google::Container::V1beta1::WorkloadMetadataConfig | Hash] # The desired image type for the node pool. + # A hash of the same form as `Google::Container::V1beta1::WorkloadMetadataConfig` + # can also be provided. # @param name [String] # The name (project, location, cluster, node pool) of the node pool to # update. Specified in the format # 'projects/*/locations/*/clusters/*/nodePools/*'. # @param options [Google::Gax::CallOptions] @@ -754,45 +758,47 @@ zone, cluster_id, node_pool_id, node_version, image_type, + workload_metadata_config: nil, name: nil, options: nil, &block req = { project_id: project_id, zone: zone, cluster_id: cluster_id, node_pool_id: node_pool_id, node_version: node_version, image_type: image_type, + workload_metadata_config: workload_metadata_config, name: name }.delete_if { |_, v| v.nil? } req = Google::Gax::to_proto(req, Google::Container::V1beta1::UpdateNodePoolRequest) @update_node_pool.call(req, options, &block) end # Sets the autoscaling settings of a specific node pool. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # 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. # @param node_pool_id [String] - # 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. # @param autoscaling [Google::Container::V1beta1::NodePoolAutoscaling | Hash] - # Autoscaling configuration for the node pool. + # Required. Autoscaling configuration for the node pool. # A hash of the same form as `Google::Container::V1beta1::NodePoolAutoscaling` # can also be provided. # @param name [String] # The name (project, location, cluster, node pool) of the node pool to set # autoscaler settings. Specified in the format @@ -848,23 +854,23 @@ end # Sets the logging service for a specific cluster. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # 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. # @param logging_service [String] - # 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 # @param name [String] @@ -916,23 +922,23 @@ end # Sets the monitoring service for a specific cluster. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # 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. # @param monitoring_service [String] - # 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" - the Google Cloud Monitoring service # * "none" - no metrics will be exported from the cluster # @param name [String] @@ -984,23 +990,23 @@ end # Sets the addons for a specific cluster. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # 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. # @param addons_config [Google::Container::V1beta1::AddonsConfig | Hash] - # 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. # A hash of the same form as `Google::Container::V1beta1::AddonsConfig` # can also be provided. # @param name [String] # The name (project, location, cluster) of the cluster to set addons. @@ -1051,23 +1057,23 @@ end # Sets the locations for a specific cluster. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # 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. # @param locations [Array<String>] - # The desired list of Google Compute Engine + # Required. The desired list of Google Compute Engine # [zones](https://cloud.google.com/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. # @@ -1121,23 +1127,23 @@ end # Updates the master for a specific cluster. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # 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. # @param master_version [String] - # 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: # # * "latest": picks the highest valid Kubernetes version @@ -1191,31 +1197,30 @@ }.delete_if { |_, v| v.nil? } req = Google::Gax::to_proto(req, Google::Container::V1beta1::UpdateMasterRequest) @update_master.call(req, options, &block) end - # 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. - # Modify basic_auth.csv and reset the K8S API server. + # Sets master auth materials. Currently supports changing the admin password + # or a specific cluster, either via password generation or explicitly setting + # the password. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # 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. # @param action [Google::Container::V1beta1::SetMasterAuthRequest::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. # @param update [Google::Container::V1beta1::MasterAuth | Hash] - # A description of the update. + # Required. A description of the update. # A hash of the same form as `Google::Container::V1beta1::MasterAuth` # can also be provided. # @param name [String] # The name (project, location, cluster) of the cluster to set auth. # Specified in the format 'projects/*/locations/*/clusters/*'. @@ -1273,25 +1278,25 @@ # nodes. # # 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. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # 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. # @param name [String] # The name (project, location, cluster) of the cluster to delete. # Specified in the format 'projects/*/locations/*/clusters/*'. # @param options [Google::Gax::CallOptions] @@ -1332,18 +1337,18 @@ }.delete_if { |_, v| v.nil? } req = Google::Gax::to_proto(req, Google::Container::V1beta1::DeleteClusterRequest) @delete_cluster.call(req, options, &block) end - # Lists all operations in a project in a specific zone or all zones. + # Lists all operations in a project in the specified zone or all zones. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) to return operations for, or `-` for # all zones. This field has been deprecated and replaced by the parent field. # @param parent [String] # The parent (project and location) where the operations will be listed. # Specified in the format 'projects/*/locations/*'. @@ -1384,20 +1389,20 @@ end # Gets the specified operation. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param operation_id [String] - # 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. # @param name [String] # The name (project, location, operation id) of the operation to get. # Specified in the format 'projects/*/locations/*/operations/*'. # @param options [Google::Gax::CallOptions] @@ -1441,19 +1446,19 @@ end # Cancels the specified operation. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the operation resides. # This field has been deprecated and replaced by the name field. # @param operation_id [String] - # 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. # @param name [String] # The name (project, location, operation id) of the operation to cancel. # Specified in the format 'projects/*/locations/*/operations/*'. # @param options [Google::Gax::CallOptions] @@ -1494,23 +1499,23 @@ req = Google::Gax::to_proto(req, Google::Container::V1beta1::CancelOperationRequest) @cancel_operation.call(req, options, &block) nil end - # Returns configuration info about the Kubernetes Engine service. + # Returns configuration info about the Google Kubernetes Engine service. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) to return operations for. # This field has been deprecated and replaced by the name field. # @param name [String] - # 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/*'. # @param options [Google::Gax::CallOptions] # Overrides the default settings for this call, e.g, timeout, # retries, etc. # @yield [result, operation] Access the result along with the RPC operation # @yieldparam result [Google::Container::V1beta1::ServerConfig] @@ -1545,20 +1550,20 @@ end # Lists the node pools for a cluster. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the parent field. # @param cluster_id [String] - # Deprecated. The name of the cluster. + # Required. Deprecated. The name of the cluster. # This field has been deprecated and replaced by the parent field. # @param parent [String] # The parent (project, location, cluster id) where the node pools will be # listed. Specified in the format 'projects/*/locations/*/clusters/*'. # @param options [Google::Gax::CallOptions] @@ -1599,26 +1604,26 @@ }.delete_if { |_, v| v.nil? } req = Google::Gax::to_proto(req, Google::Container::V1beta1::ListNodePoolsRequest) @list_node_pools.call(req, options, &block) end - # Retrieves the node pool requested. + # Retrieves the requested node pool. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # Deprecated. The name of the cluster. + # Required. Deprecated. The name of the cluster. # This field has been deprecated and replaced by the name field. # @param node_pool_id [String] - # 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. # @param name [String] # The name (project, location, cluster, node pool id) of the node pool to # get. Specified in the format # 'projects/*/locations/*/clusters/*/nodePools/*'. @@ -1668,23 +1673,23 @@ end # Creates a node pool for a cluster. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the parent field. # @param cluster_id [String] - # Deprecated. The name of the cluster. + # Required. Deprecated. The name of the cluster. # This field has been deprecated and replaced by the parent field. # @param node_pool [Google::Container::V1beta1::NodePool | Hash] - # The node pool to create. + # Required. The node pool to create. # A hash of the same form as `Google::Container::V1beta1::NodePool` # can also be provided. # @param parent [String] # The parent (project, location, cluster id) where the node pool will be # created. Specified in the format @@ -1735,23 +1740,23 @@ end # Deletes a node pool from a cluster. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # Deprecated. The name of the cluster. + # Required. Deprecated. The name of the cluster. # This field has been deprecated and replaced by the name field. # @param node_pool_id [String] - # 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. # @param name [String] # The name (project, location, cluster, node pool id) of the node pool to # delete. Specified in the format # 'projects/*/locations/*/clusters/*/nodePools/*'. @@ -1798,27 +1803,27 @@ }.delete_if { |_, v| v.nil? } req = Google::Gax::to_proto(req, Google::Container::V1beta1::DeleteNodePoolRequest) @delete_node_pool.call(req, options, &block) end - # 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. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # 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. # @param node_pool_id [String] - # 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. # @param name [String] # The name (project, location, cluster, node pool id) of the node poll to # rollback upgrade. # Specified in the format 'projects/*/locations/*/clusters/*/nodePools/*'. @@ -1868,26 +1873,26 @@ end # Sets the NodeManagement options for a node pool. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # 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. # @param node_pool_id [String] - # 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. # @param management [Google::Container::V1beta1::NodeManagement | Hash] - # NodeManagement configuration for the node pool. + # Required. NodeManagement configuration for the node pool. # A hash of the same form as `Google::Container::V1beta1::NodeManagement` # can also be provided. # @param name [String] # The name (project, location, cluster, node pool id) of the node pool to set # management properties. Specified in the format @@ -1943,25 +1948,25 @@ end # Sets labels on a cluster. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # Deprecated. The name of the cluster. + # Required. Deprecated. The name of the cluster. # This field has been deprecated and replaced by the name field. # @param resource_labels [Hash{String => String}] - # The labels to set for that cluster. + # Required. The labels to set for that cluster. # @param label_fingerprint [String] - # 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 <code>get()</code> request to the # resource to get the latest fingerprint. @@ -2019,23 +2024,23 @@ end # Enables or disables the ABAC authorization mechanism on a cluster. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # 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. # @param enabled [true, false] - # Whether ABAC authorization will be enabled in the cluster. + # Required. Whether ABAC authorization will be enabled in the cluster. # @param name [String] # The name (project, location, cluster id) of the cluster to set legacy abac. # Specified in the format 'projects/*/locations/*/clusters/*'. # @param options [Google::Gax::CallOptions] # Overrides the default settings for this call, e.g, timeout, @@ -2080,23 +2085,23 @@ }.delete_if { |_, v| v.nil? } req = Google::Gax::to_proto(req, Google::Container::V1beta1::SetLegacyAbacRequest) @set_legacy_abac.call(req, options, &block) end - # Start master IP rotation. + # Starts master IP rotation. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # Deprecated. The name of the cluster. + # Required. Deprecated. The name of the cluster. # This field has been deprecated and replaced by the name field. # @param name [String] # The name (project, location, cluster id) of the cluster to start IP # rotation. Specified in the format 'projects/*/locations/*/clusters/*'. # @param rotate_credentials [true, false] @@ -2144,20 +2149,20 @@ end # Completes master IP rotation. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # Deprecated. The name of the cluster. + # Required. Deprecated. The name of the cluster. # This field has been deprecated and replaced by the name field. # @param name [String] # The name (project, location, cluster id) of the cluster to complete IP # rotation. Specified in the format 'projects/*/locations/*/clusters/*'. # @param options [Google::Gax::CallOptions] @@ -2201,26 +2206,26 @@ end # Sets the size for a specific node pool. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # 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. # @param node_pool_id [String] - # 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. # @param node_count [Integer] - # The desired node count for the pool. + # Required. The desired node count for the pool. # @param name [String] # The name (project, location, cluster, node pool id) of the node pool to set # size. # Specified in the format 'projects/*/locations/*/clusters/*/nodePools/*'. # @param options [Google::Gax::CallOptions] @@ -2271,26 +2276,26 @@ }.delete_if { |_, v| v.nil? } req = Google::Gax::to_proto(req, Google::Container::V1beta1::SetNodePoolSizeRequest) @set_node_pool_size.call(req, options, &block) end - # Enables/Disables Network Policy for a cluster. + # Enables or disables Network Policy for a cluster. # # @param project_id [String] - # 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. # @param zone [String] - # Deprecated. The name of the Google Compute Engine + # Required. Deprecated. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # This field has been deprecated and replaced by the name field. # @param cluster_id [String] - # Deprecated. The name of the cluster. + # Required. Deprecated. The name of the cluster. # This field has been deprecated and replaced by the name field. # @param network_policy [Google::Container::V1beta1::NetworkPolicy | Hash] - # Configuration options for the NetworkPolicy feature. + # Required. Configuration options for the NetworkPolicy feature. # A hash of the same form as `Google::Container::V1beta1::NetworkPolicy` # can also be provided. # @param name [String] # The name (project, location, cluster id) of the cluster to set networking # policy. Specified in the format 'projects/*/locations/*/clusters/*'. @@ -2340,20 +2345,20 @@ end # Sets the maintenance policy for a cluster. # # @param project_id [String] - # 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). # @param zone [String] - # The name of the Google Compute Engine + # Required. The name of the Google Compute Engine # [zone](https://cloud.google.com/compute/docs/zones#available) in which the cluster # resides. # @param cluster_id [String] - # The name of the cluster to update. + # Required. The name of the cluster to update. # @param maintenance_policy [Google::Container::V1beta1::MaintenancePolicy | Hash] - # 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. # A hash of the same form as `Google::Container::V1beta1::MaintenancePolicy` # can also be provided. # @param name [String] # The name (project, location, cluster id) of the cluster to set maintenance @@ -2402,14 +2407,14 @@ }.delete_if { |_, v| v.nil? } req = Google::Gax::to_proto(req, Google::Container::V1beta1::SetMaintenancePolicyRequest) @set_maintenance_policy.call(req, options, &block) end - # Lists subnetworks that are usable for creating clusters in a project. + # Lists subnetworks that can be used for creating clusters in a project. # # @param parent [String] - # The parent project where subnetworks are usable. + # Required. The parent project where subnetworks are usable. # Specified in the format 'projects/*'. # @param filter [String] # 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 @@ -2466,13 +2471,13 @@ }.delete_if { |_, v| v.nil? } req = Google::Gax::to_proto(req, Google::Container::V1beta1::ListUsableSubnetworksRequest) @list_usable_subnetworks.call(req, options, &block) end - # Used to fetch locations that offer GKE. + # Fetches locations that offer Google Kubernetes Engine. # # @param parent [String] - # Contains the name of the resource requested. + # Required. Contains the name of the resource requested. # Specified in the format 'projects/*'. # @param options [Google::Gax::CallOptions] # Overrides the default settings for this call, e.g, timeout, # retries, etc. # @yield [result, operation] Access the result along with the RPC operation