Package google.cloud.gkehub.v1alpha

Index

GkeHub

Der GKE Hub-Dienst übernimmt die Registrierung vieler Kubernetes-Cluster in Google Cloud und die Verwaltung von Multi-Cluster-Features in diesen Clustern.

Der GKE Hub-Dienst wird mit den folgenden Ressourcen ausgeführt:

GKE Hub ist derzeit in der globalen Region und in allen Regionen in https://cloud.google.com/compute/docs/regions-zones verfügbar. Die Funktion ist nur in der globalen Region verfügbar, während die Mitgliedschaft die globale Region und alle Regionen umfasst.

Die Mitgliedschaftsverwaltung ist mitunter nicht einfach: Es wird empfohlen, bei der Arbeit mit Mitgliedschaftsressourcen nach Möglichkeit eine der von Google bereitgestellten Clientbibliotheken oder Tools zu verwenden.

CreateFeature

rpc CreateFeature(CreateFeatureRequest) returns (Operation)

Fügt ein neues Feature hinzu.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

CreateFleet

rpc CreateFleet(CreateFleetRequest) returns (Operation)

Erstellt eine Flotte.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

CreateMembership

rpc CreateMembership(CreateMembershipRequest) returns (Operation)

Erstellt eine neue Mitgliedschaft.

Dies wird derzeit nur für GKE-Cluster in Google Cloud unterstützt. Folgen Sie der Anleitung unter https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/registering-a-cluster, um weitere Cluster zu registrieren.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

CreateMembershipBinding

rpc CreateMembershipBinding(CreateMembershipBindingRequest) returns (Operation)

Erstellt eine MembershipBinding.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

CreateMembershipRBACRoleBinding

rpc CreateMembershipRBACRoleBinding(CreateMembershipRBACRoleBindingRequest) returns (Operation)

Erstellt eine RBACRoleBinding für die Mitgliedschaft.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

CreateScope

rpc CreateScope(CreateScopeRequest) returns (Operation)

Erstellt einen Bereich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

CreateScopeNamespace

rpc CreateScopeNamespace(CreateScopeNamespaceRequest) returns (Operation)

Erstellt einen Flotten-Namespace.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

CreateScopeRBACRoleBinding

rpc CreateScopeRBACRoleBinding(CreateScopeRBACRoleBindingRequest) returns (Operation)

Erstellt eine Bereichs-RBACRoleBinding.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

DeleteFeature

rpc DeleteFeature(DeleteFeatureRequest) returns (Operation)

Entfernt ein Feature.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

DeleteFleet

rpc DeleteFleet(DeleteFleetRequest) returns (Operation)

Entfernt eine Flotte. In der Flotte dürfen keine Mitgliedschaften mehr vorhanden sein.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

DeleteMembership

rpc DeleteMembership(DeleteMembershipRequest) returns (Operation)

Entfernt eine Mitgliedschaft.

Dies wird derzeit nur für GKE-Cluster in Google Cloud unterstützt. Folgen Sie der Anleitung unter https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/unregistering-a-cluster, um die Registrierung anderer Cluster aufzuheben.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

DeleteMembershipBinding

rpc DeleteMembershipBinding(DeleteMembershipBindingRequest) returns (Operation)

Löscht eine MembershipBinding.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

DeleteMembershipRBACRoleBinding

rpc DeleteMembershipRBACRoleBinding(DeleteMembershipRBACRoleBindingRequest) returns (Operation)

Löscht eine RBACRoleBinding für die Mitgliedschaft.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

DeleteScope

rpc DeleteScope(DeleteScopeRequest) returns (Operation)

Löscht einen Bereich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

DeleteScopeNamespace

rpc DeleteScopeNamespace(DeleteScopeNamespaceRequest) returns (Operation)

Löscht einen Flotten-Namespace.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

DeleteScopeRBACRoleBinding

rpc DeleteScopeRBACRoleBinding(DeleteScopeRBACRoleBindingRequest) returns (Operation)

Löscht eine Bereichs-RBACRoleBinding.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

GenerateConnectManifest

rpc GenerateConnectManifest(GenerateConnectManifestRequest) returns (GenerateConnectManifestResponse)

Generiert das Manifest für die Bereitstellung des GKE Connect-Agents.

Diese Methode wird intern von Google bereitgestellten Bibliotheken verwendet. Die meisten Clients sollten diese Methode nicht direkt aufrufen müssen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

GenerateMembershipRBACRoleBindingYAML

rpc GenerateMembershipRBACRoleBindingYAML(GenerateMembershipRBACRoleBindingYAMLRequest) returns (GenerateMembershipRBACRoleBindingYAMLResponse)

Generiert eine YAML-Datei der RBAC-Richtlinien für das angegebene RoleBinding und die zugehörigen Ressourcen zur Identitätsübertragung.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

GetFeature

rpc GetFeature(GetFeatureRequest) returns (Feature)

Ruft Details zu einem einzelnen Feature ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

GetFleet

rpc GetFleet(GetFleetRequest) returns (Fleet)

Gibt die Details einer Flotte zurück.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

GetMembership

rpc GetMembership(GetMembershipRequest) returns (Membership)

Ruft die Details einer Mitgliedschaft ab.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

GetMembershipBinding

rpc GetMembershipBinding(GetMembershipBindingRequest) returns (MembershipBinding)

Gibt die Details zu einer MembershipBinding zurück.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

GetMembershipRBACRoleBinding

rpc GetMembershipRBACRoleBinding(GetMembershipRBACRoleBindingRequest) returns (RBACRoleBinding)

Gibt die Details zu einem RBACRoleBinding für die Mitgliedschaft zurück.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

GetScope

rpc GetScope(GetScopeRequest) returns (Scope)

Gibt die Details eines Bereichs zurück.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

GetScopeNamespace

rpc GetScopeNamespace(GetScopeNamespaceRequest) returns (Namespace)

Gibt die Details eines Flotten-Namespace zurück.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

GetScopeRBACRoleBinding

rpc GetScopeRBACRoleBinding(GetScopeRBACRoleBindingRequest) returns (RBACRoleBinding)

Gibt die Details einer Bereichs-RBACRoleBinding zurück.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ListAdminClusterMemberships

rpc ListAdminClusterMemberships(ListAdminClusterMembershipsRequest) returns (ListAdminClusterMembershipsResponse)

Listet Mitgliedschaften von Administratorclustern in einem angegebenen Projekt und an einem angegebenen Standort auf.

Diese Methode wird nur intern verwendet.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ListFeatures

rpc ListFeatures(ListFeaturesRequest) returns (ListFeaturesResponse)

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

ListFleets

rpc ListFleets(ListFleetsRequest) returns (ListFleetsResponse)

Gibt alle Flotten innerhalb einer Organisation oder eines Projekts zurück, auf die der Aufrufer Zugriff hat.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ListMembershipBindings

rpc ListMembershipBindings(ListMembershipBindingsRequest) returns (ListMembershipBindingsResponse)

Listet MembershipBindings auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ListMembershipRBACRoleBindings

rpc ListMembershipRBACRoleBindings(ListMembershipRBACRoleBindingsRequest) returns (ListMembershipRBACRoleBindingsResponse)

Listet alle RBAC-RoleBindings der Mitgliedschaft auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ListMemberships

rpc ListMemberships(ListMembershipsRequest) returns (ListMembershipsResponse)

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

ListScopeNamespaces

rpc ListScopeNamespaces(ListScopeNamespacesRequest) returns (ListScopeNamespacesResponse)

Listet Flotten-Namespaces auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ListScopeRBACRoleBindings

rpc ListScopeRBACRoleBindings(ListScopeRBACRoleBindingsRequest) returns (ListScopeRBACRoleBindingsResponse)

Listet alle RBACRoleBindings für den Bereich auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ListScopes

rpc ListScopes(ListScopesRequest) returns (ListScopesResponse)

Listet Bereiche auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

UpdateFeature

rpc UpdateFeature(UpdateFeatureRequest) returns (Operation)

Aktualisiert ein vorhandenes Feature.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

UpdateFleet

rpc UpdateFleet(UpdateFleetRequest) returns (Operation)

Aktualisiert eine Flotte.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

UpdateMembership

rpc UpdateMembership(UpdateMembershipRequest) returns (Operation)

Aktualisiert eine vorhandene Mitgliedschaft.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

UpdateMembershipBinding

rpc UpdateMembershipBinding(UpdateMembershipBindingRequest) returns (Operation)

Aktualisiert ein MembershipBinding.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

UpdateMembershipRBACRoleBinding

rpc UpdateMembershipRBACRoleBinding(UpdateMembershipRBACRoleBindingRequest) returns (Operation)

Aktualisiert eine Mitgliedschafts-RBACRoleBinding.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

UpdateScope

rpc UpdateScope(UpdateScopeRequest) returns (Operation)

Aktualisiert einen Bereich.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

UpdateScopeNamespace

rpc UpdateScopeNamespace(UpdateScopeNamespaceRequest) returns (Operation)

Aktualisiert einen Flotten-Namespace.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

UpdateScopeRBACRoleBinding

rpc UpdateScopeRBACRoleBinding(UpdateScopeRBACRoleBindingRequest) returns (Operation)

Aktualisiert eine Bereichs-RBACRoleBinding.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ValidateCreateMembership

rpc ValidateCreateMembership(ValidateCreateMembershipRequest) returns (ValidateCreateMembershipResponse)

ValidateCreateMembership ist eine Preflight-Prüfung für CreateMembership. Dabei werden folgende Elemente überprüft: 1. Der Aufrufer hat die erforderliche Berechtigung gkehub.memberships.create. 2. Die Mitgliedschafts-ID ist weiterhin verfügbar.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ApplianceCluster

ApplianceCluster enthält Informationen zu GDC Edge-Appliance-Clustern.

Felder

Authority-Header

Die Zertifizierungsstelle codiert, wie Google Identitäten aus dieser Mitgliedschaft erkennt. Weitere Informationen finden Sie in der Dokumentation zu Workload Identity: https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity

Felder
issuer

string

Optional. Der URI eines JWT-Ausstellers (JSON Web Token). issuer muss mit https:// beginnen und eine gültige URL mit weniger als 2.000 Zeichen sein. Für GKE-Cluster muss location statt zone verwendet werden.

Wenn diese Option festgelegt ist, lässt Google gültige OIDC-Tokens von diesem Aussteller zur Authentifizierung im workload_identity_pool zu. Für diesen URI wird die OIDC-Erkennung durchgeführt, um Tokens vom Aussteller zu validieren.

Durch das Löschen von issuer wird Workload Identity deaktiviert. issuer kann nicht direkt geändert werden; er muss gelöscht (und Workload Identity deaktiviert) werden, bevor Sie einen neuen Aussteller verwenden (und Workload Identity wieder aktivieren).

workload_identity_pool

string

Nur Ausgabe. Der Name des Workload Identity-Pools, in dem issuer erkannt wird.

Es gibt einen einzelnen Workload Identity-Pool pro Hub, der von allen Mitgliedschaften geteilt wird, die zu diesem Hub gehören. Bei einem in {PROJECT_ID} gehosteten Hub ist das Arbeitslastpoolformat {PROJECT_ID}.hub.id.goog. Dies kann sich jedoch in neueren Versionen dieser API ändern.

identity_provider

string

Nur Ausgabe. Einen Identitätsanbieter, der die issuer im Workload Identity-Pool widerspiegelt.

oidc_jwks

bytes

Optional. OIDC-Bestätigungsschlüssel für diese Mitgliedschaft im JWKS-Format (RFC 7517).

Wenn dieses Feld festgelegt ist, wird die OIDC-Erkennung NICHT für issuer ausgeführt. Stattdessen werden OIDC-Tokens mit diesem Feld validiert.

BinaryAuthorizationConfig

BinaryAuthorizationConfig definiert die Konfiguration auf Flottenebene der Binärautorisierungsfunktion.

Felder
evaluation_mode

BinaryAuthorizationConfig.EvaluationMode

Optional. Betriebsmodus für die binauthz-Richtlinienbewertung.

policy_bindings[]

BinaryAuthorizationConfig.PolicyBinding

Optional. Binauthz-Richtlinien, die für diesen Cluster gelten.

EvaluationMode

Betriebsmodus der Binärautorisierung

Enums
EVALUATION_MODE_UNSPECIFIED Standardwert
DISABLED BinaryAuthorization deaktivieren
POLICY_BINDINGS Verwenden Sie die Binärautorisierung mit den in policy_bindings angegebenen Richtlinien.

Richtlinienbindung

Binauthz-Richtlinie, die für diesen Cluster gilt.

Felder
name

string

Der relative Ressourcenname der zu prüfenden binauthz-Plattformrichtlinie. GKE-Plattformrichtlinien haben das folgende Format: projects/{project_number}/platforms/gke/policies/{policy_id}.

CommonFeatureSpec

CommonFeatureSpec enthält Hub-weite Konfigurationsinformationen

Felder

Union-Feld feature_spec.

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

multiclusteringress

FeatureSpec

Spezifische Spezifikation für Multi-Cluster-Ingress.

cloudauditlogging

FeatureSpec

Cloud-Audit-Logging-spezifische Spezifikation.

workloadcertificate

FeatureSpec

Spezifikation des Arbeitslastzertifikats.

appdevexperience

AppDevExperienceFeatureSpec

Appdevexperience-spezifische Spezifikation.

anthosobservability

AnthosObservabilityFeatureSpec

Anthos-Beobachtbarkeitsspezifikation

fleetobservability

FeatureSpec

FleetObservability-Featurespezifikation.

namespaceactuation

FeatureSpec

Featurespezifikation für Namespace-Aktivierung

clusterupgrade

FleetSpec

Featurespezifikation mit ClusterUpgrade (flottenbasiert).

dataplanev2

FeatureSpec

DataplaneV2-Featurespezifikation.

CommonFeatureState

CommonFeatureState enthält Informationen zum Hub-weiten Funktionsstatus.

Felder
state

FeatureState

Nur Ausgabe. Der „Ausführungsstatus“ des Features in diesem Hub.

Union-Feld feature_state.

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

servicemesh

FeatureState

Service Mesh-spezifischer Status.

appdevexperience

AppDevExperienceFeatureState

Appdevexperience-spezifischer Status.

fleetobservability

FeatureState

FleetObservability-Featurestatus.

namespaceactuation

FeatureState

Featurestatus der Namespace-Aktivierung.

clusterupgrade

FleetState

ClusterUpgrade-Status auf Flottenebene.

CommonFleetDefaultMemberConfigSpec

CommonFleetDefaultMemberConfigSpec enthält Informationen zur Standardkonfiguration für Mitgliedschaften einer Flotte

Felder

Union-Feld feature_spec.

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

mesh

MembershipSpec

Anthos Service Mesh-spezifische Spezifikation

configmanagement

MembershipSpec

Config Management-spezifische Spezifikation.

identityservice

MembershipSpec

Identity Service-spezifische Spezifikation.

policycontroller

MembershipSpec

Policy Controller-Spezifikation.

ConnectAgentResource

ConnectAgentResource stellt ein Kubernetes-Ressourcenmanifest für die Bereitstellung des Connect-Agents dar.

Felder
type

TypeMeta

Kubernetes-Typ der Ressource.

manifest

string

YAML-Manifest der Ressource.

CreateFeatureRequest

Anfragenachricht für die Methode GkeHub.CreateFeature.

Felder
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem das Feature erstellt werden wird. Wird im Format projects/*/locations/* angegeben.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.features.create
feature_id

string

ID des zu erstellenden Features.

resource

Feature

Die zu erstellende Feature-Ressource.

request_id

string

Eine Anfrage-ID zur Identifizierung von Anfragen. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignoriert, falls sie bereits abgeschlossen wurde, falls Sie Ihre Anfrage wiederholen müssen. Der Server gewährleistet dies für mindestens 60 Minuten nach der ersten Anfrage.

Stellen Sie sich beispielsweise eine Situation vor, in der Sie eine erste Anfrage stellen und diese das Zeitlimit überschreitet. Wenn Sie die Anfrage mit derselben Anfrage-ID noch einmal senden, kann der Server prüfen, ob der ursprüngliche Vorgang mit derselben Anfrage-ID empfangen wurde. Ist dies der Fall, wird die zweite Anfrage ignoriert. Dadurch wird verhindert, dass Clients versehentlich doppelte Zusicherungen erstellen.

Die Anfrage-ID muss eine gültige UUID sein, mit der Ausnahme, dass null UUID nicht unterstützt wird (00000000-0000-0000-0000-000000000000).

CreateFleetRequest

Anfragenachricht für die Methode GkeHub.CreateFleet.

Felder
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem die Flotte erstellt wird. Wird im Format projects/*/locations/* angegeben.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.fleet.create
fleet

Fleet

Erforderlich. Die zu erstellende Flotte.

CreateMembershipBindingRequest

Anfrage zum Erstellen einer MembershipBinding.

Felder
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem die MembershipBinding erstellt wird. Wird im Format projects/*/locations/*/memberships/* angegeben.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.membershipbindings.create
membership_binding

MembershipBinding

Erforderlich. Die zu erstellende MembershipBinding.

membership_binding_id

string

Erforderlich. Die für das MembershipBinding zu verwendende ID.

CreateMembershipRBACRoleBindingRequest

Anfrage zum Erstellen von rbacrolebindings.

Felder
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem die RBACRoleBinding erstellt wird. Wird im Format projects/*/locations/*/memberships/* angegeben.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.rbacrolebindings.create
rbacrolebinding_id

string

Erforderlich. Vom Client ausgewählte ID für die RBACRoleBinding. rbacrolebinding_id muss ein gültiges RFC 1123-konformes DNS-Label sein:

  1. Maximal 63 Zeichen.
  2. Muss aus alphanumerischen Kleinbuchstaben oder - bestehen.
  3. Muss mit einem alphanumerischen Zeichen beginnen und enden.

Dies kann als regulärer Ausdruck [a-z0-9]([-a-z0-9]*[a-z0-9])? mit einer maximalen Länge von 63 Zeichen ausgedrückt werden.

rbacrolebinding

RBACRoleBinding

Erforderlich. Die zu erstellenden rbacrolebindings.

CreateMembershipRequest

Anfragenachricht für die Methode GkeHub.CreateMembership.

Felder
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem die Mitgliedschaften erstellt werden. Wird im Format projects/*/locations/* angegeben.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.memberships.create
membership_id

string

Erforderlich. Vom Client ausgewählte ID für die Mitgliedschaft. membership_id muss ein gültiges RFC 1123-konformes DNS-Label sein:

  1. Maximal 63 Zeichen.
  2. Muss aus alphanumerischen Kleinbuchstaben oder - bestehen.
  3. Muss mit einem alphanumerischen Zeichen beginnen und enden.

Dies kann als regulärer Ausdruck [a-z0-9]([-a-z0-9]*[a-z0-9])? mit einer maximalen Länge von 63 Zeichen ausgedrückt werden.

resource

Membership

Erforderlich. Die zu erstellende Mitgliedschaft.

request_id

string

Optional. Eine Anfrage-ID zur Identifizierung von Anfragen. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignoriert, falls sie bereits abgeschlossen wurde, falls Sie Ihre Anfrage wiederholen müssen. Der Server gewährleistet dies für mindestens 60 Minuten nach der ersten Anfrage.

Stellen Sie sich beispielsweise eine Situation vor, in der Sie eine erste Anfrage stellen und diese das Zeitlimit überschreitet. Wenn Sie die Anfrage mit derselben Anfrage-ID noch einmal senden, kann der Server prüfen, ob der ursprüngliche Vorgang mit derselben Anfrage-ID empfangen wurde. Ist dies der Fall, wird die zweite Anfrage ignoriert. Dadurch wird verhindert, dass Clients versehentlich doppelte Zusicherungen erstellen.

Die Anfrage-ID muss eine gültige UUID sein, mit der Ausnahme, dass null UUID nicht unterstützt wird (00000000-0000-0000-0000-000000000000).

CreateScopeNamespaceRequest

Anfrage zum Erstellen eines Flotten-Namespace

Felder
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Speicherort), in dem der Namespace erstellt wird. Wird im Format projects/*/locations/*/scopes/* angegeben.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.namespaces.create
scope_namespace_id

string

Erforderlich. Vom Client ausgewählte ID für den Namespace. namespace_id muss ein gültiges RFC 1123-konformes DNS-Label sein:

  1. Maximal 63 Zeichen.
  2. Muss aus alphanumerischen Kleinbuchstaben oder - bestehen.
  3. Muss mit einem alphanumerischen Zeichen beginnen und enden.

Dies kann als regulärer Ausdruck [a-z0-9]([-a-z0-9]*[a-z0-9])? mit einer maximalen Länge von 63 Zeichen ausgedrückt werden.

scope_namespace

Namespace

Erforderlich. Der zu erstellende Flotten-Namespace.

CreateScopeRBACRoleBindingRequest

Anfrage zum Erstellen von rbacrolebindings.

Felder
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem die RBACRoleBinding erstellt wird. Wird im Format projects/*/locations/*/scopes/* angegeben.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.rbacrolebindings.create
rbacrolebinding_id

string

Erforderlich. Vom Client ausgewählte ID für die RBACRoleBinding. rbacrolebinding_id muss ein gültiges RFC 1123-konformes DNS-Label sein:

  1. Maximal 63 Zeichen.
  2. Muss aus alphanumerischen Kleinbuchstaben oder - bestehen.
  3. Muss mit einem alphanumerischen Zeichen beginnen und enden.

Dies kann als regulärer Ausdruck [a-z0-9]([-a-z0-9]*[a-z0-9])? mit einer maximalen Länge von 63 Zeichen ausgedrückt werden.

rbacrolebinding

RBACRoleBinding

Erforderlich. Die zu erstellenden rbacrolebindings.

CreateScopeRequest

Anfrage zum Erstellen eines Bereichs.

Felder
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem der Bereich erstellt wird. Wird im Format projects/*/locations/* angegeben.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.scopes.create
scope_id

string

Erforderlich. Vom Client ausgewählte ID für den Bereich. scope_id muss ein ???? sein.

scope

Scope

Erforderlich. Der zu erstellende Bereich.

DefaultClusterConfig

DefaultClusterConfig beschreibt die Standard-Clusterkonfigurationen, die auf alle in der Flotte geborenen Cluster angewendet werden sollen.

Felder
security_posture_config

SecurityPostureConfig

Sicherheitsstatus-Features für den Cluster aktivieren/deaktivieren.

binary_authorization_config

BinaryAuthorizationConfig

Optional. Binärautorisierungsfunktionen für den Cluster aktivieren/deaktivieren.

DeleteFeatureRequest

Anfragenachricht für die Methode GkeHub.DeleteFeature.

Felder
name

string

Erforderlich. Der Name der Feature-Ressource im Format projects/*/locations/*/features/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.features.delete
force

bool

Wenn dieser Wert auf "true" gesetzt ist, werden beim Löschen alle ausstehenden Ressourcen für dieses Feature ignoriert (d. h. FeatureState.has_resources ist auf "true" gesetzt). Diese Ressourcen werden NICHT bereinigt oder geändert.

request_id

string

Optional. Eine Anfrage-ID zur Identifizierung von Anfragen. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignoriert, falls sie bereits abgeschlossen wurde, falls Sie Ihre Anfrage wiederholen müssen. Der Server gewährleistet dies für mindestens 60 Minuten nach der ersten Anfrage.

Stellen Sie sich beispielsweise eine Situation vor, in der Sie eine erste Anfrage stellen und diese das Zeitlimit überschreitet. Wenn Sie die Anfrage mit derselben Anfrage-ID noch einmal senden, kann der Server prüfen, ob der ursprüngliche Vorgang mit derselben Anfrage-ID empfangen wurde. Ist dies der Fall, wird die zweite Anfrage ignoriert. Dadurch wird verhindert, dass Clients versehentlich doppelte Zusicherungen erstellen.

Die Anfrage-ID muss eine gültige UUID sein, mit der Ausnahme, dass null UUID nicht unterstützt wird (00000000-0000-0000-0000-000000000000).

DeleteFleetRequest

Anfragenachricht für die Methode GkeHub.DeleteFleet.

Felder
name

string

Erforderlich. Der Name der Flottenressource im Format projects/*/locations/*/fleets/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.fleet.delete

DeleteMembershipBindingRequest

Anfrage zum Löschen einer Bindung.

Felder
name

string

Erforderlich. Der Name der MembershipBinding-Ressource im Format projects/*/locations/*/memberships/*/bindings/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.membershipbindings.get

DeleteMembershipRBACRoleBindingRequest

Anfrage zum Löschen einer Membership-RBACRoleBinding.

Felder
name

string

Erforderlich. Der Name der RBACRoleBinding-Ressource im Format projects/*/locations/*/memberships/*/rbacrolebindings/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.rbacrolebindings.delete

DeleteMembershipRequest

Anfragenachricht für die Methode GkeHub.DeleteMembership.

Felder
name

string

Erforderlich. Der Name der Mitgliedschaftsressource im Format projects/*/locations/*/memberships/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.memberships.delete
request_id

string

Optional. Eine Anfrage-ID zur Identifizierung von Anfragen. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignoriert, falls sie bereits abgeschlossen wurde, falls Sie Ihre Anfrage wiederholen müssen. Der Server gewährleistet dies für mindestens 60 Minuten nach der ersten Anfrage.

Stellen Sie sich beispielsweise eine Situation vor, in der Sie eine erste Anfrage stellen und diese das Zeitlimit überschreitet. Wenn Sie die Anfrage mit derselben Anfrage-ID noch einmal senden, kann der Server prüfen, ob der ursprüngliche Vorgang mit derselben Anfrage-ID empfangen wurde. Ist dies der Fall, wird die zweite Anfrage ignoriert. Dadurch wird verhindert, dass Clients versehentlich doppelte Zusicherungen erstellen.

Die Anfrage-ID muss eine gültige UUID sein, mit der Ausnahme, dass null UUID nicht unterstützt wird (00000000-0000-0000-0000-000000000000).

force

bool

Optional. Wenn auf "true" gesetzt, werden alle Unterressourcen aus dieser Mitgliedschaft ebenfalls gelöscht. Andernfalls funktioniert die Anfrage nur, wenn die Mitgliedschaft keine Unterressource hat.

DeleteScopeNamespaceRequest

Anfrage zum Löschen eines Flotten-Namespace.

Felder
name

string

Erforderlich. Der Name der Namespace-Ressource im Format projects/*/locations/*/scopes/*/namespaces/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.namespaces.delete

DeleteScopeRBACRoleBindingRequest

Anfrage zum Löschen einer Bereichs-RBACRoleBinding.

Felder
name

string

Erforderlich. Der Name der RBACRoleBinding-Ressource im Format projects/*/locations/*/scopes/*/rbacrolebindings/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.rbacrolebindings.delete

DeleteScopeRequest

Anfrage zum Löschen eines Bereichs.

Felder
name

string

Erforderlich. Der Name der Bereichsressource im Format projects/*/locations/*/scopes/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.scopes.delete

EdgeCluster

EdgeCluster enthält spezifische Informationen für Google Edge-Cluster.

Felder

Funktion

„Feature” steht für die Einstellungen und den Status eines Hub-Features.

Felder
name

string

Nur Ausgabe. Der vollständige, eindeutige Name dieser Feature-Ressource im Format projects/*/locations/*/features/*.

labels

map<string, string>

Labels für dieses Feature.

resource_state

FeatureResourceState

Nur Ausgabe. Status der Featureressource selbst.

spec

CommonFeatureSpec

Optional. Hub-weite Featurekonfiguration. Wenn dieses Feature keine Hub-weite Konfiguration unterstützt, wird dieses Feld möglicherweise nicht verwendet.

membership_specs

map<string, MembershipFeatureSpec>

Optional. Mitgliedschaftsspezifische Konfiguration für dieses Feature. Wenn dieses Feature keine mitgliedschaftsspezifischen Konfigurationen unterstützt, wird dieses Feld möglicherweise nicht verwendet.

Die Schlüssel geben im folgenden Format an, für welche Mitgliedschaft die Konfiguration bestimmt ist:

projects/{p}/locations/{l}/memberships/{m}

Dabei ist {p} das Projekt, {l} ein gültiger Speicherort und {m} eine gültige Mitgliedschaft in diesem Projekt an diesem Speicherort. {p} entspricht dem Projekt der Funktion.

{p} wird immer als Projektnummer zurückgegeben. Die Projekt-ID wird jedoch bei der Eingabe auch akzeptiert. Wenn dieselbe Mitgliedschaft zweimal in der Zuordnung angegeben wird (mit dem Projekt-ID-Formular und dem Projektnummernformular), wird genau EINER der Einträge gespeichert, wobei keine Garantie dafür besteht. Aus diesem Grund wird empfohlen, für alle Einträge beim Mutieren eines Features dasselbe Format zu verwenden.

state

CommonFeatureState

Nur Ausgabe. Der Hub-weite Funktionsstatus.

membership_states

map<string, MembershipFeatureState>

Nur Ausgabe. Mitgliedschaftsspezifischer Funktionsstatus. Wenn diese Funktion den Status pro Mitgliedschaft meldet, wird dieses Feld möglicherweise nicht verwendet.

Die Schlüssel geben im folgenden Format an, für welche Mitgliedschaft der Status gilt:

projects/{p}/locations/{l}/memberships/{m}

Dabei ist {p} die Projektnummer, {l} ein gültiger Speicherort und {m} eine gültige Mitgliedschaft in diesem Projekt an diesem Speicherort. {p} MUSS mit der Projektnummer des Features übereinstimmen.

create_time

Timestamp

Nur Ausgabe. Wann die Feature-Ressource erstellt wurde.

update_time

Timestamp

Nur Ausgabe. Der Zeitpunkt der letzten Aktualisierung der Funktionsressource.

delete_time

Timestamp

Nur Ausgabe. Wann die Feature-Ressource gelöscht wurde.

fleet_default_member_config

CommonFleetDefaultMemberConfigSpec

Optional. Die Featurekonfiguration gilt für alle Mitgliedschaften der Flotte.

scope_specs

map<string, ScopeFeatureSpec>

Optional. Bereichsspezifische Konfiguration für dieses Feature. Wenn dieses Feature keine bereichsspezifischen Konfigurationen unterstützt, wird dieses Feld möglicherweise nicht verwendet.

Die Schlüssel geben im folgenden Format an, für welchen Bereich die Konfiguration gilt:

projects/{p}/locations/global/scopes/{s}

Dabei ist {p} das Projekt, {s} ein gültiger Bereich in diesem Projekt. {p} entspricht dem Projekt des Features.

{p} wird immer als Projektnummer zurückgegeben. Die Projekt-ID wird jedoch bei der Eingabe auch akzeptiert. Wenn in der Karte zweimal derselbe Bereich angegeben ist (mit dem Projekt-ID-Format und dem Projektnummernformat), wird genau EINER der Einträge gespeichert, wobei keine Garantie dafür besteht, welcher. Aus diesem Grund wird empfohlen, für alle Einträge beim Mutieren eines Features dasselbe Format zu verwenden.

scope_states

map<string, ScopeFeatureState>

Nur Ausgabe. Bereichsspezifischer Featurestatus. Wenn dieses Feature einen bereichsspezifischen Status meldet, wird dieses Feld möglicherweise nicht verwendet.

Die Schlüssel geben in folgendem Format an, für welchen Bereich der Status gilt:

projects/{p}/locations/global/scopes/{s}

Dabei ist {p} das Projekt, {s} ein gültiger Bereich in diesem Projekt. {p} entspricht dem Projekt der Funktion.

FeatureResourceState

FeatureResourceState beschreibt den Status einer Feature-Ressource in der GkeHub API. Unter FeatureState finden Sie den „Ausführungsstatus“ des Features im Hub und in Mitgliedschaften.

Felder
state

FeatureResourceState.State

Der aktuelle Status der Featureressource in der Hub API.

Status

Der Status beschreibt den Lebenszyklusstatus eines Features.

Enums
STATE_UNSPECIFIED Status ist unbekannt oder nicht festgelegt.
ENABLING Das Feature wird aktiviert und die Feature-Ressource wird erstellt. Anschließend wird das entsprechende Feature in diesem Hub aktiviert.
ACTIVE Das Feature ist in diesem Hub aktiviert und die Featureressource ist vollständig verfügbar.
DISABLING Das Feature wird in diesem Hub deaktiviert und die Feature-Ressource wird gelöscht.
UPDATING Die Feature-Ressource wird aktualisiert.
SERVICE_UPDATING Die Feature-Ressource wird vom Hub-Dienst aktualisiert.

FeatureState

FeatureState beschreibt den übergeordneten Status eines Features. Kann verwendet werden, um den Status einer Funktion auf Umgebungsebene oder je Mitgliedschaft, je nach Kontext, zu beschreiben.

Felder
code

FeatureState.Code

Der maschinenlesbare Gesamtstatus dieses Features.

description

string

Eine für Menschen lesbare Beschreibung des aktuellen Status.

update_time

Timestamp

Der Zeitpunkt, zu dem dieser Status und alle zugehörigen featurespezifischen Details aktualisiert wurden.

Code

Code stellt einen maschinenlesbaren allgemeinen Status des Features dar.

Enums
CODE_UNSPECIFIED Unbekannt oder nicht festgelegt.
OK Das Feature funktioniert normal.
WARNING Bei dem Feature ist ein Problem aufgetreten und es befindet sich in einem eingeschränkten Zustand. Es ist möglicherweise ein Eingreifen erforderlich, um zum normalen Betrieb zurückzukehren. Weitere Informationen finden Sie in der Beschreibung und in den zugehörigen featurespezifischen Details.
ERROR Das Feature wird nicht ausgeführt oder ist stark eingeschränkt. Es ist möglicherweise ein Eingreifen erforderlich, um zum normalen Betrieb zurückzukehren. Weitere Informationen finden Sie in der Beschreibung und in den zugehörigen featurespezifischen Details.

Flotte

Fleet enthält die flottenweiten Metadaten und die Konfiguration.

Felder
name

string

Nur Ausgabe. Der vollständige Ressourcenname dieser Flotte im Format projects/{project}/locations/{location}/fleets/{fleet}.

Jedes Google Cloud-Projekt kann höchstens eine Flottenressource mit dem Namen "Standard" haben.

display_name

string

Optional. Ein vom Nutzer zugewiesener Anzeigename für die Flotte. Wenn vorhanden, muss er zwischen 4 und 30 Zeichen lang sein. Zulässige Zeichen sind: Klein- und Großbuchstaben, Ziffern, Bindestriche, einfache Anführungszeichen, doppelte Anführungszeichen, Leerzeichen und Ausrufezeichen.

Beispiel: Production Fleet

create_time

Timestamp

Nur Ausgabe. Wann die Flotte erstellt wurde.

update_time

Timestamp

Nur Ausgabe. Wann die Flotte zuletzt aktualisiert wurde.

delete_time

Timestamp

Nur Ausgabe. Wann die Flotte gelöscht wurde.

uid

string

Nur Ausgabe. Von Google generierte UUID für diese Ressource. Dies ist für alle Flottenressourcen einmalig. Wenn eine Flottenressource gelöscht und eine andere Ressource mit demselben Namen erstellt wird, erhält sie eine andere UID.

state

FleetLifecycleState

Nur Ausgabe. Status der Namespace-Ressource.

default_cluster_config

DefaultClusterConfig

Optional. Die Standard-Clusterkonfigurationen, die auf die gesamte Flotte angewendet werden sollen.

labels

map<string, string>

Optional. Labels für diese Flotte.

FleetLifecycleState

FleetLifecycleState beschreibt den Status einer Flottenressource.

Felder
code

FleetLifecycleState.Code

Nur Ausgabe. Der aktuelle Status der Flottenressource.

Code

Der Code beschreibt den Status einer Flottenressource.

Enums
CODE_UNSPECIFIED Der Code ist nicht festgelegt.
CREATING Die Flotte wird erstellt.
READY Die Flotte ist aktiv.
DELETING Die Flotte wird gelöscht.
UPDATING Der Flotte wird aktualisiert.

GenerateConnectManifestRequest

Anfragenachricht für die Methode GkeHub.GenerateConnectManifest. .

Felder
name

string

Erforderlich. Der Name der Mitgliedschaftsressource, mit der der Agent verknüpft werden soll, im Format projects/*/locations/*/memberships/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.memberships.generateConnectManifest
namespace

string

Optional. Namespace für GKE Connect-Agent-Ressourcen. Die Standardeinstellung ist gke-connect.

Der Connect Agent wird bei Ausführung im Standard-Namespace automatisch autorisiert. Andernfalls muss eine explizite Autorisierung mit einer zusätzlichen IAM-Bindung gewährt werden.

proxy

bytes

Optional. URI eines Proxys, wenn für eine Verbindung vom Agent zu gkeconnect.googleapis.com die Verwendung eines Proxys erforderlich ist. Das Format muss die Form http(s)://{proxy_address} haben, je nach dem vom Proxy unterstützten HTTP-/HTTPS-Protokoll. Dadurch wird der ausgehende Traffic des Connect-Agents über einen HTTP(S)-Proxy geleitet.

version

string

Optional. Die zu verwendende Connect-Agent-Version. Die Standardeinstellung ist die neueste Version.

is_upgrade

bool

Optional. Falls "true", generieren Sie die Ressourcen nur für das Upgrade. Einige Ressourcen, die nur für die Installation generiert wurden (z. B. Secrets), werden ausgeschlossen.

registry

string

Optional. Die Registry, aus der das Connect-Agent-Image abgerufen werden soll. Die Standardeinstellung ist gcr.io/gkeconnect.

image_pull_secret_content

bytes

Optional. Das Image ruft Secret-Inhalte für die Registry ab, falls es nicht öffentlich ist.

GenerateConnectManifestResponse

GenerateConnectManifestResponse enthält Manifestinformationen für die Installation/Aktualisierung eines Connect-Agents.

Felder
manifest[]

ConnectAgentResource

Die sortierte Liste der Kubernetes-Ressourcen, die für die Installation/Upgrade des GKE Connect-Agents auf den Cluster angewendet werden müssen.

GenerateMembershipRBACRoleBindingYAMLRequest

Anfrage zum Generieren einer YAML-Datei der RBAC-Richtlinien für das angegebene RoleBinding und die zugehörigen Ressourcen zur Identitätsübertragung.

Felder
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem die RBACRoleBinding erstellt wird. Wird im Format projects/*/locations/*/memberships/* angegeben.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.rbacrolebindings.get
rbacrolebinding_id

string

Erforderlich. Vom Client ausgewählte ID für die RBACRoleBinding. rbacrolebinding_id muss ein gültiges RFC 1123-konformes DNS-Label sein:

  1. Maximal 63 Zeichen.
  2. Muss aus alphanumerischen Kleinbuchstaben oder - bestehen.
  3. Muss mit einem alphanumerischen Zeichen beginnen und enden.

Dies kann als regulärer Ausdruck [a-z0-9]([-a-z0-9]*[a-z0-9])? mit einer maximalen Länge von 63 Zeichen ausgedrückt werden.

rbacrolebinding

RBACRoleBinding

Erforderlich. Die rbacrolebindings, für die die YAML-Datei generiert werden soll.

GenerateMembershipRBACRoleBindingYAMLResponse

Antwort für GenerateRBACRoleBindingYAML.

Felder
role_bindings_yaml

string

Ein YAML-Text-Blob mit den RBAC-Richtlinien.

GetFeatureRequest

Anfragenachricht für die Methode GkeHub.GetFeature.

Felder
name

string

Erforderlich. Der Name der Feature-Ressource im Format projects/*/locations/*/features/*

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.features.get

GetFleetRequest

Anfragenachricht für die Methode GkeHub.GetFleet.

Felder
name

string

Erforderlich. Der Name der Flottenressource im Format projects/*/locations/*/fleets/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.fleet.get

GetMembershipBindingRequest

Anfragenachricht für die Methode GkeHub.GetMembershipBinding.

Felder
name

string

Erforderlich. Der Name der MembershipBinding-Ressource im Format projects/*/locations/*/memberships/*/bindings/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.membershipbindings.get

GetMembershipRBACRoleBindingRequest

Anfragenachricht für die Methode GkeHub.GetMembershipRBACRoleBinding.

Felder
name

string

Erforderlich. Der Name der RBACRoleBinding-Ressource im Format projects/*/locations/*/memberships/*/rbacrolebindings/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.rbacrolebindings.get

GetMembershipRequest

Anfragenachricht für die Methode GkeHub.GetMembership.

Felder
name

string

Erforderlich. Der Name der Mitgliedschaftsressource im Format projects/*/locations/*/memberships/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.memberships.get

GetScopeNamespaceRequest

Anfragenachricht für die Methode GkeHub.GetNamespace.

Felder
name

string

Erforderlich. Der Name der Namespace-Ressource im Format projects/*/locations/*/scopes/*/namespaces/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.namespaces.get

GetScopeRBACRoleBindingRequest

Anfragenachricht für die Methode GkeHub.GetScopeRBACRoleBinding.

Felder
name

string

Erforderlich. Der Name der RBACRoleBinding-Ressource im Format projects/*/locations/*/scopes/*/rbacrolebindings/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.rbacrolebindings.get

GetScopeRequest

Anfragenachricht für die Methode GkeHub.GetScope.

Felder
name

string

Erforderlich. Der Name der Bereichsressource im Format projects/*/locations/*/scopes/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.scopes.get

GkeCluster

GkeCluster enthält für GKE-Cluster spezifische Informationen.

Felder
cluster_missing

bool

Nur Ausgabe. Wenn cluster_missing festgelegt ist, bedeutet dies, dass der GKE-Cluster nicht mehr in der GKE-Steuerungsebene vorhanden ist.

KubernetesMetadata

KubernetesMetadata stellt Informationsmetadaten für Mitgliedschaften bereit, die Kubernetes-Cluster darstellen.

Felder
kubernetes_api_server_version

string

Nur Ausgabe. Versionsstring des Kubernetes API-Servers, wie von /version gemeldet.

node_provider_id

string

Nur Ausgabe. Knotenanbieter-ID, wie vom ersten Knoten in der Liste der Knoten auf dem Kubernetes-Endpunkt gemeldet. Auf Kubernetes-Plattformen, die Cluster mit null Knoten unterstützen (z. B. GKE-on-GCP), ist der Wert für „node_count“ null und die „node_provider_id“ ist leer.

node_count

int32

Nur Ausgabe. Knotenanzahl, wie von Kubernetes-Knotenressourcen gemeldet.

vcpu_count

int32

Nur Ausgabe. vCPU-Anzahl, wie von den Ressourcen der Kubernetes-Knoten gemeldet.

memory_mb

int32

Nur Ausgabe. Die gesamte Speicherkapazität, angegeben durch die Summe aller Kubernetes-Knotenressourcen, definiert in MB.

update_time

Timestamp

Nur Ausgabe. Der Zeitpunkt der letzten Aktualisierung dieser Details. Diese „update_time“ unterscheidet sich von der „update_time“ auf Mitgliedschaftsebene, da EndpointDetails intern für API-Nutzer aktualisiert werden.

KubernetesResource

KubernetesResource enthält die YAML-Manifeste und -Konfigurationen für die Kubernetes-Mitgliedschaftsressourcen im Cluster. Nach „CreateMembership“ oder „Update Membership“ sollten diese Ressourcen noch einmal im Cluster angewendet werden.

Felder
membership_cr_manifest

string

Nur Eingabe Die YAML-Darstellung der Mitgliedschaft-CR. Dieses Feld wird für GKE-Cluster ignoriert, in denen Hub die CR direkt lesen kann.

Aufrufer sollten die CR angeben, die derzeit im Cluster während der CreateMembership oder UpdateMembership vorhanden ist, oder dieses Feld leer lassen, wenn keine vorhanden ist. Das CR-Manifest wird verwendet, um zu prüfen, ob der Cluster nicht mit einer anderen Mitgliedschaft registriert wurde.

membership_resources[]

ResourceManifest

Nur Ausgabe. Zusätzliche Kubernetes-Ressourcen, die nach der Erstellung der Mitgliedschaft und nach jeder Aktualisierung auf den Cluster angewendet werden müssen.

Dieses Feld wird nur in der Mitgliedschaft ausgefüllt, die von einem erfolgreichen Vorgang mit langer Ausführungszeit von CreateMembership oder UpdateMembership zurückgegeben wurde. Während normaler GetMembership- oder ListMemberships-Anfragen wird es nicht ausgefüllt. Um das Ressourcenmanifest nach der ersten Registrierung abzurufen, sollte der Aufrufer einen UpdateMembership-Aufruf mit einer leeren Feldmaske ausführen.

connect_resources[]

ResourceManifest

Nur Ausgabe. Kubernetes-Ressourcen zur Installation des GKE Connect-Agents

Dieses Feld wird nur in der Mitgliedschaft ausgefüllt, die von einem erfolgreichen Vorgang mit langer Ausführungszeit von CreateMembership oder UpdateMembership zurückgegeben wurde. Während normaler GetMembership- oder ListMemberships-Anfragen wird es nicht ausgefüllt. Um das Ressourcenmanifest nach der ersten Registrierung abzurufen, sollte der Aufrufer einen UpdateMembership-Aufruf mit einer leeren Feldmaske ausführen.

resource_options

ResourceOptions

Optional. Optionen für die Generierung von Kubernetes-Ressourcen.

ListAdminClusterMembershipsRequest

Anfragenachricht für die Methode GkeHub.ListAdminClusterMemberships.

Felder
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem die Mitgliedschaften des Administratorclusters aufgeführt werden. Wird im Format projects/*/locations/* angegeben.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.memberships.list
page_size

int32

Optional. Beim Anfordern einer „Seite“ mit Ressourcen gibt page_size die Anzahl der zurückzugebenden Ressourcen an. Wenn nicht angegeben oder auf 0 festgelegt, werden alle Ressourcen zurückgegeben.

page_token

string

Optional. Token, das vom vorherigen Aufruf an ListAdminClusterMemberships zurückgegeben wurde. Gibt die Position in der Liste an, von der aus die Ressourcen aufgelistet werden sollen.

filter

string

Optional. Listet Mitgliedschaften von Administratorclustern auf, die dem Filterausdruck entsprechen.

order_by

string

Optional. Ein oder mehrere Felder, die verglichen und zum Sortieren der Ausgabe verwendet werden sollen. Siehe https://google.aip.dev/132#ordering.

ListAdminClusterMembershipsResponse

Antwortnachricht für die Methode GkeHub.ListAdminClusterMemberships.

Felder
admin_cluster_memberships[]

Membership

Die Liste der übereinstimmenden Mitgliedschaften von Administratorclustern.

next_page_token

string

Ein Token, mit dem die nächste Ressourcenseite von der Methode ListAdminClusterMemberships angefordert wird. Der Wert eines leeren Strings bedeutet, dass es keine weiteren Ressourcen gibt, die zurückgegeben werden können.

unreachable[]

string

Liste der Standorte, die beim Abrufen dieser Liste nicht erreicht werden konnten.

ListFeaturesRequest

Anfragenachricht für die Methode GkeHub.ListFeatures.

Felder
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem die Features aufgelistet werden. Wird im Format projects/*/locations/* angegeben.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.features.list
page_size

int32

Beim Anfordern einer "Seite" mit Ressourcen gibt page_size die Anzahl der zurückzugebenden Ressourcen an. Wenn nicht angegeben oder auf 0 festgelegt, werden alle Ressourcen zurückgegeben.

page_token

string

Token, das vom vorherigen Aufruf an ListFeatures zurückgegeben wurde. Gibt die Position in der Liste an, von der aus die Ressourcen aufgelistet werden sollen.

filter

string

Listet Features auf, die dem Filterausdruck entsprechen. Dabei wird die unter https://google.aip.dev/160 beschriebene Syntax beachtet.

Beispiele:

  • Feature mit dem Namen „servicemesh“ im Projekt „foo-proj“:
  name = "projects/foo-proj/locations/global/features/servicemesh"
  • Features mit einem Label namens foo:
  labels.foo:*
  • Features mit einem Label namens foo, dessen Wert bar ist:
  labels.foo = bar
order_by

string

Ein oder mehrere Felder, die verglichen und zum Sortieren der Ausgabe verwendet werden sollen. Siehe https://google.aip.dev/132#ordering.

ListFeaturesResponse

Antwortnachricht für die Methode GkeHub.ListFeatures.

Felder
resources[]

Feature

Die Liste der übereinstimmenden Features

next_page_token

string

Ein Token, mit dem die nächste Ressourcenseite von der Methode ListFeatures angefordert wird. Der Wert eines leeren Strings bedeutet, dass keine weiteren Ressourcen für die Rückgabe vorhanden sind.

ListFleetsRequest

Anfragenachricht für die Methode GkeHub.ListFleets.

Felder
parent

string

Erforderlich. Die Organisation oder das Projekt, unter dem Flotten aufgelistet werden sollen, im Format organizations/*/locations/* oder projects/*/locations/*.

page_token

string

Optional. Ein Seitentoken, das von einem vorherigen ListFleets-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListFleets bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

page_size

int32

Optional. Die maximale Anzahl der zurückzugebenden Flotten. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 200 Flotten zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.

ListFleetsResponse

Antwortnachricht für die Methode GkeHub.ListFleetsResponse.

Felder
fleets[]

Fleet

Die Liste der übereinstimmenden Flotten.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten. Das Token ist nur 1 Stunde lang gültig.

ListMembershipBindingsRequest

Anfrage zum Auflisten von MembershipBinding.

Felder
parent

string

Erforderlich. Die übergeordnete Mitgliedschaft, für die die MembershipBindings aufgeführt werden. Wird im Format projects/*/locations/*/memberships/* angegeben.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.membershipbindings.list
page_size

int32

Optional. Beim Anfordern einer „Seite“ mit Ressourcen gibt page_size die Anzahl der zurückzugebenden Ressourcen an. Wenn nicht angegeben oder auf 0 festgelegt, werden alle Ressourcen zurückgegeben.

page_token

string

Optional. Token, das vom vorherigen Aufruf an ListMembershipBindings zurückgegeben wurde. Gibt die Position in der Liste an, von der aus die Ressourcen aufgelistet werden sollen.

filter

string

Optional. Listet MembershipBindings auf, die dem Filterausdruck entsprechen, und zwar gemäß der unter https://google.aip.dev/160 beschriebenen Syntax.

ListMembershipBindingsResponse

Liste der MembershipBindings

Felder
membership_bindings[]

MembershipBinding

Die Liste der membership_bindings

next_page_token

string

Ein Token, mit dem die nächste Seite von Ressourcen von der Methode ListMembershipBindings angefordert wird. Der Wert eines leeren Strings bedeutet, dass keine weiteren Ressourcen für die Rückgabe vorhanden sind.

ListMembershipRBACRoleBindingsRequest

Anfrage zum Auflisten von RBACRoleBindings für die Mitgliedschaft.

Felder
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem die Features aufgelistet werden. Wird im Format projects/*/locations/*/memberships/* angegeben.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.rbacrolebindings.list
page_size

int32

Optional. Beim Anfordern einer „Seite“ mit Ressourcen gibt page_size die Anzahl der zurückzugebenden Ressourcen an. Wenn nicht angegeben oder auf 0 festgelegt, werden alle Ressourcen zurückgegeben.

page_token

string

Optional. Token, das vom vorherigen Aufruf an ListMembershipRBACRoleBindings zurückgegeben wurde. Gibt die Position in der Liste an, von der aus die Ressourcen aufgelistet werden sollen.

ListMembershipRBACRoleBindingsResponse

Liste der RBACRoleBindings für die Mitgliedschaft.

Felder
rbacrolebindings[]

RBACRoleBinding

Die Liste der RBAC-RoleBindings für die Mitgliedschaft.

next_page_token

string

Ein Token, mit dem die nächste Seite von Ressourcen von der Methode ListMembershipRBACRoleBindings angefordert wird. Der Wert eines leeren Strings bedeutet, dass keine weiteren Ressourcen für die Rückgabe vorhanden sind.

ListMembershipsRequest

Anfragenachricht für die Methode GkeHub.ListMemberships.

Felder
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem die Mitgliedschaften aufgelistet werden. Wird im Format projects/*/locations/* angegeben. projects/*/locations/- listet die Mitgliedschaften in allen Regionen auf.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.memberships.list
page_size

int32

Optional. Beim Anfordern einer „Seite“ mit Ressourcen gibt page_size die Anzahl der zurückzugebenden Ressourcen an. Wenn nicht angegeben oder auf 0 festgelegt, werden alle Ressourcen zurückgegeben.

page_token

string

Optional. Token, das vom vorherigen Aufruf an ListMemberships zurückgegeben wurde. Gibt die Position in der Liste an, von der aus die Ressourcen aufgelistet werden sollen.

filter

string

Optional. Listet Mitgliedschaften auf, die dem Filterausdruck entsprechen. Dabei wird die unter https://google.aip.dev/160 beschriebene Syntax beachtet.

Beispiele:

  • Der Name lautet bar im Projekt foo-proj und am Standort global:
  name = "projects/foo-proj/locations/global/membership/bar"
  • Mitgliedschaften mit dem Label foo:
  labels.foo:*
  • Mitgliedschaften mit dem Label foo, dessen Wert bar ist:
  labels.foo = bar
  • Mitgliedschaften mit dem Status CREATING:
  state = CREATING
order_by

string

Optional. Ein oder mehrere Felder, die verglichen und zum Sortieren der Ausgabe verwendet werden sollen. Siehe https://google.aip.dev/132#ordering.

ListMembershipsResponse

Antwortnachricht für die Methode GkeHub.ListMemberships.

Felder
resources[]

Membership

Die Liste der übereinstimmenden Mitgliedschaften.

next_page_token

string

Ein Token, mit dem die nächste Seite von Ressourcen von der Methode ListMemberships angefordert wird. Der Wert eines leeren Strings bedeutet, dass es keine weiteren Ressourcen gibt, die zurückgegeben werden können.

unreachable[]

string

Liste der Standorte, die beim Abrufen dieser Liste nicht erreicht werden konnten.

ListScopeNamespacesRequest

Anfrage zum Auflisten von Flotten-Namespaces.

Felder
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem die Features aufgelistet werden. Wird im Format projects/*/locations/*/scopes/* angegeben.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.namespaces.list
page_size

int32

Optional. Beim Anfordern einer „Seite“ mit Ressourcen gibt page_size die Anzahl der zurückzugebenden Ressourcen an. Wenn nicht angegeben oder auf 0 festgelegt, werden alle Ressourcen zurückgegeben.

page_token

string

Optional. Token, das vom vorherigen Aufruf an ListFeatures zurückgegeben wurde. Gibt die Position in der Liste an, von der aus die Ressourcen aufgelistet werden sollen.

ListScopeNamespacesResponse

Liste der Flotten-Namespaces.

Felder
scope_namespaces[]

Namespace

Die Liste der Flotten-Namespaces

next_page_token

string

Ein Token, mit dem die nächste Ressourcenseite von der Methode ListNamespaces angefordert wird. Der Wert eines leeren Strings bedeutet, dass keine weiteren Ressourcen für die Rückgabe vorhanden sind.

ListScopeRBACRoleBindingsRequest

Anfrage zum Auflisten von Bereichs-RBACRoleBindings.

Felder
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem die Features aufgelistet werden. Wird im Format projects/*/locations/*/scopes/* angegeben.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.rbacrolebindings.list
page_size

int32

Optional. Beim Anfordern einer „Seite“ mit Ressourcen gibt page_size die Anzahl der zurückzugebenden Ressourcen an. Wenn nicht angegeben oder auf 0 festgelegt, werden alle Ressourcen zurückgegeben.

page_token

string

Optional. Token, das vom vorherigen Aufruf an ListScopeRBACRoleBindings zurückgegeben wurde. Gibt die Position in der Liste an, von der aus die Ressourcen aufgelistet werden sollen.

ListScopeRBACRoleBindingsResponse

Liste der RBACRoleBindings für Bereiche

Felder
rbacrolebindings[]

RBACRoleBinding

Die Liste der RBACRoleBindings für Bereiche.

next_page_token

string

Ein Token, mit dem die nächste Ressourcenseite von der Methode ListScopeRBACRoleBindings angefordert wird. Der Wert eines leeren Strings bedeutet, dass keine weiteren Ressourcen für die Rückgabe vorhanden sind.

ListScopesRequest

Anfrage zum Auflisten von Bereichen.

Felder
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem der Bereich aufgeführt wird. Wird im Format projects/*/locations/* angegeben.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.scopes.list
page_size

int32

Optional. Beim Anfordern einer „Seite“ mit Ressourcen gibt page_size die Anzahl der zurückzugebenden Ressourcen an. Wenn nicht angegeben oder auf 0 festgelegt, werden alle Ressourcen zurückgegeben.

page_token

string

Optional. Token, das vom vorherigen Aufruf an ListScopes zurückgegeben wurde. Gibt die Position in der Liste an, von der aus die Ressourcen aufgelistet werden sollen.

ListScopesResponse

Liste der Bereiche.

Felder
scopes[]

Scope

Die Liste der Bereiche

next_page_token

string

Ein Token, mit dem die nächste Ressourcenseite von der Methode ListScopes angefordert wird. Der Wert eines leeren Strings bedeutet, dass keine weiteren Ressourcen für die Rückgabe vorhanden sind.

Mitgliedschaft

Die Mitgliedschaft enthält Informationen zu einem Mitgliedscluster.

Felder
name

string

Nur Ausgabe. Der vollständige, eindeutige Name dieser Mitgliedschaftsressource im Format projects/*/locations/*/memberships/{membership_id}, der während der Erstellung festgelegt wurde.

membership_id muss ein gültiges RFC 1123-konformes DNS-Label sein:

  1. Maximal 63 Zeichen.
  2. Muss aus alphanumerischen Kleinbuchstaben oder - bestehen.
  3. Muss mit einem alphanumerischen Zeichen beginnen und enden.

Dies kann als regulärer Ausdruck [a-z0-9]([-a-z0-9]*[a-z0-9])? mit einer maximalen Länge von 63 Zeichen ausgedrückt werden.

labels

map<string, string>

Optional. Labels für diese Mitgliedschaft.

description

string

Nur Ausgabe. Beschreibung dieser Mitgliedschaft. Ist auf maximal 63 Zeichen beschränkt. Muss mit dem regulären Ausdruck [a-zA-Z0-9][a-zA-Z0-9_\-\.\ ]* übereinstimmen.

Dieses Feld ist für Legacy-Zwecke vorhanden.

state

MembershipState

Nur Ausgabe. Status der Mitgliedschaftsressource.

create_time

Timestamp

Nur Ausgabe. Wann die Mitgliedschaft erstellt wurde.

update_time

Timestamp

Nur Ausgabe. Wann die Mitgliedschaft zuletzt aktualisiert wurde.

delete_time

Timestamp

Nur Ausgabe. Wann die Mitgliedschaft gelöscht wurde.

external_id

string

Optional. Eine extern generierte und verwaltete ID für diese Mitgliedschaft. Diese ID kann nach dem Erstellen geändert werden. Das wird jedoch nicht empfohlen.

Die ID muss mit dem regulären Ausdruck [a-zA-Z0-9][a-zA-Z0-9_\-\.]* übereinstimmen.

Wenn diese Mitgliedschaft einen Kubernetes-Cluster darstellt, sollte dieser Wert auf die UID des Namespace-Objekts kube-system festgelegt werden.

last_connection_time

Timestamp

Nur Ausgabe. Bei Clustern, die Connect verwenden, der Zeitstempel der letzten Verbindung zu Google Cloud. Diese Uhrzeit wird alle paar Minuten aktualisiert, nicht kontinuierlich. Bei Clustern, die GKE Connect nicht verwenden oder nie erfolgreich verbunden wurden, wird dieses Feld nicht festgelegt.

unique_id

string

Nur Ausgabe. Von Google generierte UUID für diese Ressource. Dies ist für alle Mitgliedschaftsressourcen eindeutig. Wenn eine Mitgliedschaftsressource gelöscht und eine andere Ressource mit demselben Namen erstellt wird, erhält sie eine andere unique_ID.

authority

Authority

Optional. Arbeitslasten aus dieser Mitgliedschaft identifizieren. Weitere Informationen finden Sie in der Dokumentation zu Workload Identity: https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity

monitoring_config

MonitoringConfig

Optional. Die Informationen zur Monitoring-Konfiguration für diese Mitgliedschaft.

Union-Feld type. Der Ressourcentyp, der durch diese Mitgliedschaft type dargestellt wird, kann nur einer der folgenden sein:
endpoint

MembershipEndpoint

Optional. Endpunktinformationen zum Erreichen dieses Mitglieds.

MembershipBinding

MembershipBinding ist eine Unterressource einer Mitgliedschaft, die angibt, an welche Flottenbereiche (oder andere zukünftige Flottenressourcen) eine Mitgliedschaft gebunden ist.

Felder
name

string

Der Ressourcenname für die membershipbinding selbst projects/{project}/locations/{location}/memberships/{membership}/bindings/{membershipbinding}

uid

string

Nur Ausgabe. Von Google generierte UUID für diese Ressource. Dies ist für alle membershipbinding-Ressourcen eindeutig. Wenn eine membershipbinding-Ressource gelöscht und eine andere Ressource mit demselben Namen erstellt wird, erhält sie eine andere UID.

create_time

Timestamp

Nur Ausgabe. Wann die Mitgliedschaftsbindung erstellt wurde.

update_time

Timestamp

Nur Ausgabe. Wann die Mitgliedschaftsbindung zuletzt aktualisiert wurde.

delete_time

Timestamp

Nur Ausgabe. Wann die Mitgliedschaftsbindung gelöscht wurde.

state

MembershipBindingLifecycleState

Nur Ausgabe. Status der Mitgliedschaftsbindungsressource.

labels

map<string, string>

Optional. Labels für diese MembershipBinding.

Union-Feld target. Um welche Art von membershipbinding handelt es sich. Für target ist nur einer der folgenden Werte zulässig:
scope

string

Ein Bereichsressourcenname im Format projects/*/locations/*/scopes/*.

MembershipBindingLifecycleState

MembershipBindingLifecycleState beschreibt den Status einer Bindungsressource.

Felder
code

MembershipBindingLifecycleState.Code

Nur Ausgabe. Der aktuelle Status der MembershipBinding-Ressource.

Code

Der Code beschreibt den Status einer MembershipBinding-Ressource.

Enums
CODE_UNSPECIFIED Der Code ist nicht festgelegt.
CREATING Die membershipbinding wird erstellt.
READY Die membershipbinding ist aktiv.
DELETING Die membershipbinding wird gelöscht.
UPDATING Die membershipbinding wird aktualisiert.

MembershipEndpoint

MemberEndpoint enthält Informationen, die zur Kontaktaufnahme mit einer Kubernetes API, einem Endpunkt und zusätzlichen Kubernetes-Metadaten erforderlich sind.

Felder
kubernetes_metadata

KubernetesMetadata

Nur Ausgabe. Nützliche Kubernetes-spezifische Metadaten.

kubernetes_resource

KubernetesResource

Optional. Die Kubernetes-Ressourcen im Cluster, die auf einen korrekt registrierten Cluster im stabilen Zustand angewendet werden sollen. Diese Ressourcen:

  • Sorgen dafür, dass der Cluster ausschließlich bei einer Hub-Mitgliedschaft registriert wird.
  • Geben Informationen zum Arbeitslastpool weiter, die im Feld "Mitgliedschaftsstelle" verfügbar sind.
  • Sorgen für eine ordnungsgemäße Erstkonfiguration der Hub-Standardfeatures.
google_managed

bool

Nur Ausgabe. Gibt an, ob der Lebenszyklus dieser Mitgliedschaft von einem Google-Clusterplattformdienst verwaltet wird.

Union-Feld type. Clusterinformationen des registrierten Clusters. Für type ist nur einer der folgenden Werte zulässig:
gke_cluster

GkeCluster

Optional. Spezifische Informationen für einen GKE-auf-GCP-Cluster

on_prem_cluster

OnPremCluster

Optional. Spezifische Informationen für einen GKE On-Prem-Cluster Ein lokaler Nutzercluster, der keinen resourceLink hat, darf dieses Feld nicht verwenden. Er sollte stattdessen einen "null"-"Typ" haben.

multi_cloud_cluster

MultiCloudCluster

Optional. Spezifische Informationen für einen GKE-Multi-Cloud-Cluster

edge_cluster

EdgeCluster

Optional. Spezifische Informationen für einen Google Edge-Cluster

appliance_cluster

ApplianceCluster

Optional. Spezifische Informationen für einen GDC Edge-Appliance-Cluster.

MembershipFeatureSpec

MembershipFeatureSpec enthält Konfigurationsinformationen für eine einzelne Mitgliedschaft. HINWEIS: Verwenden Sie im Featurenamen die Snake-Case-Schreibweise

Felder
origin

MembershipFeatureSpec.Origin

Gibt an, ob diese Spezifikation pro Mitgliedschaft von einer Standardeinstellung auf Flottenebene übernommen wurde. Dieses Feld kann von Nutzern aktualisiert werden, indem sie entweder eine Mitgliedschaftskonfiguration überschreiben (die implizit auf USER aktualisiert) oder explizit auf FLEET festlegen.

Union-Feld feature_spec.

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

configmanagement

MembershipSpec

Config Management-spezifische Spezifikation.

cloudbuild

MembershipSpec

Cloud Build-spezifische Spezifikation

identityservice

MembershipSpec

Identity Service-spezifische Spezifikation.

workloadcertificate

MembershipSpec

Spezifikation des Arbeitslastzertifikats.

mesh

MembershipSpec

Anthos Service Mesh-spezifische Spezifikation

anthosobservability

AnthosObservabilityMembershipSpec

Anthos-Beobachtbarkeits-spezifische Spezifikation

policycontroller

MembershipSpec

Policy Controller-Spezifikation.

fleetobservability

MembershipSpec

Spezifikation für die Mitgliedschaft in der Flottenbeobachtbarkeit

namespaceactuation

MembershipSpec

Spezifikation für die Mitgliedschaft in FNS-Aktivierung

Ursprung

„Origin“ definiert, woher diese MemberFeatureSpec stammt.

Felder
type

MembershipFeatureSpec.Origin.Type

Der Typ gibt an, welcher Ursprungstyp festgelegt wird.

Typ

Der Typ gibt die Identität an, die die Konfiguration beibehalten hat.

Enums
TYPE_UNSPECIFIED Der Typ ist unbekannt oder ist nicht festgelegt.
FLEET Die Spezifikation pro Mitgliedschaft wurde von der Standardeinstellung auf Flottenebene übernommen.
FLEET_OUT_OF_SYNC Die Spezifikation pro Mitgliedschaft wurde von der Standardeinstellung auf Geräteebene übernommen, ist aber jetzt nicht mehr mit der aktuellen Standardeinstellung synchron.
USER Die Spezifikation pro Mitgliedschaft wurde von einer Nutzerspezifikation übernommen.

MembershipFeatureState

MembershipFeatureState enthält Informationen zum Featurestatus für eine einzelne Mitgliedschaft.

Felder
state

FeatureState

Der übergeordnete Status dieses Features für eine einzelne Mitgliedschaft.

Union-Feld feature_state.

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

servicemesh

MembershipState

Service Mesh-spezifischer Status.

metering

MembershipState

Messungsspezifischer Status.

configmanagement

MembershipState

Config Management-spezifischer Status.

identityservice

MembershipState

Identity Service-spezifischer Status.

appdevexperience

AppDevExperienceFeatureState

Appdevexperience-spezifischer Status.

policycontroller

MembershipState

Policycontroller-spezifischer Status.

clusterupgrade

MembershipState

ClusterUpgrade-Status.

fleetobservability

MembershipState

Mitgliedschaftsstatus der Flottenbeobachtbarkeit.

namespaceactuation

MembershipState

Mitgliedschaftsstatus der FNS-Aktivierung

MembershipState

MembershipState beschreibt den Status einer Mitgliedschaftsressource.

Felder
code

MembershipState.Code

Nur Ausgabe. Der aktuelle Status der Mitgliedschaftsressource.

Code

Der Code beschreibt den Status einer Mitgliedschaftsressource.

Enums
CODE_UNSPECIFIED Der Code ist nicht festgelegt.
CREATING Der Cluster wird registriert.
READY Der Cluster ist registriert.
DELETING Der Cluster wird abgemeldet.
UPDATING Die Mitgliedschaft wird aktualisiert.
SERVICE_UPDATING Die Mitgliedschaft wird vom Hub-Dienst aktualisiert.

MonitoringConfig

MonitoringConfig informiert flottenbasierte Anwendungen/Dienste/UIs darüber, wie die Messwerte für den zugrunde liegenden Cluster an Cloud-Monitoring-Dienste gemeldet werden. Ein Wert kann von leer auf nicht leer gesetzt, aber nicht direkt angepasst werden, um zu verhindern, dass versehentlich die Kontinuität von Messwerten unterbrochen wird.

Felder
project_id

string

Optional. Projekt zum Melden von Messwerten

location

string

Optional. Ort zum Melden von Messwerten

cluster

string

Optional. Zum Melden von Messwerten verwendeter Clustername. Bei Anthos on VMWare/Baremetal/MultiCloud-Clustern hat die Datei das Format {cluster_type}/{cluster_name}, z. B. "awsClusters/cluster_1".

kubernetes_metrics_prefix

string

Optional. Kubernetes-Systemmesswerte werden, sofern verfügbar, in dieses Präfix geschrieben. Standardmäßig wird in GKE „kubernetes.io“ und für Anthos „kubernetes.io/anthos“ verwendet. Hinweis: Anthos MultiCloud hat heute das Präfix „kubernetes.io“, wird aber unter kubernetes.io/anthos migriert.

cluster_hash

string

Optional. Bei GKE- und Multi-Cloud-Clustern ist dies die UUID der Clusterressource. Für VMWare- und Baremetal-Cluster ist dies die kube-system-UID.

MultiCloudCluster

MultiCloudCluster enthält spezifische Informationen für GKE-Multi-Cloud-Cluster.

Felder
cluster_missing

bool

Nur Ausgabe. Wenn „cluster_missing“ festgelegt ist, bedeutet dies, dass die API(gkemulticloud.googleapis.com)-Ressource für diesen GKE-Multi-Cloud-Cluster nicht mehr vorhanden ist.

Namespace

Namespace stellt einen Namespace in der Flotte dar

Felder
name

string

Der Ressourcenname für den Namespace projects/{project}/locations/{location}/namespaces/{namespace}

uid

string

Nur Ausgabe. Von Google generierte UUID für diese Ressource. Dies ist für alle Namespace-Ressourcen eindeutig. Wenn eine Namespace-Ressource gelöscht und eine andere Ressource mit demselben Namen erstellt wird, erhält sie eine andere UID.

create_time

Timestamp

Nur Ausgabe. Wann der Namespace erstellt wurde.

update_time

Timestamp

Nur Ausgabe. Wann der Namespace zuletzt aktualisiert wurde.

delete_time

Timestamp

Nur Ausgabe. Wann der Namespace gelöscht wurde.

state

NamespaceLifecycleState

Nur Ausgabe. Status der Namespace-Ressource.

scope

string

Erforderlich. Mit dem Namespace verknüpfter Bereich

namespace_labels

map<string, string>

Optional. Cluster-Namespace-Labels auf Namespace-Ebene. Diese Labels werden auf den zugehörigen Namespace der Mitgliedscluster angewendet, die an den übergeordneten Bereich gebunden sind. Labels auf Bereichsebene (namespace_labels in der Flottenbereichsressource) haben Vorrang vor Labels auf Namespace-Ebene, wenn sie einen Schlüssel gemeinsam nutzen. Schlüssel und Werte müssen Kubernetes-konform sein.

labels

map<string, string>

Optional. Labels für diesen Namespace.

NamespaceLifecycleState

NamespaceLifecycleState beschreibt den Status einer Namespace-Ressource.

Felder
code

NamespaceLifecycleState.Code

Nur Ausgabe. Der aktuelle Status der Namespace-Ressource.

Code

Der Code beschreibt den Status einer Namespace-Ressource.

Enums
CODE_UNSPECIFIED Der Code ist nicht festgelegt.
CREATING Der Namespace wird erstellt.
READY Der Namespace ist aktiv.
DELETING Der Namespace wird gelöscht.
UPDATING Der Namespace wird aktualisiert.

OnPremCluster

OnPremCluster enthält spezifische Informationen für GKE On-Prem-Cluster.

Felder
cluster_missing

bool

Nur Ausgabe. Wenn „cluster_missing“ festgelegt ist, bedeutet dies, dass die API(gkeonprem.googleapis.com)-Ressource für diesen GKE On-Prem-Cluster nicht mehr vorhanden ist.

admin_cluster

bool

Nicht veränderbar. Ob der Cluster ein Administratorcluster ist.

cluster_type

OnPremCluster.ClusterType

Nicht veränderbar. Der Typ des lokalen Clusters.

ClusterType

ClusterType beschreibt den Typ des lokalen Clusters.

Enums
CLUSTERTYPE_UNSPECIFIED Der ClusterType ist nicht festgelegt.
BOOTSTRAP Der ClusterType ist Bootstrap-Cluster.
HYBRID Der ClusterType ist ein Bare-Metal-Hybridcluster.
STANDALONE Der ClusterType ist ein eigenständiger Bare-Metal-Cluster.
USER Der ClusterType ist ein Nutzercluster.

OperationMetadata

Stellt die Metadaten des Vorgangs mit langer Ausführungszeit dar.

Felder
create_time

Timestamp

[Nur Ausgabe] Die Zeit, zu der die Vorgang erstellt wurde.

end_time

Timestamp

[Nur Ausgabe] Der Zeitpunkt, zu dem der Vorgang abgeschlossen wurde.

target

string

Nur Ausgabe. Serverdefinierter Ressourcenpfad für das Ziel des Vorgangs.

verb

string

Nur Ausgabe. Name des vom Vorgang ausgeführten Verbs.

status_detail

string

Nur Ausgabe. Lesbarer Status des Vorgangs, falls vorhanden.

cancel_requested

bool

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

Nur Ausgabe. Zum Starten des Vorgangs verwendete API-Version.

RBACRoleBinding

RBACRoleBinding stellt eine rbacrolebinding in der Flotte dar

Felder
name

string

Der Ressourcenname für die rbacrolebinding projects/{project}/locations/{location}/scopes/{scope}/rbacrolebindings/{rbacrolebinding} oder projects/{project}/locations/{location}/memberships/{membership}/rbacrolebindings/{rbacrolebinding}

uid

string

Nur Ausgabe. Von Google generierte UUID für diese Ressource. Dies ist für alle rbacrolebinding-Ressourcen eindeutig. Wenn eine rbacrolebinding-Ressource gelöscht und eine andere Ressource mit demselben Namen erstellt wird, erhält sie eine andere UID.

create_time

Timestamp

Nur Ausgabe. Wann die rbacrolebinding erstellt wurde.

update_time

Timestamp

Nur Ausgabe. Wann die rbacrolebinding zuletzt aktualisiert wurde.

delete_time

Timestamp

Nur Ausgabe. Wann die rbacrolebinding gelöscht wurde.

state

RBACRoleBindingLifecycleState

Nur Ausgabe. Status der rbacrolebinding-Ressource.

role

RBACRoleBinding.Role

Erforderlich. Rolle, die an das Hauptkonto gebunden werden soll

labels

map<string, string>

Optional. Labels für diese RBACRolebinding.

Union-Feld principal. Hauptkonto, das im Cluster autorisiert ist (mindestens eines der beiden ist erforderlich). Wenn Sie eins aktualisieren, wird das andere automatisch aufgehoben. Für principal ist nur einer der folgenden Werte zulässig:
user

string

"user" ist der Name des Nutzers, wie er vom Kubernetes-Cluster angezeigt wird, z. B. „alice“ oder „alice@domain.tld“.

group

string

„group“ ist die Gruppe, wie sie vom Kubernetes-Cluster erkannt wird.

Rolle

„Role“ ist der Typ von Kubernetes-Rollen.

Felder
predefined_role

RBACRoleBinding.Role.PredefinedRoles

predefined_role ist die zu verwendende Kubernetes-Standardrolle

PredefinedRoles

PredefinedRoles ist eine ENUM-Darstellung der Kubernetes-Standardrollen

Enums
UNKNOWN UNKNOWN
ADMIN ADMIN hat EDIT- und RBAC-Berechtigungen
EDIT EDIT kann alle Ressourcen außer RBAC bearbeiten.
VIEW VIEW kann nur Ressourcen lesen
ANTHOS_SUPPORT ANTHOS_SUPPORT gewährt dem Google-Support Lesezugriff auf eine Reihe von Clusterressourcen.

RBACRoleBindingLifecycleState

RBACRoleBindingLifecycleState beschreibt den Status einer RbacRoleBinding-Ressource.

Felder
code

RBACRoleBindingLifecycleState.Code

Nur Ausgabe. Der aktuelle Status der rbacrolebinding-Ressource.

Code

Code beschreibt den Status einer rbacrolebinding-Ressource.

Enums
CODE_UNSPECIFIED Der Code ist nicht festgelegt.
CREATING Die rbacrolebinding wird erstellt.
READY Die rbacrolebinding ist aktiv.
DELETING Die rbacrolebinding wird gelöscht.
UPDATING Die rbacrolebinding wird aktualisiert.

ResourceManifest

ResourceManifest stellt eine einzelne Kubernetes-Ressource dar, die auf den Cluster angewendet werden soll.

Felder
manifest

string

YAML-Manifest der Ressource.

cluster_scoped

bool

Ob die im Manifest angegebene Ressource cluster_scoped ist. Wenn kein Wert festgelegt ist, wird davon ausgegangen, dass das Manifest Namespace-bezogen ist.

Dieses Feld wird für die REST-Zuordnung verwendet, wenn die Ressource in einem Cluster angewendet wird.

ResourceOptions

ResourceOptions stellen Optionen für die Generierung von Kubernetes-Ressourcen dar.

Felder
connect_version

string

Optional. Die Connect-Agent-Version, die für connect_resources verwendet werden soll. Die Standardeinstellung ist die neueste GKE Connect-Version. Die Version muss eine derzeit unterstützte Version sein. Veraltete Versionen werden abgelehnt.

v1beta1_crd

bool

Optional. Verwenden Sie apiextensions/v1beta1 anstelle von apiextensions/v1 für CustomResourceDefinition-Ressourcen. Diese Option sollte für Cluster mit Kubernetes API-Serverversionen < 1.16 festgelegt werden.

k8s_version

string

Optional. Hauptversion des Kubernetes-Clusters. Damit wird lediglich ermittelt, welche Version für die CustomResourceDefinition-Ressourcen (apiextensions/v1beta1 oder apiextensions/v1) verwendet werden soll.

Bereich

„Scope“ stellt einen Bereich in einer Flotte dar.

Felder
name

string

Der Ressourcenname für den Bereich projects/{project}/locations/{location}/scopes/{scope}

uid

string

Nur Ausgabe. Von Google generierte UUID für diese Ressource. Dies ist für alle Bereichsressourcen einmalig. Wenn eine Bereichsressource gelöscht und eine andere Ressource mit demselben Namen erstellt wird, erhält sie eine andere UID.

create_time

Timestamp

Nur Ausgabe. Zeitpunkt der Erstellung des Bereichs.

update_time

Timestamp

Nur Ausgabe. Der Zeitpunkt der letzten Aktualisierung des Bereichs.

delete_time

Timestamp

Nur Ausgabe. Zeitpunkt des Löschens des Bereichs.

state

ScopeLifecycleState

Nur Ausgabe. Status der Bereichsressource.

namespace_labels

map<string, string>

Optional. Cluster-Namespace-Labels auf Bereichsebene. Bei den Mitgliedsclustern, die an den Bereich gebunden sind, werden diese Labels auf jeden Namespace unter dem Bereich angewendet. Labels auf Bereichsebene haben Vorrang vor Labels auf Namespace-Ebene (namespace_labels in der Flotten-Namespace-Ressource), wenn sie einen Schlüssel gemeinsam nutzen. Schlüssel und Werte müssen Kubernetes-konform sein.

labels

map<string, string>

Optional. Labels für diesen Bereich.

ScopeFeatureSpec

ScopeFeatureSpec enthält Featurespezifikationen für einen Flottenbereich.

Felder

Union-Feld feature_spec.

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

clusterupgrade

ScopeSpec

Spezifikation für das ClusterUpgrade-Feature auf Bereichsebene

ScopeFeatureState

ScopeFeatureState enthält Informationen zum bereichsweiten Funktionsstatus.

Felder
state

FeatureState

Nur Ausgabe. Der „Ausführungsstatus“ des Features in diesem Bereich.

Union-Feld feature_state.

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

clusterupgrade

ScopeState

Status für das ClusterUpgrade-Feature auf Bereichsebene

ScopeLifecycleState

ScopeLifecycleState beschreibt den Status einer Bereichsressource.

Felder
code

ScopeLifecycleState.Code

Nur Ausgabe. Der aktuelle Status der Bereichsressource.

Code

Code beschreibt den Status einer Bereichsressource.

Enums
CODE_UNSPECIFIED Der Code ist nicht festgelegt.
CREATING Der Bereich wird erstellt.
READY Der Bereich ist aktiv.
DELETING Der Bereich wird gelöscht.
UPDATING Der Bereich wird aktualisiert.

SecurityPostureConfig

SecurityPostureConfig definiert die Flags, die zum Aktivieren/Deaktivieren von Features für die Security Posture API erforderlich sind.

Felder
mode

SecurityPostureConfig.Mode

Legt den Modus fest, der für die Funktionen des Sicherheitsstatus verwendet werden soll.

vulnerability_mode

SecurityPostureConfig.VulnerabilityMode

Legt den Modus fest, der für das Scannen auf Sicherheitslücken verwendet werden soll.

Modus

Der Modus definiert den Aktivierungsmodus für Features des GKE-Sicherheitsstatus.

Enums
MODE_UNSPECIFIED Standardwert nicht angegeben.
DISABLED Deaktiviert die Sicherheitsstatus-Features im Cluster.
BASIC Wendet Funktionen des Sicherheitsstatus auf den Cluster an.

VulnerabilityMode

Der VulnerabilityMode definiert den Aktivierungsmodus für das Scannen auf Sicherheitslücken.

Enums
VULNERABILITY_MODE_UNSPECIFIED Standardwert nicht angegeben.
VULNERABILITY_DISABLED Deaktiviert das Scannen auf Sicherheitslücken im Cluster.
VULNERABILITY_BASIC Wendet ein grundlegendes Scannen auf Sicherheitslücken auf dem Cluster an.
VULNERABILITY_ENTERPRISE Wendet die Sicherheitslücke des Sicherheitsstatus auf Funktionen der Cluster-Enterprise-Ebene an.

TypeMeta

TypeMeta sind die Typinformationen, die für das Unmarshalling von Kubernetes-Ressourcen im Manifest erforderlich sind.

Felder
kind

string

Art der Ressource (z. B. Bereitstellung).

api_version

string

APIVersion der Ressource (z.B. v1).

UpdateFeatureRequest

Anfragenachricht für die Methode GkeHub.UpdateFeature.

Felder
name

string

Erforderlich. Der Name der Feature-Ressource im Format projects/*/locations/*/features/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.features.update
update_mask

FieldMask

Maske der zu aktualisierenden Felder.

resource

Feature

Nur in "update_mask" angegebene Felder werden aktualisiert. Wenn Sie ein Feld in „update_mask“ angeben, aber hier keinen Wert angeben, wird dieses Feld gelöscht. Wenn Sie ein Zuordnungsfeld aktualisieren, setzen Sie den Wert eines Schlüssels auf null oder einen leeren String, um den Schlüssel aus der Zuordnung zu löschen. Es ist nicht möglich, den Wert eines Schlüssels auf einen leeren String zu aktualisieren. Wenn Sie "update_mask" als speziellen Pfad "*" angeben, werden alle vom Nutzer änderbaren Felder vollständig ersetzt, sodass sie mit resource übereinstimmen.

request_id

string

Eine Anfrage-ID zur Identifizierung von Anfragen. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignoriert, falls sie bereits abgeschlossen wurde, falls Sie Ihre Anfrage wiederholen müssen. Der Server gewährleistet dies für mindestens 60 Minuten nach der ersten Anfrage.

Stellen Sie sich beispielsweise eine Situation vor, in der Sie eine erste Anfrage stellen und diese das Zeitlimit überschreitet. Wenn Sie die Anfrage mit derselben Anfrage-ID noch einmal senden, kann der Server prüfen, ob der ursprüngliche Vorgang mit derselben Anfrage-ID empfangen wurde. Ist dies der Fall, wird die zweite Anfrage ignoriert. Dadurch wird verhindert, dass Clients versehentlich doppelte Zusicherungen erstellen.

Die Anfrage-ID muss eine gültige UUID sein, mit der Ausnahme, dass null UUID nicht unterstützt wird (00000000-0000-0000-0000-000000000000).

UpdateFleetRequest

Anfragenachricht für die Methode GkeHub.UpdateFleet.

Felder
fleet

Fleet

Erforderlich. Die zu aktualisierende Flotte.

Das Feld name des Fleet-Objekts gibt an, welche Flotte aktualisiert wird.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource fleet erforderlich:

  • gkehub.fleet.update
update_mask

FieldMask

Erforderlich. Die zu aktualisierenden Felder.

UpdateMembershipBindingRequest

Anfrage zum Aktualisieren eines MembershipBinding

Felder
membership_binding

MembershipBinding

Erforderlich. Das Objekt "MembershipBinding" mit aktualisierten Feldern.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource membershipBinding erforderlich:

  • gkehub.membershipbindings.update
update_mask

FieldMask

Erforderlich. Die zu aktualisierenden Felder.

UpdateMembershipRBACRoleBindingRequest

Anfrage zur Aktualisierung einer Mitgliedschaft-rbacrolebinding.

Felder
rbacrolebinding

RBACRoleBinding

Erforderlich. Eine rbacrolebinding mit aktualisierten Feldern. Das Feld "name" in dieser rbacrolebinding wird verwendet, um die zu aktualisierende Ressource zu identifizieren.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource rbacrolebinding erforderlich:

  • gkehub.rbacrolebindings.update
update_mask

FieldMask

Erforderlich. Die zu aktualisierenden Felder.

UpdateMembershipRequest

Anfragenachricht für die Methode GkeHub.UpdateMembership.

Felder
name

string

Erforderlich. Der Name der Mitgliedschaftsressource im Format projects/*/locations/*/memberships/*.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • gkehub.memberships.update
update_mask

FieldMask

Erforderlich. Maske der zu aktualisierenden Felder.

resource

Membership

Erforderlich. Nur in „update_mask“ angegebene Felder werden aktualisiert. Wenn Sie ein Feld in „update_mask“ angeben, aber hier keinen Wert angeben, wird dieses Feld gelöscht. Wenn Sie ein Zuordnungsfeld aktualisieren, setzen Sie den Wert eines Schlüssels auf null oder einen leeren String, um den Schlüssel aus der Zuordnung zu löschen. Es ist nicht möglich, den Wert eines Schlüssels auf einen leeren String zu aktualisieren. Wenn Sie „update_mask“ als speziellen Pfad „*“ angeben, werden alle vom Nutzer änderbaren Felder vollständig ersetzt, sodass sie mit resource übereinstimmen.

request_id

string

Optional. Eine Anfrage-ID zur Identifizierung von Anfragen. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignoriert, falls sie bereits abgeschlossen wurde, falls Sie Ihre Anfrage wiederholen müssen. Der Server gewährleistet dies für mindestens 60 Minuten nach der ersten Anfrage.

Stellen Sie sich beispielsweise eine Situation vor, in der Sie eine erste Anfrage stellen und diese das Zeitlimit überschreitet. Wenn Sie die Anfrage mit derselben Anfrage-ID noch einmal senden, kann der Server prüfen, ob der ursprüngliche Vorgang mit derselben Anfrage-ID empfangen wurde. Ist dies der Fall, wird die zweite Anfrage ignoriert. Dadurch wird verhindert, dass Clients versehentlich doppelte Zusicherungen erstellen.

Die Anfrage-ID muss eine gültige UUID sein, mit der Ausnahme, dass null UUID nicht unterstützt wird (00000000-0000-0000-0000-000000000000).

UpdateScopeNamespaceRequest

Anfrage zum Aktualisieren eines Flotten-Namespace.

Felder
scope_namespace

Namespace

Erforderlich. Ein Namespace mit aktualisierten Feldern. Das Feld "Name" in diesem Namespace dient zur Identifizierung der zu aktualisierenden Ressource. Angesichts des Präfixes "aktualisiert" wird "go/proto-best-practices-checkers#keyword_Conflict" ausgeführt

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource scopeNamespace erforderlich:

  • gkehub.namespace.update
update_mask

FieldMask

Erforderlich. Die zu aktualisierenden Felder.

UpdateScopeRBACRoleBindingRequest

Anfrage zur Aktualisierung einer Bereichs-rbacrolebinding.

Felder
rbacrolebinding

RBACRoleBinding

Erforderlich. Eine rbacrolebinding mit aktualisierten Feldern. Das Feld "name" in dieser rbacrolebinding wird verwendet, um die zu aktualisierende Ressource zu identifizieren.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource rbacrolebinding erforderlich:

  • gkehub.rbacrolebindings.update
update_mask

FieldMask

Erforderlich. Die zu aktualisierenden Felder.

UpdateScopeRequest

Anfrage zum Aktualisieren eines Bereichs.

Felder
scope

Scope

Erforderlich. Ein Bereich mit aktualisierten Feldern. Das Feld "Name" in diesem Namespace dient zur Identifizierung der zu aktualisierenden Ressource.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource scope erforderlich:

  • gkehub.scopes.update
update_mask

FieldMask

Erforderlich. Die zu aktualisierenden Felder.

ValidateCreateMembershipRequest

Anfragenachricht für die Methode GkeHub.ValidateCreateMembership.

Felder
parent

string

Erforderlich. Das übergeordnete Element (Projekt und Standort), in dem die Mitgliedschaften erstellt werden. Wird im Format projects/*/locations/* angegeben.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • gkehub.memberships.create
membership_id

string

Erforderlich. Vom Client ausgewählte Mitgliedschafts-ID.

membership

Membership

Erforderlich. Zu erstellende Mitgliedschaftsressource.

ValidateCreateMembershipResponse

Antwortnachricht für die Methode GkeHub.ValidateCreateMembership.

Felder
validation_results[]

ValidationResult

Bettet alle Validierungsergebnisse ein.

ValidationResult

ValidationResults sind Ergebnisse, die von jeder Validierung festgelegt werden, die während ValidateCreateMembership ausgeführt wird.

Felder
validator

ValidationResult.ValidatorType

Validatortyp, mit dem die Mitgliedschaft validiert werden soll.

success

bool

Gibt an, ob die Validierung bestanden wurde oder nicht.

result

string

Zusätzliche Informationen zur Validierung.

ValidatorType

Gibt verschiedene Validierungstypen an.

Enums
VALIDATOR_TYPE_UNSPECIFIED UNSPECIFIED-Validator.
MEMBERSHIP_ID Mit der Validierung MEMBERSHIP_ID wird überprüft, ob die Mitgliedschafts-ID noch verfügbar ist.
CROSS_PROJECT_PERMISSION Mit der Validierung CROSS_PROJECT_PERMISSION wird geprüft, ob die projektübergreifende Rollenbindung für den Dienst-Agent vorhanden ist.