REST Resource: projects.locations.attachedClusters

Risorsa: AttachedCluster

Un cluster Anthos in esecuzione sull'infrastruttura del cliente.

Rappresentazione JSON 
{
  "name": string,
  "description": string,
  "oidcConfig": {
    object (AttachedOidcConfig)
  },
  "platformVersion": string,
  "distribution": string,
  "clusterRegion": string,
  "fleet": {
    object (Fleet)
  },
  "state": enum (State),
  "uid": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "kubernetesVersion": string,
  "annotations": {
    string: string,
    ...
  },
  "workloadIdentityConfig": {
    object (WorkloadIdentityConfig)
  },
  "loggingConfig": {
    object (LoggingConfig)
  },
  "errors": [
    {
      object (AttachedClusterError)
    }
  ],
  "authorization": {
    object (AttachedClustersAuthorization)
  },
  "monitoringConfig": {
    object (MonitoringConfig)
  },
  "proxyConfig": {
    object (AttachedProxyConfig)
  },
  "binaryAuthorization": {
    object (BinaryAuthorization)
  },
  "securityPostureConfig": {
    object (SecurityPostureConfig)
  },
  "tags": {
    string: string,
    ...
  },
  "systemComponentsConfig": {
    object (SystemComponentsConfig)
  }
}
Campi
name

string

Il nome di questa risorsa.

I nomi dei cluster sono formattati come projects/<project-number>/locations/<region>/attachedClusters/<cluster-id>.

Per ulteriori dettagli sui nomi delle risorse Google Cloud, vedi Nomi delle risorse.
description

string

Facoltativo. Una descrizione leggibile di questo cluster. Non può superare i 255 byte codificati in UTF-8.
oidcConfig

object (AttachedOidcConfig)

Obbligatorio. Configurazione di OpenID Connect (OIDC) per il cluster.
platformVersion

string

Obbligatorio. La versione della piattaforma per il cluster (ad es. 1.19.0-gke.1000).

Puoi elencare tutte le versioni supportate in una determinata regione Google Cloud chiamando locations.getAttachedServerConfig.
distribution

string

Obbligatorio. La distribuzione Kubernetes del cluster collegato sottostante.

Valori supportati: ["eks", "aks", "generic"].
clusterRegion

string

Solo output. La regione in cui viene eseguito questo cluster.

Per i cluster EKS, si tratta di una regione AWS. Per i cluster AKS, si tratta di una regione Azure.
fleet

object (Fleet)

Obbligatorio. Configurazione del parco risorse.
state

enum (State)

Solo output. Lo stato attuale del cluster.
uid

string

Solo output. Un identificatore univoco globale per il cluster.
reconciling

boolean

Solo output. Se impostato, al momento sono in corso modifiche al cluster.
createTime

string (Timestamp format)

Solo output. L'ora in cui è stato registrato questo cluster.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. L'ora dell'ultimo aggiornamento di questo cluster.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
etag

string

Consente ai client di eseguire operazioni di lettura-modifica-scrittura coerenti tramite controllo della contemporaneità ottimistico.

Può essere inviato nelle richieste di aggiornamento ed eliminazione per garantire che il client disponga di un valore aggiornato prima di procedere.
kubernetesVersion

string

Solo output. La versione di Kubernetes del cluster.
annotations

map (key: string, value: string)

Facoltativo. Annotazioni sul cluster.

Questo campo ha le stesse limitazioni delle annotazioni Kubernetes. La dimensione totale di tutte le chiavi e i valori combinati è limitata a 256 kB. La chiave può avere due segmenti: prefisso (facoltativo) e nome (obbligatorio), separati da una barra (/). Il prefisso deve essere un sottodominio DNS. Il nome deve avere una lunghezza massima di 63 caratteri, deve iniziare e terminare con caratteri alfanumerici e può comprendere trattini (-), trattini bassi (_), punti (.) e caratteri alfanumerici.

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

object (WorkloadIdentityConfig)

Solo output. Impostazioni di Workload Identity.
loggingConfig

object (LoggingConfig)

Facoltativo. Configurazione della registrazione per questo cluster.
errors[]

object (AttachedClusterError)

Solo output. Un insieme di errori trovati nel cluster.
authorization

object (AttachedClustersAuthorization)

Facoltativo. Configurazione relativa alle impostazioni RBAC del cluster.
monitoringConfig

object (MonitoringConfig)

Facoltativo. Configurazione del monitoraggio per questo cluster.
proxyConfig

object (AttachedProxyConfig)

Facoltativo. Configurazione del proxy per il traffico HTTP(S) in uscita.
binaryAuthorization

object (BinaryAuthorization)

Facoltativo. Configurazione di Autorizzazione binaria per questo cluster.
securityPostureConfig

object (SecurityPostureConfig)

Facoltativo. Configurazione della security posture per questo cluster.
tags

map (key: string, value: string)

Facoltativo. Solo input. Chiavi e valori dei tag associati direttamente a questa risorsa.

La chiave tag deve essere specificata nel formato <tag namespace>/<tag key name>,, dove lo spazio dei nomi del tag è l'ID dell'organizzazione o il nome del progetto in cui è definita la chiave tag. Il nome breve di una chiave o di un valore del tag può avere una lunghezza massima di 256 caratteri. Il set di caratteri consentito per il nome breve include i caratteri Unicode codificati in UTF-8, ad eccezione di virgolette singole ('), virgolette doppie ("), barre rovesciate (\) e barre dirette (/).

Per ulteriori dettagli sui tag di Google Cloud Platform, consulta Tag.

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

object (SystemComponentsConfig)

Facoltativo. Configurazioni Kubernetes per i componenti installati automaticamente sul cluster.

AttachedOidcConfig

Informazioni di rilevamento OIDC del cluster di destinazione.

I token dell'account di servizio Kubernetes (KSA) sono token JWT firmati dal server API del cluster. Questi campi indicano in che modo i servizi Google Cloud Platform convalidano i token KSA per consentire ai carichi di lavoro di sistema (come GKE Connect e gli agenti di telemetria) di autenticarsi nuovamente su Google Cloud Platform.

Sono supportati entrambi i cluster con URL dell'emittente pubblici e privati. I cluster con emittenti pubblici devono specificare solo il campo issuerUrl, mentre i cluster con emittenti privati devono fornire sia issuerUrl sia oidc_jwks.

Rappresentazione JSON 
{
  "issuerUrl": string,
  "jwks": string
}
Campi
issuerUrl

string

URI dell'emittente di un JSON Web Token (JWT). issuer deve iniziare con https://.
jwks

string (bytes format)

Facoltativo. Chiavi di verifica OIDC in formato JWKS (RFC 7517). Contiene un elenco di chiavi di verifica OIDC che possono essere utilizzate per verificare i JWT OIDC.

Questo campo è obbligatorio per il cluster che non dispone di un endpoint di rilevamento disponibile pubblicamente. Se fornito, verrà utilizzato direttamente per verificare il JWT OIDC asserito dal provider di identità.

Una stringa con codifica Base64.

Stato

Lo stato del ciclo di vita del cluster.

Enum
STATE_UNSPECIFIED Non impostato.
PROVISIONING Lo stato PROVISIONING indica che il cluster è in fase di registrazione.
RUNNING Lo stato RUNNING indica che il cluster è stato registrato ed è completamente utilizzabile.
RECONCILING Lo stato RECONCILING indica che sul cluster è in corso un'attività, ad esempio l'upgrade dei componenti software.
STOPPING Lo stato STOPPING indica che il cluster è in fase di annullamento della registrazione.
ERROR Lo stato ERROR indica che il cluster è in uno stato non funzionante e non recuperabile.
DEGRADED Lo stato DEGRADED indica che il cluster richiede un'azione da parte dell'utente per ripristinare la funzionalità completa.

AttachedClusterError

AttachedClusterError descrive gli errori rilevati nei cluster collegati.

Rappresentazione JSON 
{
  "message": string
}
Campi
message

string

Descrizione dell'errore di facile comprensione.

AttachedClustersAuthorization

Configurazione relativa alle impostazioni RBAC del cluster.

Rappresentazione JSON 
{
  "adminUsers": [
    {
      object (AttachedClusterUser)
    }
  ],
  "adminGroups": [
    {
      object (AttachedClusterGroup)
    }
  ]
}
Campi
adminUsers[]

object (AttachedClusterUser)

Facoltativo. Utenti che possono eseguire operazioni come amministratore del cluster. Verrà creato un ClusterRoleBinding gestito per concedere il ClusterRole cluster-admin agli utenti. È possibile fornire fino a dieci utenti amministratori.

Per saperne di più su RBAC, visita la pagina https://kubernetes.io/docs/reference/access-authn-authz/rbac/#user-facing-roles.
adminGroups[]

object (AttachedClusterGroup)

Facoltativo. Gruppi di utenti che possono eseguire operazioni come amministratore del cluster. Verrà creato un ClusterRoleBinding gestito per concedere il ClusterRole cluster-admin ai gruppi. Puoi fornire fino a 10 gruppi di amministratori.

Per saperne di più su RBAC, visita la pagina https://kubernetes.io/docs/reference/access-authn-authz/rbac/#user-facing-roles.

AttachedClusterUser

Identità di un soggetto di tipo utente per i cluster collegati.

Rappresentazione JSON 
{
  "username": string
}
Campi
username

string

Obbligatorio. Il nome dell'utente, ad es. [email protected].

AttachedClusterGroup

Identità di un soggetto di tipo gruppo per i cluster collegati.

Rappresentazione JSON 
{
  "group": string
}
Campi
group

string

Obbligatorio. Il nome del gruppo, ad es. [email protected].

AttachedProxyConfig

Dettagli di una configurazione proxy.

Rappresentazione JSON 
{
  "kubernetesSecret": {
    object (KubernetesSecret)
  }
}
Campi
kubernetesSecret

object (KubernetesSecret)

La risorsa Kubernetes Secret che contiene la configurazione del proxy HTTP(S). Il secret deve essere una configurazione proxy codificata in formato JSON, come descritto all'indirizzo https://cloud.google.com/kubernetes-engine/multi-cloud/docs/attached/eks/how-to/use-a-proxy#configure-proxy-support per i cluster EKS e all'indirizzo https://cloud.google.com/kubernetes-engine/multi-cloud/docs/attached/aks/how-to/use-a-proxy#configure-proxy-support per i cluster AKS.

KubernetesSecret

Informazioni su un secret Kubernetes

Rappresentazione JSON 
{
  "name": string,
  "namespace": string
}
Campi
name

string

Nome del secret Kubernetes.
namespace

string

Lo spazio dei nomi in cui è archiviato il secret di Kubernetes.

SecurityPostureConfig

SecurityPostureConfig definisce i flag necessari per attivare/disattivare le funzionalità per l'API Security Posture.

Rappresentazione JSON 
{
  "vulnerabilityMode": enum (VulnerabilityMode)
}
Campi
vulnerabilityMode

enum (VulnerabilityMode)

Imposta la modalità da utilizzare per l'analisi delle vulnerabilità.

VulnerabilityMode

VulnerabilityMode definisce la modalità di attivazione per l'analisi delle vulnerabilità.

Enum
VULNERABILITY_MODE_UNSPECIFIED Valore predefinito non specificato.
VULNERABILITY_DISABLED Disabilita l'analisi delle vulnerabilità sul cluster.
VULNERABILITY_ENTERPRISE Applica la vulnerabilità della postura di sicurezza alle funzionalità a livello di cluster Enterprise.

SystemComponentsConfig

SystemComponentsConfig definisce i campi per personalizzare le configurazioni per i componenti installati automaticamente.

Rappresentazione JSON 
{
  "tolerations": [
    {
      object (Toleration)
    }
  ],
  "labels": [
    {
      object (Label)
    }
  ]
}
Campi
tolerations[]

object (Toleration)

Imposta tolleranze personalizzate per i pod creati dai componenti installati automaticamente.
labels[]

object (Label)

Imposta etichette personalizzate per i pod creati dai componenti installati automaticamente.

Tolleranza

La tolleranza definisce i campi per le tolleranze per i pod creati dai componenti installati automaticamente.

Rappresentazione JSON 
{
  "key": string,
  "value": string,
  "keyOperator": enum (KeyOperator),
  "effect": enum (Effect)
}
Campi
key

string

Key è la chiave di incompatibilità a cui si applica la tolleranza.
value

string

Value è il valore di incompatibilità a cui si applica la tolleranza.
keyOperator

enum (KeyOperator)

KeyOperator rappresenta la relazione di una chiave con il valore, ad esempio "Exist".
effect

enum (Effect)

L'effetto indica l'effetto di contaminazione da abbinare, ad esempio "NoSchedule"

KeyOperator

KeyOperator rappresenta la relazione di una chiave con il valore, ad esempio "Equal".

Enum
KEY_OPERATOR_UNSPECIFIED L'operatore non è specificato.
KEY_OPERATOR_EQUAL L'operatore è mappato a "Uguale".
KEY_OPERATOR_EXISTS L'operatore è mappato a "Esiste".

Effetto

Effect indica l'effetto di contaminazione da abbinare, ad esempio "NoSchedule".

Enum
EFFECT_UNSPECIFIED L'effetto non è specificato.
EFFECT_NO_SCHEDULE L'effetto corrisponde a "NoSchedule".
EFFECT_PREFER_NO_SCHEDULE L'effetto corrisponde a "PreferNoSchedule".
EFFECT_NO_EXECUTE L'effetto viene mappato su "NoExecute".

Etichetta

L'etichetta definisce i campi aggiuntivi per le etichette dei pod creati dai componenti installati automaticamente.

Rappresentazione JSON 
{
  "key": string,
  "value": string
}
Campi
key

string

Questa è la chiave dell'etichetta.
value

string

Questo è il valore dell'etichetta.

Metodi

create

 Crea una nuova risorsa AttachedCluster in un determinato progetto e regione Google Cloud Platform.

delete

 Elimina una risorsa AttachedCluster specifica.

generateAttachedClusterAgentToken

 Genera un token di accesso per un agente del cluster.

get

 Descrive una risorsa AttachedCluster specifica.

import

 L'importazione crea una nuova risorsa AttachedCluster importando una risorsa Abbonamento al parco risorse esistente.

list

 Elenca tutte le risorse AttachedCluster in un determinato progetto Google Cloud e in una determinata regione.

patch

 Aggiorna un AttachedCluster.