Indice
EdgeContainer(interfaccia)Authorization(messaggio)ChannelConfig(messaggio)Cluster(messaggio)Cluster.ConnectionState(messaggio)Cluster.ConnectionState.State(enum)Cluster.ControlPlane(messaggio)Cluster.ControlPlane.Local(messaggio)Cluster.ControlPlane.Remote(messaggio)Cluster.ControlPlane.SharedDeploymentPolicy(enum)Cluster.ControlPlaneEncryption(messaggio)Cluster.ExternalLoadBalancerPool(messaggio)Cluster.MaintenanceEvent(messaggio)Cluster.MaintenanceEvent.Schedule(enum)Cluster.MaintenanceEvent.State(enum)Cluster.MaintenanceEvent.Type(enum)Cluster.ReleaseChannel(enum)Cluster.Status(enum)Cluster.SurvivabilityConfig(messaggio)Cluster.SystemAddonsConfig(messaggio)Cluster.SystemAddonsConfig.Ingress(messaggio)Cluster.SystemAddonsConfig.VMServiceConfig(messaggio)Cluster.ZoneStorageEncryption(messaggio)ClusterNetworking(messaggio)ClusterUser(messaggio)ConfigData(messaggio)CreateClusterRequest(messaggio)CreateNodePoolRequest(messaggio)CreateVpnConnectionRequest(messaggio)DeleteClusterRequest(messaggio)DeleteNodePoolRequest(messaggio)DeleteVpnConnectionRequest(messaggio)Fleet(messaggio)GenerateAccessTokenRequest(messaggio)GenerateAccessTokenResponse(messaggio)GenerateOfflineCredentialRequest(messaggio)GenerateOfflineCredentialResponse(messaggio)GetClusterRequest(messaggio)GetMachineRequest(messaggio)GetNodePoolRequest(messaggio)GetServerConfigRequest(messaggio)GetVpnConnectionRequest(messaggio)KmsKeyState(enum)ListClustersRequest(messaggio)ListClustersResponse(messaggio)ListMachinesRequest(messaggio)ListMachinesResponse(messaggio)ListNodePoolsRequest(messaggio)ListNodePoolsResponse(messaggio)ListVpnConnectionsRequest(messaggio)ListVpnConnectionsResponse(messaggio)LocationMetadata(messaggio)Machine(messaggio)Machine.Purpose(enum)Machine.Status(enum)MaintenanceExclusionWindow(messaggio)MaintenancePolicy(messaggio)MaintenanceWindow(messaggio)NodePool(messaggio)NodePool.LocalDiskEncryption(messaggio)NodePool.NodeConfig(messaggio)OperationMetadata(messaggio)OperationMetadata.StatusReason(enum)Quota(messaggio)RecurringTimeWindow(messaggio)ResourceState(enum)ServerConfig(messaggio)TimeWindow(messaggio)UpdateClusterRequest(messaggio)UpdateNodePoolRequest(messaggio)UpgradeClusterRequest(messaggio)UpgradeClusterRequest.Schedule(enum)Version(messaggio)VpnConnection(messaggio)VpnConnection.BgpRoutingMode(enum)VpnConnection.Details(messaggio)VpnConnection.Details.CloudRouter(messaggio)VpnConnection.Details.CloudVpn(messaggio)VpnConnection.Details.State(enum)VpnConnection.VpcProject(messaggio)ZoneMetadata(messaggio)ZoneMetadata.RackType(enum)
EdgeContainer
L'API EdgeContainer fornisce la gestione dei cluster Kubernetes nei deployment di Google Edge Cloud.
| CreateCluster |
|---|
|
Crea un nuovo cluster in un progetto e una località specifici.
|
| CreateNodePool |
|---|
|
Crea un nuovo NodePool in un progetto e una località specifici.
|
| CreateVpnConnection |
|---|
|
Crea una nuova connessione VPN in un progetto e una località specifici.
|
| DeleteCluster |
|---|
|
Elimina un singolo cluster.
|
| DeleteNodePool |
|---|
|
Elimina un singolo NodePool.
|
| DeleteVpnConnection |
|---|
|
Elimina una singola connessione VPN.
|
| GenerateAccessToken |
|---|
|
Genera un token di accesso per un cluster.
|
| GenerateOfflineCredential |
|---|
|
Genera una credenziale offline per un cluster.
|
| GetCluster |
|---|
|
Recupera i dettagli di un singolo cluster.
|
| GetMachine |
|---|
|
Recupera i dettagli di una singola macchina.
|
| GetNodePool |
|---|
|
Recupera i dettagli di un singolo NodePool.
|
| GetServerConfig |
|---|
|
Recupera la configurazione del server.
|
| GetVpnConnection |
|---|
|
Recupera i dettagli di una singola connessione VPN.
|
| ListClusters |
|---|
|
Elenca i cluster in un progetto e una località specifici.
|
| ListMachines |
|---|
|
Elenca le macchine in un progetto e una località specifici.
|
| ListNodePools |
|---|
|
Elenca i nodepool in un progetto e una località specifici.
|
| ListVpnConnections |
|---|
|
Elenca le connessioni VPN in un progetto e una località specifici.
|
| UpdateCluster |
|---|
|
Aggiorna i parametri di un singolo cluster.
|
| UpdateNodePool |
|---|
|
Aggiorna i parametri di un singolo node pool.
|
| UpgradeCluster |
|---|
|
Esegue l'upgrade di un singolo cluster.
|
Autorizzazione
Criterio RBAC che verrà applicato e gestito da GEC.
| Campi | |
|---|---|
admin_ |
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_ |
Solo output. Versione predefinita per questo canale di rilascio, ad esempio: "1.4.0". |
Cluster
Un cluster Kubernetes Google Distributed Cloud Edge.
| Campi | |
|---|---|
name |
Obbligatorio. Il nome della risorsa del cluster. |
create_ |
Solo output. L'ora in cui è stato creato il cluster. |
update_ |
Solo output. L'ora dell'ultimo aggiornamento del cluster. |
labels |
Etichette associate a questa risorsa. |
fleet |
Obbligatorio. Configurazione del parco risorse. |
networking |
Obbligatorio. Configurazione del networking a livello di cluster. |
authorization |
Obbligatorio. Immutabile. Criterio RBAC che verrà applicato e gestito da GEC. |
default_ |
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 |
Solo output. L'indirizzo IP del server API Kubernetes. |
port |
Solo output. Il numero di porta del server API Kubernetes. |
cluster_ |
Solo output. Il certificato pubblico con codifica PEM della CA del cluster. |
maintenance_ |
Facoltativo. Configurazione della policy di manutenzione a livello di cluster. |
control_ |
Solo output. La versione di rilascio del control plane |
node_ |
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_ |
Facoltativo. La configurazione del control plane del cluster. |
system_ |
Facoltativo. La configurazione dei componenti aggiuntivi di sistema. |
external_ |
Facoltativo. Pool di indirizzi IPv4 per il bilanciamento del carico esterno del piano dati del cluster. |
control_ |
Facoltativo. Opzioni di crittografia del disco del control plane remoto. Questo campo viene utilizzato solo quando viene attivato il supporto di CMEK. |
status |
Solo output. Lo stato attuale del cluster. |
maintenance_ |
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_ |
Facoltativo. La versione del cluster di destinazione. Ad esempio: "1.5.0". |
release_ |
Facoltativo. Il canale di rilascio a cui è iscritto un cluster. |
survivability_ |
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_ |
Facoltativo. Pool di indirizzi IPv6 per il bilanciamento del carico esterno del piano dati del cluster. |
connection_ |
Solo output. Lo stato attuale della connessione del cluster. |
external_ |
Facoltativo. Pool del bilanciatore del carico esterno per il cluster. |
zone_ |
Facoltativo. Configurazione della crittografia dell'archiviazione della zona |
ConnectionState
ConnectionState contiene lo stato attuale della connessione dal cluster a Google.
| Campi | |
|---|---|
state |
Solo output. Lo stato attuale della connessione. |
update_ |
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
|
|
remote |
Configurazione del control plane remoto. |
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_ |
Nome delle zone Google Distributed Cloud Edge in cui verrà creato questo pool di nodi. Ad esempio: |
node_ |
Il numero di nodi che fungono da repliche del control plane. |
machine_ |
Solo le macchine che corrispondono a questo filtro potranno ospitare i nodi del control plane. Il linguaggio di filtraggio accetta stringhe come "name= |
shared_ |
Configurazione dei criteri relativi alla modalità di deployment delle applicazioni utente. |
control_ |
Facoltativo. Nome dello schema di archiviazione dei nodi del control plane. Avviso: la funzionalità dello schema di archiviazione locale dei nodi configurabile è sperimentale e non è consigliata per l'uso generale nei cluster/nodepool di produzione. |
Remoto
Questo tipo non contiene campi.
Configurazione specifica per i cluster con un control plane ospitato da remoto.
ControlPlaneEncryption
Configurazione per il supporto della chiave KMS gestita dal cliente per i nodi del control plane.
| Campi | |
|---|---|
kms_ |
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_ |
Solo output. La CryptoKeyVersion di Cloud KMS attualmente in uso per proteggere i dischi del control plane. Applicabile solo se è impostata kms_key. |
kms_ |
Solo output. Disponibilità della chiave di crittografia Cloud KMS. In caso contrario, i nodi potrebbero andare offline perché non possono accedere ai dati locali. |
kms_ |
Solo output. Stato di errore restituito da Cloud KMS quando viene utilizzata questa chiave. Questo campo può essere compilato solo se |
resource_ |
Solo output. Lo stato attuale della risorsa associata a cmek. |
ExternalLoadBalancerPool
Pool del bilanciatore del carico esterno con configurazione personalizzata come nome, assegnazione manuale/automatica, intervallo di indirizzi IPv4 non sovrapposto e intervallo di indirizzi IPv6 facoltativo.
| Campi | |
|---|---|
address_ |
Facoltativo. Nome del pool del bilanciatore del carico esterno. |
ipv4_ |
Obbligatorio. Intervallo di indirizzi IPv4 non sovrapposto del pool del bilanciatore del carico esterno. |
ipv6_ |
Facoltativo. Intervallo di indirizzi IPv6 non sovrapposto del pool del bilanciatore del carico esterno. |
avoid_ |
Facoltativo. Se il valore è true, il pool omette gli indirizzi IP che terminano con .0 e .255. Alcuni hardware di rete eliminano il traffico verso questi indirizzi speciali. Il valore predefinito è false. |
manual_ |
Facoltativo. Se è true, gli indirizzi in questo pool non vengono assegnati automaticamente ai servizi Kubernetes. Se è vero, un indirizzo IP in questo pool viene utilizzato solo quando viene specificato esplicitamente da un servizio. Il valore predefinito è false. |
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 |
Solo output. UUID dell'evento di manutenzione. |
target_ |
Solo output. La versione di destinazione del cluster. |
operation |
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 |
Solo output. Il tipo di evento di manutenzione. |
schedule |
Solo output. La pianificazione dell'evento di manutenzione. |
state |
Solo output. Lo stato dell'evento di manutenzione. |
create_ |
Solo output. L'ora in cui è stata creata la richiesta di evento di manutenzione. |
start_ |
Solo output. L'ora in cui è iniziato l'evento di manutenzione. |
end_ |
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_ |
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_ |
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 |
Facoltativo. Configurazione per Ingress. |
vm_ |
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 |
Facoltativo. Indica se Ingress è disabilitato. |
ipv4_ |
Facoltativo. VIP in entrata. |
VMServiceConfig
VMServiceConfig definisce la configurazione per il servizio VM GDCE.
| Campi | |
|---|---|
vmm_ |
Facoltativo. Indica se VMM è abilitato. |
ZoneStorageEncryption
Configurazione del supporto CMEK per l'archiviazione di zona
| Campi | |
|---|---|
kms_ |
Facoltativo. Chiave Cloud KMS |
kms_ |
Solo output. La versione CryptoKey Cloud KMS attualmente utilizzata per la crittografia/decrittografia |
resource_ |
Solo output. Lo stato attuale della risorsa della chiave CMEK |
ClusterNetworking
Configurazione del networking a livello di cluster.
| Campi | |
|---|---|
cluster_ |
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_ |
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 |
Obbligatorio. Un nome utente Google attivo. |
ConfigData
I dati di configurazione contengono tutti i dati correlati alla configurazione della zona.
| Campi | |
|---|---|
available_ |
elenco dei pool di IP v4 disponibili per il bilanciatore del carico esterno |
available_ |
elenco dei pool di IP v6 disponibili per il bilanciatore del carico esterno |
CreateClusterRequest
Crea un cluster.
| Campi | |
|---|---|
parent |
Obbligatorio. La località principale in cui verrà creato questo cluster. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
cluster_ |
Obbligatorio. Un identificatore univoco specificato dal client per il cluster. |
cluster |
Obbligatorio. Il cluster da creare. |
request_ |
Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito |
CreateNodePoolRequest
Crea un pool di nodi.
| Campi | |
|---|---|
parent |
Obbligatorio. Il cluster padre in cui verrà creato questo pool di nodi. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
node_ |
Obbligatorio. Un identificatore univoco specificato dal client per il pool di nodi. |
node_ |
Obbligatorio. Il pool di nodi da creare. |
request_ |
Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito |
CreateVpnConnectionRequest
Crea una connessione VPN.
| Campi | |
|---|---|
parent |
Obbligatorio. La località principale in cui verrà creata questa connessione VPN. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
vpn_ |
Obbligatorio. L'identificatore della connessione VPN. |
vpn_ |
Obbligatorio. La connessione VPN da creare. |
request_ |
Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito |
DeleteClusterRequest
Elimina un cluster.
| Campi | |
|---|---|
name |
Obbligatorio. Il nome della risorsa del cluster. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
request_ |
Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito |
DeleteNodePoolRequest
Elimina un pool di nodi.
| Campi | |
|---|---|
name |
Obbligatorio. Il nome della risorsa del pool di nodi. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
request_ |
Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito |
DeleteVpnConnectionRequest
Elimina una connessione VPN.
| Campi | |
|---|---|
name |
Obbligatorio. Il nome della risorsa della connessione VPN. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
request_ |
Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito |
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 |
Obbligatorio. Il nome del progetto host del parco risorse in cui verrà registrato questo cluster. I nomi dei progetti sono formattati come |
membership |
Solo output. Il nome della risorsa Hub Membership gestita associata a questo cluster. I nomi delle iscrizioni sono formattati come |
GenerateAccessTokenRequest
Genera un token di accesso per un cluster.
| Campi | |
|---|---|
cluster |
Obbligatorio. Il nome della risorsa del cluster. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
GenerateAccessTokenResponse
Un token di accesso per un cluster.
| Campi | |
|---|---|
access_ |
Solo output. Token di accesso per l'autenticazione al server API k8s. |
expire_ |
Solo output. Timestamp in corrispondenza del quale il token scadrà. |
GenerateOfflineCredentialRequest
Genera una credenziale offline per un cluster.
| Campi | |
|---|---|
cluster |
Obbligatorio. Il nome della risorsa del cluster. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
GenerateOfflineCredentialResponse
Una credenziale offline per un cluster.
| Campi | |
|---|---|
client_ |
Solo output. Certificato client per l'autenticazione al server API k8s. |
client_ |
Solo output. Chiave privata del client per l'autenticazione con l'API server k8s. |
user_ |
Solo output. L'identità del cliente. |
expire_ |
Solo output. Timestamp in cui questa credenziale scadrà. |
GetClusterRequest
Recupera un cluster.
| Campi | |
|---|---|
name |
Obbligatorio. Il nome della risorsa del cluster. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
GetMachineRequest
Acquista una macchina.
| Campi | |
|---|---|
name |
Obbligatorio. Il nome della risorsa della macchina. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
GetNodePoolRequest
Recupera un pool di nodi.
| Campi | |
|---|---|
name |
Obbligatorio. Il nome della risorsa del pool di nodi. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
GetServerConfigRequest
Recupera la configurazione del server.
| Campi | |
|---|---|
name |
Obbligatorio. Il nome (progetto e località) della configurazione del server da recuperare, specificato nel formato L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
GetVpnConnectionRequest
Ottiene una connessione VPN.
| Campi | |
|---|---|
name |
Obbligatorio. Il nome della risorsa della connessione VPN. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
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 |
Obbligatorio. La località principale, proprietaria di questa raccolta di cluster. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
page_ |
Il numero massimo di risorse da elencare. |
page_ |
Un token di pagina ricevuto dalla precedente richiesta di elenco. Un token di pagina ricevuto dalla precedente richiesta di elenco. |
filter |
Verranno elencate solo le risorse che corrispondono a questo filtro. |
order_ |
Specifica l'ordine in cui verranno elencate le risorse. |
ListClustersResponse
Elenco dei cluster in una località.
| Campi | |
|---|---|
clusters[] |
Cluster nella località. |
next_ |
Un token per recuperare la pagina dei risultati successiva. |
unreachable[] |
Località non raggiungibili. |
ListMachinesRequest
Elenca le macchine in un sito.
| Campi | |
|---|---|
parent |
Obbligatorio. Il sito principale, proprietario di questa raccolta di macchine. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
page_ |
Il numero massimo di risorse da elencare. |
page_ |
Un token di pagina ricevuto dalla precedente richiesta di elenco. |
filter |
Verranno elencate solo le risorse che corrispondono a questo filtro. |
order_ |
Specifica l'ordine in cui verranno elencate le risorse. |
ListMachinesResponse
Elenco delle macchine in un sito.
| Campi | |
|---|---|
machines[] |
Macchine nel sito. |
next_ |
Un token per recuperare la pagina dei risultati successiva. |
unreachable[] |
Località non raggiungibili. |
ListNodePoolsRequest
Elenca i pool di nodi in un cluster.
| Campi | |
|---|---|
parent |
Obbligatorio. Il cluster principale, proprietario di questa raccolta di pool di nodi. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
page_ |
Il numero massimo di risorse da elencare. |
page_ |
Un token di pagina ricevuto dalla precedente richiesta di elenco. |
filter |
Verranno elencate solo le risorse che corrispondono a questo filtro. |
order_ |
Specifica l'ordine in cui verranno elencate le risorse. |
ListNodePoolsResponse
Elenco dei node pool in un cluster.
| Campi | |
|---|---|
node_ |
I node pool nel cluster. |
next_ |
Un token per recuperare la pagina dei risultati successiva. |
unreachable[] |
Località non raggiungibili. |
ListVpnConnectionsRequest
Elenca le connessioni VPN.
| Campi | |
|---|---|
parent |
Obbligatorio. La località principale, proprietaria di questa raccolta di connessioni VPN. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
page_ |
Il numero massimo di risorse da elencare. |
page_ |
Un token di pagina ricevuto dalla precedente richiesta di elenco. |
filter |
Verranno elencate solo le risorse che corrispondono a questo filtro. |
order_ |
Specifica l'ordine in cui verranno elencate le risorse. |
ListVpnConnectionsResponse
Elenco delle connessioni VPN in una località.
| Campi | |
|---|---|
vpn_ |
VpnConnections nella località. |
next_ |
Un token per recuperare la pagina dei risultati successiva. |
unreachable[] |
Località non raggiungibili. |
LocationMetadata
Metadati per un determinato google.cloud.location.Location.
| Campi | |
|---|---|
available_ |
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 |
Obbligatorio. Il nome della risorsa della macchina. |
create_ |
Solo output. L'ora in cui è stato creato il pool di nodi. |
update_ |
Solo output. La data e l'ora dell'ultimo aggiornamento del pool di nodi. |
labels |
Etichette associate a questa risorsa. |
hosted_ |
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 |
La zona Google Distributed Cloud Edge di questa macchina. |
version |
Solo output. La versione software della macchina. |
disabled |
Solo output. Indica se la macchina è disattivata. Se disattivata, la macchina non può entrare in servizio. |
status |
Solo output. Lo stato attuale della macchina. |
purpose |
Il tipo di cluster per cui viene utilizzata la macchina. |
Finalità
Lo scopo della macchina può essere VIRTUALIZED_WORKLOAD o BAREMETAL_CLUSTER.
| Enum | |
|---|---|
PURPOSE_UNSPECIFIED |
Scopo non specificato. |
VIRTUALIZED_WORKLOAD |
La macchina viene utilizzata per il carico di lavoro virtuale. |
BAREMETAL_CLUSTER |
La macchina viene utilizzata per un cluster utente Bare Metal. |
Stato
Indica lo stato della macchina.
| Enum | |
|---|---|
STATUS_UNSPECIFIED |
Stato sconosciuto. |
READY |
La macchina è pronta per ospitare un nodo. Questa è l'impostazione predefinita. |
DISABLED_FOR_REPAIR |
La macchina è stata disattivata per la riparazione aggiungendo una o più rivendicazioni di disattivazione. |
MaintenanceExclusionWindow
Rappresenta un periodo di esclusione della manutenzione.
| Campi | |
|---|---|
window |
Facoltativo. La finestra temporale. |
id |
Facoltativo. Un ID univoco (per cluster) per la finestra. |
MaintenancePolicy
Configurazione della policy di manutenzione.
| Campi | |
|---|---|
window |
Specifica il periodo di manutenzione in cui può essere eseguita la manutenzione. |
maintenance_ |
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_ |
Configurazione di un periodo di manutenzione ricorrente. |
NodePool
Un insieme di nodi Kubernetes in un cluster con configurazione e specifiche comuni.
| Campi | |
|---|---|
name |
Obbligatorio. Il nome della risorsa del pool di nodi. |
create_ |
Solo output. L'ora in cui è stato creato il pool di nodi. |
update_ |
Solo output. La data e l'ora dell'ultimo aggiornamento del pool di nodi. |
labels |
Etichette associate a questa risorsa. |
node_ |
Nome della zona Google Distributed Cloud Edge in cui verrà creato questo pool di nodi. Ad esempio: |
node_ |
Obbligatorio. Il numero di nodi nel pool. |
machine_ |
Solo le macchine che corrispondono a questo filtro potranno unirsi al pool di nodi. Il linguaggio di applicazione dei filtri accetta stringhe come "name= |
local_ |
Facoltativo. Opzioni di crittografia del disco locale. Questo campo viene utilizzato solo quando viene attivato il supporto di CMEK. |
node_ |
Solo output. La versione di rilascio più bassa tra tutti i nodi worker. |
node_ |
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_ |
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_ |
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_ |
Solo output. Disponibilità della chiave di crittografia Cloud KMS. In caso contrario, i nodi potrebbero andare offline perché non possono accedere ai dati locali. |
kms_ |
Solo output. Stato di errore restituito da Cloud KMS quando viene utilizzata questa chiave. Questo campo può essere compilato solo se |
resource_ |
Solo output. Lo stato attuale della risorsa associata a cmek. |
NodeConfig
Configurazione per ogni nodo nel node pool
| Campi | |
|---|---|
labels |
Facoltativo. Etichette dei nodi Kubernetes |
node_ |
Facoltativo. Nome dello schema di archiviazione dei nodi worker. Avviso: la funzionalità dello schema di archiviazione locale dei nodi configurabile è sperimentale e non è consigliata per l'uso generale nei cluster/nodepool di produzione. |
OperationMetadata
Metadati dell'operazione a lunga esecuzione per i metodi dell'API Edge Container.
| Campi | |
|---|---|
create_ |
L'ora in cui è stata creata l'operazione. |
end_ |
L'ora in cui è terminata l'esecuzione dell'operazione. |
target |
Percorso della risorsa definito dal server per la destinazione dell'operazione. |
verb |
Il verbo eseguito dall'operazione. |
status_ |
Stato dell'operazione leggibile, se presente. |
requested_ |
Indica se l'utente ha richiesto l'annullamento dell'operazione. Le operazioni annullate correttamente hanno un valore [Operation.error][] pari a 1, corrispondente a |
api_ |
Versione dell'API utilizzata per avviare l'operazione. |
warnings[] |
Avvisi che non bloccano l'operazione, ma contengono comunque informazioni pertinenti che l'utente finale deve ricevere. |
status_ |
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 |
Nome della metrica di quota. |
limit |
Limite di quota per questa metrica. |
usage |
Utilizzo attuale di questa metrica. |
RecurringTimeWindow
Rappresenta un periodo di tempo arbitrario che si ripete.
| Campi | |
|---|---|
window |
La finestra della prima ricorrenza. |
recurrence |
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. |
ResourceState
Indica se la risorsa è in stato di blocco o in attesa.
| Enum | |
|---|---|
RESOURCE_STATE_UNSPECIFIED |
Valore predefinito. |
RESOURCE_STATE_LOCK_DOWN |
La risorsa è in stato LOCK DOWN. |
RESOURCE_STATE_LOCK_DOWN_PENDING |
La risorsa è in attesa di blocco. |
ServerConfig
Configurazione del server per le versioni e i canali di rilascio supportati.
| Campi | |
|---|---|
channels |
Solo output. Mappatura dal canale di rilascio alla configurazione del canale. |
versions[] |
Solo output. Versioni supportate, ad esempio: ["1.4.0", "1.5.0"]. |
default_ |
Solo output. Versione predefinita, ad es.: "1.4.0". |
TimeWindow
Rappresenta un periodo di tempo arbitrario.
| Campi | |
|---|---|
start_ |
L'ora in cui inizia la finestra. |
end_ |
L'ora in cui termina la finestra. L'ora di fine deve essere successiva all'ora di inizio. |
UpdateClusterRequest
Aggiorna un cluster.
| Campi | |
|---|---|
update_ |
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 |
Il cluster aggiornato. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
request_ |
Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito |
UpdateNodePoolRequest
Aggiorna un pool di nodi.
| Campi | |
|---|---|
update_ |
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_ |
Il pool di nodi aggiornato. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
request_ |
Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito |
UpgradeClusterRequest
Esegue l'upgrade di un cluster.
| Campi | |
|---|---|
name |
Obbligatorio. Il nome della risorsa del cluster. L'autorizzazione richiede il seguente permesso IAM per la risorsa
|
target_ |
Obbligatorio. La versione a cui verrà eseguito l'upgrade del cluster. |
schedule |
La pianificazione dell'upgrade. |
request_ |
Un identificatore univoco per questa richiesta. Limitato a 36 caratteri ASCII. È consigliabile utilizzare un UUID casuale. Questa richiesta è idempotente solo se viene fornito |
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 |
Solo output. Nome della versione, ad esempio: "1.4.0". |
VpnConnection
Una connessione VPN .
| Campi | |
|---|---|
name |
Obbligatorio. Il nome della risorsa della connessione VPN |
create_ |
Solo output. L'ora in cui è stata creata la connessione VPN. |
update_ |
Solo output. L'ora dell'ultimo aggiornamento della connessione VPN. |
labels |
Etichette associate a questa risorsa. |
nat_ |
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 |
Modalità di routing dinamico della rete VPC, |
cluster |
Il nome canonico del cluster a cui connettersi. È nel formato projects/{project}/locations/{location}/clusters/{cluster}. |
vpc |
L'ID rete del VPC a cui connettersi. |
vpc_ |
Facoltativo. Dettagli del progetto della rete VPC. Obbligatorio se il VPC si trova in un progetto diverso da quello del cluster. |
enable_ |
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 |
Facoltativo. Il nome del router Cloud della connessione VPN. |
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 |
Lo stato di questa connessione. |
error |
Il messaggio di errore. Questo campo viene compilato solo quando state=ERROR. |
cloud_ |
Le informazioni sul router Cloud. |
cloud_ |
Ogni connessione ha più gateway Cloud VPN. |
CloudRouter
Le informazioni sul router Cloud.
| Campi | |
|---|---|
name |
Il nome del router Cloud associato. |
CloudVpn
Le informazioni su Cloud VPN.
| Campi | |
|---|---|
gateway |
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_ |
Il progetto del VPC a cui connettersi. Se non specificato, è uguale al progetto del cluster. |
service_account |
Facoltativo. Deprecato: non utilizzare. |
ZoneMetadata
Una zona Google Distributed Cloud Edge in cui si trovano le macchine perimetrali.
| Campi | |
|---|---|
quota[] |
Quota per le risorse in questa zona. |
rack_ |
La mappa è indicizzata in base al nome del rack e ha il valore RackType. |
config_ |
Dati di configurazione per la zona. |
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. |