REST Resource: projects.locations.clusters.nodePools

Recurso: NodePool

Es un conjunto de nodos de Kubernetes en un clúster con configuración y 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. El nombre del recurso del grupo de nodos.

createTime

string (Timestamp format)

Solo salida. La hora en 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 que se actualizó por última vez 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".

labels

map (key: string, value: string)

Etiquetas asociadas con este recurso.

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

nodeLocation

string

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 las máquinas que coincidan con este filtro podrán unirse al grupo de nodos. 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 disco local. Este campo solo se usa cuando se habilita la compatibilidad con CMEK.

nodeVersion

string

Solo salida. La versión de lanzamiento más baja entre todos los nodos trabajadores.

nodeConfig

object (NodeConfig)

Es opcional. Configuración para cada nodo en NodePool

LocalDiskEncryption

Configuración para la compatibilidad con CMEK para la encriptación de disco local de la máquina perimetral.

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

string

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

kmsKeyActiveVersion

string

Solo salida. La versión de la clave criptográfica de Cloud KMS que se usa actualmente para proteger los discos locales de los nodos. Solo se aplica si se establece kmsKey.

kmsKeyState

enum (KmsKeyState)

Solo salida. Disponibilidad de la clave criptográfica 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 si la clave está inhabilitada o borrada.

kmsStatus

object (Status)

Solo salida. Estado de error que muestra Cloud KMS cuando se usa esta clave. Este campo solo se puede propagar si kmsKeyState no es KMS_KEY_STATE_KEY_AVAILABLE. Si se propaga, este campo contiene el estado de error que informa Cloud KMS.

resourceState

enum (ResourceState)

Solo salida. El estado actual del recurso asociado con la cmek.

NodeConfig

Configuración para cada nodo en NodePool

Representación JSON
{
  "labels": {
    string: string,
    ...
  },
  "nodeStorageSchema": string,
  "nodeSystemPartitionSize": enum (SystemPartitionGiBSize)
}
Campos
labels

map (key: string, value: string)

Es opcional. Las etiquetas de nodo de Kubernetes

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

nodeStorageSchema

string

Es opcional. Nombre del esquema de almacenamiento de los nodos trabajadores.

nodeSystemPartitionSize

enum (SystemPartitionGiBSize)

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

Métodos

create

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

delete

Borra un solo NodePool.

get

Obtiene los detalles de un solo NodePool.

list

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

patch

Actualiza los parámetros de un solo NodePool.