Regen all docs. (#700)
* Stop recursing if discovery == {}
* Generate docs with 'make docs'.
diff --git a/docs/dyn/container_v1.projects.zones.clusters.nodePools.html b/docs/dyn/container_v1.projects.zones.clusters.nodePools.html
index b870b56..370160e 100644
--- a/docs/dyn/container_v1.projects.zones.clusters.nodePools.html
+++ b/docs/dyn/container_v1.projects.zones.clusters.nodePools.html
@@ -72,42 +72,152 @@
</style>
-<h1><a href="container_v1.html">Google Container Engine API</a> . <a href="container_v1.projects.html">projects</a> . <a href="container_v1.projects.zones.html">zones</a> . <a href="container_v1.projects.zones.clusters.html">clusters</a> . <a href="container_v1.projects.zones.clusters.nodePools.html">nodePools</a></h1>
+<h1><a href="container_v1.html">Kubernetes Engine API</a> . <a href="container_v1.projects.html">projects</a> . <a href="container_v1.projects.zones.html">zones</a> . <a href="container_v1.projects.zones.clusters.html">clusters</a> . <a href="container_v1.projects.zones.clusters.nodePools.html">nodePools</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
+ <code><a href="#autoscaling">autoscaling(projectId, zone, clusterId, nodePoolId, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Sets the autoscaling settings for the specified node pool.</p>
+<p class="toc_element">
<code><a href="#create">create(projectId, zone, clusterId, body, x__xgafv=None)</a></code></p>
<p class="firstline">Creates a node pool for a cluster.</p>
<p class="toc_element">
- <code><a href="#delete">delete(projectId, zone, clusterId, nodePoolId, x__xgafv=None)</a></code></p>
+ <code><a href="#delete">delete(projectId, zone, clusterId, nodePoolId, name=None, x__xgafv=None)</a></code></p>
<p class="firstline">Deletes a node pool from a cluster.</p>
<p class="toc_element">
- <code><a href="#get">get(projectId, zone, clusterId, nodePoolId, x__xgafv=None)</a></code></p>
-<p class="firstline">Retrieves the node pool requested.</p>
+ <code><a href="#get">get(projectId, zone, clusterId, nodePoolId, name=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Retrieves the requested node pool.</p>
<p class="toc_element">
- <code><a href="#list">list(projectId, zone, clusterId, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(projectId, zone, clusterId, parent=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists the node pools for a cluster.</p>
<p class="toc_element">
<code><a href="#rollback">rollback(projectId, zone, clusterId, nodePoolId, body, x__xgafv=None)</a></code></p>
-<p class="firstline">Roll back the previously Aborted or Failed NodePool upgrade.</p>
+<p class="firstline">Rolls back a previously Aborted or Failed NodePool upgrade.</p>
<p class="toc_element">
<code><a href="#setManagement">setManagement(projectId, zone, clusterId, nodePoolId, body, x__xgafv=None)</a></code></p>
<p class="firstline">Sets the NodeManagement options for a node pool.</p>
+<p class="toc_element">
+ <code><a href="#setSize">setSize(projectId, zone, clusterId, nodePoolId, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Sets the size for a specific node pool.</p>
+<p class="toc_element">
+ <code><a href="#update">update(projectId, zone, clusterId, nodePoolId, body, x__xgafv=None)</a></code></p>
+<p class="firstline">Updates the version and/or image type for the specified node pool.</p>
<h3>Method Details</h3>
<div class="method">
+ <code class="details" id="autoscaling">autoscaling(projectId, zone, clusterId, nodePoolId, body, x__xgafv=None)</code>
+ <pre>Sets the autoscaling settings for the specified node pool.
+
+Args:
+ projectId: string, 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. (required)
+ zone: string, 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. (required)
+ clusterId: string, Deprecated. The name of the cluster to upgrade.
+This field has been deprecated and replaced by the name field. (required)
+ nodePoolId: string, Deprecated. The name of the node pool to upgrade.
+This field has been deprecated and replaced by the name field. (required)
+ body: object, The request body. (required)
+ The object takes the form of:
+
+{ # SetNodePoolAutoscalingRequest sets the autoscaler settings of a node pool.
+ "name": "A String", # The name (project, location, cluster, node pool) of the node pool to set
+ # autoscaler settings. Specified in the format
+ # 'projects/*/locations/*/clusters/*/nodePools/*'.
+ "zone": "A String", # 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.
+ "projectId": "A String", # 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.
+ "autoscaling": { # NodePoolAutoscaling contains information required by cluster autoscaler to # Autoscaling configuration for the node pool.
+ # adjust the size of the node pool to the current cluster usage.
+ "minNodeCount": 42, # Minimum number of nodes in the NodePool. Must be >= 1 and <=
+ # max_node_count.
+ "enabled": True or False, # Is autoscaling enabled for this node pool.
+ "maxNodeCount": 42, # Maximum number of nodes in the NodePool. Must be >= min_node_count. There
+ # has to enough quota to scale up the cluster.
+ },
+ "clusterId": "A String", # Deprecated. The name of the cluster to upgrade.
+ # This field has been deprecated and replaced by the name field.
+ "nodePoolId": "A String", # Deprecated. The name of the node pool to upgrade.
+ # This field has been deprecated and replaced by the name field.
+ }
+
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # This operation resource represents operations that may have happened or are
+ # happening on the cluster. All fields are output only.
+ "status": "A String", # The current status of the operation.
+ "selfLink": "A String", # Server-defined URL for the resource.
+ "name": "A String", # The server-assigned ID for the operation.
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](/compute/docs/zones#available) in which the operation
+ # is taking place.
+ # This field is deprecated, use location instead.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "detail": "A String", # Detailed operation progress, if available.
+ "operationType": "A String", # The operation type.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "location": "A String", # [Output only] The name of the Google Compute Engine
+ # [zone](/compute/docs/regions-zones/regions-zones#available) or
+ # [region](/compute/docs/regions-zones/regions-zones#available) in which
+ # the cluster resides.
+ "nodepoolConditions": [ # Which conditions caused the current node pool state.
+ { # StatusCondition describes why a cluster or a node pool has a certain status
+ # (e.g., ERROR or DEGRADED).
+ "message": "A String", # Human-friendly representation of the condition
+ "code": "A String", # Machine-friendly representation of the condition
+ },
+ ],
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "statusMessage": "A String", # If an error has occurred, a textual description of the error.
+ "clusterConditions": [ # Which conditions caused the current cluster state.
+ { # StatusCondition describes why a cluster or a node pool has a certain status
+ # (e.g., ERROR or DEGRADED).
+ "message": "A String", # Human-friendly representation of the condition
+ "code": "A String", # Machine-friendly representation of the condition
+ },
+ ],
+ }</pre>
+</div>
+
+<div class="method">
<code class="details" id="create">create(projectId, zone, clusterId, body, x__xgafv=None)</code>
<pre>Creates a node pool for a cluster.
Args:
- projectId: string, The Google Developers Console [project ID or project
-number](https://developers.google.com/console/help/new/#projectnumber). (required)
- zone: string, The name of the Google Compute Engine
+ projectId: string, 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. (required)
+ zone: string, Deprecated. The name of the Google Compute Engine
[zone](/compute/docs/zones#available) in which the cluster
-resides. (required)
- clusterId: string, The name of the cluster. (required)
+resides.
+This field has been deprecated and replaced by the parent field. (required)
+ clusterId: string, Deprecated. The name of the cluster.
+This field has been deprecated and replaced by the parent field. (required)
body: object, The request body. (required)
The object takes the form of:
{ # CreateNodePoolRequest creates a node pool for a cluster.
+ "parent": "A String", # The parent (project, location, cluster id) where the node pool will be
+ # created. Specified in the format
+ # 'projects/*/locations/*/clusters/*'.
+ "projectId": "A String", # 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.
+ "clusterId": "A String", # Deprecated. The name of the cluster.
+ # This field has been deprecated and replaced by the parent field.
"nodePool": { # NodePool contains the name and configuration for a cluster's node pool. # The node pool to create.
# Node pools are a set of nodes (i.e. VM's), with a common configuration and
# specification, under the control of the cluster master. They may have a set
@@ -115,7 +225,33 @@
# during pod scheduling. They may also be resized up or down, to accommodate
# the workload.
"status": "A String", # [Output only] The status of the nodes in this pool instance.
- "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+ "statusMessage": "A String", # [Output only] Additional information about the current status of this
+ # node pool instance, if available.
+ "name": "A String", # The name of the node pool.
+ "instanceGroupUrls": [ # [Output only] The resource URLs of the [managed instance
+ # groups](/compute/docs/instance-groups/creating-groups-of-managed-instances)
+ # associated with this node pool.
+ "A String",
+ ],
+ "autoscaling": { # NodePoolAutoscaling contains information required by cluster autoscaler to # Autoscaler configuration for this NodePool. Autoscaler is enabled
+ # only if a valid configuration is present.
+ # adjust the size of the node pool to the current cluster usage.
+ "minNodeCount": 42, # Minimum number of nodes in the NodePool. Must be >= 1 and <=
+ # max_node_count.
+ "enabled": True or False, # Is autoscaling enabled for this node pool.
+ "maxNodeCount": 42, # Maximum number of nodes in the NodePool. Must be >= min_node_count. There
+ # has to enough quota to scale up the cluster.
+ },
+ "maxPodsConstraint": { # Constraints applied to pods. # The constraint on the maximum number of pods that can be run
+ # simultaneously on a node in the node pool.
+ "maxPodsPerNode": "A String", # Constraint enforced on the max num of pods per node.
+ },
+ "version": "A String", # The version of the Kubernetes of this node.
+ "initialNodeCount": 42, # The initial node count for the pool. You must ensure that your
+ # Compute Engine <a href="/compute/docs/resource-quotas">resource quota</a>
+ # is sufficient for this number of instances. You must also have available
+ # firewall and routes quota.
+ "podIpv4CidrSize": 42, # [Output only] The pod CIDR block size per node in this node pool.
"management": { # NodeManagement defines the set of node management services turned on for the # NodeManagement configuration for this NodePool.
# node pool.
"autoRepair": True or False, # A flag that specifies whether the node auto-repair is enabled for the node
@@ -134,27 +270,21 @@
# pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
# up to date with the latest release version of Kubernetes.
},
- "name": "A String", # The name of the node pool.
- "instanceGroupUrls": [ # [Output only] The resource URLs of [instance
- # groups](/compute/docs/instance-groups/) associated with this
- # node pool.
- "A String",
- ],
- "autoscaling": { # NodePoolAutoscaling contains information required by cluster autoscaler to # Autoscaler configuration for this NodePool. Autoscaler is enabled
- # only if a valid configuration is present.
- # adjust the size of the node pool to the current cluster usage.
- "minNodeCount": 42, # Minimum number of nodes in the NodePool. Must be >= 1 and <=
- # max_node_count.
- "enabled": True or False, # Is autoscaling enabled for this node pool.
- "maxNodeCount": 42, # Maximum number of nodes in the NodePool. Must be >= min_node_count. There
- # has to enough quota to scale up the cluster.
- },
- "version": "A String", # [Output only] The version of the Kubernetes of this node.
- "initialNodeCount": 42, # The initial node count for the pool. You must ensure that your
- # Compute Engine <a href="/compute/docs/resource-quotas">resource quota</a>
- # is sufficient for this number of instances. You must also have available
- # firewall and routes quota.
"config": { # Parameters that describe the nodes in a cluster. # The node configuration of the pool.
+ "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/
+ { # 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/
+ "key": "A String", # Key for taint.
+ "effect": "A String", # Effect for taint.
+ "value": "A String", # Value for taint.
+ },
+ ],
"machineType": "A String", # The name of a Google Compute Engine [machine
# type](/compute/docs/machine-types) (e.g.
# `n1-standard-1`).
@@ -169,7 +299,7 @@
],
"preemptible": True or False, # Whether the nodes are created as preemptible VM instances. See:
# https://cloud.google.com/compute/docs/instances/preemptible for more
- # inforamtion about preemptible VM instances.
+ # information about preemptible VM instances.
"labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
# These will added in addition to any default label(s) that
# Kubernetes may apply to the node.
@@ -177,7 +307,7 @@
# the Kubernetes version -- it's best to assume the behavior is undefined
# and conflicts should be avoided.
# For more information, including usage and the valid values, see:
- # http://kubernetes.io/v1.1/docs/user-guide/labels.html
+ # https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
"a_key": "A String",
},
"serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs. If
@@ -198,17 +328,54 @@
# Monitoring are enabled, in which case their required scopes will be added.
"A String",
],
+ "diskType": "A String", # Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
+ #
+ # If unspecified, the default disk type is 'pd-standard'
"diskSizeGb": 42, # Size of the disk attached to each node, specified in GB.
# The smallest allowed disk size is 10GB.
#
# If unspecified, the default disk size is 100GB.
+ "accelerators": [ # A list of hardware accelerators to be attached to each node.
+ # See https://cloud.google.com/compute/docs/gpus for more information about
+ # support for GPUs.
+ { # AcceleratorConfig represents a Hardware Accelerator request.
+ "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
+ "acceleratorType": "A String", # The accelerator type resource name. List of supported accelerators
+ # [here](/compute/docs/gpus/#Introduction)
+ },
+ ],
+ "minCpuPlatform": "A String", # Minimum CPU platform to be used by this instance. The instance may be
+ # scheduled on the specified or newer CPU platform. Applicable values are the
+ # friendly names of CPU platforms, such as
+ # <code>minCpuPlatform: "Intel Haswell"</code> or
+ # <code>minCpuPlatform: "Intel Sandy Bridge"</code>. For more
+ # information, read [how to specify min CPU
+ # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
"metadata": { # The metadata key/value pairs assigned to instances in the cluster.
#
# Keys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes
# 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 four reserved keys:
- # "instance-template", "kube-env", "startup-script", and "user-data"
+ # metadata keys for the project or be one of the reserved keys:
+ # "cluster-location"
+ # "cluster-name"
+ # "cluster-uid"
+ # "configure-sh"
+ # "containerd-configure-sh"
+ # "enable-os-login"
+ # "gci-update-strategy"
+ # "gci-ensure-gke-docker"
+ # "instance-template"
+ # "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
@@ -226,9 +393,19 @@
# https://cloud.google.com/compute/docs/disks/local-ssd#local_ssd_limits
# for more information.
},
- "statusMessage": "A String", # [Output only] Additional information about the current status of this
- # node pool instance, if available.
+ "conditions": [ # Which conditions caused the current node pool state.
+ { # StatusCondition describes why a cluster or a node pool has a certain status
+ # (e.g., ERROR or DEGRADED).
+ "message": "A String", # Human-friendly representation of the condition
+ "code": "A String", # Machine-friendly representation of the condition
+ },
+ ],
+ "selfLink": "A String", # [Output only] Server-defined URL for the resource.
},
+ "zone": "A String", # 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.
}
x__xgafv: string, V1 error format.
@@ -242,30 +419,60 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
"status": "A String", # The current status of the operation.
- "statusMessage": "A String", # If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
"name": "A String", # The server-assigned ID for the operation.
"zone": "A String", # The name of the Google Compute Engine
# [zone](/compute/docs/zones#available) in which the operation
# is taking place.
+ # This field is deprecated, use location instead.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
"detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
"operationType": "A String", # The operation type.
- "selfLink": "A String", # Server-defined URL for the resource.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "location": "A String", # [Output only] The name of the Google Compute Engine
+ # [zone](/compute/docs/regions-zones/regions-zones#available) or
+ # [region](/compute/docs/regions-zones/regions-zones#available) in which
+ # the cluster resides.
+ "nodepoolConditions": [ # Which conditions caused the current node pool state.
+ { # StatusCondition describes why a cluster or a node pool has a certain status
+ # (e.g., ERROR or DEGRADED).
+ "message": "A String", # Human-friendly representation of the condition
+ "code": "A String", # Machine-friendly representation of the condition
+ },
+ ],
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "statusMessage": "A String", # If an error has occurred, a textual description of the error.
+ "clusterConditions": [ # Which conditions caused the current cluster state.
+ { # StatusCondition describes why a cluster or a node pool has a certain status
+ # (e.g., ERROR or DEGRADED).
+ "message": "A String", # Human-friendly representation of the condition
+ "code": "A String", # Machine-friendly representation of the condition
+ },
+ ],
}</pre>
</div>
<div class="method">
- <code class="details" id="delete">delete(projectId, zone, clusterId, nodePoolId, x__xgafv=None)</code>
+ <code class="details" id="delete">delete(projectId, zone, clusterId, nodePoolId, name=None, x__xgafv=None)</code>
<pre>Deletes a node pool from a cluster.
Args:
- projectId: string, The Google Developers Console [project ID or project
-number](https://developers.google.com/console/help/new/#projectnumber). (required)
- zone: string, The name of the Google Compute Engine
+ projectId: string, 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. (required)
+ zone: string, Deprecated. The name of the Google Compute Engine
[zone](/compute/docs/zones#available) in which the cluster
-resides. (required)
- clusterId: string, The name of the cluster. (required)
- nodePoolId: string, The name of the node pool to delete. (required)
+resides.
+This field has been deprecated and replaced by the name field. (required)
+ clusterId: string, Deprecated. The name of the cluster.
+This field has been deprecated and replaced by the name field. (required)
+ nodePoolId: string, Deprecated. The name of the node pool to delete.
+This field has been deprecated and replaced by the name field. (required)
+ name: string, The name (project, location, cluster, node pool id) of the node pool to
+delete. Specified in the format
+'projects/*/locations/*/clusters/*/nodePools/*'.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -277,30 +484,60 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
"status": "A String", # The current status of the operation.
- "statusMessage": "A String", # If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
"name": "A String", # The server-assigned ID for the operation.
"zone": "A String", # The name of the Google Compute Engine
# [zone](/compute/docs/zones#available) in which the operation
# is taking place.
+ # This field is deprecated, use location instead.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
"detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
"operationType": "A String", # The operation type.
- "selfLink": "A String", # Server-defined URL for the resource.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "location": "A String", # [Output only] The name of the Google Compute Engine
+ # [zone](/compute/docs/regions-zones/regions-zones#available) or
+ # [region](/compute/docs/regions-zones/regions-zones#available) in which
+ # the cluster resides.
+ "nodepoolConditions": [ # Which conditions caused the current node pool state.
+ { # StatusCondition describes why a cluster or a node pool has a certain status
+ # (e.g., ERROR or DEGRADED).
+ "message": "A String", # Human-friendly representation of the condition
+ "code": "A String", # Machine-friendly representation of the condition
+ },
+ ],
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "statusMessage": "A String", # If an error has occurred, a textual description of the error.
+ "clusterConditions": [ # Which conditions caused the current cluster state.
+ { # StatusCondition describes why a cluster or a node pool has a certain status
+ # (e.g., ERROR or DEGRADED).
+ "message": "A String", # Human-friendly representation of the condition
+ "code": "A String", # Machine-friendly representation of the condition
+ },
+ ],
}</pre>
</div>
<div class="method">
- <code class="details" id="get">get(projectId, zone, clusterId, nodePoolId, x__xgafv=None)</code>
- <pre>Retrieves the node pool requested.
+ <code class="details" id="get">get(projectId, zone, clusterId, nodePoolId, name=None, x__xgafv=None)</code>
+ <pre>Retrieves the requested node pool.
Args:
- projectId: string, The Google Developers Console [project ID or project
-number](https://developers.google.com/console/help/new/#projectnumber). (required)
- zone: string, The name of the Google Compute Engine
+ projectId: string, 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. (required)
+ zone: string, Deprecated. The name of the Google Compute Engine
[zone](/compute/docs/zones#available) in which the cluster
-resides. (required)
- clusterId: string, The name of the cluster. (required)
- nodePoolId: string, The name of the node pool. (required)
+resides.
+This field has been deprecated and replaced by the name field. (required)
+ clusterId: string, Deprecated. The name of the cluster.
+This field has been deprecated and replaced by the name field. (required)
+ nodePoolId: string, Deprecated. The name of the node pool.
+This field has been deprecated and replaced by the name field. (required)
+ name: string, The name (project, location, cluster, node pool id) of the node pool to
+get. Specified in the format
+'projects/*/locations/*/clusters/*/nodePools/*'.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -316,7 +553,33 @@
# during pod scheduling. They may also be resized up or down, to accommodate
# the workload.
"status": "A String", # [Output only] The status of the nodes in this pool instance.
- "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+ "statusMessage": "A String", # [Output only] Additional information about the current status of this
+ # node pool instance, if available.
+ "name": "A String", # The name of the node pool.
+ "instanceGroupUrls": [ # [Output only] The resource URLs of the [managed instance
+ # groups](/compute/docs/instance-groups/creating-groups-of-managed-instances)
+ # associated with this node pool.
+ "A String",
+ ],
+ "autoscaling": { # NodePoolAutoscaling contains information required by cluster autoscaler to # Autoscaler configuration for this NodePool. Autoscaler is enabled
+ # only if a valid configuration is present.
+ # adjust the size of the node pool to the current cluster usage.
+ "minNodeCount": 42, # Minimum number of nodes in the NodePool. Must be >= 1 and <=
+ # max_node_count.
+ "enabled": True or False, # Is autoscaling enabled for this node pool.
+ "maxNodeCount": 42, # Maximum number of nodes in the NodePool. Must be >= min_node_count. There
+ # has to enough quota to scale up the cluster.
+ },
+ "maxPodsConstraint": { # Constraints applied to pods. # The constraint on the maximum number of pods that can be run
+ # simultaneously on a node in the node pool.
+ "maxPodsPerNode": "A String", # Constraint enforced on the max num of pods per node.
+ },
+ "version": "A String", # The version of the Kubernetes of this node.
+ "initialNodeCount": 42, # The initial node count for the pool. You must ensure that your
+ # Compute Engine <a href="/compute/docs/resource-quotas">resource quota</a>
+ # is sufficient for this number of instances. You must also have available
+ # firewall and routes quota.
+ "podIpv4CidrSize": 42, # [Output only] The pod CIDR block size per node in this node pool.
"management": { # NodeManagement defines the set of node management services turned on for the # NodeManagement configuration for this NodePool.
# node pool.
"autoRepair": True or False, # A flag that specifies whether the node auto-repair is enabled for the node
@@ -335,27 +598,21 @@
# pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
# up to date with the latest release version of Kubernetes.
},
- "name": "A String", # The name of the node pool.
- "instanceGroupUrls": [ # [Output only] The resource URLs of [instance
- # groups](/compute/docs/instance-groups/) associated with this
- # node pool.
- "A String",
- ],
- "autoscaling": { # NodePoolAutoscaling contains information required by cluster autoscaler to # Autoscaler configuration for this NodePool. Autoscaler is enabled
- # only if a valid configuration is present.
- # adjust the size of the node pool to the current cluster usage.
- "minNodeCount": 42, # Minimum number of nodes in the NodePool. Must be >= 1 and <=
- # max_node_count.
- "enabled": True or False, # Is autoscaling enabled for this node pool.
- "maxNodeCount": 42, # Maximum number of nodes in the NodePool. Must be >= min_node_count. There
- # has to enough quota to scale up the cluster.
- },
- "version": "A String", # [Output only] The version of the Kubernetes of this node.
- "initialNodeCount": 42, # The initial node count for the pool. You must ensure that your
- # Compute Engine <a href="/compute/docs/resource-quotas">resource quota</a>
- # is sufficient for this number of instances. You must also have available
- # firewall and routes quota.
"config": { # Parameters that describe the nodes in a cluster. # The node configuration of the pool.
+ "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/
+ { # 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/
+ "key": "A String", # Key for taint.
+ "effect": "A String", # Effect for taint.
+ "value": "A String", # Value for taint.
+ },
+ ],
"machineType": "A String", # The name of a Google Compute Engine [machine
# type](/compute/docs/machine-types) (e.g.
# `n1-standard-1`).
@@ -370,7 +627,7 @@
],
"preemptible": True or False, # Whether the nodes are created as preemptible VM instances. See:
# https://cloud.google.com/compute/docs/instances/preemptible for more
- # inforamtion about preemptible VM instances.
+ # information about preemptible VM instances.
"labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
# These will added in addition to any default label(s) that
# Kubernetes may apply to the node.
@@ -378,7 +635,7 @@
# the Kubernetes version -- it's best to assume the behavior is undefined
# and conflicts should be avoided.
# For more information, including usage and the valid values, see:
- # http://kubernetes.io/v1.1/docs/user-guide/labels.html
+ # https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
"a_key": "A String",
},
"serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs. If
@@ -399,17 +656,54 @@
# Monitoring are enabled, in which case their required scopes will be added.
"A String",
],
+ "diskType": "A String", # Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
+ #
+ # If unspecified, the default disk type is 'pd-standard'
"diskSizeGb": 42, # Size of the disk attached to each node, specified in GB.
# The smallest allowed disk size is 10GB.
#
# If unspecified, the default disk size is 100GB.
+ "accelerators": [ # A list of hardware accelerators to be attached to each node.
+ # See https://cloud.google.com/compute/docs/gpus for more information about
+ # support for GPUs.
+ { # AcceleratorConfig represents a Hardware Accelerator request.
+ "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
+ "acceleratorType": "A String", # The accelerator type resource name. List of supported accelerators
+ # [here](/compute/docs/gpus/#Introduction)
+ },
+ ],
+ "minCpuPlatform": "A String", # Minimum CPU platform to be used by this instance. The instance may be
+ # scheduled on the specified or newer CPU platform. Applicable values are the
+ # friendly names of CPU platforms, such as
+ # <code>minCpuPlatform: "Intel Haswell"</code> or
+ # <code>minCpuPlatform: "Intel Sandy Bridge"</code>. For more
+ # information, read [how to specify min CPU
+ # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
"metadata": { # The metadata key/value pairs assigned to instances in the cluster.
#
# Keys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes
# 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 four reserved keys:
- # "instance-template", "kube-env", "startup-script", and "user-data"
+ # metadata keys for the project or be one of the reserved keys:
+ # "cluster-location"
+ # "cluster-name"
+ # "cluster-uid"
+ # "configure-sh"
+ # "containerd-configure-sh"
+ # "enable-os-login"
+ # "gci-update-strategy"
+ # "gci-ensure-gke-docker"
+ # "instance-template"
+ # "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
@@ -427,22 +721,33 @@
# https://cloud.google.com/compute/docs/disks/local-ssd#local_ssd_limits
# for more information.
},
- "statusMessage": "A String", # [Output only] Additional information about the current status of this
- # node pool instance, if available.
+ "conditions": [ # Which conditions caused the current node pool state.
+ { # StatusCondition describes why a cluster or a node pool has a certain status
+ # (e.g., ERROR or DEGRADED).
+ "message": "A String", # Human-friendly representation of the condition
+ "code": "A String", # Machine-friendly representation of the condition
+ },
+ ],
+ "selfLink": "A String", # [Output only] Server-defined URL for the resource.
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(projectId, zone, clusterId, x__xgafv=None)</code>
+ <code class="details" id="list">list(projectId, zone, clusterId, parent=None, x__xgafv=None)</code>
<pre>Lists the node pools for a cluster.
Args:
- projectId: string, The Google Developers Console [project ID or project
-number](https://developers.google.com/console/help/new/#projectnumber). (required)
- zone: string, The name of the Google Compute Engine
+ projectId: string, 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. (required)
+ zone: string, Deprecated. The name of the Google Compute Engine
[zone](/compute/docs/zones#available) in which the cluster
-resides. (required)
- clusterId: string, The name of the cluster. (required)
+resides.
+This field has been deprecated and replaced by the parent field. (required)
+ clusterId: string, Deprecated. The name of the cluster.
+This field has been deprecated and replaced by the parent field. (required)
+ parent: string, The parent (project, location, cluster id) where the node pools will be
+listed. Specified in the format 'projects/*/locations/*/clusters/*'.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -460,7 +765,33 @@
# during pod scheduling. They may also be resized up or down, to accommodate
# the workload.
"status": "A String", # [Output only] The status of the nodes in this pool instance.
- "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+ "statusMessage": "A String", # [Output only] Additional information about the current status of this
+ # node pool instance, if available.
+ "name": "A String", # The name of the node pool.
+ "instanceGroupUrls": [ # [Output only] The resource URLs of the [managed instance
+ # groups](/compute/docs/instance-groups/creating-groups-of-managed-instances)
+ # associated with this node pool.
+ "A String",
+ ],
+ "autoscaling": { # NodePoolAutoscaling contains information required by cluster autoscaler to # Autoscaler configuration for this NodePool. Autoscaler is enabled
+ # only if a valid configuration is present.
+ # adjust the size of the node pool to the current cluster usage.
+ "minNodeCount": 42, # Minimum number of nodes in the NodePool. Must be >= 1 and <=
+ # max_node_count.
+ "enabled": True or False, # Is autoscaling enabled for this node pool.
+ "maxNodeCount": 42, # Maximum number of nodes in the NodePool. Must be >= min_node_count. There
+ # has to enough quota to scale up the cluster.
+ },
+ "maxPodsConstraint": { # Constraints applied to pods. # The constraint on the maximum number of pods that can be run
+ # simultaneously on a node in the node pool.
+ "maxPodsPerNode": "A String", # Constraint enforced on the max num of pods per node.
+ },
+ "version": "A String", # The version of the Kubernetes of this node.
+ "initialNodeCount": 42, # The initial node count for the pool. You must ensure that your
+ # Compute Engine <a href="/compute/docs/resource-quotas">resource quota</a>
+ # is sufficient for this number of instances. You must also have available
+ # firewall and routes quota.
+ "podIpv4CidrSize": 42, # [Output only] The pod CIDR block size per node in this node pool.
"management": { # NodeManagement defines the set of node management services turned on for the # NodeManagement configuration for this NodePool.
# node pool.
"autoRepair": True or False, # A flag that specifies whether the node auto-repair is enabled for the node
@@ -479,27 +810,21 @@
# pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
# up to date with the latest release version of Kubernetes.
},
- "name": "A String", # The name of the node pool.
- "instanceGroupUrls": [ # [Output only] The resource URLs of [instance
- # groups](/compute/docs/instance-groups/) associated with this
- # node pool.
- "A String",
- ],
- "autoscaling": { # NodePoolAutoscaling contains information required by cluster autoscaler to # Autoscaler configuration for this NodePool. Autoscaler is enabled
- # only if a valid configuration is present.
- # adjust the size of the node pool to the current cluster usage.
- "minNodeCount": 42, # Minimum number of nodes in the NodePool. Must be >= 1 and <=
- # max_node_count.
- "enabled": True or False, # Is autoscaling enabled for this node pool.
- "maxNodeCount": 42, # Maximum number of nodes in the NodePool. Must be >= min_node_count. There
- # has to enough quota to scale up the cluster.
- },
- "version": "A String", # [Output only] The version of the Kubernetes of this node.
- "initialNodeCount": 42, # The initial node count for the pool. You must ensure that your
- # Compute Engine <a href="/compute/docs/resource-quotas">resource quota</a>
- # is sufficient for this number of instances. You must also have available
- # firewall and routes quota.
"config": { # Parameters that describe the nodes in a cluster. # The node configuration of the pool.
+ "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/
+ { # 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/
+ "key": "A String", # Key for taint.
+ "effect": "A String", # Effect for taint.
+ "value": "A String", # Value for taint.
+ },
+ ],
"machineType": "A String", # The name of a Google Compute Engine [machine
# type](/compute/docs/machine-types) (e.g.
# `n1-standard-1`).
@@ -514,7 +839,7 @@
],
"preemptible": True or False, # Whether the nodes are created as preemptible VM instances. See:
# https://cloud.google.com/compute/docs/instances/preemptible for more
- # inforamtion about preemptible VM instances.
+ # information about preemptible VM instances.
"labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
# These will added in addition to any default label(s) that
# Kubernetes may apply to the node.
@@ -522,7 +847,7 @@
# the Kubernetes version -- it's best to assume the behavior is undefined
# and conflicts should be avoided.
# For more information, including usage and the valid values, see:
- # http://kubernetes.io/v1.1/docs/user-guide/labels.html
+ # https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
"a_key": "A String",
},
"serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs. If
@@ -543,17 +868,54 @@
# Monitoring are enabled, in which case their required scopes will be added.
"A String",
],
+ "diskType": "A String", # Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
+ #
+ # If unspecified, the default disk type is 'pd-standard'
"diskSizeGb": 42, # Size of the disk attached to each node, specified in GB.
# The smallest allowed disk size is 10GB.
#
# If unspecified, the default disk size is 100GB.
+ "accelerators": [ # A list of hardware accelerators to be attached to each node.
+ # See https://cloud.google.com/compute/docs/gpus for more information about
+ # support for GPUs.
+ { # AcceleratorConfig represents a Hardware Accelerator request.
+ "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
+ "acceleratorType": "A String", # The accelerator type resource name. List of supported accelerators
+ # [here](/compute/docs/gpus/#Introduction)
+ },
+ ],
+ "minCpuPlatform": "A String", # Minimum CPU platform to be used by this instance. The instance may be
+ # scheduled on the specified or newer CPU platform. Applicable values are the
+ # friendly names of CPU platforms, such as
+ # <code>minCpuPlatform: "Intel Haswell"</code> or
+ # <code>minCpuPlatform: "Intel Sandy Bridge"</code>. For more
+ # information, read [how to specify min CPU
+ # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
"metadata": { # The metadata key/value pairs assigned to instances in the cluster.
#
# Keys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes
# 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 four reserved keys:
- # "instance-template", "kube-env", "startup-script", and "user-data"
+ # metadata keys for the project or be one of the reserved keys:
+ # "cluster-location"
+ # "cluster-name"
+ # "cluster-uid"
+ # "configure-sh"
+ # "containerd-configure-sh"
+ # "enable-os-login"
+ # "gci-update-strategy"
+ # "gci-ensure-gke-docker"
+ # "instance-template"
+ # "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
@@ -571,8 +933,14 @@
# https://cloud.google.com/compute/docs/disks/local-ssd#local_ssd_limits
# for more information.
},
- "statusMessage": "A String", # [Output only] Additional information about the current status of this
- # node pool instance, if available.
+ "conditions": [ # Which conditions caused the current node pool state.
+ { # StatusCondition describes why a cluster or a node pool has a certain status
+ # (e.g., ERROR or DEGRADED).
+ "message": "A String", # Human-friendly representation of the condition
+ "code": "A String", # Machine-friendly representation of the condition
+ },
+ ],
+ "selfLink": "A String", # [Output only] Server-defined URL for the resource.
},
],
}</pre>
@@ -580,23 +948,41 @@
<div class="method">
<code class="details" id="rollback">rollback(projectId, zone, clusterId, nodePoolId, body, x__xgafv=None)</code>
- <pre>Roll back the previously Aborted or Failed NodePool upgrade.
-This will be an no-op if the last upgrade successfully completed.
+ <pre>Rolls back a previously Aborted or Failed NodePool upgrade.
+This makes no changes if the last upgrade successfully completed.
Args:
- projectId: string, The Google Developers Console [project ID or project
-number](https://support.google.com/cloud/answer/6158840). (required)
- zone: string, The name of the Google Compute Engine
+ projectId: string, 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. (required)
+ zone: string, Deprecated. The name of the Google Compute Engine
[zone](/compute/docs/zones#available) in which the cluster
-resides. (required)
- clusterId: string, The name of the cluster to rollback. (required)
- nodePoolId: string, The name of the node pool to rollback. (required)
+resides.
+This field has been deprecated and replaced by the name field. (required)
+ clusterId: string, Deprecated. The name of the cluster to rollback.
+This field has been deprecated and replaced by the name field. (required)
+ nodePoolId: string, Deprecated. The name of the node pool to rollback.
+This field has been deprecated and replaced by the name field. (required)
body: object, The request body. (required)
The object takes the form of:
{ # RollbackNodePoolUpgradeRequest rollbacks the previously Aborted or Failed
# NodePool upgrade. This will be an no-op if the last upgrade successfully
# completed.
+ "projectId": "A String", # 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.
+ "clusterId": "A String", # Deprecated. The name of the cluster to rollback.
+ # This field has been deprecated and replaced by the name field.
+ "name": "A String", # The name (project, location, cluster, node pool id) of the node poll to
+ # rollback upgrade.
+ # Specified in the format 'projects/*/locations/*/clusters/*/nodePools/*'.
+ "zone": "A String", # 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.
+ "nodePoolId": "A String", # Deprecated. The name of the node pool to rollback.
+ # This field has been deprecated and replaced by the name field.
}
x__xgafv: string, V1 error format.
@@ -610,15 +996,38 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
"status": "A String", # The current status of the operation.
- "statusMessage": "A String", # If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
"name": "A String", # The server-assigned ID for the operation.
"zone": "A String", # The name of the Google Compute Engine
# [zone](/compute/docs/zones#available) in which the operation
# is taking place.
+ # This field is deprecated, use location instead.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
"detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
"operationType": "A String", # The operation type.
- "selfLink": "A String", # Server-defined URL for the resource.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "location": "A String", # [Output only] The name of the Google Compute Engine
+ # [zone](/compute/docs/regions-zones/regions-zones#available) or
+ # [region](/compute/docs/regions-zones/regions-zones#available) in which
+ # the cluster resides.
+ "nodepoolConditions": [ # Which conditions caused the current node pool state.
+ { # StatusCondition describes why a cluster or a node pool has a certain status
+ # (e.g., ERROR or DEGRADED).
+ "message": "A String", # Human-friendly representation of the condition
+ "code": "A String", # Machine-friendly representation of the condition
+ },
+ ],
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "statusMessage": "A String", # If an error has occurred, a textual description of the error.
+ "clusterConditions": [ # Which conditions caused the current cluster state.
+ { # StatusCondition describes why a cluster or a node pool has a certain status
+ # (e.g., ERROR or DEGRADED).
+ "message": "A String", # Human-friendly representation of the condition
+ "code": "A String", # Machine-friendly representation of the condition
+ },
+ ],
}</pre>
</div>
@@ -627,13 +1036,17 @@
<pre>Sets the NodeManagement options for a node pool.
Args:
- projectId: string, The Google Developers Console [project ID or project
-number](https://support.google.com/cloud/answer/6158840). (required)
- zone: string, The name of the Google Compute Engine
+ projectId: string, 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. (required)
+ zone: string, Deprecated. The name of the Google Compute Engine
[zone](/compute/docs/zones#available) in which the cluster
-resides. (required)
- clusterId: string, The name of the cluster to update. (required)
- nodePoolId: string, The name of the node pool to update. (required)
+resides.
+This field has been deprecated and replaced by the name field. (required)
+ clusterId: string, Deprecated. The name of the cluster to update.
+This field has been deprecated and replaced by the name field. (required)
+ nodePoolId: string, Deprecated. The name of the node pool to update.
+This field has been deprecated and replaced by the name field. (required)
body: object, The request body. (required)
The object takes the form of:
@@ -657,6 +1070,20 @@
# pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
# up to date with the latest release version of Kubernetes.
},
+ "name": "A String", # The name (project, location, cluster, node pool id) of the node pool to set
+ # management properties. Specified in the format
+ # 'projects/*/locations/*/clusters/*/nodePools/*'.
+ "zone": "A String", # 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.
+ "projectId": "A String", # 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.
+ "clusterId": "A String", # Deprecated. The name of the cluster to update.
+ # This field has been deprecated and replaced by the name field.
+ "nodePoolId": "A String", # Deprecated. The name of the node pool to update.
+ # This field has been deprecated and replaced by the name field.
}
x__xgafv: string, V1 error format.
@@ -670,15 +1097,216 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
"status": "A String", # The current status of the operation.
- "statusMessage": "A String", # If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
"name": "A String", # The server-assigned ID for the operation.
"zone": "A String", # The name of the Google Compute Engine
# [zone](/compute/docs/zones#available) in which the operation
# is taking place.
+ # This field is deprecated, use location instead.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
"detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
"operationType": "A String", # The operation type.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "location": "A String", # [Output only] The name of the Google Compute Engine
+ # [zone](/compute/docs/regions-zones/regions-zones#available) or
+ # [region](/compute/docs/regions-zones/regions-zones#available) in which
+ # the cluster resides.
+ "nodepoolConditions": [ # Which conditions caused the current node pool state.
+ { # StatusCondition describes why a cluster or a node pool has a certain status
+ # (e.g., ERROR or DEGRADED).
+ "message": "A String", # Human-friendly representation of the condition
+ "code": "A String", # Machine-friendly representation of the condition
+ },
+ ],
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "statusMessage": "A String", # If an error has occurred, a textual description of the error.
+ "clusterConditions": [ # Which conditions caused the current cluster state.
+ { # StatusCondition describes why a cluster or a node pool has a certain status
+ # (e.g., ERROR or DEGRADED).
+ "message": "A String", # Human-friendly representation of the condition
+ "code": "A String", # Machine-friendly representation of the condition
+ },
+ ],
+ }</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="setSize">setSize(projectId, zone, clusterId, nodePoolId, body, x__xgafv=None)</code>
+ <pre>Sets the size for a specific node pool.
+
+Args:
+ projectId: string, 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. (required)
+ zone: string, 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. (required)
+ clusterId: string, Deprecated. The name of the cluster to update.
+This field has been deprecated and replaced by the name field. (required)
+ nodePoolId: string, Deprecated. The name of the node pool to update.
+This field has been deprecated and replaced by the name field. (required)
+ body: object, The request body. (required)
+ The object takes the form of:
+
+{ # SetNodePoolSizeRequest sets the size a node
+ # pool.
+ "name": "A String", # The name (project, location, cluster, node pool id) of the node pool to set
+ # size.
+ # Specified in the format 'projects/*/locations/*/clusters/*/nodePools/*'.
+ "zone": "A String", # 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.
+ "projectId": "A String", # 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.
+ "clusterId": "A String", # Deprecated. The name of the cluster to update.
+ # This field has been deprecated and replaced by the name field.
+ "nodePoolId": "A String", # Deprecated. The name of the node pool to update.
+ # This field has been deprecated and replaced by the name field.
+ "nodeCount": 42, # The desired node count for the pool.
+ }
+
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # This operation resource represents operations that may have happened or are
+ # happening on the cluster. All fields are output only.
+ "status": "A String", # The current status of the operation.
"selfLink": "A String", # Server-defined URL for the resource.
+ "name": "A String", # The server-assigned ID for the operation.
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](/compute/docs/zones#available) in which the operation
+ # is taking place.
+ # This field is deprecated, use location instead.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "detail": "A String", # Detailed operation progress, if available.
+ "operationType": "A String", # The operation type.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "location": "A String", # [Output only] The name of the Google Compute Engine
+ # [zone](/compute/docs/regions-zones/regions-zones#available) or
+ # [region](/compute/docs/regions-zones/regions-zones#available) in which
+ # the cluster resides.
+ "nodepoolConditions": [ # Which conditions caused the current node pool state.
+ { # StatusCondition describes why a cluster or a node pool has a certain status
+ # (e.g., ERROR or DEGRADED).
+ "message": "A String", # Human-friendly representation of the condition
+ "code": "A String", # Machine-friendly representation of the condition
+ },
+ ],
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "statusMessage": "A String", # If an error has occurred, a textual description of the error.
+ "clusterConditions": [ # Which conditions caused the current cluster state.
+ { # StatusCondition describes why a cluster or a node pool has a certain status
+ # (e.g., ERROR or DEGRADED).
+ "message": "A String", # Human-friendly representation of the condition
+ "code": "A String", # Machine-friendly representation of the condition
+ },
+ ],
+ }</pre>
+</div>
+
+<div class="method">
+ <code class="details" id="update">update(projectId, zone, clusterId, nodePoolId, body, x__xgafv=None)</code>
+ <pre>Updates the version and/or image type for the specified node pool.
+
+Args:
+ projectId: string, 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. (required)
+ zone: string, 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. (required)
+ clusterId: string, Deprecated. The name of the cluster to upgrade.
+This field has been deprecated and replaced by the name field. (required)
+ nodePoolId: string, Deprecated. The name of the node pool to upgrade.
+This field has been deprecated and replaced by the name field. (required)
+ body: object, The request body. (required)
+ The object takes the form of:
+
+{ # UpdateNodePoolRequests update a node pool's image and/or version.
+ "name": "A String", # The name (project, location, cluster, node pool) of the node pool to
+ # update. Specified in the format
+ # 'projects/*/locations/*/clusters/*/nodePools/*'.
+ "zone": "A String", # 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.
+ "projectId": "A String", # 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.
+ "clusterId": "A String", # Deprecated. The name of the cluster to upgrade.
+ # This field has been deprecated and replaced by the name field.
+ "nodePoolId": "A String", # Deprecated. The name of the node pool to upgrade.
+ # This field has been deprecated and replaced by the name field.
+ "nodeVersion": "A String", # 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
+ "imageType": "A String", # The desired image type for the node pool.
+ }
+
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # This operation resource represents operations that may have happened or are
+ # happening on the cluster. All fields are output only.
+ "status": "A String", # The current status of the operation.
+ "selfLink": "A String", # Server-defined URL for the resource.
+ "name": "A String", # The server-assigned ID for the operation.
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](/compute/docs/zones#available) in which the operation
+ # is taking place.
+ # This field is deprecated, use location instead.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "detail": "A String", # Detailed operation progress, if available.
+ "operationType": "A String", # The operation type.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "location": "A String", # [Output only] The name of the Google Compute Engine
+ # [zone](/compute/docs/regions-zones/regions-zones#available) or
+ # [region](/compute/docs/regions-zones/regions-zones#available) in which
+ # the cluster resides.
+ "nodepoolConditions": [ # Which conditions caused the current node pool state.
+ { # StatusCondition describes why a cluster or a node pool has a certain status
+ # (e.g., ERROR or DEGRADED).
+ "message": "A String", # Human-friendly representation of the condition
+ "code": "A String", # Machine-friendly representation of the condition
+ },
+ ],
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "statusMessage": "A String", # If an error has occurred, a textual description of the error.
+ "clusterConditions": [ # Which conditions caused the current cluster state.
+ { # StatusCondition describes why a cluster or a node pool has a certain status
+ # (e.g., ERROR or DEGRADED).
+ "message": "A String", # Human-friendly representation of the condition
+ "code": "A String", # Machine-friendly representation of the condition
+ },
+ ],
}</pre>
</div>