REST Resource: projects.locations.clusters.nodePools

Recurso: NodePool

Es un conjunto de nodos de Kubernetes en un clúster con una configuración y una especificación comunes.

Representación JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "nodeLocation": string,
  "nodeCount": integer,
  "machineFilter": string,
  "localDiskEncryption": {
    object (LocalDiskEncryption)
  },
  "nodeVersion": string,
  "nodeConfig": {
    object (NodeConfig)
  }
}
Campos
name

string

Obligatorio. Es el nombre del recurso del grupo de nodos.

createTime

string (Timestamp format)

Solo salida. Es la hora en la que se creó el grupo de nodos.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Solo salida. La hora en la que se actualizó el grupo de nodos por última vez.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

labels

map (key: string, value: string)

Son las etiquetas asociadas con este recurso.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

nodeLocation

string

Es el nombre de la zona de Google Distributed Cloud Edge en la que se creará este grupo de nodos. Por ejemplo: us-central1-edge-customer-a.

nodeCount

integer

Obligatorio. Es la cantidad de nodos del grupo.

machineFilter

string

Solo se podrán unir al grupo de nodos las máquinas que coincidan con este filtro. El lenguaje de filtrado acepta cadenas como "name=" y se documenta con más detalle en AIP-160.

localDiskEncryption

object (LocalDiskEncryption)

Es opcional. Opciones de encriptación de discos locales Este campo solo se usa cuando se habilita la compatibilidad con CMEK.

nodeVersion

string

Solo salida. Es la versión de actualización más baja entre todos los nodos trabajadores.

nodeConfig

object (NodeConfig)

Es opcional. Configuración de cada nodo en el NodePool

LocalDiskEncryption

Configuración de la compatibilidad con CMEK para la encriptación de discos locales de máquinas perimetrales.

Representación JSON
{
  "kmsKey": string,
  "kmsKeyActiveVersion": string,
  "kmsKeyState": enum (KmsKeyState),
  "kmsStatus": {
    object (Status)
  },
  "resourceState": enum (ResourceState)
}
Campos
kmsKey

string

Es opcional. La CryptoKey de Cloud KMS, p.ej., projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}, que se usará para proteger los discos locales de los nodos. Si no se especifica, se usará una clave administrada por Google.

kmsKeyActiveVersion

string

Solo salida. Es la CryptoKeyVersion de Cloud KMS que se usa actualmente para proteger los discos locales del nodo. Solo se aplica si se establece kmsKey.

kmsKeyState

enum (KmsKeyState)

Solo salida. Disponibilidad de la CryptoKey de Cloud KMS. Si no es KEY_AVAILABLE, es posible que los nodos se desconecten, ya que no pueden acceder a sus datos locales. Esto puede deberse a la falta de permisos para usar la clave o a que la clave esté inhabilitada o borrada.

kmsStatus

object (Status)

Solo salida. Es el estado de error que devuelve Cloud KMS cuando se usa esta clave. Este campo solo se puede propagar si kmsKeyState no es KMS_KEY_STATE_KEY_AVAILABLE. Si se completa, este campo contiene el estado de error que informó Cloud KMS.

resourceState

enum (ResourceState)

Solo salida. Es el estado actual del recurso asociado a la CMEK.

NodeConfig

Configuración de cada nodo en el NodePool

Representación JSON
{
  "labels": {
    string: string,
    ...
  },
  "nodeStorageSchema": string,
  "nodeSystemPartitionSize": enum /1.13.0/docs/f="/distributed-cloud/connected/latest/docs/reference/container/rest/v1/SystemPartitionGiBSize">SystemPartitionGiBSize)
}
Campos
labels

map (key: string, value: string)

Es opcional. Las etiquetas de nodo de Kubernetes

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

nodeStorageSchema

string

Es opcional. Es el nombre del esquema de almacenamiento de los nodos trabajadores.

nodeSystemPartitionSize

enum (SystemPartitionGiBSize)

Es opcional. Es el tamaño de la partición del sistema para los nodos trabajadores en GiB.

Métodos

create

Crea un NodePool nuevo en un proyecto y una ubicación determinados.

delete

Borra un solo NodePool.

get

Obtiene detalles de un solo NodePool.

list

Enumera los NodePools en una ubicación y un proyecto determinados.

patch

Actualiza los parámetros de un solo NodePool.