docs: docs update (#911)
Thank you for opening a Pull Request! Before submitting your PR, there are a few things you can do to make sure it goes smoothly:
- [ ] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/google-api-python-client/issues/new/choose) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea
- [ ] Ensure the tests and linter pass
- [ ] Code coverage does not decrease (if any source code was changed)
- [ ] Appropriate docs were updated (if necessary)
Fixes #<issue_number_goes_here> 🦕
diff --git a/docs/dyn/container_v1beta1.projects.zones.clusters.html b/docs/dyn/container_v1beta1.projects.zones.clusters.html
index 8126a39..58bd5ab 100644
--- a/docs/dyn/container_v1beta1.projects.zones.clusters.html
+++ b/docs/dyn/container_v1beta1.projects.zones.clusters.html
@@ -149,76 +149,76 @@
The object takes the form of:
{ # SetAddonsRequest sets the addons associated with the cluster.
- "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
+ "name": "A String", # The name (project, location, cluster) of the cluster to set addons.
+ # Specified in the format `projects/*/locations/*/clusters/*`.
+ "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
# number](https://support.google.com/cloud/answer/6158840).
# This field has been deprecated and replaced by the name field.
- "addonsConfig": { # Configuration for the addons that can be automatically spun up in the # Required. The desired configurations for the various addons available to run in the
+ "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # cluster resides. This field has been deprecated and replaced by the name
+ # field.
+ "clusterId": "A String", # Required. Deprecated. The name of the cluster to upgrade.
+ # This field has been deprecated and replaced by the name field.
+ "addonsConfig": { # Configuration for the addons that can be automatically spun up in the # Required. The desired 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
+ "networkPolicyConfig": { # Configuration for NetworkPolicy. This only tracks whether the addon # Configuration for NetworkPolicy. This only tracks whether the addon
# is enabled or not on the Master, it does not track whether network policy
# is enabled for the nodes.
# is enabled or not on the Master, it does not track whether network policy
# is enabled for the nodes.
- "disabled": True or False, # Whether NetworkPolicy is enabled for this cluster.
+ "disabled": True or False, # Whether NetworkPolicy is enabled for this cluster.
},
- "cloudRunConfig": { # Configuration options for the Cloud Run feature. # Configuration for the Cloud Run addon. The `IstioConfig` addon must be
+ "configConnectorConfig": { # Configuration options for the Config Connector add-on. # Configuration for the ConfigConnector add-on, a Kubernetes
+ # extension to manage hosted GCP services through the Kubernetes API
+ "enabled": True or False, # Whether Cloud Connector is enabled for this cluster.
+ },
+ "cloudRunConfig": { # Configuration options for the Cloud Run feature. # Configuration for the Cloud Run addon. The `IstioConfig` addon must be
# enabled in order to enable Cloud Run addon. This option can only be enabled
# at cluster creation time.
- "disabled": True or False, # Whether Cloud Run addon is enabled for this cluster.
+ "disabled": True or False, # Whether Cloud Run addon is enabled for this cluster.
},
- "httpLoadBalancing": { # Configuration options for the HTTP (L7) load balancing controller addon, # Configuration for the HTTP (L7) load balancing controller addon, which
- # makes it easy to set up HTTP load balancers for services in a cluster.
- # which makes it easy to set up HTTP load balancers for services in a cluster.
- "disabled": True or False, # Whether the HTTP Load Balancing controller is enabled in the cluster.
- # When enabled, it runs a small pod in the cluster that manages the load
- # balancers.
- },
- "kalmConfig": { # Configuration options for the KALM addon. # Configuration for the KALM addon, which manages the lifecycle of k8s
- # applications.
- "enabled": True or False, # Whether KALM is enabled for this cluster.
- },
- "horizontalPodAutoscaling": { # Configuration options for the horizontal pod autoscaling feature, which # Configuration for the horizontal pod autoscaling feature, which
+ "horizontalPodAutoscaling": { # Configuration options for the horizontal pod autoscaling feature, which # Configuration for the horizontal pod autoscaling feature, which
# increases or decreases the number of replica pods a replication controller
# has based on the resource usage of the existing pods.
# increases or decreases the number of replica pods a replication controller
# has based on the resource usage of the existing pods.
- "disabled": True or False, # Whether the Horizontal Pod Autoscaling feature is enabled in the cluster.
+ "disabled": True or False, # Whether the Horizontal Pod Autoscaling feature is enabled in the cluster.
# When enabled, it ensures that metrics are collected into Stackdriver
# Monitoring.
},
- "gcePersistentDiskCsiDriverConfig": { # Configuration for the Compute Engine PD CSI driver. This option can only be # Configuration for the Compute Engine Persistent Disk CSI driver.
- # enabled at cluster creation time.
- "enabled": True or False, # Whether the Compute Engine PD CSI driver is enabled for this cluster.
+ "httpLoadBalancing": { # Configuration options for the HTTP (L7) load balancing controller addon, # Configuration for the HTTP (L7) load balancing controller addon, which
+ # makes it easy to set up HTTP load balancers for services in a cluster.
+ # which makes it easy to set up HTTP load balancers for services in a cluster.
+ "disabled": True or False, # Whether the HTTP Load Balancing controller is enabled in the cluster.
+ # When enabled, it runs a small pod in the cluster that manages the load
+ # balancers.
},
- "configConnectorConfig": { # Configuration options for the Config Connector add-on. # Configuration for the ConfigConnector add-on, a Kubernetes
- # extension to manage hosted GCP services through the Kubernetes API
- "enabled": True or False, # Whether Cloud Connector is enabled for this cluster.
- },
- "dnsCacheConfig": { # Configuration for NodeLocal DNSCache # Configuration for NodeLocalDNS, a dns cache running on cluster nodes
- "enabled": True or False, # Whether NodeLocal DNSCache is enabled for this cluster.
- },
- "istioConfig": { # Configuration options for Istio addon. # Configuration for Istio, an open platform to connect, manage, and secure
- # microservices.
- "disabled": True or False, # Whether Istio is enabled for this cluster.
- "auth": "A String", # The specified Istio auth mode, either none, or mutual TLS.
- },
- "kubernetesDashboard": { # Configuration for the Kubernetes Dashboard. # Configuration for the Kubernetes Dashboard.
+ "kubernetesDashboard": { # Configuration for the Kubernetes Dashboard. # Configuration for the Kubernetes Dashboard.
# This addon is deprecated, and will be disabled in 1.15. It is recommended
# to use the Cloud Console to manage and monitor your Kubernetes clusters,
# workloads and applications. For more information, see:
# https://cloud.google.com/kubernetes-engine/docs/concepts/dashboards
- "disabled": True or False, # Whether the Kubernetes Dashboard is enabled for this cluster.
+ "disabled": True or False, # Whether the Kubernetes Dashboard is enabled for this cluster.
+ },
+ "dnsCacheConfig": { # Configuration for NodeLocal DNSCache # Configuration for NodeLocalDNS, a dns cache running on cluster nodes
+ "enabled": True or False, # Whether NodeLocal DNSCache is enabled for this cluster.
+ },
+ "kalmConfig": { # Configuration options for the KALM addon. # Configuration for the KALM addon, which manages the lifecycle of k8s
+ # applications.
+ "enabled": True or False, # Whether KALM is enabled for this cluster.
+ },
+ "gcePersistentDiskCsiDriverConfig": { # Configuration for the Compute Engine PD CSI driver. This option can only be # Configuration for the Compute Engine Persistent Disk CSI driver.
+ # enabled at cluster creation time.
+ "enabled": True or False, # Whether the Compute Engine PD CSI driver is enabled for this cluster.
+ },
+ "istioConfig": { # Configuration options for Istio addon. # Configuration for Istio, an open platform to connect, manage, and secure
+ # microservices.
+ "disabled": True or False, # Whether Istio is enabled for this cluster.
+ "auth": "A String", # The specified Istio auth mode, either none, or mutual TLS.
},
},
- "clusterId": "A String", # Required. 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 addons.
- # Specified in the format 'projects/*/locations/*/clusters/*'.
- "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # cluster resides. This field has been deprecated and replaced by the name
- # field.
}
x__xgafv: string, V1 error format.
@@ -231,61 +231,61 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
- "status": "A String", # The current status of the operation.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "endTime": "A String", # [Output only] The time the operation completed, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "name": "A String", # The server-assigned ID for the operation.
- "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.
- "clusterConditions": [ # Which conditions caused the current cluster state.
+ "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
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
],
- "startTime": "A String", # [Output only] The time the operation started, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
- "operationType": "A String", # The operation type.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "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.).
- "intValue": "A String", # For metrics with integer value.
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- },
- ],
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "selfLink": "A String", # Server-defined URL for the resource.
- "location": "A String", # [Output only] The name of the Google Compute Engine
+ "location": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "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.
+ "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.
+ "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.).
+ },
+ ],
+ "name": "A String", # A non-parameterized string describing 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.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "detail": "A String", # Detailed operation progress, if available.
+ "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.
}</pre>
</div>
@@ -307,17 +307,17 @@
The object takes the form of:
{ # CompleteIPRotationRequest moves the cluster master back into single-IP mode.
- "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
+ "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", # Required. Deprecated. The Google Developers Console [project ID or project
# number](https://developers.google.com/console/help/new/#projectnumber).
# This field has been deprecated and replaced by the name field.
- "clusterId": "A String", # Required. 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/*'.
- "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
+ "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/zones#available) in which the
# cluster resides. This field has been deprecated and replaced by the name
# field.
+ "clusterId": "A String", # Required. Deprecated. The name of the cluster.
+ # This field has been deprecated and replaced by the name field.
}
x__xgafv: string, V1 error format.
@@ -330,61 +330,61 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
- "status": "A String", # The current status of the operation.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "endTime": "A String", # [Output only] The time the operation completed, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "name": "A String", # The server-assigned ID for the operation.
- "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.
- "clusterConditions": [ # Which conditions caused the current cluster state.
+ "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
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
],
- "startTime": "A String", # [Output only] The time the operation started, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
- "operationType": "A String", # The operation type.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "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.).
- "intValue": "A String", # For metrics with integer value.
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- },
- ],
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "selfLink": "A String", # Server-defined URL for the resource.
- "location": "A String", # [Output only] The name of the Google Compute Engine
+ "location": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "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.
+ "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.
+ "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.).
+ },
+ ],
+ "name": "A String", # A non-parameterized string describing 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.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "detail": "A String", # Detailed operation progress, if available.
+ "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.
}</pre>
</div>
@@ -393,7 +393,7 @@
<pre>Creates a cluster, consisting of the specified number and type of Google
Compute Engine instances.
-By default, the cluster is created in the project's
+By default, the cluster is created in the project's
[default
network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks).
@@ -402,7 +402,7 @@
on that node to communicate with all other instances in the
cluster.
-Finally, an entry is added to the project's global metadata indicating
+Finally, an entry is added to the project's global metadata indicating
which CIDR range the cluster is using.
Args:
@@ -417,38 +417,180 @@
The object takes the form of:
{ # CreateClusterRequest creates a cluster.
- "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
+ "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
# number](https://support.google.com/cloud/answer/6158840).
# This field has been deprecated and replaced by the parent field.
- "parent": "A String", # The parent (project and location) where the cluster will be created.
- # Specified in the format 'projects/*/locations/*'.
- "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # cluster resides. This field has been deprecated and replaced by the parent
- # field.
- "cluster": { # A Google Kubernetes Engine cluster. # Required. A [cluster
+ "cluster": { # A Google Kubernetes Engine cluster. # Required. A [cluster
# resource](https://cloud.google.com/container-engine/reference/rest/v1beta1/projects.zones.clusters)
- "nodeIpv4CidrSize": 42, # [Output only] The size of the address space on each node for hosting
+ "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.
+ "maxPodsPerNode": "A String", # Constraint enforced on the max num of pods per node.
+ },
+ "network": "A String", # The name of the Google Compute Engine
+ # [network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks)
+ # to which the cluster is connected. If left unspecified, the `default`
+ # network will be used. On output this shows the network ID instead of the
+ # name.
+ "labelFingerprint": "A String", # The fingerprint of the set of labels for this cluster.
+ "nodeIpv4CidrSize": 42, # [Output only] The size of the address space on each node for hosting
# containers. This is provisioned from within the `container_ipv4_cidr`
# range. This field will only be set when cluster is in route-based network
# mode.
- "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.
- "recurringWindow": { # Represents an arbitrary window of time that recurs. # RecurringWindow specifies some number of recurring time periods for
+ "masterAuthorizedNetworksConfig": { # Configuration options for the master authorized networks feature. Enabled # The configuration options for master authorized networks feature.
+ # 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.
+ "cidrBlocks": [ # cidr_blocks define up to 10 external networks that could access
+ # Kubernetes master through HTTPS.
+ { # CidrBlock contains an optional name and one CIDR block.
+ "displayName": "A String", # display_name is an optional field for users to identify CIDR blocks.
+ "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.
+ "masterAuth": { # The authentication information for accessing the master endpoint. # The authentication information for accessing the master endpoint.
+ # If unspecified, the defaults are used:
+ # For clusters before v1.12, if master_auth is unspecified, `username` will
+ # be set to "admin", a random password will be generated, and a client
+ # certificate will be issued.
+ # Authentication can be done using HTTP basic auth or using client
+ # certificates.
+ "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
+ # must be non-empty.
+ "clientCertificateConfig": { # Configuration for client certificates on the cluster. # Configuration for client certificate authentication on the cluster. For
+ # clusters before v1.12, if no configuration is specified, a client
+ # certificate is issued.
+ "issueClientCertificate": True or False, # Issue a client certificate.
+ },
+ "clientKey": "A String", # [Output only] Base64-encoded private key used by clients to authenticate
+ # to the cluster endpoint.
+ "clusterCaCertificate": "A String",
+ "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
+ # during authentication using a group of security groups.
+ "securityGroup": "A String", # The name of the security group-of-groups to be used. Only relevant
+ # if enabled = true.
+ },
+ "masterIpv4CidrBlock": "A String", # The IP prefix in CIDR notation to use for the hosted master network.
+ # This prefix will be used for assigning private IP addresses to the
+ # master or set of masters, as well as the ILB VIP.
+ # This field is deprecated, use
+ # private_cluster_config.master_ipv4_cidr_block instead.
+ "clusterTelemetry": { # Telemetry integration for the cluster. # Telemetry integration for the cluster.
+ "type": "A String", # Type of the integration.
+ },
+ "currentMasterVersion": "A String", # [Output only] The current software version of the master endpoint.
+ "addonsConfig": { # 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
+ # is enabled or not on the Master, it does not track whether network policy
+ # is enabled for the nodes.
+ # is enabled or not on the Master, it does not track whether network policy
+ # is enabled for the nodes.
+ "disabled": True or False, # Whether NetworkPolicy is enabled for this cluster.
+ },
+ "configConnectorConfig": { # Configuration options for the Config Connector add-on. # Configuration for the ConfigConnector add-on, a Kubernetes
+ # extension to manage hosted GCP services through the Kubernetes API
+ "enabled": True or False, # Whether Cloud Connector is enabled for this cluster.
+ },
+ "cloudRunConfig": { # Configuration options for the Cloud Run feature. # Configuration for the Cloud Run addon. The `IstioConfig` addon must be
+ # enabled in order to enable Cloud Run addon. This option can only be enabled
+ # at cluster creation time.
+ "disabled": True or False, # Whether Cloud Run addon is enabled for this cluster.
+ },
+ "horizontalPodAutoscaling": { # Configuration options for the horizontal pod autoscaling feature, which # Configuration for the horizontal pod autoscaling feature, which
+ # increases or decreases the number of replica pods a replication controller
+ # has based on the resource usage of the existing pods.
+ # increases or decreases the number of replica pods a replication controller
+ # has based on the resource usage of the existing pods.
+ "disabled": True or False, # Whether the Horizontal Pod Autoscaling feature is enabled in the cluster.
+ # When enabled, it ensures that metrics are collected into Stackdriver
+ # Monitoring.
+ },
+ "httpLoadBalancing": { # Configuration options for the HTTP (L7) load balancing controller addon, # Configuration for the HTTP (L7) load balancing controller addon, which
+ # makes it easy to set up HTTP load balancers for services in a cluster.
+ # which makes it easy to set up HTTP load balancers for services in a cluster.
+ "disabled": True or False, # Whether the HTTP Load Balancing controller is enabled in the cluster.
+ # When enabled, it runs a small pod in the cluster that manages the load
+ # balancers.
+ },
+ "kubernetesDashboard": { # Configuration for the Kubernetes Dashboard. # Configuration for the Kubernetes Dashboard.
+ # This addon is deprecated, and will be disabled in 1.15. It is recommended
+ # to use the Cloud Console to manage and monitor your Kubernetes clusters,
+ # workloads and applications. For more information, see:
+ # https://cloud.google.com/kubernetes-engine/docs/concepts/dashboards
+ "disabled": True or False, # Whether the Kubernetes Dashboard is enabled for this cluster.
+ },
+ "dnsCacheConfig": { # Configuration for NodeLocal DNSCache # Configuration for NodeLocalDNS, a dns cache running on cluster nodes
+ "enabled": True or False, # Whether NodeLocal DNSCache is enabled for this cluster.
+ },
+ "kalmConfig": { # Configuration options for the KALM addon. # Configuration for the KALM addon, which manages the lifecycle of k8s
+ # applications.
+ "enabled": True or False, # Whether KALM is enabled for this cluster.
+ },
+ "gcePersistentDiskCsiDriverConfig": { # Configuration for the Compute Engine PD CSI driver. This option can only be # Configuration for the Compute Engine Persistent Disk CSI driver.
+ # enabled at cluster creation time.
+ "enabled": True or False, # Whether the Compute Engine PD CSI driver is enabled for this cluster.
+ },
+ "istioConfig": { # Configuration options for Istio addon. # Configuration for Istio, an open platform to connect, manage, and secure
+ # microservices.
+ "disabled": True or False, # Whether Istio is enabled for this cluster.
+ "auth": "A String", # The specified Istio auth mode, either none, or mutual TLS.
+ },
+ },
+ "podSecurityPolicyConfig": { # Configuration for the PodSecurityPolicy feature. # Configuration for the PodSecurityPolicy feature.
+ "enabled": True or False, # Enable the PodSecurityPolicy controller for this cluster. If enabled, pods
+ # must be valid under a PodSecurityPolicy to be created.
+ },
+ "currentNodeVersion": "A String", # [Output only] Deprecated, use
+ # [NodePool.version](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters.nodePools)
+ # instead. The current version of the node software components.
+ # If they are currently at multiple versions because they're in the process
+ # of being upgraded, this reflects the minimum version of all nodes.
+ "subnetwork": "A String", # The name of the Google Compute Engine
+ # [subnetwork](https://cloud.google.com/compute/docs/subnetworks) to which
+ # the cluster is connected. On output this shows the subnetwork ID instead of
+ # the name.
+ "maintenancePolicy": { # MaintenancePolicy defines the maintenance policy to be used for the cluster. # Configure the maintenance policy for this cluster.
+ "resourceVersion": "A String", # A hash identifying the version of this policy, so that updates to fields of
+ # the policy won't accidentally undo intermediate changes (and so that users
+ # of the API unaware of some fields won't accidentally remove other fields).
+ # Make a <code>get()</code> request to the cluster to get the current
+ # resource version and include it with requests to set the 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.
+ "startTime": "A String", # Time within the maintenance window to start the maintenance operations.
+ # It must be in format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
+ },
+ "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.
- "recurrence": "A String", # An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how
+ "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.
#
- # For example, to have something repeat every weekday, you'd use:
+ # For example, to have something repeat every weekday, you'd use:
# <code>FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR</code>
# To repeat some window daily (equivalent to the DailyMaintenanceWindow):
# <code>FREQ=DAILY</code>
# For the first weekend of every month:
# <code>FREQ=MONTHLY;BYSETPOS=1;BYDAY=SA,SU</code>
# This specifies how frequently the window starts. Eg, if you wanted to have
- # a 9-5 UTC-4 window every weekday, you'd use something like:
+ # a 9-5 UTC-4 window every weekday, you'd use something like:
# <code>
# start time = 2019-01-01T09:00:00-0400
# end time = 2019-01-01T17:00:00-0400
@@ -461,279 +603,48 @@
# end time = 2019-01-07T23:59:00Z
# recurrence = FREQ=WEEKLY;BYDAY=SA
# </code>
- # Note the start and end time's specific dates are largely arbitrary except
+ # 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
+ "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.
+ "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.
- "duration": "A String", # [Output only] Duration of the time window, automatically chosen to be
- # smallest possible in the given scenario.
- "startTime": "A String", # Time within the maintenance window to start the maintenance operations.
- # It must be in format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
- },
- "maintenanceExclusions": { # Exceptions to maintenance window. Non-emergency maintenance should not
+ "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
+ "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.
+ "startTime": "A String", # The time that the window first starts.
},
},
},
- "resourceVersion": "A String", # A hash identifying the version of this policy, so that updates to fields of
- # the policy won't accidentally undo intermediate changes (and so that users
- # of the API unaware of some fields won't accidentally remove other fields).
- # Make a <code>get()</code> request to the cluster to get the current
- # resource version and include it with requests to set the policy.
},
- "networkPolicy": { # Configuration options for the NetworkPolicy feature. # Configuration options for the NetworkPolicy feature.
- # https://kubernetes.io/docs/concepts/services-networking/networkpolicies/
- "enabled": True or False, # Whether network policy is enabled on the cluster.
- "provider": "A String", # The selected network policy provider.
+ "resourceLabels": { # The resource labels for the cluster to use to annotate any related
+ # Google Compute Engine resources.
+ "a_key": "A String",
},
- "masterAuthorizedNetworksConfig": { # Configuration options for the master authorized networks feature. Enabled # The configuration options for master authorized networks feature.
- # 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 10 external networks that could access
- # Kubernetes master through HTTPS.
- { # CidrBlock contains an optional name and one CIDR block.
- "cidrBlock": "A String", # cidr_block must be specified in CIDR notation.
- "displayName": "A String", # display_name is an optional field for users to identify CIDR blocks.
- },
- ],
- },
- "addonsConfig": { # 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
- # is enabled or not on the Master, it does not track whether network policy
- # is enabled for the nodes.
- # is enabled or not on the Master, it does not track whether network policy
- # is enabled for the nodes.
- "disabled": True or False, # Whether NetworkPolicy is enabled for this cluster.
- },
- "cloudRunConfig": { # Configuration options for the Cloud Run feature. # Configuration for the Cloud Run addon. The `IstioConfig` addon must be
- # enabled in order to enable Cloud Run addon. This option can only be enabled
- # at cluster creation time.
- "disabled": True or False, # Whether Cloud Run addon is enabled for this cluster.
- },
- "httpLoadBalancing": { # Configuration options for the HTTP (L7) load balancing controller addon, # Configuration for the HTTP (L7) load balancing controller addon, which
- # makes it easy to set up HTTP load balancers for services in a cluster.
- # which makes it easy to set up HTTP load balancers for services in a cluster.
- "disabled": True or False, # Whether the HTTP Load Balancing controller is enabled in the cluster.
- # When enabled, it runs a small pod in the cluster that manages the load
- # balancers.
- },
- "kalmConfig": { # Configuration options for the KALM addon. # Configuration for the KALM addon, which manages the lifecycle of k8s
- # applications.
- "enabled": True or False, # Whether KALM is enabled for this cluster.
- },
- "horizontalPodAutoscaling": { # Configuration options for the horizontal pod autoscaling feature, which # Configuration for the horizontal pod autoscaling feature, which
- # increases or decreases the number of replica pods a replication controller
- # has based on the resource usage of the existing pods.
- # increases or decreases the number of replica pods a replication controller
- # has based on the resource usage of the existing pods.
- "disabled": True or False, # Whether the Horizontal Pod Autoscaling feature is enabled in the cluster.
- # When enabled, it ensures that metrics are collected into Stackdriver
- # Monitoring.
- },
- "gcePersistentDiskCsiDriverConfig": { # Configuration for the Compute Engine PD CSI driver. This option can only be # Configuration for the Compute Engine Persistent Disk CSI driver.
- # enabled at cluster creation time.
- "enabled": True or False, # Whether the Compute Engine PD CSI driver is enabled for this cluster.
- },
- "configConnectorConfig": { # Configuration options for the Config Connector add-on. # Configuration for the ConfigConnector add-on, a Kubernetes
- # extension to manage hosted GCP services through the Kubernetes API
- "enabled": True or False, # Whether Cloud Connector is enabled for this cluster.
- },
- "dnsCacheConfig": { # Configuration for NodeLocal DNSCache # Configuration for NodeLocalDNS, a dns cache running on cluster nodes
- "enabled": True or False, # Whether NodeLocal DNSCache is enabled for this cluster.
- },
- "istioConfig": { # Configuration options for Istio addon. # Configuration for Istio, an open platform to connect, manage, and secure
- # microservices.
- "disabled": True or False, # Whether Istio is enabled for this cluster.
- "auth": "A String", # The specified Istio auth mode, either none, or mutual TLS.
- },
- "kubernetesDashboard": { # Configuration for the Kubernetes Dashboard. # Configuration for the Kubernetes Dashboard.
- # This addon is deprecated, and will be disabled in 1.15. It is recommended
- # to use the Cloud Console to manage and monitor your Kubernetes clusters,
- # workloads and applications. For more information, see:
- # https://cloud.google.com/kubernetes-engine/docs/concepts/dashboards
- "disabled": True or False, # Whether the Kubernetes Dashboard is enabled for this cluster.
- },
- },
- "locations": [ # The list of Google Compute Engine
- # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
- # cluster's nodes should be located.
- "A String",
- ],
- "enableKubernetesAlpha": True or False, # Kubernetes alpha features are enabled on this cluster. This includes alpha
- # API groups (e.g. v1beta1) and features that may not be production ready in
- # the kubernetes version of the master and nodes.
- # The cluster has no SLA for uptime and master/node upgrades are disabled.
- # Alpha enabled clusters are automatically deleted thirty days after
- # creation.
- "enableTpu": True or False, # Enable the ability to use Cloud TPUs in this cluster.
- # This field is deprecated, use tpu_config.enabled instead.
- "releaseChannel": { # ReleaseChannel indicates which release channel a cluster is # Release channel configuration.
- # subscribed to. Release channels are arranged in order of risk and
- # frequency of updates.
+ "initialClusterVersion": "A String", # The initial Kubernetes version for this cluster. Valid versions are those
+ # found in validMasterVersions returned by getServerConfig. The version can
+ # be upgraded over time; such upgrades are reflected in
+ # currentMasterVersion and currentNodeVersion.
#
- # When a cluster is subscribed to a release channel, Google maintains
- # both the master version and the node version. Node auto-upgrade
- # defaults to true and cannot be disabled. Updates to version related
- # fields (e.g. current_master_version) return an error.
- "channel": "A String", # channel specifies which release channel the cluster is subscribed to.
- },
- "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.
- "maxPodsPerNode": "A String", # Constraint enforced on the max num of pods per node.
- },
- "network": "A String", # The name of the Google Compute Engine
- # [network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks)
- # to which the cluster is connected. If left unspecified, the `default`
- # network will be used. On output this shows the network ID instead of the
- # name.
- "loggingService": "A String", # The logging service the cluster should use to write logs.
- # Currently available options:
+ # Users may specify either explicit versions offered by
+ # Kubernetes Engine or version aliases, which have the following behavior:
#
- # * `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.
- "instanceGroupUrls": [ # Deprecated. Use node_pools.instance_group_urls.
- "A String",
- ],
- "networkConfig": { # NetworkConfig reports the relative names of network & subnetwork. # Configuration for cluster networking.
- "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:
- # projects/my-project/regions/us-central1/subnetworks/my-subnet
- "network": "A String", # Output only. The relative name of the Google Compute Engine
- # 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.
- },
- "privateCluster": True or False, # If this is a private cluster setup. Private clusters are clusters that, by
- # default have no external IP addresses on the nodes and where nodes and the
- # master communicate over private IP addresses.
- # This field is deprecated, use private_cluster_config.enable_private_nodes
- # instead.
- "podSecurityPolicyConfig": { # Configuration for the PodSecurityPolicy feature. # Configuration for the PodSecurityPolicy feature.
- "enabled": True or False, # Enable the PodSecurityPolicy controller for this cluster. If enabled, pods
- # must be valid under a PodSecurityPolicy to be created.
- },
- "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.
- },
- "location": "A String", # [Output only] The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
- # or
- # [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
- # in which the cluster resides.
- "workloadIdentityConfig": { # Configuration for the use of Kubernetes Service Accounts in GCP IAM # Configuration for the use of Kubernetes Service Accounts in GCP IAM
- # policies.
- # policies.
- "workloadPool": "A String", # The workload pool to attach all Kubernetes service accounts to.
- "identityNamespace": "A String", # IAM Identity Namespace to attach all Kubernetes Service Accounts to.
- },
- "resourceUsageExportConfig": { # Configuration for exporting cluster resource usages. # Configuration for exporting resource usages. Resource usage export is
- # disabled when this config unspecified.
- "bigqueryDestination": { # Parameters for using BigQuery as the destination of resource usage export. # Configuration to use BigQuery as usage export destination.
- "datasetId": "A String", # The ID of a BigQuery Dataset.
- },
- "enableNetworkEgressMetering": True or False, # Whether to enable network egress metering for this cluster. If enabled, a
- # daemonset will be created in the cluster to meter network egress traffic.
- "consumptionMeteringConfig": { # Parameters for controlling consumption metering. # Configuration to enable resource consumption metering.
- "enabled": True or False, # Whether to enable consumption metering for this cluster. If enabled, a
- # second BigQuery table will be created to hold resource consumption
- # records.
- },
- },
- "privateClusterConfig": { # Configuration options for private clusters. # Configuration for private cluster.
- "enablePrivateEndpoint": True or False, # Whether the master's internal IP address is used as the cluster endpoint.
- "publicEndpoint": "A String", # Output only. The external IP address of this cluster's master endpoint.
- "masterGlobalAccessConfig": { # Configuration for controlling master global access settings. # Controls master global access settings.
- "enabled": True or False, # Whenever master is accessible globally or not.
- },
- "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.
- "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.
- "peeringName": "A String", # Output only. The peering name in the customer VPC used by this cluster.
- },
- "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
- },
- ],
- "statusMessage": "A String", # [Output only] Additional information about the current status of this
- # cluster, if available.
- "servicesIpv4Cidr": "A String", # [Output only] The IP address range of the Kubernetes services in
- # this cluster, in
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `1.2.3.4/29`). Service addresses are
- # typically put in the last `/16` from the container CIDR.
- "status": "A String", # [Output only] The current status of this cluster.
- "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the cluster. # Configuration for cluster IP allocation.
- "allowRouteOverlap": True or False, # If true, allow allocation of cluster CIDR ranges that overlap with certain
- # kinds of network routes. By default we do not allow cluster CIDR ranges to
- # intersect with any user declared routes. With allow_route_overlap == true,
- # we allow overlapping with CIDR ranges that are larger than the cluster CIDR
- # range.
- #
- # If this field is set to true, then cluster and services CIDRs must be
- # fully-specified (e.g. `10.96.0.0/14`, but not `/14`), which means:
- # 1) When `use_ip_aliases` is true, `cluster_ipv4_cidr_block` and
- # `services_ipv4_cidr_block` must be fully-specified.
- # 2) When `use_ip_aliases` is false, `cluster.cluster_ipv4_cidr` muse be
- # fully-specified.
- "useIpAliases": True or False, # Whether alias IPs will be used for pod IPs in the cluster.
- # This is used in conjunction with use_routes. It cannot
- # be true if use_routes is true. If both use_ip_aliases and use_routes are
- # false, then the server picks the default IP allocation mode
- "nodeIpv4Cidr": "A String", # This field is deprecated, use node_ipv4_cidr_block.
- "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.
- #
- # 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.
- "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 and
- # create_subnetwork is false.
- "servicesIpv4CidrBlock": "A String", # The IP address range of the services IPs in this cluster. If blank, a range
+ # - "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
+ "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the cluster. # Configuration for cluster IP allocation.
+ "useRoutes": True or False, # Whether routes will be used for pod IPs in the cluster.
+ # This is used in conjunction with use_ip_aliases. It cannot be true if
+ # use_ip_aliases is true. If both use_ip_aliases and use_routes are false,
+ # then the server picks the default IP allocation mode
+ "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.
@@ -748,10 +659,42 @@
# 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.
+ "allowRouteOverlap": True or False, # If true, allow allocation of cluster CIDR ranges that overlap with certain
+ # kinds of network routes. By default we do not allow cluster CIDR ranges to
+ # intersect with any user declared routes. With allow_route_overlap == true,
+ # we allow overlapping with CIDR ranges that are larger than the cluster CIDR
+ # range.
+ #
+ # If this field is set to true, then cluster and services CIDRs must be
+ # fully-specified (e.g. `10.96.0.0/14`, but not `/14`), which means:
+ # 1) When `use_ip_aliases` is true, `cluster_ipv4_cidr_block` and
+ # `services_ipv4_cidr_block` must be fully-specified.
+ # 2) When `use_ip_aliases` is false, `cluster.cluster_ipv4_cidr` muse be
+ # fully-specified.
+ "nodeIpv4Cidr": "A String", # This field is deprecated, use node_ipv4_cidr_block.
+ "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.
#
# This field is only applicable when `use_ip_aliases` is true.
- "nodeIpv4CidrBlock": "A String", # The IP address range of the instance IPs in this cluster.
+ #
+ # 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.
+ "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 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.
#
@@ -765,7 +708,7 @@
# 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.
- "tpuIpv4CidrBlock": "A String", # The IP address range of the Cloud TPUs in this cluster. If unspecified, a
+ "tpuIpv4CidrBlock": "A String", # The IP address range of the Cloud TPUs in this cluster. If unspecified, a
# range will be automatically chosen with the default size.
#
# This field is only applicable when `use_ip_aliases` is true.
@@ -781,207 +724,79 @@
# `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
# to use.
# This field is deprecated, use cluster.tpu_config.ipv4_cidr_block instead.
- "clusterIpv4Cidr": "A String", # This field is deprecated, use cluster_ipv4_cidr_block.
- "useRoutes": True or False, # Whether routes will be used for pod IPs in the cluster.
- # This is used in conjunction with use_ip_aliases. It cannot be true if
- # use_ip_aliases is true. If both use_ip_aliases and use_routes are false,
- # then the server picks the default IP allocation mode
- "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.
- "servicesSecondaryRangeName": "A String", # The name of the secondary range to be used as for the services
+ "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
# ClusterIPs. This must be an existing secondary range associated
# with the cluster subnetwork.
#
# This field is only applicable with use_ip_aliases and
# create_subnetwork is false.
- "servicesIpv4Cidr": "A String", # This field is deprecated, use services_ipv4_cidr_block.
+ "useIpAliases": True or False, # Whether alias IPs will be used for pod IPs in the cluster.
+ # This is used in conjunction with use_routes. It cannot
+ # be true if use_routes is true. If both use_ip_aliases and use_routes are
+ # false, then the server picks the default IP allocation mode
+ "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.
},
- "currentMasterVersion": "A String", # [Output only] The current software version of the master endpoint.
- "description": "A String", # An optional description of this cluster.
- "currentNodeVersion": "A String", # [Output only] Deprecated, use
- # [NodePool.version](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters.nodePools)
- # instead. The current version of the node software components.
- # If they are currently at multiple versions because they're in the process
- # of being upgraded, this reflects the minimum version of all nodes.
- "binaryAuthorization": { # Configuration for Binary Authorization. # Configuration for Binary Authorization.
- "enabled": True or False, # Enable Binary Authorization for this cluster. If enabled, all container
- # images will be validated by Google Binauthz.
+ "legacyAbac": { # Configuration for the legacy Attribute Based Access Control authorization # Configuration for the legacy ABAC authorization mode.
+ # mode.
+ "enabled": True or False, # Whether the ABAC authorizer is enabled for this cluster. When enabled,
+ # identities in the system, including service accounts, nodes, and
+ # controllers, will have statically granted permissions beyond those
+ # provided by the RBAC configuration or IAM.
},
- "labelFingerprint": "A String", # The fingerprint of the set of labels for this cluster.
- "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.
- "autoprovisioningNodePoolDefaults": { # AutoprovisioningNodePoolDefaults contains defaults for a node pool created # AutoprovisioningNodePoolDefaults contains defaults for a node pool
- # created by NAP.
- # by NAP.
- "minCpuPlatform": "A String", # Minimum CPU platform to be used for NAP created node pools.
- # The instance may be scheduled on the specified or newer CPU platform.
- # Applicable values are the friendly names of CPU platforms, such as
- # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
- # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
- # information, read [how to specify min CPU
- # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
- # To unset the min cpu platform field pass "automatic" as field value.
- "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.
- },
- "autoRepair": True or False, # Whether the nodes will be automatically repaired.
- "autoUpgrade": True or False, # Whether the nodes will be automatically upgraded.
- },
- "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.
- "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.
- "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
- # of the node pool during the upgrade process.
- "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.
- },
+ "enableTpu": True or False, # Enable the ability to use Cloud TPUs in this cluster.
+ # This field is deprecated, use tpu_config.enabled instead.
+ "resourceUsageExportConfig": { # Configuration for exporting cluster resource usages. # Configuration for exporting resource usages. Resource usage export is
+ # disabled when this config unspecified.
+ "enableNetworkEgressMetering": True or False, # Whether to enable network egress metering for this cluster. If enabled, a
+ # daemonset will be created in the cluster to meter network egress traffic.
+ "consumptionMeteringConfig": { # Parameters for controlling consumption metering. # Configuration to enable resource consumption metering.
+ "enabled": True or False, # Whether to enable consumption metering for this cluster. If enabled, a
+ # second BigQuery table will be created to hold resource consumption
+ # records.
},
- "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.
- "resourceType": "A String", # Resource name "cpu", "memory" or gpu-specific string.
- "minimum": "A String", # Minimum amount of the resource in the cluster.
- "maximum": "A String", # Maximum amount of the resource in the cluster.
- },
- ],
- "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",
- ],
- "autoscalingProfile": "A String", # Defines autoscaling behaviour.
- "enableNodeAutoprovisioning": True or False, # Enables automatic node pool creation and deletion.
- },
- "masterAuth": { # The authentication information for accessing the master endpoint. # The authentication information for accessing the master endpoint.
- # If unspecified, the defaults are used:
- # For clusters before v1.12, if master_auth is unspecified, `username` will
- # be set to "admin", a random password will be generated, and a client
- # certificate will be issued.
- # Authentication can be done using HTTP basic auth or using client
- # certificates.
- "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).
- "clientKey": "A String", # [Output only] Base64-encoded private key used by clients to authenticate
- # to the cluster endpoint.
- "clientCertificate": "A String", # [Output only] Base64-encoded public certificate used by clients to
- # authenticate to the cluster endpoint.
- "clusterCaCertificate": "A 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
- # must be non-empty.
- "clientCertificateConfig": { # Configuration for client certificates on the cluster. # Configuration for client certificate authentication on the cluster. For
- # clusters before v1.12, if no configuration is specified, a client
- # certificate is issued.
- "issueClientCertificate": True or False, # Issue a client certificate.
+ "bigqueryDestination": { # Parameters for using BigQuery as the destination of resource usage export. # Configuration to use BigQuery as usage export destination.
+ "datasetId": "A String", # The ID of a BigQuery Dataset.
},
},
- "expireTime": "A String", # [Output only] The time the cluster will be automatically
- # deleted in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "masterIpv4CidrBlock": "A String", # The IP prefix in CIDR notation to use for the hosted master network.
- # This prefix will be used for assigning private IP addresses to the
- # master or set of masters, as well as the ILB VIP.
- # This field is deprecated, use
- # private_cluster_config.master_ipv4_cidr_block instead.
- "clusterTelemetry": { # Telemetry integration for the cluster. # Telemetry integration for the cluster.
- "type": "A String", # Type of the integration.
- },
- "tpuIpv4CidrBlock": "A String", # [Output only] The IP address range of the Cloud TPUs in this cluster, in
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `1.2.3.4/29`).
- "nodePools": [ # The node pools associated with this cluster.
- # This field should not be set if "node_config" or "initial_node_count" are
+ "locations": [ # The list of Google Compute Engine
+ # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
+ # cluster's nodes should be located.
+ "A String",
+ ],
+ "nodePools": [ # The node pools associated with this cluster.
+ # This field should not be set if "node_config" or "initial_node_count" are
# specified.
- { # NodePool contains the name and configuration for a cluster's node pool.
- # Node pools are a set of nodes (i.e. VM's), with a common configuration and
+ { # NodePool contains the name and configuration for a cluster's node pool.
+ # Node pools are a set of nodes (i.e. VM's), with a common configuration and
# specification, under the control of the cluster master. They may have a set
# 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.
- "status": "A String", # [Output only] The status of the nodes in this pool instance.
- "selfLink": "A String", # [Output only] Server-defined URL for the resource.
- "management": { # NodeManagement defines the set of node management services turned on for the # NodeManagement configuration for this NodePool.
- # 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.
- },
- "autoRepair": True or False, # Whether the nodes will be automatically repaired.
- "autoUpgrade": True or False, # Whether the nodes will be automatically upgraded.
- },
- "name": "A String", # The name of the node pool.
- "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
- },
- ],
- "autoscaling": { # NodePoolAutoscaling contains information required by cluster autoscaler to # Autoscaler configuration for this NodePool. Autoscaler is enabled
+ "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.
- "minNodeCount": 42, # Minimum number of nodes in the NodePool. Must be >= 1 and <=
+ "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.
- "maxNodeCount": 42, # Maximum number of nodes in the NodePool. Must be >= min_node_count. There
+ "autoprovisioned": True or False, # Can this node pool be deleted automatically.
+ "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.
},
- "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",
- ],
- "maxPodsConstraint": { # Constraints applied to pods. # The constraint on the maximum number of pods that can be run
- # simultaneously on a node in the node pool.
- "maxPodsPerNode": "A String", # Constraint enforced on the max num of pods per node.
- },
- "version": "A String", # The version of the Kubernetes of this node.
- "upgradeSettings": { # These upgrade settings control the level of parallelism and the level of # Upgrade settings control disruption and speed of the upgrade.
+ "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.
+ "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.
#
# maxUnavailable controls the number of nodes that can be simultaneously
@@ -1004,87 +819,163 @@
# 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.
- "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
+ "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
# of the node pool during the upgrade process.
- "maxUnavailable": 42, # The maximum number of nodes that can be simultaneously unavailable during
+ "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.
},
- "initialNodeCount": 42, # The initial node count for the pool. You must ensure that your
- # Compute Engine <a href="/compute/docs/resource-quotas">resource quota</a>
- # is sufficient for this number of instances. You must also have available
- # firewall and routes quota.
- "podIpv4CidrSize": 42, # [Output only] The pod CIDR block size per node in this node pool.
- "instanceGroupUrls": [ # [Output only] The resource URLs of the [managed instance
+ "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+ "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.
- "A String",
+ "A String",
],
- "config": { # Parameters that describe the nodes in a cluster. # The node configuration of the pool.
- "reservationAffinity": { # [ReservationAffinity](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) # The optional reservation affinity. Setting this field will apply
- # the specified [Zonal Compute
- # Reservation](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources)
- # to this node pool.
- # is the configuration of desired reservation which instances could take
- # capacity from.
- "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.
+ "version": "A String", # The version of the Kubernetes of this node.
+ "podIpv4CidrSize": 42, # [Output only] The pod CIDR block size per node in this node pool.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
- "sandboxConfig": { # SandboxConfig contains configurations of the sandbox to use for the node. # Sandbox configuration for this node.
- "type": "A String", # Type of the sandbox to use for the node.
- "sandboxType": "A String", # Type of the sandbox to use for the node (e.g. 'gvisor')
+ ],
+ "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.
+ "diskSizeGb": 42, # Size of the disk attached to each node, specified in GB.
+ # The smallest allowed disk size is 10GB.
+ #
+ # If unspecified, the default disk size is 100GB.
+ "workloadMetadataConfig": { # WorkloadMetadataConfig defines the metadata configuration to expose to # The workload metadata configuration for this node.
+ # workloads on the node pool.
+ "nodeMetadata": "A String", # NodeMetadata is the configuration for how to expose metadata to the
+ # workloads running on the node.
+ "mode": "A String", # Mode is the configuration for how to expose metadata to workloads running
+ # on the node pool.
},
- "machineType": "A String", # The name of a Google Compute Engine [machine
+ "accelerators": [ # A list of hardware accelerators to be attached to each node.
+ # See https://cloud.google.com/compute/docs/gpus for more information about
+ # support for GPUs.
+ { # AcceleratorConfig represents a Hardware Accelerator request.
+ "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
+ "acceleratorType": "A String", # The accelerator type resource name. List of supported accelerators
+ # [here](https://cloud.google.com/compute/docs/gpus)
+ },
+ ],
+ "machineType": "A String", # The name of a Google Compute Engine [machine
# type](https://cloud.google.com/compute/docs/machine-types) (e.g.
# `n1-standard-1`).
#
# If unspecified, the default machine type is
# `n1-standard-1`.
- "shieldedInstanceConfig": { # A set of Shielded Instance options. # Shielded Instance options.
- "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.
+ "diskType": "A String", # Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
+ #
+ # If unspecified, the default disk type is 'pd-standard'
+ "bootDiskKmsKey": "A String", #
+ # The Customer Managed Encryption Key used to encrypt the boot disk attached
+ # to each node in the node pool. This should be of the form
+ # projects/[KEY_PROJECT_ID]/locations/[LOCATION]/keyRings/[RING_NAME]/cryptoKeys/[KEY_NAME].
+ # For more information about protecting resources with Cloud KMS Keys please
+ # see:
+ # https://cloud.google.com/compute/docs/disks/customer-managed-encryption
+ "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.
},
- "diskType": "A String", # Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
+ "minCpuPlatform": "A String", # Minimum CPU platform to be used by this instance. The instance may be
+ # scheduled on the specified or newer CPU platform. Applicable values are the
+ # friendly names of CPU platforms, such as
+ # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
+ # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
+ # information, read [how to specify min CPU
+ # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
+ "preemptible": True or False, # Whether the nodes are created as preemptible VM instances. See:
+ # https://cloud.google.com/compute/docs/instances/preemptible for more
+ # inforamtion about preemptible VM instances.
+ "localSsdCount": 42, # The number of local SSD disks to be attached to the node.
#
- # If unspecified, the default disk type is 'pd-standard'
- "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
+ # The limit for this value is dependent upon the maximum number of
+ # disks available on a machine per zone. See:
+ # https://cloud.google.com/compute/docs/disks/local-ssd
+ # for more information.
+ "sandboxConfig": { # SandboxConfig contains configurations of the sandbox to use for the node. # Sandbox configuration for this node.
+ "type": "A String", # Type of the sandbox to use for the node.
+ "sandboxType": "A String", # Type of the sandbox to use for the node (e.g. 'gvisor')
+ },
+ "metadata": { # The metadata key/value pairs assigned to instances in the cluster.
+ #
+ # Keys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes
+ # in length. These are reflected as part of a URL in the metadata server.
+ # Additionally, to avoid ambiguity, keys must not conflict with any other
+ # metadata keys for the project or be one of the reserved keys:
+ # "cluster-location"
+ # "cluster-name"
+ # "cluster-uid"
+ # "configure-sh"
+ # "containerd-configure-sh"
+ # "enable-oslogin"
+ # "gci-ensure-gke-docker"
+ # "gci-metrics-enabled"
+ # "gci-update-strategy"
+ # "instance-template"
+ # "kube-env"
+ # "startup-script"
+ # "user-data"
+ # "disable-address-manager"
+ # "windows-startup-script-ps1"
+ # "common-psm1"
+ # "k8s-node-setup-psm1"
+ # "install-ssh-psm1"
+ # "user-profile-psm1"
+ # "serial-port-logging-enable"
+ # Values are free-form strings, and only have meaning as interpreted by
+ # the image running in the instance. The only restriction placed on them is
+ # that each value's size must be less than or equal to 32 KB.
+ #
+ # The total size of all keys and values must be less than 512 KB.
+ "a_key": "A String",
+ },
+ "reservationAffinity": { # [ReservationAffinity](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) # The optional reservation affinity. Setting this field will apply
+ # the specified [Zonal Compute
+ # Reservation](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources)
+ # 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.
+ },
+ "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",
+ "A String",
],
- "preemptible": True or False, # Whether the nodes are created as preemptible VM instances. See:
- # https://cloud.google.com/compute/docs/instances/preemptible for more
- # inforamtion about preemptible VM instances.
- "labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
- # These will added in addition to any default label(s) that
- # Kubernetes may apply to the node.
- # In case of conflict in label keys, the applied set may differ depending on
- # the Kubernetes version -- it's best to assume the behavior is undefined
- # and conflicts should be avoided.
- # For more information, including usage and the valid values, see:
- # https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
- "a_key": "A String",
- },
- "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
+ "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.
- "oauthScopes": [ # The set of Google API scopes to be made available on all of the
- # node VMs under the "default" service account.
+ # 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.
#
# The following scopes are recommended, but not required, and by default are
# not included:
@@ -1098,106 +989,100 @@
#
# If unspecified, no scopes are added, unless Cloud Logging or Cloud
# Monitoring are enabled, in which case their required scopes will be added.
- "A String",
+ "A String",
],
- "taints": [ # List of kubernetes taints to be applied to each node.
+ "taints": [ # List of kubernetes taints to be applied to each node.
#
# For more information, including usage and the valid values, see:
# https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
{ # Kubernetes taint is comprised of three fields: key, value, and effect. Effect
# can only be one of three types: NoSchedule, PreferNoSchedule or NoExecute.
#
- # For more information, including usage and the valid values, see:
- # https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
- "value": "A String", # Value for taint.
- "key": "A String", # Key for taint.
- "effect": "A String", # Effect for taint.
+ # 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.
},
],
- "workloadMetadataConfig": { # WorkloadMetadataConfig defines the metadata configuration to expose to # The workload metadata configuration for this node.
- # workloads on the node pool.
- "mode": "A String", # Mode is the configuration for how to expose metadata to workloads running
- # on the node pool.
- "nodeMetadata": "A String", # NodeMetadata is the configuration for how to expose metadata to the
- # workloads running on the node.
- },
- "diskSizeGb": 42, # Size of the disk attached to each node, specified in GB.
- # The smallest allowed disk size is 10GB.
- #
- # If unspecified, the default disk size is 100GB.
- "accelerators": [ # A list of hardware accelerators to be attached to each node.
- # See https://cloud.google.com/compute/docs/gpus for more information about
- # support for GPUs.
- { # AcceleratorConfig represents a Hardware Accelerator request.
- "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
- "acceleratorType": "A String", # The accelerator type resource name. List of supported accelerators
- # [here](https://cloud.google.com/compute/docs/gpus)
- },
- ],
- "minCpuPlatform": "A String", # Minimum CPU platform to be used by this instance. The instance may be
- # scheduled on the specified or newer CPU platform. Applicable values are the
- # friendly names of CPU platforms, such as
- # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
- # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
- # information, read [how to specify min CPU
- # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
- "bootDiskKmsKey": "A String", #
- # The Customer Managed Encryption Key used to encrypt the boot disk attached
- # to each node in the node pool. This should be of the form
- # projects/[KEY_PROJECT_ID]/locations/[LOCATION]/keyRings/[RING_NAME]/cryptoKeys/[KEY_NAME].
- # For more information about protecting resources with Cloud KMS Keys please
- # see:
- # https://cloud.google.com/compute/docs/disks/customer-managed-encryption
- "localSsdCount": 42, # The number of local SSD disks to be attached to the node.
- #
- # The limit for this value is dependent upon the maximum number of
- # disks available on a machine per zone. See:
- # https://cloud.google.com/compute/docs/disks/local-ssd
- # for more information.
- "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.
- "metadata": { # The metadata key/value pairs assigned to instances in the cluster.
- #
- # Keys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes
- # in length. These are reflected as part of a URL in the metadata server.
- # Additionally, to avoid ambiguity, keys must not conflict with any other
- # metadata keys for the project or be one of the reserved keys:
- # "cluster-location"
- # "cluster-name"
- # "cluster-uid"
- # "configure-sh"
- # "containerd-configure-sh"
- # "enable-oslogin"
- # "gci-ensure-gke-docker"
- # "gci-metrics-enabled"
- # "gci-update-strategy"
- # "instance-template"
- # "kube-env"
- # "startup-script"
- # "user-data"
- # "disable-address-manager"
- # "windows-startup-script-ps1"
- # "common-psm1"
- # "k8s-node-setup-psm1"
- # "install-ssh-psm1"
- # "user-profile-psm1"
- # "serial-port-logging-enable"
- # Values are free-form strings, and only have meaning as interpreted by
- # the image running in the instance. The only restriction placed on them is
- # that each value's size must be less than or equal to 32 KB.
- #
- # The total size of all keys and values must be less than 512 KB.
- "a_key": "A String",
+ "labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
+ # These will added in addition to any default label(s) that
+ # Kubernetes may apply to the node.
+ # In case of conflict in label keys, the applied set may differ depending on
+ # the Kubernetes version -- it's best to assume the behavior is undefined
+ # and conflicts should be avoided.
+ # For more information, including usage and the valid values, see:
+ # https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
+ "a_key": "A String",
},
},
- "statusMessage": "A String", # [Output only] Additional information about the current status of this
- # node pool instance, if available.
+ "name": "A String", # The name of the node pool.
+ "maxPodsConstraint": { # Constraints applied to pods. # The constraint on the maximum number of pods that can be run
+ # simultaneously on a node in the node pool.
+ "maxPodsPerNode": "A String", # Constraint enforced on the max num of pods per node.
+ },
+ "management": { # NodeManagement defines the set of node management services turned on for the # NodeManagement configuration for this NodePool.
+ # node pool.
+ "autoUpgrade": True or False, # Whether the nodes will be automatically upgraded.
+ "autoRepair": True or False, # Whether the nodes will be automatically repaired.
+ "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.
+ },
+ },
},
],
- "monitoringService": "A String", # The monitoring service the cluster should use to write metrics.
+ "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+ "servicesIpv4Cidr": "A String", # [Output only] The IP address range of the Kubernetes services in
+ # this cluster, in
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `1.2.3.4/29`). Service addresses are
+ # typically put in the last `/16` from the container CIDR.
+ "networkPolicy": { # Configuration options for the NetworkPolicy feature. # Configuration options for the NetworkPolicy feature.
+ # https://kubernetes.io/docs/concepts/services-networking/networkpolicies/
+ "enabled": True or False, # Whether network policy is enabled on the cluster.
+ "provider": "A String", # The selected network policy provider.
+ },
+ "releaseChannel": { # ReleaseChannel indicates which release channel a cluster is # Release channel configuration.
+ # subscribed to. Release channels are arranged in order of risk and
+ # frequency of updates.
+ #
+ # When a cluster is subscribed to a release channel, Google maintains
+ # both the master version and the node version. Node auto-upgrade
+ # defaults to true and cannot be disabled. Updates to version related
+ # fields (e.g. current_master_version) return an error.
+ "channel": "A String", # channel specifies which release channel the cluster is subscribed to.
+ },
+ "enableKubernetesAlpha": True or False, # Kubernetes alpha features are enabled on this cluster. This includes alpha
+ # API groups (e.g. v1beta1) and features that may not be production ready in
+ # the kubernetes version of the master and nodes.
+ # The cluster has no SLA for uptime and master/node upgrades are disabled.
+ # Alpha enabled clusters are automatically deleted thirty days after
+ # creation.
+ "description": "A String", # An optional description of this cluster.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "privateCluster": True or False, # If this is a private cluster setup. Private clusters are clusters that, by
+ # default have no external IP addresses on the nodes and where nodes and the
+ # master communicate over private IP addresses.
+ # This field is deprecated, use private_cluster_config.enable_private_nodes
+ # instead.
+ "currentNodeCount": 42, # [Output only] The number of nodes currently in the cluster. Deprecated.
+ # Call Kubernetes API directly to retrieve node information.
+ "monitoringService": "A String", # The monitoring service the cluster should use to write metrics.
# Currently available options:
#
- # * "monitoring.googleapis.com/kubernetes" - The Cloud Monitoring
+ # * "monitoring.googleapis.com/kubernetes" - The Cloud Monitoring
# service with a Kubernetes-native resource model
# * `monitoring.googleapis.com` - The legacy Cloud Monitoring service (no
# longer available as of GKE 1.15).
@@ -1205,65 +1090,44 @@
#
# If left as an empty string,`monitoring.googleapis.com/kubernetes` will be
# used for GKE 1.14+ or `monitoring.googleapis.com` for earlier versions.
- "createTime": "A String", # [Output only] The time the cluster was created, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "databaseEncryption": { # Configuration of etcd encryption. # Configuration of etcd encryption.
- "state": "A String", # Denotes the state of etcd encryption.
- "keyName": "A String", # Name of CloudKMS key to use for the encryption of secrets in etcd.
+ "databaseEncryption": { # Configuration of etcd encryption. # Configuration of etcd encryption.
+ "state": "A String", # Denotes the state of etcd encryption.
+ "keyName": "A String", # Name of CloudKMS key to use for the encryption of secrets in etcd.
# Ex. projects/my-project/locations/global/keyRings/my-ring/cryptoKeys/my-key
},
- "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
- # the following restrictions:
- #
- # * Lowercase letters, numbers, and hyphens only.
- # * Must start with a letter.
- # * Must end with a number or a letter.
- "legacyAbac": { # Configuration for the legacy Attribute Based Access Control authorization # Configuration for the legacy ABAC authorization mode.
- # mode.
- "enabled": True or False, # Whether the ABAC authorizer is enabled for this cluster. When enabled,
- # identities in the system, including service accounts, nodes, and
- # controllers, will have statically granted permissions beyond those
- # provided by the RBAC configuration or IAM.
+ "binaryAuthorization": { # Configuration for Binary Authorization. # Configuration for Binary Authorization.
+ "enabled": True or False, # Enable Binary Authorization for this cluster. If enabled, all container
+ # images will be validated by Google Binauthz.
},
- "endpoint": "A String", # [Output only] The IP address of this cluster's master endpoint.
- # The endpoint can be accessed from the internet at
- # `https://username:password@endpoint/`.
- #
- # See the `masterAuth` property of this resource for username and
- # password information.
- "currentNodeCount": 42, # [Output only] The number of nodes currently in the cluster. Deprecated.
- # Call Kubernetes API directly to retrieve node information.
- "zone": "A String", # [Output only] The name of the Google Compute Engine
+ "tpuIpv4CidrBlock": "A String", # [Output only] The IP address range of the Cloud TPUs in this cluster, in
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `1.2.3.4/29`).
+ "workloadIdentityConfig": { # Configuration for the use of Kubernetes Service Accounts in GCP IAM # Configuration for the use of Kubernetes Service Accounts in GCP IAM
+ # policies.
+ # policies.
+ "identityNamespace": "A String", # IAM Identity Namespace to attach all Kubernetes Service Accounts to.
+ "workloadPool": "A String", # The workload pool to attach all Kubernetes service accounts to.
+ },
+ "zone": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/zones#available) in which the
# cluster resides. This field is deprecated, use location instead.
- "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.
- },
- "tpuConfig": { # Configuration for Cloud TPU. # Configuration for Cloud TPU support;
- "useServiceNetworking": True or False, # Whether to use service networking for Cloud TPU or not.
- "ipv4CidrBlock": "A String", # IPv4 CIDR block reserved for Cloud TPU in the VPC.
- "enabled": True or False, # Whether Cloud TPU integration is enabled or not.
- },
- "initialClusterVersion": "A String", # The initial Kubernetes version for this cluster. Valid versions are those
- # found in validMasterVersions returned by getServerConfig. The version can
- # be upgraded over time; such upgrades are reflected in
- # currentMasterVersion and currentNodeVersion.
+ "loggingService": "A String", # The logging service the cluster should use to write logs.
+ # Currently available options:
#
- # Users may specify either explicit versions offered by
- # Kubernetes Engine or version aliases, which have the following behavior:
+ # * `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.
#
- # - "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
- "nodeConfig": { # Parameters that describe the nodes in a cluster. # Parameters used in creating the cluster's nodes.
+ # If left as an empty string,`logging.googleapis.com/kubernetes` will be
+ # used for GKE 1.14+ or `logging.googleapis.com` for earlier versions.
+ "expireTime": "A String", # [Output only] The time the cluster will be automatically
+ # deleted in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "nodeConfig": { # Parameters that describe the nodes in a cluster. # Parameters used in creating the cluster's nodes.
# For requests, this field should only be used in lieu of a
- # "node_pool" object, since this configuration (along with the
- # "initial_node_count") will be used to create a "NodePool" object with an
+ # "node_pool" object, since this configuration (along with the
+ # "initial_node_count") will be used to create a "NodePool" object with an
# auto-generated name. Do not use this and a node_pool at the same time.
# For responses, this field will be populated with the node configuration of
# the first node pool. (For configuration of each node pool, see
@@ -1271,70 +1135,135 @@
#
# If unspecified, the defaults are used.
# This field is deprecated, use node_pool.config instead.
- "reservationAffinity": { # [ReservationAffinity](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) # The optional reservation affinity. Setting this field will apply
- # the specified [Zonal Compute
- # Reservation](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources)
- # to this node pool.
- # is the configuration of desired reservation which instances could take
- # capacity from.
- "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.
+ "diskSizeGb": 42, # Size of the disk attached to each node, specified in GB.
+ # The smallest allowed disk size is 10GB.
+ #
+ # If unspecified, the default disk size is 100GB.
+ "workloadMetadataConfig": { # WorkloadMetadataConfig defines the metadata configuration to expose to # The workload metadata configuration for this node.
+ # workloads on the node pool.
+ "nodeMetadata": "A String", # NodeMetadata is the configuration for how to expose metadata to the
+ # workloads running on the node.
+ "mode": "A String", # Mode is the configuration for how to expose metadata to workloads running
+ # on the node pool.
},
- "sandboxConfig": { # SandboxConfig contains configurations of the sandbox to use for the node. # Sandbox configuration for this node.
- "type": "A String", # Type of the sandbox to use for the node.
- "sandboxType": "A String", # Type of the sandbox to use for the node (e.g. 'gvisor')
- },
- "machineType": "A String", # The name of a Google Compute Engine [machine
+ "accelerators": [ # A list of hardware accelerators to be attached to each node.
+ # See https://cloud.google.com/compute/docs/gpus for more information about
+ # support for GPUs.
+ { # AcceleratorConfig represents a Hardware Accelerator request.
+ "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
+ "acceleratorType": "A String", # The accelerator type resource name. List of supported accelerators
+ # [here](https://cloud.google.com/compute/docs/gpus)
+ },
+ ],
+ "machineType": "A String", # The name of a Google Compute Engine [machine
# type](https://cloud.google.com/compute/docs/machine-types) (e.g.
# `n1-standard-1`).
#
# If unspecified, the default machine type is
# `n1-standard-1`.
- "shieldedInstanceConfig": { # A set of Shielded Instance options. # Shielded Instance options.
- "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.
+ "diskType": "A String", # Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
+ #
+ # If unspecified, the default disk type is 'pd-standard'
+ "bootDiskKmsKey": "A String", #
+ # The Customer Managed Encryption Key used to encrypt the boot disk attached
+ # to each node in the node pool. This should be of the form
+ # projects/[KEY_PROJECT_ID]/locations/[LOCATION]/keyRings/[RING_NAME]/cryptoKeys/[KEY_NAME].
+ # For more information about protecting resources with Cloud KMS Keys please
+ # see:
+ # https://cloud.google.com/compute/docs/disks/customer-managed-encryption
+ "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.
},
- "diskType": "A String", # Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
+ "minCpuPlatform": "A String", # Minimum CPU platform to be used by this instance. The instance may be
+ # scheduled on the specified or newer CPU platform. Applicable values are the
+ # friendly names of CPU platforms, such as
+ # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
+ # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
+ # information, read [how to specify min CPU
+ # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
+ "preemptible": True or False, # Whether the nodes are created as preemptible VM instances. See:
+ # https://cloud.google.com/compute/docs/instances/preemptible for more
+ # inforamtion about preemptible VM instances.
+ "localSsdCount": 42, # The number of local SSD disks to be attached to the node.
#
- # If unspecified, the default disk type is 'pd-standard'
- "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
+ # The limit for this value is dependent upon the maximum number of
+ # disks available on a machine per zone. See:
+ # https://cloud.google.com/compute/docs/disks/local-ssd
+ # for more information.
+ "sandboxConfig": { # SandboxConfig contains configurations of the sandbox to use for the node. # Sandbox configuration for this node.
+ "type": "A String", # Type of the sandbox to use for the node.
+ "sandboxType": "A String", # Type of the sandbox to use for the node (e.g. 'gvisor')
+ },
+ "metadata": { # The metadata key/value pairs assigned to instances in the cluster.
+ #
+ # Keys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes
+ # in length. These are reflected as part of a URL in the metadata server.
+ # Additionally, to avoid ambiguity, keys must not conflict with any other
+ # metadata keys for the project or be one of the reserved keys:
+ # "cluster-location"
+ # "cluster-name"
+ # "cluster-uid"
+ # "configure-sh"
+ # "containerd-configure-sh"
+ # "enable-oslogin"
+ # "gci-ensure-gke-docker"
+ # "gci-metrics-enabled"
+ # "gci-update-strategy"
+ # "instance-template"
+ # "kube-env"
+ # "startup-script"
+ # "user-data"
+ # "disable-address-manager"
+ # "windows-startup-script-ps1"
+ # "common-psm1"
+ # "k8s-node-setup-psm1"
+ # "install-ssh-psm1"
+ # "user-profile-psm1"
+ # "serial-port-logging-enable"
+ # Values are free-form strings, and only have meaning as interpreted by
+ # the image running in the instance. The only restriction placed on them is
+ # that each value's size must be less than or equal to 32 KB.
+ #
+ # The total size of all keys and values must be less than 512 KB.
+ "a_key": "A String",
+ },
+ "reservationAffinity": { # [ReservationAffinity](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) # The optional reservation affinity. Setting this field will apply
+ # the specified [Zonal Compute
+ # Reservation](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources)
+ # 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.
+ },
+ "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",
+ "A String",
],
- "preemptible": True or False, # Whether the nodes are created as preemptible VM instances. See:
- # https://cloud.google.com/compute/docs/instances/preemptible for more
- # inforamtion about preemptible VM instances.
- "labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
- # These will added in addition to any default label(s) that
- # Kubernetes may apply to the node.
- # In case of conflict in label keys, the applied set may differ depending on
- # the Kubernetes version -- it's best to assume the behavior is undefined
- # and conflicts should be avoided.
- # For more information, including usage and the valid values, see:
- # https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
- "a_key": "A String",
- },
- "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
+ "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.
- "oauthScopes": [ # The set of Google API scopes to be made available on all of the
- # node VMs under the "default" service account.
+ # 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.
#
# The following scopes are recommended, but not required, and by default are
# not included:
@@ -1348,128 +1277,201 @@
#
# If unspecified, no scopes are added, unless Cloud Logging or Cloud
# Monitoring are enabled, in which case their required scopes will be added.
- "A String",
+ "A String",
],
- "taints": [ # List of kubernetes taints to be applied to each node.
+ "taints": [ # List of kubernetes taints to be applied to each node.
#
# For more information, including usage and the valid values, see:
# https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
{ # Kubernetes taint is comprised of three fields: key, value, and effect. Effect
# can only be one of three types: NoSchedule, PreferNoSchedule or NoExecute.
#
- # For more information, including usage and the valid values, see:
- # https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
- "value": "A String", # Value for taint.
- "key": "A String", # Key for taint.
- "effect": "A String", # Effect for taint.
+ # 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.
},
],
- "workloadMetadataConfig": { # WorkloadMetadataConfig defines the metadata configuration to expose to # The workload metadata configuration for this node.
- # workloads on the node pool.
- "mode": "A String", # Mode is the configuration for how to expose metadata to workloads running
- # on the node pool.
- "nodeMetadata": "A String", # NodeMetadata is the configuration for how to expose metadata to the
- # workloads running on the node.
- },
- "diskSizeGb": 42, # Size of the disk attached to each node, specified in GB.
- # The smallest allowed disk size is 10GB.
- #
- # If unspecified, the default disk size is 100GB.
- "accelerators": [ # A list of hardware accelerators to be attached to each node.
- # See https://cloud.google.com/compute/docs/gpus for more information about
- # support for GPUs.
- { # AcceleratorConfig represents a Hardware Accelerator request.
- "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
- "acceleratorType": "A String", # The accelerator type resource name. List of supported accelerators
- # [here](https://cloud.google.com/compute/docs/gpus)
- },
- ],
- "minCpuPlatform": "A String", # Minimum CPU platform to be used by this instance. The instance may be
- # scheduled on the specified or newer CPU platform. Applicable values are the
- # friendly names of CPU platforms, such as
- # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
- # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
- # information, read [how to specify min CPU
- # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
- "bootDiskKmsKey": "A String", #
- # The Customer Managed Encryption Key used to encrypt the boot disk attached
- # to each node in the node pool. This should be of the form
- # projects/[KEY_PROJECT_ID]/locations/[LOCATION]/keyRings/[RING_NAME]/cryptoKeys/[KEY_NAME].
- # For more information about protecting resources with Cloud KMS Keys please
- # see:
- # https://cloud.google.com/compute/docs/disks/customer-managed-encryption
- "localSsdCount": 42, # The number of local SSD disks to be attached to the node.
- #
- # The limit for this value is dependent upon the maximum number of
- # disks available on a machine per zone. See:
- # https://cloud.google.com/compute/docs/disks/local-ssd
- # for more information.
- "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.
- "metadata": { # The metadata key/value pairs assigned to instances in the cluster.
- #
- # Keys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes
- # in length. These are reflected as part of a URL in the metadata server.
- # Additionally, to avoid ambiguity, keys must not conflict with any other
- # metadata keys for the project or be one of the reserved keys:
- # "cluster-location"
- # "cluster-name"
- # "cluster-uid"
- # "configure-sh"
- # "containerd-configure-sh"
- # "enable-oslogin"
- # "gci-ensure-gke-docker"
- # "gci-metrics-enabled"
- # "gci-update-strategy"
- # "instance-template"
- # "kube-env"
- # "startup-script"
- # "user-data"
- # "disable-address-manager"
- # "windows-startup-script-ps1"
- # "common-psm1"
- # "k8s-node-setup-psm1"
- # "install-ssh-psm1"
- # "user-profile-psm1"
- # "serial-port-logging-enable"
- # Values are free-form strings, and only have meaning as interpreted by
- # the image running in the instance. The only restriction placed on them is
- # that each value's size must be less than or equal to 32 KB.
- #
- # The total size of all keys and values must be less than 512 KB.
- "a_key": "A String",
+ "labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
+ # These will added in addition to any default label(s) that
+ # Kubernetes may apply to the node.
+ # In case of conflict in label keys, the applied set may differ depending on
+ # the Kubernetes version -- it's best to assume the behavior is undefined
+ # and conflicts should be avoided.
+ # For more information, including usage and the valid values, see:
+ # https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
+ "a_key": "A String",
},
},
- "clusterIpv4Cidr": "A String", # The IP address range of the container pods in this cluster, in
+ "status": "A String", # [Output only] The current status of this cluster.
+ "tpuConfig": { # Configuration for Cloud TPU. # Configuration for Cloud TPU support;
+ "enabled": True or False, # Whether Cloud TPU integration is enabled or not.
+ "ipv4CidrBlock": "A String", # IPv4 CIDR block reserved for Cloud TPU in the VPC.
+ "useServiceNetworking": True or False, # Whether to use service networking for Cloud TPU or not.
+ },
+ "networkConfig": { # NetworkConfig reports the relative names of network & subnetwork. # Configuration for cluster networking.
+ "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:
+ # projects/my-project/regions/us-central1/subnetworks/my-subnet
+ "network": "A String", # Output only. The relative name of the Google Compute Engine
+ # 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
+ # the following restrictions:
+ #
+ # * Lowercase letters, numbers, and hyphens only.
+ # * Must start with a letter.
+ # * Must end with a number or a letter.
+ "endpoint": "A String", # [Output only] The IP address of this cluster's master endpoint.
+ # The endpoint can be accessed from the internet at
+ # `https://username:password@endpoint/`.
+ #
+ # See the `masterAuth` property of this resource for username and
+ # password information.
+ "location": "A String", # [Output only] The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
+ # 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`.
- "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
- # during authentication using a group of security groups.
- "securityGroup": "A String", # The name of the security group-of-groups to be used. Only relevant
- # if enabled = true.
+ "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.
+ "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.
+ },
+ ],
+ "autoscalingProfile": "A String", # Defines autoscaling behaviour.
+ "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.
+ "autoUpgrade": True or False, # Whether the nodes will be automatically upgraded.
+ "autoRepair": True or False, # Whether the nodes will be automatically repaired.
+ "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.
+ },
+ },
+ "minCpuPlatform": "A String", # Minimum CPU platform to be used for NAP created node pools.
+ # The instance may be scheduled on the specified or newer CPU platform.
+ # Applicable values are the friendly names of CPU platforms, such as
+ # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
+ # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
+ # information, read [how to specify min CPU
+ # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
+ # To unset the min cpu platform field pass "automatic" as field value.
+ "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.
+ "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
+ # of the node pool during the upgrade process.
+ "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.
+ },
+ "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.
+ },
+ "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",
+ ],
},
- "subnetwork": "A String", # The name of the Google Compute Engine
- # [subnetwork](https://cloud.google.com/compute/docs/subnetworks) to which
- # the cluster is connected. On output this shows the subnetwork ID instead of
- # the name.
- "resourceLabels": { # The resource labels for the cluster to use to annotate any related
- # Google Compute Engine resources.
- "a_key": "A String",
- },
- "selfLink": "A String", # [Output only] Server-defined URL for the resource.
- "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>
+ "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
+ # "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.
+ "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.
+ "masterGlobalAccessConfig": { # Configuration for controlling master global access settings. # Controls master global access settings.
+ "enabled": True or False, # Whenever master is accessible globally or not.
+ },
+ "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.
+ },
+ "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.
+ },
},
+ "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # cluster resides. This field has been deprecated and replaced by the parent
+ # field.
+ "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.
@@ -1482,61 +1484,61 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
- "status": "A String", # The current status of the operation.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "endTime": "A String", # [Output only] The time the operation completed, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "name": "A String", # The server-assigned ID for the operation.
- "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.
- "clusterConditions": [ # Which conditions caused the current cluster state.
+ "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
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
],
- "startTime": "A String", # [Output only] The time the operation started, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
- "operationType": "A String", # The operation type.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "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.).
- "intValue": "A String", # For metrics with integer value.
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- },
- ],
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "selfLink": "A String", # Server-defined URL for the resource.
- "location": "A String", # [Output only] The name of the Google Compute Engine
+ "location": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "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.
+ "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.
+ "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.).
+ },
+ ],
+ "name": "A String", # A non-parameterized string describing 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.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "detail": "A String", # Detailed operation progress, if available.
+ "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.
}</pre>
</div>
@@ -1549,7 +1551,7 @@
are also deleted.
Other Google Compute Engine resources that might be in use by the cluster,
-such as load balancer resources, are not deleted if they weren't present
+such as load balancer resources, are not deleted if they weren't present
when the cluster was initially created.
Args:
@@ -1563,7 +1565,7 @@
clusterId: string, Required. Deprecated. The name of the cluster to delete.
This field has been deprecated and replaced by the name field. (required)
name: string, The name (project, location, cluster) of the cluster to delete.
-Specified in the format 'projects/*/locations/*/clusters/*'.
+Specified in the format `projects/*/locations/*/clusters/*`.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -1574,61 +1576,61 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
- "status": "A String", # The current status of the operation.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "endTime": "A String", # [Output only] The time the operation completed, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "name": "A String", # The server-assigned ID for the operation.
- "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.
- "clusterConditions": [ # Which conditions caused the current cluster state.
+ "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
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
],
- "startTime": "A String", # [Output only] The time the operation started, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
- "operationType": "A String", # The operation type.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "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.).
- "intValue": "A String", # For metrics with integer value.
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- },
- ],
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "selfLink": "A String", # Server-defined URL for the resource.
- "location": "A String", # [Output only] The name of the Google Compute Engine
+ "location": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "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.
+ "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.
+ "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.).
+ },
+ ],
+ "name": "A String", # A non-parameterized string describing 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.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "detail": "A String", # Detailed operation progress, if available.
+ "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.
}</pre>
</div>
@@ -1647,7 +1649,7 @@
clusterId: string, Required. Deprecated. The name of the cluster to retrieve.
This field has been deprecated and replaced by the name field. (required)
name: string, The name (project, location, cluster) of the cluster to retrieve.
-Specified in the format 'projects/*/locations/*/clusters/*'.
+Specified in the format `projects/*/locations/*/clusters/*`.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -1657,27 +1659,175 @@
An object of the form:
{ # A Google Kubernetes Engine cluster.
- "nodeIpv4CidrSize": 42, # [Output only] The size of the address space on each node for hosting
+ "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.
+ "maxPodsPerNode": "A String", # Constraint enforced on the max num of pods per node.
+ },
+ "network": "A String", # The name of the Google Compute Engine
+ # [network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks)
+ # to which the cluster is connected. If left unspecified, the `default`
+ # network will be used. On output this shows the network ID instead of the
+ # name.
+ "labelFingerprint": "A String", # The fingerprint of the set of labels for this cluster.
+ "nodeIpv4CidrSize": 42, # [Output only] The size of the address space on each node for hosting
# containers. This is provisioned from within the `container_ipv4_cidr`
# range. This field will only be set when cluster is in route-based network
# mode.
- "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.
- "recurringWindow": { # Represents an arbitrary window of time that recurs. # RecurringWindow specifies some number of recurring time periods for
+ "masterAuthorizedNetworksConfig": { # Configuration options for the master authorized networks feature. Enabled # The configuration options for master authorized networks feature.
+ # 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.
+ "cidrBlocks": [ # cidr_blocks define up to 10 external networks that could access
+ # Kubernetes master through HTTPS.
+ { # CidrBlock contains an optional name and one CIDR block.
+ "displayName": "A String", # display_name is an optional field for users to identify CIDR blocks.
+ "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.
+ "masterAuth": { # The authentication information for accessing the master endpoint. # The authentication information for accessing the master endpoint.
+ # If unspecified, the defaults are used:
+ # For clusters before v1.12, if master_auth is unspecified, `username` will
+ # be set to "admin", a random password will be generated, and a client
+ # certificate will be issued.
+ # Authentication can be done using HTTP basic auth or using client
+ # certificates.
+ "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
+ # must be non-empty.
+ "clientCertificateConfig": { # Configuration for client certificates on the cluster. # Configuration for client certificate authentication on the cluster. For
+ # clusters before v1.12, if no configuration is specified, a client
+ # certificate is issued.
+ "issueClientCertificate": True or False, # Issue a client certificate.
+ },
+ "clientKey": "A String", # [Output only] Base64-encoded private key used by clients to authenticate
+ # to the cluster endpoint.
+ "clusterCaCertificate": "A String",
+ "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
+ # during authentication using a group of security groups.
+ "securityGroup": "A String", # The name of the security group-of-groups to be used. Only relevant
+ # if enabled = true.
+ },
+ "masterIpv4CidrBlock": "A String", # The IP prefix in CIDR notation to use for the hosted master network.
+ # This prefix will be used for assigning private IP addresses to the
+ # master or set of masters, as well as the ILB VIP.
+ # This field is deprecated, use
+ # private_cluster_config.master_ipv4_cidr_block instead.
+ "clusterTelemetry": { # Telemetry integration for the cluster. # Telemetry integration for the cluster.
+ "type": "A String", # Type of the integration.
+ },
+ "currentMasterVersion": "A String", # [Output only] The current software version of the master endpoint.
+ "addonsConfig": { # 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
+ # is enabled or not on the Master, it does not track whether network policy
+ # is enabled for the nodes.
+ # is enabled or not on the Master, it does not track whether network policy
+ # is enabled for the nodes.
+ "disabled": True or False, # Whether NetworkPolicy is enabled for this cluster.
+ },
+ "configConnectorConfig": { # Configuration options for the Config Connector add-on. # Configuration for the ConfigConnector add-on, a Kubernetes
+ # extension to manage hosted GCP services through the Kubernetes API
+ "enabled": True or False, # Whether Cloud Connector is enabled for this cluster.
+ },
+ "cloudRunConfig": { # Configuration options for the Cloud Run feature. # Configuration for the Cloud Run addon. The `IstioConfig` addon must be
+ # enabled in order to enable Cloud Run addon. This option can only be enabled
+ # at cluster creation time.
+ "disabled": True or False, # Whether Cloud Run addon is enabled for this cluster.
+ },
+ "horizontalPodAutoscaling": { # Configuration options for the horizontal pod autoscaling feature, which # Configuration for the horizontal pod autoscaling feature, which
+ # increases or decreases the number of replica pods a replication controller
+ # has based on the resource usage of the existing pods.
+ # increases or decreases the number of replica pods a replication controller
+ # has based on the resource usage of the existing pods.
+ "disabled": True or False, # Whether the Horizontal Pod Autoscaling feature is enabled in the cluster.
+ # When enabled, it ensures that metrics are collected into Stackdriver
+ # Monitoring.
+ },
+ "httpLoadBalancing": { # Configuration options for the HTTP (L7) load balancing controller addon, # Configuration for the HTTP (L7) load balancing controller addon, which
+ # makes it easy to set up HTTP load balancers for services in a cluster.
+ # which makes it easy to set up HTTP load balancers for services in a cluster.
+ "disabled": True or False, # Whether the HTTP Load Balancing controller is enabled in the cluster.
+ # When enabled, it runs a small pod in the cluster that manages the load
+ # balancers.
+ },
+ "kubernetesDashboard": { # Configuration for the Kubernetes Dashboard. # Configuration for the Kubernetes Dashboard.
+ # This addon is deprecated, and will be disabled in 1.15. It is recommended
+ # to use the Cloud Console to manage and monitor your Kubernetes clusters,
+ # workloads and applications. For more information, see:
+ # https://cloud.google.com/kubernetes-engine/docs/concepts/dashboards
+ "disabled": True or False, # Whether the Kubernetes Dashboard is enabled for this cluster.
+ },
+ "dnsCacheConfig": { # Configuration for NodeLocal DNSCache # Configuration for NodeLocalDNS, a dns cache running on cluster nodes
+ "enabled": True or False, # Whether NodeLocal DNSCache is enabled for this cluster.
+ },
+ "kalmConfig": { # Configuration options for the KALM addon. # Configuration for the KALM addon, which manages the lifecycle of k8s
+ # applications.
+ "enabled": True or False, # Whether KALM is enabled for this cluster.
+ },
+ "gcePersistentDiskCsiDriverConfig": { # Configuration for the Compute Engine PD CSI driver. This option can only be # Configuration for the Compute Engine Persistent Disk CSI driver.
+ # enabled at cluster creation time.
+ "enabled": True or False, # Whether the Compute Engine PD CSI driver is enabled for this cluster.
+ },
+ "istioConfig": { # Configuration options for Istio addon. # Configuration for Istio, an open platform to connect, manage, and secure
+ # microservices.
+ "disabled": True or False, # Whether Istio is enabled for this cluster.
+ "auth": "A String", # The specified Istio auth mode, either none, or mutual TLS.
+ },
+ },
+ "podSecurityPolicyConfig": { # Configuration for the PodSecurityPolicy feature. # Configuration for the PodSecurityPolicy feature.
+ "enabled": True or False, # Enable the PodSecurityPolicy controller for this cluster. If enabled, pods
+ # must be valid under a PodSecurityPolicy to be created.
+ },
+ "currentNodeVersion": "A String", # [Output only] Deprecated, use
+ # [NodePool.version](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters.nodePools)
+ # instead. The current version of the node software components.
+ # If they are currently at multiple versions because they're in the process
+ # of being upgraded, this reflects the minimum version of all nodes.
+ "subnetwork": "A String", # The name of the Google Compute Engine
+ # [subnetwork](https://cloud.google.com/compute/docs/subnetworks) to which
+ # the cluster is connected. On output this shows the subnetwork ID instead of
+ # the name.
+ "maintenancePolicy": { # MaintenancePolicy defines the maintenance policy to be used for the cluster. # Configure the maintenance policy for this cluster.
+ "resourceVersion": "A String", # A hash identifying the version of this policy, so that updates to fields of
+ # the policy won't accidentally undo intermediate changes (and so that users
+ # of the API unaware of some fields won't accidentally remove other fields).
+ # Make a <code>get()</code> request to the cluster to get the current
+ # resource version and include it with requests to set the 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.
+ "startTime": "A String", # Time within the maintenance window to start the maintenance operations.
+ # It must be in format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
+ },
+ "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.
- "recurrence": "A String", # An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how
+ "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.
#
- # For example, to have something repeat every weekday, you'd use:
+ # For example, to have something repeat every weekday, you'd use:
# <code>FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR</code>
# To repeat some window daily (equivalent to the DailyMaintenanceWindow):
# <code>FREQ=DAILY</code>
# For the first weekend of every month:
# <code>FREQ=MONTHLY;BYSETPOS=1;BYDAY=SA,SU</code>
# This specifies how frequently the window starts. Eg, if you wanted to have
- # a 9-5 UTC-4 window every weekday, you'd use something like:
+ # a 9-5 UTC-4 window every weekday, you'd use something like:
# <code>
# start time = 2019-01-01T09:00:00-0400
# end time = 2019-01-01T17:00:00-0400
@@ -1690,279 +1840,48 @@
# end time = 2019-01-07T23:59:00Z
# recurrence = FREQ=WEEKLY;BYDAY=SA
# </code>
- # Note the start and end time's specific dates are largely arbitrary except
+ # 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
+ "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.
+ "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.
- "duration": "A String", # [Output only] Duration of the time window, automatically chosen to be
- # smallest possible in the given scenario.
- "startTime": "A String", # Time within the maintenance window to start the maintenance operations.
- # It must be in format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
- },
- "maintenanceExclusions": { # Exceptions to maintenance window. Non-emergency maintenance should not
+ "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
+ "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.
+ "startTime": "A String", # The time that the window first starts.
},
},
},
- "resourceVersion": "A String", # A hash identifying the version of this policy, so that updates to fields of
- # the policy won't accidentally undo intermediate changes (and so that users
- # of the API unaware of some fields won't accidentally remove other fields).
- # Make a <code>get()</code> request to the cluster to get the current
- # resource version and include it with requests to set the policy.
},
- "networkPolicy": { # Configuration options for the NetworkPolicy feature. # Configuration options for the NetworkPolicy feature.
- # https://kubernetes.io/docs/concepts/services-networking/networkpolicies/
- "enabled": True or False, # Whether network policy is enabled on the cluster.
- "provider": "A String", # The selected network policy provider.
+ "resourceLabels": { # The resource labels for the cluster to use to annotate any related
+ # Google Compute Engine resources.
+ "a_key": "A String",
},
- "masterAuthorizedNetworksConfig": { # Configuration options for the master authorized networks feature. Enabled # The configuration options for master authorized networks feature.
- # 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 10 external networks that could access
- # Kubernetes master through HTTPS.
- { # CidrBlock contains an optional name and one CIDR block.
- "cidrBlock": "A String", # cidr_block must be specified in CIDR notation.
- "displayName": "A String", # display_name is an optional field for users to identify CIDR blocks.
- },
- ],
- },
- "addonsConfig": { # 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
- # is enabled or not on the Master, it does not track whether network policy
- # is enabled for the nodes.
- # is enabled or not on the Master, it does not track whether network policy
- # is enabled for the nodes.
- "disabled": True or False, # Whether NetworkPolicy is enabled for this cluster.
- },
- "cloudRunConfig": { # Configuration options for the Cloud Run feature. # Configuration for the Cloud Run addon. The `IstioConfig` addon must be
- # enabled in order to enable Cloud Run addon. This option can only be enabled
- # at cluster creation time.
- "disabled": True or False, # Whether Cloud Run addon is enabled for this cluster.
- },
- "httpLoadBalancing": { # Configuration options for the HTTP (L7) load balancing controller addon, # Configuration for the HTTP (L7) load balancing controller addon, which
- # makes it easy to set up HTTP load balancers for services in a cluster.
- # which makes it easy to set up HTTP load balancers for services in a cluster.
- "disabled": True or False, # Whether the HTTP Load Balancing controller is enabled in the cluster.
- # When enabled, it runs a small pod in the cluster that manages the load
- # balancers.
- },
- "kalmConfig": { # Configuration options for the KALM addon. # Configuration for the KALM addon, which manages the lifecycle of k8s
- # applications.
- "enabled": True or False, # Whether KALM is enabled for this cluster.
- },
- "horizontalPodAutoscaling": { # Configuration options for the horizontal pod autoscaling feature, which # Configuration for the horizontal pod autoscaling feature, which
- # increases or decreases the number of replica pods a replication controller
- # has based on the resource usage of the existing pods.
- # increases or decreases the number of replica pods a replication controller
- # has based on the resource usage of the existing pods.
- "disabled": True or False, # Whether the Horizontal Pod Autoscaling feature is enabled in the cluster.
- # When enabled, it ensures that metrics are collected into Stackdriver
- # Monitoring.
- },
- "gcePersistentDiskCsiDriverConfig": { # Configuration for the Compute Engine PD CSI driver. This option can only be # Configuration for the Compute Engine Persistent Disk CSI driver.
- # enabled at cluster creation time.
- "enabled": True or False, # Whether the Compute Engine PD CSI driver is enabled for this cluster.
- },
- "configConnectorConfig": { # Configuration options for the Config Connector add-on. # Configuration for the ConfigConnector add-on, a Kubernetes
- # extension to manage hosted GCP services through the Kubernetes API
- "enabled": True or False, # Whether Cloud Connector is enabled for this cluster.
- },
- "dnsCacheConfig": { # Configuration for NodeLocal DNSCache # Configuration for NodeLocalDNS, a dns cache running on cluster nodes
- "enabled": True or False, # Whether NodeLocal DNSCache is enabled for this cluster.
- },
- "istioConfig": { # Configuration options for Istio addon. # Configuration for Istio, an open platform to connect, manage, and secure
- # microservices.
- "disabled": True or False, # Whether Istio is enabled for this cluster.
- "auth": "A String", # The specified Istio auth mode, either none, or mutual TLS.
- },
- "kubernetesDashboard": { # Configuration for the Kubernetes Dashboard. # Configuration for the Kubernetes Dashboard.
- # This addon is deprecated, and will be disabled in 1.15. It is recommended
- # to use the Cloud Console to manage and monitor your Kubernetes clusters,
- # workloads and applications. For more information, see:
- # https://cloud.google.com/kubernetes-engine/docs/concepts/dashboards
- "disabled": True or False, # Whether the Kubernetes Dashboard is enabled for this cluster.
- },
- },
- "locations": [ # The list of Google Compute Engine
- # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
- # cluster's nodes should be located.
- "A String",
- ],
- "enableKubernetesAlpha": True or False, # Kubernetes alpha features are enabled on this cluster. This includes alpha
- # API groups (e.g. v1beta1) and features that may not be production ready in
- # the kubernetes version of the master and nodes.
- # The cluster has no SLA for uptime and master/node upgrades are disabled.
- # Alpha enabled clusters are automatically deleted thirty days after
- # creation.
- "enableTpu": True or False, # Enable the ability to use Cloud TPUs in this cluster.
- # This field is deprecated, use tpu_config.enabled instead.
- "releaseChannel": { # ReleaseChannel indicates which release channel a cluster is # Release channel configuration.
- # subscribed to. Release channels are arranged in order of risk and
- # frequency of updates.
+ "initialClusterVersion": "A String", # The initial Kubernetes version for this cluster. Valid versions are those
+ # found in validMasterVersions returned by getServerConfig. The version can
+ # be upgraded over time; such upgrades are reflected in
+ # currentMasterVersion and currentNodeVersion.
#
- # When a cluster is subscribed to a release channel, Google maintains
- # both the master version and the node version. Node auto-upgrade
- # defaults to true and cannot be disabled. Updates to version related
- # fields (e.g. current_master_version) return an error.
- "channel": "A String", # channel specifies which release channel the cluster is subscribed to.
- },
- "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.
- "maxPodsPerNode": "A String", # Constraint enforced on the max num of pods per node.
- },
- "network": "A String", # The name of the Google Compute Engine
- # [network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks)
- # to which the cluster is connected. If left unspecified, the `default`
- # network will be used. On output this shows the network ID instead of the
- # name.
- "loggingService": "A String", # The logging service the cluster should use to write logs.
- # Currently available options:
+ # Users may specify either explicit versions offered by
+ # Kubernetes Engine or version aliases, which have the following behavior:
#
- # * `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.
- "instanceGroupUrls": [ # Deprecated. Use node_pools.instance_group_urls.
- "A String",
- ],
- "networkConfig": { # NetworkConfig reports the relative names of network & subnetwork. # Configuration for cluster networking.
- "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:
- # projects/my-project/regions/us-central1/subnetworks/my-subnet
- "network": "A String", # Output only. The relative name of the Google Compute Engine
- # 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.
- },
- "privateCluster": True or False, # If this is a private cluster setup. Private clusters are clusters that, by
- # default have no external IP addresses on the nodes and where nodes and the
- # master communicate over private IP addresses.
- # This field is deprecated, use private_cluster_config.enable_private_nodes
- # instead.
- "podSecurityPolicyConfig": { # Configuration for the PodSecurityPolicy feature. # Configuration for the PodSecurityPolicy feature.
- "enabled": True or False, # Enable the PodSecurityPolicy controller for this cluster. If enabled, pods
- # must be valid under a PodSecurityPolicy to be created.
- },
- "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.
- },
- "location": "A String", # [Output only] The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
- # or
- # [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
- # in which the cluster resides.
- "workloadIdentityConfig": { # Configuration for the use of Kubernetes Service Accounts in GCP IAM # Configuration for the use of Kubernetes Service Accounts in GCP IAM
- # policies.
- # policies.
- "workloadPool": "A String", # The workload pool to attach all Kubernetes service accounts to.
- "identityNamespace": "A String", # IAM Identity Namespace to attach all Kubernetes Service Accounts to.
- },
- "resourceUsageExportConfig": { # Configuration for exporting cluster resource usages. # Configuration for exporting resource usages. Resource usage export is
- # disabled when this config unspecified.
- "bigqueryDestination": { # Parameters for using BigQuery as the destination of resource usage export. # Configuration to use BigQuery as usage export destination.
- "datasetId": "A String", # The ID of a BigQuery Dataset.
- },
- "enableNetworkEgressMetering": True or False, # Whether to enable network egress metering for this cluster. If enabled, a
- # daemonset will be created in the cluster to meter network egress traffic.
- "consumptionMeteringConfig": { # Parameters for controlling consumption metering. # Configuration to enable resource consumption metering.
- "enabled": True or False, # Whether to enable consumption metering for this cluster. If enabled, a
- # second BigQuery table will be created to hold resource consumption
- # records.
- },
- },
- "privateClusterConfig": { # Configuration options for private clusters. # Configuration for private cluster.
- "enablePrivateEndpoint": True or False, # Whether the master's internal IP address is used as the cluster endpoint.
- "publicEndpoint": "A String", # Output only. The external IP address of this cluster's master endpoint.
- "masterGlobalAccessConfig": { # Configuration for controlling master global access settings. # Controls master global access settings.
- "enabled": True or False, # Whenever master is accessible globally or not.
- },
- "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.
- "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.
- "peeringName": "A String", # Output only. The peering name in the customer VPC used by this cluster.
- },
- "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
- },
- ],
- "statusMessage": "A String", # [Output only] Additional information about the current status of this
- # cluster, if available.
- "servicesIpv4Cidr": "A String", # [Output only] The IP address range of the Kubernetes services in
- # this cluster, in
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `1.2.3.4/29`). Service addresses are
- # typically put in the last `/16` from the container CIDR.
- "status": "A String", # [Output only] The current status of this cluster.
- "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the cluster. # Configuration for cluster IP allocation.
- "allowRouteOverlap": True or False, # If true, allow allocation of cluster CIDR ranges that overlap with certain
- # kinds of network routes. By default we do not allow cluster CIDR ranges to
- # intersect with any user declared routes. With allow_route_overlap == true,
- # we allow overlapping with CIDR ranges that are larger than the cluster CIDR
- # range.
- #
- # If this field is set to true, then cluster and services CIDRs must be
- # fully-specified (e.g. `10.96.0.0/14`, but not `/14`), which means:
- # 1) When `use_ip_aliases` is true, `cluster_ipv4_cidr_block` and
- # `services_ipv4_cidr_block` must be fully-specified.
- # 2) When `use_ip_aliases` is false, `cluster.cluster_ipv4_cidr` muse be
- # fully-specified.
- "useIpAliases": True or False, # Whether alias IPs will be used for pod IPs in the cluster.
- # This is used in conjunction with use_routes. It cannot
- # be true if use_routes is true. If both use_ip_aliases and use_routes are
- # false, then the server picks the default IP allocation mode
- "nodeIpv4Cidr": "A String", # This field is deprecated, use node_ipv4_cidr_block.
- "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.
- #
- # 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.
- "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 and
- # create_subnetwork is false.
- "servicesIpv4CidrBlock": "A String", # The IP address range of the services IPs in this cluster. If blank, a range
+ # - "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
+ "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the cluster. # Configuration for cluster IP allocation.
+ "useRoutes": True or False, # Whether routes will be used for pod IPs in the cluster.
+ # This is used in conjunction with use_ip_aliases. It cannot be true if
+ # use_ip_aliases is true. If both use_ip_aliases and use_routes are false,
+ # then the server picks the default IP allocation mode
+ "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.
@@ -1977,10 +1896,42 @@
# 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.
+ "allowRouteOverlap": True or False, # If true, allow allocation of cluster CIDR ranges that overlap with certain
+ # kinds of network routes. By default we do not allow cluster CIDR ranges to
+ # intersect with any user declared routes. With allow_route_overlap == true,
+ # we allow overlapping with CIDR ranges that are larger than the cluster CIDR
+ # range.
+ #
+ # If this field is set to true, then cluster and services CIDRs must be
+ # fully-specified (e.g. `10.96.0.0/14`, but not `/14`), which means:
+ # 1) When `use_ip_aliases` is true, `cluster_ipv4_cidr_block` and
+ # `services_ipv4_cidr_block` must be fully-specified.
+ # 2) When `use_ip_aliases` is false, `cluster.cluster_ipv4_cidr` muse be
+ # fully-specified.
+ "nodeIpv4Cidr": "A String", # This field is deprecated, use node_ipv4_cidr_block.
+ "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.
#
# This field is only applicable when `use_ip_aliases` is true.
- "nodeIpv4CidrBlock": "A String", # The IP address range of the instance IPs in this cluster.
+ #
+ # 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.
+ "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 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.
#
@@ -1994,7 +1945,7 @@
# 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.
- "tpuIpv4CidrBlock": "A String", # The IP address range of the Cloud TPUs in this cluster. If unspecified, a
+ "tpuIpv4CidrBlock": "A String", # The IP address range of the Cloud TPUs in this cluster. If unspecified, a
# range will be automatically chosen with the default size.
#
# This field is only applicable when `use_ip_aliases` is true.
@@ -2010,207 +1961,79 @@
# `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
# to use.
# This field is deprecated, use cluster.tpu_config.ipv4_cidr_block instead.
- "clusterIpv4Cidr": "A String", # This field is deprecated, use cluster_ipv4_cidr_block.
- "useRoutes": True or False, # Whether routes will be used for pod IPs in the cluster.
- # This is used in conjunction with use_ip_aliases. It cannot be true if
- # use_ip_aliases is true. If both use_ip_aliases and use_routes are false,
- # then the server picks the default IP allocation mode
- "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.
- "servicesSecondaryRangeName": "A String", # The name of the secondary range to be used as for the services
+ "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
# ClusterIPs. This must be an existing secondary range associated
# with the cluster subnetwork.
#
# This field is only applicable with use_ip_aliases and
# create_subnetwork is false.
- "servicesIpv4Cidr": "A String", # This field is deprecated, use services_ipv4_cidr_block.
+ "useIpAliases": True or False, # Whether alias IPs will be used for pod IPs in the cluster.
+ # This is used in conjunction with use_routes. It cannot
+ # be true if use_routes is true. If both use_ip_aliases and use_routes are
+ # false, then the server picks the default IP allocation mode
+ "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.
},
- "currentMasterVersion": "A String", # [Output only] The current software version of the master endpoint.
- "description": "A String", # An optional description of this cluster.
- "currentNodeVersion": "A String", # [Output only] Deprecated, use
- # [NodePool.version](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters.nodePools)
- # instead. The current version of the node software components.
- # If they are currently at multiple versions because they're in the process
- # of being upgraded, this reflects the minimum version of all nodes.
- "binaryAuthorization": { # Configuration for Binary Authorization. # Configuration for Binary Authorization.
- "enabled": True or False, # Enable Binary Authorization for this cluster. If enabled, all container
- # images will be validated by Google Binauthz.
+ "legacyAbac": { # Configuration for the legacy Attribute Based Access Control authorization # Configuration for the legacy ABAC authorization mode.
+ # mode.
+ "enabled": True or False, # Whether the ABAC authorizer is enabled for this cluster. When enabled,
+ # identities in the system, including service accounts, nodes, and
+ # controllers, will have statically granted permissions beyond those
+ # provided by the RBAC configuration or IAM.
},
- "labelFingerprint": "A String", # The fingerprint of the set of labels for this cluster.
- "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.
- "autoprovisioningNodePoolDefaults": { # AutoprovisioningNodePoolDefaults contains defaults for a node pool created # AutoprovisioningNodePoolDefaults contains defaults for a node pool
- # created by NAP.
- # by NAP.
- "minCpuPlatform": "A String", # Minimum CPU platform to be used for NAP created node pools.
- # The instance may be scheduled on the specified or newer CPU platform.
- # Applicable values are the friendly names of CPU platforms, such as
- # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
- # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
- # information, read [how to specify min CPU
- # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
- # To unset the min cpu platform field pass "automatic" as field value.
- "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.
- },
- "autoRepair": True or False, # Whether the nodes will be automatically repaired.
- "autoUpgrade": True or False, # Whether the nodes will be automatically upgraded.
- },
- "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.
- "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.
- "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
- # of the node pool during the upgrade process.
- "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.
- },
+ "enableTpu": True or False, # Enable the ability to use Cloud TPUs in this cluster.
+ # This field is deprecated, use tpu_config.enabled instead.
+ "resourceUsageExportConfig": { # Configuration for exporting cluster resource usages. # Configuration for exporting resource usages. Resource usage export is
+ # disabled when this config unspecified.
+ "enableNetworkEgressMetering": True or False, # Whether to enable network egress metering for this cluster. If enabled, a
+ # daemonset will be created in the cluster to meter network egress traffic.
+ "consumptionMeteringConfig": { # Parameters for controlling consumption metering. # Configuration to enable resource consumption metering.
+ "enabled": True or False, # Whether to enable consumption metering for this cluster. If enabled, a
+ # second BigQuery table will be created to hold resource consumption
+ # records.
},
- "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.
- "resourceType": "A String", # Resource name "cpu", "memory" or gpu-specific string.
- "minimum": "A String", # Minimum amount of the resource in the cluster.
- "maximum": "A String", # Maximum amount of the resource in the cluster.
- },
- ],
- "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",
- ],
- "autoscalingProfile": "A String", # Defines autoscaling behaviour.
- "enableNodeAutoprovisioning": True or False, # Enables automatic node pool creation and deletion.
- },
- "masterAuth": { # The authentication information for accessing the master endpoint. # The authentication information for accessing the master endpoint.
- # If unspecified, the defaults are used:
- # For clusters before v1.12, if master_auth is unspecified, `username` will
- # be set to "admin", a random password will be generated, and a client
- # certificate will be issued.
- # Authentication can be done using HTTP basic auth or using client
- # certificates.
- "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).
- "clientKey": "A String", # [Output only] Base64-encoded private key used by clients to authenticate
- # to the cluster endpoint.
- "clientCertificate": "A String", # [Output only] Base64-encoded public certificate used by clients to
- # authenticate to the cluster endpoint.
- "clusterCaCertificate": "A 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
- # must be non-empty.
- "clientCertificateConfig": { # Configuration for client certificates on the cluster. # Configuration for client certificate authentication on the cluster. For
- # clusters before v1.12, if no configuration is specified, a client
- # certificate is issued.
- "issueClientCertificate": True or False, # Issue a client certificate.
+ "bigqueryDestination": { # Parameters for using BigQuery as the destination of resource usage export. # Configuration to use BigQuery as usage export destination.
+ "datasetId": "A String", # The ID of a BigQuery Dataset.
},
},
- "expireTime": "A String", # [Output only] The time the cluster will be automatically
- # deleted in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "masterIpv4CidrBlock": "A String", # The IP prefix in CIDR notation to use for the hosted master network.
- # This prefix will be used for assigning private IP addresses to the
- # master or set of masters, as well as the ILB VIP.
- # This field is deprecated, use
- # private_cluster_config.master_ipv4_cidr_block instead.
- "clusterTelemetry": { # Telemetry integration for the cluster. # Telemetry integration for the cluster.
- "type": "A String", # Type of the integration.
- },
- "tpuIpv4CidrBlock": "A String", # [Output only] The IP address range of the Cloud TPUs in this cluster, in
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `1.2.3.4/29`).
- "nodePools": [ # The node pools associated with this cluster.
- # This field should not be set if "node_config" or "initial_node_count" are
+ "locations": [ # The list of Google Compute Engine
+ # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
+ # cluster's nodes should be located.
+ "A String",
+ ],
+ "nodePools": [ # The node pools associated with this cluster.
+ # This field should not be set if "node_config" or "initial_node_count" are
# specified.
- { # NodePool contains the name and configuration for a cluster's node pool.
- # Node pools are a set of nodes (i.e. VM's), with a common configuration and
+ { # NodePool contains the name and configuration for a cluster's node pool.
+ # Node pools are a set of nodes (i.e. VM's), with a common configuration and
# specification, under the control of the cluster master. They may have a set
# 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.
- "status": "A String", # [Output only] The status of the nodes in this pool instance.
- "selfLink": "A String", # [Output only] Server-defined URL for the resource.
- "management": { # NodeManagement defines the set of node management services turned on for the # NodeManagement configuration for this NodePool.
- # 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.
- },
- "autoRepair": True or False, # Whether the nodes will be automatically repaired.
- "autoUpgrade": True or False, # Whether the nodes will be automatically upgraded.
- },
- "name": "A String", # The name of the node pool.
- "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
- },
- ],
- "autoscaling": { # NodePoolAutoscaling contains information required by cluster autoscaler to # Autoscaler configuration for this NodePool. Autoscaler is enabled
+ "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.
- "minNodeCount": 42, # Minimum number of nodes in the NodePool. Must be >= 1 and <=
+ "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.
- "maxNodeCount": 42, # Maximum number of nodes in the NodePool. Must be >= min_node_count. There
+ "autoprovisioned": True or False, # Can this node pool be deleted automatically.
+ "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.
},
- "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",
- ],
- "maxPodsConstraint": { # Constraints applied to pods. # The constraint on the maximum number of pods that can be run
- # simultaneously on a node in the node pool.
- "maxPodsPerNode": "A String", # Constraint enforced on the max num of pods per node.
- },
- "version": "A String", # The version of the Kubernetes of this node.
- "upgradeSettings": { # These upgrade settings control the level of parallelism and the level of # Upgrade settings control disruption and speed of the upgrade.
+ "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.
+ "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.
#
# maxUnavailable controls the number of nodes that can be simultaneously
@@ -2233,87 +2056,163 @@
# 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.
- "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
+ "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
# of the node pool during the upgrade process.
- "maxUnavailable": 42, # The maximum number of nodes that can be simultaneously unavailable during
+ "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.
},
- "initialNodeCount": 42, # The initial node count for the pool. You must ensure that your
- # Compute Engine <a href="/compute/docs/resource-quotas">resource quota</a>
- # is sufficient for this number of instances. You must also have available
- # firewall and routes quota.
- "podIpv4CidrSize": 42, # [Output only] The pod CIDR block size per node in this node pool.
- "instanceGroupUrls": [ # [Output only] The resource URLs of the [managed instance
+ "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+ "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.
- "A String",
+ "A String",
],
- "config": { # Parameters that describe the nodes in a cluster. # The node configuration of the pool.
- "reservationAffinity": { # [ReservationAffinity](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) # The optional reservation affinity. Setting this field will apply
- # the specified [Zonal Compute
- # Reservation](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources)
- # to this node pool.
- # is the configuration of desired reservation which instances could take
- # capacity from.
- "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.
+ "version": "A String", # The version of the Kubernetes of this node.
+ "podIpv4CidrSize": 42, # [Output only] The pod CIDR block size per node in this node pool.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
- "sandboxConfig": { # SandboxConfig contains configurations of the sandbox to use for the node. # Sandbox configuration for this node.
- "type": "A String", # Type of the sandbox to use for the node.
- "sandboxType": "A String", # Type of the sandbox to use for the node (e.g. 'gvisor')
+ ],
+ "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.
+ "diskSizeGb": 42, # Size of the disk attached to each node, specified in GB.
+ # The smallest allowed disk size is 10GB.
+ #
+ # If unspecified, the default disk size is 100GB.
+ "workloadMetadataConfig": { # WorkloadMetadataConfig defines the metadata configuration to expose to # The workload metadata configuration for this node.
+ # workloads on the node pool.
+ "nodeMetadata": "A String", # NodeMetadata is the configuration for how to expose metadata to the
+ # workloads running on the node.
+ "mode": "A String", # Mode is the configuration for how to expose metadata to workloads running
+ # on the node pool.
},
- "machineType": "A String", # The name of a Google Compute Engine [machine
+ "accelerators": [ # A list of hardware accelerators to be attached to each node.
+ # See https://cloud.google.com/compute/docs/gpus for more information about
+ # support for GPUs.
+ { # AcceleratorConfig represents a Hardware Accelerator request.
+ "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
+ "acceleratorType": "A String", # The accelerator type resource name. List of supported accelerators
+ # [here](https://cloud.google.com/compute/docs/gpus)
+ },
+ ],
+ "machineType": "A String", # The name of a Google Compute Engine [machine
# type](https://cloud.google.com/compute/docs/machine-types) (e.g.
# `n1-standard-1`).
#
# If unspecified, the default machine type is
# `n1-standard-1`.
- "shieldedInstanceConfig": { # A set of Shielded Instance options. # Shielded Instance options.
- "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.
+ "diskType": "A String", # Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
+ #
+ # If unspecified, the default disk type is 'pd-standard'
+ "bootDiskKmsKey": "A String", #
+ # The Customer Managed Encryption Key used to encrypt the boot disk attached
+ # to each node in the node pool. This should be of the form
+ # projects/[KEY_PROJECT_ID]/locations/[LOCATION]/keyRings/[RING_NAME]/cryptoKeys/[KEY_NAME].
+ # For more information about protecting resources with Cloud KMS Keys please
+ # see:
+ # https://cloud.google.com/compute/docs/disks/customer-managed-encryption
+ "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.
},
- "diskType": "A String", # Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
+ "minCpuPlatform": "A String", # Minimum CPU platform to be used by this instance. The instance may be
+ # scheduled on the specified or newer CPU platform. Applicable values are the
+ # friendly names of CPU platforms, such as
+ # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
+ # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
+ # information, read [how to specify min CPU
+ # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
+ "preemptible": True or False, # Whether the nodes are created as preemptible VM instances. See:
+ # https://cloud.google.com/compute/docs/instances/preemptible for more
+ # inforamtion about preemptible VM instances.
+ "localSsdCount": 42, # The number of local SSD disks to be attached to the node.
#
- # If unspecified, the default disk type is 'pd-standard'
- "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
+ # The limit for this value is dependent upon the maximum number of
+ # disks available on a machine per zone. See:
+ # https://cloud.google.com/compute/docs/disks/local-ssd
+ # for more information.
+ "sandboxConfig": { # SandboxConfig contains configurations of the sandbox to use for the node. # Sandbox configuration for this node.
+ "type": "A String", # Type of the sandbox to use for the node.
+ "sandboxType": "A String", # Type of the sandbox to use for the node (e.g. 'gvisor')
+ },
+ "metadata": { # The metadata key/value pairs assigned to instances in the cluster.
+ #
+ # Keys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes
+ # in length. These are reflected as part of a URL in the metadata server.
+ # Additionally, to avoid ambiguity, keys must not conflict with any other
+ # metadata keys for the project or be one of the reserved keys:
+ # "cluster-location"
+ # "cluster-name"
+ # "cluster-uid"
+ # "configure-sh"
+ # "containerd-configure-sh"
+ # "enable-oslogin"
+ # "gci-ensure-gke-docker"
+ # "gci-metrics-enabled"
+ # "gci-update-strategy"
+ # "instance-template"
+ # "kube-env"
+ # "startup-script"
+ # "user-data"
+ # "disable-address-manager"
+ # "windows-startup-script-ps1"
+ # "common-psm1"
+ # "k8s-node-setup-psm1"
+ # "install-ssh-psm1"
+ # "user-profile-psm1"
+ # "serial-port-logging-enable"
+ # Values are free-form strings, and only have meaning as interpreted by
+ # the image running in the instance. The only restriction placed on them is
+ # that each value's size must be less than or equal to 32 KB.
+ #
+ # The total size of all keys and values must be less than 512 KB.
+ "a_key": "A String",
+ },
+ "reservationAffinity": { # [ReservationAffinity](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) # The optional reservation affinity. Setting this field will apply
+ # the specified [Zonal Compute
+ # Reservation](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources)
+ # 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.
+ },
+ "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",
+ "A String",
],
- "preemptible": True or False, # Whether the nodes are created as preemptible VM instances. See:
- # https://cloud.google.com/compute/docs/instances/preemptible for more
- # inforamtion about preemptible VM instances.
- "labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
- # These will added in addition to any default label(s) that
- # Kubernetes may apply to the node.
- # In case of conflict in label keys, the applied set may differ depending on
- # the Kubernetes version -- it's best to assume the behavior is undefined
- # and conflicts should be avoided.
- # For more information, including usage and the valid values, see:
- # https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
- "a_key": "A String",
- },
- "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
+ "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.
- "oauthScopes": [ # The set of Google API scopes to be made available on all of the
- # node VMs under the "default" service account.
+ # 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.
#
# The following scopes are recommended, but not required, and by default are
# not included:
@@ -2327,106 +2226,100 @@
#
# If unspecified, no scopes are added, unless Cloud Logging or Cloud
# Monitoring are enabled, in which case their required scopes will be added.
- "A String",
+ "A String",
],
- "taints": [ # List of kubernetes taints to be applied to each node.
+ "taints": [ # List of kubernetes taints to be applied to each node.
#
# For more information, including usage and the valid values, see:
# https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
{ # Kubernetes taint is comprised of three fields: key, value, and effect. Effect
# can only be one of three types: NoSchedule, PreferNoSchedule or NoExecute.
#
- # For more information, including usage and the valid values, see:
- # https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
- "value": "A String", # Value for taint.
- "key": "A String", # Key for taint.
- "effect": "A String", # Effect for taint.
+ # 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.
},
],
- "workloadMetadataConfig": { # WorkloadMetadataConfig defines the metadata configuration to expose to # The workload metadata configuration for this node.
- # workloads on the node pool.
- "mode": "A String", # Mode is the configuration for how to expose metadata to workloads running
- # on the node pool.
- "nodeMetadata": "A String", # NodeMetadata is the configuration for how to expose metadata to the
- # workloads running on the node.
- },
- "diskSizeGb": 42, # Size of the disk attached to each node, specified in GB.
- # The smallest allowed disk size is 10GB.
- #
- # If unspecified, the default disk size is 100GB.
- "accelerators": [ # A list of hardware accelerators to be attached to each node.
- # See https://cloud.google.com/compute/docs/gpus for more information about
- # support for GPUs.
- { # AcceleratorConfig represents a Hardware Accelerator request.
- "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
- "acceleratorType": "A String", # The accelerator type resource name. List of supported accelerators
- # [here](https://cloud.google.com/compute/docs/gpus)
- },
- ],
- "minCpuPlatform": "A String", # Minimum CPU platform to be used by this instance. The instance may be
- # scheduled on the specified or newer CPU platform. Applicable values are the
- # friendly names of CPU platforms, such as
- # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
- # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
- # information, read [how to specify min CPU
- # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
- "bootDiskKmsKey": "A String", #
- # The Customer Managed Encryption Key used to encrypt the boot disk attached
- # to each node in the node pool. This should be of the form
- # projects/[KEY_PROJECT_ID]/locations/[LOCATION]/keyRings/[RING_NAME]/cryptoKeys/[KEY_NAME].
- # For more information about protecting resources with Cloud KMS Keys please
- # see:
- # https://cloud.google.com/compute/docs/disks/customer-managed-encryption
- "localSsdCount": 42, # The number of local SSD disks to be attached to the node.
- #
- # The limit for this value is dependent upon the maximum number of
- # disks available on a machine per zone. See:
- # https://cloud.google.com/compute/docs/disks/local-ssd
- # for more information.
- "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.
- "metadata": { # The metadata key/value pairs assigned to instances in the cluster.
- #
- # Keys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes
- # in length. These are reflected as part of a URL in the metadata server.
- # Additionally, to avoid ambiguity, keys must not conflict with any other
- # metadata keys for the project or be one of the reserved keys:
- # "cluster-location"
- # "cluster-name"
- # "cluster-uid"
- # "configure-sh"
- # "containerd-configure-sh"
- # "enable-oslogin"
- # "gci-ensure-gke-docker"
- # "gci-metrics-enabled"
- # "gci-update-strategy"
- # "instance-template"
- # "kube-env"
- # "startup-script"
- # "user-data"
- # "disable-address-manager"
- # "windows-startup-script-ps1"
- # "common-psm1"
- # "k8s-node-setup-psm1"
- # "install-ssh-psm1"
- # "user-profile-psm1"
- # "serial-port-logging-enable"
- # Values are free-form strings, and only have meaning as interpreted by
- # the image running in the instance. The only restriction placed on them is
- # that each value's size must be less than or equal to 32 KB.
- #
- # The total size of all keys and values must be less than 512 KB.
- "a_key": "A String",
+ "labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
+ # These will added in addition to any default label(s) that
+ # Kubernetes may apply to the node.
+ # In case of conflict in label keys, the applied set may differ depending on
+ # the Kubernetes version -- it's best to assume the behavior is undefined
+ # and conflicts should be avoided.
+ # For more information, including usage and the valid values, see:
+ # https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
+ "a_key": "A String",
},
},
- "statusMessage": "A String", # [Output only] Additional information about the current status of this
- # node pool instance, if available.
+ "name": "A String", # The name of the node pool.
+ "maxPodsConstraint": { # Constraints applied to pods. # The constraint on the maximum number of pods that can be run
+ # simultaneously on a node in the node pool.
+ "maxPodsPerNode": "A String", # Constraint enforced on the max num of pods per node.
+ },
+ "management": { # NodeManagement defines the set of node management services turned on for the # NodeManagement configuration for this NodePool.
+ # node pool.
+ "autoUpgrade": True or False, # Whether the nodes will be automatically upgraded.
+ "autoRepair": True or False, # Whether the nodes will be automatically repaired.
+ "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.
+ },
+ },
},
],
- "monitoringService": "A String", # The monitoring service the cluster should use to write metrics.
+ "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+ "servicesIpv4Cidr": "A String", # [Output only] The IP address range of the Kubernetes services in
+ # this cluster, in
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `1.2.3.4/29`). Service addresses are
+ # typically put in the last `/16` from the container CIDR.
+ "networkPolicy": { # Configuration options for the NetworkPolicy feature. # Configuration options for the NetworkPolicy feature.
+ # https://kubernetes.io/docs/concepts/services-networking/networkpolicies/
+ "enabled": True or False, # Whether network policy is enabled on the cluster.
+ "provider": "A String", # The selected network policy provider.
+ },
+ "releaseChannel": { # ReleaseChannel indicates which release channel a cluster is # Release channel configuration.
+ # subscribed to. Release channels are arranged in order of risk and
+ # frequency of updates.
+ #
+ # When a cluster is subscribed to a release channel, Google maintains
+ # both the master version and the node version. Node auto-upgrade
+ # defaults to true and cannot be disabled. Updates to version related
+ # fields (e.g. current_master_version) return an error.
+ "channel": "A String", # channel specifies which release channel the cluster is subscribed to.
+ },
+ "enableKubernetesAlpha": True or False, # Kubernetes alpha features are enabled on this cluster. This includes alpha
+ # API groups (e.g. v1beta1) and features that may not be production ready in
+ # the kubernetes version of the master and nodes.
+ # The cluster has no SLA for uptime and master/node upgrades are disabled.
+ # Alpha enabled clusters are automatically deleted thirty days after
+ # creation.
+ "description": "A String", # An optional description of this cluster.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "privateCluster": True or False, # If this is a private cluster setup. Private clusters are clusters that, by
+ # default have no external IP addresses on the nodes and where nodes and the
+ # master communicate over private IP addresses.
+ # This field is deprecated, use private_cluster_config.enable_private_nodes
+ # instead.
+ "currentNodeCount": 42, # [Output only] The number of nodes currently in the cluster. Deprecated.
+ # Call Kubernetes API directly to retrieve node information.
+ "monitoringService": "A String", # The monitoring service the cluster should use to write metrics.
# Currently available options:
#
- # * "monitoring.googleapis.com/kubernetes" - The Cloud Monitoring
+ # * "monitoring.googleapis.com/kubernetes" - The Cloud Monitoring
# service with a Kubernetes-native resource model
# * `monitoring.googleapis.com` - The legacy Cloud Monitoring service (no
# longer available as of GKE 1.15).
@@ -2434,65 +2327,44 @@
#
# If left as an empty string,`monitoring.googleapis.com/kubernetes` will be
# used for GKE 1.14+ or `monitoring.googleapis.com` for earlier versions.
- "createTime": "A String", # [Output only] The time the cluster was created, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "databaseEncryption": { # Configuration of etcd encryption. # Configuration of etcd encryption.
- "state": "A String", # Denotes the state of etcd encryption.
- "keyName": "A String", # Name of CloudKMS key to use for the encryption of secrets in etcd.
+ "databaseEncryption": { # Configuration of etcd encryption. # Configuration of etcd encryption.
+ "state": "A String", # Denotes the state of etcd encryption.
+ "keyName": "A String", # Name of CloudKMS key to use for the encryption of secrets in etcd.
# Ex. projects/my-project/locations/global/keyRings/my-ring/cryptoKeys/my-key
},
- "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
- # the following restrictions:
- #
- # * Lowercase letters, numbers, and hyphens only.
- # * Must start with a letter.
- # * Must end with a number or a letter.
- "legacyAbac": { # Configuration for the legacy Attribute Based Access Control authorization # Configuration for the legacy ABAC authorization mode.
- # mode.
- "enabled": True or False, # Whether the ABAC authorizer is enabled for this cluster. When enabled,
- # identities in the system, including service accounts, nodes, and
- # controllers, will have statically granted permissions beyond those
- # provided by the RBAC configuration or IAM.
+ "binaryAuthorization": { # Configuration for Binary Authorization. # Configuration for Binary Authorization.
+ "enabled": True or False, # Enable Binary Authorization for this cluster. If enabled, all container
+ # images will be validated by Google Binauthz.
},
- "endpoint": "A String", # [Output only] The IP address of this cluster's master endpoint.
- # The endpoint can be accessed from the internet at
- # `https://username:password@endpoint/`.
- #
- # See the `masterAuth` property of this resource for username and
- # password information.
- "currentNodeCount": 42, # [Output only] The number of nodes currently in the cluster. Deprecated.
- # Call Kubernetes API directly to retrieve node information.
- "zone": "A String", # [Output only] The name of the Google Compute Engine
+ "tpuIpv4CidrBlock": "A String", # [Output only] The IP address range of the Cloud TPUs in this cluster, in
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `1.2.3.4/29`).
+ "workloadIdentityConfig": { # Configuration for the use of Kubernetes Service Accounts in GCP IAM # Configuration for the use of Kubernetes Service Accounts in GCP IAM
+ # policies.
+ # policies.
+ "identityNamespace": "A String", # IAM Identity Namespace to attach all Kubernetes Service Accounts to.
+ "workloadPool": "A String", # The workload pool to attach all Kubernetes service accounts to.
+ },
+ "zone": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/zones#available) in which the
# cluster resides. This field is deprecated, use location instead.
- "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.
- },
- "tpuConfig": { # Configuration for Cloud TPU. # Configuration for Cloud TPU support;
- "useServiceNetworking": True or False, # Whether to use service networking for Cloud TPU or not.
- "ipv4CidrBlock": "A String", # IPv4 CIDR block reserved for Cloud TPU in the VPC.
- "enabled": True or False, # Whether Cloud TPU integration is enabled or not.
- },
- "initialClusterVersion": "A String", # The initial Kubernetes version for this cluster. Valid versions are those
- # found in validMasterVersions returned by getServerConfig. The version can
- # be upgraded over time; such upgrades are reflected in
- # currentMasterVersion and currentNodeVersion.
+ "loggingService": "A String", # The logging service the cluster should use to write logs.
+ # Currently available options:
#
- # Users may specify either explicit versions offered by
- # Kubernetes Engine or version aliases, which have the following behavior:
+ # * `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.
#
- # - "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
- "nodeConfig": { # Parameters that describe the nodes in a cluster. # Parameters used in creating the cluster's nodes.
+ # If left as an empty string,`logging.googleapis.com/kubernetes` will be
+ # used for GKE 1.14+ or `logging.googleapis.com` for earlier versions.
+ "expireTime": "A String", # [Output only] The time the cluster will be automatically
+ # deleted in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "nodeConfig": { # Parameters that describe the nodes in a cluster. # Parameters used in creating the cluster's nodes.
# For requests, this field should only be used in lieu of a
- # "node_pool" object, since this configuration (along with the
- # "initial_node_count") will be used to create a "NodePool" object with an
+ # "node_pool" object, since this configuration (along with the
+ # "initial_node_count") will be used to create a "NodePool" object with an
# auto-generated name. Do not use this and a node_pool at the same time.
# For responses, this field will be populated with the node configuration of
# the first node pool. (For configuration of each node pool, see
@@ -2500,70 +2372,135 @@
#
# If unspecified, the defaults are used.
# This field is deprecated, use node_pool.config instead.
- "reservationAffinity": { # [ReservationAffinity](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) # The optional reservation affinity. Setting this field will apply
- # the specified [Zonal Compute
- # Reservation](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources)
- # to this node pool.
- # is the configuration of desired reservation which instances could take
- # capacity from.
- "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.
+ "diskSizeGb": 42, # Size of the disk attached to each node, specified in GB.
+ # The smallest allowed disk size is 10GB.
+ #
+ # If unspecified, the default disk size is 100GB.
+ "workloadMetadataConfig": { # WorkloadMetadataConfig defines the metadata configuration to expose to # The workload metadata configuration for this node.
+ # workloads on the node pool.
+ "nodeMetadata": "A String", # NodeMetadata is the configuration for how to expose metadata to the
+ # workloads running on the node.
+ "mode": "A String", # Mode is the configuration for how to expose metadata to workloads running
+ # on the node pool.
},
- "sandboxConfig": { # SandboxConfig contains configurations of the sandbox to use for the node. # Sandbox configuration for this node.
- "type": "A String", # Type of the sandbox to use for the node.
- "sandboxType": "A String", # Type of the sandbox to use for the node (e.g. 'gvisor')
- },
- "machineType": "A String", # The name of a Google Compute Engine [machine
+ "accelerators": [ # A list of hardware accelerators to be attached to each node.
+ # See https://cloud.google.com/compute/docs/gpus for more information about
+ # support for GPUs.
+ { # AcceleratorConfig represents a Hardware Accelerator request.
+ "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
+ "acceleratorType": "A String", # The accelerator type resource name. List of supported accelerators
+ # [here](https://cloud.google.com/compute/docs/gpus)
+ },
+ ],
+ "machineType": "A String", # The name of a Google Compute Engine [machine
# type](https://cloud.google.com/compute/docs/machine-types) (e.g.
# `n1-standard-1`).
#
# If unspecified, the default machine type is
# `n1-standard-1`.
- "shieldedInstanceConfig": { # A set of Shielded Instance options. # Shielded Instance options.
- "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.
+ "diskType": "A String", # Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
+ #
+ # If unspecified, the default disk type is 'pd-standard'
+ "bootDiskKmsKey": "A String", #
+ # The Customer Managed Encryption Key used to encrypt the boot disk attached
+ # to each node in the node pool. This should be of the form
+ # projects/[KEY_PROJECT_ID]/locations/[LOCATION]/keyRings/[RING_NAME]/cryptoKeys/[KEY_NAME].
+ # For more information about protecting resources with Cloud KMS Keys please
+ # see:
+ # https://cloud.google.com/compute/docs/disks/customer-managed-encryption
+ "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.
},
- "diskType": "A String", # Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
+ "minCpuPlatform": "A String", # Minimum CPU platform to be used by this instance. The instance may be
+ # scheduled on the specified or newer CPU platform. Applicable values are the
+ # friendly names of CPU platforms, such as
+ # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
+ # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
+ # information, read [how to specify min CPU
+ # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
+ "preemptible": True or False, # Whether the nodes are created as preemptible VM instances. See:
+ # https://cloud.google.com/compute/docs/instances/preemptible for more
+ # inforamtion about preemptible VM instances.
+ "localSsdCount": 42, # The number of local SSD disks to be attached to the node.
#
- # If unspecified, the default disk type is 'pd-standard'
- "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
+ # The limit for this value is dependent upon the maximum number of
+ # disks available on a machine per zone. See:
+ # https://cloud.google.com/compute/docs/disks/local-ssd
+ # for more information.
+ "sandboxConfig": { # SandboxConfig contains configurations of the sandbox to use for the node. # Sandbox configuration for this node.
+ "type": "A String", # Type of the sandbox to use for the node.
+ "sandboxType": "A String", # Type of the sandbox to use for the node (e.g. 'gvisor')
+ },
+ "metadata": { # The metadata key/value pairs assigned to instances in the cluster.
+ #
+ # Keys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes
+ # in length. These are reflected as part of a URL in the metadata server.
+ # Additionally, to avoid ambiguity, keys must not conflict with any other
+ # metadata keys for the project or be one of the reserved keys:
+ # "cluster-location"
+ # "cluster-name"
+ # "cluster-uid"
+ # "configure-sh"
+ # "containerd-configure-sh"
+ # "enable-oslogin"
+ # "gci-ensure-gke-docker"
+ # "gci-metrics-enabled"
+ # "gci-update-strategy"
+ # "instance-template"
+ # "kube-env"
+ # "startup-script"
+ # "user-data"
+ # "disable-address-manager"
+ # "windows-startup-script-ps1"
+ # "common-psm1"
+ # "k8s-node-setup-psm1"
+ # "install-ssh-psm1"
+ # "user-profile-psm1"
+ # "serial-port-logging-enable"
+ # Values are free-form strings, and only have meaning as interpreted by
+ # the image running in the instance. The only restriction placed on them is
+ # that each value's size must be less than or equal to 32 KB.
+ #
+ # The total size of all keys and values must be less than 512 KB.
+ "a_key": "A String",
+ },
+ "reservationAffinity": { # [ReservationAffinity](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) # The optional reservation affinity. Setting this field will apply
+ # the specified [Zonal Compute
+ # Reservation](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources)
+ # 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.
+ },
+ "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",
+ "A String",
],
- "preemptible": True or False, # Whether the nodes are created as preemptible VM instances. See:
- # https://cloud.google.com/compute/docs/instances/preemptible for more
- # inforamtion about preemptible VM instances.
- "labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
- # These will added in addition to any default label(s) that
- # Kubernetes may apply to the node.
- # In case of conflict in label keys, the applied set may differ depending on
- # the Kubernetes version -- it's best to assume the behavior is undefined
- # and conflicts should be avoided.
- # For more information, including usage and the valid values, see:
- # https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
- "a_key": "A String",
- },
- "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
+ "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.
- "oauthScopes": [ # The set of Google API scopes to be made available on all of the
- # node VMs under the "default" service account.
+ # 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.
#
# The following scopes are recommended, but not required, and by default are
# not included:
@@ -2577,127 +2514,194 @@
#
# If unspecified, no scopes are added, unless Cloud Logging or Cloud
# Monitoring are enabled, in which case their required scopes will be added.
- "A String",
+ "A String",
],
- "taints": [ # List of kubernetes taints to be applied to each node.
+ "taints": [ # List of kubernetes taints to be applied to each node.
#
# For more information, including usage and the valid values, see:
# https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
{ # Kubernetes taint is comprised of three fields: key, value, and effect. Effect
# can only be one of three types: NoSchedule, PreferNoSchedule or NoExecute.
#
- # For more information, including usage and the valid values, see:
- # https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
- "value": "A String", # Value for taint.
- "key": "A String", # Key for taint.
- "effect": "A String", # Effect for taint.
+ # 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.
},
],
- "workloadMetadataConfig": { # WorkloadMetadataConfig defines the metadata configuration to expose to # The workload metadata configuration for this node.
- # workloads on the node pool.
- "mode": "A String", # Mode is the configuration for how to expose metadata to workloads running
- # on the node pool.
- "nodeMetadata": "A String", # NodeMetadata is the configuration for how to expose metadata to the
- # workloads running on the node.
- },
- "diskSizeGb": 42, # Size of the disk attached to each node, specified in GB.
- # The smallest allowed disk size is 10GB.
- #
- # If unspecified, the default disk size is 100GB.
- "accelerators": [ # A list of hardware accelerators to be attached to each node.
- # See https://cloud.google.com/compute/docs/gpus for more information about
- # support for GPUs.
- { # AcceleratorConfig represents a Hardware Accelerator request.
- "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
- "acceleratorType": "A String", # The accelerator type resource name. List of supported accelerators
- # [here](https://cloud.google.com/compute/docs/gpus)
- },
- ],
- "minCpuPlatform": "A String", # Minimum CPU platform to be used by this instance. The instance may be
- # scheduled on the specified or newer CPU platform. Applicable values are the
- # friendly names of CPU platforms, such as
- # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
- # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
- # information, read [how to specify min CPU
- # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
- "bootDiskKmsKey": "A String", #
- # The Customer Managed Encryption Key used to encrypt the boot disk attached
- # to each node in the node pool. This should be of the form
- # projects/[KEY_PROJECT_ID]/locations/[LOCATION]/keyRings/[RING_NAME]/cryptoKeys/[KEY_NAME].
- # For more information about protecting resources with Cloud KMS Keys please
- # see:
- # https://cloud.google.com/compute/docs/disks/customer-managed-encryption
- "localSsdCount": 42, # The number of local SSD disks to be attached to the node.
- #
- # The limit for this value is dependent upon the maximum number of
- # disks available on a machine per zone. See:
- # https://cloud.google.com/compute/docs/disks/local-ssd
- # for more information.
- "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.
- "metadata": { # The metadata key/value pairs assigned to instances in the cluster.
- #
- # Keys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes
- # in length. These are reflected as part of a URL in the metadata server.
- # Additionally, to avoid ambiguity, keys must not conflict with any other
- # metadata keys for the project or be one of the reserved keys:
- # "cluster-location"
- # "cluster-name"
- # "cluster-uid"
- # "configure-sh"
- # "containerd-configure-sh"
- # "enable-oslogin"
- # "gci-ensure-gke-docker"
- # "gci-metrics-enabled"
- # "gci-update-strategy"
- # "instance-template"
- # "kube-env"
- # "startup-script"
- # "user-data"
- # "disable-address-manager"
- # "windows-startup-script-ps1"
- # "common-psm1"
- # "k8s-node-setup-psm1"
- # "install-ssh-psm1"
- # "user-profile-psm1"
- # "serial-port-logging-enable"
- # Values are free-form strings, and only have meaning as interpreted by
- # the image running in the instance. The only restriction placed on them is
- # that each value's size must be less than or equal to 32 KB.
- #
- # The total size of all keys and values must be less than 512 KB.
- "a_key": "A String",
+ "labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
+ # These will added in addition to any default label(s) that
+ # Kubernetes may apply to the node.
+ # In case of conflict in label keys, the applied set may differ depending on
+ # the Kubernetes version -- it's best to assume the behavior is undefined
+ # and conflicts should be avoided.
+ # For more information, including usage and the valid values, see:
+ # https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
+ "a_key": "A String",
},
},
- "clusterIpv4Cidr": "A String", # The IP address range of the container pods in this cluster, in
+ "status": "A String", # [Output only] The current status of this cluster.
+ "tpuConfig": { # Configuration for Cloud TPU. # Configuration for Cloud TPU support;
+ "enabled": True or False, # Whether Cloud TPU integration is enabled or not.
+ "ipv4CidrBlock": "A String", # IPv4 CIDR block reserved for Cloud TPU in the VPC.
+ "useServiceNetworking": True or False, # Whether to use service networking for Cloud TPU or not.
+ },
+ "networkConfig": { # NetworkConfig reports the relative names of network & subnetwork. # Configuration for cluster networking.
+ "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:
+ # projects/my-project/regions/us-central1/subnetworks/my-subnet
+ "network": "A String", # Output only. The relative name of the Google Compute Engine
+ # 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
+ # the following restrictions:
+ #
+ # * Lowercase letters, numbers, and hyphens only.
+ # * Must start with a letter.
+ # * Must end with a number or a letter.
+ "endpoint": "A String", # [Output only] The IP address of this cluster's master endpoint.
+ # The endpoint can be accessed from the internet at
+ # `https://username:password@endpoint/`.
+ #
+ # See the `masterAuth` property of this resource for username and
+ # password information.
+ "location": "A String", # [Output only] The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
+ # 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`.
- "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
- # during authentication using a group of security groups.
- "securityGroup": "A String", # The name of the security group-of-groups to be used. Only relevant
- # if enabled = true.
+ "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.
+ "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.
+ },
+ ],
+ "autoscalingProfile": "A String", # Defines autoscaling behaviour.
+ "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.
+ "autoUpgrade": True or False, # Whether the nodes will be automatically upgraded.
+ "autoRepair": True or False, # Whether the nodes will be automatically repaired.
+ "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.
+ },
+ },
+ "minCpuPlatform": "A String", # Minimum CPU platform to be used for NAP created node pools.
+ # The instance may be scheduled on the specified or newer CPU platform.
+ # Applicable values are the friendly names of CPU platforms, such as
+ # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
+ # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
+ # information, read [how to specify min CPU
+ # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
+ # To unset the min cpu platform field pass "automatic" as field value.
+ "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.
+ "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
+ # of the node pool during the upgrade process.
+ "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.
+ },
+ "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.
+ },
+ "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",
+ ],
},
- "subnetwork": "A String", # The name of the Google Compute Engine
- # [subnetwork](https://cloud.google.com/compute/docs/subnetworks) to which
- # the cluster is connected. On output this shows the subnetwork ID instead of
- # the name.
- "resourceLabels": { # The resource labels for the cluster to use to annotate any related
- # Google Compute Engine resources.
- "a_key": "A String",
- },
- "selfLink": "A String", # [Output only] Server-defined URL for the resource.
- "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>
+ "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
+ # "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.
+ "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.
+ "masterGlobalAccessConfig": { # Configuration for controlling master global access settings. # Controls master global access settings.
+ "enabled": True or False, # Whenever master is accessible globally or not.
+ },
+ "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.
+ },
+ "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>
@@ -2720,18 +2724,18 @@
{ # SetLegacyAbacRequest enables or disables the ABAC authorization mechanism for
# a cluster.
- "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
+ "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.
+ "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
# number](https://support.google.com/cloud/answer/6158840).
# This field has been deprecated and replaced by the name field.
- "clusterId": "A String", # Required. Deprecated. The name of the cluster to update.
- # This field has been deprecated and replaced by the name field.
- "enabled": True or False, # Required. Whether ABAC authorization will be enabled in the cluster.
- "name": "A String", # The name (project, location, cluster id) of the cluster to set legacy abac.
- # Specified in the format 'projects/*/locations/*/clusters/*'.
- "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
+ "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/zones#available) in which the
# cluster resides. This field has been deprecated and replaced by the name
# field.
+ "clusterId": "A String", # Required. 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.
@@ -2744,61 +2748,61 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
- "status": "A String", # The current status of the operation.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "endTime": "A String", # [Output only] The time the operation completed, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "name": "A String", # The server-assigned ID for the operation.
- "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.
- "clusterConditions": [ # Which conditions caused the current cluster state.
+ "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
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
],
- "startTime": "A String", # [Output only] The time the operation started, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
- "operationType": "A String", # The operation type.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "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.).
- "intValue": "A String", # For metrics with integer value.
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- },
- ],
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "selfLink": "A String", # Server-defined URL for the resource.
- "location": "A String", # [Output only] The name of the Google Compute Engine
+ "location": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "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.
+ "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.
+ "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.).
+ },
+ ],
+ "name": "A String", # A non-parameterized string describing 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.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "detail": "A String", # Detailed operation progress, if available.
+ "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.
}</pre>
</div>
@@ -2813,11 +2817,11 @@
This field has been deprecated and replaced by the parent field. (required)
zone: string, Required. Deprecated. The name of the Google Compute Engine
[zone](https://cloud.google.com/compute/docs/zones#available) in which the
-cluster resides, or "-" for all zones. This field has been deprecated and
+cluster resides, or "-" for all zones. This field has been deprecated and
replaced by the parent field. (required)
parent: string, The parent (project and location) where the clusters will be listed.
-Specified in the format 'projects/*/locations/*'.
-Location "-" matches all zones and all regions.
+Specified in the format `projects/*/locations/*`.
+Location "-" matches all zones and all regions.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -2827,30 +2831,178 @@
An object of the form:
{ # ListClustersResponse is the result of ListClustersRequest.
- "clusters": [ # A list of clusters in the project in the specified zone, or
+ "clusters": [ # A list of clusters in the project in the specified zone, or
# across all ones.
{ # A Google Kubernetes Engine cluster.
- "nodeIpv4CidrSize": 42, # [Output only] The size of the address space on each node for hosting
+ "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.
+ "maxPodsPerNode": "A String", # Constraint enforced on the max num of pods per node.
+ },
+ "network": "A String", # The name of the Google Compute Engine
+ # [network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks)
+ # to which the cluster is connected. If left unspecified, the `default`
+ # network will be used. On output this shows the network ID instead of the
+ # name.
+ "labelFingerprint": "A String", # The fingerprint of the set of labels for this cluster.
+ "nodeIpv4CidrSize": 42, # [Output only] The size of the address space on each node for hosting
# containers. This is provisioned from within the `container_ipv4_cidr`
# range. This field will only be set when cluster is in route-based network
# mode.
- "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.
- "recurringWindow": { # Represents an arbitrary window of time that recurs. # RecurringWindow specifies some number of recurring time periods for
+ "masterAuthorizedNetworksConfig": { # Configuration options for the master authorized networks feature. Enabled # The configuration options for master authorized networks feature.
+ # 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.
+ "cidrBlocks": [ # cidr_blocks define up to 10 external networks that could access
+ # Kubernetes master through HTTPS.
+ { # CidrBlock contains an optional name and one CIDR block.
+ "displayName": "A String", # display_name is an optional field for users to identify CIDR blocks.
+ "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.
+ "masterAuth": { # The authentication information for accessing the master endpoint. # The authentication information for accessing the master endpoint.
+ # If unspecified, the defaults are used:
+ # For clusters before v1.12, if master_auth is unspecified, `username` will
+ # be set to "admin", a random password will be generated, and a client
+ # certificate will be issued.
+ # Authentication can be done using HTTP basic auth or using client
+ # certificates.
+ "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
+ # must be non-empty.
+ "clientCertificateConfig": { # Configuration for client certificates on the cluster. # Configuration for client certificate authentication on the cluster. For
+ # clusters before v1.12, if no configuration is specified, a client
+ # certificate is issued.
+ "issueClientCertificate": True or False, # Issue a client certificate.
+ },
+ "clientKey": "A String", # [Output only] Base64-encoded private key used by clients to authenticate
+ # to the cluster endpoint.
+ "clusterCaCertificate": "A String",
+ "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
+ # during authentication using a group of security groups.
+ "securityGroup": "A String", # The name of the security group-of-groups to be used. Only relevant
+ # if enabled = true.
+ },
+ "masterIpv4CidrBlock": "A String", # The IP prefix in CIDR notation to use for the hosted master network.
+ # This prefix will be used for assigning private IP addresses to the
+ # master or set of masters, as well as the ILB VIP.
+ # This field is deprecated, use
+ # private_cluster_config.master_ipv4_cidr_block instead.
+ "clusterTelemetry": { # Telemetry integration for the cluster. # Telemetry integration for the cluster.
+ "type": "A String", # Type of the integration.
+ },
+ "currentMasterVersion": "A String", # [Output only] The current software version of the master endpoint.
+ "addonsConfig": { # 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
+ # is enabled or not on the Master, it does not track whether network policy
+ # is enabled for the nodes.
+ # is enabled or not on the Master, it does not track whether network policy
+ # is enabled for the nodes.
+ "disabled": True or False, # Whether NetworkPolicy is enabled for this cluster.
+ },
+ "configConnectorConfig": { # Configuration options for the Config Connector add-on. # Configuration for the ConfigConnector add-on, a Kubernetes
+ # extension to manage hosted GCP services through the Kubernetes API
+ "enabled": True or False, # Whether Cloud Connector is enabled for this cluster.
+ },
+ "cloudRunConfig": { # Configuration options for the Cloud Run feature. # Configuration for the Cloud Run addon. The `IstioConfig` addon must be
+ # enabled in order to enable Cloud Run addon. This option can only be enabled
+ # at cluster creation time.
+ "disabled": True or False, # Whether Cloud Run addon is enabled for this cluster.
+ },
+ "horizontalPodAutoscaling": { # Configuration options for the horizontal pod autoscaling feature, which # Configuration for the horizontal pod autoscaling feature, which
+ # increases or decreases the number of replica pods a replication controller
+ # has based on the resource usage of the existing pods.
+ # increases or decreases the number of replica pods a replication controller
+ # has based on the resource usage of the existing pods.
+ "disabled": True or False, # Whether the Horizontal Pod Autoscaling feature is enabled in the cluster.
+ # When enabled, it ensures that metrics are collected into Stackdriver
+ # Monitoring.
+ },
+ "httpLoadBalancing": { # Configuration options for the HTTP (L7) load balancing controller addon, # Configuration for the HTTP (L7) load balancing controller addon, which
+ # makes it easy to set up HTTP load balancers for services in a cluster.
+ # which makes it easy to set up HTTP load balancers for services in a cluster.
+ "disabled": True or False, # Whether the HTTP Load Balancing controller is enabled in the cluster.
+ # When enabled, it runs a small pod in the cluster that manages the load
+ # balancers.
+ },
+ "kubernetesDashboard": { # Configuration for the Kubernetes Dashboard. # Configuration for the Kubernetes Dashboard.
+ # This addon is deprecated, and will be disabled in 1.15. It is recommended
+ # to use the Cloud Console to manage and monitor your Kubernetes clusters,
+ # workloads and applications. For more information, see:
+ # https://cloud.google.com/kubernetes-engine/docs/concepts/dashboards
+ "disabled": True or False, # Whether the Kubernetes Dashboard is enabled for this cluster.
+ },
+ "dnsCacheConfig": { # Configuration for NodeLocal DNSCache # Configuration for NodeLocalDNS, a dns cache running on cluster nodes
+ "enabled": True or False, # Whether NodeLocal DNSCache is enabled for this cluster.
+ },
+ "kalmConfig": { # Configuration options for the KALM addon. # Configuration for the KALM addon, which manages the lifecycle of k8s
+ # applications.
+ "enabled": True or False, # Whether KALM is enabled for this cluster.
+ },
+ "gcePersistentDiskCsiDriverConfig": { # Configuration for the Compute Engine PD CSI driver. This option can only be # Configuration for the Compute Engine Persistent Disk CSI driver.
+ # enabled at cluster creation time.
+ "enabled": True or False, # Whether the Compute Engine PD CSI driver is enabled for this cluster.
+ },
+ "istioConfig": { # Configuration options for Istio addon. # Configuration for Istio, an open platform to connect, manage, and secure
+ # microservices.
+ "disabled": True or False, # Whether Istio is enabled for this cluster.
+ "auth": "A String", # The specified Istio auth mode, either none, or mutual TLS.
+ },
+ },
+ "podSecurityPolicyConfig": { # Configuration for the PodSecurityPolicy feature. # Configuration for the PodSecurityPolicy feature.
+ "enabled": True or False, # Enable the PodSecurityPolicy controller for this cluster. If enabled, pods
+ # must be valid under a PodSecurityPolicy to be created.
+ },
+ "currentNodeVersion": "A String", # [Output only] Deprecated, use
+ # [NodePool.version](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters.nodePools)
+ # instead. The current version of the node software components.
+ # If they are currently at multiple versions because they're in the process
+ # of being upgraded, this reflects the minimum version of all nodes.
+ "subnetwork": "A String", # The name of the Google Compute Engine
+ # [subnetwork](https://cloud.google.com/compute/docs/subnetworks) to which
+ # the cluster is connected. On output this shows the subnetwork ID instead of
+ # the name.
+ "maintenancePolicy": { # MaintenancePolicy defines the maintenance policy to be used for the cluster. # Configure the maintenance policy for this cluster.
+ "resourceVersion": "A String", # A hash identifying the version of this policy, so that updates to fields of
+ # the policy won't accidentally undo intermediate changes (and so that users
+ # of the API unaware of some fields won't accidentally remove other fields).
+ # Make a <code>get()</code> request to the cluster to get the current
+ # resource version and include it with requests to set the 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.
+ "startTime": "A String", # Time within the maintenance window to start the maintenance operations.
+ # It must be in format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
+ },
+ "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.
- "recurrence": "A String", # An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how
+ "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.
#
- # For example, to have something repeat every weekday, you'd use:
+ # For example, to have something repeat every weekday, you'd use:
# <code>FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR</code>
# To repeat some window daily (equivalent to the DailyMaintenanceWindow):
# <code>FREQ=DAILY</code>
# For the first weekend of every month:
# <code>FREQ=MONTHLY;BYSETPOS=1;BYDAY=SA,SU</code>
# This specifies how frequently the window starts. Eg, if you wanted to have
- # a 9-5 UTC-4 window every weekday, you'd use something like:
+ # a 9-5 UTC-4 window every weekday, you'd use something like:
# <code>
# start time = 2019-01-01T09:00:00-0400
# end time = 2019-01-01T17:00:00-0400
@@ -2863,279 +3015,48 @@
# end time = 2019-01-07T23:59:00Z
# recurrence = FREQ=WEEKLY;BYDAY=SA
# </code>
- # Note the start and end time's specific dates are largely arbitrary except
+ # 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
+ "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.
+ "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.
- "duration": "A String", # [Output only] Duration of the time window, automatically chosen to be
- # smallest possible in the given scenario.
- "startTime": "A String", # Time within the maintenance window to start the maintenance operations.
- # It must be in format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
- },
- "maintenanceExclusions": { # Exceptions to maintenance window. Non-emergency maintenance should not
+ "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
+ "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.
+ "startTime": "A String", # The time that the window first starts.
},
},
},
- "resourceVersion": "A String", # A hash identifying the version of this policy, so that updates to fields of
- # the policy won't accidentally undo intermediate changes (and so that users
- # of the API unaware of some fields won't accidentally remove other fields).
- # Make a <code>get()</code> request to the cluster to get the current
- # resource version and include it with requests to set the policy.
},
- "networkPolicy": { # Configuration options for the NetworkPolicy feature. # Configuration options for the NetworkPolicy feature.
- # https://kubernetes.io/docs/concepts/services-networking/networkpolicies/
- "enabled": True or False, # Whether network policy is enabled on the cluster.
- "provider": "A String", # The selected network policy provider.
+ "resourceLabels": { # The resource labels for the cluster to use to annotate any related
+ # Google Compute Engine resources.
+ "a_key": "A String",
},
- "masterAuthorizedNetworksConfig": { # Configuration options for the master authorized networks feature. Enabled # The configuration options for master authorized networks feature.
- # 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 10 external networks that could access
- # Kubernetes master through HTTPS.
- { # CidrBlock contains an optional name and one CIDR block.
- "cidrBlock": "A String", # cidr_block must be specified in CIDR notation.
- "displayName": "A String", # display_name is an optional field for users to identify CIDR blocks.
- },
- ],
- },
- "addonsConfig": { # 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
- # is enabled or not on the Master, it does not track whether network policy
- # is enabled for the nodes.
- # is enabled or not on the Master, it does not track whether network policy
- # is enabled for the nodes.
- "disabled": True or False, # Whether NetworkPolicy is enabled for this cluster.
- },
- "cloudRunConfig": { # Configuration options for the Cloud Run feature. # Configuration for the Cloud Run addon. The `IstioConfig` addon must be
- # enabled in order to enable Cloud Run addon. This option can only be enabled
- # at cluster creation time.
- "disabled": True or False, # Whether Cloud Run addon is enabled for this cluster.
- },
- "httpLoadBalancing": { # Configuration options for the HTTP (L7) load balancing controller addon, # Configuration for the HTTP (L7) load balancing controller addon, which
- # makes it easy to set up HTTP load balancers for services in a cluster.
- # which makes it easy to set up HTTP load balancers for services in a cluster.
- "disabled": True or False, # Whether the HTTP Load Balancing controller is enabled in the cluster.
- # When enabled, it runs a small pod in the cluster that manages the load
- # balancers.
- },
- "kalmConfig": { # Configuration options for the KALM addon. # Configuration for the KALM addon, which manages the lifecycle of k8s
- # applications.
- "enabled": True or False, # Whether KALM is enabled for this cluster.
- },
- "horizontalPodAutoscaling": { # Configuration options for the horizontal pod autoscaling feature, which # Configuration for the horizontal pod autoscaling feature, which
- # increases or decreases the number of replica pods a replication controller
- # has based on the resource usage of the existing pods.
- # increases or decreases the number of replica pods a replication controller
- # has based on the resource usage of the existing pods.
- "disabled": True or False, # Whether the Horizontal Pod Autoscaling feature is enabled in the cluster.
- # When enabled, it ensures that metrics are collected into Stackdriver
- # Monitoring.
- },
- "gcePersistentDiskCsiDriverConfig": { # Configuration for the Compute Engine PD CSI driver. This option can only be # Configuration for the Compute Engine Persistent Disk CSI driver.
- # enabled at cluster creation time.
- "enabled": True or False, # Whether the Compute Engine PD CSI driver is enabled for this cluster.
- },
- "configConnectorConfig": { # Configuration options for the Config Connector add-on. # Configuration for the ConfigConnector add-on, a Kubernetes
- # extension to manage hosted GCP services through the Kubernetes API
- "enabled": True or False, # Whether Cloud Connector is enabled for this cluster.
- },
- "dnsCacheConfig": { # Configuration for NodeLocal DNSCache # Configuration for NodeLocalDNS, a dns cache running on cluster nodes
- "enabled": True or False, # Whether NodeLocal DNSCache is enabled for this cluster.
- },
- "istioConfig": { # Configuration options for Istio addon. # Configuration for Istio, an open platform to connect, manage, and secure
- # microservices.
- "disabled": True or False, # Whether Istio is enabled for this cluster.
- "auth": "A String", # The specified Istio auth mode, either none, or mutual TLS.
- },
- "kubernetesDashboard": { # Configuration for the Kubernetes Dashboard. # Configuration for the Kubernetes Dashboard.
- # This addon is deprecated, and will be disabled in 1.15. It is recommended
- # to use the Cloud Console to manage and monitor your Kubernetes clusters,
- # workloads and applications. For more information, see:
- # https://cloud.google.com/kubernetes-engine/docs/concepts/dashboards
- "disabled": True or False, # Whether the Kubernetes Dashboard is enabled for this cluster.
- },
- },
- "locations": [ # The list of Google Compute Engine
- # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
- # cluster's nodes should be located.
- "A String",
- ],
- "enableKubernetesAlpha": True or False, # Kubernetes alpha features are enabled on this cluster. This includes alpha
- # API groups (e.g. v1beta1) and features that may not be production ready in
- # the kubernetes version of the master and nodes.
- # The cluster has no SLA for uptime and master/node upgrades are disabled.
- # Alpha enabled clusters are automatically deleted thirty days after
- # creation.
- "enableTpu": True or False, # Enable the ability to use Cloud TPUs in this cluster.
- # This field is deprecated, use tpu_config.enabled instead.
- "releaseChannel": { # ReleaseChannel indicates which release channel a cluster is # Release channel configuration.
- # subscribed to. Release channels are arranged in order of risk and
- # frequency of updates.
+ "initialClusterVersion": "A String", # The initial Kubernetes version for this cluster. Valid versions are those
+ # found in validMasterVersions returned by getServerConfig. The version can
+ # be upgraded over time; such upgrades are reflected in
+ # currentMasterVersion and currentNodeVersion.
#
- # When a cluster is subscribed to a release channel, Google maintains
- # both the master version and the node version. Node auto-upgrade
- # defaults to true and cannot be disabled. Updates to version related
- # fields (e.g. current_master_version) return an error.
- "channel": "A String", # channel specifies which release channel the cluster is subscribed to.
- },
- "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.
- "maxPodsPerNode": "A String", # Constraint enforced on the max num of pods per node.
- },
- "network": "A String", # The name of the Google Compute Engine
- # [network](https://cloud.google.com/compute/docs/networks-and-firewalls#networks)
- # to which the cluster is connected. If left unspecified, the `default`
- # network will be used. On output this shows the network ID instead of the
- # name.
- "loggingService": "A String", # The logging service the cluster should use to write logs.
- # Currently available options:
+ # Users may specify either explicit versions offered by
+ # Kubernetes Engine or version aliases, which have the following behavior:
#
- # * `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.
- "instanceGroupUrls": [ # Deprecated. Use node_pools.instance_group_urls.
- "A String",
- ],
- "networkConfig": { # NetworkConfig reports the relative names of network & subnetwork. # Configuration for cluster networking.
- "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:
- # projects/my-project/regions/us-central1/subnetworks/my-subnet
- "network": "A String", # Output only. The relative name of the Google Compute Engine
- # 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.
- },
- "privateCluster": True or False, # If this is a private cluster setup. Private clusters are clusters that, by
- # default have no external IP addresses on the nodes and where nodes and the
- # master communicate over private IP addresses.
- # This field is deprecated, use private_cluster_config.enable_private_nodes
- # instead.
- "podSecurityPolicyConfig": { # Configuration for the PodSecurityPolicy feature. # Configuration for the PodSecurityPolicy feature.
- "enabled": True or False, # Enable the PodSecurityPolicy controller for this cluster. If enabled, pods
- # must be valid under a PodSecurityPolicy to be created.
- },
- "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.
- },
- "location": "A String", # [Output only] The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
- # or
- # [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
- # in which the cluster resides.
- "workloadIdentityConfig": { # Configuration for the use of Kubernetes Service Accounts in GCP IAM # Configuration for the use of Kubernetes Service Accounts in GCP IAM
- # policies.
- # policies.
- "workloadPool": "A String", # The workload pool to attach all Kubernetes service accounts to.
- "identityNamespace": "A String", # IAM Identity Namespace to attach all Kubernetes Service Accounts to.
- },
- "resourceUsageExportConfig": { # Configuration for exporting cluster resource usages. # Configuration for exporting resource usages. Resource usage export is
- # disabled when this config unspecified.
- "bigqueryDestination": { # Parameters for using BigQuery as the destination of resource usage export. # Configuration to use BigQuery as usage export destination.
- "datasetId": "A String", # The ID of a BigQuery Dataset.
- },
- "enableNetworkEgressMetering": True or False, # Whether to enable network egress metering for this cluster. If enabled, a
- # daemonset will be created in the cluster to meter network egress traffic.
- "consumptionMeteringConfig": { # Parameters for controlling consumption metering. # Configuration to enable resource consumption metering.
- "enabled": True or False, # Whether to enable consumption metering for this cluster. If enabled, a
- # second BigQuery table will be created to hold resource consumption
- # records.
- },
- },
- "privateClusterConfig": { # Configuration options for private clusters. # Configuration for private cluster.
- "enablePrivateEndpoint": True or False, # Whether the master's internal IP address is used as the cluster endpoint.
- "publicEndpoint": "A String", # Output only. The external IP address of this cluster's master endpoint.
- "masterGlobalAccessConfig": { # Configuration for controlling master global access settings. # Controls master global access settings.
- "enabled": True or False, # Whenever master is accessible globally or not.
- },
- "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.
- "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.
- "peeringName": "A String", # Output only. The peering name in the customer VPC used by this cluster.
- },
- "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
- },
- ],
- "statusMessage": "A String", # [Output only] Additional information about the current status of this
- # cluster, if available.
- "servicesIpv4Cidr": "A String", # [Output only] The IP address range of the Kubernetes services in
- # this cluster, in
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `1.2.3.4/29`). Service addresses are
- # typically put in the last `/16` from the container CIDR.
- "status": "A String", # [Output only] The current status of this cluster.
- "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the cluster. # Configuration for cluster IP allocation.
- "allowRouteOverlap": True or False, # If true, allow allocation of cluster CIDR ranges that overlap with certain
- # kinds of network routes. By default we do not allow cluster CIDR ranges to
- # intersect with any user declared routes. With allow_route_overlap == true,
- # we allow overlapping with CIDR ranges that are larger than the cluster CIDR
- # range.
- #
- # If this field is set to true, then cluster and services CIDRs must be
- # fully-specified (e.g. `10.96.0.0/14`, but not `/14`), which means:
- # 1) When `use_ip_aliases` is true, `cluster_ipv4_cidr_block` and
- # `services_ipv4_cidr_block` must be fully-specified.
- # 2) When `use_ip_aliases` is false, `cluster.cluster_ipv4_cidr` muse be
- # fully-specified.
- "useIpAliases": True or False, # Whether alias IPs will be used for pod IPs in the cluster.
- # This is used in conjunction with use_routes. It cannot
- # be true if use_routes is true. If both use_ip_aliases and use_routes are
- # false, then the server picks the default IP allocation mode
- "nodeIpv4Cidr": "A String", # This field is deprecated, use node_ipv4_cidr_block.
- "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.
- #
- # 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.
- "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 and
- # create_subnetwork is false.
- "servicesIpv4CidrBlock": "A String", # The IP address range of the services IPs in this cluster. If blank, a range
+ # - "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
+ "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the cluster. # Configuration for cluster IP allocation.
+ "useRoutes": True or False, # Whether routes will be used for pod IPs in the cluster.
+ # This is used in conjunction with use_ip_aliases. It cannot be true if
+ # use_ip_aliases is true. If both use_ip_aliases and use_routes are false,
+ # then the server picks the default IP allocation mode
+ "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.
@@ -3150,10 +3071,42 @@
# 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.
+ "allowRouteOverlap": True or False, # If true, allow allocation of cluster CIDR ranges that overlap with certain
+ # kinds of network routes. By default we do not allow cluster CIDR ranges to
+ # intersect with any user declared routes. With allow_route_overlap == true,
+ # we allow overlapping with CIDR ranges that are larger than the cluster CIDR
+ # range.
+ #
+ # If this field is set to true, then cluster and services CIDRs must be
+ # fully-specified (e.g. `10.96.0.0/14`, but not `/14`), which means:
+ # 1) When `use_ip_aliases` is true, `cluster_ipv4_cidr_block` and
+ # `services_ipv4_cidr_block` must be fully-specified.
+ # 2) When `use_ip_aliases` is false, `cluster.cluster_ipv4_cidr` muse be
+ # fully-specified.
+ "nodeIpv4Cidr": "A String", # This field is deprecated, use node_ipv4_cidr_block.
+ "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.
#
# This field is only applicable when `use_ip_aliases` is true.
- "nodeIpv4CidrBlock": "A String", # The IP address range of the instance IPs in this cluster.
+ #
+ # 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.
+ "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 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.
#
@@ -3167,7 +3120,7 @@
# 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.
- "tpuIpv4CidrBlock": "A String", # The IP address range of the Cloud TPUs in this cluster. If unspecified, a
+ "tpuIpv4CidrBlock": "A String", # The IP address range of the Cloud TPUs in this cluster. If unspecified, a
# range will be automatically chosen with the default size.
#
# This field is only applicable when `use_ip_aliases` is true.
@@ -3183,207 +3136,79 @@
# `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
# to use.
# This field is deprecated, use cluster.tpu_config.ipv4_cidr_block instead.
- "clusterIpv4Cidr": "A String", # This field is deprecated, use cluster_ipv4_cidr_block.
- "useRoutes": True or False, # Whether routes will be used for pod IPs in the cluster.
- # This is used in conjunction with use_ip_aliases. It cannot be true if
- # use_ip_aliases is true. If both use_ip_aliases and use_routes are false,
- # then the server picks the default IP allocation mode
- "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.
- "servicesSecondaryRangeName": "A String", # The name of the secondary range to be used as for the services
+ "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
# ClusterIPs. This must be an existing secondary range associated
# with the cluster subnetwork.
#
# This field is only applicable with use_ip_aliases and
# create_subnetwork is false.
- "servicesIpv4Cidr": "A String", # This field is deprecated, use services_ipv4_cidr_block.
+ "useIpAliases": True or False, # Whether alias IPs will be used for pod IPs in the cluster.
+ # This is used in conjunction with use_routes. It cannot
+ # be true if use_routes is true. If both use_ip_aliases and use_routes are
+ # false, then the server picks the default IP allocation mode
+ "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.
},
- "currentMasterVersion": "A String", # [Output only] The current software version of the master endpoint.
- "description": "A String", # An optional description of this cluster.
- "currentNodeVersion": "A String", # [Output only] Deprecated, use
- # [NodePool.version](https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters.nodePools)
- # instead. The current version of the node software components.
- # If they are currently at multiple versions because they're in the process
- # of being upgraded, this reflects the minimum version of all nodes.
- "binaryAuthorization": { # Configuration for Binary Authorization. # Configuration for Binary Authorization.
- "enabled": True or False, # Enable Binary Authorization for this cluster. If enabled, all container
- # images will be validated by Google Binauthz.
+ "legacyAbac": { # Configuration for the legacy Attribute Based Access Control authorization # Configuration for the legacy ABAC authorization mode.
+ # mode.
+ "enabled": True or False, # Whether the ABAC authorizer is enabled for this cluster. When enabled,
+ # identities in the system, including service accounts, nodes, and
+ # controllers, will have statically granted permissions beyond those
+ # provided by the RBAC configuration or IAM.
},
- "labelFingerprint": "A String", # The fingerprint of the set of labels for this cluster.
- "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.
- "autoprovisioningNodePoolDefaults": { # AutoprovisioningNodePoolDefaults contains defaults for a node pool created # AutoprovisioningNodePoolDefaults contains defaults for a node pool
- # created by NAP.
- # by NAP.
- "minCpuPlatform": "A String", # Minimum CPU platform to be used for NAP created node pools.
- # The instance may be scheduled on the specified or newer CPU platform.
- # Applicable values are the friendly names of CPU platforms, such as
- # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
- # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
- # information, read [how to specify min CPU
- # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
- # To unset the min cpu platform field pass "automatic" as field value.
- "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.
- },
- "autoRepair": True or False, # Whether the nodes will be automatically repaired.
- "autoUpgrade": True or False, # Whether the nodes will be automatically upgraded.
- },
- "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.
- "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.
- "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
- # of the node pool during the upgrade process.
- "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.
- },
+ "enableTpu": True or False, # Enable the ability to use Cloud TPUs in this cluster.
+ # This field is deprecated, use tpu_config.enabled instead.
+ "resourceUsageExportConfig": { # Configuration for exporting cluster resource usages. # Configuration for exporting resource usages. Resource usage export is
+ # disabled when this config unspecified.
+ "enableNetworkEgressMetering": True or False, # Whether to enable network egress metering for this cluster. If enabled, a
+ # daemonset will be created in the cluster to meter network egress traffic.
+ "consumptionMeteringConfig": { # Parameters for controlling consumption metering. # Configuration to enable resource consumption metering.
+ "enabled": True or False, # Whether to enable consumption metering for this cluster. If enabled, a
+ # second BigQuery table will be created to hold resource consumption
+ # records.
},
- "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.
- "resourceType": "A String", # Resource name "cpu", "memory" or gpu-specific string.
- "minimum": "A String", # Minimum amount of the resource in the cluster.
- "maximum": "A String", # Maximum amount of the resource in the cluster.
- },
- ],
- "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",
- ],
- "autoscalingProfile": "A String", # Defines autoscaling behaviour.
- "enableNodeAutoprovisioning": True or False, # Enables automatic node pool creation and deletion.
- },
- "masterAuth": { # The authentication information for accessing the master endpoint. # The authentication information for accessing the master endpoint.
- # If unspecified, the defaults are used:
- # For clusters before v1.12, if master_auth is unspecified, `username` will
- # be set to "admin", a random password will be generated, and a client
- # certificate will be issued.
- # Authentication can be done using HTTP basic auth or using client
- # certificates.
- "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).
- "clientKey": "A String", # [Output only] Base64-encoded private key used by clients to authenticate
- # to the cluster endpoint.
- "clientCertificate": "A String", # [Output only] Base64-encoded public certificate used by clients to
- # authenticate to the cluster endpoint.
- "clusterCaCertificate": "A 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
- # must be non-empty.
- "clientCertificateConfig": { # Configuration for client certificates on the cluster. # Configuration for client certificate authentication on the cluster. For
- # clusters before v1.12, if no configuration is specified, a client
- # certificate is issued.
- "issueClientCertificate": True or False, # Issue a client certificate.
+ "bigqueryDestination": { # Parameters for using BigQuery as the destination of resource usage export. # Configuration to use BigQuery as usage export destination.
+ "datasetId": "A String", # The ID of a BigQuery Dataset.
},
},
- "expireTime": "A String", # [Output only] The time the cluster will be automatically
- # deleted in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "masterIpv4CidrBlock": "A String", # The IP prefix in CIDR notation to use for the hosted master network.
- # This prefix will be used for assigning private IP addresses to the
- # master or set of masters, as well as the ILB VIP.
- # This field is deprecated, use
- # private_cluster_config.master_ipv4_cidr_block instead.
- "clusterTelemetry": { # Telemetry integration for the cluster. # Telemetry integration for the cluster.
- "type": "A String", # Type of the integration.
- },
- "tpuIpv4CidrBlock": "A String", # [Output only] The IP address range of the Cloud TPUs in this cluster, in
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `1.2.3.4/29`).
- "nodePools": [ # The node pools associated with this cluster.
- # This field should not be set if "node_config" or "initial_node_count" are
+ "locations": [ # The list of Google Compute Engine
+ # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
+ # cluster's nodes should be located.
+ "A String",
+ ],
+ "nodePools": [ # The node pools associated with this cluster.
+ # This field should not be set if "node_config" or "initial_node_count" are
# specified.
- { # NodePool contains the name and configuration for a cluster's node pool.
- # Node pools are a set of nodes (i.e. VM's), with a common configuration and
+ { # NodePool contains the name and configuration for a cluster's node pool.
+ # Node pools are a set of nodes (i.e. VM's), with a common configuration and
# specification, under the control of the cluster master. They may have a set
# 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.
- "status": "A String", # [Output only] The status of the nodes in this pool instance.
- "selfLink": "A String", # [Output only] Server-defined URL for the resource.
- "management": { # NodeManagement defines the set of node management services turned on for the # NodeManagement configuration for this NodePool.
- # 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.
- },
- "autoRepair": True or False, # Whether the nodes will be automatically repaired.
- "autoUpgrade": True or False, # Whether the nodes will be automatically upgraded.
- },
- "name": "A String", # The name of the node pool.
- "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
- },
- ],
- "autoscaling": { # NodePoolAutoscaling contains information required by cluster autoscaler to # Autoscaler configuration for this NodePool. Autoscaler is enabled
+ "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.
- "minNodeCount": 42, # Minimum number of nodes in the NodePool. Must be >= 1 and <=
+ "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.
- "maxNodeCount": 42, # Maximum number of nodes in the NodePool. Must be >= min_node_count. There
+ "autoprovisioned": True or False, # Can this node pool be deleted automatically.
+ "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.
},
- "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",
- ],
- "maxPodsConstraint": { # Constraints applied to pods. # The constraint on the maximum number of pods that can be run
- # simultaneously on a node in the node pool.
- "maxPodsPerNode": "A String", # Constraint enforced on the max num of pods per node.
- },
- "version": "A String", # The version of the Kubernetes of this node.
- "upgradeSettings": { # These upgrade settings control the level of parallelism and the level of # Upgrade settings control disruption and speed of the upgrade.
+ "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.
+ "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.
#
# maxUnavailable controls the number of nodes that can be simultaneously
@@ -3406,87 +3231,163 @@
# 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.
- "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
+ "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
# of the node pool during the upgrade process.
- "maxUnavailable": 42, # The maximum number of nodes that can be simultaneously unavailable during
+ "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.
},
- "initialNodeCount": 42, # The initial node count for the pool. You must ensure that your
- # Compute Engine <a href="/compute/docs/resource-quotas">resource quota</a>
- # is sufficient for this number of instances. You must also have available
- # firewall and routes quota.
- "podIpv4CidrSize": 42, # [Output only] The pod CIDR block size per node in this node pool.
- "instanceGroupUrls": [ # [Output only] The resource URLs of the [managed instance
+ "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+ "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.
- "A String",
+ "A String",
],
- "config": { # Parameters that describe the nodes in a cluster. # The node configuration of the pool.
- "reservationAffinity": { # [ReservationAffinity](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) # The optional reservation affinity. Setting this field will apply
- # the specified [Zonal Compute
- # Reservation](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources)
- # to this node pool.
- # is the configuration of desired reservation which instances could take
- # capacity from.
- "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.
+ "version": "A String", # The version of the Kubernetes of this node.
+ "podIpv4CidrSize": 42, # [Output only] The pod CIDR block size per node in this node pool.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
- "sandboxConfig": { # SandboxConfig contains configurations of the sandbox to use for the node. # Sandbox configuration for this node.
- "type": "A String", # Type of the sandbox to use for the node.
- "sandboxType": "A String", # Type of the sandbox to use for the node (e.g. 'gvisor')
+ ],
+ "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.
+ "diskSizeGb": 42, # Size of the disk attached to each node, specified in GB.
+ # The smallest allowed disk size is 10GB.
+ #
+ # If unspecified, the default disk size is 100GB.
+ "workloadMetadataConfig": { # WorkloadMetadataConfig defines the metadata configuration to expose to # The workload metadata configuration for this node.
+ # workloads on the node pool.
+ "nodeMetadata": "A String", # NodeMetadata is the configuration for how to expose metadata to the
+ # workloads running on the node.
+ "mode": "A String", # Mode is the configuration for how to expose metadata to workloads running
+ # on the node pool.
},
- "machineType": "A String", # The name of a Google Compute Engine [machine
+ "accelerators": [ # A list of hardware accelerators to be attached to each node.
+ # See https://cloud.google.com/compute/docs/gpus for more information about
+ # support for GPUs.
+ { # AcceleratorConfig represents a Hardware Accelerator request.
+ "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
+ "acceleratorType": "A String", # The accelerator type resource name. List of supported accelerators
+ # [here](https://cloud.google.com/compute/docs/gpus)
+ },
+ ],
+ "machineType": "A String", # The name of a Google Compute Engine [machine
# type](https://cloud.google.com/compute/docs/machine-types) (e.g.
# `n1-standard-1`).
#
# If unspecified, the default machine type is
# `n1-standard-1`.
- "shieldedInstanceConfig": { # A set of Shielded Instance options. # Shielded Instance options.
- "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.
+ "diskType": "A String", # Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
+ #
+ # If unspecified, the default disk type is 'pd-standard'
+ "bootDiskKmsKey": "A String", #
+ # The Customer Managed Encryption Key used to encrypt the boot disk attached
+ # to each node in the node pool. This should be of the form
+ # projects/[KEY_PROJECT_ID]/locations/[LOCATION]/keyRings/[RING_NAME]/cryptoKeys/[KEY_NAME].
+ # For more information about protecting resources with Cloud KMS Keys please
+ # see:
+ # https://cloud.google.com/compute/docs/disks/customer-managed-encryption
+ "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.
},
- "diskType": "A String", # Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
+ "minCpuPlatform": "A String", # Minimum CPU platform to be used by this instance. The instance may be
+ # scheduled on the specified or newer CPU platform. Applicable values are the
+ # friendly names of CPU platforms, such as
+ # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
+ # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
+ # information, read [how to specify min CPU
+ # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
+ "preemptible": True or False, # Whether the nodes are created as preemptible VM instances. See:
+ # https://cloud.google.com/compute/docs/instances/preemptible for more
+ # inforamtion about preemptible VM instances.
+ "localSsdCount": 42, # The number of local SSD disks to be attached to the node.
#
- # If unspecified, the default disk type is 'pd-standard'
- "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
+ # The limit for this value is dependent upon the maximum number of
+ # disks available on a machine per zone. See:
+ # https://cloud.google.com/compute/docs/disks/local-ssd
+ # for more information.
+ "sandboxConfig": { # SandboxConfig contains configurations of the sandbox to use for the node. # Sandbox configuration for this node.
+ "type": "A String", # Type of the sandbox to use for the node.
+ "sandboxType": "A String", # Type of the sandbox to use for the node (e.g. 'gvisor')
+ },
+ "metadata": { # The metadata key/value pairs assigned to instances in the cluster.
+ #
+ # Keys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes
+ # in length. These are reflected as part of a URL in the metadata server.
+ # Additionally, to avoid ambiguity, keys must not conflict with any other
+ # metadata keys for the project or be one of the reserved keys:
+ # "cluster-location"
+ # "cluster-name"
+ # "cluster-uid"
+ # "configure-sh"
+ # "containerd-configure-sh"
+ # "enable-oslogin"
+ # "gci-ensure-gke-docker"
+ # "gci-metrics-enabled"
+ # "gci-update-strategy"
+ # "instance-template"
+ # "kube-env"
+ # "startup-script"
+ # "user-data"
+ # "disable-address-manager"
+ # "windows-startup-script-ps1"
+ # "common-psm1"
+ # "k8s-node-setup-psm1"
+ # "install-ssh-psm1"
+ # "user-profile-psm1"
+ # "serial-port-logging-enable"
+ # Values are free-form strings, and only have meaning as interpreted by
+ # the image running in the instance. The only restriction placed on them is
+ # that each value's size must be less than or equal to 32 KB.
+ #
+ # The total size of all keys and values must be less than 512 KB.
+ "a_key": "A String",
+ },
+ "reservationAffinity": { # [ReservationAffinity](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) # The optional reservation affinity. Setting this field will apply
+ # the specified [Zonal Compute
+ # Reservation](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources)
+ # 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.
+ },
+ "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",
+ "A String",
],
- "preemptible": True or False, # Whether the nodes are created as preemptible VM instances. See:
- # https://cloud.google.com/compute/docs/instances/preemptible for more
- # inforamtion about preemptible VM instances.
- "labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
- # These will added in addition to any default label(s) that
- # Kubernetes may apply to the node.
- # In case of conflict in label keys, the applied set may differ depending on
- # the Kubernetes version -- it's best to assume the behavior is undefined
- # and conflicts should be avoided.
- # For more information, including usage and the valid values, see:
- # https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
- "a_key": "A String",
- },
- "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
+ "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.
- "oauthScopes": [ # The set of Google API scopes to be made available on all of the
- # node VMs under the "default" service account.
+ # 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.
#
# The following scopes are recommended, but not required, and by default are
# not included:
@@ -3500,106 +3401,100 @@
#
# If unspecified, no scopes are added, unless Cloud Logging or Cloud
# Monitoring are enabled, in which case their required scopes will be added.
- "A String",
+ "A String",
],
- "taints": [ # List of kubernetes taints to be applied to each node.
+ "taints": [ # List of kubernetes taints to be applied to each node.
#
# For more information, including usage and the valid values, see:
# https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
{ # Kubernetes taint is comprised of three fields: key, value, and effect. Effect
# can only be one of three types: NoSchedule, PreferNoSchedule or NoExecute.
#
- # For more information, including usage and the valid values, see:
- # https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
- "value": "A String", # Value for taint.
- "key": "A String", # Key for taint.
- "effect": "A String", # Effect for taint.
+ # 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.
},
],
- "workloadMetadataConfig": { # WorkloadMetadataConfig defines the metadata configuration to expose to # The workload metadata configuration for this node.
- # workloads on the node pool.
- "mode": "A String", # Mode is the configuration for how to expose metadata to workloads running
- # on the node pool.
- "nodeMetadata": "A String", # NodeMetadata is the configuration for how to expose metadata to the
- # workloads running on the node.
- },
- "diskSizeGb": 42, # Size of the disk attached to each node, specified in GB.
- # The smallest allowed disk size is 10GB.
- #
- # If unspecified, the default disk size is 100GB.
- "accelerators": [ # A list of hardware accelerators to be attached to each node.
- # See https://cloud.google.com/compute/docs/gpus for more information about
- # support for GPUs.
- { # AcceleratorConfig represents a Hardware Accelerator request.
- "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
- "acceleratorType": "A String", # The accelerator type resource name. List of supported accelerators
- # [here](https://cloud.google.com/compute/docs/gpus)
- },
- ],
- "minCpuPlatform": "A String", # Minimum CPU platform to be used by this instance. The instance may be
- # scheduled on the specified or newer CPU platform. Applicable values are the
- # friendly names of CPU platforms, such as
- # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
- # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
- # information, read [how to specify min CPU
- # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
- "bootDiskKmsKey": "A String", #
- # The Customer Managed Encryption Key used to encrypt the boot disk attached
- # to each node in the node pool. This should be of the form
- # projects/[KEY_PROJECT_ID]/locations/[LOCATION]/keyRings/[RING_NAME]/cryptoKeys/[KEY_NAME].
- # For more information about protecting resources with Cloud KMS Keys please
- # see:
- # https://cloud.google.com/compute/docs/disks/customer-managed-encryption
- "localSsdCount": 42, # The number of local SSD disks to be attached to the node.
- #
- # The limit for this value is dependent upon the maximum number of
- # disks available on a machine per zone. See:
- # https://cloud.google.com/compute/docs/disks/local-ssd
- # for more information.
- "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.
- "metadata": { # The metadata key/value pairs assigned to instances in the cluster.
- #
- # Keys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes
- # in length. These are reflected as part of a URL in the metadata server.
- # Additionally, to avoid ambiguity, keys must not conflict with any other
- # metadata keys for the project or be one of the reserved keys:
- # "cluster-location"
- # "cluster-name"
- # "cluster-uid"
- # "configure-sh"
- # "containerd-configure-sh"
- # "enable-oslogin"
- # "gci-ensure-gke-docker"
- # "gci-metrics-enabled"
- # "gci-update-strategy"
- # "instance-template"
- # "kube-env"
- # "startup-script"
- # "user-data"
- # "disable-address-manager"
- # "windows-startup-script-ps1"
- # "common-psm1"
- # "k8s-node-setup-psm1"
- # "install-ssh-psm1"
- # "user-profile-psm1"
- # "serial-port-logging-enable"
- # Values are free-form strings, and only have meaning as interpreted by
- # the image running in the instance. The only restriction placed on them is
- # that each value's size must be less than or equal to 32 KB.
- #
- # The total size of all keys and values must be less than 512 KB.
- "a_key": "A String",
+ "labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
+ # These will added in addition to any default label(s) that
+ # Kubernetes may apply to the node.
+ # In case of conflict in label keys, the applied set may differ depending on
+ # the Kubernetes version -- it's best to assume the behavior is undefined
+ # and conflicts should be avoided.
+ # For more information, including usage and the valid values, see:
+ # https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
+ "a_key": "A String",
},
},
- "statusMessage": "A String", # [Output only] Additional information about the current status of this
- # node pool instance, if available.
+ "name": "A String", # The name of the node pool.
+ "maxPodsConstraint": { # Constraints applied to pods. # The constraint on the maximum number of pods that can be run
+ # simultaneously on a node in the node pool.
+ "maxPodsPerNode": "A String", # Constraint enforced on the max num of pods per node.
+ },
+ "management": { # NodeManagement defines the set of node management services turned on for the # NodeManagement configuration for this NodePool.
+ # node pool.
+ "autoUpgrade": True or False, # Whether the nodes will be automatically upgraded.
+ "autoRepair": True or False, # Whether the nodes will be automatically repaired.
+ "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.
+ },
+ },
},
],
- "monitoringService": "A String", # The monitoring service the cluster should use to write metrics.
+ "selfLink": "A String", # [Output only] Server-defined URL for the resource.
+ "servicesIpv4Cidr": "A String", # [Output only] The IP address range of the Kubernetes services in
+ # this cluster, in
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `1.2.3.4/29`). Service addresses are
+ # typically put in the last `/16` from the container CIDR.
+ "networkPolicy": { # Configuration options for the NetworkPolicy feature. # Configuration options for the NetworkPolicy feature.
+ # https://kubernetes.io/docs/concepts/services-networking/networkpolicies/
+ "enabled": True or False, # Whether network policy is enabled on the cluster.
+ "provider": "A String", # The selected network policy provider.
+ },
+ "releaseChannel": { # ReleaseChannel indicates which release channel a cluster is # Release channel configuration.
+ # subscribed to. Release channels are arranged in order of risk and
+ # frequency of updates.
+ #
+ # When a cluster is subscribed to a release channel, Google maintains
+ # both the master version and the node version. Node auto-upgrade
+ # defaults to true and cannot be disabled. Updates to version related
+ # fields (e.g. current_master_version) return an error.
+ "channel": "A String", # channel specifies which release channel the cluster is subscribed to.
+ },
+ "enableKubernetesAlpha": True or False, # Kubernetes alpha features are enabled on this cluster. This includes alpha
+ # API groups (e.g. v1beta1) and features that may not be production ready in
+ # the kubernetes version of the master and nodes.
+ # The cluster has no SLA for uptime and master/node upgrades are disabled.
+ # Alpha enabled clusters are automatically deleted thirty days after
+ # creation.
+ "description": "A String", # An optional description of this cluster.
+ "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).
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
+ },
+ ],
+ "privateCluster": True or False, # If this is a private cluster setup. Private clusters are clusters that, by
+ # default have no external IP addresses on the nodes and where nodes and the
+ # master communicate over private IP addresses.
+ # This field is deprecated, use private_cluster_config.enable_private_nodes
+ # instead.
+ "currentNodeCount": 42, # [Output only] The number of nodes currently in the cluster. Deprecated.
+ # Call Kubernetes API directly to retrieve node information.
+ "monitoringService": "A String", # The monitoring service the cluster should use to write metrics.
# Currently available options:
#
- # * "monitoring.googleapis.com/kubernetes" - The Cloud Monitoring
+ # * "monitoring.googleapis.com/kubernetes" - The Cloud Monitoring
# service with a Kubernetes-native resource model
# * `monitoring.googleapis.com` - The legacy Cloud Monitoring service (no
# longer available as of GKE 1.15).
@@ -3607,65 +3502,44 @@
#
# If left as an empty string,`monitoring.googleapis.com/kubernetes` will be
# used for GKE 1.14+ or `monitoring.googleapis.com` for earlier versions.
- "createTime": "A String", # [Output only] The time the cluster was created, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "databaseEncryption": { # Configuration of etcd encryption. # Configuration of etcd encryption.
- "state": "A String", # Denotes the state of etcd encryption.
- "keyName": "A String", # Name of CloudKMS key to use for the encryption of secrets in etcd.
+ "databaseEncryption": { # Configuration of etcd encryption. # Configuration of etcd encryption.
+ "state": "A String", # Denotes the state of etcd encryption.
+ "keyName": "A String", # Name of CloudKMS key to use for the encryption of secrets in etcd.
# Ex. projects/my-project/locations/global/keyRings/my-ring/cryptoKeys/my-key
},
- "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
- # the following restrictions:
- #
- # * Lowercase letters, numbers, and hyphens only.
- # * Must start with a letter.
- # * Must end with a number or a letter.
- "legacyAbac": { # Configuration for the legacy Attribute Based Access Control authorization # Configuration for the legacy ABAC authorization mode.
- # mode.
- "enabled": True or False, # Whether the ABAC authorizer is enabled for this cluster. When enabled,
- # identities in the system, including service accounts, nodes, and
- # controllers, will have statically granted permissions beyond those
- # provided by the RBAC configuration or IAM.
+ "binaryAuthorization": { # Configuration for Binary Authorization. # Configuration for Binary Authorization.
+ "enabled": True or False, # Enable Binary Authorization for this cluster. If enabled, all container
+ # images will be validated by Google Binauthz.
},
- "endpoint": "A String", # [Output only] The IP address of this cluster's master endpoint.
- # The endpoint can be accessed from the internet at
- # `https://username:password@endpoint/`.
- #
- # See the `masterAuth` property of this resource for username and
- # password information.
- "currentNodeCount": 42, # [Output only] The number of nodes currently in the cluster. Deprecated.
- # Call Kubernetes API directly to retrieve node information.
- "zone": "A String", # [Output only] The name of the Google Compute Engine
+ "tpuIpv4CidrBlock": "A String", # [Output only] The IP address range of the Cloud TPUs in this cluster, in
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `1.2.3.4/29`).
+ "workloadIdentityConfig": { # Configuration for the use of Kubernetes Service Accounts in GCP IAM # Configuration for the use of Kubernetes Service Accounts in GCP IAM
+ # policies.
+ # policies.
+ "identityNamespace": "A String", # IAM Identity Namespace to attach all Kubernetes Service Accounts to.
+ "workloadPool": "A String", # The workload pool to attach all Kubernetes service accounts to.
+ },
+ "zone": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/zones#available) in which the
# cluster resides. This field is deprecated, use location instead.
- "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.
- },
- "tpuConfig": { # Configuration for Cloud TPU. # Configuration for Cloud TPU support;
- "useServiceNetworking": True or False, # Whether to use service networking for Cloud TPU or not.
- "ipv4CidrBlock": "A String", # IPv4 CIDR block reserved for Cloud TPU in the VPC.
- "enabled": True or False, # Whether Cloud TPU integration is enabled or not.
- },
- "initialClusterVersion": "A String", # The initial Kubernetes version for this cluster. Valid versions are those
- # found in validMasterVersions returned by getServerConfig. The version can
- # be upgraded over time; such upgrades are reflected in
- # currentMasterVersion and currentNodeVersion.
+ "loggingService": "A String", # The logging service the cluster should use to write logs.
+ # Currently available options:
#
- # Users may specify either explicit versions offered by
- # Kubernetes Engine or version aliases, which have the following behavior:
+ # * `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.
#
- # - "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
- "nodeConfig": { # Parameters that describe the nodes in a cluster. # Parameters used in creating the cluster's nodes.
+ # If left as an empty string,`logging.googleapis.com/kubernetes` will be
+ # used for GKE 1.14+ or `logging.googleapis.com` for earlier versions.
+ "expireTime": "A String", # [Output only] The time the cluster will be automatically
+ # deleted in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "nodeConfig": { # Parameters that describe the nodes in a cluster. # Parameters used in creating the cluster's nodes.
# For requests, this field should only be used in lieu of a
- # "node_pool" object, since this configuration (along with the
- # "initial_node_count") will be used to create a "NodePool" object with an
+ # "node_pool" object, since this configuration (along with the
+ # "initial_node_count") will be used to create a "NodePool" object with an
# auto-generated name. Do not use this and a node_pool at the same time.
# For responses, this field will be populated with the node configuration of
# the first node pool. (For configuration of each node pool, see
@@ -3673,70 +3547,135 @@
#
# If unspecified, the defaults are used.
# This field is deprecated, use node_pool.config instead.
- "reservationAffinity": { # [ReservationAffinity](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) # The optional reservation affinity. Setting this field will apply
- # the specified [Zonal Compute
- # Reservation](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources)
- # to this node pool.
- # is the configuration of desired reservation which instances could take
- # capacity from.
- "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.
+ "diskSizeGb": 42, # Size of the disk attached to each node, specified in GB.
+ # The smallest allowed disk size is 10GB.
+ #
+ # If unspecified, the default disk size is 100GB.
+ "workloadMetadataConfig": { # WorkloadMetadataConfig defines the metadata configuration to expose to # The workload metadata configuration for this node.
+ # workloads on the node pool.
+ "nodeMetadata": "A String", # NodeMetadata is the configuration for how to expose metadata to the
+ # workloads running on the node.
+ "mode": "A String", # Mode is the configuration for how to expose metadata to workloads running
+ # on the node pool.
},
- "sandboxConfig": { # SandboxConfig contains configurations of the sandbox to use for the node. # Sandbox configuration for this node.
- "type": "A String", # Type of the sandbox to use for the node.
- "sandboxType": "A String", # Type of the sandbox to use for the node (e.g. 'gvisor')
- },
- "machineType": "A String", # The name of a Google Compute Engine [machine
+ "accelerators": [ # A list of hardware accelerators to be attached to each node.
+ # See https://cloud.google.com/compute/docs/gpus for more information about
+ # support for GPUs.
+ { # AcceleratorConfig represents a Hardware Accelerator request.
+ "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
+ "acceleratorType": "A String", # The accelerator type resource name. List of supported accelerators
+ # [here](https://cloud.google.com/compute/docs/gpus)
+ },
+ ],
+ "machineType": "A String", # The name of a Google Compute Engine [machine
# type](https://cloud.google.com/compute/docs/machine-types) (e.g.
# `n1-standard-1`).
#
# If unspecified, the default machine type is
# `n1-standard-1`.
- "shieldedInstanceConfig": { # A set of Shielded Instance options. # Shielded Instance options.
- "enableIntegrityMonitoring": True or False, # Defines whether the instance has integrity monitoring enabled.
+ "diskType": "A String", # Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
+ #
+ # If unspecified, the default disk type is 'pd-standard'
+ "bootDiskKmsKey": "A String", #
+ # The Customer Managed Encryption Key used to encrypt the boot disk attached
+ # to each node in the node pool. This should be of the form
+ # projects/[KEY_PROJECT_ID]/locations/[LOCATION]/keyRings/[RING_NAME]/cryptoKeys/[KEY_NAME].
+ # For more information about protecting resources with Cloud KMS Keys please
+ # see:
+ # https://cloud.google.com/compute/docs/disks/customer-managed-encryption
+ "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.
},
- "diskType": "A String", # Type of the disk attached to each node (e.g. 'pd-standard' or 'pd-ssd')
+ "minCpuPlatform": "A String", # Minimum CPU platform to be used by this instance. The instance may be
+ # scheduled on the specified or newer CPU platform. Applicable values are the
+ # friendly names of CPU platforms, such as
+ # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
+ # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
+ # information, read [how to specify min CPU
+ # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
+ "preemptible": True or False, # Whether the nodes are created as preemptible VM instances. See:
+ # https://cloud.google.com/compute/docs/instances/preemptible for more
+ # inforamtion about preemptible VM instances.
+ "localSsdCount": 42, # The number of local SSD disks to be attached to the node.
#
- # If unspecified, the default disk type is 'pd-standard'
- "tags": [ # The list of instance tags applied to all nodes. Tags are used to identify
+ # The limit for this value is dependent upon the maximum number of
+ # disks available on a machine per zone. See:
+ # https://cloud.google.com/compute/docs/disks/local-ssd
+ # for more information.
+ "sandboxConfig": { # SandboxConfig contains configurations of the sandbox to use for the node. # Sandbox configuration for this node.
+ "type": "A String", # Type of the sandbox to use for the node.
+ "sandboxType": "A String", # Type of the sandbox to use for the node (e.g. 'gvisor')
+ },
+ "metadata": { # The metadata key/value pairs assigned to instances in the cluster.
+ #
+ # Keys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes
+ # in length. These are reflected as part of a URL in the metadata server.
+ # Additionally, to avoid ambiguity, keys must not conflict with any other
+ # metadata keys for the project or be one of the reserved keys:
+ # "cluster-location"
+ # "cluster-name"
+ # "cluster-uid"
+ # "configure-sh"
+ # "containerd-configure-sh"
+ # "enable-oslogin"
+ # "gci-ensure-gke-docker"
+ # "gci-metrics-enabled"
+ # "gci-update-strategy"
+ # "instance-template"
+ # "kube-env"
+ # "startup-script"
+ # "user-data"
+ # "disable-address-manager"
+ # "windows-startup-script-ps1"
+ # "common-psm1"
+ # "k8s-node-setup-psm1"
+ # "install-ssh-psm1"
+ # "user-profile-psm1"
+ # "serial-port-logging-enable"
+ # Values are free-form strings, and only have meaning as interpreted by
+ # the image running in the instance. The only restriction placed on them is
+ # that each value's size must be less than or equal to 32 KB.
+ #
+ # The total size of all keys and values must be less than 512 KB.
+ "a_key": "A String",
+ },
+ "reservationAffinity": { # [ReservationAffinity](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) # The optional reservation affinity. Setting this field will apply
+ # the specified [Zonal Compute
+ # Reservation](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources)
+ # 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.
+ },
+ "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",
+ "A String",
],
- "preemptible": True or False, # Whether the nodes are created as preemptible VM instances. See:
- # https://cloud.google.com/compute/docs/instances/preemptible for more
- # inforamtion about preemptible VM instances.
- "labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
- # These will added in addition to any default label(s) that
- # Kubernetes may apply to the node.
- # In case of conflict in label keys, the applied set may differ depending on
- # the Kubernetes version -- it's best to assume the behavior is undefined
- # and conflicts should be avoided.
- # For more information, including usage and the valid values, see:
- # https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
- "a_key": "A String",
- },
- "serviceAccount": "A String", # The Google Cloud Platform Service Account to be used by the node VMs.
+ "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.
- "oauthScopes": [ # The set of Google API scopes to be made available on all of the
- # node VMs under the "default" service account.
+ # 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.
#
# The following scopes are recommended, but not required, and by default are
# not included:
@@ -3750,132 +3689,199 @@
#
# If unspecified, no scopes are added, unless Cloud Logging or Cloud
# Monitoring are enabled, in which case their required scopes will be added.
- "A String",
+ "A String",
],
- "taints": [ # List of kubernetes taints to be applied to each node.
+ "taints": [ # List of kubernetes taints to be applied to each node.
#
# For more information, including usage and the valid values, see:
# https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
{ # Kubernetes taint is comprised of three fields: key, value, and effect. Effect
# can only be one of three types: NoSchedule, PreferNoSchedule or NoExecute.
#
- # For more information, including usage and the valid values, see:
- # https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
- "value": "A String", # Value for taint.
- "key": "A String", # Key for taint.
- "effect": "A String", # Effect for taint.
+ # 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.
},
],
- "workloadMetadataConfig": { # WorkloadMetadataConfig defines the metadata configuration to expose to # The workload metadata configuration for this node.
- # workloads on the node pool.
- "mode": "A String", # Mode is the configuration for how to expose metadata to workloads running
- # on the node pool.
- "nodeMetadata": "A String", # NodeMetadata is the configuration for how to expose metadata to the
- # workloads running on the node.
- },
- "diskSizeGb": 42, # Size of the disk attached to each node, specified in GB.
- # The smallest allowed disk size is 10GB.
- #
- # If unspecified, the default disk size is 100GB.
- "accelerators": [ # A list of hardware accelerators to be attached to each node.
- # See https://cloud.google.com/compute/docs/gpus for more information about
- # support for GPUs.
- { # AcceleratorConfig represents a Hardware Accelerator request.
- "acceleratorCount": "A String", # The number of the accelerator cards exposed to an instance.
- "acceleratorType": "A String", # The accelerator type resource name. List of supported accelerators
- # [here](https://cloud.google.com/compute/docs/gpus)
- },
- ],
- "minCpuPlatform": "A String", # Minimum CPU platform to be used by this instance. The instance may be
- # scheduled on the specified or newer CPU platform. Applicable values are the
- # friendly names of CPU platforms, such as
- # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
- # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
- # information, read [how to specify min CPU
- # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
- "bootDiskKmsKey": "A String", #
- # The Customer Managed Encryption Key used to encrypt the boot disk attached
- # to each node in the node pool. This should be of the form
- # projects/[KEY_PROJECT_ID]/locations/[LOCATION]/keyRings/[RING_NAME]/cryptoKeys/[KEY_NAME].
- # For more information about protecting resources with Cloud KMS Keys please
- # see:
- # https://cloud.google.com/compute/docs/disks/customer-managed-encryption
- "localSsdCount": 42, # The number of local SSD disks to be attached to the node.
- #
- # The limit for this value is dependent upon the maximum number of
- # disks available on a machine per zone. See:
- # https://cloud.google.com/compute/docs/disks/local-ssd
- # for more information.
- "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.
- "metadata": { # The metadata key/value pairs assigned to instances in the cluster.
- #
- # Keys must conform to the regexp [a-zA-Z0-9-_]+ and be less than 128 bytes
- # in length. These are reflected as part of a URL in the metadata server.
- # Additionally, to avoid ambiguity, keys must not conflict with any other
- # metadata keys for the project or be one of the reserved keys:
- # "cluster-location"
- # "cluster-name"
- # "cluster-uid"
- # "configure-sh"
- # "containerd-configure-sh"
- # "enable-oslogin"
- # "gci-ensure-gke-docker"
- # "gci-metrics-enabled"
- # "gci-update-strategy"
- # "instance-template"
- # "kube-env"
- # "startup-script"
- # "user-data"
- # "disable-address-manager"
- # "windows-startup-script-ps1"
- # "common-psm1"
- # "k8s-node-setup-psm1"
- # "install-ssh-psm1"
- # "user-profile-psm1"
- # "serial-port-logging-enable"
- # Values are free-form strings, and only have meaning as interpreted by
- # the image running in the instance. The only restriction placed on them is
- # that each value's size must be less than or equal to 32 KB.
- #
- # The total size of all keys and values must be less than 512 KB.
- "a_key": "A String",
+ "labels": { # The map of Kubernetes labels (key/value pairs) to be applied to each node.
+ # These will added in addition to any default label(s) that
+ # Kubernetes may apply to the node.
+ # In case of conflict in label keys, the applied set may differ depending on
+ # the Kubernetes version -- it's best to assume the behavior is undefined
+ # and conflicts should be avoided.
+ # For more information, including usage and the valid values, see:
+ # https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
+ "a_key": "A String",
},
},
- "clusterIpv4Cidr": "A String", # The IP address range of the container pods in this cluster, in
+ "status": "A String", # [Output only] The current status of this cluster.
+ "tpuConfig": { # Configuration for Cloud TPU. # Configuration for Cloud TPU support;
+ "enabled": True or False, # Whether Cloud TPU integration is enabled or not.
+ "ipv4CidrBlock": "A String", # IPv4 CIDR block reserved for Cloud TPU in the VPC.
+ "useServiceNetworking": True or False, # Whether to use service networking for Cloud TPU or not.
+ },
+ "networkConfig": { # NetworkConfig reports the relative names of network & subnetwork. # Configuration for cluster networking.
+ "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:
+ # projects/my-project/regions/us-central1/subnetworks/my-subnet
+ "network": "A String", # Output only. The relative name of the Google Compute Engine
+ # 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
+ # the following restrictions:
+ #
+ # * Lowercase letters, numbers, and hyphens only.
+ # * Must start with a letter.
+ # * Must end with a number or a letter.
+ "endpoint": "A String", # [Output only] The IP address of this cluster's master endpoint.
+ # The endpoint can be accessed from the internet at
+ # `https://username:password@endpoint/`.
+ #
+ # See the `masterAuth` property of this resource for username and
+ # password information.
+ "location": "A String", # [Output only] The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
+ # 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`.
- "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
- # during authentication using a group of security groups.
- "securityGroup": "A String", # The name of the security group-of-groups to be used. Only relevant
- # if enabled = true.
+ "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.
+ "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.
+ },
+ ],
+ "autoscalingProfile": "A String", # Defines autoscaling behaviour.
+ "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.
+ "autoUpgrade": True or False, # Whether the nodes will be automatically upgraded.
+ "autoRepair": True or False, # Whether the nodes will be automatically repaired.
+ "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.
+ },
+ },
+ "minCpuPlatform": "A String", # Minimum CPU platform to be used for NAP created node pools.
+ # The instance may be scheduled on the specified or newer CPU platform.
+ # Applicable values are the friendly names of CPU platforms, such as
+ # <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
+ # <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
+ # information, read [how to specify min CPU
+ # platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
+ # To unset the min cpu platform field pass "automatic" as field value.
+ "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.
+ "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
+ # of the node pool during the upgrade process.
+ "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.
+ },
+ "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.
+ },
+ "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",
+ ],
},
- "subnetwork": "A String", # The name of the Google Compute Engine
- # [subnetwork](https://cloud.google.com/compute/docs/subnetworks) to which
- # the cluster is connected. On output this shows the subnetwork ID instead of
- # the name.
- "resourceLabels": { # The resource labels for the cluster to use to annotate any related
- # Google Compute Engine resources.
- "a_key": "A String",
- },
- "selfLink": "A String", # [Output only] Server-defined URL for the resource.
- "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>
+ "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
+ # "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.
+ "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.
+ "masterGlobalAccessConfig": { # Configuration for controlling master global access settings. # Controls master global access settings.
+ "enabled": True or False, # Whenever master is accessible globally or not.
+ },
+ "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.
+ },
+ "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
+ "missingZones": [ # If any zones are listed here, the list of clusters returned
# may be missing those zones.
- "A String",
+ "A String",
],
}</pre>
</div>
@@ -3901,26 +3907,26 @@
The object takes the form of:
{ # SetLocationsRequest sets the locations of the cluster.
- "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
+ "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
# number](https://support.google.com/cloud/answer/6158840).
# This field has been deprecated and replaced by the name field.
- "clusterId": "A String", # Required. 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", # Required. Deprecated. The name of the Google Compute Engine
+ "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/zones#available) in which the
# cluster resides. This field has been deprecated and replaced by the name
# field.
- "locations": [ # Required. The desired list of Google Compute Engine
+ "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
+ # cluster's nodes should be located. Changing the locations a cluster is in
# will result in nodes being either created or removed from the cluster,
# depending on whether locations are being added or removed.
#
- # This list must always include the cluster's primary zone.
- "A String",
+ # This list must always include the cluster's primary zone.
+ "A String",
],
+ "clusterId": "A String", # Required. 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/*`.
}
x__xgafv: string, V1 error format.
@@ -3933,61 +3939,61 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
- "status": "A String", # The current status of the operation.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "endTime": "A String", # [Output only] The time the operation completed, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "name": "A String", # The server-assigned ID for the operation.
- "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.
- "clusterConditions": [ # Which conditions caused the current cluster state.
+ "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
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
],
- "startTime": "A String", # [Output only] The time the operation started, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
- "operationType": "A String", # The operation type.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "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.).
- "intValue": "A String", # For metrics with integer value.
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- },
- ],
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "selfLink": "A String", # Server-defined URL for the resource.
- "location": "A String", # [Output only] The name of the Google Compute Engine
+ "location": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "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.
+ "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.
+ "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.).
+ },
+ ],
+ "name": "A String", # A non-parameterized string describing 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.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "detail": "A String", # Detailed operation progress, if available.
+ "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.
}</pre>
</div>
@@ -4009,10 +4015,7 @@
The object takes the form of:
{ # SetLoggingServiceRequest sets the logging service of a cluster.
- "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
- # number](https://support.google.com/cloud/answer/6158840).
- # This field has been deprecated and replaced by the name field.
- "loggingService": "A String", # Required. The logging service the cluster should use to write logs.
+ "loggingService": "A String", # Required. The logging service the cluster should use to write logs.
# Currently available options:
#
# * `logging.googleapis.com/kubernetes` - The Cloud Logging
@@ -4023,14 +4026,17 @@
#
# If left as an empty string,`logging.googleapis.com/kubernetes` will be
# used for GKE 1.14+ or `logging.googleapis.com` for earlier versions.
- "clusterId": "A String", # Required. Deprecated. The name of the cluster to upgrade.
+ "name": "A String", # The name (project, location, cluster) of the cluster to set logging.
+ # Specified in the format `projects/*/locations/*/clusters/*`.
+ "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
+ # number](https://support.google.com/cloud/answer/6158840).
# This field has been deprecated and replaced by the name field.
- "name": "A String", # The name (project, location, cluster) of the cluster to set logging.
- # Specified in the format 'projects/*/locations/*/clusters/*'.
- "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
+ "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/zones#available) in which the
# cluster resides. This field has been deprecated and replaced by the name
# field.
+ "clusterId": "A String", # Required. 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.
@@ -4043,61 +4049,61 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
- "status": "A String", # The current status of the operation.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "endTime": "A String", # [Output only] The time the operation completed, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "name": "A String", # The server-assigned ID for the operation.
- "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.
- "clusterConditions": [ # Which conditions caused the current cluster state.
+ "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
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
],
- "startTime": "A String", # [Output only] The time the operation started, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
- "operationType": "A String", # The operation type.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "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.).
- "intValue": "A String", # For metrics with integer value.
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- },
- ],
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "selfLink": "A String", # Server-defined URL for the resource.
- "location": "A String", # [Output only] The name of the Google Compute Engine
+ "location": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "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.
+ "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.
+ "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.).
+ },
+ ],
+ "name": "A String", # A non-parameterized string describing 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.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "detail": "A String", # Detailed operation progress, if available.
+ "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.
}</pre>
</div>
@@ -4119,27 +4125,27 @@
The object takes the form of:
{ # UpdateMasterRequest updates the master of the cluster.
- "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
+ "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
# number](https://support.google.com/cloud/answer/6158840).
# This field has been deprecated and replaced by the name field.
- "masterVersion": "A String", # Required. The Kubernetes version to change the master to.
+ "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # cluster resides. This field has been deprecated and replaced by the name
+ # field.
+ "masterVersion": "A String", # Required. The Kubernetes version to change the master to.
#
# Users may specify either explicit versions offered by
# Kubernetes Engine or version aliases, which have the following behavior:
#
- # - "latest": picks the highest valid Kubernetes version
- # - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
- # - "1.X.Y": picks the highest valid gke.N patch in the 1.X.Y version
- # - "1.X.Y-gke.N": picks an explicit Kubernetes version
- # - "-": picks the default Kubernetes version
- "clusterId": "A String", # Required. Deprecated. The name of the cluster to upgrade.
+ # - "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
+ "clusterId": "A String", # Required. 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/*'.
- "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # cluster resides. This field has been deprecated and replaced by the name
- # field.
+ "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.
@@ -4152,61 +4158,61 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
- "status": "A String", # The current status of the operation.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "endTime": "A String", # [Output only] The time the operation completed, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "name": "A String", # The server-assigned ID for the operation.
- "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.
- "clusterConditions": [ # Which conditions caused the current cluster state.
+ "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
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
],
- "startTime": "A String", # [Output only] The time the operation started, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
- "operationType": "A String", # The operation type.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "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.).
- "intValue": "A String", # For metrics with integer value.
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- },
- ],
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "selfLink": "A String", # Server-defined URL for the resource.
- "location": "A String", # [Output only] The name of the Google Compute Engine
+ "location": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "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.
+ "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.
+ "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.).
+ },
+ ],
+ "name": "A String", # A non-parameterized string describing 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.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "detail": "A String", # Detailed operation progress, if available.
+ "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.
}</pre>
</div>
@@ -4228,13 +4234,19 @@
The object takes the form of:
{ # SetMonitoringServiceRequest sets the monitoring service of a cluster.
- "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
+ "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
# number](https://support.google.com/cloud/answer/6158840).
# This field has been deprecated and replaced by the name field.
- "monitoringService": "A String", # Required. The monitoring service the cluster should use to write metrics.
+ "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # cluster resides. This field has been deprecated and replaced by the name
+ # field.
+ "clusterId": "A String", # Required. 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:
#
- # * "monitoring.googleapis.com/kubernetes" - The Cloud Monitoring
+ # * "monitoring.googleapis.com/kubernetes" - The Cloud Monitoring
# service with a Kubernetes-native resource model
# * `monitoring.googleapis.com` - The legacy Cloud Monitoring service (no
# longer available as of GKE 1.15).
@@ -4242,14 +4254,8 @@
#
# If left as an empty string,`monitoring.googleapis.com/kubernetes` will be
# used for GKE 1.14+ or `monitoring.googleapis.com` for earlier versions.
- "clusterId": "A String", # Required. 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 monitoring.
- # Specified in the format 'projects/*/locations/*/clusters/*'.
- "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # cluster resides. This field has been deprecated and replaced by the name
- # field.
+ "name": "A String", # The name (project, location, cluster) of the cluster to set monitoring.
+ # Specified in the format `projects/*/locations/*/clusters/*`.
}
x__xgafv: string, V1 error format.
@@ -4262,61 +4268,61 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
- "status": "A String", # The current status of the operation.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "endTime": "A String", # [Output only] The time the operation completed, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "name": "A String", # The server-assigned ID for the operation.
- "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.
- "clusterConditions": [ # Which conditions caused the current cluster state.
+ "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
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
],
- "startTime": "A String", # [Output only] The time the operation started, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
- "operationType": "A String", # The operation type.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "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.).
- "intValue": "A String", # For metrics with integer value.
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- },
- ],
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "selfLink": "A String", # Server-defined URL for the resource.
- "location": "A String", # [Output only] The name of the Google Compute Engine
+ "location": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "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.
+ "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.
+ "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.).
+ },
+ ],
+ "name": "A String", # A non-parameterized string describing 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.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "detail": "A String", # Detailed operation progress, if available.
+ "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.
}</pre>
</div>
@@ -4340,26 +4346,26 @@
{ # 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/*'.
- "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # cluster resides. This field has been deprecated and replaced by the name
- # field.
- "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
- # number](https://developers.google.com/console/help/new/#projectnumber).
- # This field has been deprecated and replaced by the name field.
- "labelFingerprint": "A String", # Required. The fingerprint of the previous set of labels for this resource,
+ "labelFingerprint": "A String", # Required. The fingerprint of the previous set of labels for this resource,
# used to detect conflicts. The fingerprint is initially generated by
# Kubernetes Engine and changes after every request to modify or update
# labels. You must always provide an up-to-date fingerprint hash when
# updating or changing labels. Make a <code>get()</code> request to the
# resource to get the latest fingerprint.
- "clusterId": "A String", # Required. Deprecated. The name of the cluster.
- # This field has been deprecated and replaced by the name field.
- "resourceLabels": { # Required. The labels to set for that cluster.
- "a_key": "A String",
+ "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # cluster resides. This field has been deprecated and replaced by the name
+ # field.
+ "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", # Required. Deprecated. The Google Developers Console [project ID or project
+ # number](https://developers.google.com/console/help/new/#projectnumber).
+ # This field has been deprecated and replaced by the name field.
+ "clusterId": "A String", # Required. Deprecated. The name of the cluster.
+ # This field has been deprecated and replaced by the name field.
}
x__xgafv: string, V1 error format.
@@ -4372,61 +4378,61 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
- "status": "A String", # The current status of the operation.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "endTime": "A String", # [Output only] The time the operation completed, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "name": "A String", # The server-assigned ID for the operation.
- "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.
- "clusterConditions": [ # Which conditions caused the current cluster state.
+ "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
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
],
- "startTime": "A String", # [Output only] The time the operation started, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
- "operationType": "A String", # The operation type.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "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.).
- "intValue": "A String", # For metrics with integer value.
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- },
- ],
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "selfLink": "A String", # Server-defined URL for the resource.
- "location": "A String", # [Output only] The name of the Google Compute Engine
+ "location": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "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.
+ "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.
+ "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.).
+ },
+ ],
+ "name": "A String", # A non-parameterized string describing 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.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "detail": "A String", # Detailed operation progress, if available.
+ "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.
}</pre>
</div>
@@ -4445,26 +4451,36 @@
The object takes the form of:
{ # SetMaintenancePolicyRequest sets the maintenance policy for a cluster.
- "projectId": "A String", # Required. The Google Developers Console [project ID or project
- # number](https://support.google.com/cloud/answer/6158840).
- "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
+ "clusterId": "A String", # Required. The name of the cluster to update.
+ "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.
- "recurringWindow": { # Represents an arbitrary window of time that recurs. # RecurringWindow specifies some number of recurring time periods for
+ "resourceVersion": "A String", # A hash identifying the version of this policy, so that updates to fields of
+ # the policy won't accidentally undo intermediate changes (and so that users
+ # of the API unaware of some fields won't accidentally remove other fields).
+ # Make a <code>get()</code> request to the cluster to get the current
+ # resource version and include it with requests to set the 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.
+ "startTime": "A String", # Time within the maintenance window to start the maintenance operations.
+ # It must be in format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
+ },
+ "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.
- "recurrence": "A String", # An RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) for how
+ "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.
#
- # For example, to have something repeat every weekday, you'd use:
+ # For example, to have something repeat every weekday, you'd use:
# <code>FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR</code>
# To repeat some window daily (equivalent to the DailyMaintenanceWindow):
# <code>FREQ=DAILY</code>
# For the first weekend of every month:
# <code>FREQ=MONTHLY;BYSETPOS=1;BYDAY=SA,SU</code>
# This specifies how frequently the window starts. Eg, if you wanted to have
- # a 9-5 UTC-4 window every weekday, you'd use something like:
+ # a 9-5 UTC-4 window every weekday, you'd use something like:
# <code>
# start time = 2019-01-01T09:00:00-0400
# end time = 2019-01-01T17:00:00-0400
@@ -4477,41 +4493,31 @@
# end time = 2019-01-07T23:59:00Z
# recurrence = FREQ=WEEKLY;BYDAY=SA
# </code>
- # Note the start and end time's specific dates are largely arbitrary except
+ # 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
+ "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.
+ "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.
- "duration": "A String", # [Output only] Duration of the time window, automatically chosen to be
- # smallest possible in the given scenario.
- "startTime": "A String", # Time within the maintenance window to start the maintenance operations.
- # It must be in format "HH:MM", where HH : [00-23] and MM : [00-59] GMT.
- },
- "maintenanceExclusions": { # Exceptions to maintenance window. Non-emergency maintenance should not
+ "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
+ "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.
+ "startTime": "A String", # The time that the window first starts.
},
},
},
- "resourceVersion": "A String", # A hash identifying the version of this policy, so that updates to fields of
- # the policy won't accidentally undo intermediate changes (and so that users
- # of the API unaware of some fields won't accidentally remove other fields).
- # Make a <code>get()</code> request to the cluster to get the current
- # resource version and include it with requests to set the policy.
},
- "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
+ "name": "A String", # The name (project, location, cluster id) of the cluster to set maintenance
# policy.
- # Specified in the format 'projects/*/locations/*/clusters/*'.
- "zone": "A String", # Required. The name of the Google Compute Engine
+ # 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.
}
@@ -4526,61 +4532,61 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
- "status": "A String", # The current status of the operation.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "endTime": "A String", # [Output only] The time the operation completed, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "name": "A String", # The server-assigned ID for the operation.
- "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.
- "clusterConditions": [ # Which conditions caused the current cluster state.
+ "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
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
],
- "startTime": "A String", # [Output only] The time the operation started, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
- "operationType": "A String", # The operation type.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "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.).
- "intValue": "A String", # For metrics with integer value.
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- },
- ],
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "selfLink": "A String", # Server-defined URL for the resource.
- "location": "A String", # [Output only] The name of the Google Compute Engine
+ "location": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "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.
+ "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.
+ "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.).
+ },
+ ],
+ "name": "A String", # A non-parameterized string describing 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.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "detail": "A String", # Detailed operation progress, if available.
+ "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.
}</pre>
</div>
@@ -4604,39 +4610,39 @@
The object takes the form of:
{ # SetMasterAuthRequest updates the admin password of a cluster.
- "name": "A String", # The name (project, location, cluster) of the cluster to set auth.
- # Specified in the format 'projects/*/locations/*/clusters/*'.
- "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # cluster resides. This field has been deprecated and replaced by the name
- # field.
- "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
+ "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.
+ "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
# number](https://support.google.com/cloud/answer/6158840).
# This field has been deprecated and replaced by the name field.
- "clusterId": "A String", # Required. Deprecated. The name of the cluster to upgrade.
+ "clusterId": "A String", # Required. Deprecated. The name of the cluster to upgrade.
# This field has been deprecated and replaced by the name field.
- "update": { # The authentication information for accessing the master endpoint. # Required. A description of the update.
+ "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.
- "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).
- "clientKey": "A String", # [Output only] Base64-encoded private key used by clients to authenticate
- # to the cluster endpoint.
- "clientCertificate": "A String", # [Output only] Base64-encoded public certificate used by clients to
- # authenticate to the cluster endpoint.
- "clusterCaCertificate": "A String",
- "password": "A String", # The password to use for HTTP basic authentication to the master endpoint.
+ "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
# must be non-empty.
- "clientCertificateConfig": { # Configuration for client certificates on the cluster. # Configuration for client certificate authentication on the cluster. For
+ "clientCertificateConfig": { # Configuration for client certificates on the cluster. # Configuration for client certificate authentication on the cluster. For
# clusters before v1.12, if no configuration is specified, a client
# certificate is issued.
- "issueClientCertificate": True or False, # Issue a client certificate.
+ "issueClientCertificate": True or False, # Issue a client certificate.
},
+ "clientKey": "A String", # [Output only] Base64-encoded private key used by clients to authenticate
+ # to the cluster endpoint.
+ "clusterCaCertificate": "A String",
+ "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).
},
- "action": "A String", # Required. The exact form of action to be taken on the master auth.
+ "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # cluster resides. This field has been deprecated and replaced by the name
+ # field.
}
x__xgafv: string, V1 error format.
@@ -4649,61 +4655,61 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
- "status": "A String", # The current status of the operation.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "endTime": "A String", # [Output only] The time the operation completed, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "name": "A String", # The server-assigned ID for the operation.
- "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.
- "clusterConditions": [ # Which conditions caused the current cluster state.
+ "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
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
],
- "startTime": "A String", # [Output only] The time the operation started, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
- "operationType": "A String", # The operation type.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "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.).
- "intValue": "A String", # For metrics with integer value.
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- },
- ],
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "selfLink": "A String", # Server-defined URL for the resource.
- "location": "A String", # [Output only] The name of the Google Compute Engine
+ "location": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "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.
+ "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.
+ "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.).
+ },
+ ],
+ "name": "A String", # A non-parameterized string describing 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.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "detail": "A String", # Detailed operation progress, if available.
+ "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.
}</pre>
</div>
@@ -4725,22 +4731,22 @@
The object takes the form of:
{ # SetNetworkPolicyRequest enables/disables network policy for a cluster.
- "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
+ "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
# number](https://developers.google.com/console/help/new/#projectnumber).
# This field has been deprecated and replaced by the name field.
- "clusterId": "A String", # Required. 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.
- # https://kubernetes.io/docs/concepts/services-networking/networkpolicies/
- "enabled": True or False, # Whether network policy is enabled on the cluster.
- "provider": "A String", # The selected network policy provider.
- },
- "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
+ "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/zones#available) in which the
# cluster resides. This field has been deprecated and replaced by the name
# field.
- "name": "A String", # The name (project, location, cluster id) of the cluster to set networking
- # policy. Specified in the format 'projects/*/locations/*/clusters/*'.
+ "clusterId": "A String", # Required. 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.
+ # https://kubernetes.io/docs/concepts/services-networking/networkpolicies/
+ "enabled": True or False, # Whether network policy is enabled on the cluster.
+ "provider": "A String", # The selected network policy provider.
+ },
+ "name": "A String", # The name (project, location, cluster id) of the cluster to set networking
+ # policy. Specified in the format `projects/*/locations/*/clusters/*`.
}
x__xgafv: string, V1 error format.
@@ -4753,61 +4759,61 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
- "status": "A String", # The current status of the operation.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "endTime": "A String", # [Output only] The time the operation completed, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "name": "A String", # The server-assigned ID for the operation.
- "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.
- "clusterConditions": [ # Which conditions caused the current cluster state.
+ "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
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
],
- "startTime": "A String", # [Output only] The time the operation started, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
- "operationType": "A String", # The operation type.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "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.).
- "intValue": "A String", # For metrics with integer value.
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- },
- ],
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "selfLink": "A String", # Server-defined URL for the resource.
- "location": "A String", # [Output only] The name of the Google Compute Engine
+ "location": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "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.
+ "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.
+ "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.).
+ },
+ ],
+ "name": "A String", # A non-parameterized string describing 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.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "detail": "A String", # Detailed operation progress, if available.
+ "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.
}</pre>
</div>
@@ -4830,18 +4836,18 @@
{ # StartIPRotationRequest creates a new IP for the cluster and then performs
# a node upgrade on each node pool to point to the new IP.
- "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
+ "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", # Required. Deprecated. The Google Developers Console [project ID or project
# number](https://developers.google.com/console/help/new/#projectnumber).
# This field has been deprecated and replaced by the name field.
- "rotateCredentials": True or False, # Whether to rotate credentials during IP rotation.
- "clusterId": "A String", # Required. 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 start IP
- # rotation. Specified in the format 'projects/*/locations/*/clusters/*'.
- "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
+ "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/zones#available) in which the
# cluster resides. This field has been deprecated and replaced by the name
# field.
+ "clusterId": "A String", # Required. 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.
}
x__xgafv: string, V1 error format.
@@ -4854,61 +4860,61 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
- "status": "A String", # The current status of the operation.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "endTime": "A String", # [Output only] The time the operation completed, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "name": "A String", # The server-assigned ID for the operation.
- "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.
- "clusterConditions": [ # Which conditions caused the current cluster state.
+ "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
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
],
- "startTime": "A String", # [Output only] The time the operation started, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
- "operationType": "A String", # The operation type.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "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.).
- "intValue": "A String", # For metrics with integer value.
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- },
- ],
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "selfLink": "A String", # Server-defined URL for the resource.
- "location": "A String", # [Output only] The name of the Google Compute Engine
+ "location": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "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.
+ "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.
+ "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.).
+ },
+ ],
+ "name": "A String", # A non-parameterized string describing 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.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "detail": "A String", # Detailed operation progress, if available.
+ "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.
}</pre>
</div>
@@ -4930,69 +4936,164 @@
The object takes the form of:
{ # UpdateClusterRequest updates the settings of a cluster.
- "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
+ "projectId": "A String", # Required. Deprecated. The Google Developers Console [project ID or project
# number](https://support.google.com/cloud/answer/6158840).
# This field has been deprecated and replaced by the name field.
- "clusterId": "A String", # Required. Deprecated. The name of the cluster to upgrade.
+ "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
+ # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
+ # cluster resides. This field has been deprecated and replaced by the name
+ # field.
+ "clusterId": "A String", # Required. Deprecated. The name of the cluster to upgrade.
# This field has been deprecated and replaced by the name field.
- "update": { # ClusterUpdate describes an update to the cluster. Exactly one update can # Required. A description of the update.
+ "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.
- "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.
- "desiredNodePoolId": "A String", # The node pool to be upgraded. This field is mandatory if
- # "desired_node_version", "desired_image_family",
- # "desired_node_pool_autoscaling", or "desired_workload_metadata_config"
- # is specified and there is more than one node pool on the cluster.
- "desiredImageType": "A String", # The desired image type for the node pool.
- # NOTE: Set the "desired_node_pool" field as well.
- "desiredClusterTelemetry": { # Telemetry integration for the cluster. # The desired telemetry integration for the cluster.
- "type": "A String", # Type of the integration.
+ "desiredPrivateClusterConfig": { # Configuration options for private clusters. # The desired private cluster configuration.
+ "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.
+ "masterGlobalAccessConfig": { # Configuration for controlling master global access settings. # Controls master global access settings.
+ "enabled": True or False, # Whenever master is accessible globally or not.
+ },
+ "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.
},
- "desiredClusterAutoscaling": { # ClusterAutoscaling contains global, per-cluster information # Cluster-level autoscaling configuration.
+ "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 Google Binauthz.
+ },
+ "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
+ # is enabled or not on the Master, it does not track whether network policy
+ # is enabled for the nodes.
+ # is enabled or not on the Master, it does not track whether network policy
+ # is enabled for the nodes.
+ "disabled": True or False, # Whether NetworkPolicy is enabled for this cluster.
+ },
+ "configConnectorConfig": { # Configuration options for the Config Connector add-on. # Configuration for the ConfigConnector add-on, a Kubernetes
+ # extension to manage hosted GCP services through the Kubernetes API
+ "enabled": True or False, # Whether Cloud Connector is enabled for this cluster.
+ },
+ "cloudRunConfig": { # Configuration options for the Cloud Run feature. # Configuration for the Cloud Run addon. The `IstioConfig` addon must be
+ # enabled in order to enable Cloud Run addon. This option can only be enabled
+ # at cluster creation time.
+ "disabled": True or False, # Whether Cloud Run addon is enabled for this cluster.
+ },
+ "horizontalPodAutoscaling": { # Configuration options for the horizontal pod autoscaling feature, which # Configuration for the horizontal pod autoscaling feature, which
+ # increases or decreases the number of replica pods a replication controller
+ # has based on the resource usage of the existing pods.
+ # increases or decreases the number of replica pods a replication controller
+ # has based on the resource usage of the existing pods.
+ "disabled": True or False, # Whether the Horizontal Pod Autoscaling feature is enabled in the cluster.
+ # When enabled, it ensures that metrics are collected into Stackdriver
+ # Monitoring.
+ },
+ "httpLoadBalancing": { # Configuration options for the HTTP (L7) load balancing controller addon, # Configuration for the HTTP (L7) load balancing controller addon, which
+ # makes it easy to set up HTTP load balancers for services in a cluster.
+ # which makes it easy to set up HTTP load balancers for services in a cluster.
+ "disabled": True or False, # Whether the HTTP Load Balancing controller is enabled in the cluster.
+ # When enabled, it runs a small pod in the cluster that manages the load
+ # balancers.
+ },
+ "kubernetesDashboard": { # Configuration for the Kubernetes Dashboard. # Configuration for the Kubernetes Dashboard.
+ # This addon is deprecated, and will be disabled in 1.15. It is recommended
+ # to use the Cloud Console to manage and monitor your Kubernetes clusters,
+ # workloads and applications. For more information, see:
+ # https://cloud.google.com/kubernetes-engine/docs/concepts/dashboards
+ "disabled": True or False, # Whether the Kubernetes Dashboard is enabled for this cluster.
+ },
+ "dnsCacheConfig": { # Configuration for NodeLocal DNSCache # Configuration for NodeLocalDNS, a dns cache running on cluster nodes
+ "enabled": True or False, # Whether NodeLocal DNSCache is enabled for this cluster.
+ },
+ "kalmConfig": { # Configuration options for the KALM addon. # Configuration for the KALM addon, which manages the lifecycle of k8s
+ # applications.
+ "enabled": True or False, # Whether KALM is enabled for this cluster.
+ },
+ "gcePersistentDiskCsiDriverConfig": { # Configuration for the Compute Engine PD CSI driver. This option can only be # Configuration for the Compute Engine Persistent Disk CSI driver.
+ # enabled at cluster creation time.
+ "enabled": True or False, # Whether the Compute Engine PD CSI driver is enabled for this cluster.
+ },
+ "istioConfig": { # Configuration options for Istio addon. # Configuration for Istio, an open platform to connect, manage, and secure
+ # microservices.
+ "disabled": True or False, # Whether Istio is enabled for this cluster.
+ "auth": "A String", # The specified Istio auth mode, either none, or mutual TLS.
+ },
+ },
+ "desiredNodeVersion": "A String", # The Kubernetes version to change the nodes to (typically an
+ # upgrade).
+ #
+ # Users may specify either explicit versions offered by
+ # Kubernetes Engine or version aliases, which have the following behavior:
+ #
+ # - "latest": picks the highest valid Kubernetes version
+ # - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
+ # - "1.X.Y": picks the highest valid gke.N patch in the 1.X.Y version
+ # - "1.X.Y-gke.N": picks an explicit Kubernetes version
+ # - "-": picks the Kubernetes master version
+ "desiredIntraNodeVisibilityConfig": { # IntraNodeVisibilityConfig contains the desired config of the intra-node # The desired config of Intra-node visibility.
+ # visibility on this cluster.
+ "enabled": True or False, # Enables intra node visibility for this cluster.
+ },
+ "desiredPodSecurityPolicyConfig": { # Configuration for the PodSecurityPolicy feature. # The desired configuration options for the PodSecurityPolicy feature.
+ "enabled": True or False, # Enable the PodSecurityPolicy controller for this cluster. If enabled, pods
+ # must be valid under a PodSecurityPolicy to be created.
+ },
+ "desiredClusterAutoscaling": { # 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.
- "autoprovisioningNodePoolDefaults": { # AutoprovisioningNodePoolDefaults contains defaults for a node pool created # AutoprovisioningNodePoolDefaults contains defaults for a node pool
+ "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.
+ },
+ ],
+ "autoscalingProfile": "A String", # Defines autoscaling behaviour.
+ "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.
- "minCpuPlatform": "A String", # Minimum CPU platform to be used for NAP created node pools.
+ "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.
+ "autoUpgrade": True or False, # Whether the nodes will be automatically upgraded.
+ "autoRepair": True or False, # Whether the nodes will be automatically repaired.
+ "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.
+ },
+ },
+ "minCpuPlatform": "A String", # Minimum CPU platform to be used for NAP created node pools.
# The instance may be scheduled on the specified or newer CPU platform.
# Applicable values are the friendly names of CPU platforms, such as
# <code>minCpuPlatform: &quot;Intel Haswell&quot;</code> or
# <code>minCpuPlatform: &quot;Intel Sandy Bridge&quot;</code>. For more
# information, read [how to specify min CPU
# platform](https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform)
- # To unset the min cpu platform field pass "automatic" as field value.
- "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.
- },
- "autoRepair": True or False, # Whether the nodes will be automatically repaired.
- "autoUpgrade": True or False, # Whether the nodes will be automatically upgraded.
- },
- "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.
- "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
+ # To unset the min cpu platform field pass "automatic" as field value.
+ "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
@@ -5015,193 +5116,81 @@
# 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.
- "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
+ "maxSurge": 42, # The maximum number of nodes that can be created beyond the current size
# of the node pool during the upgrade process.
- "maxUnavailable": 42, # The maximum number of nodes that can be simultaneously unavailable during
+ "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.
},
+ "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.
},
- "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.
- "resourceType": "A String", # Resource name "cpu", "memory" or gpu-specific string.
- "minimum": "A String", # Minimum amount of the resource in the cluster.
- "maximum": "A String", # Maximum amount of the resource in the cluster.
+ "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",
+ ],
+ },
+ "desiredDatabaseEncryption": { # Configuration of etcd encryption. # Configuration of etcd encryption.
+ "state": "A String", # Denotes the state of etcd encryption.
+ "keyName": "A String", # Name of CloudKMS key to use for the encryption of secrets in etcd.
+ # Ex. projects/my-project/locations/global/keyRings/my-ring/cryptoKeys/my-key
+ },
+ "desiredMasterAuthorizedNetworksConfig": { # Configuration options for the master authorized networks feature. Enabled # The desired configuration options for master authorized networks feature.
+ # 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.
+ "cidrBlocks": [ # cidr_blocks define up to 10 external networks that could access
+ # Kubernetes master through HTTPS.
+ { # CidrBlock contains an optional name and one CIDR block.
+ "displayName": "A String", # display_name is an optional field for users to identify CIDR blocks.
+ "cidrBlock": "A String", # cidr_block must be specified in CIDR notation.
},
],
- "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",
- ],
- "autoscalingProfile": "A String", # Defines autoscaling behaviour.
- "enableNodeAutoprovisioning": True or False, # Enables automatic node pool creation and deletion.
+ "enabled": True or False, # Whether or not master authorized networks is enabled.
},
- "desiredNodePoolAutoscaling": { # NodePoolAutoscaling contains information required by cluster autoscaler to # Autoscaler configuration for the node pool specified in
+ "desiredTpuConfig": { # Configuration for Cloud TPU. # The desired Cloud TPU configuration.
+ "enabled": True or False, # Whether Cloud TPU integration is enabled or not.
+ "ipv4CidrBlock": "A String", # IPv4 CIDR block reserved for Cloud TPU in the VPC.
+ "useServiceNetworking": True or False, # Whether to use service networking for Cloud TPU or not.
+ },
+ "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
+ # daemonset will be created in the cluster to meter network egress traffic.
+ "consumptionMeteringConfig": { # Parameters for controlling consumption metering. # Configuration to enable resource consumption metering.
+ "enabled": True or False, # Whether to enable consumption metering for this cluster. If enabled, a
+ # second BigQuery table will be created to hold resource consumption
+ # records.
+ },
+ "bigqueryDestination": { # Parameters for using BigQuery as the destination of resource usage export. # Configuration to use BigQuery as usage export destination.
+ "datasetId": "A String", # The ID of a BigQuery Dataset.
+ },
+ },
+ "desiredLocations": [ # The desired list of Google Compute Engine
+ # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
+ # cluster's nodes should be located. Changing the locations a cluster is in
+ # will result in nodes being either created or removed from the cluster,
+ # depending on whether locations are being added or removed.
+ #
+ # This list must always include the cluster's primary zone.
+ "A String",
+ ],
+ "desiredNodePoolAutoscaling": { # NodePoolAutoscaling contains information required by cluster autoscaler to # Autoscaler configuration for the node pool specified in
# desired_node_pool_id. If there is only one pool in the
# cluster and desired_node_pool_id is not provided then
# the change applies to that single node pool.
# adjust the size of the node pool to the current cluster usage.
- "minNodeCount": 42, # Minimum number of nodes in the NodePool. Must be >= 1 and <=
+ "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.
- "maxNodeCount": 42, # Maximum number of nodes in the NodePool. Must be >= min_node_count. There
+ "autoprovisioned": True or False, # Can this node pool be deleted automatically.
+ "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.
},
- "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.
- },
- "desiredNodeVersion": "A String", # The Kubernetes version to change the nodes to (typically an
- # upgrade).
- #
- # Users may specify either explicit versions offered by
- # Kubernetes Engine or version aliases, which have the following behavior:
- #
- # - "latest": picks the highest valid Kubernetes version
- # - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
- # - "1.X.Y": picks the highest valid gke.N patch in the 1.X.Y version
- # - "1.X.Y-gke.N": picks an explicit Kubernetes version
- # - "-": picks the Kubernetes master version
- "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.
- "identityNamespace": "A String", # IAM Identity Namespace to attach all Kubernetes Service Accounts to.
- },
- "desiredPodSecurityPolicyConfig": { # Configuration for the PodSecurityPolicy feature. # The desired configuration options for the PodSecurityPolicy feature.
- "enabled": True or False, # Enable the PodSecurityPolicy controller for this cluster. If enabled, pods
- # must be valid under a PodSecurityPolicy to be created.
- },
- "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
- # is enabled or not on the Master, it does not track whether network policy
- # is enabled for the nodes.
- # is enabled or not on the Master, it does not track whether network policy
- # is enabled for the nodes.
- "disabled": True or False, # Whether NetworkPolicy is enabled for this cluster.
- },
- "cloudRunConfig": { # Configuration options for the Cloud Run feature. # Configuration for the Cloud Run addon. The `IstioConfig` addon must be
- # enabled in order to enable Cloud Run addon. This option can only be enabled
- # at cluster creation time.
- "disabled": True or False, # Whether Cloud Run addon is enabled for this cluster.
- },
- "httpLoadBalancing": { # Configuration options for the HTTP (L7) load balancing controller addon, # Configuration for the HTTP (L7) load balancing controller addon, which
- # makes it easy to set up HTTP load balancers for services in a cluster.
- # which makes it easy to set up HTTP load balancers for services in a cluster.
- "disabled": True or False, # Whether the HTTP Load Balancing controller is enabled in the cluster.
- # When enabled, it runs a small pod in the cluster that manages the load
- # balancers.
- },
- "kalmConfig": { # Configuration options for the KALM addon. # Configuration for the KALM addon, which manages the lifecycle of k8s
- # applications.
- "enabled": True or False, # Whether KALM is enabled for this cluster.
- },
- "horizontalPodAutoscaling": { # Configuration options for the horizontal pod autoscaling feature, which # Configuration for the horizontal pod autoscaling feature, which
- # increases or decreases the number of replica pods a replication controller
- # has based on the resource usage of the existing pods.
- # increases or decreases the number of replica pods a replication controller
- # has based on the resource usage of the existing pods.
- "disabled": True or False, # Whether the Horizontal Pod Autoscaling feature is enabled in the cluster.
- # When enabled, it ensures that metrics are collected into Stackdriver
- # Monitoring.
- },
- "gcePersistentDiskCsiDriverConfig": { # Configuration for the Compute Engine PD CSI driver. This option can only be # Configuration for the Compute Engine Persistent Disk CSI driver.
- # enabled at cluster creation time.
- "enabled": True or False, # Whether the Compute Engine PD CSI driver is enabled for this cluster.
- },
- "configConnectorConfig": { # Configuration options for the Config Connector add-on. # Configuration for the ConfigConnector add-on, a Kubernetes
- # extension to manage hosted GCP services through the Kubernetes API
- "enabled": True or False, # Whether Cloud Connector is enabled for this cluster.
- },
- "dnsCacheConfig": { # Configuration for NodeLocal DNSCache # Configuration for NodeLocalDNS, a dns cache running on cluster nodes
- "enabled": True or False, # Whether NodeLocal DNSCache is enabled for this cluster.
- },
- "istioConfig": { # Configuration options for Istio addon. # Configuration for Istio, an open platform to connect, manage, and secure
- # microservices.
- "disabled": True or False, # Whether Istio is enabled for this cluster.
- "auth": "A String", # The specified Istio auth mode, either none, or mutual TLS.
- },
- "kubernetesDashboard": { # Configuration for the Kubernetes Dashboard. # Configuration for the Kubernetes Dashboard.
- # This addon is deprecated, and will be disabled in 1.15. It is recommended
- # to use the Cloud Console to manage and monitor your Kubernetes clusters,
- # workloads and applications. For more information, see:
- # https://cloud.google.com/kubernetes-engine/docs/concepts/dashboards
- "disabled": True or False, # Whether the Kubernetes Dashboard is enabled for this cluster.
- },
- },
- "desiredTpuConfig": { # Configuration for Cloud TPU. # The desired Cloud TPU configuration.
- "useServiceNetworking": True or False, # Whether to use service networking for Cloud TPU or not.
- "ipv4CidrBlock": "A String", # IPv4 CIDR block reserved for Cloud TPU in the VPC.
- "enabled": True or False, # Whether Cloud TPU integration is enabled or not.
- },
- "desiredResourceUsageExportConfig": { # Configuration for exporting cluster resource usages. # The desired configuration for exporting resource usage.
- "bigqueryDestination": { # Parameters for using BigQuery as the destination of resource usage export. # Configuration to use BigQuery as usage export destination.
- "datasetId": "A String", # The ID of a BigQuery Dataset.
- },
- "enableNetworkEgressMetering": True or False, # Whether to enable network egress metering for this cluster. If enabled, a
- # daemonset will be created in the cluster to meter network egress traffic.
- "consumptionMeteringConfig": { # Parameters for controlling consumption metering. # Configuration to enable resource consumption metering.
- "enabled": True or False, # Whether to enable consumption metering for this cluster. If enabled, a
- # second BigQuery table will be created to hold resource consumption
- # records.
- },
- },
- "desiredIntraNodeVisibilityConfig": { # IntraNodeVisibilityConfig contains the desired config of the intra-node # The desired config of Intra-node visibility.
- # visibility on this cluster.
- "enabled": True or False, # Enables intra node visibility for this cluster.
- },
- "desiredMasterAuthorizedNetworksConfig": { # Configuration options for the master authorized networks feature. Enabled # The desired configuration options for master authorized networks feature.
- # 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 10 external networks that could access
- # Kubernetes master through HTTPS.
- { # CidrBlock contains an optional name and one CIDR block.
- "cidrBlock": "A String", # cidr_block must be specified in CIDR notation.
- "displayName": "A String", # display_name is an optional field for users to identify CIDR blocks.
- },
- ],
- },
- "desiredReleaseChannel": { # ReleaseChannel indicates which release channel a cluster is # The desired release channel configuration.
- # subscribed to. Release channels are arranged in order of risk and
- # frequency of updates.
- #
- # When a cluster is subscribed to a release channel, Google maintains
- # both the master version and the node version. Node auto-upgrade
- # defaults to true and cannot be disabled. Updates to version related
- # fields (e.g. current_master_version) return an error.
- "channel": "A String", # channel specifies which release channel the cluster is subscribed to.
- },
- "desiredLocations": [ # The desired list of Google Compute Engine
- # [zones](https://cloud.google.com/compute/docs/zones#available) in which the
- # cluster's nodes should be located. Changing the locations a cluster is in
- # will result in nodes being either created or removed from the cluster,
- # depending on whether locations are being added or removed.
- #
- # This list must always include the cluster's primary zone.
- "A String",
- ],
- "desiredMasterVersion": "A String", # The Kubernetes version to change the master to. The only valid value is the
- # latest supported version.
- #
- # Users may specify either explicit versions offered by
- # Kubernetes Engine or version aliases, which have the following behavior:
- #
- # - "latest": picks the highest valid Kubernetes version
- # - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
- # - "1.X.Y": picks the highest valid gke.N patch in the 1.X.Y version
- # - "1.X.Y-gke.N": picks an explicit Kubernetes version
- # - "-": picks the default Kubernetes version
- "desiredMonitoringService": "A String", # The monitoring service the cluster should use to write metrics.
+ "desiredMonitoringService": "A String", # The monitoring service the cluster should use to write metrics.
# Currently available options:
#
- # * "monitoring.googleapis.com/kubernetes" - The Cloud Monitoring
+ # * "monitoring.googleapis.com/kubernetes" - The Cloud Monitoring
# service with a Kubernetes-native resource model
# * `monitoring.googleapis.com` - The legacy Cloud Monitoring service (no
# longer available as of GKE 1.15).
@@ -5209,41 +5198,58 @@
#
# If left as an empty string,`monitoring.googleapis.com/kubernetes` will be
# used for GKE 1.14+ or `monitoring.googleapis.com` for earlier versions.
- "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 Google Binauthz.
+ "desiredImageType": "A String", # The desired image type for the node pool.
+ # NOTE: Set the "desired_node_pool" field as well.
+ "desiredClusterTelemetry": { # Telemetry integration for the cluster. # The desired telemetry integration for the cluster.
+ "type": "A String", # Type of the integration.
},
- "desiredPrivateClusterConfig": { # Configuration options for private clusters. # The desired private cluster configuration.
- "enablePrivateEndpoint": True or False, # Whether the master's internal IP address is used as the cluster endpoint.
- "publicEndpoint": "A String", # Output only. The external IP address of this cluster's master endpoint.
- "masterGlobalAccessConfig": { # Configuration for controlling master global access settings. # Controls master global access settings.
- "enabled": True or False, # Whenever master is accessible globally or not.
- },
- "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.
- "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.
- "peeringName": "A String", # Output only. The peering name in the customer VPC used by this cluster.
+ "desiredWorkloadIdentityConfig": { # Configuration for the use of Kubernetes Service Accounts in GCP IAM # Configuration for Workload Identity.
+ # policies.
+ "identityNamespace": "A String", # IAM Identity Namespace to attach all Kubernetes Service Accounts to.
+ "workloadPool": "A String", # The workload pool to attach all Kubernetes service accounts to.
},
- "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.
+ "desiredNodePoolId": "A String", # The node pool to be upgraded. This field is mandatory if
+ # "desired_node_version", "desired_image_family",
+ # "desired_node_pool_autoscaling", or "desired_workload_metadata_config"
+ # is specified and there is more than one node pool on the cluster.
+ "desiredReleaseChannel": { # ReleaseChannel indicates which release channel a cluster is # The desired release channel configuration.
+ # subscribed to. Release channels are arranged in order of risk and
+ # frequency of updates.
+ #
+ # When a cluster is subscribed to a release channel, Google maintains
+ # both the master version and the node version. Node auto-upgrade
+ # defaults to true and cannot be disabled. Updates to version related
+ # fields (e.g. current_master_version) return an error.
+ "channel": "A String", # channel specifies which release channel the cluster is subscribed to.
},
- "desiredDatabaseEncryption": { # Configuration of etcd encryption. # Configuration of etcd encryption.
- "state": "A String", # Denotes the state of etcd encryption.
- "keyName": "A String", # Name of CloudKMS key to use for the encryption of secrets in etcd.
- # Ex. projects/my-project/locations/global/keyRings/my-ring/cryptoKeys/my-key
+ "desiredMasterVersion": "A String", # The Kubernetes version to change the master to. The only valid value is the
+ # latest supported version.
+ #
+ # Users may specify either explicit versions offered by
+ # Kubernetes Engine or version aliases, which have the following behavior:
+ #
+ # - "latest": picks the highest valid Kubernetes version
+ # - "1.X": picks the highest valid patch+gke.N patch in the 1.X version
+ # - "1.X.Y": picks the highest valid gke.N patch in the 1.X.Y version
+ # - "1.X.Y-gke.N": picks an explicit Kubernetes version
+ # - "-": picks the default Kubernetes version
+ "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.
},
- "zone": "A String", # Required. Deprecated. The name of the Google Compute Engine
- # [zone](https://cloud.google.com/compute/docs/zones#available) in which the
- # cluster resides. This field has been deprecated and replaced by the name
- # field.
- "name": "A String", # The name (project, location, cluster) of the cluster to update.
- # Specified in the format 'projects/*/locations/*/clusters/*'.
+ "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.
@@ -5256,61 +5262,61 @@
{ # This operation resource represents operations that may have happened or are
# happening on the cluster. All fields are output only.
- "status": "A String", # The current status of the operation.
- "statusMessage": "A String", # Output only. If an error has occurred, a textual description of the error.
- "endTime": "A String", # [Output only] The time the operation completed, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "name": "A String", # The server-assigned ID for the operation.
- "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.
- "clusterConditions": [ # Which conditions caused the current cluster state.
+ "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
+ "code": "A String", # Machine-friendly representation of the condition
+ "message": "A String", # Human-friendly representation of the condition
},
],
- "startTime": "A String", # [Output only] The time the operation started, in
- # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
- "detail": "A String", # Detailed operation progress, if available.
- "targetLink": "A String", # Server-defined URL for the target of the operation.
- "operationType": "A String", # The operation type.
- "progress": { # Information about operation (or operation stage) progress. # Output only. [Output only] Progress information for an operation.
- "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.).
- "intValue": "A String", # For metrics with integer value.
- "name": "A String", # Required. Metric name, e.g., "nodes total", "percent done".
- "doubleValue": 3.14, # For metrics with floating point value.
- },
- ],
- "stages": [ # Substages of an operation or a stage.
- # Object with schema name: OperationProgress
- ],
- "name": "A String", # A non-parameterized string describing an operation stage.
- # Unset for single-stage operations.
- },
- "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
- },
- ],
- "selfLink": "A String", # Server-defined URL for the resource.
- "location": "A String", # [Output only] The name of the Google Compute Engine
+ "location": "A String", # [Output only] The name of the Google Compute Engine
# [zone](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# or
# [region](https://cloud.google.com/compute/docs/regions-zones/regions-zones#available)
# in which the cluster resides.
+ "endTime": "A String", # [Output only] The time the operation completed, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "startTime": "A String", # [Output only] The time the operation started, in
+ # [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format.
+ "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.
+ "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.
+ "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.).
+ },
+ ],
+ "name": "A String", # A non-parameterized string describing 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.
+ "targetLink": "A String", # Server-defined URL for the target of the operation.
+ "detail": "A String", # Detailed operation progress, if available.
+ "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.
}</pre>
</div>