Package google.cloud.edgecontainer.v1alpha

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.

CreateIdentityProvider

rpc CreateIdentityProvider(CreateIdentityProviderRequest) returns (IdentityProvider)

Konfiguriert einen Identitätsanbieter im Infrastrukturcluster.

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.

CreateServiceAccount

rpc CreateServiceAccount(CreateServiceAccountRequest) returns (Operation)

Mit CreateServiceAccount wird die CR für das Projekt-Dienstkonto im Projekt-Namespace im Cluster erstellt (Infrastrukturcluster für V2, Nutzercluster für V1).

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.

DeleteIdentityProvider

rpc DeleteIdentityProvider(DeleteIdentityProviderRequest) returns (IdentityProvider)

Mit „DeleteIdentityProvider“ wird der Identitätsanbieter aus dem Infrastrukturcluster entfernt.

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.

DeleteServiceAccount

rpc DeleteServiceAccount(DeleteServiceAccountRequest) returns (Operation)

Mit DeleteServiceAccount wird das CR des Projektdienstkontos im Projektnamespace im Cluster gelöscht (Infrastrukturcluster für V2, Nutzercluster für V1).

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.

EnableZonalProject

rpc EnableZonalProject(EnableZonalProjectRequest) returns (Operation)

Mit EnableZonalProject wird das Nutzerprojekt in der Zone aktiviert.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

EnableZonalService

rpc EnableZonalService(EnableZonalServiceRequest) returns (Operation)

Mit EnableZonalService wird ein Dienst in einer Zone aktiviert.

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.

GenerateServiceAccountKey

rpc GenerateServiceAccountKey(GenerateServiceAccountKeyRequest) returns (GenerateServiceAccountKeyResponse)

GenerateServiceAccountKey generiert ein Schlüsselpaar für die angegebene Dienstkontoressource.

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.

GetIamPolicy

rpc GetIamPolicy(GetIamPolicyRequest) returns (IamPolicy)

Mit GetIamPolicy werden die IAM-Richtlinien für ein Projekt im Infrastrukturcluster abgerufen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

GetIdentityProvider

rpc GetIdentityProvider(GetIdentityProviderRequest) returns (IdentityProvider)

GetIdentityProvider ruft die Details des Identitätsanbieters 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.

GetServiceAccount

rpc GetServiceAccount(GetServiceAccountRequest) returns (ServiceAccount)

Mit GetServiceAccount werden die Dienstkontodetails abgerufen.

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.

GetZonalProject

rpc GetZonalProject(GetZonalProjectRequest) returns (ZonalProject)

GetZonalProject ruft das ZonalProject ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

GetZonalService

rpc GetZonalService(GetZonalServiceRequest) returns (ZonalService)

Mit „GetEnabledZonalService“ werden die Details des aktivierten Dienstes abgerufen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

GetZone

rpc GetZone(GetZoneRequest) returns (Zone)

Ruft Details zu einer einzelnen Zone ab, in der die übergeordnete Organisation aktiviert ist.

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.

ListIdentityProviders

rpc ListIdentityProviders(ListIdentityProvidersRequest) returns (ListIdentityProvidersResponse)

Listet Identitätsanbieter auf, die im Infrastrukturcluster konfiguriert sind.

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.

ListServiceAccounts

rpc ListServiceAccounts(ListServiceAccountsRequest) returns (ListServiceAccountsResponse)

Mit ListServiceAccounts werden die Details aller Dienstkontoressourcen für ein Projekt im Cluster (Infrastrukturcluster für V2, Nutzercluster für V1) aufgeführt.

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.

ListZonalProjects

rpc ListZonalProjects(ListZonalProjectsRequest) returns (ListZonalProjectsResponse)

Listet ZonalProjects in der Zone auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

ListZonalServices

rpc ListZonalServices(ListZonalServicesRequest) returns (ListZonalServicesResponse)

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

ListZones

rpc ListZones(ListZonesRequest) returns (ListZonesResponse)

Listet Zonen auf, in denen die übergeordnete Organisation aktiviert ist.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

SetIamPolicy

rpc SetIamPolicy(SetIamPolicyRequest) returns (IamPolicy)

SetIamPolicy legt die IAM-Richtlinie für ein Projekt im Infrastrukturcluster fest. Die vorhandene Richtlinie wird durch die angegebene überschrieben.

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

container_runtime_config

ContainerRuntimeConfig

Optional. Die Containerlaufzeitkonfiguration des Clusters.

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-Gruppen-Authentifizierungskonfiguration 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, hat aber möglicherweise vor Kurzem nach einer Trennung wieder eine Verbindung hergestellt. Die Synchronisierung läuft noch.

ContainerRuntimeConfig

Containerlaufzeitkonfiguration des Clusters.

Felder
default_container_runtime

DefaultContainerRuntime

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

DefaultContainerRuntime

Liste der unterstützten Container-Runtimes.

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

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

GoogleGroupAuthenticationConfig

Google Groups-Authentifizierungskonfiguration 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, 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.

CreateIdentityProviderRequest

Request-Proto zum Konfigurieren des Identitätsanbieters für eine Organisation.

Felder
parent

string

Erforderlich. Der Ressourcenname des zu konfigurierenden Identitätsanbieters, z. B.organizations/{organization}/locations/{location}.

identity_provider_id

string

Erforderlich. Die ID des Identitätsanbieters.

identity_provider

IdentityProvider

Erforderlich. Der zu konfigurierende Identitätsanbieter.

request_id

string

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

CreateServiceAccountRequest

Fordern Sie das Proto an, um eine Dienstkontoressource zu erstellen.

Felder
parent

string

Erforderlich. Der Ressourcenname des zu konfigurierenden Identitätsanbieters, z. B. project/{project}/locations/{location}

service_account_id

string

Erforderlich. Die Dienstkonto-ID.

service_account

ServiceAccount

Erforderlich. Das zu konfigurierende Dienstkonto.

request_id

string

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

DeleteIdentityProviderRequest

Fordern Sie das Protokoll an, um den Identitätsanbieter für eine Organisation zu löschen.

Felder
name

string

Erforderlich. Der Ressourcenname des zu löschenden Identitätsanbieters. Der Name muss das folgende Format haben: organizations/{organization}/locations/{location}/identityProviders/{identity_provider}

request_id

string

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

Union-Feld target. Das Ziel des Identitätsanbieters. Für target ist nur einer der folgenden Werte zulässig:
zone_id

string

Die Zonen-ID der Zielzone des Infrastrukturclusters, für den der Identitätsanbieter gelöscht werden soll.

cluster

string

Der vollständig qualifizierte Name der Ziel-BMUC, für die der Identitätsanbieter gelöscht werden soll.

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.

DeleteServiceAccountRequest

Request-Proto zum Löschen einer Projekt-Dienstkontoressource.

Felder
name

string

Erforderlich. Der kanonische Ressourcenname des Dienstkontos des Projekts. Beispiel: projects/{project}/locations/{location}/serviceAccounts/{service_account}

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.

EnableZonalProjectRequest

Aktiviert ein Nutzerprojekt (entsprechend dem Cloud-Nutzerprojekt) in Zonen.

Felder
parent

string

Erforderlich. Die übergeordnete Zone, in der das Projekt erstellt wird.

zonal_project_id

string

Erforderlich. Die angegebene project_id des zu aktivierenden Nutzerprojekts.

zonal_project

ZonalProject

Erforderlich. Das zu aktivierende Nutzerprojekt.

request_id

string

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

EnableZonalProjectResponse

Antwortnachricht zum Aktivieren eines zonalen Projekts.

Felder
zonal_project

ZonalProject

Das aktivierte zonale Projekt.

EnableZonalServiceRequest

Aktivieren Sie „ZonalService Request“. Die API konfiguriert den Zugriff für die Dienstersteller im Cluster, um Dienstressourcen zu erstellen.

Felder
parent

string

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

zonal_service_id

string

Optional. Die zonal_service_id wurde angegeben.

zonal_service

ZonalService

Erforderlich. Der zu erstellende Dienst.

request_id

string

Optional. UUID für idempotente Anfrage.

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

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

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.

GenerateServiceAccountKeyRequest

Request-Proto für die GenerateServiceAccountKey API.

Felder
name

string

Erforderlich. Der kanonische Ressourcenname des Dienstkontos des Projekts. Beispiel: projects/{project}/locations/{location}/serviceAccounts/{service_account}

ca_cert_path

string

Optional. Der Pfad zum CA-Zertifikat.

GenerateServiceAccountKeyResponse

Antwort-Proto für die GenerateServiceAccountKey API.

Felder
type

string

Der Anmeldedatentyp.

project

string

Nur Ausgabe. Das Projekt, zu dem das Dienstkonto gehört.

private_key_id

string

Nur Ausgabe. Die ID des privaten Schlüssels.

private_key

string

Nur Ausgabe. Der private Schlüssel.

name

string

Nur Ausgabe. Der Name der Dienstidentität.

token_uri

string

Nur Ausgabe. Der Token-URI.

format_version

string

Nur Ausgabe. Die Formatversion.

ca_cert_path

string

Nur Ausgabe. Der Pfad zum CA-Zertifikat.

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

GetIamPolicyRequest

Fordern Sie das Proto an, um die mit einem Projekt in einer Zone verknüpfte IAM-Richtlinie abzurufen.

Felder
name

string

Erforderlich. Der kanonische Name der Zone, aus der die IamPolicy abgerufen werden soll. Beispiel: projects/*/locations/*/zones/*

GetIdentityProviderRequest

Proto anfordern, um den Identitätsanbieter für eine Organisation abzurufen

Felder
name

string

Erforderlich. Der kanonische Ressourcenname des Identitätsanbieters. Beispiel: organizations/*/locations/*/identityProviders/*

Union-Feld target. Das Ziel, von dem der Identitätsanbieter abgerufen wird. Für target ist nur einer der folgenden Werte zulässig:
zone_id

string

Die Zonen-ID der Zielzone, für die der Identitätsanbieter konfiguriert ist.

cluster

string

Der Clustername des Ziel-BMUC, für den der Identitätsanbieter konfiguriert ist.

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

GetServiceAccountRequest

Fordern Sie ein Proto an, um eine Dienstkontoressource abzurufen.

Felder
name

string

Erforderlich. Der kanonische Ressourcenname des Dienstkontos des Projekts. Beispiel: projects/{project}/locations/{location}/serviceAccounts/{service_account}

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

GetZonalProjectRequest

Ruft eine zonale Projektressource ab.

Felder
name

string

Erforderlich. Der kanonische Ressourcenname des zonalen Projekts. Beispiel: organizations/*/locations/*/zonalProjects/*

GetZonalServiceRequest

ZonalService-Anfrage abrufen.

Felder
name

string

Erforderlich. Der Ressourcenname des Dienstes.

GetZoneRequest

Ruft eine Zone ab.

Felder
name

string

Erforderlich. Der kanonische Ressourcenname der Zone. Beispiel: organizations/*/locations/*/zone/*

IamPolicy

IamPolicy stellt eine IAM-Richtlinie dar.

Felder
bindings[]

Binding

Optional. Die Richtlinie ist eine Liste von Bindungen.

etag

string

Optional. Das ETag der IAM-Richtlinie.

Bindung

„Binding“ steht für eine Rollenbindung in der IAM-Richtlinie.

Felder
role

string

Erforderlich. Die Rolle in der IAM-Richtlinie, an die die Mitglieder gebunden werden sollen.

members[]

Principal

Optional. Die Mitglieder, an die die Rolle gebunden werden soll.

Prinzipal

„Principal“ stellt ein Hauptkonto in der IAM-Richtlinie dar.

Felder
Union-Feld identity. Das Hauptkonto, an das die Rolle gebunden werden soll. Für identity ist nur einer der folgenden Werte zulässig:
user

string

„User“ stellt einen Nutzer in der IAM-Richtlinie dar.

service_account

string

„Service account“ (Dienstkonto) steht für ein Dienstkonto in der IAM-Richtlinie.

IdentityProvider

Stellt eine Identitätsanbieterressource dar, die die Konfiguration des Identitätsanbieters für die Organisation repräsentiert.

Felder
name

string

ID. Der kanonische Ressourcenname des Identitätsanbieters. z.B. organizations/{organization}/locations/{location}/identityProviders/{identity_provider}

create_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Identitätsanbieter erstellt wurde.

update_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Identitätsanbieter zuletzt aktualisiert wurde.

delete_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Identitätsanbieter gelöscht wurde.

labels

map<string, string>

Optional. Mit dieser Ressource verknüpfte Labels.

Union-Feld config. Die Konfiguration des Identitätsanbieters. Für config ist nur einer der folgenden Werte zulässig:
oidc_config

OIDCProviderConfig

Die OIDC-Anbieterkonfiguration.

Union-Feld target. Das Ziel des Identitätsanbieters. Für target ist nur einer der folgenden Werte zulässig:
zone_id

string

Die Zonen-ID der Zielzone des Infrastrukturclusters, für den der Identitätsanbieter konfiguriert werden soll.

cluster

string

Der voll qualifizierte Name der Ziel-BMUC, für die der Identitätsanbieter konfiguriert werden soll.

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.

ListIdentityProvidersRequest

Proto anfordern, um die Identitätsanbieter für eine Organisation aufzulisten.

Felder
parent

string

Erforderlich. Die übergeordnete Organisation und Region für die Identitätsanbieter.

page_size

int32

Optional. Die maximale Anzahl der aufzulistenden Ressourcen.

page_token

string

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

Union-Feld target. Das Ziel des Identitätsanbieters. Für target ist nur einer der folgenden Werte zulässig:
zone_id

string

Die Zonen-ID der Zielzone des Infrastrukturclusters, für den die Identitätsanbieter aufgeführt werden sollen.

cluster

string

Der vollständig qualifizierte Name der Ziel-BMUC, für die die Identitätsanbieter aufgeführt werden sollen.

ListIdentityProvidersResponse

Antwort-Proto, um die Identitätsanbieter für eine Organisation aufzulisten.

Felder
identity_providers[]

IdentityProvider

Eine Liste der Identitätsanbieter, die der Anfrage entsprechen.

next_page_token

string

Ein Token zum Abrufen der nächsten Ergebnisseite.

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.

ListServiceAccountsRequest

Anfrage vom Typ „List ServiceAccounts“.

Felder
parent

string

Erforderlich. Der übergeordnete Standort, der diese Sammlung von Projekt-Dienstkonten besitzt.

page_size

int32

Optional. Die maximale Anzahl der aufzulistenden Ressourcen.

page_token

string

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

filter

string

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

order_by

string

Optional. Gibt die Reihenfolge an, in der Ressourcen aufgeführt werden. Felder, nach denen das Ergebnis sortiert werden soll.

ListServiceAccountsResponse

Antwort für ListServiceAccounts.

Felder
service_accounts[]

ServiceAccount

Liste der Dienstkonten, die der Anfrage entsprechen.

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.

ListZonalProjectsRequest

Listet Nutzerprojekte in einer Organisation auf.

Felder
parent

string

Erforderlich. Die übergeordnete Zone, in der das Projekt erstellt wird.

page_size

int32

Optional. Die maximale Anzahl der aufzulistenden Ressourcen.

page_token

string

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

filter

string

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

order_by

string

Optional. Gibt die Reihenfolge an, in der Ressourcen aufgeführt werden. Felder, nach denen das Ergebnis sortiert werden soll.

ListZonalProjectsResponse

Liste der Nutzerprojekte in einer Organisationsantwort.

Felder
zonal_projects[]

ZonalProject

Cluster am Standort.

next_page_token

string

Ein Token zum Abrufen der nächsten Ergebnisseite.

unreachable[]

string

Zonen, die nicht erreicht werden konnten.

ListZonalServicesRequest

ListZonalServices-Anfrage.

Felder
parent

string

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

page_size

int32

Optional. Die maximale Anzahl der aufzulistenden Ressourcen.

page_token

string

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

filter

string

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

order_by

string

Optional. Gibt die Reihenfolge an, in der Ressourcen aufgeführt werden. Felder, nach denen das Ergebnis sortiert werden soll.

ListZonalServicesResponse

Antwort auf „ZonalServices auflisten“.

Felder
zonal_services[]

ZonalService

ZonalServices am Standort.

next_page_token

string

Ein Token zum Abrufen der nächsten Ergebnisseite.

unreachable[]

string

Standorte, die nicht erreicht werden konnten.

ListZonesRequest

Listet die Zonen auf, für die die übergeordnete Organisation aktiviert ist.

Felder
parent

string

Erforderlich. Die übergeordnete Organisation und der Standort.

page_size

int32

Optional. Die maximale Anzahl der Elemente, die zurückgegeben werden sollen.

page_token

string

Optional. Der Wert next_page_token wurde gegebenenfalls von einer vorherigen Listenanfrage zurückgegeben.

filter

string

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

order_by

string

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

ListZonesResponse

Antwortnachricht zum Auflisten von Zonen.

Felder
zones[]

Zone

Eine Liste der Zonen, die der Anfrage entsprechen.

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.

OIDCProviderConfig

Stellt die OIDC-Anbieterkonfiguration dar.

Felder
client_id

string

Erforderlich. Die Client-ID des Identitätsanbieters.

client_secret

string

Optional. Der Clientschlüssel des Identitätsanbieters.

issuer_uri

string

Erforderlich. Der Aussteller-URI des Identitätsanbieters.

scopes

string

Erforderlich. Die Bereiche des Identitätsanbieters.

user_claim

string

Optional. Der Nutzeranspruch des Identitätsanbieters.

cloud_console_redirect_uri

string

Optional. CloudConsoleRedirectURI ist der URI, an den Nutzer weitergeleitet werden, die den OAuth-Ablauf über die Cloud Console durchlaufen.

enable_access_token

bool

Optional. Flag, das angibt, ob das Zugriffstoken als Teil des Inhabertokens durch gcloud anthos auth login und kubectl oidc login in die Anfrage aufgenommen werden soll. Die Standardeinstellung ist „false“.

extra_params

string

Optional. Durch Kommas getrennte Liste von Schlüssel/Wert-Paaren, die abfragecodiert und mit der Authentifizierungsendpunktanfrage gesendet werden.

kubectl_redirect_uri

string

Optional. KubectlRedirectURI ist der URI, zu dem Nutzer weitergeleitet werden, die sich mit dem kubectl-Plug-in bei einem OIDC-Anbieter authentifizieren.

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.
RETRYABLE_ERROR Bei der Anfrage ist ein Fehler aufgetreten, der sich durch Wiederholen beheben lässt.

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

version_rollouts[]

VersionRollout

Nur Ausgabe. Rollout-Informationen für die Serverkonfiguration.

ServiceAccount

Stellt die Dienstkontoressource dar.

Felder
name

string

ID. Der kanonische Ressourcenname des Dienstkontos des Projekts. Beispiel: projects/{project}/locations/{location}/serviceAccounts/{service_account}

zone

string

Erforderlich. Die Zonen-ID der Zone, in der das Dienstkonto des Projekts erstellt werden muss.

create_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem das Dienstkonto des Projekts erstellt wurde.

update_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem das Dienstkonto des Projekts zuletzt aktualisiert wurde.

labels

map<string, string>

Optional. Mit dieser Ressource verknüpfte Labels.

SetIamPolicyRequest

Request-Proto zum Festlegen der IAM-Richtlinie für ein Projekt in einer Zone.

Felder
name

string

Erforderlich. Der kanonische Ressourcenname der Zone: projects/{project}/locations/{location}/zones/{zone}

policy

IamPolicy

Erforderlich. Die festzulegende IAM-Richtlinie.

request_id

string

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

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

VersionRollout

VersionRollout enthält die Informationen zum Versions-Roll-out.

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

ZonalProject

Zonales Projekt (entspricht dem Cloud-Nutzerprojekt), das in Zonen aktiviert wird.

Felder
name

string

ID. Der Ressourcenname des Projekts.

create_time

Timestamp

Nur Ausgabe. Eine Angabe zur Erstellungszeit des Projekts

update_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem das Projekt zuletzt aktualisiert wurde.

labels

map<string, string>

Optional. Mit dieser Ressource verknüpfte Labels.

state

State

Nur Ausgabe. Der Status des Projekts in der Zone.

Bundesland

Der Status des Projekts in der Zone.

Enums
STATE_UNSPECIFIED Nicht angegeben.
STATE_ON Das Projekt ist in der Zone aktiviert.
STATE_OFF Das Projekt ist in der Zone deaktiviert.

ZonalService

Der Dienst ist für das Projekt aktiviert.

Felder
name

string

ID. Der Ressourcenname des Dienstes.

service_selector

ServiceSelector

Optional. Der Dienst, der aktiviert/deaktiviert werden soll. Es muss entweder „service_selector“ oder „service_name“ angegeben werden.

state

State

Nur Ausgabe. Der Status des Dienstes.

create_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem der Dienst aktiviert wurde.

update_time

Timestamp

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

labels

map<string, string>

Optional. Mit dieser Ressource verknüpfte Labels.

Union-Feld zone_or_cluster. Die Zone oder der Cluster, in dem der Dienst aktiviert/deaktiviert werden muss. Für zone_or_cluster ist nur einer der folgenden Werte zulässig:
zone

string

Die Zonen-ID der Zone, in der der Dienst aktiviert/deaktiviert werden muss.

cluster

string

Der vollständig qualifizierte Name des Clusters, für den der Dienst aktiviert/deaktiviert werden muss.

service_name

string

Optional. Der vollständige Dienstname, z.B. alloydb.googleapis.com. Es darf nur service_selector oder service_name angegeben werden. Damit wird der Dienst für das Projekt aktiviert bzw. deaktiviert.

ServiceSelector

Dienste, die aktiviert/deaktiviert werden können.

Enums
SERVICE_SELECTOR_UNSPECIFIED Nicht angegeben.
ALLOYDB AlloyDB-Dienst, alloydb.googleapis.com.
VMM VMM-Dienst, gdcvmmanager.googleapis.com.
BOOKSTORE Buchhandlungsservice, bookstore.googleapis.com.
VERTEX Vertex-Dienst, aiplatform.googleapis.com.
BOOKSTORE_AI Bookstore.AI-Dienst, bookstore-ai.googleapis.com.

Bundesland

Der Status des Dienstes.

Enums
STATE_UNSPECIFIED Nicht angegeben.
STATE_ENABLED Der Dienst ist für das Projekt aktiviert.
STATE_DISABLED Der Dienst ist für das Projekt deaktiviert.
STATE_ENABLING Der Dienst wird für das Projekt aktiviert.
STATE_DISABLING Der Dienst wird für das Projekt deaktiviert.

Zone

Stellt eine Zone dar.

Felder
name

string

ID. Der kanonische Ressourcenname der Zone. Beispiel: organizations/{organization}/locations/{location}/zones/{zone}

create_time

Timestamp

Nur Ausgabe. Der Zeitpunkt, zu dem die Zone erstellt wurde.

labels

map<string, string>

Optional. Mit dieser Ressource verknüpfte Labels.

certificate_authorities[]

string

Nur Ausgabe. Das Web-CA-Zertifikat für die Zone.

dns_servers[]

DNSServer

Nur Ausgabe. Die DNS-Server für die Zone.

state

State

Nur Ausgabe. Der Status der Zone.

DNSServer

Stellt einen DNS-Server für die Zone dar.

Felder
ip_address

string

Nur Ausgabe. Die IP-Adresse des DNS-Servers.

tld

string

Nur Ausgabe. Die Top-Level-Domain des DNS-Servers.

Bundesland

Der Status der Zone.

Enums
STATE_UNSPECIFIED Nicht angegeben.
STATE_RUNNING Die Zone befindet sich im Status „AKTIV“.
STATE_ERROR Die Zone befindet sich im Status „ERROR“.

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.