google-api-client 0.19.8 → 0.20.0

data/generated/google/apis/container_v1beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/container-engine/
     module ContainerV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20180201'
+      REVISION = '20180319'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/container_v1beta1/classes.rb

@@ -130,22 +130,22 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The server-assigned `name` of the operation.
-        # This field is deprecated, use name instead.
+        # Deprecated. The server-assigned `name` of the operation.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `operationId`
         # @return [String]
         attr_accessor :operation_id
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://support.google.com/cloud/answer/6158840).
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the operation resides.
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -284,6 +284,13 @@ module Google
         # found in validMasterVersions returned by getServerConfig.  The version can
         # be upgraded over time; such upgrades are reflected in
         # currentMasterVersion and currentNodeVersion.
+        # 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
         # Corresponds to the JSON property `initialClusterVersion`
         # @return [String]
         attr_accessor :initial_cluster_version
@@ -365,6 +372,13 @@ module Google
         # @return [Google::Apis::ContainerV1beta1::MasterAuthorizedNetworksConfig]
         attr_accessor :master_authorized_networks_config
       
+        # The IP prefix in CIDR notation to use for the hosted master network.
+        # This prefix will be used for assigning private IP addresses to the
+        # master or set of masters, as well as the ILB VIP.
+        # Corresponds to the JSON property `masterIpv4CidrBlock`
+        # @return [String]
+        attr_accessor :master_ipv4_cidr_block
+      
         # The monitoring service the cluster should use to write metrics.
         # Currently available options:
         # * `monitoring.googleapis.com` - the Google Cloud Monitoring service.
@@ -386,7 +400,8 @@ module Google
         # The name of the Google Compute Engine
         # [network](/compute/docs/networks-and-firewalls#networks) to which the
         # cluster is connected. If left unspecified, the `default` network
-        # will be used.
+        # will be used. On output this shows the network ID instead of
+        # the name.
         # Corresponds to the JSON property `network`
         # @return [String]
         attr_accessor :network
@@ -421,6 +436,14 @@ module Google
         # @return [Google::Apis::ContainerV1beta1::PodSecurityPolicyConfig]
         attr_accessor :pod_security_policy_config
       
+        # If this is a private cluster setup. Private clusters are clusters that, by
+        # default have no external IP addresses on the nodes and where nodes and the
+        # master communicate over private IP addresses.
+        # Corresponds to the JSON property `privateCluster`
+        # @return [Boolean]
+        attr_accessor :private_cluster
+        alias_method :private_cluster?, :private_cluster
+      
         # The resource labels for the cluster to use to annotate any related GCE
         # resources.
         # Corresponds to the JSON property `resourceLabels`
@@ -454,7 +477,8 @@ module Google
       
         # The name of the Google Compute Engine
         # [subnetwork](/compute/docs/subnetworks) to which the
-        # cluster is connected.
+        # cluster is connected. On output this shows the subnetwork ID instead of
+        # the name.
         # Corresponds to the JSON property `subnetwork`
         # @return [String]
         attr_accessor :subnetwork
@@ -495,6 +519,7 @@ module Google
           @maintenance_policy = args[:maintenance_policy] if args.key?(:maintenance_policy)
           @master_auth = args[:master_auth] if args.key?(:master_auth)
           @master_authorized_networks_config = args[:master_authorized_networks_config] if args.key?(:master_authorized_networks_config)
+          @master_ipv4_cidr_block = args[:master_ipv4_cidr_block] if args.key?(:master_ipv4_cidr_block)
           @monitoring_service = args[:monitoring_service] if args.key?(:monitoring_service)
           @name = args[:name] if args.key?(:name)
           @network = args[:network] if args.key?(:network)
@@ -503,6 +528,7 @@ module Google
           @node_ipv4_cidr_size = args[:node_ipv4_cidr_size] if args.key?(:node_ipv4_cidr_size)
           @node_pools = args[:node_pools] if args.key?(:node_pools)
           @pod_security_policy_config = args[:pod_security_policy_config] if args.key?(:pod_security_policy_config)
+          @private_cluster = args[:private_cluster] if args.key?(:private_cluster)
           @resource_labels = args[:resource_labels] if args.key?(:resource_labels)
           @self_link = args[:self_link] if args.key?(:self_link)
           @services_ipv4_cidr = args[:services_ipv4_cidr] if args.key?(:services_ipv4_cidr)
@@ -550,8 +576,14 @@ module Google
         attr_accessor :desired_master_authorized_networks_config
       
         # The Kubernetes version to change the master to. The only valid value is the
-        # latest supported version. Use "-" to have the server automatically select
-        # the latest version.
+        # latest supported version.
+        # 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
         # Corresponds to the JSON property `desiredMasterVersion`
         # @return [String]
         attr_accessor :desired_master_version
@@ -579,8 +611,14 @@ module Google
         attr_accessor :desired_node_pool_id
       
         # The Kubernetes version to change the nodes to (typically an
-        # upgrade). Use `-` to upgrade to the latest version supported by
-        # the server.
+        # 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
         # Corresponds to the JSON property `desiredNodeVersion`
         # @return [String]
         attr_accessor :desired_node_version
@@ -613,8 +651,8 @@ module Google
       class CompleteIpRotationRequest
         include Google::Apis::Core::Hashable
       
-        # The name of the cluster.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the cluster.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
@@ -626,17 +664,17 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://developers.google.com/console/help/new/#projectnumber).
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -669,17 +707,17 @@ module Google
         # @return [String]
         attr_accessor :parent
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://support.google.com/cloud/answer/6158840).
-        # This field is deprecated, use parent instead.
+        # This field has been deprecated and replaced by the parent field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use parent instead.
+        # This field has been deprecated and replaced by the parent field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -701,8 +739,8 @@ module Google
       class CreateNodePoolRequest
         include Google::Apis::Core::Hashable
       
-        # The name of the cluster.
-        # This field is deprecated, use parent instead.
+        # Deprecated. The name of the cluster.
+        # This field has been deprecated and replaced by the parent field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
@@ -723,17 +761,17 @@ module Google
         # @return [String]
         attr_accessor :parent
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://developers.google.com/console/help/new/#projectnumber).
-        # This field is deprecated, use parent instead.
+        # This field has been deprecated and replaced by the parent field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use parent instead.
+        # This field has been deprecated and replaced by the parent field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -1336,6 +1374,7 @@ module Google
         # in length. These are reflected as part of a URL in the metadata server.
         # Additionally, to avoid ambiguity, keys must not conflict with any other
         # metadata keys for the project or be one of the reserved keys:
+        # "cluster-location"
         # "cluster-name"
         # "cluster-uid"
         # "configure-sh"
@@ -1742,8 +1781,8 @@ module Google
       class RollbackNodePoolUpgradeRequest
         include Google::Apis::Core::Hashable
       
-        # The name of the cluster to rollback.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the cluster to rollback.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
@@ -1755,23 +1794,23 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The name of the node pool to rollback.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the node pool to rollback.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `nodePoolId`
         # @return [String]
         attr_accessor :node_pool_id
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://support.google.com/cloud/answer/6158840).
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -1843,8 +1882,8 @@ module Google
         # @return [Google::Apis::ContainerV1beta1::AddonsConfig]
         attr_accessor :addons_config
       
-        # The name of the cluster to upgrade.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the cluster to upgrade.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
@@ -1855,17 +1894,17 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://support.google.com/cloud/answer/6158840).
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -1890,8 +1929,8 @@ module Google
       class SetLabelsRequest
         include Google::Apis::Core::Hashable
       
-        # The name of the cluster.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the cluster.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
@@ -1912,9 +1951,9 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://developers.google.com/console/help/new/#projectnumber).
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
@@ -1924,10 +1963,10 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :resource_labels
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -1952,8 +1991,8 @@ module Google
       class SetLegacyAbacRequest
         include Google::Apis::Core::Hashable
       
-        # The name of the cluster to update.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the cluster to update.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
@@ -1970,17 +2009,17 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://support.google.com/cloud/answer/6158840).
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -2003,8 +2042,8 @@ module Google
       class SetLocationsRequest
         include Google::Apis::Core::Hashable
       
-        # The name of the cluster to upgrade.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the cluster to upgrade.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
@@ -2025,17 +2064,17 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://support.google.com/cloud/answer/6158840).
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -2058,8 +2097,8 @@ module Google
       class SetLoggingServiceRequest
         include Google::Apis::Core::Hashable
       
-        # The name of the cluster to upgrade.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the cluster to upgrade.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
@@ -2078,16 +2117,17 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://support.google.com/cloud/answer/6158840).
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # The name of the Google Compute Engine
+        # 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.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -2163,8 +2203,8 @@ module Google
         # @return [String]
         attr_accessor :action
       
-        # The name of the cluster to upgrade.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the cluster to upgrade.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
@@ -2175,9 +2215,9 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://support.google.com/cloud/answer/6158840).
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
@@ -2189,10 +2229,10 @@ module Google
         # @return [Google::Apis::ContainerV1beta1::MasterAuth]
         attr_accessor :update
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -2216,8 +2256,8 @@ module Google
       class SetMonitoringServiceRequest
         include Google::Apis::Core::Hashable
       
-        # The name of the cluster to upgrade.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the cluster to upgrade.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
@@ -2236,17 +2276,17 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://support.google.com/cloud/answer/6158840).
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -2269,8 +2309,8 @@ module Google
       class SetNetworkPolicyRequest
         include Google::Apis::Core::Hashable
       
-        # The name of the cluster.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the cluster.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
@@ -2288,17 +2328,17 @@ module Google
         # @return [Google::Apis::ContainerV1beta1::NetworkPolicy]
         attr_accessor :network_policy
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://developers.google.com/console/help/new/#projectnumber).
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -2327,8 +2367,8 @@ module Google
         # @return [Google::Apis::ContainerV1beta1::NodePoolAutoscaling]
         attr_accessor :autoscaling
       
-        # The name of the cluster to upgrade.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the cluster to upgrade.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
@@ -2340,23 +2380,23 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The name of the node pool to upgrade.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the node pool to upgrade.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `nodePoolId`
         # @return [String]
         attr_accessor :node_pool_id
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://support.google.com/cloud/answer/6158840).
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -2381,8 +2421,8 @@ module Google
       class SetNodePoolManagementRequest
         include Google::Apis::Core::Hashable
       
-        # The name of the cluster to update.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the cluster to update.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
@@ -2400,23 +2440,23 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The name of the node pool to update.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the node pool to update.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `nodePoolId`
         # @return [String]
         attr_accessor :node_pool_id
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://support.google.com/cloud/answer/6158840).
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -2441,8 +2481,8 @@ module Google
       class SetNodePoolSizeRequest
         include Google::Apis::Core::Hashable
       
-        # The name of the cluster to update.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the cluster to update.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
@@ -2459,22 +2499,23 @@ module Google
         # @return [Fixnum]
         attr_accessor :node_count
       
-        # The name of the node pool to update.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the node pool to update.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `nodePoolId`
         # @return [String]
         attr_accessor :node_pool_id
       
-        # The Google Developers Console [project ID or project
+        # 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.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -2499,8 +2540,8 @@ module Google
       class StartIpRotationRequest
         include Google::Apis::Core::Hashable
       
-        # The name of the cluster.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the cluster.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
@@ -2511,17 +2552,17 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://developers.google.com/console/help/new/#projectnumber).
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -2543,8 +2584,8 @@ module Google
       class UpdateClusterRequest
         include Google::Apis::Core::Hashable
       
-        # The name of the cluster to upgrade.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the cluster to upgrade.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
@@ -2555,9 +2596,9 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://support.google.com/cloud/answer/6158840).
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
@@ -2569,10 +2610,10 @@ module Google
         # @return [Google::Apis::ContainerV1beta1::ClusterUpdate]
         attr_accessor :update
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -2595,15 +2636,20 @@ module Google
       class UpdateMasterRequest
         include Google::Apis::Core::Hashable
       
-        # The name of the cluster to upgrade.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the cluster to upgrade.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
       
-        # The Kubernetes version to change the master to. The only valid value is the
-        # latest supported version. Use "-" to have the server automatically select
-        # the latest 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
         # Corresponds to the JSON property `masterVersion`
         # @return [String]
         attr_accessor :master_version
@@ -2614,16 +2660,17 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The Google Developers Console [project ID or project
+        # 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.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -2646,8 +2693,8 @@ module Google
       class UpdateNodePoolRequest
         include Google::Apis::Core::Hashable
       
-        # The name of the cluster to upgrade.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the cluster to upgrade.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `clusterId`
         # @return [String]
         attr_accessor :cluster_id
@@ -2663,30 +2710,36 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The name of the node pool to upgrade.
-        # This field is deprecated, use name instead.
+        # Deprecated. The name of the node pool to upgrade.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `nodePoolId`
         # @return [String]
         attr_accessor :node_pool_id
       
         # The Kubernetes version to change the nodes to (typically an
-        # upgrade). Use `-` to upgrade to the latest version supported by
-        # the server.
+        # 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
         # Corresponds to the JSON property `nodeVersion`
         # @return [String]
         attr_accessor :node_version
       
-        # The Google Developers Console [project ID or project
+        # Deprecated. The Google Developers Console [project ID or project
         # number](https://support.google.com/cloud/answer/6158840).
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # The name of the Google Compute Engine
+        # Deprecated. The name of the Google Compute Engine
         # [zone](/compute/docs/zones#available) in which the cluster
         # resides.
-        # This field is deprecated, use name instead.
+        # This field has been deprecated and replaced by the name field.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -2712,8 +2765,8 @@ module Google
       class WorkloadMetadataConfig
         include Google::Apis::Core::Hashable
       
-        # NodeMetadata is the configuration for if and how to expose the node
-        # metadata to the workload running on the node.
+        # NodeMetadata is the configuration for how to expose the node metadata to
+        # the workload running on the node.
         # Corresponds to the JSON property `nodeMetadata`
         # @return [String]
         attr_accessor :node_metadata