# REST Resource: projects.locations.clusters.nodePools

- [Resource: NodePool](https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/projects.locations.clusters.nodePools#NodePool)
  - [JSON representation](https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/projects.locations.clusters.nodePools#NodePool.SCHEMA_REPRESENTATION)
- [LocalDiskEncryption](https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/projects.locations.clusters.nodePools#LocalDiskEncryption)
  - [JSON representation](https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/projects.locations.clusters.nodePools#LocalDiskEncryption.SCHEMA_REPRESENTATION)
- [NodeConfig](https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/projects.locations.clusters.nodePools#NodeConfig)
  - [JSON representation](https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/projects.locations.clusters.nodePools#NodeConfig.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/projects.locations.clusters.nodePools#METHODS_SUMMARY)

## Resource: NodePool

A set of Kubernetes nodes in a cluster with common configuration and specification.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "nodeLocation": string, "nodeCount": integer, "machineFilter": string, "localDiskEncryption": { object (`https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/projects.locations.clusters.nodePools#LocalDiskEncryption`) }, "nodeVersion": string, "nodeConfig": { object (`https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/projects.locations.clusters.nodePools#NodeConfig`) } } ``` |

| Fields ||
|---|---|
| `name` | `string` Required. The resource name of the node pool. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The time when the node pool was created. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The time when the node pool was last updated. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `labels` | `map (key: string, value: string)` Labels associated with this resource. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `nodeLocation` | `string` Name of the Google Distributed Cloud Edge zone where this node pool will be created. For example: `us-central1-edge-customer-a`. |
| `nodeCount` | `integer` Required. The number of nodes in the pool. |
| `machineFilter` | `string` Only machines matching this filter will be allowed to join the node pool. The filtering language accepts strings like "name=", and is documented in more detail in [AIP-160](https://google.aip.dev/160). |
| `localDiskEncryption` | ``object (`https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/projects.locations.clusters.nodePools#LocalDiskEncryption`)`` Optional. Local disk encryption options. This field is only used when enabling CMEK support. |
| `nodeVersion` | `string` Output only. The lowest release version among all worker nodes. |
| `nodeConfig` | ``object (`https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/projects.locations.clusters.nodePools#NodeConfig`)`` Optional. Configuration for each node in the NodePool |

## LocalDiskEncryption

Configuration for CMEK support for edge machine local disk encryption.

| JSON representation |
|---|
| ``` { "kmsKey": string, "kmsKeyActiveVersion": string, "kmsKeyState": enum (`https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/KmsKeyState`), "kmsStatus": { object (`https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/Status`) }, "resourceState": enum (`https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/ResourceState`) } ``` |

| Fields ||
|---|---|
| `kmsKey` | `string` Optional. The Cloud KMS CryptoKey e.g. projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey} to use for protecting node local disks. If not specified, a Google-managed key will be used instead. |
| `kmsKeyActiveVersion` | `string` Output only. The Cloud KMS CryptoKeyVersion currently in use for protecting node local disks. Only applicable if kmsKey is set. |
| `kmsKeyState` | ``enum (`https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/KmsKeyState`)`` Output only. Availability of the Cloud KMS CryptoKey. If not `KEY_AVAILABLE`, then nodes may go offline as they cannot access their local data. This can be caused by a lack of permissions to use the key, or if the key is disabled or deleted. |
| `kmsStatus` | ``object (`https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/Status`)`` Output only. Error status returned by Cloud KMS when using this key. This field may be populated only if `kmsKeyState` is not `KMS_KEY_STATE_KEY_AVAILABLE`. If populated, this field contains the error status reported by Cloud KMS. |
| `resourceState` | ``enum (`https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/ResourceState`)`` Output only. The current resource state associated with the cmek. |

## NodeConfig

Configuration for each node in the NodePool

| JSON representation |
|---|
| ``` { "labels": { string: string, ... }, "nodeStorageSchema": string } ``` |

| Fields ||
|---|---|
| `labels` | `map (key: string, value: string)` Optional. The Kubernetes node labels An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `nodeStorageSchema` | `string` Optional. Name for the storage schema of worker nodes. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/projects.locations.clusters.nodePools/create` | Creates a new NodePool in a given project and location. |
| ### `https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/projects.locations.clusters.nodePools/delete` | Deletes a single NodePool. |
| ### `https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/projects.locations.clusters.nodePools/get` | Gets details of a single NodePool. |
| ### `https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/projects.locations.clusters.nodePools/list` | Lists NodePools in a given project and location. |
| ### `https://docs.cloud.google.com/distributed-cloud/connected/1.9.0/docs/reference/container/rest/v1/projects.locations.clusters.nodePools/patch` | Updates the parameters of a single NodePool. |