REST Resource: projects.locations.clusters

Recurso: Cluster

Um cluster do Kubernetes do Google Distributed Cloud Edge.

Representação 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

Obrigatório. O nome do recurso do cluster.
createTime

string (Timestamp format)

Apenas saída. O horário de criação do cluster.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Apenas saída. A hora em que o cluster foi atualizado pela última vez.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

Rótulos associados a este recurso.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
fleet

object (Fleet)

Opcional. Configuração da frota.
networking

object (ClusterNetworking)

Obrigatório. Configuração de rede em todo o cluster.
authorization

object (Authorization)

Obrigatório. Imutável. Política de RBAC que será aplicada e gerenciada pelo GEC.
defaultMaxPodsPerNode

integer

Opcional. O número máximo padrão de pods por nó usado se um valor máximo não for especificado explicitamente para um pool de nós neste cluster. Se não for especificado, o valor padrão do Kubernetes será usado.
endpoint

string

Apenas saída. O endereço IP do servidor da API Kubernetes.
clusterCaCertificate

string

Apenas saída. O certificado público codificado em PEM da CA do cluster.
maintenancePolicy

object (MaintenancePolicy)

Opcional. Configuração da política de manutenção em todo o cluster.
controlPlaneVersion

string

Apenas saída. A versão de lançamento do plano de controle
nodeVersion

string

Apenas saída. A versão de lançamento mais baixa entre todos os nós de trabalho. Esse campo pode ficar vazio se o cluster não tiver nós de trabalho.

Frota

Configuração relacionada à frota.

As frotas são um conceito do Google Cloud voltado à organização lógica de clusters. Com elas, é possível usar e gerenciar recursos de vários clusters e aplicar políticas consistentes em todos os sistemas.

Representação JSON 
{
  "project": string,
  "membership": string
}
Campos
project

string

Obrigatório. O número do projeto host da frota em que este cluster será registrado.

Os nomes de projetos são formatados como projects/<project-number>.
membership

string

Apenas saída. O nome do recurso de assinatura de hub gerenciado associado a esse cluster.

Os nomes de assinaturas são formatados como projects/<project-number>/locations/global/membership/<cluster-id>.

ClusterNetworking

Configuração de rede em todo o cluster.

Representação JSON 
{
  "clusterIpv4CidrBlocks": [
    string
  ],
  "servicesIpv4CidrBlocks": [
    string
  ]
}
Campos
clusterIpv4CidrBlocks[]

string

Obrigatório. Todos os pods no cluster recebem um endereço IPv4 RFC1918 desses blocos. Só é possível usar um bloco. Este campo não pode ser alterado após a criação.
servicesIpv4CidrBlocks[]

string

Obrigatório. Todos os serviços do cluster recebem um endereço IPv4 RFC1918 desses blocos. Só é possível usar um bloco. Este campo não pode ser alterado após a criação.

Autorização

Política de RBAC que será aplicada e gerenciada pelo GEC.

Representação JSON 
{
  "adminUsers": {
    object (ClusterUser)
  }
}
Campos
adminUsers

object (ClusterUser)

Obrigatório. Usuário que receberá o papel de administrador do cluster e terá acesso total a ele. No momento, esse é um campo único, mas será expandido para permitir vários administradores no futuro.

ClusterUser

Um principal de usuário para uma política de RBAC.

Representação JSON 
{
  "username": string
}
Campos
username

string

Obrigatório. Um nome de usuário do Google ativo.

MaintenancePolicy

Configuração da política de manutenção.

Representação JSON 
{
  "window": {
    object (MaintenanceWindow)
  }
}
Campos
window

object (MaintenanceWindow)

Especifica a janela de manutenção em que a manutenção pode ser realizada.

MaintenanceWindow

Configuração da janela de manutenção

Representação JSON 
{
  "recurringWindow": {
    object (RecurringTimeWindow)
  }
}
Campos
recurringWindow

object (RecurringTimeWindow)

Configuração de uma janela de manutenção recorrente.

RecurringTimeWindow

Representa um período arbitrário que se repete.

Representação JSON 
{
  "window": {
    object (TimeWindow)
  },
  "recurrence": string
}
Campos
window

object (TimeWindow)

O período da primeira recorrência.
recurrence

string

Uma RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) para a recorrência dessa janela. Eles duram o período entre o horário de início e término.

TimeWindow

Representa um período arbitrário.

Representação JSON 
{
  "startTime": string,
  "endTime": string
}
Campos
startTime

string (Timestamp format)

O horário em que a janela começa.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

O horário em que a janela termina. O horário de término precisa ser posterior ao horário de início.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

Métodos

create

 Cria um novo cluster em determinado projeto e local.

delete

 Exclui um único cluster.

generateAccessToken

 Gera um token de acesso para um cluster.

get

 Recebe detalhes de um único cluster.

list

 Lista os clusters em um determinado projeto e local.

patch

 Atualiza os parâmetros de um único cluster.