REST Resource: projects.locations.clusters

Recurso: Cluster

Un clúster de Kubernetes de Google Distributed Cloud Edge.

Representación JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "fleet": {
    object (Fleet)
  },
  "networking": {
    object (ClusterNetworking)
  },
  "authorization": {
    object (Authorization)
  },
  "defaultMaxPodsPerNode": integer,
  "endpoint": string,
  "clusterCaCertificate": string,
  "maintenancePolicy": {
    object (MaintenancePolicy)
  },
  "controlPlaneVersion": string,
  "nodeVersion": string
}
Campos
name

string

Obligatorio. Es el nombre del recurso del clúster.
createTime

string (Timestamp format)

Solo salida. Es la fecha y hora en que se creó el clúster.

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 clúster 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" }.
fleet

object (Fleet)

Es opcional. Configuración de la flota.
networking

object (ClusterNetworking)

Obligatorio. Configuración de herramientas de redes de todo el clúster.
authorization

object (Authorization)

Obligatorio. Inmutable. Es la política de RBAC que aplicará y administrará GEC.
defaultMaxPodsPerNode

integer

Es opcional. Cantidad máxima predeterminada de Pods por nodo que se usa si no se especifica de forma explícita un valor máximo para un grupo de nodos en este clúster. En tal caso, se usará el valor predeterminado de Kubernetes.
endpoint

string

Solo salida. Es la dirección IP del servidor de la API de Kubernetes.
clusterCaCertificate

string

Solo salida. Es el certificado público de la CA del clúster codificado con PEM.
maintenancePolicy

object (MaintenancePolicy)

Es opcional. Es la configuración de la política de mantenimiento de todo el clúster.
controlPlaneVersion

string

Solo salida. Versión de lanzamiento del plano de control
nodeVersion

string

Solo salida. Es la versión de lanzamiento más baja entre todos los nodos trabajadores. Este campo puede estar vacío si el clúster no tiene nodos de trabajador.

Flota

Configuración relacionada con la flota.

Las flotas son un concepto de Google Cloud que organiza los clústeres de manera lógica, lo que te permite usar y administrar capacidades de varios clústeres y aplicar políticas coherentes en tus sistemas.

Representación JSON 
{
  "project": string,
  "membership": string
}
Campos
project

string

Obligatorio. El número del proyecto host de la flota en el que se registrará este clúster.

Los nombres de los proyectos tienen el formato projects/<project-number>.
membership

string

Solo salida. El nombre del recurso de membresía del concentrador administrado asociado a este clúster.

Los nombres de las membresías tienen el formato projects/<project-number>/locations/global/membership/<cluster-id>.

ClusterNetworking

Configuración de herramientas de redes de todo el clúster.

Representación JSON 
{
  "clusterIpv4CidrBlocks": [
    string
  ],
  "servicesIpv4CidrBlocks": [
    string
  ]
}
Campos
clusterIpv4CidrBlocks[]

string

Obligatorio. A todos los pods del clúster se les asigna una dirección IPv4 RFC1918 de estos bloques. Solo se admite un bloque. No se puede cambiar este campo después de crearlo.
servicesIpv4CidrBlocks[]

string

Obligatorio. A todos los servicios del clúster se les asigna una dirección IPv4 RFC1918 de estos bloques. Solo se admite un bloque. No se puede cambiar este campo después de crearlo.

Autorización

Es la política de RBAC que aplicará y administrará GEC.

Representación JSON 
{
  "adminUsers": {
    object (ClusterUser)
  }
}
Campos
adminUsers

object (ClusterUser)

Obligatorio. Usuario al que se le otorgará el rol de administrador de clústeres, lo que le proporcionará acceso completo al clúster. Actualmente, este es un campo único, pero se expandirá para permitir varios administradores en el futuro.

ClusterUser

Es un principal de usuario para una política de RBAC.

Representación JSON 
{
  "username": string
}
Campos
username

string

Obligatorio. Un nombre de usuario de Google activo

MaintenancePolicy

Es la configuración de la política de mantenimiento.

Representación JSON 
{
  "window": {
    object (MaintenanceWindow)
  }
}
Campos
window

object (MaintenanceWindow)

Especifica el período de mantenimiento en el que se puede realizar el mantenimiento.

MaintenanceWindow

Configuración del período de mantenimiento

Representación JSON 
{
  "recurringWindow": {
    object (RecurringTimeWindow)
  }
}
Campos
recurringWindow

object (RecurringTimeWindow)

Es la configuración de un período de mantenimiento recurrente.

RecurringTimeWindow

Representa un período arbitrario que se repite.

Representación JSON 
{
  "window": {
    object (TimeWindow)
  },
  "recurrence": string
}
Campos
window

object (TimeWindow)

Es el período de la primera recurrencia.
recurrence

string

Es una RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) que indica cómo se repite este período. Se extienden durante el período comprendido entre la hora de inicio y la hora de finalización.

TimeWindow

Representa un período arbitrario.

Representación JSON 
{
  "startTime": string,
  "endTime": string
}
Campos
startTime

string (Timestamp format)

Es la hora en la que comienza el período.

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".
endTime

string (Timestamp format)

Es la fecha y hora en que finaliza el período. La hora de finalización debe ser posterior a la de inicio.

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".

Métodos

create

 Crea un clúster nuevo en un proyecto y una ubicación determinados.

delete

 Borra un solo clúster.

generateAccessToken

 Genera un token de acceso para un clúster.

get

 Obtiene detalles de un solo clúster.

list

 Enumera clústeres en una ubicación y un proyecto determinados.

patch

 Actualiza los parámetros de un solo clúster.