REST Resource: projects.locations.clusters

Ressource : Cluster

Cluster Kubernetes Google Distributed Cloud Edge.

Représentation 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
}
Champs
name

string

Obligatoire. Nom de ressource du cluster.
createTime

string (Timestamp format)

Uniquement en sortie. Heure à laquelle le cluster a été créé.

Code temporel au format RFC3339 UTC "Zulu", avec une précision de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Uniquement en sortie. Heure de la dernière mise à jour du cluster.

Code temporel au format RFC3339 UTC "Zulu", avec une précision de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

Libellés associés à cette ressource.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
fleet

object (Fleet)

Facultatif. Configuration du parc.
networking

object (ClusterNetworking)

Obligatoire. Configuration réseau à l'échelle du cluster.
authorization

object (Authorization)

Obligatoire. Immuable. Stratégie RBAC qui sera appliquée et gérée par GEC.
defaultMaxPodsPerNode

integer

Facultatif. Nombre maximal de pods par nœud utilisés par défaut si aucune valeur maximale n'est spécifiée explicitement pour un pool de nœuds dans ce cluster. Si rien n'est spécifié, la valeur par défaut de Kubernetes est utilisée.
endpoint

string

Uniquement en sortie. Adresse IP du serveur d'API Kubernetes.
clusterCaCertificate

string

Uniquement en sortie. Certificat public de l'autorité de certification du cluster, encodé au format PEM.
maintenancePolicy

object (MaintenancePolicy)

Facultatif. Configuration des règles de maintenance à l'échelle du cluster.
controlPlaneVersion

string

Uniquement en sortie. Version de publication du plan de contrôle
nodeVersion

string

Uniquement en sortie. Version la plus ancienne parmi tous les nœuds de calcul. Ce champ peut être vide si le cluster ne comporte aucun nœud de calcul.

Parc

Configuration liée au parc.

Les parcs sont un concept de Google Cloud permettant d'organiser de manière logique les clusters. Vous pouvez ainsi utiliser et gérer des fonctionnalités multicluster et appliquer des règles cohérentes à vos systèmes.

Représentation JSON 
{
  "project": string,
  "membership": string
}
Champs
project

string

Obligatoire. Nom du projet hôte du parc dans lequel ce cluster sera enregistré.

Les noms de projet sont au format projects/<project-number>.
membership

string

Uniquement en sortie. Nom de la ressource Hub Membership gérée associée à ce cluster.

Les noms des abonnements sont au format projects/<project-number>/locations/global/membership/<cluster-id>.

ClusterNetworking

Configuration réseau à l'échelle du cluster.

Représentation JSON 
{
  "clusterIpv4CidrBlocks": [
    string
  ],
  "servicesIpv4CidrBlocks": [
    string
  ]
}
Champs
clusterIpv4CidrBlocks[]

string

Obligatoire. Une adresse IPv4 RFC1918 de ces blocs est attribuée à chaque pod du cluster. Un seul bloc est accepté. Une fois le nœud créé, ce champ ne peut plus être modifié.
servicesIpv4CidrBlocks[]

string

Obligatoire. Une adresse IPv4 RFC1918 de ces blocs est attribuée à chaque service du cluster. Un seul bloc est accepté. Une fois le nœud créé, ce champ ne peut plus être modifié.

Autorisation

Stratégie RBAC qui sera appliquée et gérée par GEC.

Représentation JSON 
{
  "adminUsers": {
    object (ClusterUser)
  }
}
Champs
adminUsers

object (ClusterUser)

Obligatoire. Utilisateur auquel le rôle cluster-admin sera attribué sur le cluster. Il disposera d'un accès complet au cluster. Actuellement, il s'agit d'un champ unique, mais il sera étendu pour permettre à plusieurs administrateurs à l'avenir.

ClusterUser

Principal utilisateur pour une stratégie RBAC.

Représentation JSON 
{
  "username": string
}
Champs
username

string

Obligatoire. Un nom d'utilisateur Google actif.

MaintenancePolicy

Configuration de la stratégie de maintenance.

Représentation JSON 
{
  "window": {
    object (MaintenanceWindow)
  }
}
Champs
window

object (MaintenanceWindow)

Spécifie la fenêtre de maintenance au cours de laquelle la maintenance peut être effectuée.

MaintenanceWindow

Configuration de l'intervalle de maintenance

Représentation JSON 
{
  "recurringWindow": {
    object (RecurringTimeWindow)
  }
}
Champs
recurringWindow

object (RecurringTimeWindow)

Configuration d'un intervalle de maintenance récurrent.

RecurringTimeWindow

Représente une période arbitraire récurrente.

Représentation JSON 
{
  "window": {
    object (TimeWindow)
  },
  "recurrence": string
}
Champs
window

object (TimeWindow)

Période de la première récurrence.
recurrence

string

RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) pour la récurrence de cette fenêtre. Ils durent pendant la période comprise entre l'heure de début et l'heure de fin.

TimeWindow

Représente une période arbitraire.

Représentation JSON 
{
  "startTime": string,
  "endTime": string
}
Champs
startTime

string (Timestamp format)

Heure de début de la période.

Code temporel au format RFC3339 UTC "Zulu", avec une précision de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

Heure de fin de la période. L'heure de fin doit être postérieure à l'heure de début.

Code temporel au format RFC3339 UTC "Zulu", avec une précision de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

Méthodes

create

 Crée un cluster dans un projet et un emplacement donnés.

delete

 Supprime un seul cluster.

generateAccessToken

 Génère un jeton d'accès pour un cluster.

get

 Récupère les détails d'un seul cluster.

list

 Liste les clusters d'un projet et d'un emplacement donnés.

patch

 Met à jour les paramètres d'un seul cluster.