Package google.cloud.edgecontainer.v1

Index

EdgeContainer

Die EdgeContainer API ermöglicht 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 Offline-Anmeldedaten 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 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.
ListMachines

rpc ListMachines(ListMachinesRequest) returns (ListMachinesResponse)

Listet Maschinen 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.
ListNodePools

rpc ListNodePools(ListNodePoolsRequest) returns (ListNodePoolsResponse)

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

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 in Zukunft erweitert, um mehrere Administratoren zuzulassen.

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. Der Zeitpunkt, zu dem der Cluster erstellt wurde.
update_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem 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. Konfiguration der clusterweiten 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 Cluster-Steuerungsebene.
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 Cluster-Datenebene.
control_plane_encryption

ControlPlaneEncryption

Optional. Optionen für die Laufwerksverschlü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 für den Cluster geplanten Wartungsereignisse, einschließlich der laufenden, der für die Zukunft geplanten und der in der Vergangenheit (bis zu 90 Tage) durchgeführten Ereignisse.
target_version

string

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

ReleaseChannel

Optional. Die Release-Version, die ein Cluster abonniert hat.
survivability_config

SurvivabilityConfig

Optional. Konfiguration der Cluster-Überlebensfähigkeit, 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 das externe Load Balancing der Cluster-Datenebene.
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 Verschlüsselung des Zonenspeichers
container_runtime_config

ContainerRuntimeConfig

Optional. Die Containerlaufzeitkonfiguration des Clusters.
enable_remote_backup

bool

Optional. Wenn „true“, wird die Remote-Sicherungs-/Wiederherstellungsfunktion für diesen Cluster aktiviert.
enable_cluster_isolation

bool

Optional. Gibt an, ob der Cluster isoliert werden muss. go/cluster-isolation-in-gdcc-cluster
google_group_authentication

GoogleGroupAuthenticationConfig

Optional. Die Google-Gruppenauthentifizierungskonfiguration des Clusters.

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, wurde aber möglicherweise vor Kurzem nach einer Trennung wieder verbunden. Die Synchronisierung ist noch nicht abgeschlossen.

ContainerRuntimeConfig

Containerlaufzeitkonfiguration des Clusters.

Felder
default_container_runtime

DefaultContainerRuntime

Optional. Die Standard-Containerlaufzeit, die im Cluster konfiguriert werden soll.

DefaultContainerRuntime

Liste der unterstützten Containerlaufzeiten.

Enums
DEFAULT_CONTAINER_RUNTIME_UNSPECIFIED Containerlaufzeit nicht angegeben.
RUNC Verwenden Sie runc als Standard-Containerlaufzeit im Cluster.
GVISOR gVisor als Standard-Containerlaufzeit im Cluster verwenden.

ControlPlane

Konfiguration der Cluster-Steuerungsebene.

Felder

Union-Feld config.

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

Remote

Konfiguration der Remote-Steuerungsebene.
local

Local

Konfiguration der lokalen Steuerungsebene.

Warnung: Cluster mit lokaler Steuerungsebene müssen in einem eigenen Projekt erstellt werden. Cluster mit lokaler Steuerungsebene können nicht im selben Projekt mit anderen Clustertypen koexistieren, einschließlich Nicht-GDCE-Clustern. Wenn Sie GDCE-Cluster mit lokaler 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 mit anderen Clustertypen koexistieren, einschließlich Nicht-GDCE-Clustern. Wenn Sie GDCE-Cluster mit lokaler 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, können Knoten der Steuerungsebene hosten. Die Filtersprache akzeptiert Strings wie „name=“ und wird unter AIP-160 genauer beschrieben.
shared_deployment_policy

SharedDeploymentPolicy

Richtlinienkonfiguration für die Bereitstellung von Nutzeranwendungen.
control_plane_node_storage_schema

string

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

SystemPartitionGiBSize

Optional. Größe der Systempartition für Knoten der Steuerungsebene in GiB.

Remote

Dieser Typ hat keine Felder.

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

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 der Steuerungsebene 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 liegen oder daran, dass der Schlüssel deaktiviert oder gelöscht wurde.
kms_status

Status

Nur Ausgabe. Fehlerstatus, der von Cloud KMS zurückgegeben wird, wenn dieser Schlüssel verwendet wird. Dieses Feld darf nur ausgefüllt werden, wenn kms_key_state nicht KMS_KEY_STATE_KEY_AVAILABLE ist. Wenn dieses Feld ausgefüllt ist, enthält es 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, z. B. Name, manuelle/automatische Zuweisung, nicht überlappender 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 externen Load-Balancer-Pools.
ipv6_range[]

string

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

bool

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

bool

Optional. Wenn „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“.

GoogleGroupAuthenticationConfig

Konfiguration der Google Groups-Authentifizierung des Clusters. go/gdc-google-group-authentication

Felder
enable

bool

Optional. Wenn „true“, wird der Cluster für die Verwendung der Google-Gruppenauthentifizierung konfiguriert.

MaintenanceEvent

Ein Wartungsereignis ist ein Vorgang, der zu vorübergehenden Unterbrechungen der Clusterarbeitslasten führen kann, einschließlich von Google gesteuerter oder vom Nutzer initiierter Clusterupgrades, vom Nutzer initiierter Ä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 aufgeteilt 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 Anfrage für das Wartungsereignis erstellt wurde.
start_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem das Wartungsereignis gestartet wurde.
end_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem das Wartungsereignis beendet wurde, entweder erfolgreich oder nicht. Wenn das Wartungsereignis in mehrere Wartungsfenster aufgeteilt ist, wird „end_time“ erst aktualisiert, wenn der gesamte Ablauf beendet ist.
update_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem die Nachricht zum Wartungsereignis aktualisiert wurde.

Zeitplan

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

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

Bundesland

Gibt den Status des Wartungsereignisses an.

Enums
STATE_UNSPECIFIED Nicht angegeben.
RECONCILING Das Wartungsereignis ist aktiv. Der Cluster ist möglicherweise nicht verwendbar.
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 Upgrade, das von Nutzern initiiert wurde.
GOOGLE_DRIVEN_UPGRADE Upgrade von Google.

ReleaseChannel

Die Release-Version, die ein Cluster abonniert hat.

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 einige Fehler aufgetreten sind.
RECONCILING Am Cluster werden gerade Arbeiten wie Versionsupgrades usw. durchgeführt.

SurvivabilityConfig

Konfiguration der Cluster-Überlebensfähigkeit, z.B. für den Fall, dass die Netzwerkverbindung unterbrochen wird.

Felder
offline_reboot_ttl

Duration

Optional. Zeitraum, in dem die Clusterknoten neu gestartet und ohne Netzwerkverbindung zu Google funktionsfähig werden können. Der Standardwert 0 bedeutet, dass die Option nicht zulässig ist. Maximal sind 30 Tage möglich.

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 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. Virtuelle IP-Adresse für eingehenden Traffic.

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 CMEK-Unterstützung für Zonenspeicher

Felder
kms_key

string

Optional. Der 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 des 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 Nutzerhauptkonto für eine RBAC-Richtlinie.

Felder
username

string

Erforderlich. Einen aktiven Google-Nutzernamen.

ConfigData

Konfigurationsdaten enthalten alle konfigurationsbezogenen Daten für die Zone.

Felder
available_external_lb_pools_ipv4[]

string

Liste der verfügbaren v4-IP-Pools für externe Load Balancer
available_external_lb_pools_ipv6[]

string

Liste der verfügbaren v6-IP-Pools 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 ist.

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

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

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

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

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

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

GenerateAccessTokenResponse

Ein Zugriffstoken für einen Cluster.

Felder
access_token

string

Nur Ausgabe. Zugriffstoken zur Authentifizierung beim k8s-API-Server.
expire_time

Timestamp

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

GenerateOfflineCredentialRequest

Generiert Offline-Anmeldedaten(offline) 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.generateOfflineCredential

GenerateOfflineCredentialResponse

Ein Offline-Ausweis für einen Cluster.

Felder
client_certificate

string

Nur Ausgabe. Clientzertifikat zur Authentifizierung beim k8s-API-Server.
client_key

string

Nur Ausgabe. Privater Client-Schlüssel zur Authentifizierung beim k8s-API-Server.
user_id

string

Nur Ausgabe. Identität des Clients.
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 der Maschine.

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

Ruft eine VPN-Verbindung ab.

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 Zugänglichkeitsstatus 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 angegebenen 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 aufgelistet 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. Der übergeordnete Standort, zu dem diese Sammlung von Maschinen gehört.

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 Maschinen aufgelistet werden. Gemäß AIP-132 muss der Wert eine durch Kommas getrennte Liste von Feldern sein. An ein Feld kann „desc“ angehängt werden, um eine absteigende Sortierung anzugeben.

Unterstützte Felder: * name (Standard) : Kanonischer Ressourcenname der Maschine.

Beispiel: „name desc“.

ListMachinesResponse

Liste der Maschinen an einem Standort.

Felder
machines[]

Machine

Maschinen am Standort.
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 aufgelistet 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 aufgelistet 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 einen bestimmten google.cloud.location.Location.

Felder
available_zones

map<string, ZoneMetadata>

Die verfügbaren Google Distributed Cloud Edge-Zonen am Standort. Die Karte wird durch die ID jeder Zone in Kleinbuchstaben verschlüsselt.

Maschine

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

Felder
name

string

Erforderlich. Der Ressourcenname der Maschine.
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

Kanonischer Ressourcenname des Knotens, für den diese Maschine verantwortlich ist, z.B. projects/{project}/locations/{location}/clusters/{cluster_id}/nodePools/{pool_id}/{node}, oder leer, wenn die Maschine nicht der Rolle eines Knotens zugewiesen ist.

Für Knoten der Steuerungsebene, 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 dieses Computers.
version

string

Nur Ausgabe. Die Softwareversion des Geräts.
disabled

bool

Nur Ausgabe. Gibt an, ob die Maschine deaktiviert ist. Wenn die Richtlinie 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 Maschinenzweck 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 Die Maschine ist bereit, einen Knoten zu hosten. Das ist die Standardeinstellung.
DISABLED_FOR_REPAIR Die Maschine wurde durch Hinzufügen von mindestens einer Deaktivierungsforderung 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 Fenster.

MaintenancePolicy

Konfiguration der Wartungsrichtlinie.

Felder
window

MaintenanceWindow

Gibt das Wartungsfenster an, in dem Wartungsarbeiten durchgeführt werden können.
maintenance_exclusions[]

MaintenanceExclusionWindow

Optional. Ausschlüsse von der automatischen Wartung. Nicht dringende Wartungsarbeiten sollten in diesen Zeiträumen nicht durchgeführt werden. Jeder Ausschluss hat einen eindeutigen Namen und kann aktiv oder abgelaufen sein. Die maximale Anzahl von Wartungsausschlüssen, die zu einem bestimmten Zeitpunkt zulässig sind, beträgt 3.

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, können in den Knotenpool aufgenommen werden. Die Filtersprache akzeptiert Strings wie „name=“ und wird unter AIP-160 genauer beschrieben.
local_disk_encryption

LocalDiskEncryption

Optional. Verschlüsselungsoptionen für lokale Laufwerke. 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 Laufwerke von Knoten 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 Laufwerke des Knotens 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 liegen oder daran, dass der Schlüssel deaktiviert oder gelöscht wurde.
kms_status

Status

Nur Ausgabe. Fehlerstatus, der von Cloud KMS zurückgegeben wird, wenn dieser Schlüssel verwendet wird. Dieses Feld darf nur ausgefüllt werden, wenn kms_key_state nicht KMS_KEY_STATE_KEY_AVAILABLE ist. Wenn dieses Feld ausgefüllt ist, enthält es 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.
node_system_partition_size

SystemPartitionGiBSize

Optional. Größe der Systempartition für Worker-Knoten in GiB.

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

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

Status

Eine öffentlich zugängliche Fehlerdarstellung, die für die Nutzung durch den Client vorgesehen ist. Dieses Feld wird aus dem Fehler des Vorgangs ausgefüllt und ist besonders nützlich, um Clients detailliertere Fehlerdetails bereitzustellen, wenn der kanonische Fehlercode INTERNAL ist und die primäre Fehlermeldung möglicherweise bereinigt wird.

StatusReason

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

Enums
STATUS_REASON_UNSPECIFIED Ursache unbekannt.
UPGRADE_PAUSED Das Clusterupgrade ist derzeit pausiert.
RETRYABLE_ERROR Bei der Anfrage ist ein Fehler aufgetreten, der jedoch wiederholt werden kann.

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 Nutzung dieses Messwerts.

RecurringTimeWindow

Stellt ein beliebiges Zeitfenster dar, das sich wiederholt.

Felder
window

TimeWindow

Das Fenster der ersten Wiederholung.
recurrence

string

Eine RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) für die Wiederholung dieses Fensters. Sie dauern so lange wie die Zeitspanne zwischen Start- und Endzeit.

ResourceState

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

Enums
RESOURCE_STATE_UNSPECIFIED Standardwert.
RESOURCE_STATE_LOCK_DOWN Die Ressource befindet sich im Status LOCK DOWN.
RESOURCE_STATE_LOCK_DOWN_PENDING Die Ressource wird gesperrt.

ServerConfig

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

Felder
channels

map<string, ChannelConfig>

Nur Ausgabe. Zuordnung von Release-Version zu Versionskonfiguration.
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".
version_rollouts[]

VersionRollout

Nur Ausgabe. Roll-out-Informationen für die Serverkonfiguration.

SystemPartitionGiBSize

„SystemPartitionGiBSize“ stellt die zulässigen Systempartitionsgrößen in GiB dar.

Enums
SYSTEM_PARTITION_GIB_SIZE_UNSPECIFIED Die Größe der Systempartition wird nicht vom Nutzer angegeben. Dadurch wird die Größe der Systempartition auf die Größe festgelegt, die im für diesen Knoten geltenden Systemspeicherschema angegeben ist, also 100 GiB.
SYSTEM_PARTITION_GIB_SIZE100 100 GiB Systempartitionsgröße, was auch die Standardgröße ist.
SYSTEM_PARTITION_GIB_SIZE300 300 GiB Systempartitionsgröße. Kann verwendet werden, um den Standardwert von 100 GiB zu überschreiben.

TimeWindow

Stellt ein beliebiges Zeitfenster dar.

Felder
start_time

Timestamp

Der Zeitpunkt, zu dem das Fenster zum ersten Mal beginnt.
end_time

Timestamp

Die Uhrzeit, zu der das Fenster 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 ist.

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

UpgradeClusterRequest

Aktualisiert einen Cluster.

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

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

Zeitplan

Stellt den Zeitplan für das Upgrade des Clusters dar.

Enums
SCHEDULE_UNSPECIFIED Nicht angegeben. Standardmäßig wird der Cluster sofort aktualisiert. Dies ist derzeit die einzige Option.
IMMEDIATELY Das Upgrade des Clusters wird sofort nach Erhalt der Anfrage durchgeführt.

Version

Version eines Clusters.

Felder
name

string

Nur Ausgabe. Name der Version, z.B.: "1.4.0".

VersionRollout

VersionRollout enthält die Informationen zum Roll-out der Version.

Felder
version

string

Nur Ausgabe. Semantische Version, z.B.: "1.4.0".
available_zones[]

string

Nur Ausgabe. Liste der Zonen, in denen die Version eingeführt wurde, z.B.: ["us-central1", "us-west1"].

VpnConnection

Eine VPN-Verbindung

Felder
name

string

Erforderlich. Der Ressourcenname der VPN-Verbindung
create_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem 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. Er hat das Format „projects/{project}/locations/{location}/clusters/{cluster}“.
vpc

string

Die Netzwerk-ID der VPC, zu 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 auf Clusterseite Hochverfügbarkeit aktiviert ist. Wenn diese Option aktiviert ist, wird beim Erstellen einer VPN-Verbindung versucht, zwei Floating-IP-Adressen von ANG zu verwenden.
router

string

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

Details

Nur Ausgabe. Die Details der erstellten Verbindung.

BgpRoutingMode

Routingmodus.

Enums
BGP_ROUTING_MODE_UNSPECIFIED Unbekannt
REGIONAL Regionaler Modus.
GLOBAL Globaler Modus.

Details

Die Details der erstellten Verbindung.

Felder
state

State

Der Status dieser Verbindung.
error

string

Die Fehlermeldung. Dieses Feld wird nur ausgefüllt, wenn state=ERROR ist.
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 Name des zugehörigen 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 Verbindung wird hergestellt.
STATE_ERROR Ein Fehler ist aufgetreten.

VpcProject

Projektdetails des VPC-Netzwerk.

Felder
project_id

string

Das Projekt der VPC, zu der eine Verbindung hergestellt werden soll. Wenn keine Angabe erfolgt, ist es mit dem Clusterprojekt identisch.
service_account
(deprecated)

string

Optional. Verworfen. 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 Zuordnung wird nach Rack-Name verschlüsselt und hat den Wert „RackType“.
config_data

ConfigData

Konfigurationsdaten für die Zone.

RackType

Typ des Racks.

Enums
RACK_TYPE_UNSPECIFIED Nicht angegebener Racktyp. Ein einzelnes Rack gehört ebenfalls zu diesem Typ.
BASE Basis-Rack-Typ, ein Paar aus zwei modifizierten Config-1-Racks mit Aggregations-Switches.
EXPANSION Erweiterungs-Rack-Typ, auch als eigenständige Racks bezeichnet, die von Kunden bei Bedarf hinzugefügt werden.