Package google.cloud.gkehub.v1beta1

Indice

GkeHubMembershipService

GKE Hub MembershipService gestisce la registrazione di molti cluster Kubernetes in Google Cloud, rappresentati con la risorsa Membership.

GKE Hub è attualmente disponibile nella regione globale e in tutte le regioni in https://cloud.google.com/compute/docs/regions-zones. La funzionalità è disponibile solo nella regione globale mentre l'appartenenza è una regione globale e in tutte le regioni.

La gestione delle iscrizioni potrebbe non essere banale: quando possibile, si consiglia di utilizzare una delle librerie client o degli strumenti forniti da Google quando si utilizzano le risorse per le iscrizioni.

CreateMembership

rpc CreateMembership(CreateMembershipRequest) returns (Operation)

Crea una nuova appartenenza.

Attualmente è supportato solo per i cluster GKE su Google Cloud. Per registrare altri cluster, segui le istruzioni all'indirizzo https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/registering-a-cluster.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
DeleteMembership

rpc DeleteMembership(DeleteMembershipRequest) returns (Operation)

Rimuove un'appartenenza.

Attualmente è supportato solo per i cluster GKE su Google Cloud. Per annullare la registrazione di altri cluster, segui le istruzioni all'indirizzo https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/unregistering-a-cluster.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
GenerateConnectManifest

rpc GenerateConnectManifest(GenerateConnectManifestRequest) returns (GenerateConnectManifestResponse)

Genera il manifest per il deployment dell'agente GKE Connect.

Questo metodo viene utilizzato internamente dalle librerie fornite da Google. La maggior parte dei clienti non dovrebbe dover chiamare direttamente questo metodo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
GenerateExclusivityManifest

rpc GenerateExclusivityManifest(GenerateExclusivityManifestRequest) returns (GenerateExclusivityManifestResponse)

GeneraExclusivityManifest genera i manifest per aggiornare gli artefatti di esclusività nel cluster, se necessario.

Gli artefatti di esclusività includono la definizione di risorse personalizzate (CRD) Membership e la risorsa personalizzata (CR) Membership singleton. Combinati con ConvalidaExclusivity, gli artefatti di esclusività garantiscono che un cluster Kubernetes sia registrato solo in un singolo GKE Hub.

Il CRD Membership ha il controllo delle versioni e può richiedere la conversione quando il server API GKE Hub inizia a gestire una versione più recente del CRD e della RP corrispondente. La risposta sarà la CRD e la RP convertite in caso di differenze tra le versioni.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
GetMembership

rpc GetMembership(GetMembershipRequest) returns (Membership)

Recupera i dettagli di un abbonamento.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
ListMemberships

rpc ListMemberships(ListMembershipsRequest) returns (ListMembershipsResponse)

Elenca gli abbonamenti a un progetto e a una località specifici.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
UpdateMembership

rpc UpdateMembership(UpdateMembershipRequest) returns (Operation)

Aggiorna un Abbonamento esistente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.
ValidateExclusivity

rpc ValidateExclusivity(ValidateExclusivityRequest) returns (ValidateExclusivityResponse)

ConvalidaEsclusività convalida lo stato di esclusività nel cluster. La convalida non dipende da una risorsa di appartenenza all'hub esistente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

ApplianceCluster

ApplianceCluster contiene informazioni specifiche per i cluster delle appliance GDC Edge.

Campi

Autorità

L'autorità codifica il modo in cui Google riconoscerà le identità da questa appartenenza. Per ulteriori dettagli, consulta la documentazione di Workload Identity: https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity

Campi
issuer

string

Facoltativo. Un URI dell'emittente JSON Web Token (JWT). issuer deve iniziare con https:// ed essere un URL valido con lunghezza inferiore a 2000 caratteri.

Se impostato, Google consentirà a token OIDC validi di questo emittente di autenticarsi all'interno del Workload_identity_pool. Il rilevamento OIDC verrà eseguito su questo URI per convalidare i token dell'emittente.

La cancellazione di issuer disabilita Workload Identity. issuer non può essere modificato direttamente. Devi cancellarlo (e disattivare Workload Identity) prima di utilizzare un nuovo emittente (e riattivare Workload Identity).
workload_identity_pool

string

Solo output. Il nome del pool di identità per i carichi di lavoro in cui verrà riconosciuto issuer.

Esiste un unico pool di Workload Identity per hub condiviso tra tutti gli abbonamenti che appartengono a quell'hub. Per un hub ospitato in {PROJECT_ID}, il formato del pool di carichi di lavoro è {PROJECT_ID}.hub.id.goog, anche se questo dato è soggetto a modifiche nelle versioni più recenti di questa API.
identity_provider

string

Solo output. Un provider di identità che riflette issuer nel pool di identità per i carichi di lavoro.
oidc_jwks

bytes

Facoltativo. Chiavi di verifica OIDC per questa appartenenza in formato JWKS (RFC 7517).

Se questo campo viene impostato, il rilevamento OIDC NON verrà eseguito su issuer e i token OIDC verranno convalidati utilizzando questo campo.

ConnectAgent

Le informazioni richieste dagli utenti finali per l'utilizzo di GKE Connect.

Campi
name
(deprecated)

string

Non impostare.
proxy

bytes

Facoltativo. URI di un proxy se la connettività dall'agente a gkeconnect.googleapis.com richiede l'utilizzo di un proxy. Il formato deve essere nel formato http(s)://{proxy_address}, a seconda del protocollo HTTP/HTTPS supportato dal proxy. Il traffico in uscita dell'agente di connessione verrà reindirizzato attraverso un proxy HTTP(S).
namespace

string

Facoltativo. Spazio dei nomi per le risorse dell'agente GKE Connect. Il valore predefinito è gke-connect.

L'agente Connect viene autorizzato automaticamente quando viene eseguito nello spazio dei nomi predefinito. In caso contrario, è necessario concedere un'autorizzazione esplicita con un'associazione IAM aggiuntiva.

ConnectAgentResource

ConnectAgentResource rappresenta un manifest di risorse Kubernetes per il deployment dell'agente Connect.

Campi
type

TypeMeta

Kubernetes della risorsa.
manifest

string

manifest YAML della risorsa.

CreateMembershipRequest

Messaggio di richiesta per il metodo GkeHubMembershipService.CreateMembership.

Campi
parent

string

Obbligatorio. L'elemento principale (progetto e località) in cui verranno creati gli abbonamenti. Specificato nel formato projects/*/locations/*.

L'autorizzazione richiede la seguente autorizzazione IAM per la risorsa specificata parent:

  • gkehub.memberships.create
membership_id

string

Obbligatorio. ID scelto dal cliente per l'appartenenza. membership_id deve essere un'etichetta DNS valida conforme a RFC 1123:

  1. Lunghezza massima: 63 caratteri
  2. Deve essere composto da caratteri alfanumerici minuscoli o -
  3. Deve iniziare e terminare con un carattere alfanumerico

che può essere espressa con l'espressione regolare: [a-z0-9]([-a-z0-9]*[a-z0-9])?, con una lunghezza massima di 63 caratteri.
resource

Membership

Obbligatorio. L'appartenenza da creare.
request_id

string

Facoltativo. Un ID richiesta per identificare le richieste. Specifica un ID richiesta univoco in modo che, se devi ritentare la richiesta, il server saprà che la richiesta è già stata completata. Il server lo garantirà per almeno 60 minuti dopo la prima richiesta.

Ad esempio, prendi in considerazione una situazione in cui effettui una richiesta iniziale e la richiesta scade. Se effettui di nuovo la richiesta con lo stesso ID richiesta, il server può verificare se è stata ricevuta l'operazione originale con lo stesso ID richiesta e, in questo caso, ignorerà la seconda richiesta. Questo impedisce ai client di creare accidentalmente impegni duplicati.

L'ID richiesta deve essere un UUID valido, ad eccezione del fatto che un UUID zero non è supportato (00000000-0000-0000-0000-000000000000).

DeleteMembershipRequest

Messaggio di richiesta per il metodo GkeHubMembershipService.DeleteMembership.

Campi
name

string

Obbligatorio. Il nome della risorsa Membership nel formato projects/*/locations/*/memberships/*.

L'autorizzazione richiede la seguente autorizzazione IAM per la risorsa specificata name:

  • gkehub.memberships.delete
request_id

string

Facoltativo. Un ID richiesta per identificare le richieste. Specifica un ID richiesta univoco in modo che, se devi ritentare la richiesta, il server saprà che la richiesta è già stata completata. Il server lo garantirà per almeno 60 minuti dopo la prima richiesta.

Ad esempio, prendi in considerazione una situazione in cui effettui una richiesta iniziale e la richiesta scade. Se effettui di nuovo la richiesta con lo stesso ID richiesta, il server può verificare se è stata ricevuta l'operazione originale con lo stesso ID richiesta e, in questo caso, ignorerà la seconda richiesta. Questo impedisce ai client di creare accidentalmente impegni duplicati.

L'ID richiesta deve essere un UUID valido, ad eccezione del fatto che un UUID zero non è supportato (00000000-0000-0000-0000-000000000000).
force

bool

Facoltativo. Se viene impostato su true, verranno eliminate anche tutte le sottorisorse di questa appartenenza. In caso contrario, la richiesta funzionerà solo se l'appartenenza non ha una risorsa secondaria.

EdgeCluster

EdgeCluster contiene informazioni specifiche per i cluster perimetrali di Google.

Campi

GenerateConnectManifestRequest

Messaggio di richiesta per il metodo GkeHubMembershipService.GenerateConnectManifest.

Campi
name

string

Obbligatorio. Il nome della risorsa di appartenenza a cui l'agente assocerà, nel formato projects/*/locations/*/memberships/*.

L'autorizzazione richiede la seguente autorizzazione IAM per la risorsa specificata name:

  • gkehub.memberships.generateConnectManifest
connect_agent

ConnectAgent

Facoltativo. L'agente Connect per cui generare il manifest.
version

string

Facoltativo. La versione dell'agente Connect da utilizzare. Il valore predefinito è la versione più recente.
is_upgrade

bool

Facoltativo. Se il valore è true, genera le risorse solo per l'upgrade. Alcune risorse generate solo per l'installazione (ad es. i secret) verranno escluse.
registry

string

Facoltativo. Il registro da cui recuperare l'immagine dell'agente Connect. Il valore predefinito è gcr.io/gkeconnect.
image_pull_secret_content

bytes

Facoltativo. I contenuti secret del pull dell'immagine per il registro, se non pubblici.

GenerateConnectManifestResponse

GeneraConnectManifestResponse contiene informazioni relative al file manifest per l'installazione/l'upgrade di un agente Connect.

Campi
manifest[]

ConnectAgentResource

L'elenco ordinato di risorse Kubernetes da applicare al cluster per l'installazione/l'upgrade dell'agente GKE Connect.

GenerateExclusivityManifestRequest

La richiesta per generare i manifest per gli artefatti di esclusività.

Campi
name

string

Obbligatorio. Il nome della risorsa Membership nel formato projects/*/locations/*/memberships/*.

L'autorizzazione richiede la seguente autorizzazione IAM per la risorsa specificata name:

  • gkehub.memberships.generateConnectManifest
crd_manifest

string

Facoltativo. Il manifest YAML del CRD di appartenenza recuperato da kubectl get customresourcedefinitions membership. Lascia vuoto se la risorsa non esiste.
cr_manifest

string

Facoltativo. Il manifest YAML della RP di appartenenza recuperato da kubectl get memberships membership. Lascia vuoto se la risorsa non esiste.

GenerateExclusivityManifestResponse

La risposta degli artefatti di esclusività si manifesta per il client da applicare.

Campi
crd_manifest

string

Il manifest YAML del CRD di appartenenza da applicare se è disponibile una versione più recente del CRD. Vuota se non è necessario applicare alcun aggiornamento.
cr_manifest

string

Il manifest YAML della RP di appartenenza da applicare se è disponibile una nuova versione della RP. Vuota se non è necessario applicare alcun aggiornamento.

GetMembershipRequest

Messaggio di richiesta per il metodo GkeHubMembershipService.GetMembership.

Campi
name

string

Obbligatorio. Il nome della risorsa Membership nel formato projects/*/locations/*/memberships/*.

L'autorizzazione richiede la seguente autorizzazione IAM per la risorsa specificata name:

  • gkehub.memberships.get

GkeCluster

GkeCluster contiene informazioni specifiche per i cluster GKE.

Campi
cluster_missing

bool

Solo output. Se cluster_missing è impostato, significa che il cluster GKE non esiste più nel piano di controllo GKE.

KubernetesMetadata

KubernetesMetadata fornisce metadati informativi per le iscrizioni che rappresentano i cluster Kubernetes.

Campi
kubernetes_api_server_version

string

Solo output. Stringa di versione del server API Kubernetes riportata da "/version".
node_provider_id

string

Solo output. Nodo providerID come riportato dal primo nodo nell'elenco di nodi sull'endpoint Kubernetes. Sulle piattaforme Kubernetes che supportano i cluster senza nodi (come GKE su GCP), il valore node_count sarà zero e il valore node_provider_id sarà vuoto.
node_count

int32

Solo output. Conteggio dei nodi riportato dalle risorse dei nodi Kubernetes.
vcpu_count

int32

Solo output. Numero di vCPU come riportato dalle risorse dei nodi Kubernetes.
memory_mb

int32

Solo output. La capacità di memoria totale riportata dalla somma di tutte le risorse dei nodi Kubernetes, definita in MB.
update_time

Timestamp

Solo output. L'ora dell'ultimo aggiornamento di questi dettagli. update_time è diverso da update_time a livello di Membership perché EndpointDetails viene aggiornato internamente per i consumer delle API.

KubernetesResource

KubernetesResource contiene i manifest e la configurazione YAML per l'appartenenza alle risorse Kubernetes nel cluster. Dopo CreateMembership o UpdateMembership, queste risorse devono essere applicate nuovamente nel cluster.

Campi
membership_cr_manifest

string

Solo input. La rappresentazione YAML della RP Membership. Questo campo viene ignorato per i cluster GKE in cui l'hub può leggere direttamente la RP.

I chiamanti devono fornire la RP attualmente presente nel cluster durante CreateMembership o UpdateMembership, oppure lasciare vuoto questo campo se non ne esiste nessuna. Il manifest della RP viene utilizzato per confermare che il cluster non è stato registrato con un'altra appartenenza.
membership_resources[]

ResourceManifest

Solo output. Risorse Kubernetes aggiuntive che devono essere applicate al cluster dopo la creazione dell'appartenenza e dopo ogni aggiornamento.

Questo campo viene compilato solo nella sezione Appartenenza restituita da un'operazione a lunga esecuzione riuscita da CreateMembership o UpdateMembership. Non viene compilato durante le normali richieste GetMembership o ListMemberships. Per ottenere il manifest della risorsa dopo la registrazione iniziale, il chiamante deve effettuare una chiamata UpdateMembership con una maschera di campo vuoto.
connect_resources[]

ResourceManifest

Solo output. Le risorse Kubernetes per l'installazione dell'agente GKE Connect

Questo campo viene compilato solo nella sezione Appartenenza restituita da un'operazione a lunga esecuzione riuscita da CreateMembership o UpdateMembership. Non viene compilato durante le normali richieste GetMembership o ListMemberships. Per ottenere il manifest della risorsa dopo la registrazione iniziale, il chiamante deve effettuare una chiamata UpdateMembership con una maschera di campo vuoto.
resource_options

ResourceOptions

Facoltativo. Opzioni per la generazione di risorse Kubernetes.

ListMembershipsRequest

Messaggio di richiesta per il metodo GkeHubMembershipService.ListMemberships.

Campi
parent

string

Obbligatorio. Il progetto principale (progetto e località) in cui verranno elencati gli abbonamenti. Specificato nel formato projects/*/locations/*. projects/*/locations/- iscrizione all'elenco in tutte le regioni.

L'autorizzazione richiede la seguente autorizzazione IAM per la risorsa specificata parent:

  • gkehub.memberships.list
page_size

int32

Facoltativo. Quando richiedi una "pagina" di risorse, page_size specifica il numero di risorse da restituire. Se non specificato o impostato su 0, verranno restituite tutte le risorse.
page_token

string

Facoltativo. Token restituito dalla precedente chiamata a ListMemberships, che specifica la posizione nell'elenco da cui continuare a elencare le risorse.
filter

string

Facoltativo. Elenca le iscrizioni che corrispondono all'espressione di filtro, secondo la sintassi descritta in https://google.aip.dev/160.

Esempi:

  • Il nome è bar nel progetto foo-proj e nella località global:
  name = "projects/foo-proj/locations/global/membership/bar"
  • Abbonamenti con etichetta chiamata foo:
  labels.foo:*
  • Abbonamenti con etichetta foo il cui valore è bar:
  labels.foo = bar
  • Abbonamenti nello stato DI CREAZIONE:
  state = CREATING
order_by

string

Facoltativo. Uno o più campi da confrontare e utilizzare per ordinare l'output. Visita la pagina https://google.aip.dev/132#ordering.

ListMembershipsResponse

Messaggio di risposta per il metodo GkeHubMembershipService.ListMemberships.

Campi
resources[]

Membership

L'elenco degli abbonamenti corrispondenti.
next_page_token

string

Un token per richiedere la pagina successiva di risorse dal metodo ListMemberships. Il valore di una stringa vuota indica che non ci sono altre risorse da restituire.
unreachable[]

string

Elenco di località che non è stato possibile raggiungere durante il recupero di questo elenco.

Appartenenza

L'appartenenza contiene informazioni su un cluster membro.

Campi
name

string

Solo output. Il nome completo e univoco di questa risorsa di appartenenza nel formato projects/*/locations/*/memberships/{membership_id}, impostato durante la creazione.

membership_id deve essere un'etichetta DNS valida conforme a RFC 1123:

  1. Lunghezza massima: 63 caratteri
  2. Deve essere composto da caratteri alfanumerici minuscoli o -
  3. Deve iniziare e terminare con un carattere alfanumerico

che può essere espressa con l'espressione regolare: [a-z0-9]([-a-z0-9]*[a-z0-9])?, con una lunghezza massima di 63 caratteri.
labels

map<string, string>

Facoltativo. Etichette Google Cloud per questa appartenenza.
description

string

Facoltativo. Descrizione di questo abbonamento (massimo 63 caratteri). Deve corrispondere alla regex: [a-zA-Z0-9][a-zA-Z0-9_\-\.\ ]*
state

MembershipState

Solo output. Stato della risorsa Membership.
authority

Authority

Facoltativo. Come identificare i carichi di lavoro da questa appartenenza. Per maggiori dettagli, consulta la documentazione su Workload Identity: https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity
create_time

Timestamp

Solo output. Data di creazione dell'abbonamento.
update_time

Timestamp

Solo output. Data dell'ultimo aggiornamento dell'abbonamento.
delete_time

Timestamp

Solo output. Data di eliminazione dell'abbonamento.
external_id

string

Facoltativo. Un ID generato e gestito esternamente per questa appartenenza. Questo ID può essere modificato dopo la creazione, ma questa operazione è sconsigliata. Per i cluster GKE, external_id è gestito dall'API Hub e gli aggiornamenti verranno ignorati.

L'ID deve corrispondere all'espressione regolare: [a-zA-Z0-9][a-zA-Z0-9_\-\.]*

Se questa appartenenza rappresenta un cluster Kubernetes, questo valore deve essere impostato sull'UID dell'oggetto dello spazio dei nomi kube-system.
last_connection_time

Timestamp

Solo output. Per i cluster che utilizzano Connect, il timestamp della connessione più recente stabilita con Google Cloud. Questo orario viene aggiornato a intervalli di qualche minuto, non in modo continuo. Per i cluster che non utilizzano GKE Connect o che non si sono mai connessi correttamente, questo campo non verrà impostato.
unique_id

string

Solo output. UUID generato da Google per questa risorsa. È univoco in tutte le risorse di appartenenza. Se una risorsa Membership viene eliminata e viene creata un'altra risorsa con lo stesso nome, questa riceve un unique_id diverso.
infrastructure_type

Membership.InfrastructureType

Facoltativo. Il tipo di infrastruttura su cui è in esecuzione questa appartenenza.
monitoring_config

MonitoringConfig

Facoltativo. Le informazioni sulla configurazione di monitoraggio per questa appartenenza.
Campo di unione type. Il tipo di risorsa rappresentato da questa appartenenza type può essere solo uno dei seguenti:
endpoint

MembershipEndpoint

Facoltativo. Informazioni sull'endpoint per raggiungere questo membro.

InfrastructureType

Specifica il tipo di infrastruttura di un'appartenenza. Il tipo di infrastruttura viene utilizzato dall'hub per controllare il comportamento specifico dell'infrastruttura, inclusi i prezzi.

Ogni distribuzione GKE (su Google Cloud, On-Prem, on-X ecc.) imposterà questo campo automaticamente, ma i clienti dei cluster collegati devono specificare un tipo durante la registrazione.

Enum
INFRASTRUCTURE_TYPE_UNSPECIFIED Nessun tipo specificato. Alcune funzionalità dell'hub potrebbero richiedere l'indicazione di un tipo e non supporteranno gli abbonamenti con questo valore.
ON_PREM Infrastruttura privata di proprietà o gestita dal cliente. Questo include distribuzioni GKE come GKE-OnPrem e GKE-OnBareMetal.
MULTI_CLOUD Infrastruttura cloud pubblica

MembershipEndpoint

MembershipEndpoint contiene le informazioni necessarie per contattare l'API e un endpoint Kubernetes ed eventuali metadati Kubernetes aggiuntivi.

Campi
kubernetes_metadata

KubernetesMetadata

Solo output. Metadati utili specifici per Kubernetes.
kubernetes_resource

KubernetesResource

Facoltativo. Le risorse Kubernetes nel cluster da applicare per un cluster registrato correttamente, in stato stabile. Queste risorse:

  • Assicurati che il cluster sia registrato in modo esclusivo per una sola appartenenza all'hub.
  • Propaga le informazioni del pool di carichi di lavoro disponibili nel campo Autorità di appartenenza.
  • Assicurati che le funzionalità predefinite dell'hub siano configurate all'inizio correttamente.
Campo di unione type. Informazioni sul cluster registrato. type può essere solo uno dei seguenti:
gke_cluster

GkeCluster

Facoltativo. Informazioni specifiche per un cluster GKE su Google Cloud.
on_prem_cluster

OnPremCluster

Facoltativo. Informazioni specifiche per un cluster GKE On-Prem. Un cluster utente on-prem senza resourceLink non è autorizzato a utilizzare questo campo. Dovrebbe avere invece un "type" nullo.
multi_cloud_cluster

MultiCloudCluster

Facoltativo. Informazioni specifiche per un cluster GKE multi-cloud.
edge_cluster

EdgeCluster

Facoltativo. Informazioni specifiche per un cluster Google Edge.
appliance_cluster

ApplianceCluster

Facoltativo. Informazioni specifiche per un cluster GDC Edge Appliance.

MembershipState

Stato della risorsa Membership.

Campi
code

MembershipState.Code

Solo output. Lo stato attuale della risorsa Membership.
description
(deprecated)

string

Questo campo non viene mai impostato dal servizio Hub.
update_time
(deprecated)

Timestamp

Questo campo non viene mai impostato dal servizio Hub.

Codice

Il codice descrive lo stato di una risorsa di appartenenza.

Enum
CODE_UNSPECIFIED Il codice non è impostato.
CREATING Il cluster è in fase di registrazione.
READY Il cluster è registrato.
DELETING È in corso l'annullamento della registrazione del cluster.
UPDATING L'abbonamento è in fase di aggiornamento.
SERVICE_UPDATING L'abbonamento è in fase di aggiornamento dal servizio Hub.

MonitoringConfig

MonitoringConfig informa le applicazioni/servizi/UI basati sul parco risorse in che modo le metriche per il cluster sottostante vengono segnalate ai servizi di Cloud Monitoring. Può essere impostato da vuoto a non vuoto, ma non può essere modificato direttamente per evitare di danneggiare accidentalmente la continuità delle metriche.

Campi
project_id

string

Facoltativo. Progetto utilizzato per generare report sulle metriche
location

string

Facoltativo. Posizione utilizzata per generare report sulle metriche
cluster

string

Facoltativo. Nome del cluster utilizzato per generare report sulle metriche. Per i cluster Anthos on VMWare/Baremetal/MultiCloud, il formato sarà {cluster_type}/{cluster_name}, ad esempio "awsClusters/cluster_1".
kubernetes_metrics_prefix

string

Facoltativo. Le metriche di sistema di Kubernetes, se disponibili, sono scritte con questo prefisso. Il valore predefinito è kubernetes.io per GKE e infine kubernetes.io/anthos per Anthos. Nota: oggi Anthos MultiCloud avrà il prefisso kubernetes.io, ma la migrazione verrà eseguita in kubernetes.io/anthos.
cluster_hash

string

Facoltativo. Per i cluster GKE e multi-cloud, questo è l'UUID della risorsa cluster. Per i cluster VMWare e Baremetal, si tratta dell'UID kube-system.

MultiCloudCluster

MultiCloudCluster contiene informazioni specifiche per i cluster multi-cloud GKE.

Campi
cluster_missing

bool

Solo output. Se cluster_missing è impostato, significa che la risorsa API(gkemulticloud.googleapis.com) per questo cluster GKE multi-cloud non esiste più.

OnPremCluster

OnPremCluster contiene informazioni specifiche per i cluster GKE On-Prem.

Campi
cluster_missing

bool

Solo output. Se cluster_missing è impostato, significa che la risorsa API(gkeonprem.googleapis.com) per questo cluster GKE On-Prem non esiste più.
admin_cluster

bool

Immutabile. Indica se il cluster è un cluster di amministrazione.
cluster_type

OnPremCluster.ClusterType

Immutabile. Il tipo di cluster on-prem.

ClusterType

ClusterType descrive il tipo di cluster on-prem.

Enum
CLUSTERTYPE_UNSPECIFIED ClusterType non impostato.
BOOTSTRAP ClusterType è un cluster di bootstrap.
HYBRID ClusterType è un cluster ibrido essenziale.
STANDALONE ClusterType è un cluster autonomo baretal.
USER ClusterType è un cluster utente.

OperationMetadata

Rappresenta i metadati dell'operazione a lunga esecuzione.

Campi
create_time

Timestamp

Solo output. L'ora di creazione dell'operazione.
end_time

Timestamp

Solo output. L'ora di fine dell'esecuzione dell'operazione.
target

string

Solo output. Percorso della risorsa definita dal server per la destinazione dell'operazione.
verb

string

Solo output. Nome del verbo eseguito dall'operazione.
status_detail

string

Solo output. Stato leggibile dell'operazione, se presente.
cancel_requested

bool

Solo output. Identifica se l'utente ha richiesto l'annullamento dell'operazione. Le operazioni che sono state annullate correttamente hanno il valore [Operation.error][] con un valore google.rpc.Status.code di 1, corrispondente a Code.CANCELLED.
api_version

string

Solo output. Versione API utilizzata per avviare l'operazione.

ResourceManifest

ResourceManifest rappresenta una singola risorsa Kubernetes da applicare al cluster.

Campi
manifest

string

manifest YAML della risorsa.
cluster_scoped

bool

Indica se la risorsa fornita nel manifest è cluster_scoped. Se il criterio non viene configurato, si presume che il manifest sia limitato allo spazio dei nomi.

Questo campo viene utilizzato per il mapping REST quando si applica la risorsa in un cluster.

ResourceOptions

ResourceOptions rappresenta le opzioni per la generazione di risorse Kubernetes.

Campi
connect_version

string

Facoltativo. La versione dell'agente Connect da utilizzare per connect_resources. Il valore predefinito è l'ultima versione di GKE Connect. La versione deve essere una versione attualmente supportata, le versioni obsolete verranno rifiutate.
v1beta1_crd

bool

Facoltativo. Utilizza apiextensions/v1beta1 anziché apiextensions/v1 per le risorse CustomResourceDefinition. Questa opzione deve essere impostata per i cluster con versioni dell'apiserver Kubernetes precedenti alla 1.16.
k8s_version

string

Facoltativo. Versione principale del cluster Kubernetes. Viene utilizzato solo per determinare la versione da utilizzare per le risorse CustomResourceDefinition, apiextensions/v1beta1 o apiextensions/v1.

TypeMeta

TypeMeta è le informazioni sul tipo necessarie per l'unmarshalling dei contenuti delle risorse Kubernetes nel manifest.

Campi
kind

string

Tipo della risorsa (ad es. Deployment).
api_version

string

Versione API della risorsa (ad es. v1).

UpdateMembershipRequest

Messaggio di richiesta per il metodo GkeHubMembershipService.UpdateMembership.

Campi
name

string

Obbligatorio. Il nome della risorsa di appartenenza nel formato: projects/[project_id]/locations/global/memberships/[membership_id]

L'autorizzazione richiede la seguente autorizzazione IAM per la risorsa specificata name:

  • gkehub.memberships.update
update_mask

FieldMask

Obbligatorio. Maschera dei campi da aggiornare. In questa maschera è necessario specificare almeno un percorso di campo.
resource

Membership

Obbligatorio. Vengono aggiornati solo i campi specificati in update_mask. Se specifichi un campo in update_mask, ma non ne specifichi il valore qui, il campo verrà eliminato. Se stai aggiornando un campo della mappa, imposta il valore di una chiave su una stringa nulla o vuota per eliminare la chiave dalla mappa. Non è possibile aggiornare il valore di una chiave in una stringa vuota. Se specifichi update_mask come percorso speciale "*", sostituisce completamente tutti i campi modificabili dall'utente in modo che corrispondano a resource.
request_id

string

Facoltativo. Un ID richiesta per identificare le richieste. Specifica un ID richiesta univoco in modo che, se devi ritentare la richiesta, il server saprà che la richiesta è già stata completata. Il server lo garantirà per almeno 60 minuti dopo la prima richiesta.

Ad esempio, prendi in considerazione una situazione in cui effettui una richiesta iniziale e la richiesta scade. Se effettui di nuovo la richiesta con lo stesso ID richiesta, il server può verificare se è stata ricevuta l'operazione originale con lo stesso ID richiesta e, in questo caso, ignorerà la seconda richiesta. Questo impedisce ai client di creare accidentalmente impegni duplicati.

L'ID richiesta deve essere un UUID valido, ad eccezione del fatto che un UUID zero non è supportato (00000000-0000-0000-0000-000000000000).

ValidateExclusivityRequest

La richiesta per convalidare lo stato esistente della RP di appartenenza nel cluster.

Campi
parent

string

Obbligatorio. L'elemento principale (progetto e località) in cui verranno creati gli abbonamenti. Specificato nel formato projects/*/locations/*.

L'autorizzazione richiede la seguente autorizzazione IAM per la risorsa specificata parent:

  • gkehub.memberships.generateConnectManifest
cr_manifest

string

Facoltativo. Il codice YAML della RP di appartenenza nel cluster. Vuoto se la RP di appartenenza non esiste.
intended_membership

string

Obbligatorio. Il nome dell'abbonamento previsto sotto parent. Questo metodo esegue la convalida solo in previsione di una chiamata CreateMembership con lo stesso nome.

ValidateExclusivityResponse

La risposta dello stato del risultato di convalida degli artefatti di esclusività.

Campi
status

Status

Il risultato della convalida.

  • OK significa che l'esclusività viene convalidata, supponendo che il manifest prodotto da generateExclusivityManifest venga applicato correttamente.
  • ALREADY_EXISTS indica che il CRD Membership è già di proprietà di un altro Hub. Consulta la pagina status.message per saperne di più.