docs: update docs (#916)
* fix: re-run script
* test: fix noxfile
diff --git a/docs/dyn/container_v1.projects.zones.clusters.html b/docs/dyn/container_v1.projects.zones.clusters.html
index e718373..375dec6 100644
--- a/docs/dyn/container_v1.projects.zones.clusters.html
+++ b/docs/dyn/container_v1.projects.zones.clusters.html
@@ -210,12 +210,50 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
+ "name": "A String", # A non-parameterized string describing an operation stage.
+ # Unset for single-stage operations.
+ "stages": [ # Substages of an operation or a stage.
+ # Object with schema name: OperationProgress
+ ],
+ "metrics": [ # Progress metric bundle, for example:
+ # metrics: [{name: "nodes done", int_value: 15},
+ # {name: "nodes total", int_value: 32}]
+ # or
+ # metrics: [{name: "progress", double_value: 0.56},
+ # {name: "progress scale", double_value: 1.0}]
+ { # Progress metric is (string, int|float|string) pair.
+ "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
+ "doubleValue": 3.14, # For metrics with floating point value.
+ "intValue": "A String", # For metrics with integer value.
+ "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
+ },
+ ],
+ "status": "A String", # Status of an operation stage.
+ # Unset for single-stage operations.
+ },
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # operation is taking place. This field is deprecated, use location instead.
+ "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
+ "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.
+ "status": "A String", # The current status of the operation.
"name": "A String", # The server-assigned ID for the operation.
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"endTime": "A String", # [Output only] The time the operation completed, in
@@ -227,44 +265,6 @@
# in which the cluster resides.
"startTime": "A String", # [Output only] The time the operation started, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "status": "A String", # Status of an operation stage.
- # Unset for single-stage operations.
- "metrics": [ # Progress metric bundle, for example:
- # metrics: [{name: "nodes done", int_value: 15},
- # {name: "nodes total", int_value: 32}]
- # or
- # metrics: [{name: "progress", double_value: 0.56},
- # {name: "progress scale", double_value: 1.0}]
- { # Progress metric is (string, int|float|string) pair.
- "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- "intValue": "A String", # For metrics with integer value.
- },
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "zone": "A String", # The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # operation is taking place. This field is deprecated, use location instead.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "selfLink": "A String", # Server-defined URL for the resource.
- "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.
- "status": "A String", # The current status of the operation.
}</pre>
</div>
@@ -286,6 +286,8 @@
The object takes the form of:
{ # CompleteIPRotationRequest moves the cluster master back into single-IP mode.
+ "clusterId": "A String", # Deprecated. The name of the cluster.
+ # This field has been deprecated and replaced by the name field.
"name": "A String", # The name (project, location, cluster id) of the cluster to complete IP
# rotation. Specified in the format `projects/*/locations/*/clusters/*`.
"projectId": "A String", # Deprecated. The Google Developers Console [project ID or project
@@ -295,8 +297,6 @@
# [zone](https://cloud.google.com/compute/docs/zones#available) in which the
# cluster resides. This field has been deprecated and replaced by the name
# field.
- "clusterId": "A String", # Deprecated. The name of the cluster.
- # This field has been deprecated and replaced by the name field.
}
x__xgafv: string, V1 error format.
@@ -309,12 +309,50 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
+ "name": "A String", # A non-parameterized string describing an operation stage.
+ # Unset for single-stage operations.
+ "stages": [ # Substages of an operation or a stage.
+ # Object with schema name: OperationProgress
+ ],
+ "metrics": [ # Progress metric bundle, for example:
+ # metrics: [{name: "nodes done", int_value: 15},
+ # {name: "nodes total", int_value: 32}]
+ # or
+ # metrics: [{name: "progress", double_value: 0.56},
+ # {name: "progress scale", double_value: 1.0}]
+ { # Progress metric is (string, int|float|string) pair.
+ "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
+ "doubleValue": 3.14, # For metrics with floating point value.
+ "intValue": "A String", # For metrics with integer value.
+ "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
+ },
+ ],
+ "status": "A String", # Status of an operation stage.
+ # Unset for single-stage operations.
+ },
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # operation is taking place. This field is deprecated, use location instead.
+ "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
+ "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.
+ "status": "A String", # The current status of the operation.
"name": "A String", # The server-assigned ID for the operation.
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"endTime": "A String", # [Output only] The time the operation completed, in
@@ -326,44 +364,6 @@
# in which the cluster resides.
"startTime": "A String", # [Output only] The time the operation started, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "status": "A String", # Status of an operation stage.
- # Unset for single-stage operations.
- "metrics": [ # Progress metric bundle, for example:
- # metrics: [{name: "nodes done", int_value: 15},
- # {name: "nodes total", int_value: 32}]
- # or
- # metrics: [{name: "progress", double_value: 0.56},
- # {name: "progress scale", double_value: 1.0}]
- { # Progress metric is (string, int|float|string) pair.
- "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- "intValue": "A String", # For metrics with integer value.
- },
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "zone": "A String", # The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # operation is taking place. This field is deprecated, use location instead.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "selfLink": "A String", # Server-defined URL for the resource.
- "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.
- "status": "A String", # The current status of the operation.
}</pre>
</div>
@@ -396,11 +396,127 @@
The object takes the form of:
{ # CreateClusterRequest creates a cluster.
- "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 parent field.
+ "parent": "A String", # The parent (project and location) where the cluster will be created.
+ # Specified in the format `projects/*/locations/*`.
"cluster": { # A Google Kubernetes Engine cluster. # Required. A [cluster
# resource](https://cloud.google.com/container-engine/reference/rest/v1/projects.zones.clusters)
+ "createTime": "A String", # [Output only] The time the cluster was created, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "clusterIpv4Cidr": "A String", # The IP address range of the container pods in this cluster, in
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `10.96.0.0/14`). Leave blank to have
+ # one automatically chosen or specify a `/14` block in `10.0.0.0/8`.
+ "autoscaling": { # ClusterAutoscaling contains global, per-cluster information # Cluster-level autoscaling configuration.
+ # required by Cluster Autoscaler to automatically adjust
+ # the size of the cluster and create/delete
+ # node pools based on the current needs.
+ "autoprovisioningLocations": [ # The list of Google Compute Engine
+ # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
+ # NodePool's nodes can be created by NAP.
+ "A String",
+ ],
+ "resourceLimits": [ # Contains global constraints regarding minimum and maximum
+ # amount of resources in the cluster.
+ { # Contains information about amount of some resource in the cluster.
+ # For memory, value should be in GB.
+ "minimum": "A String", # Minimum amount of the resource in the cluster.
+ "maximum": "A String", # Maximum amount of the resource in the cluster.
+ "resourceType": "A String", # Resource name "cpu", "memory" or gpu-specific string.
+ },
+ ],
+ "enableNodeAutoprovisioning": True or False, # Enables automatic node pool creation and deletion.
+ "autoprovisioningNodePoolDefaults": { # AutoprovisioningNodePoolDefaults contains defaults for a node pool created # AutoprovisioningNodePoolDefaults contains defaults for a node pool
+ # created by NAP.
+ # by NAP.
+ "management": { # NodeManagement defines the set of node management services turned on for the # Specifies the node management options for NAP created node-pools.
+ # node pool.
+ "upgradeOptions": { # AutoUpgradeOptions defines the set of options for the user to control how # Specifies the Auto Upgrade knobs for the node pool.
+ # the Auto Upgrades will proceed.
+ "autoUpgradeStartTime": "A String", # [Output only] This field is set when upgrades are about to commence
+ # with the approximate start time for the upgrades, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "description": "A String", # [Output only] This field is set when upgrades are about to commence
+ # with the description of the upgrade.
+ },
+ "autoRepair": True or False, # A flag that specifies whether the node auto-repair is enabled for the node
+ # pool. If enabled, the nodes in this node pool will be monitored and, if
+ # they fail health checks too many times, an automatic repair action will be
+ # triggered.
+ "autoUpgrade": True or False, # A flag that specifies whether node auto-upgrade is enabled for the node
+ # pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
+ # up to date with the latest release version of Kubernetes.
+ },
+ "oauthScopes": [ # Scopes that are used by NAP when creating node pools. If oauth_scopes are
+ # specified, service_account should be empty.
+ "A String",
+ ],
+ "upgradeSettings": { # These upgrade settings control the level of parallelism and the level of # Specifies the upgrade settings for NAP created node pools
+ # disruption caused by an upgrade.
+ #
+ # maxUnavailable controls the number of nodes that can be simultaneously
+ # unavailable.
+ #
+ # maxSurge controls the number of additional nodes that can be added to the
+ # node pool temporarily for the time of the upgrade to increase the number of
+ # available nodes.
+ #
+ # (maxUnavailable + maxSurge) determines the level of parallelism (how many
+ # nodes are being upgraded at the same time).
+ #
+ # Note: upgrades inevitably introduce some disruption since workloads need to
+ # be moved from old nodes to new, upgraded ones. Even if maxUnavailable=0,
+ # this holds true. (Disruption stays within the limits of
+ # PodDisruptionBudget, if it is configured.)
+ #
+ # Consider a hypothetical node pool with 5 nodes having maxSurge=2,
+ # maxUnavailable=1. This means the upgrade process upgrades 3 nodes
+ # simultaneously. It creates 2 additional (upgraded) nodes, then it brings
+ # down 3 old (not yet upgraded) nodes at the same time. This ensures that
+ # there are always at least 4 nodes available.
+ "maxUnavailable": 42, # The maximum number of nodes that can be simultaneously unavailable during
+ # the upgrade process. A node is considered available if its status is
+ # Ready.
+ "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
+ # of the node pool during the upgrade process.
+ },
+ "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs. If
+ # service_account is specified, scopes should be empty.
+ },
+ },
+ "initialNodeCount": 42, # The number of nodes to create in this cluster. 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.
+ # For requests, this field should only be used in lieu of a
+ # "node_pool" object, since this configuration (along with the
+ # "node_config") will be used to create a "NodePool" object with an
+ # auto-generated name. Do not use this and a node_pool at the same time.
+ #
+ # This field is deprecated, use node_pool.initial_node_count instead.
+ "instanceGroupUrls": [ # Deprecated. Use node_pools.instance_group_urls.
+ "A String",
+ ],
+ "privateClusterConfig": { # Configuration options for private clusters. # Configuration for private cluster.
+ "masterIpv4CidrBlock": "A String", # The IP range in CIDR notation to use for the hosted master network. This
+ # range will be used for assigning internal IP addresses to the master or
+ # set of masters, as well as the ILB VIP. This range must not overlap with
+ # any other ranges in use within the cluster's network.
+ "enablePrivateNodes": True or False, # Whether nodes have internal IP addresses only. If enabled, all nodes are
+ # given only RFC 1918 private addresses and communicate with the master via
+ # private networking.
+ "privateEndpoint": "A String", # Output only. The internal IP address of this cluster's master endpoint.
+ "enablePrivateEndpoint": True or False, # Whether the master's internal IP address is used as the cluster endpoint.
+ "peeringName": "A String", # Output only. The peering name in the customer VPC used by this cluster.
+ "publicEndpoint": "A String", # Output only. The external IP address of this cluster's master endpoint.
+ },
+ "shieldedNodes": { # Configuration of Shielded Nodes feature. # Shielded Nodes configuration.
+ "enabled": True or False, # Whether Shielded Nodes features are enabled on all nodes in this cluster.
+ },
+ "verticalPodAutoscaling": { # VerticalPodAutoscaling contains global, per-cluster information # Cluster-level Vertical Pod Autoscaling configuration.
+ # required by Vertical Pod Autoscaler to automatically adjust
+ # the resources of pods controlled by it.
+ "enabled": True or False, # Enables vertical pod autoscaling.
+ },
"defaultMaxPodsConstraint": { # Constraints applied to pods. # The default constraint on the maximum number of pods that can be run
# simultaneously on a node in the node pool of this cluster. Only honored
# if cluster created with IP Alias support.
@@ -419,7 +535,6 @@
# master authorized networks will disallow all external traffic to access
# Kubernetes master through HTTPS except traffic from the given CIDR blocks,
# Google Compute Engine Public IPs and Google Prod IPs.
- "enabled": True or False, # Whether or not master authorized networks is enabled.
"cidrBlocks": [ # cidr_blocks define up to 50 external networks that could access
# Kubernetes master through HTTPS.
{ # CidrBlock contains an optional name and one CIDR block.
@@ -427,6 +542,7 @@
"cidrBlock": "A String", # cidr_block must be specified in CIDR notation.
},
],
+ "enabled": True or False, # Whether or not master authorized networks is enabled.
},
"statusMessage": "A String", # [Output only] Additional information about the current status of this
# cluster, if available.
@@ -437,13 +553,6 @@
# certificate will be issued.
# Authentication can be done using HTTP basic auth or using client
# certificates.
- "clusterCaCertificate": "A String", # [Output only] Base64-encoded public certificate that is the root of
- # trust for the cluster.
- "clientCertificate": "A String", # [Output only] Base64-encoded public certificate used by clients to
- # authenticate to the cluster endpoint.
- "username": "A String", # The username to use for HTTP basic authentication to the master endpoint.
- # For clusters v1.6.0 and later, basic authentication can be disabled by
- # leaving username unspecified (or setting it to the empty string).
"password": "A String", # The password to use for HTTP basic authentication to the master endpoint.
# Because the master endpoint is open to the Internet, you should create a
# strong password. If a password is provided for cluster creation, username
@@ -455,6 +564,13 @@
},
"clientKey": "A String", # [Output only] Base64-encoded private key used by clients to authenticate
# to the cluster endpoint.
+ "clusterCaCertificate": "A String", # [Output only] Base64-encoded public certificate that is the root of
+ # trust for the cluster.
+ "clientCertificate": "A String", # [Output only] Base64-encoded public certificate used by clients to
+ # authenticate to the cluster endpoint.
+ "username": "A String", # The username to use for HTTP basic authentication to the master endpoint.
+ # For clusters v1.6.0 and later, basic authentication can be disabled by
+ # leaving username unspecified (or setting it to the empty string).
},
"authenticatorGroupsConfig": { # Configuration for returning group information from authenticators. # Configuration controlling RBAC group membership information.
"enabled": True or False, # Whether this cluster should return group membership lookups
@@ -514,18 +630,22 @@
},
"maintenancePolicy": { # MaintenancePolicy defines the maintenance policy to be used for the cluster. # Configure the maintenance policy for this cluster.
"window": { # MaintenanceWindow defines the maintenance window to be used for the cluster. # Specifies the maintenance window in which maintenance may be performed.
- "dailyMaintenanceWindow": { # Time window specified for daily maintenance operations. # DailyMaintenanceWindow specifies a daily maintenance operation window.
- "duration": "A String", # [Output only] Duration of the time window, automatically chosen to be
- # smallest possible in the given scenario.
- # Duration will be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
- # format "PTnHnMnS".
- "startTime": "A String", # Time within the maintenance window to start the maintenance operations.
- # Time format should be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
- # format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
+ "maintenanceExclusions": { # Exceptions to maintenance window. Non-emergency maintenance should not
+ # occur in these windows.
+ "a_key": { # Represents an arbitrary window of time.
+ "endTime": "A String", # The time that the window ends. The end time should take place after the
+ # start time.
+ "startTime": "A String", # The time that the window first starts.
+ },
},
"recurringWindow": { # Represents an arbitrary window of time that recurs. # RecurringWindow specifies some number of recurring time periods for
# maintenance to occur. The time windows may be overlapping. If no
# maintenance windows are set, maintenance can occur at any time.
+ "window": { # Represents an arbitrary window of time. # The window of the first recurrence.
+ "endTime": "A String", # The time that the window ends. The end time should take place after the
+ # start time.
+ "startTime": "A String", # The time that the window first starts.
+ },
"recurrence": "A String", # An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how
# this window reccurs. They go on for the span of time between the start and
# end time.
@@ -553,19 +673,15 @@
# Note the start and end time's specific dates are largely arbitrary except
# to specify duration of the window and when it first starts.
# The FREQ values of HOURLY, MINUTELY, and SECONDLY are not supported.
- "window": { # Represents an arbitrary window of time. # The window of the first recurrence.
- "endTime": "A String", # The time that the window ends. The end time should take place after the
- # start time.
- "startTime": "A String", # The time that the window first starts.
- },
},
- "maintenanceExclusions": { # Exceptions to maintenance window. Non-emergency maintenance should not
- # occur in these windows.
- "a_key": { # Represents an arbitrary window of time.
- "endTime": "A String", # The time that the window ends. The end time should take place after the
- # start time.
- "startTime": "A String", # The time that the window first starts.
- },
+ "dailyMaintenanceWindow": { # Time window specified for daily maintenance operations. # DailyMaintenanceWindow specifies a daily maintenance operation window.
+ "startTime": "A String", # Time within the maintenance window to start the maintenance operations.
+ # Time format should be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
+ # format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
+ "duration": "A String", # [Output only] Duration of the time window, automatically chosen to be
+ # smallest possible in the given scenario.
+ # Duration will be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
+ # format "PTnHnMnS".
},
},
"resourceVersion": "A String", # A hash identifying the version of this policy, so that updates to fields of
@@ -588,24 +704,14 @@
# - "1.X.Y-gke.N": picks an explicit Kubernetes version
# - "","-": picks the default Kubernetes version
"ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the cluster. # Configuration for cluster IP allocation.
- "clusterIpv4Cidr": "A String", # This field is deprecated, use cluster_ipv4_cidr_block.
- "servicesIpv4Cidr": "A String", # This field is deprecated, use services_ipv4_cidr_block.
- "servicesIpv4CidrBlock": "A String", # The IP address range of the services IPs in this cluster. If blank, a range
- # will be automatically chosen with the default size.
- #
- # This field is only applicable when `use_ip_aliases` is true.
- #
- # Set to blank to have a range chosen with the default size.
- #
- # Set to /netmask (e.g. `/14`) to have a range chosen with a specific
- # netmask.
- #
- # Set to a
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
- # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
- # to use.
"nodeIpv4Cidr": "A String", # This field is deprecated, use node_ipv4_cidr_block.
+ "clusterSecondaryRangeName": "A String", # The name of the secondary range to be used for the cluster CIDR
+ # block. The secondary range will be used for pod IP
+ # addresses. This must be an existing secondary range associated
+ # with the cluster subnetwork.
+ #
+ # This field is only applicable with use_ip_aliases is true and
+ # create_subnetwork is false.
"clusterIpv4CidrBlock": "A String", # The IP address range for the cluster pod IPs. If this field is set, then
# `cluster.cluster_ipv4_cidr` must be left blank.
#
@@ -621,13 +727,6 @@
# notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
# `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
# to use.
- "clusterSecondaryRangeName": "A String", # The name of the secondary range to be used for the cluster CIDR
- # block. The secondary range will be used for pod IP
- # addresses. This must be an existing secondary range associated
- # with the cluster subnetwork.
- #
- # This field is only applicable with use_ip_aliases is true and
- # create_subnetwork is false.
"nodeIpv4CidrBlock": "A String", # The IP address range of the instance IPs in this cluster.
#
# This is applicable only if `create_subnetwork` is true.
@@ -657,9 +756,6 @@
# notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
# `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
# to use.
- "createSubnetwork": True or False, # Whether a new subnetwork will be created automatically for the cluster.
- #
- # This field is only applicable when `use_ip_aliases` is true.
"useIpAliases": True or False, # Whether alias IPs will be used for pod IPs in the cluster.
"servicesSecondaryRangeName": "A String", # The name of the secondary range to be used as for the services
# CIDR block. The secondary range will be used for service
@@ -668,9 +764,29 @@
#
# This field is only applicable with use_ip_aliases is true and
# create_subnetwork is false.
+ "createSubnetwork": True or False, # Whether a new subnetwork will be created automatically for the cluster.
+ #
+ # This field is only applicable when `use_ip_aliases` is true.
"subnetworkName": "A String", # A custom subnetwork name to be used if `create_subnetwork` is true. If
# this field is empty, then an automatic name will be chosen for the new
# subnetwork.
+ "clusterIpv4Cidr": "A String", # This field is deprecated, use cluster_ipv4_cidr_block.
+ "servicesIpv4Cidr": "A String", # This field is deprecated, use services_ipv4_cidr_block.
+ "servicesIpv4CidrBlock": "A String", # The IP address range of the services IPs in this cluster. If blank, a range
+ # will be automatically chosen with the default size.
+ #
+ # This field is only applicable when `use_ip_aliases` is true.
+ #
+ # Set to blank to have a range chosen with the default size.
+ #
+ # Set to /netmask (e.g. `/14`) to have a range chosen with a specific
+ # netmask.
+ #
+ # Set to a
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
+ # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
+ # to use.
},
"legacyAbac": { # Configuration for the legacy Attribute Based Access Control authorization # Configuration for the legacy ABAC authorization mode.
# mode.
@@ -707,15 +823,22 @@
# of Kubernetes labels applied to them, which may be used to reference them
# during pod scheduling. They may also be resized up or down, to accommodate
# the workload.
+ "statusMessage": "A String", # [Output only] Additional information about the current status of this
+ # node pool instance, if available.
+ "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.
+ "maxNodeCount": 42, # Maximum number of nodes in the NodePool. Must be >= min_node_count. There
+ # has to enough quota to scale up the cluster.
+ "autoprovisioned": True or False, # Can this node pool be deleted automatically.
+ "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.
+ },
"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.
- "locations": [ # The list of Google Compute Engine
- # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
- # NodePool's nodes should be located.
- "A String",
- ],
"selfLink": "A String", # [Output only] Server-defined URL for the resource.
"upgradeSettings": { # These upgrade settings control the level of parallelism and the level of # Upgrade settings control disruption and speed of the upgrade.
# disruption caused by an upgrade.
@@ -746,6 +869,11 @@
"maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
# of the node pool during the upgrade process.
},
+ "locations": [ # The list of Google Compute Engine
+ # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
+ # NodePool's nodes should be located.
+ "A String",
+ ],
"instanceGroupUrls": [ # [Output only] The resource URLs of the [managed instance
# groups](https://cloud.google.com/compute/docs/instance-groups/creating-groups-of-managed-instances)
# associated with this node pool.
@@ -756,23 +884,12 @@
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"status": "A String", # [Output only] The status of the nodes in this pool instance.
"config": { # Parameters that describe the nodes in a cluster. # The node configuration of the pool.
- "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
- # valid sources or targets for network firewalls and are specified by
- # the client during cluster or node pool creation. Each tag within the list
- # must comply with RFC1035.
- "A String",
- ],
- "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
- # Specify the email address of the Service Account; otherwise, if no Service
- # Account is specified, the "default" service account is used.
- "imageType": "A String", # The image type to use for this node. Note that for a given image type,
- # the latest version of it will be used.
"oauthScopes": [ # The set of Google API scopes to be made available on all of the
# node VMs under the "default" service account.
#
@@ -800,9 +917,9 @@
# See
# [here](https://kubernetes.io/docs/concepts/configuration/taint-and-toleration)
# for more information, including usage and the valid values.
- "key": "A String", # Key for taint.
- "value": "A String", # Value for taint.
"effect": "A String", # Effect for taint.
+ "value": "A String", # Value for taint.
+ "key": "A String", # Key for taint.
},
],
"labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
@@ -828,9 +945,9 @@
# 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](https://cloud.google.com/compute/docs/gpus)
+ "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
},
],
"machineType": "A String", # The name of a Google Compute Engine [machine
@@ -843,17 +960,17 @@
#
# If unspecified, the default disk type is 'pd-standard'
"shieldedInstanceConfig": { # A set of Shielded Instance options. # Shielded Instance options.
- "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.
- #
- # Secure Boot helps ensure that the system only runs authentic software by
- # verifying the digital signature of all boot components, and halting the
- # boot process if signature verification fails.
"enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.
#
# Enables monitoring and attestation of the boot integrity of the instance.
# The attestation is performed against the integrity policy baseline. This
# baseline is initially derived from the implicitly trusted boot image when
# the instance is created.
+ "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.
+ #
+ # Secure Boot helps ensure that the system only runs authentic software by
+ # verifying the digital signature of all boot components, and halting the
+ # boot process if signature verification fails.
},
"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
@@ -914,14 +1031,25 @@
# to this node pool.
# is the configuration of desired reservation which instances could take
# capacity from.
- "key": "A String", # Corresponds to the label key of a reservation resource. To target a
- # SPECIFIC_RESERVATION by name, specify "googleapis.com/reservation-name" as
- # the key and specify the name of your reservation as its value.
"values": [ # Corresponds to the label value(s) of reservation resource(s).
"A String",
],
"consumeReservationType": "A String", # Corresponds to the type of reservation consumption.
+ "key": "A String", # Corresponds to the label key of a reservation resource. To target a
+ # SPECIFIC_RESERVATION by name, specify "googleapis.com/reservation-name" as
+ # the key and specify the name of your reservation as its value.
},
+ "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
+ # valid sources or targets for network firewalls and are specified by
+ # the client during cluster or node pool creation. Each tag within the list
+ # must comply with RFC1035.
+ "A String",
+ ],
+ "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
+ # Specify the email address of the Service Account; otherwise, if no Service
+ # Account is specified, the "default" service account is used.
+ "imageType": "A String", # The image type to use for this node. Note that for a given image type,
+ # the latest version of it will be used.
},
"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.
@@ -932,31 +1060,19 @@
# node pool.
"upgradeOptions": { # AutoUpgradeOptions defines the set of options for the user to control how # Specifies the Auto Upgrade knobs for the node pool.
# the Auto Upgrades will proceed.
- "description": "A String", # [Output only] This field is set when upgrades are about to commence
- # with the description of the upgrade.
"autoUpgradeStartTime": "A String", # [Output only] This field is set when upgrades are about to commence
# with the approximate start time for the upgrades, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "description": "A String", # [Output only] This field is set when upgrades are about to commence
+ # with the description of the upgrade.
},
- "autoUpgrade": True or False, # A flag that specifies whether node auto-upgrade is enabled for the node
- # pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
- # up to date with the latest release version of Kubernetes.
"autoRepair": True or False, # A flag that specifies whether the node auto-repair is enabled for the node
# pool. If enabled, the nodes in this node pool will be monitored and, if
# they fail health checks too many times, an automatic repair action will be
# triggered.
- },
- "statusMessage": "A String", # [Output only] Additional information about the current status of this
- # node pool instance, if available.
- "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.
- "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.
- "minNodeCount": 42, # Minimum number of nodes in the NodePool. Must be >= 1 and <=
- # max_node_count.
- "autoprovisioned": True or False, # Can this node pool be deleted automatically.
+ "autoUpgrade": True or False, # A flag that specifies whether node auto-upgrade is enabled for the node
+ # pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
+ # up to date with the latest release version of Kubernetes.
},
},
],
@@ -981,8 +1097,8 @@
"conditions": [ # 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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"currentNodeCount": 42, # [Output only] The number of nodes currently in the cluster. Deprecated.
@@ -1042,17 +1158,6 @@
#
# If unspecified, the defaults are used.
# This field is deprecated, use node_pool.config instead.
- "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
- # valid sources or targets for network firewalls and are specified by
- # the client during cluster or node pool creation. Each tag within the list
- # must comply with RFC1035.
- "A String",
- ],
- "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
- # Specify the email address of the Service Account; otherwise, if no Service
- # Account is specified, the "default" service account is used.
- "imageType": "A String", # The image type to use for this node. Note that for a given image type,
- # the latest version of it will be used.
"oauthScopes": [ # The set of Google API scopes to be made available on all of the
# node VMs under the "default" service account.
#
@@ -1080,9 +1185,9 @@
# See
# [here](https://kubernetes.io/docs/concepts/configuration/taint-and-toleration)
# for more information, including usage and the valid values.
- "key": "A String", # Key for taint.
- "value": "A String", # Value for taint.
"effect": "A String", # Effect for taint.
+ "value": "A String", # Value for taint.
+ "key": "A String", # Key for taint.
},
],
"labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
@@ -1108,9 +1213,9 @@
# 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](https://cloud.google.com/compute/docs/gpus)
+ "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
},
],
"machineType": "A String", # The name of a Google Compute Engine [machine
@@ -1123,17 +1228,17 @@
#
# If unspecified, the default disk type is 'pd-standard'
"shieldedInstanceConfig": { # A set of Shielded Instance options. # Shielded Instance options.
- "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.
- #
- # Secure Boot helps ensure that the system only runs authentic software by
- # verifying the digital signature of all boot components, and halting the
- # boot process if signature verification fails.
"enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.
#
# Enables monitoring and attestation of the boot integrity of the instance.
# The attestation is performed against the integrity policy baseline. This
# baseline is initially derived from the implicitly trusted boot image when
# the instance is created.
+ "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.
+ #
+ # Secure Boot helps ensure that the system only runs authentic software by
+ # verifying the digital signature of all boot components, and halting the
+ # boot process if signature verification fails.
},
"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
@@ -1194,17 +1299,30 @@
# to this node pool.
# is the configuration of desired reservation which instances could take
# capacity from.
- "key": "A String", # Corresponds to the label key of a reservation resource. To target a
- # SPECIFIC_RESERVATION by name, specify "googleapis.com/reservation-name" as
- # the key and specify the name of your reservation as its value.
"values": [ # Corresponds to the label value(s) of reservation resource(s).
"A String",
],
"consumeReservationType": "A String", # Corresponds to the type of reservation consumption.
+ "key": "A String", # Corresponds to the label key of a reservation resource. To target a
+ # SPECIFIC_RESERVATION by name, specify "googleapis.com/reservation-name" as
+ # the key and specify the name of your reservation as its value.
},
+ "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
+ # valid sources or targets for network firewalls and are specified by
+ # the client during cluster or node pool creation. Each tag within the list
+ # must comply with RFC1035.
+ "A String",
+ ],
+ "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
+ # Specify the email address of the Service Account; otherwise, if no Service
+ # Account is specified, the "default" service account is used.
+ "imageType": "A String", # The image type to use for this node. Note that for a given image type,
+ # the latest version of it will be used.
},
"status": "A String", # [Output only] The current status of this cluster.
"networkConfig": { # NetworkConfig reports the relative names of network & subnetwork. # Configuration for cluster networking.
+ "enableIntraNodeVisibility": True or False, # Whether Intra-node visibility is enabled for this cluster.
+ # This makes same node pod to pod traffic visible for VPC network.
"subnetwork": "A String", # Output only. The relative name of the Google Compute Engine
# [subnetwork](https://cloud.google.com/compute/docs/vpc) to which the
# cluster is connected. Example:
@@ -1213,8 +1331,6 @@
# network(https://cloud.google.com/compute/docs/networks-and-firewalls#networks)
# to which the cluster is connected. Example:
# projects/my-project/global/networks/my-network
- "enableIntraNodeVisibility": True or False, # Whether Intra-node visibility is enabled for this cluster.
- # This makes same node pod to pod traffic visible for VPC network.
},
"name": "A String", # The name of this cluster. The name must be unique within this project
# and location (e.g. zone or region), and can be up to 40 characters with
@@ -1234,130 +1350,14 @@
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
- "createTime": "A String", # [Output only] The time the cluster was created, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "clusterIpv4Cidr": "A String", # The IP address range of the container pods in this cluster, in
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `10.96.0.0/14`). Leave blank to have
- # one automatically chosen or specify a `/14` block in `10.0.0.0/8`.
- "autoscaling": { # ClusterAutoscaling contains global, per-cluster information # Cluster-level autoscaling configuration.
- # required by Cluster Autoscaler to automatically adjust
- # the size of the cluster and create/delete
- # node pools based on the current needs.
- "autoprovisioningLocations": [ # The list of Google Compute Engine
- # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
- # NodePool's nodes can be created by NAP.
- "A String",
- ],
- "resourceLimits": [ # Contains global constraints regarding minimum and maximum
- # amount of resources in the cluster.
- { # Contains information about amount of some resource in the cluster.
- # For memory, value should be in GB.
- "maximum": "A String", # Maximum amount of the resource in the cluster.
- "resourceType": "A String", # Resource name "cpu", "memory" or gpu-specific string.
- "minimum": "A String", # Minimum amount of the resource in the cluster.
- },
- ],
- "enableNodeAutoprovisioning": True or False, # Enables automatic node pool creation and deletion.
- "autoprovisioningNodePoolDefaults": { # AutoprovisioningNodePoolDefaults contains defaults for a node pool created # AutoprovisioningNodePoolDefaults contains defaults for a node pool
- # created by NAP.
- # by NAP.
- "oauthScopes": [ # Scopes that are used by NAP when creating node pools. If oauth_scopes are
- # specified, service_account should be empty.
- "A String",
- ],
- "management": { # NodeManagement defines the set of node management services turned on for the # Specifies the node management options for NAP created node-pools.
- # node pool.
- "upgradeOptions": { # AutoUpgradeOptions defines the set of options for the user to control how # Specifies the Auto Upgrade knobs for the node pool.
- # the Auto Upgrades will proceed.
- "description": "A String", # [Output only] This field is set when upgrades are about to commence
- # with the description of the upgrade.
- "autoUpgradeStartTime": "A String", # [Output only] This field is set when upgrades are about to commence
- # with the approximate start time for the upgrades, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- },
- "autoUpgrade": True or False, # A flag that specifies whether node auto-upgrade is enabled for the node
- # pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
- # up to date with the latest release version of Kubernetes.
- "autoRepair": True or False, # A flag that specifies whether the node auto-repair is enabled for the node
- # pool. If enabled, the nodes in this node pool will be monitored and, if
- # they fail health checks too many times, an automatic repair action will be
- # triggered.
- },
- "upgradeSettings": { # These upgrade settings control the level of parallelism and the level of # Specifies the upgrade settings for NAP created node pools
- # disruption caused by an upgrade.
- #
- # maxUnavailable controls the number of nodes that can be simultaneously
- # unavailable.
- #
- # maxSurge controls the number of additional nodes that can be added to the
- # node pool temporarily for the time of the upgrade to increase the number of
- # available nodes.
- #
- # (maxUnavailable + maxSurge) determines the level of parallelism (how many
- # nodes are being upgraded at the same time).
- #
- # Note: upgrades inevitably introduce some disruption since workloads need to
- # be moved from old nodes to new, upgraded ones. Even if maxUnavailable=0,
- # this holds true. (Disruption stays within the limits of
- # PodDisruptionBudget, if it is configured.)
- #
- # Consider a hypothetical node pool with 5 nodes having maxSurge=2,
- # maxUnavailable=1. This means the upgrade process upgrades 3 nodes
- # simultaneously. It creates 2 additional (upgraded) nodes, then it brings
- # down 3 old (not yet upgraded) nodes at the same time. This ensures that
- # there are always at least 4 nodes available.
- "maxUnavailable": 42, # The maximum number of nodes that can be simultaneously unavailable during
- # the upgrade process. A node is considered available if its status is
- # Ready.
- "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
- # of the node pool during the upgrade process.
- },
- "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs. If
- # service_account is specified, scopes should be empty.
- },
- },
- "initialNodeCount": 42, # The number of nodes to create in this cluster. 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.
- # For requests, this field should only be used in lieu of a
- # "node_pool" object, since this configuration (along with the
- # "node_config") will be used to create a "NodePool" object with an
- # auto-generated name. Do not use this and a node_pool at the same time.
- #
- # This field is deprecated, use node_pool.initial_node_count instead.
- "instanceGroupUrls": [ # Deprecated. Use node_pools.instance_group_urls.
- "A String",
- ],
- "privateClusterConfig": { # Configuration options for private clusters. # Configuration for private cluster.
- "peeringName": "A String", # Output only. The peering name in the customer VPC used by this cluster.
- "publicEndpoint": "A String", # Output only. The external IP address of this cluster's master endpoint.
- "enablePrivateNodes": True or False, # Whether nodes have internal IP addresses only. If enabled, all nodes are
- # given only RFC 1918 private addresses and communicate with the master via
- # private networking.
- "masterIpv4CidrBlock": "A String", # The IP range in CIDR notation to use for the hosted master network. This
- # range will be used for assigning internal IP addresses to the master or
- # set of masters, as well as the ILB VIP. This range must not overlap with
- # any other ranges in use within the cluster's network.
- "privateEndpoint": "A String", # Output only. The internal IP address of this cluster's master endpoint.
- "enablePrivateEndpoint": True or False, # Whether the master's internal IP address is used as the cluster endpoint.
- },
- "shieldedNodes": { # Configuration of Shielded Nodes feature. # Shielded Nodes configuration.
- "enabled": True or False, # Whether Shielded Nodes features are enabled on all nodes in this cluster.
- },
- "verticalPodAutoscaling": { # VerticalPodAutoscaling contains global, per-cluster information # Cluster-level Vertical Pod Autoscaling configuration.
- # required by Vertical Pod Autoscaler to automatically adjust
- # the resources of pods controlled by it.
- "enabled": True or False, # Enables vertical pod autoscaling.
- },
},
+ "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 parent field.
"zone": "A String", # Deprecated. The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/zones#available) in which the
# cluster resides. This field has been deprecated and replaced by the parent
# field.
- "parent": "A String", # The parent (project and location) where the cluster will be created.
- # Specified in the format `projects/*/locations/*`.
}
x__xgafv: string, V1 error format.
@@ -1370,12 +1370,50 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
+ "name": "A String", # A non-parameterized string describing an operation stage.
+ # Unset for single-stage operations.
+ "stages": [ # Substages of an operation or a stage.
+ # Object with schema name: OperationProgress
+ ],
+ "metrics": [ # Progress metric bundle, for example:
+ # metrics: [{name: "nodes done", int_value: 15},
+ # {name: "nodes total", int_value: 32}]
+ # or
+ # metrics: [{name: "progress", double_value: 0.56},
+ # {name: "progress scale", double_value: 1.0}]
+ { # Progress metric is (string, int|float|string) pair.
+ "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
+ "doubleValue": 3.14, # For metrics with floating point value.
+ "intValue": "A String", # For metrics with integer value.
+ "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
+ },
+ ],
+ "status": "A String", # Status of an operation stage.
+ # Unset for single-stage operations.
+ },
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # operation is taking place. This field is deprecated, use location instead.
+ "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
+ "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.
+ "status": "A String", # The current status of the operation.
"name": "A String", # The server-assigned ID for the operation.
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"endTime": "A String", # [Output only] The time the operation completed, in
@@ -1387,44 +1425,6 @@
# in which the cluster resides.
"startTime": "A String", # [Output only] The time the operation started, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "status": "A String", # Status of an operation stage.
- # Unset for single-stage operations.
- "metrics": [ # Progress metric bundle, for example:
- # metrics: [{name: "nodes done", int_value: 15},
- # {name: "nodes total", int_value: 32}]
- # or
- # metrics: [{name: "progress", double_value: 0.56},
- # {name: "progress scale", double_value: 1.0}]
- { # Progress metric is (string, int|float|string) pair.
- "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- "intValue": "A String", # For metrics with integer value.
- },
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "zone": "A String", # The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # operation is taking place. This field is deprecated, use location instead.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "selfLink": "A String", # Server-defined URL for the resource.
- "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.
- "status": "A String", # The current status of the operation.
}</pre>
</div>
@@ -1462,12 +1462,50 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
+ "name": "A String", # A non-parameterized string describing an operation stage.
+ # Unset for single-stage operations.
+ "stages": [ # Substages of an operation or a stage.
+ # Object with schema name: OperationProgress
+ ],
+ "metrics": [ # Progress metric bundle, for example:
+ # metrics: [{name: "nodes done", int_value: 15},
+ # {name: "nodes total", int_value: 32}]
+ # or
+ # metrics: [{name: "progress", double_value: 0.56},
+ # {name: "progress scale", double_value: 1.0}]
+ { # Progress metric is (string, int|float|string) pair.
+ "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
+ "doubleValue": 3.14, # For metrics with floating point value.
+ "intValue": "A String", # For metrics with integer value.
+ "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
+ },
+ ],
+ "status": "A String", # Status of an operation stage.
+ # Unset for single-stage operations.
+ },
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # operation is taking place. This field is deprecated, use location instead.
+ "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
+ "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.
+ "status": "A String", # The current status of the operation.
"name": "A String", # The server-assigned ID for the operation.
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"endTime": "A String", # [Output only] The time the operation completed, in
@@ -1479,44 +1517,6 @@
# in which the cluster resides.
"startTime": "A String", # [Output only] The time the operation started, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "status": "A String", # Status of an operation stage.
- # Unset for single-stage operations.
- "metrics": [ # Progress metric bundle, for example:
- # metrics: [{name: "nodes done", int_value: 15},
- # {name: "nodes total", int_value: 32}]
- # or
- # metrics: [{name: "progress", double_value: 0.56},
- # {name: "progress scale", double_value: 1.0}]
- { # Progress metric is (string, int|float|string) pair.
- "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- "intValue": "A String", # For metrics with integer value.
- },
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "zone": "A String", # The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # operation is taking place. This field is deprecated, use location instead.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "selfLink": "A String", # Server-defined URL for the resource.
- "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.
- "status": "A String", # The current status of the operation.
}</pre>
</div>
@@ -1545,6 +1545,123 @@
An object of the form:
{ # A Google Kubernetes Engine cluster.
+ "createTime": "A String", # [Output only] The time the cluster was created, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "clusterIpv4Cidr": "A String", # The IP address range of the container pods in this cluster, in
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `10.96.0.0/14`). Leave blank to have
+ # one automatically chosen or specify a `/14` block in `10.0.0.0/8`.
+ "autoscaling": { # ClusterAutoscaling contains global, per-cluster information # Cluster-level autoscaling configuration.
+ # required by Cluster Autoscaler to automatically adjust
+ # the size of the cluster and create/delete
+ # node pools based on the current needs.
+ "autoprovisioningLocations": [ # The list of Google Compute Engine
+ # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
+ # NodePool's nodes can be created by NAP.
+ "A String",
+ ],
+ "resourceLimits": [ # Contains global constraints regarding minimum and maximum
+ # amount of resources in the cluster.
+ { # Contains information about amount of some resource in the cluster.
+ # For memory, value should be in GB.
+ "minimum": "A String", # Minimum amount of the resource in the cluster.
+ "maximum": "A String", # Maximum amount of the resource in the cluster.
+ "resourceType": "A String", # Resource name "cpu", "memory" or gpu-specific string.
+ },
+ ],
+ "enableNodeAutoprovisioning": True or False, # Enables automatic node pool creation and deletion.
+ "autoprovisioningNodePoolDefaults": { # AutoprovisioningNodePoolDefaults contains defaults for a node pool created # AutoprovisioningNodePoolDefaults contains defaults for a node pool
+ # created by NAP.
+ # by NAP.
+ "management": { # NodeManagement defines the set of node management services turned on for the # Specifies the node management options for NAP created node-pools.
+ # node pool.
+ "upgradeOptions": { # AutoUpgradeOptions defines the set of options for the user to control how # Specifies the Auto Upgrade knobs for the node pool.
+ # the Auto Upgrades will proceed.
+ "autoUpgradeStartTime": "A String", # [Output only] This field is set when upgrades are about to commence
+ # with the approximate start time for the upgrades, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "description": "A String", # [Output only] This field is set when upgrades are about to commence
+ # with the description of the upgrade.
+ },
+ "autoRepair": True or False, # A flag that specifies whether the node auto-repair is enabled for the node
+ # pool. If enabled, the nodes in this node pool will be monitored and, if
+ # they fail health checks too many times, an automatic repair action will be
+ # triggered.
+ "autoUpgrade": True or False, # A flag that specifies whether node auto-upgrade is enabled for the node
+ # pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
+ # up to date with the latest release version of Kubernetes.
+ },
+ "oauthScopes": [ # Scopes that are used by NAP when creating node pools. If oauth_scopes are
+ # specified, service_account should be empty.
+ "A String",
+ ],
+ "upgradeSettings": { # These upgrade settings control the level of parallelism and the level of # Specifies the upgrade settings for NAP created node pools
+ # disruption caused by an upgrade.
+ #
+ # maxUnavailable controls the number of nodes that can be simultaneously
+ # unavailable.
+ #
+ # maxSurge controls the number of additional nodes that can be added to the
+ # node pool temporarily for the time of the upgrade to increase the number of
+ # available nodes.
+ #
+ # (maxUnavailable + maxSurge) determines the level of parallelism (how many
+ # nodes are being upgraded at the same time).
+ #
+ # Note: upgrades inevitably introduce some disruption since workloads need to
+ # be moved from old nodes to new, upgraded ones. Even if maxUnavailable=0,
+ # this holds true. (Disruption stays within the limits of
+ # PodDisruptionBudget, if it is configured.)
+ #
+ # Consider a hypothetical node pool with 5 nodes having maxSurge=2,
+ # maxUnavailable=1. This means the upgrade process upgrades 3 nodes
+ # simultaneously. It creates 2 additional (upgraded) nodes, then it brings
+ # down 3 old (not yet upgraded) nodes at the same time. This ensures that
+ # there are always at least 4 nodes available.
+ "maxUnavailable": 42, # The maximum number of nodes that can be simultaneously unavailable during
+ # the upgrade process. A node is considered available if its status is
+ # Ready.
+ "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
+ # of the node pool during the upgrade process.
+ },
+ "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs. If
+ # service_account is specified, scopes should be empty.
+ },
+ },
+ "initialNodeCount": 42, # The number of nodes to create in this cluster. 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.
+ # For requests, this field should only be used in lieu of a
+ # "node_pool" object, since this configuration (along with the
+ # "node_config") will be used to create a "NodePool" object with an
+ # auto-generated name. Do not use this and a node_pool at the same time.
+ #
+ # This field is deprecated, use node_pool.initial_node_count instead.
+ "instanceGroupUrls": [ # Deprecated. Use node_pools.instance_group_urls.
+ "A String",
+ ],
+ "privateClusterConfig": { # Configuration options for private clusters. # Configuration for private cluster.
+ "masterIpv4CidrBlock": "A String", # The IP range in CIDR notation to use for the hosted master network. This
+ # range will be used for assigning internal IP addresses to the master or
+ # set of masters, as well as the ILB VIP. This range must not overlap with
+ # any other ranges in use within the cluster's network.
+ "enablePrivateNodes": True or False, # Whether nodes have internal IP addresses only. If enabled, all nodes are
+ # given only RFC 1918 private addresses and communicate with the master via
+ # private networking.
+ "privateEndpoint": "A String", # Output only. The internal IP address of this cluster's master endpoint.
+ "enablePrivateEndpoint": True or False, # Whether the master's internal IP address is used as the cluster endpoint.
+ "peeringName": "A String", # Output only. The peering name in the customer VPC used by this cluster.
+ "publicEndpoint": "A String", # Output only. The external IP address of this cluster's master endpoint.
+ },
+ "shieldedNodes": { # Configuration of Shielded Nodes feature. # Shielded Nodes configuration.
+ "enabled": True or False, # Whether Shielded Nodes features are enabled on all nodes in this cluster.
+ },
+ "verticalPodAutoscaling": { # VerticalPodAutoscaling contains global, per-cluster information # Cluster-level Vertical Pod Autoscaling configuration.
+ # required by Vertical Pod Autoscaler to automatically adjust
+ # the resources of pods controlled by it.
+ "enabled": True or False, # Enables vertical pod autoscaling.
+ },
"defaultMaxPodsConstraint": { # Constraints applied to pods. # The default constraint on the maximum number of pods that can be run
# simultaneously on a node in the node pool of this cluster. Only honored
# if cluster created with IP Alias support.
@@ -1563,7 +1680,6 @@
# master authorized networks will disallow all external traffic to access
# Kubernetes master through HTTPS except traffic from the given CIDR blocks,
# Google Compute Engine Public IPs and Google Prod IPs.
- "enabled": True or False, # Whether or not master authorized networks is enabled.
"cidrBlocks": [ # cidr_blocks define up to 50 external networks that could access
# Kubernetes master through HTTPS.
{ # CidrBlock contains an optional name and one CIDR block.
@@ -1571,6 +1687,7 @@
"cidrBlock": "A String", # cidr_block must be specified in CIDR notation.
},
],
+ "enabled": True or False, # Whether or not master authorized networks is enabled.
},
"statusMessage": "A String", # [Output only] Additional information about the current status of this
# cluster, if available.
@@ -1581,13 +1698,6 @@
# certificate will be issued.
# Authentication can be done using HTTP basic auth or using client
# certificates.
- "clusterCaCertificate": "A String", # [Output only] Base64-encoded public certificate that is the root of
- # trust for the cluster.
- "clientCertificate": "A String", # [Output only] Base64-encoded public certificate used by clients to
- # authenticate to the cluster endpoint.
- "username": "A String", # The username to use for HTTP basic authentication to the master endpoint.
- # For clusters v1.6.0 and later, basic authentication can be disabled by
- # leaving username unspecified (or setting it to the empty string).
"password": "A String", # The password to use for HTTP basic authentication to the master endpoint.
# Because the master endpoint is open to the Internet, you should create a
# strong password. If a password is provided for cluster creation, username
@@ -1599,6 +1709,13 @@
},
"clientKey": "A String", # [Output only] Base64-encoded private key used by clients to authenticate
# to the cluster endpoint.
+ "clusterCaCertificate": "A String", # [Output only] Base64-encoded public certificate that is the root of
+ # trust for the cluster.
+ "clientCertificate": "A String", # [Output only] Base64-encoded public certificate used by clients to
+ # authenticate to the cluster endpoint.
+ "username": "A String", # The username to use for HTTP basic authentication to the master endpoint.
+ # For clusters v1.6.0 and later, basic authentication can be disabled by
+ # leaving username unspecified (or setting it to the empty string).
},
"authenticatorGroupsConfig": { # Configuration for returning group information from authenticators. # Configuration controlling RBAC group membership information.
"enabled": True or False, # Whether this cluster should return group membership lookups
@@ -1658,18 +1775,22 @@
},
"maintenancePolicy": { # MaintenancePolicy defines the maintenance policy to be used for the cluster. # Configure the maintenance policy for this cluster.
"window": { # MaintenanceWindow defines the maintenance window to be used for the cluster. # Specifies the maintenance window in which maintenance may be performed.
- "dailyMaintenanceWindow": { # Time window specified for daily maintenance operations. # DailyMaintenanceWindow specifies a daily maintenance operation window.
- "duration": "A String", # [Output only] Duration of the time window, automatically chosen to be
- # smallest possible in the given scenario.
- # Duration will be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
- # format "PTnHnMnS".
- "startTime": "A String", # Time within the maintenance window to start the maintenance operations.
- # Time format should be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
- # format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
+ "maintenanceExclusions": { # Exceptions to maintenance window. Non-emergency maintenance should not
+ # occur in these windows.
+ "a_key": { # Represents an arbitrary window of time.
+ "endTime": "A String", # The time that the window ends. The end time should take place after the
+ # start time.
+ "startTime": "A String", # The time that the window first starts.
+ },
},
"recurringWindow": { # Represents an arbitrary window of time that recurs. # RecurringWindow specifies some number of recurring time periods for
# maintenance to occur. The time windows may be overlapping. If no
# maintenance windows are set, maintenance can occur at any time.
+ "window": { # Represents an arbitrary window of time. # The window of the first recurrence.
+ "endTime": "A String", # The time that the window ends. The end time should take place after the
+ # start time.
+ "startTime": "A String", # The time that the window first starts.
+ },
"recurrence": "A String", # An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how
# this window reccurs. They go on for the span of time between the start and
# end time.
@@ -1697,19 +1818,15 @@
# Note the start and end time's specific dates are largely arbitrary except
# to specify duration of the window and when it first starts.
# The FREQ values of HOURLY, MINUTELY, and SECONDLY are not supported.
- "window": { # Represents an arbitrary window of time. # The window of the first recurrence.
- "endTime": "A String", # The time that the window ends. The end time should take place after the
- # start time.
- "startTime": "A String", # The time that the window first starts.
- },
},
- "maintenanceExclusions": { # Exceptions to maintenance window. Non-emergency maintenance should not
- # occur in these windows.
- "a_key": { # Represents an arbitrary window of time.
- "endTime": "A String", # The time that the window ends. The end time should take place after the
- # start time.
- "startTime": "A String", # The time that the window first starts.
- },
+ "dailyMaintenanceWindow": { # Time window specified for daily maintenance operations. # DailyMaintenanceWindow specifies a daily maintenance operation window.
+ "startTime": "A String", # Time within the maintenance window to start the maintenance operations.
+ # Time format should be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
+ # format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
+ "duration": "A String", # [Output only] Duration of the time window, automatically chosen to be
+ # smallest possible in the given scenario.
+ # Duration will be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
+ # format "PTnHnMnS".
},
},
"resourceVersion": "A String", # A hash identifying the version of this policy, so that updates to fields of
@@ -1732,24 +1849,14 @@
# - "1.X.Y-gke.N": picks an explicit Kubernetes version
# - "","-": picks the default Kubernetes version
"ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the cluster. # Configuration for cluster IP allocation.
- "clusterIpv4Cidr": "A String", # This field is deprecated, use cluster_ipv4_cidr_block.
- "servicesIpv4Cidr": "A String", # This field is deprecated, use services_ipv4_cidr_block.
- "servicesIpv4CidrBlock": "A String", # The IP address range of the services IPs in this cluster. If blank, a range
- # will be automatically chosen with the default size.
- #
- # This field is only applicable when `use_ip_aliases` is true.
- #
- # Set to blank to have a range chosen with the default size.
- #
- # Set to /netmask (e.g. `/14`) to have a range chosen with a specific
- # netmask.
- #
- # Set to a
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
- # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
- # to use.
"nodeIpv4Cidr": "A String", # This field is deprecated, use node_ipv4_cidr_block.
+ "clusterSecondaryRangeName": "A String", # The name of the secondary range to be used for the cluster CIDR
+ # block. The secondary range will be used for pod IP
+ # addresses. This must be an existing secondary range associated
+ # with the cluster subnetwork.
+ #
+ # This field is only applicable with use_ip_aliases is true and
+ # create_subnetwork is false.
"clusterIpv4CidrBlock": "A String", # The IP address range for the cluster pod IPs. If this field is set, then
# `cluster.cluster_ipv4_cidr` must be left blank.
#
@@ -1765,13 +1872,6 @@
# notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
# `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
# to use.
- "clusterSecondaryRangeName": "A String", # The name of the secondary range to be used for the cluster CIDR
- # block. The secondary range will be used for pod IP
- # addresses. This must be an existing secondary range associated
- # with the cluster subnetwork.
- #
- # This field is only applicable with use_ip_aliases is true and
- # create_subnetwork is false.
"nodeIpv4CidrBlock": "A String", # The IP address range of the instance IPs in this cluster.
#
# This is applicable only if `create_subnetwork` is true.
@@ -1801,9 +1901,6 @@
# notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
# `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
# to use.
- "createSubnetwork": True or False, # Whether a new subnetwork will be created automatically for the cluster.
- #
- # This field is only applicable when `use_ip_aliases` is true.
"useIpAliases": True or False, # Whether alias IPs will be used for pod IPs in the cluster.
"servicesSecondaryRangeName": "A String", # The name of the secondary range to be used as for the services
# CIDR block. The secondary range will be used for service
@@ -1812,9 +1909,29 @@
#
# This field is only applicable with use_ip_aliases is true and
# create_subnetwork is false.
+ "createSubnetwork": True or False, # Whether a new subnetwork will be created automatically for the cluster.
+ #
+ # This field is only applicable when `use_ip_aliases` is true.
"subnetworkName": "A String", # A custom subnetwork name to be used if `create_subnetwork` is true. If
# this field is empty, then an automatic name will be chosen for the new
# subnetwork.
+ "clusterIpv4Cidr": "A String", # This field is deprecated, use cluster_ipv4_cidr_block.
+ "servicesIpv4Cidr": "A String", # This field is deprecated, use services_ipv4_cidr_block.
+ "servicesIpv4CidrBlock": "A String", # The IP address range of the services IPs in this cluster. If blank, a range
+ # will be automatically chosen with the default size.
+ #
+ # This field is only applicable when `use_ip_aliases` is true.
+ #
+ # Set to blank to have a range chosen with the default size.
+ #
+ # Set to /netmask (e.g. `/14`) to have a range chosen with a specific
+ # netmask.
+ #
+ # Set to a
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
+ # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
+ # to use.
},
"legacyAbac": { # Configuration for the legacy Attribute Based Access Control authorization # Configuration for the legacy ABAC authorization mode.
# mode.
@@ -1851,15 +1968,22 @@
# of Kubernetes labels applied to them, which may be used to reference them
# during pod scheduling. They may also be resized up or down, to accommodate
# the workload.
+ "statusMessage": "A String", # [Output only] Additional information about the current status of this
+ # node pool instance, if available.
+ "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.
+ "maxNodeCount": 42, # Maximum number of nodes in the NodePool. Must be >= min_node_count. There
+ # has to enough quota to scale up the cluster.
+ "autoprovisioned": True or False, # Can this node pool be deleted automatically.
+ "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.
+ },
"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.
- "locations": [ # The list of Google Compute Engine
- # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
- # NodePool's nodes should be located.
- "A String",
- ],
"selfLink": "A String", # [Output only] Server-defined URL for the resource.
"upgradeSettings": { # These upgrade settings control the level of parallelism and the level of # Upgrade settings control disruption and speed of the upgrade.
# disruption caused by an upgrade.
@@ -1890,6 +2014,11 @@
"maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
# of the node pool during the upgrade process.
},
+ "locations": [ # The list of Google Compute Engine
+ # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
+ # NodePool's nodes should be located.
+ "A String",
+ ],
"instanceGroupUrls": [ # [Output only] The resource URLs of the [managed instance
# groups](https://cloud.google.com/compute/docs/instance-groups/creating-groups-of-managed-instances)
# associated with this node pool.
@@ -1900,23 +2029,12 @@
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"status": "A String", # [Output only] The status of the nodes in this pool instance.
"config": { # Parameters that describe the nodes in a cluster. # The node configuration of the pool.
- "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
- # valid sources or targets for network firewalls and are specified by
- # the client during cluster or node pool creation. Each tag within the list
- # must comply with RFC1035.
- "A String",
- ],
- "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
- # Specify the email address of the Service Account; otherwise, if no Service
- # Account is specified, the "default" service account is used.
- "imageType": "A String", # The image type to use for this node. Note that for a given image type,
- # the latest version of it will be used.
"oauthScopes": [ # The set of Google API scopes to be made available on all of the
# node VMs under the "default" service account.
#
@@ -1944,9 +2062,9 @@
# See
# [here](https://kubernetes.io/docs/concepts/configuration/taint-and-toleration)
# for more information, including usage and the valid values.
- "key": "A String", # Key for taint.
- "value": "A String", # Value for taint.
"effect": "A String", # Effect for taint.
+ "value": "A String", # Value for taint.
+ "key": "A String", # Key for taint.
},
],
"labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
@@ -1972,9 +2090,9 @@
# 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](https://cloud.google.com/compute/docs/gpus)
+ "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
},
],
"machineType": "A String", # The name of a Google Compute Engine [machine
@@ -1987,17 +2105,17 @@
#
# If unspecified, the default disk type is 'pd-standard'
"shieldedInstanceConfig": { # A set of Shielded Instance options. # Shielded Instance options.
- "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.
- #
- # Secure Boot helps ensure that the system only runs authentic software by
- # verifying the digital signature of all boot components, and halting the
- # boot process if signature verification fails.
"enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.
#
# Enables monitoring and attestation of the boot integrity of the instance.
# The attestation is performed against the integrity policy baseline. This
# baseline is initially derived from the implicitly trusted boot image when
# the instance is created.
+ "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.
+ #
+ # Secure Boot helps ensure that the system only runs authentic software by
+ # verifying the digital signature of all boot components, and halting the
+ # boot process if signature verification fails.
},
"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
@@ -2058,14 +2176,25 @@
# to this node pool.
# is the configuration of desired reservation which instances could take
# capacity from.
- "key": "A String", # Corresponds to the label key of a reservation resource. To target a
- # SPECIFIC_RESERVATION by name, specify "googleapis.com/reservation-name" as
- # the key and specify the name of your reservation as its value.
"values": [ # Corresponds to the label value(s) of reservation resource(s).
"A String",
],
"consumeReservationType": "A String", # Corresponds to the type of reservation consumption.
+ "key": "A String", # Corresponds to the label key of a reservation resource. To target a
+ # SPECIFIC_RESERVATION by name, specify "googleapis.com/reservation-name" as
+ # the key and specify the name of your reservation as its value.
},
+ "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
+ # valid sources or targets for network firewalls and are specified by
+ # the client during cluster or node pool creation. Each tag within the list
+ # must comply with RFC1035.
+ "A String",
+ ],
+ "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
+ # Specify the email address of the Service Account; otherwise, if no Service
+ # Account is specified, the "default" service account is used.
+ "imageType": "A String", # The image type to use for this node. Note that for a given image type,
+ # the latest version of it will be used.
},
"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.
@@ -2076,31 +2205,19 @@
# node pool.
"upgradeOptions": { # AutoUpgradeOptions defines the set of options for the user to control how # Specifies the Auto Upgrade knobs for the node pool.
# the Auto Upgrades will proceed.
- "description": "A String", # [Output only] This field is set when upgrades are about to commence
- # with the description of the upgrade.
"autoUpgradeStartTime": "A String", # [Output only] This field is set when upgrades are about to commence
# with the approximate start time for the upgrades, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "description": "A String", # [Output only] This field is set when upgrades are about to commence
+ # with the description of the upgrade.
},
- "autoUpgrade": True or False, # A flag that specifies whether node auto-upgrade is enabled for the node
- # pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
- # up to date with the latest release version of Kubernetes.
"autoRepair": True or False, # A flag that specifies whether the node auto-repair is enabled for the node
# pool. If enabled, the nodes in this node pool will be monitored and, if
# they fail health checks too many times, an automatic repair action will be
# triggered.
- },
- "statusMessage": "A String", # [Output only] Additional information about the current status of this
- # node pool instance, if available.
- "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.
- "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.
- "minNodeCount": 42, # Minimum number of nodes in the NodePool. Must be >= 1 and <=
- # max_node_count.
- "autoprovisioned": True or False, # Can this node pool be deleted automatically.
+ "autoUpgrade": True or False, # A flag that specifies whether node auto-upgrade is enabled for the node
+ # pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
+ # up to date with the latest release version of Kubernetes.
},
},
],
@@ -2125,8 +2242,8 @@
"conditions": [ # 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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"currentNodeCount": 42, # [Output only] The number of nodes currently in the cluster. Deprecated.
@@ -2186,17 +2303,6 @@
#
# If unspecified, the defaults are used.
# This field is deprecated, use node_pool.config instead.
- "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
- # valid sources or targets for network firewalls and are specified by
- # the client during cluster or node pool creation. Each tag within the list
- # must comply with RFC1035.
- "A String",
- ],
- "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
- # Specify the email address of the Service Account; otherwise, if no Service
- # Account is specified, the "default" service account is used.
- "imageType": "A String", # The image type to use for this node. Note that for a given image type,
- # the latest version of it will be used.
"oauthScopes": [ # The set of Google API scopes to be made available on all of the
# node VMs under the "default" service account.
#
@@ -2224,9 +2330,9 @@
# See
# [here](https://kubernetes.io/docs/concepts/configuration/taint-and-toleration)
# for more information, including usage and the valid values.
- "key": "A String", # Key for taint.
- "value": "A String", # Value for taint.
"effect": "A String", # Effect for taint.
+ "value": "A String", # Value for taint.
+ "key": "A String", # Key for taint.
},
],
"labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
@@ -2252,9 +2358,9 @@
# 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](https://cloud.google.com/compute/docs/gpus)
+ "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
},
],
"machineType": "A String", # The name of a Google Compute Engine [machine
@@ -2267,17 +2373,17 @@
#
# If unspecified, the default disk type is 'pd-standard'
"shieldedInstanceConfig": { # A set of Shielded Instance options. # Shielded Instance options.
- "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.
- #
- # Secure Boot helps ensure that the system only runs authentic software by
- # verifying the digital signature of all boot components, and halting the
- # boot process if signature verification fails.
"enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.
#
# Enables monitoring and attestation of the boot integrity of the instance.
# The attestation is performed against the integrity policy baseline. This
# baseline is initially derived from the implicitly trusted boot image when
# the instance is created.
+ "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.
+ #
+ # Secure Boot helps ensure that the system only runs authentic software by
+ # verifying the digital signature of all boot components, and halting the
+ # boot process if signature verification fails.
},
"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
@@ -2338,17 +2444,30 @@
# to this node pool.
# is the configuration of desired reservation which instances could take
# capacity from.
- "key": "A String", # Corresponds to the label key of a reservation resource. To target a
- # SPECIFIC_RESERVATION by name, specify "googleapis.com/reservation-name" as
- # the key and specify the name of your reservation as its value.
"values": [ # Corresponds to the label value(s) of reservation resource(s).
"A String",
],
"consumeReservationType": "A String", # Corresponds to the type of reservation consumption.
+ "key": "A String", # Corresponds to the label key of a reservation resource. To target a
+ # SPECIFIC_RESERVATION by name, specify "googleapis.com/reservation-name" as
+ # the key and specify the name of your reservation as its value.
},
+ "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
+ # valid sources or targets for network firewalls and are specified by
+ # the client during cluster or node pool creation. Each tag within the list
+ # must comply with RFC1035.
+ "A String",
+ ],
+ "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
+ # Specify the email address of the Service Account; otherwise, if no Service
+ # Account is specified, the "default" service account is used.
+ "imageType": "A String", # The image type to use for this node. Note that for a given image type,
+ # the latest version of it will be used.
},
"status": "A String", # [Output only] The current status of this cluster.
"networkConfig": { # NetworkConfig reports the relative names of network & subnetwork. # Configuration for cluster networking.
+ "enableIntraNodeVisibility": True or False, # Whether Intra-node visibility is enabled for this cluster.
+ # This makes same node pod to pod traffic visible for VPC network.
"subnetwork": "A String", # Output only. The relative name of the Google Compute Engine
# [subnetwork](https://cloud.google.com/compute/docs/vpc) to which the
# cluster is connected. Example:
@@ -2357,8 +2476,6 @@
# network(https://cloud.google.com/compute/docs/networks-and-firewalls#networks)
# to which the cluster is connected. Example:
# projects/my-project/global/networks/my-network
- "enableIntraNodeVisibility": True or False, # Whether Intra-node visibility is enabled for this cluster.
- # This makes same node pod to pod traffic visible for VPC network.
},
"name": "A String", # The name of this cluster. The name must be unique within this project
# and location (e.g. zone or region), and can be up to 40 characters with
@@ -2378,123 +2495,6 @@
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
- "createTime": "A String", # [Output only] The time the cluster was created, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "clusterIpv4Cidr": "A String", # The IP address range of the container pods in this cluster, in
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `10.96.0.0/14`). Leave blank to have
- # one automatically chosen or specify a `/14` block in `10.0.0.0/8`.
- "autoscaling": { # ClusterAutoscaling contains global, per-cluster information # Cluster-level autoscaling configuration.
- # required by Cluster Autoscaler to automatically adjust
- # the size of the cluster and create/delete
- # node pools based on the current needs.
- "autoprovisioningLocations": [ # The list of Google Compute Engine
- # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
- # NodePool's nodes can be created by NAP.
- "A String",
- ],
- "resourceLimits": [ # Contains global constraints regarding minimum and maximum
- # amount of resources in the cluster.
- { # Contains information about amount of some resource in the cluster.
- # For memory, value should be in GB.
- "maximum": "A String", # Maximum amount of the resource in the cluster.
- "resourceType": "A String", # Resource name "cpu", "memory" or gpu-specific string.
- "minimum": "A String", # Minimum amount of the resource in the cluster.
- },
- ],
- "enableNodeAutoprovisioning": True or False, # Enables automatic node pool creation and deletion.
- "autoprovisioningNodePoolDefaults": { # AutoprovisioningNodePoolDefaults contains defaults for a node pool created # AutoprovisioningNodePoolDefaults contains defaults for a node pool
- # created by NAP.
- # by NAP.
- "oauthScopes": [ # Scopes that are used by NAP when creating node pools. If oauth_scopes are
- # specified, service_account should be empty.
- "A String",
- ],
- "management": { # NodeManagement defines the set of node management services turned on for the # Specifies the node management options for NAP created node-pools.
- # node pool.
- "upgradeOptions": { # AutoUpgradeOptions defines the set of options for the user to control how # Specifies the Auto Upgrade knobs for the node pool.
- # the Auto Upgrades will proceed.
- "description": "A String", # [Output only] This field is set when upgrades are about to commence
- # with the description of the upgrade.
- "autoUpgradeStartTime": "A String", # [Output only] This field is set when upgrades are about to commence
- # with the approximate start time for the upgrades, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- },
- "autoUpgrade": True or False, # A flag that specifies whether node auto-upgrade is enabled for the node
- # pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
- # up to date with the latest release version of Kubernetes.
- "autoRepair": True or False, # A flag that specifies whether the node auto-repair is enabled for the node
- # pool. If enabled, the nodes in this node pool will be monitored and, if
- # they fail health checks too many times, an automatic repair action will be
- # triggered.
- },
- "upgradeSettings": { # These upgrade settings control the level of parallelism and the level of # Specifies the upgrade settings for NAP created node pools
- # disruption caused by an upgrade.
- #
- # maxUnavailable controls the number of nodes that can be simultaneously
- # unavailable.
- #
- # maxSurge controls the number of additional nodes that can be added to the
- # node pool temporarily for the time of the upgrade to increase the number of
- # available nodes.
- #
- # (maxUnavailable + maxSurge) determines the level of parallelism (how many
- # nodes are being upgraded at the same time).
- #
- # Note: upgrades inevitably introduce some disruption since workloads need to
- # be moved from old nodes to new, upgraded ones. Even if maxUnavailable=0,
- # this holds true. (Disruption stays within the limits of
- # PodDisruptionBudget, if it is configured.)
- #
- # Consider a hypothetical node pool with 5 nodes having maxSurge=2,
- # maxUnavailable=1. This means the upgrade process upgrades 3 nodes
- # simultaneously. It creates 2 additional (upgraded) nodes, then it brings
- # down 3 old (not yet upgraded) nodes at the same time. This ensures that
- # there are always at least 4 nodes available.
- "maxUnavailable": 42, # The maximum number of nodes that can be simultaneously unavailable during
- # the upgrade process. A node is considered available if its status is
- # Ready.
- "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
- # of the node pool during the upgrade process.
- },
- "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs. If
- # service_account is specified, scopes should be empty.
- },
- },
- "initialNodeCount": 42, # The number of nodes to create in this cluster. 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.
- # For requests, this field should only be used in lieu of a
- # "node_pool" object, since this configuration (along with the
- # "node_config") will be used to create a "NodePool" object with an
- # auto-generated name. Do not use this and a node_pool at the same time.
- #
- # This field is deprecated, use node_pool.initial_node_count instead.
- "instanceGroupUrls": [ # Deprecated. Use node_pools.instance_group_urls.
- "A String",
- ],
- "privateClusterConfig": { # Configuration options for private clusters. # Configuration for private cluster.
- "peeringName": "A String", # Output only. The peering name in the customer VPC used by this cluster.
- "publicEndpoint": "A String", # Output only. The external IP address of this cluster's master endpoint.
- "enablePrivateNodes": True or False, # Whether nodes have internal IP addresses only. If enabled, all nodes are
- # given only RFC 1918 private addresses and communicate with the master via
- # private networking.
- "masterIpv4CidrBlock": "A String", # The IP range in CIDR notation to use for the hosted master network. This
- # range will be used for assigning internal IP addresses to the master or
- # set of masters, as well as the ILB VIP. This range must not overlap with
- # any other ranges in use within the cluster's network.
- "privateEndpoint": "A String", # Output only. The internal IP address of this cluster's master endpoint.
- "enablePrivateEndpoint": True or False, # Whether the master's internal IP address is used as the cluster endpoint.
- },
- "shieldedNodes": { # Configuration of Shielded Nodes feature. # Shielded Nodes configuration.
- "enabled": True or False, # Whether Shielded Nodes features are enabled on all nodes in this cluster.
- },
- "verticalPodAutoscaling": { # VerticalPodAutoscaling contains global, per-cluster information # Cluster-level Vertical Pod Autoscaling configuration.
- # required by Vertical Pod Autoscaler to automatically adjust
- # the resources of pods controlled by it.
- "enabled": True or False, # Enables vertical pod autoscaling.
- },
}</pre>
</div>
@@ -2517,6 +2517,8 @@
{ # SetLegacyAbacRequest enables or disables the ABAC authorization mechanism for
# a cluster.
+ "clusterId": "A String", # Deprecated. The name of the cluster to update.
+ # This field has been deprecated and replaced by the name field.
"name": "A String", # The name (project, location, cluster id) of the cluster to set legacy abac.
# Specified in the format `projects/*/locations/*/clusters/*`.
"enabled": True or False, # Required. Whether ABAC authorization will be enabled in the cluster.
@@ -2527,8 +2529,6 @@
# [zone](https://cloud.google.com/compute/docs/zones#available) in which the
# cluster resides. This field has been deprecated and replaced by the name
# field.
- "clusterId": "A String", # Deprecated. The name of the cluster to update.
- # This field has been deprecated and replaced by the name field.
}
x__xgafv: string, V1 error format.
@@ -2541,12 +2541,50 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
+ "name": "A String", # A non-parameterized string describing an operation stage.
+ # Unset for single-stage operations.
+ "stages": [ # Substages of an operation or a stage.
+ # Object with schema name: OperationProgress
+ ],
+ "metrics": [ # Progress metric bundle, for example:
+ # metrics: [{name: "nodes done", int_value: 15},
+ # {name: "nodes total", int_value: 32}]
+ # or
+ # metrics: [{name: "progress", double_value: 0.56},
+ # {name: "progress scale", double_value: 1.0}]
+ { # Progress metric is (string, int|float|string) pair.
+ "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
+ "doubleValue": 3.14, # For metrics with floating point value.
+ "intValue": "A String", # For metrics with integer value.
+ "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
+ },
+ ],
+ "status": "A String", # Status of an operation stage.
+ # Unset for single-stage operations.
+ },
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # operation is taking place. This field is deprecated, use location instead.
+ "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
+ "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.
+ "status": "A String", # The current status of the operation.
"name": "A String", # The server-assigned ID for the operation.
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"endTime": "A String", # [Output only] The time the operation completed, in
@@ -2558,44 +2596,6 @@
# in which the cluster resides.
"startTime": "A String", # [Output only] The time the operation started, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "status": "A String", # Status of an operation stage.
- # Unset for single-stage operations.
- "metrics": [ # Progress metric bundle, for example:
- # metrics: [{name: "nodes done", int_value: 15},
- # {name: "nodes total", int_value: 32}]
- # or
- # metrics: [{name: "progress", double_value: 0.56},
- # {name: "progress scale", double_value: 1.0}]
- { # Progress metric is (string, int|float|string) pair.
- "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- "intValue": "A String", # For metrics with integer value.
- },
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "zone": "A String", # The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # operation is taking place. This field is deprecated, use location instead.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "selfLink": "A String", # Server-defined URL for the resource.
- "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.
- "status": "A String", # The current status of the operation.
}</pre>
</div>
@@ -2627,6 +2627,123 @@
"clusters": [ # A list of clusters in the project in the specified zone, or
# across all ones.
{ # A Google Kubernetes Engine cluster.
+ "createTime": "A String", # [Output only] The time the cluster was created, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "clusterIpv4Cidr": "A String", # The IP address range of the container pods in this cluster, in
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `10.96.0.0/14`). Leave blank to have
+ # one automatically chosen or specify a `/14` block in `10.0.0.0/8`.
+ "autoscaling": { # ClusterAutoscaling contains global, per-cluster information # Cluster-level autoscaling configuration.
+ # required by Cluster Autoscaler to automatically adjust
+ # the size of the cluster and create/delete
+ # node pools based on the current needs.
+ "autoprovisioningLocations": [ # The list of Google Compute Engine
+ # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
+ # NodePool's nodes can be created by NAP.
+ "A String",
+ ],
+ "resourceLimits": [ # Contains global constraints regarding minimum and maximum
+ # amount of resources in the cluster.
+ { # Contains information about amount of some resource in the cluster.
+ # For memory, value should be in GB.
+ "minimum": "A String", # Minimum amount of the resource in the cluster.
+ "maximum": "A String", # Maximum amount of the resource in the cluster.
+ "resourceType": "A String", # Resource name "cpu", "memory" or gpu-specific string.
+ },
+ ],
+ "enableNodeAutoprovisioning": True or False, # Enables automatic node pool creation and deletion.
+ "autoprovisioningNodePoolDefaults": { # AutoprovisioningNodePoolDefaults contains defaults for a node pool created # AutoprovisioningNodePoolDefaults contains defaults for a node pool
+ # created by NAP.
+ # by NAP.
+ "management": { # NodeManagement defines the set of node management services turned on for the # Specifies the node management options for NAP created node-pools.
+ # node pool.
+ "upgradeOptions": { # AutoUpgradeOptions defines the set of options for the user to control how # Specifies the Auto Upgrade knobs for the node pool.
+ # the Auto Upgrades will proceed.
+ "autoUpgradeStartTime": "A String", # [Output only] This field is set when upgrades are about to commence
+ # with the approximate start time for the upgrades, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "description": "A String", # [Output only] This field is set when upgrades are about to commence
+ # with the description of the upgrade.
+ },
+ "autoRepair": True or False, # A flag that specifies whether the node auto-repair is enabled for the node
+ # pool. If enabled, the nodes in this node pool will be monitored and, if
+ # they fail health checks too many times, an automatic repair action will be
+ # triggered.
+ "autoUpgrade": True or False, # A flag that specifies whether node auto-upgrade is enabled for the node
+ # pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
+ # up to date with the latest release version of Kubernetes.
+ },
+ "oauthScopes": [ # Scopes that are used by NAP when creating node pools. If oauth_scopes are
+ # specified, service_account should be empty.
+ "A String",
+ ],
+ "upgradeSettings": { # These upgrade settings control the level of parallelism and the level of # Specifies the upgrade settings for NAP created node pools
+ # disruption caused by an upgrade.
+ #
+ # maxUnavailable controls the number of nodes that can be simultaneously
+ # unavailable.
+ #
+ # maxSurge controls the number of additional nodes that can be added to the
+ # node pool temporarily for the time of the upgrade to increase the number of
+ # available nodes.
+ #
+ # (maxUnavailable + maxSurge) determines the level of parallelism (how many
+ # nodes are being upgraded at the same time).
+ #
+ # Note: upgrades inevitably introduce some disruption since workloads need to
+ # be moved from old nodes to new, upgraded ones. Even if maxUnavailable=0,
+ # this holds true. (Disruption stays within the limits of
+ # PodDisruptionBudget, if it is configured.)
+ #
+ # Consider a hypothetical node pool with 5 nodes having maxSurge=2,
+ # maxUnavailable=1. This means the upgrade process upgrades 3 nodes
+ # simultaneously. It creates 2 additional (upgraded) nodes, then it brings
+ # down 3 old (not yet upgraded) nodes at the same time. This ensures that
+ # there are always at least 4 nodes available.
+ "maxUnavailable": 42, # The maximum number of nodes that can be simultaneously unavailable during
+ # the upgrade process. A node is considered available if its status is
+ # Ready.
+ "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
+ # of the node pool during the upgrade process.
+ },
+ "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs. If
+ # service_account is specified, scopes should be empty.
+ },
+ },
+ "initialNodeCount": 42, # The number of nodes to create in this cluster. 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.
+ # For requests, this field should only be used in lieu of a
+ # "node_pool" object, since this configuration (along with the
+ # "node_config") will be used to create a "NodePool" object with an
+ # auto-generated name. Do not use this and a node_pool at the same time.
+ #
+ # This field is deprecated, use node_pool.initial_node_count instead.
+ "instanceGroupUrls": [ # Deprecated. Use node_pools.instance_group_urls.
+ "A String",
+ ],
+ "privateClusterConfig": { # Configuration options for private clusters. # Configuration for private cluster.
+ "masterIpv4CidrBlock": "A String", # The IP range in CIDR notation to use for the hosted master network. This
+ # range will be used for assigning internal IP addresses to the master or
+ # set of masters, as well as the ILB VIP. This range must not overlap with
+ # any other ranges in use within the cluster's network.
+ "enablePrivateNodes": True or False, # Whether nodes have internal IP addresses only. If enabled, all nodes are
+ # given only RFC 1918 private addresses and communicate with the master via
+ # private networking.
+ "privateEndpoint": "A String", # Output only. The internal IP address of this cluster's master endpoint.
+ "enablePrivateEndpoint": True or False, # Whether the master's internal IP address is used as the cluster endpoint.
+ "peeringName": "A String", # Output only. The peering name in the customer VPC used by this cluster.
+ "publicEndpoint": "A String", # Output only. The external IP address of this cluster's master endpoint.
+ },
+ "shieldedNodes": { # Configuration of Shielded Nodes feature. # Shielded Nodes configuration.
+ "enabled": True or False, # Whether Shielded Nodes features are enabled on all nodes in this cluster.
+ },
+ "verticalPodAutoscaling": { # VerticalPodAutoscaling contains global, per-cluster information # Cluster-level Vertical Pod Autoscaling configuration.
+ # required by Vertical Pod Autoscaler to automatically adjust
+ # the resources of pods controlled by it.
+ "enabled": True or False, # Enables vertical pod autoscaling.
+ },
"defaultMaxPodsConstraint": { # Constraints applied to pods. # The default constraint on the maximum number of pods that can be run
# simultaneously on a node in the node pool of this cluster. Only honored
# if cluster created with IP Alias support.
@@ -2645,7 +2762,6 @@
# master authorized networks will disallow all external traffic to access
# Kubernetes master through HTTPS except traffic from the given CIDR blocks,
# Google Compute Engine Public IPs and Google Prod IPs.
- "enabled": True or False, # Whether or not master authorized networks is enabled.
"cidrBlocks": [ # cidr_blocks define up to 50 external networks that could access
# Kubernetes master through HTTPS.
{ # CidrBlock contains an optional name and one CIDR block.
@@ -2653,6 +2769,7 @@
"cidrBlock": "A String", # cidr_block must be specified in CIDR notation.
},
],
+ "enabled": True or False, # Whether or not master authorized networks is enabled.
},
"statusMessage": "A String", # [Output only] Additional information about the current status of this
# cluster, if available.
@@ -2663,13 +2780,6 @@
# certificate will be issued.
# Authentication can be done using HTTP basic auth or using client
# certificates.
- "clusterCaCertificate": "A String", # [Output only] Base64-encoded public certificate that is the root of
- # trust for the cluster.
- "clientCertificate": "A String", # [Output only] Base64-encoded public certificate used by clients to
- # authenticate to the cluster endpoint.
- "username": "A String", # The username to use for HTTP basic authentication to the master endpoint.
- # For clusters v1.6.0 and later, basic authentication can be disabled by
- # leaving username unspecified (or setting it to the empty string).
"password": "A String", # The password to use for HTTP basic authentication to the master endpoint.
# Because the master endpoint is open to the Internet, you should create a
# strong password. If a password is provided for cluster creation, username
@@ -2681,6 +2791,13 @@
},
"clientKey": "A String", # [Output only] Base64-encoded private key used by clients to authenticate
# to the cluster endpoint.
+ "clusterCaCertificate": "A String", # [Output only] Base64-encoded public certificate that is the root of
+ # trust for the cluster.
+ "clientCertificate": "A String", # [Output only] Base64-encoded public certificate used by clients to
+ # authenticate to the cluster endpoint.
+ "username": "A String", # The username to use for HTTP basic authentication to the master endpoint.
+ # For clusters v1.6.0 and later, basic authentication can be disabled by
+ # leaving username unspecified (or setting it to the empty string).
},
"authenticatorGroupsConfig": { # Configuration for returning group information from authenticators. # Configuration controlling RBAC group membership information.
"enabled": True or False, # Whether this cluster should return group membership lookups
@@ -2740,18 +2857,22 @@
},
"maintenancePolicy": { # MaintenancePolicy defines the maintenance policy to be used for the cluster. # Configure the maintenance policy for this cluster.
"window": { # MaintenanceWindow defines the maintenance window to be used for the cluster. # Specifies the maintenance window in which maintenance may be performed.
- "dailyMaintenanceWindow": { # Time window specified for daily maintenance operations. # DailyMaintenanceWindow specifies a daily maintenance operation window.
- "duration": "A String", # [Output only] Duration of the time window, automatically chosen to be
- # smallest possible in the given scenario.
- # Duration will be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
- # format "PTnHnMnS".
- "startTime": "A String", # Time within the maintenance window to start the maintenance operations.
- # Time format should be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
- # format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
+ "maintenanceExclusions": { # Exceptions to maintenance window. Non-emergency maintenance should not
+ # occur in these windows.
+ "a_key": { # Represents an arbitrary window of time.
+ "endTime": "A String", # The time that the window ends. The end time should take place after the
+ # start time.
+ "startTime": "A String", # The time that the window first starts.
+ },
},
"recurringWindow": { # Represents an arbitrary window of time that recurs. # RecurringWindow specifies some number of recurring time periods for
# maintenance to occur. The time windows may be overlapping. If no
# maintenance windows are set, maintenance can occur at any time.
+ "window": { # Represents an arbitrary window of time. # The window of the first recurrence.
+ "endTime": "A String", # The time that the window ends. The end time should take place after the
+ # start time.
+ "startTime": "A String", # The time that the window first starts.
+ },
"recurrence": "A String", # An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how
# this window reccurs. They go on for the span of time between the start and
# end time.
@@ -2779,19 +2900,15 @@
# Note the start and end time's specific dates are largely arbitrary except
# to specify duration of the window and when it first starts.
# The FREQ values of HOURLY, MINUTELY, and SECONDLY are not supported.
- "window": { # Represents an arbitrary window of time. # The window of the first recurrence.
- "endTime": "A String", # The time that the window ends. The end time should take place after the
- # start time.
- "startTime": "A String", # The time that the window first starts.
- },
},
- "maintenanceExclusions": { # Exceptions to maintenance window. Non-emergency maintenance should not
- # occur in these windows.
- "a_key": { # Represents an arbitrary window of time.
- "endTime": "A String", # The time that the window ends. The end time should take place after the
- # start time.
- "startTime": "A String", # The time that the window first starts.
- },
+ "dailyMaintenanceWindow": { # Time window specified for daily maintenance operations. # DailyMaintenanceWindow specifies a daily maintenance operation window.
+ "startTime": "A String", # Time within the maintenance window to start the maintenance operations.
+ # Time format should be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
+ # format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
+ "duration": "A String", # [Output only] Duration of the time window, automatically chosen to be
+ # smallest possible in the given scenario.
+ # Duration will be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
+ # format "PTnHnMnS".
},
},
"resourceVersion": "A String", # A hash identifying the version of this policy, so that updates to fields of
@@ -2814,24 +2931,14 @@
# - "1.X.Y-gke.N": picks an explicit Kubernetes version
# - "","-": picks the default Kubernetes version
"ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the cluster. # Configuration for cluster IP allocation.
- "clusterIpv4Cidr": "A String", # This field is deprecated, use cluster_ipv4_cidr_block.
- "servicesIpv4Cidr": "A String", # This field is deprecated, use services_ipv4_cidr_block.
- "servicesIpv4CidrBlock": "A String", # The IP address range of the services IPs in this cluster. If blank, a range
- # will be automatically chosen with the default size.
- #
- # This field is only applicable when `use_ip_aliases` is true.
- #
- # Set to blank to have a range chosen with the default size.
- #
- # Set to /netmask (e.g. `/14`) to have a range chosen with a specific
- # netmask.
- #
- # Set to a
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
- # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
- # to use.
"nodeIpv4Cidr": "A String", # This field is deprecated, use node_ipv4_cidr_block.
+ "clusterSecondaryRangeName": "A String", # The name of the secondary range to be used for the cluster CIDR
+ # block. The secondary range will be used for pod IP
+ # addresses. This must be an existing secondary range associated
+ # with the cluster subnetwork.
+ #
+ # This field is only applicable with use_ip_aliases is true and
+ # create_subnetwork is false.
"clusterIpv4CidrBlock": "A String", # The IP address range for the cluster pod IPs. If this field is set, then
# `cluster.cluster_ipv4_cidr` must be left blank.
#
@@ -2847,13 +2954,6 @@
# notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
# `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
# to use.
- "clusterSecondaryRangeName": "A String", # The name of the secondary range to be used for the cluster CIDR
- # block. The secondary range will be used for pod IP
- # addresses. This must be an existing secondary range associated
- # with the cluster subnetwork.
- #
- # This field is only applicable with use_ip_aliases is true and
- # create_subnetwork is false.
"nodeIpv4CidrBlock": "A String", # The IP address range of the instance IPs in this cluster.
#
# This is applicable only if `create_subnetwork` is true.
@@ -2883,9 +2983,6 @@
# notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
# `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
# to use.
- "createSubnetwork": True or False, # Whether a new subnetwork will be created automatically for the cluster.
- #
- # This field is only applicable when `use_ip_aliases` is true.
"useIpAliases": True or False, # Whether alias IPs will be used for pod IPs in the cluster.
"servicesSecondaryRangeName": "A String", # The name of the secondary range to be used as for the services
# CIDR block. The secondary range will be used for service
@@ -2894,9 +2991,29 @@
#
# This field is only applicable with use_ip_aliases is true and
# create_subnetwork is false.
+ "createSubnetwork": True or False, # Whether a new subnetwork will be created automatically for the cluster.
+ #
+ # This field is only applicable when `use_ip_aliases` is true.
"subnetworkName": "A String", # A custom subnetwork name to be used if `create_subnetwork` is true. If
# this field is empty, then an automatic name will be chosen for the new
# subnetwork.
+ "clusterIpv4Cidr": "A String", # This field is deprecated, use cluster_ipv4_cidr_block.
+ "servicesIpv4Cidr": "A String", # This field is deprecated, use services_ipv4_cidr_block.
+ "servicesIpv4CidrBlock": "A String", # The IP address range of the services IPs in this cluster. If blank, a range
+ # will be automatically chosen with the default size.
+ #
+ # This field is only applicable when `use_ip_aliases` is true.
+ #
+ # Set to blank to have a range chosen with the default size.
+ #
+ # Set to /netmask (e.g. `/14`) to have a range chosen with a specific
+ # netmask.
+ #
+ # Set to a
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
+ # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
+ # to use.
},
"legacyAbac": { # Configuration for the legacy Attribute Based Access Control authorization # Configuration for the legacy ABAC authorization mode.
# mode.
@@ -2933,15 +3050,22 @@
# of Kubernetes labels applied to them, which may be used to reference them
# during pod scheduling. They may also be resized up or down, to accommodate
# the workload.
+ "statusMessage": "A String", # [Output only] Additional information about the current status of this
+ # node pool instance, if available.
+ "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.
+ "maxNodeCount": 42, # Maximum number of nodes in the NodePool. Must be >= min_node_count. There
+ # has to enough quota to scale up the cluster.
+ "autoprovisioned": True or False, # Can this node pool be deleted automatically.
+ "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.
+ },
"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.
- "locations": [ # The list of Google Compute Engine
- # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
- # NodePool's nodes should be located.
- "A String",
- ],
"selfLink": "A String", # [Output only] Server-defined URL for the resource.
"upgradeSettings": { # These upgrade settings control the level of parallelism and the level of # Upgrade settings control disruption and speed of the upgrade.
# disruption caused by an upgrade.
@@ -2972,6 +3096,11 @@
"maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
# of the node pool during the upgrade process.
},
+ "locations": [ # The list of Google Compute Engine
+ # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
+ # NodePool's nodes should be located.
+ "A String",
+ ],
"instanceGroupUrls": [ # [Output only] The resource URLs of the [managed instance
# groups](https://cloud.google.com/compute/docs/instance-groups/creating-groups-of-managed-instances)
# associated with this node pool.
@@ -2982,23 +3111,12 @@
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"status": "A String", # [Output only] The status of the nodes in this pool instance.
"config": { # Parameters that describe the nodes in a cluster. # The node configuration of the pool.
- "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
- # valid sources or targets for network firewalls and are specified by
- # the client during cluster or node pool creation. Each tag within the list
- # must comply with RFC1035.
- "A String",
- ],
- "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
- # Specify the email address of the Service Account; otherwise, if no Service
- # Account is specified, the "default" service account is used.
- "imageType": "A String", # The image type to use for this node. Note that for a given image type,
- # the latest version of it will be used.
"oauthScopes": [ # The set of Google API scopes to be made available on all of the
# node VMs under the "default" service account.
#
@@ -3026,9 +3144,9 @@
# See
# [here](https://kubernetes.io/docs/concepts/configuration/taint-and-toleration)
# for more information, including usage and the valid values.
- "key": "A String", # Key for taint.
- "value": "A String", # Value for taint.
"effect": "A String", # Effect for taint.
+ "value": "A String", # Value for taint.
+ "key": "A String", # Key for taint.
},
],
"labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
@@ -3054,9 +3172,9 @@
# 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](https://cloud.google.com/compute/docs/gpus)
+ "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
},
],
"machineType": "A String", # The name of a Google Compute Engine [machine
@@ -3069,17 +3187,17 @@
#
# If unspecified, the default disk type is 'pd-standard'
"shieldedInstanceConfig": { # A set of Shielded Instance options. # Shielded Instance options.
- "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.
- #
- # Secure Boot helps ensure that the system only runs authentic software by
- # verifying the digital signature of all boot components, and halting the
- # boot process if signature verification fails.
"enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.
#
# Enables monitoring and attestation of the boot integrity of the instance.
# The attestation is performed against the integrity policy baseline. This
# baseline is initially derived from the implicitly trusted boot image when
# the instance is created.
+ "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.
+ #
+ # Secure Boot helps ensure that the system only runs authentic software by
+ # verifying the digital signature of all boot components, and halting the
+ # boot process if signature verification fails.
},
"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
@@ -3140,14 +3258,25 @@
# to this node pool.
# is the configuration of desired reservation which instances could take
# capacity from.
- "key": "A String", # Corresponds to the label key of a reservation resource. To target a
- # SPECIFIC_RESERVATION by name, specify "googleapis.com/reservation-name" as
- # the key and specify the name of your reservation as its value.
"values": [ # Corresponds to the label value(s) of reservation resource(s).
"A String",
],
"consumeReservationType": "A String", # Corresponds to the type of reservation consumption.
+ "key": "A String", # Corresponds to the label key of a reservation resource. To target a
+ # SPECIFIC_RESERVATION by name, specify "googleapis.com/reservation-name" as
+ # the key and specify the name of your reservation as its value.
},
+ "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
+ # valid sources or targets for network firewalls and are specified by
+ # the client during cluster or node pool creation. Each tag within the list
+ # must comply with RFC1035.
+ "A String",
+ ],
+ "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
+ # Specify the email address of the Service Account; otherwise, if no Service
+ # Account is specified, the "default" service account is used.
+ "imageType": "A String", # The image type to use for this node. Note that for a given image type,
+ # the latest version of it will be used.
},
"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.
@@ -3158,31 +3287,19 @@
# node pool.
"upgradeOptions": { # AutoUpgradeOptions defines the set of options for the user to control how # Specifies the Auto Upgrade knobs for the node pool.
# the Auto Upgrades will proceed.
- "description": "A String", # [Output only] This field is set when upgrades are about to commence
- # with the description of the upgrade.
"autoUpgradeStartTime": "A String", # [Output only] This field is set when upgrades are about to commence
# with the approximate start time for the upgrades, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "description": "A String", # [Output only] This field is set when upgrades are about to commence
+ # with the description of the upgrade.
},
- "autoUpgrade": True or False, # A flag that specifies whether node auto-upgrade is enabled for the node
- # pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
- # up to date with the latest release version of Kubernetes.
"autoRepair": True or False, # A flag that specifies whether the node auto-repair is enabled for the node
# pool. If enabled, the nodes in this node pool will be monitored and, if
# they fail health checks too many times, an automatic repair action will be
# triggered.
- },
- "statusMessage": "A String", # [Output only] Additional information about the current status of this
- # node pool instance, if available.
- "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.
- "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.
- "minNodeCount": 42, # Minimum number of nodes in the NodePool. Must be >= 1 and <=
- # max_node_count.
- "autoprovisioned": True or False, # Can this node pool be deleted automatically.
+ "autoUpgrade": True or False, # A flag that specifies whether node auto-upgrade is enabled for the node
+ # pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
+ # up to date with the latest release version of Kubernetes.
},
},
],
@@ -3207,8 +3324,8 @@
"conditions": [ # 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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"currentNodeCount": 42, # [Output only] The number of nodes currently in the cluster. Deprecated.
@@ -3268,17 +3385,6 @@
#
# If unspecified, the defaults are used.
# This field is deprecated, use node_pool.config instead.
- "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
- # valid sources or targets for network firewalls and are specified by
- # the client during cluster or node pool creation. Each tag within the list
- # must comply with RFC1035.
- "A String",
- ],
- "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
- # Specify the email address of the Service Account; otherwise, if no Service
- # Account is specified, the "default" service account is used.
- "imageType": "A String", # The image type to use for this node. Note that for a given image type,
- # the latest version of it will be used.
"oauthScopes": [ # The set of Google API scopes to be made available on all of the
# node VMs under the "default" service account.
#
@@ -3306,9 +3412,9 @@
# See
# [here](https://kubernetes.io/docs/concepts/configuration/taint-and-toleration)
# for more information, including usage and the valid values.
- "key": "A String", # Key for taint.
- "value": "A String", # Value for taint.
"effect": "A String", # Effect for taint.
+ "value": "A String", # Value for taint.
+ "key": "A String", # Key for taint.
},
],
"labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
@@ -3334,9 +3440,9 @@
# 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](https://cloud.google.com/compute/docs/gpus)
+ "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
},
],
"machineType": "A String", # The name of a Google Compute Engine [machine
@@ -3349,17 +3455,17 @@
#
# If unspecified, the default disk type is 'pd-standard'
"shieldedInstanceConfig": { # A set of Shielded Instance options. # Shielded Instance options.
- "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.
- #
- # Secure Boot helps ensure that the system only runs authentic software by
- # verifying the digital signature of all boot components, and halting the
- # boot process if signature verification fails.
"enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.
#
# Enables monitoring and attestation of the boot integrity of the instance.
# The attestation is performed against the integrity policy baseline. This
# baseline is initially derived from the implicitly trusted boot image when
# the instance is created.
+ "enableSecureBoot": True or False, # Defines whether the instance has Secure Boot enabled.
+ #
+ # Secure Boot helps ensure that the system only runs authentic software by
+ # verifying the digital signature of all boot components, and halting the
+ # boot process if signature verification fails.
},
"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
@@ -3420,17 +3526,30 @@
# to this node pool.
# is the configuration of desired reservation which instances could take
# capacity from.
- "key": "A String", # Corresponds to the label key of a reservation resource. To target a
- # SPECIFIC_RESERVATION by name, specify "googleapis.com/reservation-name" as
- # the key and specify the name of your reservation as its value.
"values": [ # Corresponds to the label value(s) of reservation resource(s).
"A String",
],
"consumeReservationType": "A String", # Corresponds to the type of reservation consumption.
+ "key": "A String", # Corresponds to the label key of a reservation resource. To target a
+ # SPECIFIC_RESERVATION by name, specify "googleapis.com/reservation-name" as
+ # the key and specify the name of your reservation as its value.
},
+ "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
+ # valid sources or targets for network firewalls and are specified by
+ # the client during cluster or node pool creation. Each tag within the list
+ # must comply with RFC1035.
+ "A String",
+ ],
+ "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
+ # Specify the email address of the Service Account; otherwise, if no Service
+ # Account is specified, the "default" service account is used.
+ "imageType": "A String", # The image type to use for this node. Note that for a given image type,
+ # the latest version of it will be used.
},
"status": "A String", # [Output only] The current status of this cluster.
"networkConfig": { # NetworkConfig reports the relative names of network & subnetwork. # Configuration for cluster networking.
+ "enableIntraNodeVisibility": True or False, # Whether Intra-node visibility is enabled for this cluster.
+ # This makes same node pod to pod traffic visible for VPC network.
"subnetwork": "A String", # Output only. The relative name of the Google Compute Engine
# [subnetwork](https://cloud.google.com/compute/docs/vpc) to which the
# cluster is connected. Example:
@@ -3439,8 +3558,6 @@
# network(https://cloud.google.com/compute/docs/networks-and-firewalls#networks)
# to which the cluster is connected. Example:
# projects/my-project/global/networks/my-network
- "enableIntraNodeVisibility": True or False, # Whether Intra-node visibility is enabled for this cluster.
- # This makes same node pod to pod traffic visible for VPC network.
},
"name": "A String", # The name of this cluster. The name must be unique within this project
# and location (e.g. zone or region), and can be up to 40 characters with
@@ -3460,123 +3577,6 @@
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
- "createTime": "A String", # [Output only] The time the cluster was created, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "clusterIpv4Cidr": "A String", # The IP address range of the container pods in this cluster, in
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `10.96.0.0/14`). Leave blank to have
- # one automatically chosen or specify a `/14` block in `10.0.0.0/8`.
- "autoscaling": { # ClusterAutoscaling contains global, per-cluster information # Cluster-level autoscaling configuration.
- # required by Cluster Autoscaler to automatically adjust
- # the size of the cluster and create/delete
- # node pools based on the current needs.
- "autoprovisioningLocations": [ # The list of Google Compute Engine
- # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
- # NodePool's nodes can be created by NAP.
- "A String",
- ],
- "resourceLimits": [ # Contains global constraints regarding minimum and maximum
- # amount of resources in the cluster.
- { # Contains information about amount of some resource in the cluster.
- # For memory, value should be in GB.
- "maximum": "A String", # Maximum amount of the resource in the cluster.
- "resourceType": "A String", # Resource name "cpu", "memory" or gpu-specific string.
- "minimum": "A String", # Minimum amount of the resource in the cluster.
- },
- ],
- "enableNodeAutoprovisioning": True or False, # Enables automatic node pool creation and deletion.
- "autoprovisioningNodePoolDefaults": { # AutoprovisioningNodePoolDefaults contains defaults for a node pool created # AutoprovisioningNodePoolDefaults contains defaults for a node pool
- # created by NAP.
- # by NAP.
- "oauthScopes": [ # Scopes that are used by NAP when creating node pools. If oauth_scopes are
- # specified, service_account should be empty.
- "A String",
- ],
- "management": { # NodeManagement defines the set of node management services turned on for the # Specifies the node management options for NAP created node-pools.
- # node pool.
- "upgradeOptions": { # AutoUpgradeOptions defines the set of options for the user to control how # Specifies the Auto Upgrade knobs for the node pool.
- # the Auto Upgrades will proceed.
- "description": "A String", # [Output only] This field is set when upgrades are about to commence
- # with the description of the upgrade.
- "autoUpgradeStartTime": "A String", # [Output only] This field is set when upgrades are about to commence
- # with the approximate start time for the upgrades, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- },
- "autoUpgrade": True or False, # A flag that specifies whether node auto-upgrade is enabled for the node
- # pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
- # up to date with the latest release version of Kubernetes.
- "autoRepair": True or False, # A flag that specifies whether the node auto-repair is enabled for the node
- # pool. If enabled, the nodes in this node pool will be monitored and, if
- # they fail health checks too many times, an automatic repair action will be
- # triggered.
- },
- "upgradeSettings": { # These upgrade settings control the level of parallelism and the level of # Specifies the upgrade settings for NAP created node pools
- # disruption caused by an upgrade.
- #
- # maxUnavailable controls the number of nodes that can be simultaneously
- # unavailable.
- #
- # maxSurge controls the number of additional nodes that can be added to the
- # node pool temporarily for the time of the upgrade to increase the number of
- # available nodes.
- #
- # (maxUnavailable + maxSurge) determines the level of parallelism (how many
- # nodes are being upgraded at the same time).
- #
- # Note: upgrades inevitably introduce some disruption since workloads need to
- # be moved from old nodes to new, upgraded ones. Even if maxUnavailable=0,
- # this holds true. (Disruption stays within the limits of
- # PodDisruptionBudget, if it is configured.)
- #
- # Consider a hypothetical node pool with 5 nodes having maxSurge=2,
- # maxUnavailable=1. This means the upgrade process upgrades 3 nodes
- # simultaneously. It creates 2 additional (upgraded) nodes, then it brings
- # down 3 old (not yet upgraded) nodes at the same time. This ensures that
- # there are always at least 4 nodes available.
- "maxUnavailable": 42, # The maximum number of nodes that can be simultaneously unavailable during
- # the upgrade process. A node is considered available if its status is
- # Ready.
- "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
- # of the node pool during the upgrade process.
- },
- "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs. If
- # service_account is specified, scopes should be empty.
- },
- },
- "initialNodeCount": 42, # The number of nodes to create in this cluster. 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.
- # For requests, this field should only be used in lieu of a
- # "node_pool" object, since this configuration (along with the
- # "node_config") will be used to create a "NodePool" object with an
- # auto-generated name. Do not use this and a node_pool at the same time.
- #
- # This field is deprecated, use node_pool.initial_node_count instead.
- "instanceGroupUrls": [ # Deprecated. Use node_pools.instance_group_urls.
- "A String",
- ],
- "privateClusterConfig": { # Configuration options for private clusters. # Configuration for private cluster.
- "peeringName": "A String", # Output only. The peering name in the customer VPC used by this cluster.
- "publicEndpoint": "A String", # Output only. The external IP address of this cluster's master endpoint.
- "enablePrivateNodes": True or False, # Whether nodes have internal IP addresses only. If enabled, all nodes are
- # given only RFC 1918 private addresses and communicate with the master via
- # private networking.
- "masterIpv4CidrBlock": "A String", # The IP range in CIDR notation to use for the hosted master network. This
- # range will be used for assigning internal IP addresses to the master or
- # set of masters, as well as the ILB VIP. This range must not overlap with
- # any other ranges in use within the cluster's network.
- "privateEndpoint": "A String", # Output only. The internal IP address of this cluster's master endpoint.
- "enablePrivateEndpoint": True or False, # Whether the master's internal IP address is used as the cluster endpoint.
- },
- "shieldedNodes": { # Configuration of Shielded Nodes feature. # Shielded Nodes configuration.
- "enabled": True or False, # Whether Shielded Nodes features are enabled on all nodes in this cluster.
- },
- "verticalPodAutoscaling": { # VerticalPodAutoscaling contains global, per-cluster information # Cluster-level Vertical Pod Autoscaling configuration.
- # required by Vertical Pod Autoscaler to automatically adjust
- # the resources of pods controlled by it.
- "enabled": True or False, # Enables vertical pod autoscaling.
- },
},
],
"missingZones": [ # If any zones are listed here, the list of clusters returned
@@ -3607,13 +3607,13 @@
The object takes the form of:
{ # SetLocationsRequest sets the locations of the cluster.
+ "clusterId": "A String", # Deprecated. The name of the cluster to upgrade.
+ # This field has been deprecated and replaced by the name field.
+ "name": "A String", # The name (project, location, cluster) of the cluster to set locations.
+ # Specified in the format `projects/*/locations/*/clusters/*`.
"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.
- "zone": "A String", # Deprecated. The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # cluster resides. This field has been deprecated and replaced by the name
- # field.
"locations": [ # Required. The desired list of Google Compute Engine
# [zones](https://cloud.google.com/compute/docs/zones#available) in which the
# cluster's nodes should be located. Changing the locations a cluster is in
@@ -3623,10 +3623,10 @@
# This list must always include the cluster's primary zone.
"A String",
],
- "clusterId": "A String", # Deprecated. The name of the cluster to upgrade.
- # This field has been deprecated and replaced by the name field.
- "name": "A String", # The name (project, location, cluster) of the cluster to set locations.
- # Specified in the format `projects/*/locations/*/clusters/*`.
+ "zone": "A String", # Deprecated. The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # cluster resides. This field has been deprecated and replaced by the name
+ # field.
}
x__xgafv: string, V1 error format.
@@ -3639,12 +3639,50 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
+ "name": "A String", # A non-parameterized string describing an operation stage.
+ # Unset for single-stage operations.
+ "stages": [ # Substages of an operation or a stage.
+ # Object with schema name: OperationProgress
+ ],
+ "metrics": [ # Progress metric bundle, for example:
+ # metrics: [{name: "nodes done", int_value: 15},
+ # {name: "nodes total", int_value: 32}]
+ # or
+ # metrics: [{name: "progress", double_value: 0.56},
+ # {name: "progress scale", double_value: 1.0}]
+ { # Progress metric is (string, int|float|string) pair.
+ "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
+ "doubleValue": 3.14, # For metrics with floating point value.
+ "intValue": "A String", # For metrics with integer value.
+ "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
+ },
+ ],
+ "status": "A String", # Status of an operation stage.
+ # Unset for single-stage operations.
+ },
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # operation is taking place. This field is deprecated, use location instead.
+ "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
+ "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.
+ "status": "A String", # The current status of the operation.
"name": "A String", # The server-assigned ID for the operation.
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"endTime": "A String", # [Output only] The time the operation completed, in
@@ -3656,44 +3694,6 @@
# in which the cluster resides.
"startTime": "A String", # [Output only] The time the operation started, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "status": "A String", # Status of an operation stage.
- # Unset for single-stage operations.
- "metrics": [ # Progress metric bundle, for example:
- # metrics: [{name: "nodes done", int_value: 15},
- # {name: "nodes total", int_value: 32}]
- # or
- # metrics: [{name: "progress", double_value: 0.56},
- # {name: "progress scale", double_value: 1.0}]
- { # Progress metric is (string, int|float|string) pair.
- "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- "intValue": "A String", # For metrics with integer value.
- },
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "zone": "A String", # The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # operation is taking place. This field is deprecated, use location instead.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "selfLink": "A String", # Server-defined URL for the resource.
- "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.
- "status": "A String", # The current status of the operation.
}</pre>
</div>
@@ -3715,6 +3715,8 @@
The object takes the form of:
{ # SetLoggingServiceRequest sets the logging service of a cluster.
+ "name": "A String", # The name (project, location, cluster) of the cluster to set logging.
+ # Specified in the format `projects/*/locations/*/clusters/*`.
"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.
@@ -3735,8 +3737,6 @@
#
# If left as an empty string,`logging.googleapis.com/kubernetes` will be
# used for GKE 1.14+ or `logging.googleapis.com` for earlier versions.
- "name": "A String", # The name (project, location, cluster) of the cluster to set logging.
- # Specified in the format `projects/*/locations/*/clusters/*`.
}
x__xgafv: string, V1 error format.
@@ -3749,12 +3749,50 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
+ "name": "A String", # A non-parameterized string describing an operation stage.
+ # Unset for single-stage operations.
+ "stages": [ # Substages of an operation or a stage.
+ # Object with schema name: OperationProgress
+ ],
+ "metrics": [ # Progress metric bundle, for example:
+ # metrics: [{name: "nodes done", int_value: 15},
+ # {name: "nodes total", int_value: 32}]
+ # or
+ # metrics: [{name: "progress", double_value: 0.56},
+ # {name: "progress scale", double_value: 1.0}]
+ { # Progress metric is (string, int|float|string) pair.
+ "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
+ "doubleValue": 3.14, # For metrics with floating point value.
+ "intValue": "A String", # For metrics with integer value.
+ "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
+ },
+ ],
+ "status": "A String", # Status of an operation stage.
+ # Unset for single-stage operations.
+ },
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # operation is taking place. This field is deprecated, use location instead.
+ "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
+ "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.
+ "status": "A String", # The current status of the operation.
"name": "A String", # The server-assigned ID for the operation.
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"endTime": "A String", # [Output only] The time the operation completed, in
@@ -3766,44 +3804,6 @@
# in which the cluster resides.
"startTime": "A String", # [Output only] The time the operation started, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "status": "A String", # Status of an operation stage.
- # Unset for single-stage operations.
- "metrics": [ # Progress metric bundle, for example:
- # metrics: [{name: "nodes done", int_value: 15},
- # {name: "nodes total", int_value: 32}]
- # or
- # metrics: [{name: "progress", double_value: 0.56},
- # {name: "progress scale", double_value: 1.0}]
- { # Progress metric is (string, int|float|string) pair.
- "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- "intValue": "A String", # For metrics with integer value.
- },
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "zone": "A String", # The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # operation is taking place. This field is deprecated, use location instead.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "selfLink": "A String", # Server-defined URL for the resource.
- "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.
- "status": "A String", # The current status of the operation.
}</pre>
</div>
@@ -3825,15 +3825,9 @@
The object takes the form of:
{ # UpdateMasterRequest updates the master of the cluster.
- "name": "A String", # The name (project, location, cluster) of the cluster to update.
- # Specified in the format `projects/*/locations/*/clusters/*`.
"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.
- "zone": "A String", # Deprecated. The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # cluster resides. This field has been deprecated and replaced by the name
- # field.
"masterVersion": "A String", # Required. The Kubernetes version to change the master to.
#
# Users may specify either explicit versions offered by Kubernetes Engine or
@@ -3844,8 +3838,14 @@
# - "1.X.Y": picks the highest valid gke.N patch in the 1.X.Y version
# - "1.X.Y-gke.N": picks an explicit Kubernetes version
# - "-": picks the default Kubernetes version
+ "zone": "A String", # Deprecated. The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # cluster resides. This field has been deprecated and replaced by the name
+ # field.
"clusterId": "A String", # Deprecated. The name of the cluster to upgrade.
# This field has been deprecated and replaced by the name field.
+ "name": "A String", # The name (project, location, cluster) of the cluster to update.
+ # Specified in the format `projects/*/locations/*/clusters/*`.
}
x__xgafv: string, V1 error format.
@@ -3858,12 +3858,50 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
+ "name": "A String", # A non-parameterized string describing an operation stage.
+ # Unset for single-stage operations.
+ "stages": [ # Substages of an operation or a stage.
+ # Object with schema name: OperationProgress
+ ],
+ "metrics": [ # Progress metric bundle, for example:
+ # metrics: [{name: "nodes done", int_value: 15},
+ # {name: "nodes total", int_value: 32}]
+ # or
+ # metrics: [{name: "progress", double_value: 0.56},
+ # {name: "progress scale", double_value: 1.0}]
+ { # Progress metric is (string, int|float|string) pair.
+ "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
+ "doubleValue": 3.14, # For metrics with floating point value.
+ "intValue": "A String", # For metrics with integer value.
+ "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
+ },
+ ],
+ "status": "A String", # Status of an operation stage.
+ # Unset for single-stage operations.
+ },
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # operation is taking place. This field is deprecated, use location instead.
+ "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
+ "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.
+ "status": "A String", # The current status of the operation.
"name": "A String", # The server-assigned ID for the operation.
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"endTime": "A String", # [Output only] The time the operation completed, in
@@ -3875,44 +3913,6 @@
# in which the cluster resides.
"startTime": "A String", # [Output only] The time the operation started, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "status": "A String", # Status of an operation stage.
- # Unset for single-stage operations.
- "metrics": [ # Progress metric bundle, for example:
- # metrics: [{name: "nodes done", int_value: 15},
- # {name: "nodes total", int_value: 32}]
- # or
- # metrics: [{name: "progress", double_value: 0.56},
- # {name: "progress scale", double_value: 1.0}]
- { # Progress metric is (string, int|float|string) pair.
- "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- "intValue": "A String", # For metrics with integer value.
- },
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "zone": "A String", # The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # operation is taking place. This field is deprecated, use location instead.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "selfLink": "A String", # Server-defined URL for the resource.
- "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.
- "status": "A String", # The current status of the operation.
}</pre>
</div>
@@ -3934,6 +3934,8 @@
The object takes the form of:
{ # SetMonitoringServiceRequest sets the monitoring service of a cluster.
+ "clusterId": "A String", # Deprecated. The name of the cluster to upgrade.
+ # This field has been deprecated and replaced by the name field.
"monitoringService": "A String", # Required. The monitoring service the cluster should use to write metrics.
# Currently available options:
#
@@ -3954,8 +3956,6 @@
# [zone](https://cloud.google.com/compute/docs/zones#available) in which the
# cluster resides. This field has been deprecated and replaced by the name
# field.
- "clusterId": "A String", # Deprecated. The name of the cluster to upgrade.
- # This field has been deprecated and replaced by the name field.
}
x__xgafv: string, V1 error format.
@@ -3968,12 +3968,50 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
+ "name": "A String", # A non-parameterized string describing an operation stage.
+ # Unset for single-stage operations.
+ "stages": [ # Substages of an operation or a stage.
+ # Object with schema name: OperationProgress
+ ],
+ "metrics": [ # Progress metric bundle, for example:
+ # metrics: [{name: "nodes done", int_value: 15},
+ # {name: "nodes total", int_value: 32}]
+ # or
+ # metrics: [{name: "progress", double_value: 0.56},
+ # {name: "progress scale", double_value: 1.0}]
+ { # Progress metric is (string, int|float|string) pair.
+ "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
+ "doubleValue": 3.14, # For metrics with floating point value.
+ "intValue": "A String", # For metrics with integer value.
+ "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
+ },
+ ],
+ "status": "A String", # Status of an operation stage.
+ # Unset for single-stage operations.
+ },
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # operation is taking place. This field is deprecated, use location instead.
+ "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
+ "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.
+ "status": "A String", # The current status of the operation.
"name": "A String", # The server-assigned ID for the operation.
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"endTime": "A String", # [Output only] The time the operation completed, in
@@ -3985,44 +4023,6 @@
# in which the cluster resides.
"startTime": "A String", # [Output only] The time the operation started, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "status": "A String", # Status of an operation stage.
- # Unset for single-stage operations.
- "metrics": [ # Progress metric bundle, for example:
- # metrics: [{name: "nodes done", int_value: 15},
- # {name: "nodes total", int_value: 32}]
- # or
- # metrics: [{name: "progress", double_value: 0.56},
- # {name: "progress scale", double_value: 1.0}]
- { # Progress metric is (string, int|float|string) pair.
- "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- "intValue": "A String", # For metrics with integer value.
- },
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "zone": "A String", # The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # operation is taking place. This field is deprecated, use location instead.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "selfLink": "A String", # Server-defined URL for the resource.
- "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.
- "status": "A String", # The current status of the operation.
}</pre>
</div>
@@ -4046,14 +4046,6 @@
{ # SetLabelsRequest sets the Google Cloud Platform labels on a Google Container
# Engine cluster, which will in turn set them for Google Compute Engine
# resources used by that cluster
- "name": "A String", # The name (project, location, cluster id) of the cluster to set labels.
- # Specified in the format `projects/*/locations/*/clusters/*`.
- "resourceLabels": { # Required. The labels to set for that cluster.
- "a_key": "A String",
- },
- "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 name field.
"clusterId": "A String", # Deprecated. The name of the cluster.
# This field has been deprecated and replaced by the name field.
"labelFingerprint": "A String", # Required. The fingerprint of the previous set of labels for this resource,
@@ -4066,6 +4058,14 @@
# [zone](https://cloud.google.com/compute/docs/zones#available) in which the
# cluster resides. This field has been deprecated and replaced by the name
# field.
+ "name": "A String", # The name (project, location, cluster id) of the cluster to set labels.
+ # Specified in the format `projects/*/locations/*/clusters/*`.
+ "resourceLabels": { # Required. The labels to set for that cluster.
+ "a_key": "A String",
+ },
+ "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 name field.
}
x__xgafv: string, V1 error format.
@@ -4078,12 +4078,50 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
+ "name": "A String", # A non-parameterized string describing an operation stage.
+ # Unset for single-stage operations.
+ "stages": [ # Substages of an operation or a stage.
+ # Object with schema name: OperationProgress
+ ],
+ "metrics": [ # Progress metric bundle, for example:
+ # metrics: [{name: "nodes done", int_value: 15},
+ # {name: "nodes total", int_value: 32}]
+ # or
+ # metrics: [{name: "progress", double_value: 0.56},
+ # {name: "progress scale", double_value: 1.0}]
+ { # Progress metric is (string, int|float|string) pair.
+ "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
+ "doubleValue": 3.14, # For metrics with floating point value.
+ "intValue": "A String", # For metrics with integer value.
+ "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
+ },
+ ],
+ "status": "A String", # Status of an operation stage.
+ # Unset for single-stage operations.
+ },
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # operation is taking place. This field is deprecated, use location instead.
+ "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
+ "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.
+ "status": "A String", # The current status of the operation.
"name": "A String", # The server-assigned ID for the operation.
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"endTime": "A String", # [Output only] The time the operation completed, in
@@ -4095,44 +4133,6 @@
# in which the cluster resides.
"startTime": "A String", # [Output only] The time the operation started, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "status": "A String", # Status of an operation stage.
- # Unset for single-stage operations.
- "metrics": [ # Progress metric bundle, for example:
- # metrics: [{name: "nodes done", int_value: 15},
- # {name: "nodes total", int_value: 32}]
- # or
- # metrics: [{name: "progress", double_value: 0.56},
- # {name: "progress scale", double_value: 1.0}]
- { # Progress metric is (string, int|float|string) pair.
- "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- "intValue": "A String", # For metrics with integer value.
- },
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "zone": "A String", # The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # operation is taking place. This field is deprecated, use location instead.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "selfLink": "A String", # Server-defined URL for the resource.
- "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.
- "status": "A String", # The current status of the operation.
}</pre>
</div>
@@ -4151,22 +4151,28 @@
The object takes the form of:
{ # SetMaintenancePolicyRequest sets the maintenance policy for a cluster.
- "clusterId": "A String", # Required. The name of the cluster to update.
+ "name": "A String", # The name (project, location, cluster id) of the cluster to set maintenance
+ # policy.
+ # Specified in the format `projects/*/locations/*/clusters/*`.
"maintenancePolicy": { # MaintenancePolicy defines the maintenance policy to be used for the cluster. # Required. The maintenance policy to be set for the cluster. An empty field
# clears the existing maintenance policy.
"window": { # MaintenanceWindow defines the maintenance window to be used for the cluster. # Specifies the maintenance window in which maintenance may be performed.
- "dailyMaintenanceWindow": { # Time window specified for daily maintenance operations. # DailyMaintenanceWindow specifies a daily maintenance operation window.
- "duration": "A String", # [Output only] Duration of the time window, automatically chosen to be
- # smallest possible in the given scenario.
- # Duration will be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
- # format "PTnHnMnS".
- "startTime": "A String", # Time within the maintenance window to start the maintenance operations.
- # Time format should be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
- # format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
+ "maintenanceExclusions": { # Exceptions to maintenance window. Non-emergency maintenance should not
+ # occur in these windows.
+ "a_key": { # Represents an arbitrary window of time.
+ "endTime": "A String", # The time that the window ends. The end time should take place after the
+ # start time.
+ "startTime": "A String", # The time that the window first starts.
+ },
},
"recurringWindow": { # Represents an arbitrary window of time that recurs. # RecurringWindow specifies some number of recurring time periods for
# maintenance to occur. The time windows may be overlapping. If no
# maintenance windows are set, maintenance can occur at any time.
+ "window": { # Represents an arbitrary window of time. # The window of the first recurrence.
+ "endTime": "A String", # The time that the window ends. The end time should take place after the
+ # start time.
+ "startTime": "A String", # The time that the window first starts.
+ },
"recurrence": "A String", # An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how
# this window reccurs. They go on for the span of time between the start and
# end time.
@@ -4194,19 +4200,15 @@
# Note the start and end time's specific dates are largely arbitrary except
# to specify duration of the window and when it first starts.
# The FREQ values of HOURLY, MINUTELY, and SECONDLY are not supported.
- "window": { # Represents an arbitrary window of time. # The window of the first recurrence.
- "endTime": "A String", # The time that the window ends. The end time should take place after the
- # start time.
- "startTime": "A String", # The time that the window first starts.
- },
},
- "maintenanceExclusions": { # Exceptions to maintenance window. Non-emergency maintenance should not
- # occur in these windows.
- "a_key": { # Represents an arbitrary window of time.
- "endTime": "A String", # The time that the window ends. The end time should take place after the
- # start time.
- "startTime": "A String", # The time that the window first starts.
- },
+ "dailyMaintenanceWindow": { # Time window specified for daily maintenance operations. # DailyMaintenanceWindow specifies a daily maintenance operation window.
+ "startTime": "A String", # Time within the maintenance window to start the maintenance operations.
+ # Time format should be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
+ # format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
+ "duration": "A String", # [Output only] Duration of the time window, automatically chosen to be
+ # smallest possible in the given scenario.
+ # Duration will be in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)
+ # format "PTnHnMnS".
},
},
"resourceVersion": "A String", # A hash identifying the version of this policy, so that updates to fields of
@@ -4215,14 +4217,12 @@
# Make a <code>get()</code> request to the cluster to get the current
# resource version and include it with requests to set the policy.
},
- "name": "A String", # The name (project, location, cluster id) of the cluster to set maintenance
- # policy.
- # Specified in the format `projects/*/locations/*/clusters/*`.
"projectId": "A String", # Required. The Google Developers Console [project ID or project
# number](https://support.google.com/cloud/answer/6158840).
"zone": "A String", # Required. The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/zones#available) in which the
# cluster resides.
+ "clusterId": "A String", # Required. The name of the cluster to update.
}
x__xgafv: string, V1 error format.
@@ -4235,12 +4235,50 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
+ "name": "A String", # A non-parameterized string describing an operation stage.
+ # Unset for single-stage operations.
+ "stages": [ # Substages of an operation or a stage.
+ # Object with schema name: OperationProgress
+ ],
+ "metrics": [ # Progress metric bundle, for example:
+ # metrics: [{name: "nodes done", int_value: 15},
+ # {name: "nodes total", int_value: 32}]
+ # or
+ # metrics: [{name: "progress", double_value: 0.56},
+ # {name: "progress scale", double_value: 1.0}]
+ { # Progress metric is (string, int|float|string) pair.
+ "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
+ "doubleValue": 3.14, # For metrics with floating point value.
+ "intValue": "A String", # For metrics with integer value.
+ "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
+ },
+ ],
+ "status": "A String", # Status of an operation stage.
+ # Unset for single-stage operations.
+ },
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # operation is taking place. This field is deprecated, use location instead.
+ "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
+ "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.
+ "status": "A String", # The current status of the operation.
"name": "A String", # The server-assigned ID for the operation.
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"endTime": "A String", # [Output only] The time the operation completed, in
@@ -4252,44 +4290,6 @@
# in which the cluster resides.
"startTime": "A String", # [Output only] The time the operation started, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "status": "A String", # Status of an operation stage.
- # Unset for single-stage operations.
- "metrics": [ # Progress metric bundle, for example:
- # metrics: [{name: "nodes done", int_value: 15},
- # {name: "nodes total", int_value: 32}]
- # or
- # metrics: [{name: "progress", double_value: 0.56},
- # {name: "progress scale", double_value: 1.0}]
- { # Progress metric is (string, int|float|string) pair.
- "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- "intValue": "A String", # For metrics with integer value.
- },
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "zone": "A String", # The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # operation is taking place. This field is deprecated, use location instead.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "selfLink": "A String", # Server-defined URL for the resource.
- "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.
- "status": "A String", # The current status of the operation.
}</pre>
</div>
@@ -4313,10 +4313,6 @@
The object takes the form of:
{ # SetMasterAuthRequest updates the admin password of a cluster.
- "zone": "A String", # Deprecated. The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # cluster resides. This field has been deprecated and replaced by the name
- # field.
"name": "A String", # The name (project, location, cluster) of the cluster to set auth.
# Specified in the format `projects/*/locations/*/clusters/*`.
"action": "A String", # Required. The exact form of action to be taken on the master auth.
@@ -4328,13 +4324,6 @@
"update": { # The authentication information for accessing the master endpoint. # Required. A description of the update.
# Authentication can be done using HTTP basic auth or using client
# certificates.
- "clusterCaCertificate": "A String", # [Output only] Base64-encoded public certificate that is the root of
- # trust for the cluster.
- "clientCertificate": "A String", # [Output only] Base64-encoded public certificate used by clients to
- # authenticate to the cluster endpoint.
- "username": "A String", # The username to use for HTTP basic authentication to the master endpoint.
- # For clusters v1.6.0 and later, basic authentication can be disabled by
- # leaving username unspecified (or setting it to the empty string).
"password": "A String", # The password to use for HTTP basic authentication to the master endpoint.
# Because the master endpoint is open to the Internet, you should create a
# strong password. If a password is provided for cluster creation, username
@@ -4346,7 +4335,18 @@
},
"clientKey": "A String", # [Output only] Base64-encoded private key used by clients to authenticate
# to the cluster endpoint.
+ "clusterCaCertificate": "A String", # [Output only] Base64-encoded public certificate that is the root of
+ # trust for the cluster.
+ "clientCertificate": "A String", # [Output only] Base64-encoded public certificate used by clients to
+ # authenticate to the cluster endpoint.
+ "username": "A String", # The username to use for HTTP basic authentication to the master endpoint.
+ # For clusters v1.6.0 and later, basic authentication can be disabled by
+ # leaving username unspecified (or setting it to the empty string).
},
+ "zone": "A String", # Deprecated. The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # cluster resides. This field has been deprecated and replaced by the name
+ # field.
}
x__xgafv: string, V1 error format.
@@ -4359,12 +4359,50 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
+ "name": "A String", # A non-parameterized string describing an operation stage.
+ # Unset for single-stage operations.
+ "stages": [ # Substages of an operation or a stage.
+ # Object with schema name: OperationProgress
+ ],
+ "metrics": [ # Progress metric bundle, for example:
+ # metrics: [{name: "nodes done", int_value: 15},
+ # {name: "nodes total", int_value: 32}]
+ # or
+ # metrics: [{name: "progress", double_value: 0.56},
+ # {name: "progress scale", double_value: 1.0}]
+ { # Progress metric is (string, int|float|string) pair.
+ "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
+ "doubleValue": 3.14, # For metrics with floating point value.
+ "intValue": "A String", # For metrics with integer value.
+ "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
+ },
+ ],
+ "status": "A String", # Status of an operation stage.
+ # Unset for single-stage operations.
+ },
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # operation is taking place. This field is deprecated, use location instead.
+ "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
+ "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.
+ "status": "A String", # The current status of the operation.
"name": "A String", # The server-assigned ID for the operation.
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"endTime": "A String", # [Output only] The time the operation completed, in
@@ -4376,44 +4414,6 @@
# in which the cluster resides.
"startTime": "A String", # [Output only] The time the operation started, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "status": "A String", # Status of an operation stage.
- # Unset for single-stage operations.
- "metrics": [ # Progress metric bundle, for example:
- # metrics: [{name: "nodes done", int_value: 15},
- # {name: "nodes total", int_value: 32}]
- # or
- # metrics: [{name: "progress", double_value: 0.56},
- # {name: "progress scale", double_value: 1.0}]
- { # Progress metric is (string, int|float|string) pair.
- "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- "intValue": "A String", # For metrics with integer value.
- },
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "zone": "A String", # The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # operation is taking place. This field is deprecated, use location instead.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "selfLink": "A String", # Server-defined URL for the resource.
- "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.
- "status": "A String", # The current status of the operation.
}</pre>
</div>
@@ -4435,13 +4435,6 @@
The object takes the form of:
{ # SetNetworkPolicyRequest enables/disables network policy for a cluster.
- "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 name field.
- "zone": "A String", # Deprecated. The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # cluster resides. This field has been deprecated and replaced by the name
- # field.
"clusterId": "A String", # Deprecated. The name of the cluster.
# This field has been deprecated and replaced by the name field.
"networkPolicy": { # Configuration options for the NetworkPolicy feature. # Required. Configuration options for the NetworkPolicy feature.
@@ -4451,6 +4444,13 @@
},
"name": "A String", # The name (project, location, cluster id) of the cluster to set networking
# policy. 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 name field.
+ "zone": "A String", # Deprecated. The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # cluster resides. This field has been deprecated and replaced by the name
+ # field.
}
x__xgafv: string, V1 error format.
@@ -4463,12 +4463,50 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
+ "name": "A String", # A non-parameterized string describing an operation stage.
+ # Unset for single-stage operations.
+ "stages": [ # Substages of an operation or a stage.
+ # Object with schema name: OperationProgress
+ ],
+ "metrics": [ # Progress metric bundle, for example:
+ # metrics: [{name: "nodes done", int_value: 15},
+ # {name: "nodes total", int_value: 32}]
+ # or
+ # metrics: [{name: "progress", double_value: 0.56},
+ # {name: "progress scale", double_value: 1.0}]
+ { # Progress metric is (string, int|float|string) pair.
+ "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
+ "doubleValue": 3.14, # For metrics with floating point value.
+ "intValue": "A String", # For metrics with integer value.
+ "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
+ },
+ ],
+ "status": "A String", # Status of an operation stage.
+ # Unset for single-stage operations.
+ },
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # operation is taking place. This field is deprecated, use location instead.
+ "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
+ "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.
+ "status": "A String", # The current status of the operation.
"name": "A String", # The server-assigned ID for the operation.
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"endTime": "A String", # [Output only] The time the operation completed, in
@@ -4480,44 +4518,6 @@
# in which the cluster resides.
"startTime": "A String", # [Output only] The time the operation started, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "status": "A String", # Status of an operation stage.
- # Unset for single-stage operations.
- "metrics": [ # Progress metric bundle, for example:
- # metrics: [{name: "nodes done", int_value: 15},
- # {name: "nodes total", int_value: 32}]
- # or
- # metrics: [{name: "progress", double_value: 0.56},
- # {name: "progress scale", double_value: 1.0}]
- { # Progress metric is (string, int|float|string) pair.
- "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- "intValue": "A String", # For metrics with integer value.
- },
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "zone": "A String", # The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # operation is taking place. This field is deprecated, use location instead.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "selfLink": "A String", # Server-defined URL for the resource.
- "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.
- "status": "A String", # The current status of the operation.
}</pre>
</div>
@@ -4540,6 +4540,8 @@
{ # StartIPRotationRequest creates a new IP for the cluster and then performs
# a node upgrade on each node pool to point to the new IP.
+ "name": "A String", # The name (project, location, cluster id) of the cluster to start IP
+ # rotation. 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 name field.
@@ -4547,11 +4549,9 @@
# [zone](https://cloud.google.com/compute/docs/zones#available) in which the
# cluster resides. This field has been deprecated and replaced by the name
# field.
+ "rotateCredentials": True or False, # Whether to rotate credentials during IP rotation.
"clusterId": "A String", # Deprecated. The name of the cluster.
# This field has been deprecated and replaced by the name field.
- "rotateCredentials": True or False, # Whether to rotate credentials during IP rotation.
- "name": "A String", # The name (project, location, cluster id) of the cluster to start IP
- # rotation. Specified in the format `projects/*/locations/*/clusters/*`.
}
x__xgafv: string, V1 error format.
@@ -4564,12 +4564,50 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
+ "name": "A String", # A non-parameterized string describing an operation stage.
+ # Unset for single-stage operations.
+ "stages": [ # Substages of an operation or a stage.
+ # Object with schema name: OperationProgress
+ ],
+ "metrics": [ # Progress metric bundle, for example:
+ # metrics: [{name: "nodes done", int_value: 15},
+ # {name: "nodes total", int_value: 32}]
+ # or
+ # metrics: [{name: "progress", double_value: 0.56},
+ # {name: "progress scale", double_value: 1.0}]
+ { # Progress metric is (string, int|float|string) pair.
+ "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
+ "doubleValue": 3.14, # For metrics with floating point value.
+ "intValue": "A String", # For metrics with integer value.
+ "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
+ },
+ ],
+ "status": "A String", # Status of an operation stage.
+ # Unset for single-stage operations.
+ },
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # operation is taking place. This field is deprecated, use location instead.
+ "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
+ "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.
+ "status": "A String", # The current status of the operation.
"name": "A String", # The server-assigned ID for the operation.
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"endTime": "A String", # [Output only] The time the operation completed, in
@@ -4581,44 +4619,6 @@
# in which the cluster resides.
"startTime": "A String", # [Output only] The time the operation started, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "status": "A String", # Status of an operation stage.
- # Unset for single-stage operations.
- "metrics": [ # Progress metric bundle, for example:
- # metrics: [{name: "nodes done", int_value: 15},
- # {name: "nodes total", int_value: 32}]
- # or
- # metrics: [{name: "progress", double_value: 0.56},
- # {name: "progress scale", double_value: 1.0}]
- { # Progress metric is (string, int|float|string) pair.
- "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- "intValue": "A String", # For metrics with integer value.
- },
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "zone": "A String", # The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # operation is taking place. This field is deprecated, use location instead.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "selfLink": "A String", # Server-defined URL for the resource.
- "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.
- "status": "A String", # The current status of the operation.
}</pre>
</div>
@@ -4643,6 +4643,49 @@
"update": { # ClusterUpdate describes an update to the cluster. Exactly one update can # Required. A description of the update.
# be applied to a cluster with each request, so at most one field can be
# provided.
+ "desiredImageType": "A String", # The desired image type for the node pool.
+ # NOTE: Set the "desired_node_pool" field as well.
+ "desiredWorkloadIdentityConfig": { # Configuration for the use of Kubernetes Service Accounts in GCP IAM # Configuration for Workload Identity.
+ # policies.
+ "workloadPool": "A String", # The workload pool to attach all Kubernetes service accounts to.
+ },
+ "desiredNodePoolId": "A String", # The node pool to be upgraded. This field is mandatory if
+ # "desired_node_version", "desired_image_family" or
+ # "desired_node_pool_autoscaling" is specified and there is more than one
+ # node pool on the cluster.
+ "desiredMasterVersion": "A String", # 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
+ "desiredShieldedNodes": { # Configuration of Shielded Nodes feature. # Configuration for Shielded Nodes.
+ "enabled": True or False, # Whether Shielded Nodes features are enabled on all nodes in this cluster.
+ },
+ "desiredLoggingService": "A String", # The logging service the cluster should use to write logs.
+ # Currently available options:
+ #
+ # * `logging.googleapis.com/kubernetes` - The Cloud Logging
+ # service with a Kubernetes-native resource model
+ # * `logging.googleapis.com` - The legacy Cloud Logging service (no longer
+ # available as of GKE 1.15).
+ # * `none` - no logs will be exported from the cluster.
+ #
+ # If left as an empty string,`logging.googleapis.com/kubernetes` will be
+ # used for GKE 1.14+ or `logging.googleapis.com` for earlier versions.
+ "desiredVerticalPodAutoscaling": { # VerticalPodAutoscaling contains global, per-cluster information # Cluster-level Vertical Pod Autoscaling configuration.
+ # required by Vertical Pod Autoscaler to automatically adjust
+ # the resources of pods controlled by it.
+ "enabled": True or False, # Enables vertical pod autoscaling.
+ },
+ "desiredBinaryAuthorization": { # Configuration for Binary Authorization. # The desired configuration options for the Binary Authorization feature.
+ "enabled": True or False, # Enable Binary Authorization for this cluster. If enabled, all container
+ # images will be validated by Binary Authorization.
+ },
"desiredAddonsConfig": { # Configuration for the addons that can be automatically spun up in the # Configurations for the various addons available to run in the cluster.
# cluster, enabling additional functionality.
"networkPolicyConfig": { # Configuration for NetworkPolicy. This only tracks whether the addon # Configuration for NetworkPolicy. This only tracks whether the addon
@@ -4708,37 +4751,37 @@
# amount of resources in the cluster.
{ # Contains information about amount of some resource in the cluster.
# For memory, value should be in GB.
+ "minimum": "A String", # Minimum amount of the resource in the cluster.
"maximum": "A String", # Maximum amount of the resource in the cluster.
"resourceType": "A String", # Resource name "cpu", "memory" or gpu-specific string.
- "minimum": "A String", # Minimum amount of the resource in the cluster.
},
],
"enableNodeAutoprovisioning": True or False, # Enables automatic node pool creation and deletion.
"autoprovisioningNodePoolDefaults": { # AutoprovisioningNodePoolDefaults contains defaults for a node pool created # AutoprovisioningNodePoolDefaults contains defaults for a node pool
# created by NAP.
# by NAP.
- "oauthScopes": [ # Scopes that are used by NAP when creating node pools. If oauth_scopes are
- # specified, service_account should be empty.
- "A String",
- ],
"management": { # NodeManagement defines the set of node management services turned on for the # Specifies the node management options for NAP created node-pools.
# node pool.
"upgradeOptions": { # AutoUpgradeOptions defines the set of options for the user to control how # Specifies the Auto Upgrade knobs for the node pool.
# the Auto Upgrades will proceed.
- "description": "A String", # [Output only] This field is set when upgrades are about to commence
- # with the description of the upgrade.
"autoUpgradeStartTime": "A String", # [Output only] This field is set when upgrades are about to commence
# with the approximate start time for the upgrades, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "description": "A String", # [Output only] This field is set when upgrades are about to commence
+ # with the description of the upgrade.
},
- "autoUpgrade": True or False, # A flag that specifies whether node auto-upgrade is enabled for the node
- # pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
- # up to date with the latest release version of Kubernetes.
"autoRepair": True or False, # A flag that specifies whether the node auto-repair is enabled for the node
# pool. If enabled, the nodes in this node pool will be monitored and, if
# they fail health checks too many times, an automatic repair action will be
# triggered.
+ "autoUpgrade": True or False, # A flag that specifies whether node auto-upgrade is enabled for the node
+ # pool. If enabled, node auto-upgrade helps keep the nodes in your node pool
+ # up to date with the latest release version of Kubernetes.
},
+ "oauthScopes": [ # Scopes that are used by NAP when creating node pools. If oauth_scopes are
+ # specified, service_account should be empty.
+ "A String",
+ ],
"upgradeSettings": { # These upgrade settings control the level of parallelism and the level of # Specifies the upgrade settings for NAP created node pools
# disruption caused by an upgrade.
#
@@ -4781,7 +4824,6 @@
# master authorized networks will disallow all external traffic to access
# Kubernetes master through HTTPS except traffic from the given CIDR blocks,
# Google Compute Engine Public IPs and Google Prod IPs.
- "enabled": True or False, # Whether or not master authorized networks is enabled.
"cidrBlocks": [ # cidr_blocks define up to 50 external networks that could access
# Kubernetes master through HTTPS.
{ # CidrBlock contains an optional name and one CIDR block.
@@ -4789,6 +4831,7 @@
"cidrBlock": "A String", # cidr_block must be specified in CIDR notation.
},
],
+ "enabled": True or False, # Whether or not master authorized networks is enabled.
},
"desiredResourceUsageExportConfig": { # Configuration for exporting cluster resource usages. # The desired configuration for exporting resource usage.
"enableNetworkEgressMetering": True or False, # Whether to enable network egress metering for this cluster. If enabled, a
@@ -4807,12 +4850,12 @@
# cluster and desired_node_pool_id is not provided then
# the change applies to that single node pool.
# adjust the size of the node pool to the current cluster usage.
- "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.
+ "autoprovisioned": True or False, # Can this node pool be deleted automatically.
"minNodeCount": 42, # Minimum number of nodes in the NodePool. Must be >= 1 and <=
# max_node_count.
- "autoprovisioned": True or False, # Can this node pool be deleted automatically.
+ "enabled": True or False, # Is autoscaling enabled for this node pool.
},
"desiredLocations": [ # The desired list of Google Compute Engine
# [zones](https://cloud.google.com/compute/docs/zones#available) in which the
@@ -4834,49 +4877,6 @@
#
# If left as an empty string,`monitoring.googleapis.com/kubernetes` will be
# used for GKE 1.14+ or `monitoring.googleapis.com` for earlier versions.
- "desiredImageType": "A String", # The desired image type for the node pool.
- # NOTE: Set the "desired_node_pool" field as well.
- "desiredWorkloadIdentityConfig": { # Configuration for the use of Kubernetes Service Accounts in GCP IAM # Configuration for Workload Identity.
- # policies.
- "workloadPool": "A String", # The workload pool to attach all Kubernetes service accounts to.
- },
- "desiredNodePoolId": "A String", # The node pool to be upgraded. This field is mandatory if
- # "desired_node_version", "desired_image_family" or
- # "desired_node_pool_autoscaling" is specified and there is more than one
- # node pool on the cluster.
- "desiredShieldedNodes": { # Configuration of Shielded Nodes feature. # Configuration for Shielded Nodes.
- "enabled": True or False, # Whether Shielded Nodes features are enabled on all nodes in this cluster.
- },
- "desiredMasterVersion": "A String", # 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
- "desiredLoggingService": "A String", # The logging service the cluster should use to write logs.
- # Currently available options:
- #
- # * `logging.googleapis.com/kubernetes` - The Cloud Logging
- # service with a Kubernetes-native resource model
- # * `logging.googleapis.com` - The legacy Cloud Logging service (no longer
- # available as of GKE 1.15).
- # * `none` - no logs will be exported from the cluster.
- #
- # If left as an empty string,`logging.googleapis.com/kubernetes` will be
- # used for GKE 1.14+ or `logging.googleapis.com` for earlier versions.
- "desiredVerticalPodAutoscaling": { # VerticalPodAutoscaling contains global, per-cluster information # Cluster-level Vertical Pod Autoscaling configuration.
- # required by Vertical Pod Autoscaler to automatically adjust
- # the resources of pods controlled by it.
- "enabled": True or False, # Enables vertical pod autoscaling.
- },
- "desiredBinaryAuthorization": { # Configuration for Binary Authorization. # The desired configuration options for the Binary Authorization feature.
- "enabled": True or False, # Enable Binary Authorization for this cluster. If enabled, all container
- # images will be validated by Binary Authorization.
- },
},
"name": "A String", # The name (project, location, cluster) of the cluster to update.
# Specified in the format `projects/*/locations/*/clusters/*`.
@@ -4901,12 +4901,50 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
+ "name": "A String", # A non-parameterized string describing an operation stage.
+ # Unset for single-stage operations.
+ "stages": [ # Substages of an operation or a stage.
+ # Object with schema name: OperationProgress
+ ],
+ "metrics": [ # Progress metric bundle, for example:
+ # metrics: [{name: "nodes done", int_value: 15},
+ # {name: "nodes total", int_value: 32}]
+ # or
+ # metrics: [{name: "progress", double_value: 0.56},
+ # {name: "progress scale", double_value: 1.0}]
+ { # Progress metric is (string, int|float|string) pair.
+ "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
+ "doubleValue": 3.14, # For metrics with floating point value.
+ "intValue": "A String", # For metrics with integer value.
+ "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
+ },
+ ],
+ "status": "A String", # Status of an operation stage.
+ # Unset for single-stage operations.
+ },
+ "zone": "A String", # The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # operation is taking place. This field is deprecated, use location instead.
+ "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
+ "selfLink": "A String", # Server-defined URL for the resource.
+ "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.
+ "status": "A String", # The current status of the operation.
"name": "A String", # The server-assigned ID for the operation.
"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
+ "message": "A String", # Human-friendly representation of the condition
},
],
"endTime": "A String", # [Output only] The time the operation completed, in
@@ -4918,44 +4956,6 @@
# in which the cluster resides.
"startTime": "A String", # [Output only] The time the operation started, in
# [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "status": "A String", # Status of an operation stage.
- # Unset for single-stage operations.
- "metrics": [ # Progress metric bundle, for example:
- # metrics: [{name: "nodes done", int_value: 15},
- # {name: "nodes total", int_value: 32}]
- # or
- # metrics: [{name: "progress", double_value: 0.56},
- # {name: "progress scale", double_value: 1.0}]
- { # Progress metric is (string, int|float|string) pair.
- "stringValue": "A String", # For metrics with custom values (ratios, visual progress, etc.).
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- "intValue": "A String", # For metrics with integer value.
- },
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "zone": "A String", # The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # operation is taking place. This field is deprecated, use location instead.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "selfLink": "A String", # Server-defined URL for the resource.
- "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.
- "status": "A String", # The current status of the operation.
}</pre>
</div>