Package google.cloud.edgecontainer.v1

Index

EdgeContainer

Die EdgeContainer API bietet die Verwaltung von Kubernetes-Clustern in Google Edge Cloud-Bereitstellungen.

CreateCluster

rpc CreateCluster(CreateClusterRequest) returns (Operation)

Erstellt einen neuen Cluster in einem bestimmten Projekt und an einem bestimmten Standort.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
CreateNodePool

rpc CreateNodePool(CreateNodePoolRequest) returns (Operation)

Erstellt einen neuen NodePool in einem bestimmten Projekt und an einem bestimmten Standort.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
CreateVpnConnection

rpc CreateVpnConnection(CreateVpnConnectionRequest) returns (Operation)

Erstellt eine neue VPN-Verbindung in einem bestimmten Projekt und an einem bestimmten Standort.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
DeleteCluster

rpc DeleteCluster(DeleteClusterRequest) returns (Operation)

Löscht einen einzelnen Cluster.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
DeleteNodePool

rpc DeleteNodePool(DeleteNodePoolRequest) returns (Operation)

Löscht einen einzelnen NodePool.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
DeleteVpnConnection

rpc DeleteVpnConnection(DeleteVpnConnectionRequest) returns (Operation)

Löscht eine einzelne VPN-Verbindung.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
GenerateAccessToken

rpc GenerateAccessToken(GenerateAccessTokenRequest) returns (GenerateAccessTokenResponse)

Generiert ein Zugriffstoken für einen Cluster.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
GenerateOfflineCredential

rpc GenerateOfflineCredential(GenerateOfflineCredentialRequest) returns (GenerateOfflineCredentialResponse)

Generiert einen Offlineanmeldedatensatz für einen Cluster.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
GetCluster

rpc GetCluster(GetClusterRequest) returns (Cluster)

Ruft Details zu einem einzelnen Cluster ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
GetMachine

rpc GetMachine(GetMachineRequest) returns (Machine)

Ruft Details zu einer einzelnen Maschine ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
GetNodePool

rpc GetNodePool(GetNodePoolRequest) returns (NodePool)

Ruft Details zu einem einzelnen NodePool ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
GetServerConfig

rpc GetServerConfig(GetServerConfigRequest) returns (ServerConfig)

Ruft die Serverkonfiguration ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
GetVpnConnection

rpc GetVpnConnection(GetVpnConnectionRequest) returns (VpnConnection)

Ruft Details zu einer einzelnen VPN-Verbindung ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
ListClusters

rpc ListClusters(ListClustersRequest) returns (ListClustersResponse)

Listet Cluster in einem angegebenen Projekt und an einem angegebenen Standort auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
ListMachines

rpc ListMachines(ListMachinesRequest) returns (ListMachinesResponse)

Listet Maschinen in einem angegebenen Projekt und an einem angegebenen Standort auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
ListNodePools

rpc ListNodePools(ListNodePoolsRequest) returns (ListNodePoolsResponse)

Listet NodePools in einem bestimmten Projekt und an einem bestimmten Standort auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
ListVpnConnections

rpc ListVpnConnections(ListVpnConnectionsRequest) returns (ListVpnConnectionsResponse)

Listet VPN-Verbindungen in einem bestimmten Projekt und an einem bestimmten Standort auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
UpdateCluster

rpc UpdateCluster(UpdateClusterRequest) returns (Operation)

Aktualisiert die Parameter eines einzelnen Clusters.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
UpdateNodePool

rpc UpdateNodePool(UpdateNodePoolRequest) returns (Operation)

Aktualisiert die Parameter eines einzelnen NodePool.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.
UpgradeCluster

rpc UpgradeCluster(UpgradeClusterRequest) returns (Operation)

Aktualisiert einen einzelnen Cluster.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

Autorisierung

RBAC-Richtlinie, die von GEC angewendet und verwaltet wird.

Felder
admin_users

ClusterUser

Erforderlich. Nutzer, dem die Rolle „cluster-admin“ für den Cluster und damit vollständiger Zugriff auf den Cluster gewährt wird. Derzeit ist dies ein einzelnes Feld, es wird aber erweitert, um in Zukunft mehrere Administratoren zu ermöglichen.

ChannelConfig

Konfiguration für eine Release-Version.

Felder
default_version

string

Nur Ausgabe. Standardversion für diese Release-Version, z.B.: „1.4.0“.

Cluster

Ein Google Distributed Cloud Edge-Kubernetes-Cluster.

Felder
name

string

Erforderlich. Der Ressourcenname des Clusters.
create_time

Timestamp

Nur Ausgabe. Die Zeit, zu der der Cluster erstellt wurde.
update_time

Timestamp

Nur Ausgabe. Die Zeit, zu der der Cluster zuletzt aktualisiert wurde.
labels

map<string, string>

Mit dieser Ressource verknüpfte Labels.
fleet

Fleet

Erforderlich. Flottenkonfiguration.
networking

ClusterNetworking

Erforderlich. Clusterweite Netzwerkkonfiguration.
authorization

Authorization

Erforderlich. Nicht veränderbar. RBAC-Richtlinie, die von GEC angewendet und verwaltet wird.
default_max_pods_per_node

int32

Optional. Die standardmäßig maximale Anzahl von Pods pro Knoten, die verwendet wird, wenn für einen Knotenpool in diesem Cluster kein expliziter Höchstwert angegeben ist. Wenn nichts angegeben ist, wird der Kubernetes-Standardwert verwendet.
endpoint

string

Nur Ausgabe. Die IP-Adresse des Kubernetes API-Servers.
port

int32

Nur Ausgabe. Die Portnummer des Kubernetes API-Servers.
cluster_ca_certificate

string

Nur Ausgabe. Das PEM-codierte öffentliche Zertifikat der Zertifizierungsstelle des Clusters.
maintenance_policy

MaintenancePolicy

Optional. Clusterweite Konfiguration der Wartungsrichtlinie.
control_plane_version

string

Nur Ausgabe. Die Release-Version der Steuerungsebene
node_version

string

Nur Ausgabe. Die niedrigste Release-Version aller Worker-Knoten. Dieses Feld kann leer sein, wenn der Cluster keine Worker-Knoten hat.
control_plane

ControlPlane

Optional. Die Konfiguration der Clustersteuerungsebene.
system_addons_config

SystemAddonsConfig

Optional. Die Konfiguration der System-Add‑ons.
external_load_balancer_ipv4_address_pools[]

string

Optional. IPv4-Adresspools für das externe Load-Balancing der Clusterdatenebene.
control_plane_encryption

ControlPlaneEncryption

Optional. Optionen für die Laufwerkverschlüsselung der Remote-Steuerungsebene. Dieses Feld wird nur verwendet, wenn die CMEK-Unterstützung aktiviert wird.
status

Status

Nur Ausgabe. Der aktuelle Status des Clusters.
maintenance_events[]

MaintenanceEvent

Nur Ausgabe. Alle Wartungsereignisse, die für den Cluster geplant sind, einschließlich der laufenden, zukünftigen und vergangenen (bis zu 90 Tage).
target_version

string

Optional. Die Zielclusterversion. Beispiel: „1.5.0“.
release_channel

ReleaseChannel

Optional. Die Release-Version, für die ein Cluster registriert ist.
survivability_config

SurvivabilityConfig

Optional. Konfiguration der Cluster-Survivability, z.B. für den Fall, dass die Netzwerkverbindung unterbrochen wird. Hinweis: Dies gilt nur für Cluster mit lokaler Steuerungsebene.
external_load_balancer_ipv6_address_pools[]

string

Optional. IPv6-Adresspools für externes Load-Balancing der Datenebene von Clustern.
connection_state

ConnectionState

Nur Ausgabe. Der aktuelle Verbindungsstatus des Clusters.
external_load_balancer_address_pools[]

ExternalLoadBalancerPool

Optional. Externe Load-Balancer-Pools für den Cluster.
zone_storage_encryption

ZoneStorageEncryption

Optional. Die Konfiguration der Speicherverschlüsselung für die Zone

ConnectionState

ConnectionState enthält den aktuellen Verbindungsstatus vom Cluster zu Google.

Felder
state

State

Nur Ausgabe. Der aktuelle Verbindungsstatus.
update_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Verbindungsstatus zuletzt geändert wurde.

Bundesland

Der Verbindungsstatus.

Enums
STATE_UNSPECIFIED Unbekannter Verbindungsstatus.
DISCONNECTED Dieser Cluster ist derzeit nicht mit Google verbunden.
CONNECTED Dieser Cluster ist derzeit mit Google verbunden.
CONNECTED_AND_SYNCING Dieser Cluster ist derzeit mit Google verbunden, hat aber möglicherweise vor Kurzem nach einer Trennung wieder eine Verbindung hergestellt. Die Synchronisierung läuft noch.

ControlPlane

Konfiguration der Clustersteuerungsebene.

Felder

Union-Feld config.

Für config ist nur einer der folgenden Werte zulässig:
remote

Remote

Konfiguration der Remote-Steuerungsebene.
local

Local

Lokale Konfiguration der Steuerungsebene.

Warnung: Cluster mit lokaler Steuerungsebene müssen in einem eigenen Projekt erstellt werden. Cluster mit lokaler Steuerungsebene können nicht im selben Projekt wie andere Clustertypen vorhanden sein, einschließlich Nicht-GDCE-Clustern. Wenn Sie lokale GDCE-Cluster mit Steuerungsebene mit anderen Clustertypen im selben Projekt kombinieren, kann dies zu Datenverlust führen.

Lokal

Konfiguration speziell für Cluster mit einer lokal gehosteten Steuerungsebene.

Warnung: Cluster mit lokaler Steuerungsebene müssen in einem eigenen Projekt erstellt werden. Cluster mit lokaler Steuerungsebene können nicht im selben Projekt wie andere Clustertypen vorhanden sein, einschließlich Nicht-GDCE-Clustern. Wenn Sie lokale GDCE-Cluster mit Steuerungsebene mit anderen Clustertypen im selben Projekt kombinieren, kann dies zu Datenverlust führen.

Felder
node_location

string

Name der Google Distributed Cloud Edge-Zonen, in denen dieser Knotenpool erstellt wird. Beispiel: us-central1-edge-customer-a.
node_count

int32

Die Anzahl der Knoten, die als Replikate der Steuerungsebene dienen sollen.
machine_filter

string

Nur Maschinen, die diesem Filter entsprechen, dürfen Knoten der Steuerungsebene hosten. Die Filtersprache akzeptiert Strings wie „name=“ und wird hier beschrieben: AIP-160.
shared_deployment_policy

SharedDeploymentPolicy

Richtlinienkonfiguration für die Bereitstellung von Nutzeranwendungen.
control_plane_node_storage_schema

string

Optional. Name für das Speicherschema der Knoten der Steuerungsebene.

Warnung: Die Funktion „Konfigurierbares Schema für lokalen Knotenspeicher“ ist eine experimentelle Funktion und wird nicht für die allgemeine Verwendung in Produktionsclustern/-nodepools empfohlen.

Remote

Dieser Typ hat keine Felder.

Konfiguration für Cluster mit einer Steuerungsebene, die remote gehostet wird.

SharedDeploymentPolicy

Stellt die Richtlinienkonfiguration für die Bereitstellung von Nutzeranwendungen dar.

Enums
SHARED_DEPLOYMENT_POLICY_UNSPECIFIED Nicht angegeben.
ALLOWED Nutzeranwendungen können sowohl auf Knoten der Steuerungsebene als auch auf Worker-Knoten bereitgestellt werden.
DISALLOWED Nutzeranwendungen können nicht auf Knoten der Steuerungsebene, sondern nur auf Worker-Knoten bereitgestellt werden.

ControlPlaneEncryption

Konfiguration für die Unterstützung von kundenverwalteten KMS-Schlüsseln für Knoten der Steuerungsebene.

Felder
kms_key

string

Optional. Der Cloud KMS CryptoKey, z.B. projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}, der zum Schutz von Laufwerken für Steuerungsebenen verwendet werden soll. Wenn keine Angabe erfolgt, wird stattdessen ein von Google verwalteter Schlüssel verwendet.
kms_key_active_version

string

Nur Ausgabe. Die Cloud KMS CryptoKeyVersion, die derzeit zum Schutz von Laufwerken der Steuerungsebene verwendet wird. Gilt nur, wenn „kms_key“ festgelegt ist.
kms_key_state

KmsKeyState

Nur Ausgabe. Verfügbarkeit des Cloud KMS-CryptoKey. Wenn nicht KEY_AVAILABLE, können Knoten offline gehen, da sie nicht auf ihre lokalen Daten zugreifen können. Dies kann an fehlenden Berechtigungen zur Verwendung des Schlüssels oder daran liegen, dass der Schlüssel deaktiviert oder gelöscht wurde.
kms_status

Status

Nur Ausgabe. Der von Cloud KMS zurückgegebene Fehlerstatus bei Verwendung dieses Schlüssels. Dieses Feld darf nur ausgefüllt werden, wenn kms_key_state nicht KMS_KEY_STATE_KEY_AVAILABLE ist. Falls ausgefüllt, enthält dieses Feld den von Cloud KMS gemeldeten Fehlerstatus.
resource_state

ResourceState

Nur Ausgabe. Der aktuelle Ressourcenstatus, der mit dem CMEK verknüpft ist.

ExternalLoadBalancerPool

Externer Load-Balancer-Pool mit benutzerdefinierter Konfiguration wie Name, manuelle/automatische Zuweisung, nicht überlappende IPv4- und optionaler IPv6-Adressbereich.

Felder
address_pool

string

Optional. Name des externen Load-Balancer-Pools.
ipv4_range[]

string

Erforderlich. Nicht überlappender IPv4-Adressbereich des Pools für externe Load Balancer.
ipv6_range[]

string

Optional. Nicht überlappender IPv6-Adressbereich des externen Load-Balancer-Pools.
avoid_buggy_ips

bool

Optional. Bei „true“ werden IP-Adressen, die auf „.0“ und „.255“ enden, aus dem Pool ausgeschlossen. Bestimmte Netzwerkhardware führt zu einem Rückgang des Traffics zu diesen speziellen Adressen. Der Standardwert ist „false“.
manual_assign

bool

Optional. Bei „true“ werden Adressen in diesem Pool nicht automatisch Kubernetes-Diensten zugewiesen. Bei „true“ wird eine IP-Adresse in diesem Pool nur verwendet, wenn sie explizit von einem Dienst angegeben wird. Der Standardwert ist „false“.

MaintenanceEvent

Ein Wartungsereignis ist ein Vorgang, der zu vorübergehenden Unterbrechungen der Clusterarbeitslasten führen kann, z. B. von Google oder vom Nutzer initiierte Clusterupgrades, vom Nutzer initiierte Änderungen der Clusterkonfiguration, die einen Neustart von Knoten erfordern usw.

Felder
uuid

string

Nur Ausgabe. UUID des Wartungsereignisses.
target_version

string

Nur Ausgabe. Die Zielversion des Clusters.
operation

string

Nur Ausgabe. Der Vorgang zum Ausführen des Wartungsereignisses. Wird im Format „projects/*/locations/*/operations/*“ angegeben. Wenn das Wartungsereignis in mehrere Vorgänge unterteilt ist (z.B. aufgrund von Wartungsfenstern), wird der letzte Vorgang aufgezeichnet.
type

Type

Nur Ausgabe. Der Typ des Wartungsereignisses.
schedule

Schedule

Nur Ausgabe. Der Zeitplan des Wartungsereignisses.
state

State

Nur Ausgabe. Der Status des Wartungsereignisses.
create_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem die Wartungsereignisanfrage erstellt wurde.
start_time

Timestamp

Nur Ausgabe. Die Uhrzeit, zu der das Wartungsereignis begonnen hat.
end_time

Timestamp

Nur Ausgabe. Die Uhrzeit, zu der das Wartungsereignis beendet wurde, unabhängig davon, ob es erfolgreich war oder nicht. Wenn das Wartungsereignis in mehrere Wartungsfenster unterteilt ist, wird „end_time“ erst aktualisiert, wenn der gesamte Ablauf beendet ist.
update_time

Timestamp

Nur Ausgabe. Die Uhrzeit, zu der die Nachricht zum Wartungsereignis aktualisiert wurde.

Zeitplan

Gibt an, wann das Wartungsereignis ausgeführt werden soll.

Enums
SCHEDULE_UNSPECIFIED Nicht angegeben.
IMMEDIATELY Unmittelbar nach Erhalt der Anfrage.

Bundesland

Gibt den Status des Wartungsereignisses an.

Enums
STATE_UNSPECIFIED Nicht angegeben.
RECONCILING Das Wartungsereignis läuft. Der Cluster ist möglicherweise nicht nutzbar.
SUCCEEDED Das Wartungsereignis war erfolgreich.
FAILED Das Wartungsereignis ist fehlgeschlagen.

Typ

Gibt den Typ des Wartungsereignisses an.

Enums
TYPE_UNSPECIFIED Nicht angegeben.
USER_INITIATED_UPGRADE Von Nutzern initiiertes Upgrade
GOOGLE_DRIVEN_UPGRADE Upgrade durch Google

ReleaseChannel

Die Release-Version, für die ein Cluster registriert ist.

Enums
RELEASE_CHANNEL_UNSPECIFIED Unbekannte Release-Version. Standardmäßig wird der REGULAR-Channel verwendet.
NONE Keine Release-Version.
REGULAR Reguläre Release-Version.

Status

Gibt den Status des Clusters an.

Enums
STATUS_UNSPECIFIED Status unbekannt.
PROVISIONING Der Cluster wird erstellt.
RUNNING Der Cluster wurde erstellt und ist vollständig nutzbar.
DELETING Der Cluster wird gelöscht.
ERROR Der Status gibt an, dass beim Abgleichen/Löschen des Clusters Fehler aufgetreten sind.
RECONCILING Im Cluster werden gerade Arbeiten wie Versionsupgrades durchgeführt.

SurvivabilityConfig

Konfiguration der Cluster-Survivability, z.B. für den Fall, dass die Netzwerkverbindung unterbrochen wird.

Felder
offline_reboot_ttl

Duration

Optional. Zeitraum, in dem die Clusterknoten neu gestartet werden können und ohne Netzwerkverbindung zu Google funktionsfähig sind. Der Standardwert 0 bedeutet „nicht zulässig“. Die maximale Dauer beträgt 7 Tage.

SystemAddonsConfig

Konfiguration, die Kunden für GDCE-System-Add-ons definieren dürfen.

Felder
ingress

Ingress

Optional. Konfiguration für Ingress.
vm_service_config

VMServiceConfig

Optional. Konfiguration für den VM-Dienst.

Eingehender Traffic

Konfiguration für das Ingress-Add-on, mit dem Kunden ein Ingress-Objekt erstellen können, um den externen Zugriff auf die Server in einem Cluster zu verwalten. Das Add-on besteht aus istiod und istio-ingress.

Felder
disabled

bool

Optional. Gibt an, ob Ingress deaktiviert ist.
ipv4_vip

string

Optional. Ingress-VIP.

VMServiceConfig

VMServiceConfig definiert die Konfiguration für den GDCE-VM-Dienst.

Felder
vmm_enabled

bool

Optional. Gibt an, ob VMM aktiviert ist.

ZoneStorageEncryption

Konfiguration für die CMEK-Unterstützung für Zonenspeicher

Felder
kms_key

string

Optional. Cloud KMS-Schlüssel
kms_key_active_version

string

Nur Ausgabe. Die Cloud KMS CryptoKeyVersion, die derzeit für die Verschlüsselung/Entschlüsselung verwendet wird
resource_state

ResourceState

Nur Ausgabe. Der aktuelle Ressourcenstatus von CMEK

ClusterNetworking

Clusterweite Netzwerkkonfiguration.

Felder
cluster_ipv4_cidr_blocks[]

string

Erforderlich. Allen Pods im Cluster wird eine RFC1918-IPv4-Adresse aus diesen Blöcken zugewiesen. Es wird nur ein einzelner Block unterstützt. Dieses Feld kann nach dem Erstellen nicht mehr geändert werden.
services_ipv4_cidr_blocks[]

string

Erforderlich. Allen Diensten im Cluster wird eine RFC1918-IPv4-Adresse aus diesen Blöcken zugewiesen. Es wird nur ein einzelner Block unterstützt. Dieses Feld kann nach dem Erstellen nicht mehr geändert werden.

ClusterUser

Ein Nutzerprinzipal für eine RBAC-Richtlinie.

Felder
username

string

Erforderlich. Sie haben einen aktiven Google-Nutzernamen.

ConfigData

„Config data“ enthält alle konfigurationsbezogenen Daten für die Zone.

Felder
available_external_lb_pools_ipv4[]

string

Liste der verfügbaren IPv4-Adresspools für externe Load-Balancer
available_external_lb_pools_ipv6[]

string

Liste der verfügbaren IPv6-Adresspools für externe Load Balancer

CreateClusterRequest

Erstellt einen Cluster.

Felder
parent

string

Erforderlich. Der übergeordnete Standort, an dem dieser Cluster erstellt wird.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource parent:

  • edgecontainer.clusters.create
cluster_id

string

Erforderlich. Eine vom Client angegebene eindeutige Kennung für den Cluster.
cluster

Cluster

Erforderlich. Der zu erstellende Cluster.
request_id

string

Eine eindeutige Kennung für diese Anfrage. Auf 36 ASCII-Zeichen beschränkt. Eine zufällige UUID wird empfohlen. Diese Anfrage ist nur idempotent, wenn request_id angegeben wird.

CreateNodePoolRequest

Erstellt einen Knotenpool.

Felder
parent

string

Erforderlich. Der übergeordnete Cluster, in dem dieser Knotenpool erstellt wird.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource parent:

  • edgecontainer.nodePools.create
node_pool_id

string

Erforderlich. Eine vom Client angegebene eindeutige Kennung für den Knotenpool.
node_pool

NodePool

Erforderlich. Der zu erstellende Knotenpool.
request_id

string

Eine eindeutige Kennung für diese Anfrage. Auf 36 ASCII-Zeichen beschränkt. Eine zufällige UUID wird empfohlen. Diese Anfrage ist nur idempotent, wenn request_id angegeben wird.

CreateVpnConnectionRequest

Erstellt eine VPN-Verbindung.

Felder
parent

string

Erforderlich. Der übergeordnete Standort, an dem diese VPN-Verbindung erstellt wird.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource parent:

  • edgecontainer.vpnConnections.create
vpn_connection_id

string

Erforderlich. Die Kennung der VPN-Verbindung.
vpn_connection

VpnConnection

Erforderlich. Die zu erstellende VPN-Verbindung.
request_id

string

Eine eindeutige Kennung für diese Anfrage. Auf 36 ASCII-Zeichen beschränkt. Eine zufällige UUID wird empfohlen. Diese Anfrage ist nur idempotent, wenn request_id angegeben wird.

DeleteClusterRequest

Löscht einen Cluster.

Felder
name

string

Erforderlich. Der Ressourcenname des Clusters.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource name:

  • edgecontainer.clusters.delete
request_id

string

Eine eindeutige Kennung für diese Anfrage. Auf 36 ASCII-Zeichen beschränkt. Eine zufällige UUID wird empfohlen. Diese Anfrage ist nur idempotent, wenn request_id angegeben wird.

DeleteNodePoolRequest

Löscht einen Knotenpool.

Felder
name

string

Erforderlich. Der Ressourcenname des Knotenpools.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource name:

  • edgecontainer.nodePools.delete
request_id

string

Eine eindeutige Kennung für diese Anfrage. Auf 36 ASCII-Zeichen beschränkt. Eine zufällige UUID wird empfohlen. Diese Anfrage ist nur idempotent, wenn request_id angegeben wird.

DeleteVpnConnectionRequest

Löscht eine VPN-Verbindung.

Felder
name

string

Erforderlich. Der Ressourcenname der VPN-Verbindung.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource name:

  • edgecontainer.vpnConnections.delete
request_id

string

Eine eindeutige Kennung für diese Anfrage. Auf 36 ASCII-Zeichen beschränkt. Eine zufällige UUID wird empfohlen. Diese Anfrage ist nur idempotent, wenn request_id angegeben wird.

Flotte

Flottenbezogene Konfiguration.

Flotten sind ein Google Cloud-Konzept für die logische Organisation von Clustern, mit dem Sie Multi-Cluster-Funktionen nutzen und verwalten sowie einheitliche Richtlinien auf Ihre Systeme anwenden können.

Felder
project

string

Erforderlich. Der Name des Flotten-Hostprojekts, in dem dieser Cluster registriert wird.

Projektnamen werden im Format projects/<project-number> angegeben.
membership

string

Nur Ausgabe. Der Name der verwalteten Hub-Mitgliedschaftsressource, die diesem Cluster zugeordnet ist.

Mitgliedschaftsnamen werden im Format projects/<project-number>/locations/global/membership/<cluster-id> angegeben.

GenerateAccessTokenRequest

Generiert ein Zugriffstoken für einen Cluster.

Felder
cluster

string

Erforderlich. Der Ressourcenname des Clusters.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource cluster:

  • edgecontainer.clusters.get

GenerateAccessTokenResponse

Ein Zugriffstoken für einen Cluster.

Felder
access_token

string

Nur Ausgabe. Zugriffstoken für die Authentifizierung beim k8s-API-Server.
expire_time

Timestamp

Nur Ausgabe. Zeitstempel, zu dem das Token abläuft.

GenerateOfflineCredentialRequest

Generiert Anmeldedaten für die Offline-Authentifizierung für einen Cluster.

Felder
cluster

string

Erforderlich. Der Ressourcenname des Clusters.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource cluster:

  • edgecontainer.clusters.get

GenerateOfflineCredentialResponse

Offline-Anmeldedaten für einen Cluster.

Felder
client_certificate

string

Nur Ausgabe. Clientzertifikat für die Authentifizierung beim K8s-API-Server.
client_key

string

Nur Ausgabe. Privater Clientschlüssel für die Authentifizierung beim K8s-API-Server.
user_id

string

Nur Ausgabe. Identität des Kunden.
expire_time

Timestamp

Nur Ausgabe. Zeitstempel, zu dem diese Anmeldedaten ablaufen.

GetClusterRequest

Ruft einen Cluster ab.

Felder
name

string

Erforderlich. Der Ressourcenname des Clusters.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource name:

  • edgecontainer.clusters.get

GetMachineRequest

Ruft eine Maschine ab.

Felder
name

string

Erforderlich. Der Ressourcenname des Computers.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource name:

  • edgecontainer.machines.get

GetNodePoolRequest

Ruft einen Knotenpool ab.

Felder
name

string

Erforderlich. Der Ressourcenname des Knotenpools.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource name:

  • edgecontainer.nodePools.get

GetServerConfigRequest

Ruft die Serverkonfiguration ab.

Felder
name

string

Erforderlich. Der Name (Projekt und Standort) der abzurufenden Serverkonfiguration im Format projects/*/locations/*.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource name:

  • edgecontainer.serverConfig.get

GetVpnConnectionRequest

Stellt eine VPN-Verbindung her.

Felder
name

string

Erforderlich. Der Ressourcenname der VPN-Verbindung.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource name:

  • edgecontainer.vpnConnections.get

KmsKeyState

Stellt den Zugriffsstatus eines vom Kunden verwalteten KMS-Schlüssels dar, der für die CMEK-Integration verwendet wird.

Enums
KMS_KEY_STATE_UNSPECIFIED Nicht angegeben.
KMS_KEY_STATE_KEY_AVAILABLE Der Schlüssel ist verfügbar und abhängige Ressourcen sollten zugänglich sein.
KMS_KEY_STATE_KEY_UNAVAILABLE Der Schlüssel ist aus einem nicht näher bezeichneten Grund nicht verfügbar. Abhängige Ressourcen sind möglicherweise nicht zugänglich.

ListClustersRequest

Listet Cluster an einem Standort auf.

Felder
parent

string

Erforderlich. Der übergeordnete Standort, der diese Sammlung von Clustern besitzt.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource parent:

  • edgecontainer.clusters.list
page_size

int32

Die maximale Anzahl der aufzulistenden Ressourcen.
page_token

string

Ein Seitentoken, das von einer vorherigen Listenanfrage empfangen wurde. Ein Seitentoken, das von einer vorherigen Listenanfrage empfangen wurde.
filter

string

Es werden nur Ressourcen aufgeführt, die diesem Filter entsprechen.
order_by

string

Gibt die Reihenfolge an, in der Ressourcen aufgeführt werden.

ListClustersResponse

Liste der Cluster an einem Standort.

Felder
clusters[]

Cluster

Cluster am Standort.
next_page_token

string

Ein Token zum Abrufen der nächsten Ergebnisseite.
unreachable[]

string

Standorte, die nicht erreicht werden konnten.

ListMachinesRequest

Listet Maschinen an einem Standort auf.

Felder
parent

string

Erforderlich. Die übergeordnete Website, die diese Sammlung von Maschinen besitzt.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource parent:

  • edgecontainer.machines.list
page_size

int32

Die maximale Anzahl der aufzulistenden Ressourcen.
page_token

string

Ein Seitentoken, das von einer vorherigen Listenanfrage empfangen wurde.
filter

string

Es werden nur Ressourcen aufgeführt, die diesem Filter entsprechen.
order_by

string

Gibt die Reihenfolge an, in der Ressourcen aufgeführt werden.

ListMachinesResponse

Liste der Maschinen an einem Standort.

Felder
machines[]

Machine

Maschinen auf dem Gelände
next_page_token

string

Ein Token zum Abrufen der nächsten Ergebnisseite.
unreachable[]

string

Standorte, die nicht erreicht werden konnten.

ListNodePoolsRequest

Listet Knotenpools in einem Cluster auf.

Felder
parent

string

Erforderlich. Der übergeordnete Cluster, der diese Sammlung von Knotenpools besitzt.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource parent:

  • edgecontainer.nodePools.list
page_size

int32

Die maximale Anzahl der aufzulistenden Ressourcen.
page_token

string

Ein Seitentoken, das von einer vorherigen Listenanfrage empfangen wurde.
filter

string

Es werden nur Ressourcen aufgeführt, die diesem Filter entsprechen.
order_by

string

Gibt die Reihenfolge an, in der Ressourcen aufgeführt werden.

ListNodePoolsResponse

Liste der Knotenpools in einem Cluster.

Felder
node_pools[]

NodePool

Knotenpools im Cluster.
next_page_token

string

Ein Token zum Abrufen der nächsten Ergebnisseite.
unreachable[]

string

Standorte, die nicht erreicht werden konnten.

ListVpnConnectionsRequest

Listet VPN-Verbindungen auf.

Felder
parent

string

Erforderlich. Der übergeordnete Standort, der diese Sammlung von VPN-Verbindungen besitzt.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource parent:

  • edgecontainer.vpnConnections.list
page_size

int32

Die maximale Anzahl der aufzulistenden Ressourcen.
page_token

string

Ein Seitentoken, das von einer vorherigen Listenanfrage empfangen wurde.
filter

string

Es werden nur Ressourcen aufgeführt, die diesem Filter entsprechen.
order_by

string

Gibt die Reihenfolge an, in der Ressourcen aufgeführt werden.

ListVpnConnectionsResponse

Liste der VPN-Verbindungen an einem Standort.

Felder
vpn_connections[]

VpnConnection

VpnConnections am Standort.
next_page_token

string

Ein Token zum Abrufen der nächsten Ergebnisseite.
unreachable[]

string

Standorte, die nicht erreicht werden konnten.

LocationMetadata

Metadaten für ein bestimmtes google.cloud.location.Location.

Felder
available_zones

map<string, ZoneMetadata>

Die Menge der verfügbaren Google Distributed Cloud Edge-Zonen am Standort. Die Karte wird anhand der kleingeschriebenen ID jeder Zone indexiert.

Maschine

Eine Google Distributed Cloud Edge-Maschine, die als Kubernetes-Knoten fungieren kann.

Felder
name

string

Erforderlich. Der Ressourcenname des Computers.
create_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Knotenpool erstellt wurde.
update_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Knotenpool zuletzt aktualisiert wurde.
labels

map<string, string>

Mit dieser Ressource verknüpfte Labels.
hosted_node

string

Der kanonische Ressourcenname des Knotens, für den diese Maschine zuständig ist, z. B. projects/{project}/locations/{location}/clusters/{cluster_id}/nodePools/{pool_id}/{node}. Ist leer, wenn die Maschine nicht als Knoten zugewiesen ist.

Für Steuerungsebenenknoten, die auf Edge-Maschinen gehostet werden, wird das folgende Format zurückgegeben: „projects/{project}/locations/{location}/clusters/{cluster_id}/controlPlaneNodes/{node}“.
zone

string

Die Google Distributed Cloud Edge-Zone dieser Maschine.
version

string

Nur Ausgabe. Die Softwareversion der Maschine.
disabled

bool

Nur Ausgabe. Gibt an, ob die Maschine deaktiviert ist. Wenn diese Option deaktiviert ist, kann die Maschine nicht in Betrieb genommen werden.
status

Status

Nur Ausgabe. Der aktuelle Status der Maschine.
purpose

Purpose

Der Clustertyp, für den die Maschine verwendet wird.

Zweck

Der Zweck der Maschine kann entweder VIRTUALIZED_WORKLOAD oder BAREMETAL_CLUSTER sein.

Enums
PURPOSE_UNSPECIFIED Zweck nicht angegeben.
VIRTUALIZED_WORKLOAD Die Maschine wird für virtuelle Arbeitslasten verwendet.
BAREMETAL_CLUSTER Die Maschine wird für einen Bare-Metal-Nutzercluster verwendet.

Status

Gibt den Status der Maschine an.

Enums
STATUS_UNSPECIFIED Status unbekannt.
READY Auf dem Computer kann ein Knoten gehostet werden. Das ist die Standardeinstellung.
DISABLED_FOR_REPAIR Die Maschine wurde durch Hinzufügen von mindestens einem Deaktivierungsanspruch für die Reparatur deaktiviert.

MaintenanceExclusionWindow

Stellt ein Wartungsausschlussfenster dar.

Felder
window

TimeWindow

Optional. Das Zeitfenster.
id

string

Optional. Eine eindeutige ID (pro Cluster) für das Zeitfenster.

MaintenancePolicy

Konfiguration der Wartungsrichtlinie.

Felder
window

MaintenanceWindow

Gibt das Wartungsfenster an, in dem Wartungsarbeiten durchgeführt werden dürfen.
maintenance_exclusions[]

MaintenanceExclusionWindow

Optional. Ausschlüsse für die automatische Wartung Wartungsarbeiten, die keine Notfälle sind, sollten nicht in diesen Zeiträumen stattfinden. Jeder Ausschluss hat einen eindeutigen Namen und kann aktiv oder abgelaufen sein. Es sind maximal drei Wartungsausschlüsse gleichzeitig zulässig.

MaintenanceWindow

Konfiguration des Wartungsfensters

Felder
recurring_window

RecurringTimeWindow

Konfiguration eines wiederkehrenden Wartungsfensters.

Knotenpool

Eine Gruppe von Kubernetes-Knoten in einem Cluster mit gemeinsamer Konfiguration und Spezifikation.

Felder
name

string

Erforderlich. Der Ressourcenname des Knotenpools.
create_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Knotenpool erstellt wurde.
update_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Knotenpool zuletzt aktualisiert wurde.
labels

map<string, string>

Mit dieser Ressource verknüpfte Labels.
node_location

string

Name der Google Distributed Cloud Edge-Zone, in der dieser Knotenpool erstellt wird. Beispiel: us-central1-edge-customer-a.
node_count

int32

Erforderlich. Die Anzahl der Knoten im Pool.
machine_filter

string

Nur Maschinen, die diesem Filter entsprechen, dürfen dem Knotenpool beitreten. Die Filtersprache akzeptiert Strings wie „name=“ und wird unter AIP-160 genauer beschrieben.
local_disk_encryption

LocalDiskEncryption

Optional. Optionen für die Verschlüsselung lokaler Festplatten. Dieses Feld wird nur verwendet, wenn die CMEK-Unterstützung aktiviert wird.
node_version

string

Nur Ausgabe. Die niedrigste Release-Version aller Worker-Knoten.
node_config

NodeConfig

Optional. Konfiguration für jeden Knoten im NodePool

LocalDiskEncryption

Konfiguration für die CMEK-Unterstützung für die Verschlüsselung lokaler Laufwerke von Edge-Maschinen.

Felder
kms_key

string

Optional. Der Cloud KMS CryptoKey, z.B. projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}, der zum Schutz lokaler Knotenlaufwerke verwendet werden soll. Wenn keine Angabe erfolgt, wird stattdessen ein von Google verwalteter Schlüssel verwendet.
kms_key_active_version

string

Nur Ausgabe. Die Cloud KMS CryptoKeyVersion, die derzeit zum Schutz lokaler Knotenlaufwerke verwendet wird. Gilt nur, wenn „kms_key“ festgelegt ist.
kms_key_state

KmsKeyState

Nur Ausgabe. Verfügbarkeit des Cloud KMS-CryptoKey. Wenn nicht KEY_AVAILABLE, können Knoten offline gehen, da sie nicht auf ihre lokalen Daten zugreifen können. Dies kann an fehlenden Berechtigungen zur Verwendung des Schlüssels oder daran liegen, dass der Schlüssel deaktiviert oder gelöscht wurde.
kms_status

Status

Nur Ausgabe. Der von Cloud KMS zurückgegebene Fehlerstatus bei Verwendung dieses Schlüssels. Dieses Feld darf nur ausgefüllt werden, wenn kms_key_state nicht KMS_KEY_STATE_KEY_AVAILABLE ist. Falls ausgefüllt, enthält dieses Feld den von Cloud KMS gemeldeten Fehlerstatus.
resource_state

ResourceState

Nur Ausgabe. Der aktuelle Ressourcenstatus, der mit dem CMEK verknüpft ist.

NodeConfig

Konfiguration für jeden Knoten im NodePool

Felder
labels

map<string, string>

Optional. Die Kubernetes-Knotenlabels
node_storage_schema

string

Optional. Name für das Speicherschema von Worker-Knoten.

Warnung: Die Funktion „Konfigurierbares Schema für lokalen Knotenspeicher“ ist eine experimentelle Funktion und wird nicht für die allgemeine Verwendung in Produktionsclustern/-nodepools empfohlen.

OperationMetadata

Metadaten für Vorgänge mit langer Ausführungszeit für Edge Container API-Methoden.

Felder
create_time

Timestamp

Der Zeitpunkt, zu dem der Vorgang erstellt wurde.
end_time

Timestamp

Der Zeitpunkt, zu dem der Vorgang abgeschlossen wurde.
target

string

Serverdefinierter Ressourcenpfad für das Ziel des Vorgangs.
verb

string

Das vom Vorgang ausgeführte Verb.
status_message

string

Lesbarer Status des Vorgangs, falls vorhanden.
requested_cancellation

bool

Gibt an, ob der Nutzer einen Abbruch angefordert hat. Vorgänge, die erfolgreich abgebrochen wurden, haben den Wert [Operation.error][] mit einem google.rpc.Status.code von 1, was Code.CANCELLED entspricht.
api_version

string

Zum Starten des Vorgangs verwendete API-Version.
warnings[]

string

Warnungen, die den Vorgang nicht blockieren, aber dennoch relevante Informationen für den Endnutzer enthalten.
status_reason

StatusReason

Maschinenlesbarer Status des Vorgangs, falls vorhanden.

StatusReason

Gibt den Grund für den Status des Vorgangs an.

Enums
STATUS_REASON_UNSPECIFIED Ursache unbekannt.
UPGRADE_PAUSED Das Cluster-Upgrade ist derzeit pausiert.

Kontingent

Stellt das Kontingent für Edge-Container-Ressourcen dar.

Felder
metric

string

Name des Kontingentmesswerts.
limit

double

Kontingentlimit für diesen Messwert.
usage

double

Aktuelle Verwendung dieses Messwerts.

RecurringTimeWindow

Stellt ein beliebiges Zeitfenster dar, das wiederkehrt.

Felder
window

TimeWindow

Das Fenster des ersten Wiederholungsereignisses.
recurrence

string

Eine RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) für die Wiederholung dieses Fensters. Sie werden über den Zeitraum zwischen Start- und Endzeit ausgeführt.

ResourceState

Gibt an, ob sich die Ressource im Sperrzustand befindet oder aussteht.

Enums
RESOURCE_STATE_UNSPECIFIED Standardwert.
RESOURCE_STATE_LOCK_DOWN Die Ressource befindet sich im Status „GESPERRT“.
RESOURCE_STATE_LOCK_DOWN_PENDING Die Ressource ist zum Sperren vorgesehen.

ServerConfig

Serverkonfiguration für unterstützte Versionen und Release-Versionen.

Felder
channels

map<string, ChannelConfig>

Nur Ausgabe. Zuordnung von Release-Version zu Channel-Konfiguration.
versions[]

Version

Nur Ausgabe. Unterstützte Versionen, z.B.: ["1.4.0", "1.5.0"].
default_version

string

Nur Ausgabe. Standardversion, z.B.: „1.4.0“.

TimeWindow

Stellt einen beliebigen Zeitraum dar.

Felder
start_time

Timestamp

Der Zeitpunkt, zu dem das Zeitfenster beginnt.
end_time

Timestamp

Die Uhrzeit, zu der das Zeitfenster endet. Das Ende muss nach dem Beginn liegen.

UpdateClusterRequest

Aktualisiert einen Cluster.

Felder
update_mask

FieldMask

Mit der Feldmaske werden die Felder angegeben, die in der Cluster-Ressource durch die Aktualisierung überschrieben werden sollen. Die in „update_mask“ angegebenen Felder beziehen sich auf die Ressource und nicht auf die vollständige Anfrage. Ein Feld wird überschrieben, wenn es in der Maske enthalten ist. Wenn der Nutzer keine Maske angibt, werden alle Felder überschrieben.
cluster

Cluster

Der aktualisierte Cluster.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource cluster:

  • edgecontainer.clusters.update
request_id

string

Eine eindeutige Kennung für diese Anfrage. Auf 36 ASCII-Zeichen beschränkt. Eine zufällige UUID wird empfohlen. Diese Anfrage ist nur idempotent, wenn request_id angegeben wird.

UpdateNodePoolRequest

Aktualisiert einen Knotenpool.

Felder
update_mask

FieldMask

Mit der Feldmaske werden die Felder angegeben, die in der NodePool-Ressource durch die Aktualisierung überschrieben werden sollen. Die in „update_mask“ angegebenen Felder beziehen sich auf die Ressource und nicht auf die vollständige Anfrage. Ein Feld wird überschrieben, wenn es in der Maske enthalten ist. Wenn der Nutzer keine Maske angibt, werden alle Felder überschrieben.
node_pool

NodePool

Der aktualisierte Knotenpool.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource nodePool:

  • edgecontainer.nodePools.update
request_id

string

Eine eindeutige Kennung für diese Anfrage. Auf 36 ASCII-Zeichen beschränkt. Eine zufällige UUID wird empfohlen. Diese Anfrage ist nur idempotent, wenn request_id angegeben wird.

UpgradeClusterRequest

Führt ein Upgrade für einen Cluster durch.

Felder
name

string

Erforderlich. Der Ressourcenname des Clusters.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource name:

  • edgecontainer.clusters.upgrade
target_version

string

Erforderlich. Die Version, auf die der Cluster aktualisiert wird.
schedule

Schedule

Zeitplan für das Upgrade
request_id

string

Eine eindeutige Kennung für diese Anfrage. Auf 36 ASCII-Zeichen beschränkt. Eine zufällige UUID wird empfohlen. Diese Anfrage ist nur idempotent, wenn request_id angegeben wird.

Zeitplan

Gibt den Zeitplan für das Upgrade des Clusters an.

Enums
SCHEDULE_UNSPECIFIED Nicht angegeben. Standardmäßig wird der Cluster sofort aktualisiert. Das ist derzeit die einzige Option.
IMMEDIATELY Der Cluster wird unmittelbar nach Eingang der Anfrage aktualisiert.

Version

Version eines Clusters.

Felder
name

string

Nur Ausgabe. Name der Version, z.B.: „1.4.0“.

VpnConnection

Eine VPN-Verbindung

Felder
name

string

Erforderlich. Der Ressourcenname der VPN-Verbindung
create_time

Timestamp

Nur Ausgabe. Die Uhrzeit, zu der die VPN-Verbindung erstellt wurde.
update_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem die VPN-Verbindung zuletzt aktualisiert wurde.
labels

map<string, string>

Mit dieser Ressource verknüpfte Labels.
nat_gateway_ip

string

NAT-Gateway-IP-Adresse oder WAN-IP-Adresse. Wenn ein Kunde mehrere NAT-IP-Adressen hat, muss er NAT so konfigurieren, dass nur eine externe IP-Adresse dem GMEC-Anthos-Cluster zugeordnet wird. Dieses Feld ist leer, wenn NAT nicht verwendet wird.
bgp_routing_mode
(deprecated)

BgpRoutingMode

Dynamischer Routingmodus des VPC-Netzwerk, regional oder global.
cluster

string

Der kanonische Clustername, zu dem eine Verbindung hergestellt werden soll. Sie hat das Format „projects/{project}/locations/{location}/clusters/{cluster}“.
vpc

string

Die Netzwerk-ID der VPC, mit der eine Verbindung hergestellt werden soll.
vpc_project

VpcProject

Optional. Projektdetails des VPC-Netzwerk. Erforderlich, wenn sich die VPC in einem anderen Projekt als dem Clusterprojekt befindet.
enable_high_availability

bool

Gibt an, ob für diese VPN-Verbindung HA auf Clusterseite aktiviert ist. Wenn diese Option aktiviert ist, wird beim Erstellen einer VPN-Verbindung versucht, zwei ANG-Floating-IP-Adressen zu verwenden.
router

string

Optional. Der Name des Cloud Router für die VPN-Verbindung.
details

Details

Nur Ausgabe. Die erstellten Verbindungsdetails.

BgpRoutingMode

Routingmodus

Enums
BGP_ROUTING_MODE_UNSPECIFIED Unbekannt
REGIONAL Regionaler Modus
GLOBAL Globaler Modus

Details

Die erstellten Verbindungsdetails.

Felder
state

State

Der Status dieser Verbindung.
error

string

Die Fehlermeldung. Wird nur ausgefüllt, wenn state=ERROR.
cloud_router

CloudRouter

Die Cloud Router-Informationen.
cloud_vpns[]

CloudVpn

Jede Verbindung hat mehrere Cloud VPN-Gateways.

CloudRouter

Die Cloud Router-Informationen.

Felder
name

string

Der zugehörige Name des Cloud Router.

CloudVpn

Die Cloud VPN-Informationen.

Felder
gateway

string

Der Name des erstellten Cloud VPN-Gateways.

Bundesland

Der aktuelle Verbindungsstatus.

Enums
STATE_UNSPECIFIED Unbekannt
STATE_CONNECTED Verbunden.
STATE_CONNECTING Es wird weiterhin versucht, die Verbindung herzustellen.
STATE_ERROR Ein Fehler ist aufgetreten.

VpcProject

Projektdetails des VPC-Netzwerk.

Felder
project_id

string

Das Projekt der VPC, mit der eine Verbindung hergestellt werden soll. Wenn keine Angabe erfolgt, ist es dasselbe wie das Clusterprojekt.
service_account
(deprecated)

string

Optional. Veraltet: Nicht verwenden.

ZoneMetadata

Eine Google Distributed Cloud Edge-Zone, in der sich Edge-Maschinen befinden.

Felder
quota[]

Quota

Kontingent für Ressourcen in dieser Zone.
rack_types

map<string, RackType>

Die Karte ist nach Rackname sortiert und hat den Wert RackType.
config_data

ConfigData

Konfigurationsdaten für die Zone.

RackType

Typ des Racks.

Enums
RACK_TYPE_UNSPECIFIED Nicht angegebener Racktyp. Einzelne Racks gehören ebenfalls zu diesem Typ.
BASE Basistyp des Racks, ein Paar von zwei modifizierten Config-1-Racks mit Aggregations-Switches.
EXPANSION Erweiterungsracks, auch als Standalone-Racks bezeichnet, die von Kunden auf Anfrage hinzugefügt werden.