REST Resource: projects.locations.clusters

Risorsa: Cluster

Un cluster Kubernetes Google Distributed Cloud Edge.

Rappresentazione 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
}
Campi
name

string

Obbligatorio. Il nome della risorsa del cluster.

createTime

string (Timestamp format)

Solo output. L'ora in cui è stato creato il cluster.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione al nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Solo output. L'ora dell'ultimo aggiornamento del cluster.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione al nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

labels

map (key: string, value: string)

Etichette associate a questa risorsa.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

fleet

object (Fleet)

Facoltativo. Configurazione del parco risorse.

networking

object (ClusterNetworking)

Obbligatorio. Configurazione del networking a livello di cluster.

authorization

object (Authorization)

Obbligatorio. Immutabile. Criterio RBAC che verrà applicato e gestito da GEC.

defaultMaxPodsPerNode

integer

Facoltativo. Il numero massimo predefinito di pod per nodo utilizzato se non è stato specificato esplicitamente un valore massimo per un pool di nodi in questo cluster. Se non specificato, verrà utilizzato il valore predefinito di Kubernetes.

endpoint

string

Solo output. L'indirizzo IP del server API Kubernetes.

clusterCaCertificate

string

Solo output. Il certificato pubblico con codifica PEM della CA del cluster.

maintenancePolicy

object (MaintenancePolicy)

Facoltativo. Configurazione della policy di manutenzione a livello di cluster.

controlPlaneVersion

string

Solo output. La versione di rilascio del control plane

nodeVersion

string

Solo output. La versione di rilascio più bassa tra tutti i nodi worker. Questo campo può essere vuoto se il cluster non ha nodi worker.

Parco risorse

Configurazione relativa al parco risorse.

I parchi risorse sono un concetto di Google Cloud per l'organizzazione logica dei cluster; ti consentono di utilizzare e gestire le funzionalità multi-cluster e di applicare criteri coerenti in tutti i tuoi sistemi.

Rappresentazione JSON
{
  "project": string,
  "membership": string
}
Campi
project

string

Obbligatorio. Il nome del progetto host del parco risorse in cui verrà registrato questo cluster.

I nomi dei progetti sono formattati come projects/<project-number>.

membership

string

Solo output. Il nome della risorsa Hub Membership gestita associata a questo cluster.

I nomi delle iscrizioni sono formattati come projects/<project-number>/locations/global/membership/<cluster-id>.

ClusterNetworking

Configurazione del networking a livello di cluster.

Rappresentazione JSON
{
  "clusterIpv4CidrBlocks": [
    string
  ],
  "servicesIpv4CidrBlocks": [
    string
  ]
}
Campi
clusterIpv4CidrBlocks[]

string

Obbligatorio. A tutti i pod del cluster viene assegnato un indirizzo IPv4 RFC1918 in questi blocchi. È supportato un solo blocco. Questo campo non può essere modificato dopo la creazione.

servicesIpv4CidrBlocks[]

string

Obbligatorio. A tutti i servizi del cluster viene assegnato un indirizzo IPv4 RFC1918 in questi blocchi. È supportato un solo blocco. Questo campo non può essere modificato dopo la creazione.

Autorizzazione

Criterio RBAC che verrà applicato e gestito da GEC.

Rappresentazione JSON
{
  "adminUsers": {
    object (ClusterUser)
  }
}
Campi
adminUsers

object (ClusterUser)

Obbligatorio. Utente a cui verrà concesso il ruolo cluster-admin, che permette di avere l'accesso completo al cluster. Al momento questo è un campo singolo, ma in futuro verrà ampliato per consentire la presenza di più amministratori.

ClusterUser

Un'entità utente per una policy RBAC.

Rappresentazione JSON
{
  "username": string
}
Campi
username

string

Obbligatorio. Un nome utente Google attivo.

MaintenancePolicy

Configurazione della policy di manutenzione.

Rappresentazione JSON
{
  "window": {
    object (MaintenanceWindow)
  }
}
Campi
window

object (MaintenanceWindow)

Specifica il periodo di manutenzione in cui può essere eseguita la manutenzione.

MaintenanceWindow

Configurazione del periodo di manutenzione

Rappresentazione JSON
{
  "recurringWindow": {
    object (RecurringTimeWindow)
  }
}
Campi
recurringWindow

object (RecurringTimeWindow)

Configurazione di un periodo di manutenzione ricorrente.

RecurringTimeWindow

Rappresenta un periodo di tempo arbitrario che si ripete.

Rappresentazione JSON
{
  "window": {
    object (TimeWindow)
  },
  "recurrence": string
}
Campi
window

object (TimeWindow)

La finestra della prima ricorrenza.

recurrence

string

Una RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) per la ricorrenza di questa finestra. Continuano per l'intervallo di tempo tra l'ora di inizio e quella di fine.

TimeWindow

Rappresenta un periodo di tempo arbitrario.

Rappresentazione JSON
{
  "startTime": string,
  "endTime": string
}
Campi
startTime

string (Timestamp format)

L'ora in cui inizia la finestra.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione al nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

L'ora in cui termina la finestra. L'ora di fine deve essere successiva all'ora di inizio.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione al nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

Metodi

create

Crea un nuovo cluster in un progetto e una località specifici.

delete

Elimina un singolo cluster.

generateAccessToken

Genera un token di accesso per un cluster.

get

Recupera i dettagli di un singolo cluster.

list

Elenca i cluster in un progetto e una località specifici.

patch

Aggiorna i parametri di un singolo cluster.