Package google.cloud.edgecontainer.v1

Indice

EdgeContainer

L'API EdgeContainer fornisce la gestione dei cluster Kubernetes nei deployment di Google Edge Cloud.

CreateCluster

rpc CreateCluster(CreateClusterRequest) returns (Operation)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
CreateNodePool

rpc CreateNodePool(CreateNodePoolRequest) returns (Operation)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
CreateVpnConnection

rpc CreateVpnConnection(CreateVpnConnectionRequest) returns (Operation)

Crea una nuova connessione VPN in un progetto e una località specifici.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
DeleteCluster

rpc DeleteCluster(DeleteClusterRequest) returns (Operation)

Elimina un singolo cluster.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
DeleteNodePool

rpc DeleteNodePool(DeleteNodePoolRequest) returns (Operation)

Elimina un singolo NodePool.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
DeleteVpnConnection

rpc DeleteVpnConnection(DeleteVpnConnectionRequest) returns (Operation)

Elimina una singola connessione VPN.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
GenerateAccessToken

rpc GenerateAccessToken(GenerateAccessTokenRequest) returns (GenerateAccessTokenResponse)

Genera un token di accesso per un cluster.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
GenerateOfflineCredential

rpc GenerateOfflineCredential(GenerateOfflineCredentialRequest) returns (GenerateOfflineCredentialResponse)

Genera una credenziale offline per un cluster.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
GetCluster

rpc GetCluster(GetClusterRequest) returns (Cluster)

Recupera i dettagli di un singolo cluster.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
GetMachine

rpc GetMachine(GetMachineRequest) returns (Machine)

Recupera i dettagli di una singola macchina.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
GetNodePool

rpc GetNodePool(GetNodePoolRequest) returns (NodePool)

Recupera i dettagli di un singolo NodePool.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
GetServerConfig

rpc GetServerConfig(GetServerConfigRequest) returns (ServerConfig)

Recupera la configurazione del server.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
GetVpnConnection

rpc GetVpnConnection(GetVpnConnectionRequest) returns (VpnConnection)

Recupera i dettagli di una singola connessione VPN.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
ListClusters

rpc ListClusters(ListClustersRequest) returns (ListClustersResponse)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
ListMachines

rpc ListMachines(ListMachinesRequest) returns (ListMachinesResponse)

Elenca le macchine in un progetto e una località specifici.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
ListNodePools

rpc ListNodePools(ListNodePoolsRequest) returns (ListNodePoolsResponse)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
ListVpnConnections

rpc ListVpnConnections(ListVpnConnectionsRequest) returns (ListVpnConnectionsResponse)

Elenca le connessioni VPN in un progetto e una località specifici.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
UpdateCluster

rpc UpdateCluster(UpdateClusterRequest) returns (Operation)

Aggiorna i parametri di un singolo cluster.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
UpdateNodePool

rpc UpdateNodePool(UpdateNodePoolRequest) returns (Operation)

Aggiorna i parametri di un singolo node pool.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.
UpgradeCluster

rpc UpgradeCluster(UpgradeClusterRequest) returns (Operation)

Esegue l'upgrade di un singolo cluster.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta Panoramica dell'autenticazione.

Autorizzazione

Criterio RBAC che verrà applicato e gestito da GEC.

Campi
admin_users

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.

ChannelConfig

Configurazione per un canale di rilascio.

Campi
default_version

string

Solo output. Versione predefinita per questo canale di rilascio, ad esempio: "1.4.0".

Cluster

Un cluster Kubernetes Google Distributed Cloud Edge.

Campi
name

string

Obbligatorio. Il nome della risorsa del cluster.
create_time

Timestamp

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

Timestamp

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

map<string, string>

Etichette associate a questa risorsa.
fleet

Fleet

Obbligatorio. Configurazione del parco risorse.
networking

ClusterNetworking

Obbligatorio. Configurazione del networking a livello di cluster.
authorization

Authorization

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

int32

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.
port

int32

Solo output. Il numero di porta del server API Kubernetes.
cluster_ca_certificate

string

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

MaintenancePolicy

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

string

Solo output. La versione di rilascio del control plane
node_version

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.
control_plane

ControlPlane

Facoltativo. La configurazione del control plane del cluster.
system_addons_config

SystemAddonsConfig

Facoltativo. La configurazione dei componenti aggiuntivi di sistema.
external_load_balancer_ipv4_address_pools[]

string

Facoltativo. Pool di indirizzi IPv4 per il bilanciamento del carico esterno del piano dati del cluster.
control_plane_encryption

ControlPlaneEncryption

Facoltativo. Opzioni di crittografia del disco del control plane remoto. Questo campo viene utilizzato solo quando viene attivato il supporto di CMEK.
status

Status

Solo output. Lo stato attuale del cluster.
maintenance_events[]

MaintenanceEvent

Solo output. Tutti gli eventi di manutenzione pianificati per il cluster, inclusi quelli in corso, pianificati per il futuro e completati in passato (fino a 90 giorni).
target_version

string

Facoltativo. La versione del cluster di destinazione. Ad esempio: "1.5.0".
release_channel

ReleaseChannel

Facoltativo. Il canale di rilascio a cui è iscritto un cluster.
survivability_config

SurvivabilityConfig

Facoltativo. Configurazione della sopravvivenza del cluster, ad esempio per il caso in cui la connettività di rete viene persa. Nota: questo vale solo per i cluster del control plane locale.
external_load_balancer_ipv6_address_pools[]

string

Facoltativo. Pool di indirizzi IPv6 per il bilanciamento del carico esterno del piano dati del cluster.
connection_state

ConnectionState

Solo output. Lo stato attuale della connessione del cluster.

ConnectionState

ConnectionState contiene lo stato attuale della connessione dal cluster a Google.

Campi
state

State

Solo output. Lo stato attuale della connessione.
update_time

Timestamp

Solo output. L'ora dell'ultima modifica dello stato della connessione.

Stato

Lo stato della connessione.

Enum
STATE_UNSPECIFIED Stato della connessione sconosciuto.
DISCONNECTED Questo cluster è attualmente disconnesso da Google.
CONNECTED Questo cluster è attualmente connesso a Google.
CONNECTED_AND_SYNCING Questo cluster è attualmente connesso a Google, ma potrebbe essersi riconnesso di recente dopo una disconnessione. La sincronizzazione è ancora in corso.

ControlPlane

Configurazione del control plane del cluster.

Campi

Campo unione config.

config può essere solo uno dei seguenti tipi:
remote

Remote

Configurazione del control plane remoto.
local

Local

Configurazione del control plane locale.

Avviso: i cluster del control plane locale devono essere creati nel proprio progetto. I cluster del piano di controllo locale non possono coesistere nello stesso progetto con altri tipi di cluster, inclusi i cluster non GDCE. La combinazione di cluster GDCE del control plane locale con qualsiasi altro tipo di cluster nello stesso progetto può causare la perdita di dati.

Locale

Configurazione specifica per i cluster con un control plane ospitato localmente.

Avviso: i cluster del control plane locale devono essere creati nel proprio progetto. I cluster del piano di controllo locale non possono coesistere nello stesso progetto con altri tipi di cluster, inclusi i cluster non GDCE. La combinazione di cluster GDCE del control plane locale con qualsiasi altro tipo di cluster nello stesso progetto può causare la perdita di dati.

Campi
node_location

string

Nome delle zone Google Distributed Cloud Edge in cui verrà creato questo pool di nodi. Ad esempio: us-central1-edge-customer-a.
node_count

int32

Il numero di nodi che fungono da repliche del control plane.
machine_filter

string

Solo le macchine che corrispondono a questo filtro potranno ospitare i nodi del control plane. Il linguaggio di filtraggio accetta stringhe come "name=" ed è documentato qui: AIP-160.
shared_deployment_policy

SharedDeploymentPolicy

Configurazione dei criteri relativi alla modalità di deployment delle applicazioni utente.

Remoto

Questo tipo non contiene campi.

Configurazione specifica per i cluster con un control plane ospitato da remoto.

SharedDeploymentPolicy

Rappresenta la configurazione dei criteri relativi alla modalità di deployment delle applicazioni utente.

Enum
SHARED_DEPLOYMENT_POLICY_UNSPECIFIED Non specificato.
ALLOWED Le applicazioni utente possono essere implementate sia sul control plane sia sui nodi worker.
DISALLOWED Le applicazioni utente non possono essere implementate sui nodi del control plane e possono essere implementate solo sui nodi worker.

ControlPlaneEncryption

Configurazione per il supporto della chiave KMS gestita dal cliente per i nodi del control plane.

Campi
kms_key

string

Facoltativo. La chiave di crittografia Cloud KMS, ad esempio projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}, da utilizzare per proteggere i dischi del control plane. Se non specificata, verrà utilizzata una chiave gestita da Google.
kms_key_active_version

string

Solo output. La CryptoKeyVersion di Cloud KMS attualmente in uso per proteggere i dischi del control plane. Applicabile solo se è impostata kms_key.
kms_key_state

KmsKeyState

Solo output. Disponibilità della chiave di crittografia Cloud KMS. In caso contrario, i nodi potrebbero andare offline perché non possono accedere ai dati locali.KEY_AVAILABLE Ciò può essere dovuto alla mancanza di autorizzazioni per utilizzare la chiave o alla disattivazione o eliminazione della chiave.
kms_status

Status

Solo output. Stato di errore restituito da Cloud KMS quando viene utilizzata questa chiave. Questo campo può essere compilato solo se kms_key_state non è KMS_KEY_STATE_KEY_AVAILABLE. Se compilato, questo campo contiene lo stato di errore segnalato da Cloud KMS.

MaintenanceEvent

Un evento di manutenzione è un'operazione che potrebbe causare interruzioni temporanee ai workload del cluster, inclusi gli upgrade del cluster basati su Google o avviati dall'utente, le modifiche alla configurazione del cluster avviate dall'utente che richiedono il riavvio dei nodi e così via.

Campi
uuid

string

Solo output. UUID dell'evento di manutenzione.
target_version

string

Solo output. La versione di destinazione del cluster.
operation

string

Solo output. L'operazione per l'esecuzione dell'evento di manutenzione. Specificato nel formato projects/*/locations/*/operations/*. Se l'evento di manutenzione è suddiviso in più operazioni (ad es. a causa di finestre di manutenzione), viene registrata l'ultima.
type

Type

Solo output. Il tipo di evento di manutenzione.
schedule

Schedule

Solo output. La pianificazione dell'evento di manutenzione.
state

State

Solo output. Lo stato dell'evento di manutenzione.
create_time

Timestamp

Solo output. L'ora in cui è stata creata la richiesta di evento di manutenzione.
start_time

Timestamp

Solo output. L'ora in cui è iniziato l'evento di manutenzione.
end_time

Timestamp

Solo output. L'ora in cui l'evento di manutenzione è terminato, correttamente o meno. Se l'evento di manutenzione è suddiviso in più finestre di manutenzione, end_time viene aggiornato solo al termine dell'intero flusso.
update_time

Timestamp

Solo output. L'ora in cui è stato aggiornato il messaggio dell'evento di manutenzione.

Pianifica

Indica quando deve essere eseguito l'evento di manutenzione.

Enum
SCHEDULE_UNSPECIFIED Non specificato.
IMMEDIATELY Subito dopo aver ricevuto la richiesta.

Stato

Indica lo stato dell'evento di manutenzione.

Enum
STATE_UNSPECIFIED Non specificato.
RECONCILING L'evento di manutenzione è in corso. Il cluster potrebbe essere inutilizzabile.
SUCCEEDED L'evento di manutenzione è riuscito.
FAILED L'evento di manutenzione non è riuscito.

Tipo

Indica il tipo di evento di manutenzione.

Enum
TYPE_UNSPECIFIED Non specificato.
USER_INITIATED_UPGRADE Upgrade avviato dagli utenti.
GOOGLE_DRIVEN_UPGRADE Upgrade gestito da Google.

ReleaseChannel

Il canale di rilascio a cui è iscritto un cluster.

Enum
RELEASE_CHANNEL_UNSPECIFIED Canale di rilascio non specificato. Per impostazione predefinita, verrà selezionato il canale REGULAR.
NONE Nessun canale di rilascio.
REGULAR Canale di rilascio regolare.

Stato

Indica lo stato del cluster.

Enum
STATUS_UNSPECIFIED Stato sconosciuto.
PROVISIONING Il cluster è in fase di creazione.
RUNNING Il cluster è stato creato ed è completamente utilizzabile.
DELETING Il cluster è in fase di eliminazione.
ERROR Lo stato indica che si sono verificati alcuni errori durante la riconciliazione/l'eliminazione del cluster.
RECONCILING Il cluster è in fase di aggiornamento, ad esempio degli upgrade di versione.

SurvivabilityConfig

Configurazione della sopravvivenza del cluster, ad esempio per il caso in cui la connettività di rete viene persa.

Campi
offline_reboot_ttl

Duration

Facoltativo. Periodo di tempo che consente il riavvio dei nodi del cluster e il loro funzionamento senza connettività di rete a Google. Il valore predefinito 0 significa che non è consentito. Il periodo di tempo massimo è 7 giorni.

SystemAddonsConfig

Configurazione che i clienti possono definire per i componenti aggiuntivi di sistema GDCE.

Campi
ingress

Ingress

Facoltativo. Configurazione per Ingress.
vm_service_config

VMServiceConfig

Facoltativo. Configurazione per il servizio VM.

In entrata

Configurazione del componente aggiuntivo Ingress, che consente ai clienti di creare un oggetto Ingress per gestire l'accesso esterno ai server in un cluster. Il componente aggiuntivo è costituito da istiod e istio-ingress.

Campi
disabled

bool

Facoltativo. Indica se Ingress è disabilitato.
ipv4_vip

string

Facoltativo. VIP in entrata.

VMServiceConfig

VMServiceConfig definisce la configurazione per il servizio VM GDCE.

Campi
vmm_enabled

bool

Facoltativo. Indica se VMM è abilitato.

ClusterNetworking

Configurazione del networking a livello di cluster.

Campi
cluster_ipv4_cidr_blocks[]

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.
services_ipv4_cidr_blocks[]

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.

ClusterUser

Un'entità utente per una policy RBAC.

Campi
username

string

Obbligatorio. Un nome utente Google attivo.

CreateClusterRequest

Crea un cluster.

Campi
parent

string

Obbligatorio. La località principale in cui verrà creato questo cluster.

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

  • edgecontainer.clusters.create
cluster_id

string

Obbligatorio. Un identificatore univoco specificato dal client per il cluster.
cluster

Cluster

Obbligatorio. Il cluster da creare.
request_id

string

Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito request_id.

CreateNodePoolRequest

Crea un pool di nodi.

Campi
parent

string

Obbligatorio. Il cluster padre in cui verrà creato questo pool di nodi.

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

  • edgecontainer.nodePools.create
node_pool_id

string

Obbligatorio. Un identificatore univoco specificato dal client per il pool di nodi.
node_pool

NodePool

Obbligatorio. Il pool di nodi da creare.
request_id

string

Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito request_id.

CreateVpnConnectionRequest

Crea una connessione VPN.

Campi
parent

string

Obbligatorio. La località principale in cui verrà creata questa connessione VPN.

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

  • edgecontainer.vpnConnections.create
vpn_connection_id

string

Obbligatorio. L'identificatore della connessione VPN.
vpn_connection

VpnConnection

Obbligatorio. La connessione VPN da creare.
request_id

string

Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito request_id.

DeleteClusterRequest

Elimina un cluster.

Campi
name

string

Obbligatorio. Il nome della risorsa del cluster.

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

  • edgecontainer.clusters.delete
request_id

string

Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito request_id.

DeleteNodePoolRequest

Elimina un pool di nodi.

Campi
name

string

Obbligatorio. Il nome della risorsa del pool di nodi.

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

  • edgecontainer.nodePools.delete
request_id

string

Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito request_id.

DeleteVpnConnectionRequest

Elimina una connessione VPN.

Campi
name

string

Obbligatorio. Il nome della risorsa della connessione VPN.

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

  • edgecontainer.vpnConnections.delete
request_id

string

Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito request_id.

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.

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>.

GenerateAccessTokenRequest

Genera un token di accesso per un cluster.

Campi
cluster

string

Obbligatorio. Il nome della risorsa del cluster.

L'autorizzazione richiede il seguente permesso IAM per la risorsa cluster specificata:

  • edgecontainer.clusters.get

GenerateAccessTokenResponse

Un token di accesso per un cluster.

Campi
access_token

string

Solo output. Token di accesso per l'autenticazione al server API k8s.
expire_time

Timestamp

Solo output. Timestamp in corrispondenza del quale il token scadrà.

GenerateOfflineCredentialRequest

Genera una credenziale offline per un cluster.

Campi
cluster

string

Obbligatorio. Il nome della risorsa del cluster.

L'autorizzazione richiede il seguente permesso IAM per la risorsa cluster specificata:

  • edgecontainer.clusters.get

GenerateOfflineCredentialResponse

Una credenziale offline per un cluster.

Campi
client_certificate

string

Solo output. Certificato client per l'autenticazione al server API k8s.
client_key

string

Solo output. Chiave privata del client per l'autenticazione con l'API server k8s.
user_id

string

Solo output. L'identità del cliente.
expire_time

Timestamp

Solo output. Timestamp in cui questa credenziale scadrà.

GetClusterRequest

Recupera un cluster.

Campi
name

string

Obbligatorio. Il nome della risorsa del cluster.

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

  • edgecontainer.clusters.get

GetMachineRequest

Acquista una macchina.

Campi
name

string

Obbligatorio. Il nome della risorsa della macchina.

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

  • edgecontainer.machines.get

GetNodePoolRequest

Recupera un pool di nodi.

Campi
name

string

Obbligatorio. Il nome della risorsa del pool di nodi.

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

  • edgecontainer.nodePools.get

GetServerConfigRequest

Recupera la configurazione del server.

Campi
name

string

Obbligatorio. Il nome (progetto e località) della configurazione del server da recuperare, specificato nel formato projects/*/locations/*.

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

  • edgecontainer.serverConfig.get

GetVpnConnectionRequest

Ottiene una connessione VPN.

Campi
name

string

Obbligatorio. Il nome della risorsa della connessione VPN.

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

  • edgecontainer.vpnConnections.get

KmsKeyState

Rappresenta lo stato di accessibilità di una chiave KMS gestita dal cliente utilizzata per l'integrazione di CMEK.

Enum
KMS_KEY_STATE_UNSPECIFIED Non specificato.
KMS_KEY_STATE_KEY_AVAILABLE La chiave è disponibile per l'uso e le risorse dipendenti devono essere accessibili.
KMS_KEY_STATE_KEY_UNAVAILABLE La chiave non è disponibile per un motivo non specificato. Le risorse dipendenti potrebbero essere inaccessibili.

ListClustersRequest

Elenca i cluster in una località.

Campi
parent

string

Obbligatorio. La località principale, proprietaria di questa raccolta di cluster.

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

  • edgecontainer.clusters.list
page_size

int32

Il numero massimo di risorse da elencare.
page_token

string

Un token di pagina ricevuto dalla precedente richiesta di elenco. Un token di pagina ricevuto dalla precedente richiesta di elenco.
filter

string

Verranno elencate solo le risorse che corrispondono a questo filtro.
order_by

string

Specifica l'ordine in cui verranno elencate le risorse.

ListClustersResponse

Elenco dei cluster in una località.

Campi
clusters[]

Cluster

Cluster nella località.
next_page_token

string

Un token per recuperare la pagina dei risultati successiva.
unreachable[]

string

Località non raggiungibili.

ListMachinesRequest

Elenca le macchine in un sito.

Campi
parent

string

Obbligatorio. Il sito principale, proprietario di questa raccolta di macchine.

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

  • edgecontainer.machines.list
page_size

int32

Il numero massimo di risorse da elencare.
page_token

string

Un token di pagina ricevuto dalla precedente richiesta di elenco.
filter

string

Verranno elencate solo le risorse che corrispondono a questo filtro.
order_by

string

Specifica l'ordine in cui verranno elencate le risorse.

ListMachinesResponse

Elenco delle macchine in un sito.

Campi
machines[]

Machine

Macchine nel sito.
next_page_token

string

Un token per recuperare la pagina dei risultati successiva.
unreachable[]

string

Località non raggiungibili.

ListNodePoolsRequest

Elenca i pool di nodi in un cluster.

Campi
parent

string

Obbligatorio. Il cluster principale, proprietario di questa raccolta di pool di nodi.

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

  • edgecontainer.nodePools.list
page_size

int32

Il numero massimo di risorse da elencare.
page_token

string

Un token di pagina ricevuto dalla precedente richiesta di elenco.
filter

string

Verranno elencate solo le risorse che corrispondono a questo filtro.
order_by

string

Specifica l'ordine in cui verranno elencate le risorse.

ListNodePoolsResponse

Elenco dei node pool in un cluster.

Campi
node_pools[]

NodePool

I node pool nel cluster.
next_page_token

string

Un token per recuperare la pagina dei risultati successiva.
unreachable[]

string

Località non raggiungibili.

ListVpnConnectionsRequest

Elenca le connessioni VPN.

Campi
parent

string

Obbligatorio. La località principale, proprietaria di questa raccolta di connessioni VPN.

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

  • edgecontainer.vpnConnections.list
page_size

int32

Il numero massimo di risorse da elencare.
page_token

string

Un token di pagina ricevuto dalla precedente richiesta di elenco.
filter

string

Verranno elencate solo le risorse che corrispondono a questo filtro.
order_by

string

Specifica l'ordine in cui verranno elencate le risorse.

ListVpnConnectionsResponse

Elenco delle connessioni VPN in una località.

Campi
vpn_connections[]

VpnConnection

VpnConnections nella località.
next_page_token

string

Un token per recuperare la pagina dei risultati successiva.
unreachable[]

string

Località non raggiungibili.

LocationMetadata

Metadati per un determinato google.cloud.location.Location.

Campi
available_zones

map<string, ZoneMetadata>

L'insieme delle zone Google Distributed Cloud Edge disponibili nella località. La mappa è indicizzata in base all'ID in minuscolo di ogni zona.

Computer

Una macchina Google Distributed Cloud Edge in grado di fungere da nodo Kubernetes.

Campi
name

string

Obbligatorio. Il nome della risorsa della macchina.
create_time

Timestamp

Solo output. L'ora in cui è stato creato il pool di nodi.
update_time

Timestamp

Solo output. La data e l'ora dell'ultimo aggiornamento del pool di nodi.
labels

map<string, string>

Etichette associate a questa risorsa.
hosted_node

string

Nome della risorsa canonica del nodo di cui questa macchina è responsabile dell'hosting, ad esempio projects/{project}/locations/{location}/clusters/{cluster_id}/nodePools/{pool_id}/{node}, oppure vuoto se alla macchina non è assegnato il ruolo di nodo.

Per i nodi del control plane ospitati su macchine edge, verrà restituito il seguente formato: "projects/{project}/locations/{location}/clusters/{cluster_id}/controlPlaneNodes/{node}".
zone

string

La zona Google Distributed Cloud Edge di questa macchina.
version

string

Solo output. La versione software della macchina.
disabled

bool

Solo output. Indica se la macchina è disattivata. Se disattivata, la macchina non può entrare in servizio.

MaintenanceExclusionWindow

Rappresenta un periodo di esclusione della manutenzione.

Campi
window

TimeWindow

Facoltativo. La finestra temporale.
id

string

Facoltativo. Un ID univoco (per cluster) per la finestra.

MaintenancePolicy

Configurazione della policy di manutenzione.

Campi
window

MaintenanceWindow

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

MaintenanceExclusionWindow

Facoltativo. Esclusioni dalla manutenzione automatica. La manutenzione non di emergenza non deve essere eseguita in questi periodi. Ogni esclusione ha un nome univoco e può essere attiva o scaduta. Il numero massimo di esclusioni dalla manutenzione consentite in un determinato momento è 3.

MaintenanceWindow

Configurazione del periodo di manutenzione

Campi
recurring_window

RecurringTimeWindow

Configurazione di un periodo di manutenzione ricorrente.

NodePool

Un insieme di nodi Kubernetes in un cluster con configurazione e specifiche comuni.

Campi
name

string

Obbligatorio. Il nome della risorsa del pool di nodi.
create_time

Timestamp

Solo output. L'ora in cui è stato creato il pool di nodi.
update_time

Timestamp

Solo output. La data e l'ora dell'ultimo aggiornamento del pool di nodi.
labels

map<string, string>

Etichette associate a questa risorsa.
node_location

string

Nome della zona Google Distributed Cloud Edge in cui verrà creato questo pool di nodi. Ad esempio: us-central1-edge-customer-a.
node_count

int32

Obbligatorio. Il numero di nodi nel pool.
machine_filter

string

Solo le macchine che corrispondono a questo filtro potranno unirsi al pool di nodi. Il linguaggio di applicazione dei filtri accetta stringhe come "name=" ed è documentato in modo più dettagliato in AIP-160.
local_disk_encryption

LocalDiskEncryption

Facoltativo. Opzioni di crittografia del disco locale. Questo campo viene utilizzato solo quando viene attivato il supporto di CMEK.
node_version

string

Solo output. La versione di rilascio più bassa tra tutti i nodi worker.
node_config

NodeConfig

Facoltativo. Configurazione per ogni nodo nel node pool

LocalDiskEncryption

Configurazione per il supporto di CMEK per la crittografia del disco locale della macchina edge.

Campi
kms_key

string

Facoltativo. La chiave di crittografia Cloud KMS, ad esempio projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}, da utilizzare per proteggere i dischi locali dei nodi. Se non specificata, verrà utilizzata una chiave gestita da Google.
kms_key_active_version

string

Solo output. La versione CryptoKey di Cloud KMS attualmente in uso per proteggere i dischi locali dei nodi. Applicabile solo se è impostata kms_key.
kms_key_state

KmsKeyState

Solo output. Disponibilità della chiave di crittografia Cloud KMS. In caso contrario, i nodi potrebbero andare offline perché non possono accedere ai dati locali.KEY_AVAILABLE Ciò può essere dovuto alla mancanza di autorizzazioni per utilizzare la chiave o alla disattivazione o eliminazione della chiave.
kms_status

Status

Solo output. Stato di errore restituito da Cloud KMS quando viene utilizzata questa chiave. Questo campo può essere compilato solo se kms_key_state non è KMS_KEY_STATE_KEY_AVAILABLE. Se compilato, questo campo contiene lo stato di errore segnalato da Cloud KMS.

NodeConfig

Configurazione per ogni nodo nel node pool

Campi
labels

map<string, string>

Facoltativo. Etichette dei nodi Kubernetes

OperationMetadata

Metadati dell'operazione a lunga esecuzione per i metodi dell'API Edge Container.

Campi
create_time

Timestamp

L'ora in cui è stata creata l'operazione.
end_time

Timestamp

L'ora in cui è terminata l'esecuzione dell'operazione.
target

string

Percorso della risorsa definito dal server per la destinazione dell'operazione.
verb

string

Il verbo eseguito dall'operazione.
status_message

string

Stato dell'operazione leggibile, se presente.
requested_cancellation

bool

Indica se l'utente ha richiesto l'annullamento dell'operazione. Le operazioni annullate correttamente hanno un valore [Operation.error][] pari a 1, corrispondente a google.rpc.Status.code.Code.CANCELLED
api_version

string

Versione dell'API utilizzata per avviare l'operazione.
warnings[]

string

Avvisi che non bloccano l'operazione, ma contengono comunque informazioni pertinenti che l'utente finale deve ricevere.
status_reason

StatusReason

Stato dell'operazione leggibile da macchina, se presente.

StatusReason

Indica il motivo dello stato dell'operazione.

Enum
STATUS_REASON_UNSPECIFIED Motivo sconosciuto.
UPGRADE_PAUSED L'upgrade del cluster è attualmente in pausa.

Quota

Rappresenta la quota per le risorse Edge Container.

Campi
metric

string

Nome della metrica di quota.
limit

double

Limite di quota per questa metrica.
usage

double

Utilizzo attuale di questa metrica.

RecurringTimeWindow

Rappresenta un periodo di tempo arbitrario che si ripete.

Campi
window

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.

ServerConfig

Configurazione del server per le versioni e i canali di rilascio supportati.

Campi
channels

map<string, ChannelConfig>

Solo output. Mappatura dal canale di rilascio alla configurazione del canale.
versions[]

Version

Solo output. Versioni supportate, ad esempio: ["1.4.0", "1.5.0"].
default_version

string

Solo output. Versione predefinita, ad es.: "1.4.0".

TimeWindow

Rappresenta un periodo di tempo arbitrario.

Campi
start_time

Timestamp

L'ora in cui inizia la finestra.
end_time

Timestamp

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

UpdateClusterRequest

Aggiorna un cluster.

Campi
update_mask

FieldMask

La maschera del campo viene utilizzata per specificare i campi da sovrascrivere nella risorsa Cluster con l'aggiornamento. I campi specificati in update_mask si riferiscono alla risorsa, non all'intera richiesta. Un campo verrà sovrascritto se si trova nella maschera. Se l'utente non fornisce una maschera, tutti i campi verranno sovrascritti.
cluster

Cluster

Il cluster aggiornato.

L'autorizzazione richiede il seguente permesso IAM per la risorsa cluster specificata:

  • edgecontainer.clusters.update
request_id

string

Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito request_id.

UpdateNodePoolRequest

Aggiorna un pool di nodi.

Campi
update_mask

FieldMask

La maschera del campo viene utilizzata per specificare i campi da sovrascrivere nella risorsa NodePool con l'aggiornamento. I campi specificati in update_mask si riferiscono alla risorsa, non all'intera richiesta. Un campo verrà sovrascritto se si trova nella maschera. Se l'utente non fornisce una maschera, tutti i campi verranno sovrascritti.
node_pool

NodePool

Il pool di nodi aggiornato.

L'autorizzazione richiede il seguente permesso IAM per la risorsa nodePool specificata:

  • edgecontainer.nodePools.update
request_id

string

Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito request_id.

UpgradeClusterRequest

Esegue l'upgrade di un cluster.

Campi
name

string

Obbligatorio. Il nome della risorsa del cluster.

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

  • edgecontainer.clusters.upgrade
target_version

string

Obbligatorio. La versione a cui verrà eseguito l'upgrade del cluster.
schedule

Schedule

La pianificazione dell'upgrade.
request_id

string

Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito request_id.

Pianifica

Rappresenta la pianificazione dell'upgrade del cluster.

Enum
SCHEDULE_UNSPECIFIED Non specificato. L'impostazione predefinita prevede l'upgrade immediato del cluster, che è l'unica opzione disponibile al momento.
IMMEDIATELY L'upgrade del cluster verrà eseguito immediatamente dopo la ricezione della richiesta.

Versione

Versione di un cluster.

Campi
name

string

Solo output. Nome della versione, ad esempio: "1.4.0".

VpnConnection

Una connessione VPN .

Campi
name

string

Obbligatorio. Il nome della risorsa della connessione VPN
create_time

Timestamp

Solo output. L'ora in cui è stata creata la connessione VPN.
update_time

Timestamp

Solo output. L'ora dell'ultimo aggiornamento della connessione VPN.
labels

map<string, string>

Etichette associate a questa risorsa.
nat_gateway_ip

string

Indirizzo IP gateway NAT o WAN. Se un cliente ha più IP NAT, deve configurare NAT in modo che solo un IP esterno venga mappato al cluster Anthos GMEC. Questo campo è vuoto se non viene utilizzato NAT.
bgp_routing_mode
(deprecated)

BgpRoutingMode

Modalità di routing dinamico della rete VPC, regional o global.
cluster

string

Il nome canonico del cluster a cui connettersi. È nel formato projects/{project}/locations/{location}/clusters/{cluster}.
vpc

string

L'ID rete del VPC a cui connettersi.
vpc_project

VpcProject

Facoltativo. Dettagli del progetto della rete VPC. Obbligatorio se il VPC si trova in un progetto diverso da quello del cluster.
enable_high_availability

bool

Indica se questa connessione VPN ha l'alta disponibilità abilitata sul lato cluster. Se abilitata, durante la creazione della connessione VPN tenteremo di utilizzare due IP mobili ANG.
router

string

Facoltativo. Il nome del router Cloud della connessione VPN.
details

Details

Solo output. I dettagli della connessione creata.

BgpRoutingMode

Modalità di routing.

Enum
BGP_ROUTING_MODE_UNSPECIFIED Sconosciuto.
REGIONAL Modalità regionale.
GLOBAL Modalità globale.

Dettagli

I dettagli della connessione creata.

Campi
state

State

Lo stato di questa connessione.
error

string

Il messaggio di errore. Questo campo viene compilato solo quando state=ERROR.
cloud_router

CloudRouter

Le informazioni sul router Cloud.
cloud_vpns[]

CloudVpn

Ogni connessione ha più gateway Cloud VPN.

CloudRouter

Le informazioni sul router Cloud.

Campi
name

string

Il nome del router Cloud associato.

CloudVpn

Le informazioni su Cloud VPN.

Campi
gateway

string

Il nome del gateway Cloud VPN creato.

Stato

Lo stato attuale della connessione.

Enum
STATE_UNSPECIFIED Sconosciuto.
STATE_CONNECTED Connesso.
STATE_CONNECTING Connessione ancora in corso.
STATE_ERROR Si è verificato un errore.

VpcProject

Dettagli del progetto della rete VPC.

Campi
project_id

string

Il progetto del VPC a cui connettersi. Se non specificato, è uguale al progetto del cluster.

ZoneMetadata

Una zona Google Distributed Cloud Edge in cui si trovano le macchine perimetrali.

Campi
quota[]

Quota

Quota per le risorse in questa zona.
rack_types

map<string, RackType>

La mappa è indicizzata in base al nome del rack e ha il valore RackType.

RackType

Tipo di rack.

Enum
RACK_TYPE_UNSPECIFIED Tipo di rack non specificato. Anche il rack singolo appartiene a questo tipo.
BASE Tipo di rack di base, una coppia di due rack Config-1 modificati contenenti switch di aggregazione.
EXPANSION Tipo di rack di espansione, noti anche come rack autonomi, aggiunti dai clienti su richiesta.