REST Resource: projects.locations.clusters.nodePools

Recurso: NodePool

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

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

string

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

createTime

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

labels

map (key: string, value: string)

Son las etiquetas asociadas a 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 permitirá que las máquinas que coincidan con este filtro se unan 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. Es la versión de lanzamiento más baja entre todos los nodos trabajadores.

LocalDiskEncryption

Es la configuración de la compatibilidad con CMEK para la encriptación de discos locales de la máquina perimetral.

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

string

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

kmsKeyActiveVersion

string

Solo salida. Es la versión de CryptoKey de Cloud KMS que se usa actualmente para proteger los discos locales del nodo. Solo se aplica si se configura 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 completar si kmsKeyState no es KMS_KEY_STATE_KEY_AVAILABLE. Si se propaga, este campo contiene el estado de error que informa Cloud KMS.

KmsKeyState

Representa el estado de accesibilidad de una clave de KMS administrada por el cliente que se usa para la integración de CMEK.

Enums
KMS_KEY_STATE_UNSPECIFIED Sin especificar.
KMS_KEY_STATE_KEY_AVAILABLE La clave está disponible para su uso y se debería poder acceder a los recursos dependientes.
KMS_KEY_STATE_KEY_UNAVAILABLE La clave no está disponible por un motivo no especificado. Es posible que no se pueda acceder a los recursos dependientes.

Métodos

create

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

delete

Borra un solo NodePool.

get

Obtiene detalles de un solo NodePool.

list

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

patch

Actualiza los parámetros de un solo NodePool.