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 in der Authentifizierungsübersicht.

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 in der Authentifizierungsübersicht.

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 in der Authentifizierungsübersicht.

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 in der Authentifizierungsübersicht.

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 in der Authentifizierungsübersicht.

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 in der Authentifizierungsübersicht.

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 in der Authentifizierungsübersicht.

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 in der Authentifizierungsübersicht.

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 in der Authentifizierungsübersicht.

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 in der Authentifizierungsübersicht.

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 in der Authentifizierungsübersicht.

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 in der Authentifizierungsübersicht.

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 in der Authentifizierungsübersicht.

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 in der Authentifizierungsübersicht.

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 in der Authentifizierungsübersicht.

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 in der Authentifizierungsübersicht.

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 in der Authentifizierungsübersicht.

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.

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

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

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.

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.

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.

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

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.

MaintenancePolicy

Konfiguration der Wartungsrichtlinie.

Felder
window

MaintenanceWindow

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

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.

LocalDiskEncryption

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

Felder
kms_key

string

Nicht veränderbar. 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.

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.

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.

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.

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.

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. Das vom Nutzer konfigurierte Dienstkonto im VPC-Projekt. Damit werden Cloud Router und Cloud HA VPNs für die VPN-Verbindung erstellt bzw. gelöscht. Wenn diese SA während oder nach dem Erstellen einer VPN-Verbindung geändert wird, müssen Sie die Cloud Router- und Cloud VPN-Ressourcen in |project_id| entfernen. Sie hat das Format service-{project_number}@gcp-sa-edgecontainer.iam.gserviceaccount.com.

ZoneMetadata

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

Felder
quota[]

Quota

Kontingent für Ressourcen in dieser Zone.