Package google.cloud.gkehub.v1alpha

Index

GKE Hub

Le service GKE Hub gère l'enregistrement de nombreux clusters Kubernetes sur Google Cloud, ainsi que la gestion des fonctionnalités multicluster sur ces clusters.

Le service GKE Hub fonctionne sur les ressources suivantes :

GKE Hub est actuellement disponible dans la région mondiale et dans toutes les régions disponibles sur https://cloud.google.com/compute/docs/regions-zones. La fonctionnalité n'est disponible que dans la région mondiale, tandis que l'appartenance est disponible dans la région mondiale et dans toutes les régions.

La gestion des appartenances peut s'avérer complexe : il est recommandé d'utiliser l'une des bibliothèques clientes ou l'un des outils fournis par Google lorsque vous utilisez des ressources Membership dans la mesure du possible.

CreateFeature

rpc CreateFeature(CreateFeatureRequest) returns (Operation)

Ajoute une nouvelle caractéristique.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

CreateFleet

rpc CreateFleet(CreateFleetRequest) returns (Operation)

Crée un parc.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

CreateMembership

rpc CreateMembership(CreateMembershipRequest) returns (Operation)

Crée une appartenance.

Cette fonctionnalité n'est actuellement disponible que pour les clusters GKE sur Google Cloud. Pour enregistrer d'autres clusters, suivez les instructions disponibles sur la page https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/registering-a-cluster.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

CreateMembershipBinding

rpc CreateMembershipBinding(CreateMembershipBindingRequest) returns (Operation)

Crée un ressource MembershipBinding.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

CreateMembershipRBACRoleBinding

rpc CreateMembershipRBACRoleBinding(CreateMembershipRBACRoleBindingRequest) returns (Operation)

Crée une ressource MembershipRBACRoleBinding.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

CreateScope

rpc CreateScope(CreateScopeRequest) returns (Operation)

Crée une ressource Scope.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

CreateScopeNamespace

rpc CreateScopeNamespace(CreateScopeNamespaceRequest) returns (Operation)

Crée un espace de noms de parc.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

CreateScopeRBACRoleBinding

rpc CreateScopeRBACRoleBinding(CreateScopeRBACRoleBindingRequest) returns (Operation)

Crée une ressource ScopeRBACRoleBinding.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

DeleteFeature

rpc DeleteFeature(DeleteFeatureRequest) returns (Operation)

Supprime une caractéristique.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

DeleteFleet

rpc DeleteFleet(DeleteFleetRequest) returns (Operation)

Supprime un parc. Il ne doit y avoir aucune appartenance dans le parc.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

DeleteMembership

rpc DeleteMembership(DeleteMembershipRequest) returns (Operation)

Supprime une appartenance.

Cette fonctionnalité n'est actuellement disponible que pour les clusters GKE sur Google Cloud. Pour annuler l'enregistrement d'autres clusters, suivez les instructions disponibles sur la page https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/unregistering-a-cluster.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

DeleteMembershipBinding

rpc DeleteMembershipBinding(DeleteMembershipBindingRequest) returns (Operation)

Supprime une ressource MembershipBinding.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

DeleteMembershipRBACRoleBinding

rpc DeleteMembershipRBACRoleBinding(DeleteMembershipRBACRoleBindingRequest) returns (Operation)

Supprime une ressource MembershipRBACRoleBinding.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

DeleteScope

rpc DeleteScope(DeleteScopeRequest) returns (Operation)

Supprime une ressource Scope.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

DeleteScopeNamespace

rpc DeleteScopeNamespace(DeleteScopeNamespaceRequest) returns (Operation)

Supprime un espace de noms de parc.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

DeleteScopeRBACRoleBinding

rpc DeleteScopeRBACRoleBinding(DeleteScopeRBACRoleBindingRequest) returns (Operation)

Supprime une ressource ScopeRBACRoleBinding.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

GenerateConnectManifest

rpc GenerateConnectManifest(GenerateConnectManifestRequest) returns (GenerateConnectManifestResponse)

Génère le fichier manifeste pour le déploiement de l'agent GKE Connect.

Cette méthode est utilisée en interne par les bibliothèques fournies par Google. La plupart des clients n'ont normalement pas besoin d'appeler cette méthode directement.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

GenerateMembershipRBACRoleBindingYAML

rpc GenerateMembershipRBACRoleBindingYAML(GenerateMembershipRBACRoleBindingYAMLRequest) returns (GenerateMembershipRBACRoleBindingYAMLResponse)

Génère un fichier YAML des stratégies RBAC pour la ressource RoleBinding spécifiée et les ressources d'emprunt d'identité associées.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

GetFeature

rpc GetFeature(GetFeatureRequest) returns (Feature)

Récupère les informations d'une seule caractéristique.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

GetFleet

rpc GetFleet(GetFleetRequest) returns (Fleet)

Renvoie les détails d'un parc.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

GetMembership

rpc GetMembership(GetMembershipRequest) returns (Membership)

Récupère les détails d'une appartenance.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

GetMembershipBinding

rpc GetMembershipBinding(GetMembershipBindingRequest) returns (MembershipBinding)

Renvoie les détails d'une ressource MembershipBinding.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

GetMembershipRBACRoleBinding

rpc GetMembershipRBACRoleBinding(GetMembershipRBACRoleBindingRequest) returns (RBACRoleBinding)

Renvoie les détails d'une appartenance RBACRoleBinding.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

GetScope

rpc GetScope(GetScopeRequest) returns (Scope)

Renvoie les détails d'un champ d'application.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

GetScopeNamespace

rpc GetScopeNamespace(GetScopeNamespaceRequest) returns (Namespace)

Renvoie les détails d'un espace de noms de parc.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

GetScopeRBACRoleBinding

rpc GetScopeRBACRoleBinding(GetScopeRBACRoleBindingRequest) returns (RBACRoleBinding)

Renvoie les détails d'un champ d'application RBACRoleBinding.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ListAdminClusterMemberships

rpc ListAdminClusterMemberships(ListAdminClusterMembershipsRequest) returns (ListAdminClusterMembershipsResponse)

Répertorie les appartenances des clusters d'administrateur d'un projet et d'un emplacement donnés.

Cette méthode n'est utilisée qu'en interne.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ListFeatures

rpc ListFeatures(ListFeaturesRequest) returns (ListFeaturesResponse)

Répertorie les caractéristiques d'un projet et d'un emplacement donnés.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ListFleets

rpc ListFleets(ListFleetsRequest) returns (ListFleetsResponse)

Renvoie tous les parcs d'une organisation ou d'un projet auxquels l'appelant a accès.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ListMembershipBindings

rpc ListMembershipBindings(ListMembershipBindingsRequest) returns (ListMembershipBindingsResponse)

Répertorie les ressources MembershipBindings.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ListMembershipRBACRoleBindings

rpc ListMembershipRBACRoleBindings(ListMembershipRBACRoleBindingsRequest) returns (ListMembershipRBACRoleBindingsResponse)

Répertorie toutes les appartenances RBACRoleBinding.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ListMemberships

rpc ListMemberships(ListMembershipsRequest) returns (ListMembershipsResponse)

Répertorie les appartenances d'un projet et d'un emplacement donnés.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ListScopeNamespaces

rpc ListScopeNamespaces(ListScopeNamespacesRequest) returns (ListScopeNamespacesResponse)

Répertorie les espaces de noms du parc.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ListScopeRBACRoleBindings

rpc ListScopeRBACRoleBindings(ListScopeRBACRoleBindingsRequest) returns (ListScopeRBACRoleBindingsResponse)

Répertorie toutes les ressources ScopeRBACRoleBindings.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ListScopes

rpc ListScopes(ListScopesRequest) returns (ListScopesResponse)

Répertorie les ressources Scope.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

UpdateFeature

rpc UpdateFeature(UpdateFeatureRequest) returns (Operation)

Met à jour une caractéristique existante.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

UpdateFleet

rpc UpdateFleet(UpdateFleetRequest) returns (Operation)

Met à jour un parc.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

UpdateMembership

rpc UpdateMembership(UpdateMembershipRequest) returns (Operation)

Met à jour une appartenance existante.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

UpdateMembershipBinding

rpc UpdateMembershipBinding(UpdateMembershipBindingRequest) returns (Operation)

Met à jour une ressource MembershipBinding.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

UpdateMembershipRBACRoleBinding

rpc UpdateMembershipRBACRoleBinding(UpdateMembershipRBACRoleBindingRequest) returns (Operation)

Met à jour une ressource MembershipRBACRoleBinding.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

UpdateScope

rpc UpdateScope(UpdateScopeRequest) returns (Operation)

Met à jour une ressource Scope.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

UpdateScopeNamespace

rpc UpdateScopeNamespace(UpdateScopeNamespaceRequest) returns (Operation)

Met à jour un espace de noms de parc.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

UpdateScopeRBACRoleBinding

rpc UpdateScopeRBACRoleBinding(UpdateScopeRBACRoleBindingRequest) returns (Operation)

Met à jour une ressource ScopeRBACRoleBinding.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ValidateCreateMembership

rpc ValidateCreateMembership(ValidateCreateMembershipRequest) returns (ValidateCreateMembershipResponse)

ValidateCreateMembership est une vérification préliminaire de CreateMembership. Il vérifie les points suivants : 1. L'appelant dispose de l'autorisation gkehub.memberships.create requise. 2. La ressource membership_id est toujours disponible.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ApplianceCluster

ApplianceCluster contient des informations spécifiques aux clusters GDC Edge Appliance.

Champs

Autorité

L'autorité code la manière dont Google reconnaît les identités de ce membre. Pour en savoir plus, consultez la documentation sur Workload Identity : https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity.

Champs
issuer

string

Facultatif. URI d'émetteur de jetons Web JSON (JWT). issuer doit commencer par https:// et être une URL valide comportant moins de 2 000 caractères. Il doit utiliser location au lieu de zone pour les clusters GKE.

Si ce champ est défini, Google autorise les jetons OIDC valides de cet émetteur à s'authentifier dans le pool d'identités de charge de travail. La découverte OIDC sera effectuée sur cet URI pour valider les jetons de l'émetteur.

Le fait de supprimer issuer désactive Workload Identity. issuer ne peut pas être modifié directement ; vous devez effacer son contenu (et désactiver Workload Identity) avant d'utiliser un nouvel émetteur (et de réactiver Workload Identity).

workload_identity_pool

string

Uniquement en sortie. Nom du pool d'identités de charge de travail dans lequel issuer sera reconnu.

Un seul pool d'identités de charge de travail est partagé entre toutes les appartenances appartenant à ce Hub. Pour un hub hébergé dans {PROJECT_ID}, le format du pool de charges de travail est {PROJECT_ID}.hub.id.goog, bien que cela soit susceptible d'être modifié dans les versions plus récentes de cette API.

identity_provider

string

Uniquement en sortie. Un fournisseur d'identité qui reflète la valeur issuer dans le pool d'identités de charge de travail.

oidc_jwks

bytes

Facultatif. Clés de validation OIDC de cette appartenance au format JWKS (RFC 7517).

Lorsque ce champ est défini, la découverte OIDC n'est PAS effectuée sur issuer, mais les jetons OIDC sont validés à l'aide de ce champ.

BinaryAuthorizationConfig

BinaryAuthorizationConfig définit la configuration au niveau du parc de la fonctionnalité d'autorisation binaire.

Champs
evaluation_mode

BinaryAuthorizationConfig.EvaluationMode

Facultatif. Mode d'évaluation de la règle BinAuthz.

policy_bindings[]

BinaryAuthorizationConfig.PolicyBinding

Facultatif. Règles BinAuthz qui s'appliquent à ce cluster.

EvaluationMode

Mode de fonctionnement de l'autorisation binaire.

Enums
EVALUATION_MODE_UNSPECIFIED Valeur par défaut
DISABLED Désactiver BinaryAuthorization
POLICY_BINDINGS Utilisez l'autorisation binaire avec les stratégies spécifiées dans policy_bindings.

PolicyBinding

Stratégie BinAuthz qui s'applique à ce cluster.

Champs
name

string

Nom de ressource relatif de la règle de plate-forme BinAuthz à auditer. Les règles de plate-forme GKE ont le format suivant : projects/{project_number}/platforms/gke/policies/{policy_id}.

CommonFeatureSpec

CommonFeatureSpec contient des informations de configuration à l'échelle du hub.

Champs

Champ d'union feature_spec.

feature_spec ne peut être qu'un des éléments suivants :

multiclusteringress

FeatureSpec

Spécification propre à l'entrée multicluster.

cloudauditlogging

FeatureSpec

Spécification propre à Cloud Audit Logging.

workloadcertificate

FeatureSpec

Spécification du certificat de charge de travail.

appdevexperience

AppDevExperienceFeatureSpec

Spécification propre à Appdevexperience.

anthosobservability

AnthosObservabilityFeatureSpec

Spécification d'Anthos Observability

fleetobservability

FeatureSpec

Spécification de la fonctionnalité FleetObservability.

namespaceactuation

FeatureSpec

Spécification de la fonctionnalité d'activation d'espace de noms

clusterupgrade

FleetSpec

Spécification de la fonctionnalité ClusterUpgrade (basée sur un parc).

dataplanev2

FeatureSpec

Spécification de la fonctionnalité DataplaneV2.

CommonFeatureState

CommonFeatureState contient des informations sur l'état des fonctionnalités à l'échelle du hub.

Champs
state

FeatureState

Uniquement en sortie. "État d'exécution" de la fonctionnalité dans ce Hub.

Champ d'union feature_state.

feature_state ne peut être qu'un des éléments suivants :

servicemesh

FeatureState

État spécifique au maillage de services.

appdevexperience

AppDevExperienceFeatureState

État spécifique de l'environnement de développement d'applications.

fleetobservability

FeatureState

État de la fonctionnalité FleetObservability.

namespaceactuation

FeatureState

État de la fonctionnalité d'activation de l'espace de noms.

clusterupgrade

FleetState

État au niveau du parc ClusterUpgrade.

CommonFleetDefaultMemberConfigSpec

CommonFleetDefaultMemberConfigSpec contient les informations de configuration par défaut des appartenances d'un parc

Champs

Champ d'union feature_spec.

feature_spec ne peut être qu'un des éléments suivants :

mesh

MembershipSpec

Spécification propre à Anthos Service Mesh

configmanagement

MembershipSpec

Spécification propre à Config Management

identityservice

MembershipSpec

Spécification propre à Identity Service

policycontroller

MembershipSpec

Spécification de Policy Controller.

ConnectAgentResource

ConnectAgentResource représente un fichier manifeste de ressource Kubernetes pour le déploiement de Connect Agent.

Champs
type

TypeMeta

Type Kubernetes de la ressource.

manifest

string

Fichier manifeste YAML de la ressource.

CreateFeatureRequest

Message de requête pour la méthode GkeHub.CreateFeature.

Champs
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel la caractéristique sera créée. Spécifié au format projects/*/locations/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.features.create
feature_id

string

ID de la caractéristique à créer.

resource

Feature

Ressource Feature à créer.

request_id

string

ID de requête permettant d'identifier les requêtes. Spécifiez un ID de requête unique pour que le serveur sache qu'il doit ignorer la requête si vous devez la retenter alors qu'elle est déjà terminée. Le serveur garantit que pendant au moins 60 minutes après la première requête.

Par exemple, imaginons que vous effectuez une requête initiale et que celle-ci expire. Si vous effectuez à nouveau la requête avec le même ID de requête, le serveur peut vérifier si une opération d'origine ayant le même ID de requête a été reçue et, le cas échéant, ignorer la deuxième requête. Ainsi, les clients ne peuvent pas créer accidentellement des engagements en double.

L'ID de requête doit être un UUID valide, à ceci près qu'un UUID égal à zéro (00000000-0000-0000-0000-000000000000) n'est pas accepté.

CreateFleetRequest

Message de requête pour la méthode GkeHub.CreateFleet.

Champs
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel le parc sera créé. Spécifié au format projects/*/locations/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.fleet.create
fleet

Fleet

Obligatoire. Parc à créer.

CreateMembershipBindingRequest

Requête de création d'une ressource MembershipBinding.

Champs
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel la ressource MembershipBinding sera créée. Spécifié au format projects/*/locations/*/memberships/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.membershipbindings.create
membership_binding

MembershipBinding

Obligatoire. Ressource MembershipBinding à créer.

membership_binding_id

string

Obligatoire. ID à utiliser pour la ressource MembershipBinding.

CreateMembershipRBACRoleBindingRequest

Requête de création d'une ressource RBACRoleBindingRequest.

Champs
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel la ressource RBACRoleBindingRequest sera créée. Spécifié au format projects/*/locations/*/memberships/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.rbacrolebindings.create
rbacrolebinding_id

string

Obligatoire. ID choisi par le client pour la ressource RBACRoleBinding. rbacrolebinding_id doit être un libellé DNS valide conforme à la norme RFC 1123 :

  1. 63 caractères au maximum
  2. Doit être composé de caractères alphanumériques minuscules ou de -.
  3. Doit commencer et se terminer par un caractère alphanumérique.

Il peut être exprimé sous la forme de l'expression régulière [a-z0-9]([-a-z0-9]*[a-z0-9])?, d'une longueur maximale de 63 caractères.

rbacrolebinding

RBACRoleBinding

Obligatoire. Ressource RBACRoleBinding à créer.

CreateMembershipRequest

Message de requête pour la méthode GkeHub.CreateMembership.

Champs
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel les appartenances seront créées. Spécifié au format projects/*/locations/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.memberships.create
membership_id

string

Obligatoire. ID choisi par le client pour l'appartenance. membership_id doit être un libellé DNS valide conforme à la norme RFC 1123 :

  1. 63 caractères au maximum
  2. Doit être composé de caractères alphanumériques minuscules ou de -.
  3. Doit commencer et se terminer par un caractère alphanumérique.

Il peut être exprimé sous la forme de l'expression régulière [a-z0-9]([-a-z0-9]*[a-z0-9])?, d'une longueur maximale de 63 caractères.

resource

Membership

Obligatoire. Appartenance à créer.

request_id

string

Facultatif. ID de requête permettant d'identifier les requêtes. Spécifiez un ID de requête unique pour que le serveur sache qu'il doit ignorer la requête si vous devez la retenter alors qu'elle est déjà terminée. Le serveur garantit que pendant au moins 60 minutes après la première requête.

Par exemple, imaginons que vous effectuez une requête initiale et que celle-ci expire. Si vous effectuez à nouveau la requête avec le même ID de requête, le serveur peut vérifier si une opération d'origine ayant le même ID de requête a été reçue et, le cas échéant, ignorer la deuxième requête. Ainsi, les clients ne peuvent pas créer accidentellement des engagements en double.

L'ID de requête doit être un UUID valide, à ceci près qu'un UUID égal à zéro (00000000-0000-0000-0000-000000000000) n'est pas accepté.

CreateScopeNamespaceRequest

Requête de création d'un espace de noms de parc.

Champs
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel l'espace de noms sera créé. Spécifié au format projects/*/locations/*/scopes/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.namespaces.create
scope_namespace_id

string

Obligatoire. ID choisi par le client pour l'espace de noms. namespace_id doit être un libellé DNS valide conforme à la norme RFC 1123 :

  1. 63 caractères au maximum
  2. Doit être composé de caractères alphanumériques minuscules ou de -.
  3. Doit commencer et se terminer par un caractère alphanumérique.

Il peut être exprimé sous la forme de l'expression régulière [a-z0-9]([-a-z0-9]*[a-z0-9])?, d'une longueur maximale de 63 caractères.

scope_namespace

Namespace

Obligatoire. Espace de noms du parc à créer.

CreateScopeRBACRoleBindingRequest

Requête de création d'une ressource RBACRoleBindingRequest.

Champs
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel la ressource RBACRoleBindingRequest sera créée. Spécifié au format projects/*/locations/*/scopes/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.rbacrolebindings.create
rbacrolebinding_id

string

Obligatoire. ID choisi par le client pour la ressource RBACRoleBinding. rbacrolebinding_id doit être un libellé DNS valide conforme à la norme RFC 1123 :

  1. 63 caractères au maximum
  2. Doit être composé de caractères alphanumériques minuscules ou de -.
  3. Doit commencer et se terminer par un caractère alphanumérique.

Il peut être exprimé sous la forme de l'expression régulière [a-z0-9]([-a-z0-9]*[a-z0-9])?, d'une longueur maximale de 63 caractères.

rbacrolebinding

RBACRoleBinding

Obligatoire. Ressource RBACRoleBinding à créer.

CreateScopeRequest

Requête de création d'un champ d'application.

Champs
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel le champ d'application sera créé. Spécifié au format projects/*/locations/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.scopes.create
scope_id

string

Obligatoire. ID choisi par le client pour le champ d'application. scope_id doit être une valeur

scope

Scope

Obligatoire. Champ d'application à créer.

DefaultClusterConfig

DefaultClusterConfig décrit les configurations de cluster par défaut à appliquer à tous les clusters nés dans le parc.

Champs
security_posture_config

SecurityPostureConfig

Activer/Désactiver les fonctionnalités de stratégie de sécurité pour le cluster.

binary_authorization_config

BinaryAuthorizationConfig

Facultatif. Activer/Désactiver les fonctionnalités d'autorisation binaire pour le cluster.

DeleteFeatureRequest

Message de requête pour la méthode GkeHub.DeleteFeature.

Champs
name

string

Obligatoire. Nom de la ressource Feature au format projects/*/locations/*/features/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.features.delete
force

bool

Si la valeur est définie sur "true", la suppression ignore toutes les ressources en attente pour cette ressource Feature (c'est-à-dire que FeatureState.has_resources est défini sur "true"). Ces ressources ne seront PAS nettoyées ou modifiées d'une manière ou d'une autre.

request_id

string

Facultatif. ID de requête permettant d'identifier les requêtes. Spécifiez un ID de requête unique pour que le serveur sache qu'il doit ignorer la requête si vous devez la retenter alors qu'elle est déjà terminée. Le serveur garantit que pendant au moins 60 minutes après la première requête.

Par exemple, imaginons que vous effectuez une requête initiale et que celle-ci expire. Si vous effectuez à nouveau la requête avec le même ID de requête, le serveur peut vérifier si une opération d'origine ayant le même ID de requête a été reçue et, le cas échéant, ignorer la deuxième requête. Ainsi, les clients ne peuvent pas créer accidentellement des engagements en double.

L'ID de requête doit être un UUID valide, à ceci près qu'un UUID égal à zéro (00000000-0000-0000-0000-000000000000) n'est pas accepté.

DeleteFleetRequest

Message de requête pour la méthode GkeHub.DeleteFleet.

Champs
name

string

Obligatoire. Nom de la ressource Fleet au format projects/*/locations/*/fleets/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.fleet.delete

DeleteMembershipBindingRequest

Requête de suppression d'une ressource Binding.

Champs
name

string

Obligatoire. Nom de la ressource MembershipBinding au format projects/*/locations/*/memberships/*/bindings/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.membershipbindings.get

DeleteMembershipRBACRoleBindingRequest

Requête de suppression d'une ressource MembershipRBACRoleBindingRequest.

Champs
name

string

Obligatoire. Nom de la ressource RBACRoleBinding au format projects/*/locations/*/memberships/*/rbacrolebindings/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.rbacrolebindings.delete

DeleteMembershipRequest

Message de requête pour la méthode GkeHub.DeleteMembership.

Champs
name

string

Obligatoire. Nom de la ressource Membership au format projects/*/locations/*/memberships/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.memberships.delete
request_id

string

Facultatif. ID de requête permettant d'identifier les requêtes. Spécifiez un ID de requête unique pour que le serveur sache qu'il doit ignorer la requête si vous devez la retenter alors qu'elle est déjà terminée. Le serveur garantit que pendant au moins 60 minutes après la première requête.

Par exemple, imaginons que vous effectuez une requête initiale et que celle-ci expire. Si vous effectuez à nouveau la requête avec le même ID de requête, le serveur peut vérifier si une opération d'origine ayant le même ID de requête a été reçue et, le cas échéant, ignorer la deuxième requête. Ainsi, les clients ne peuvent pas créer accidentellement des engagements en double.

L'ID de requête doit être un UUID valide, à ceci près qu'un UUID égal à zéro (00000000-0000-0000-0000-000000000000) n'est pas accepté.

force

bool

Facultatif. Si la valeur est définie sur "true", toute sous-ressource de cette ressource Membership sera également supprimée. Sinon, la requête ne fonctionnera que si la ressource Membership n'a pas de sous-ressource.

DeleteScopeNamespaceRequest

Requête de suppression d'un espace de noms de parc.

Champs
name

string

Obligatoire. Nom de la ressource d'espace de noms au format projects/*/locations/*/scopes/*/namespaces/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.namespaces.delete

DeleteScopeRBACRoleBindingRequest

Requête de suppression d'une ressource ScopeRBACRoleBindingRequest.

Champs
name

string

Obligatoire. Nom de la ressource RBACRoleBinding au format projects/*/locations/*/scopes/*/rbacrolebindings/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.rbacrolebindings.delete

DeleteScopeRequest

Requête de suppression d'une ressource Scope.

Champs
name

string

Obligatoire. Nom de la ressource Scope au format projects/*/locations/*/scopes/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.scopes.delete

EdgeCluster

EdgeCluster contient des informations spécifiques aux clusters périphériques Google.

Champs

Sélection

La ressource Feature représente les paramètres et l'état d'une fonctionnalité Hub.

Champs
name

string

Uniquement en sortie. Nom complet et unique de cette ressource Feature au format projects/*/locations/*/features/*.

labels

map<string, string>

Libellés de cette ressource Feature.

resource_state

FeatureResourceState

Uniquement en sortie. État de la ressource Feature elle-même.

spec

CommonFeatureSpec

Facultatif. Configuration de la ressource Feature à l'échelle du hub. Si cette ressource Feature n'est pas compatible avec la configuration à l'échelle de Hub, ce champ peut être inutilisé.

membership_specs

map<string, MembershipFeatureSpec>

Facultatif. Configuration spécifique à l'appartenance pour cette ressource Feature. Si cette fonctionnalité n'est pas compatible avec les configurations par abonnement, ce champ peut être inutilisé.

Les clés indiquent l'appartenance pour la configuration, au format suivant :

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

Où {p} est le projet, {l} un emplacement valide et {m} une ressource Membership valide dans ce projet à cet emplacement. {p} correspond au projet de la ressource Feature.

{p} est toujours renvoyé en tant que numéro de projet, mais l'ID de projet est également accepté lors de la saisie. Si la même ressource Membership est spécifiée deux fois dans le mappage (à l'aide du formulaire d'ID de projet et du formulaire de numéro de projet), seule UNE entrée sera enregistrée, sans qu'il soit possible de choisir cette entrée. Pour cette raison, il est recommandé d'utiliser le même format pour toutes les entrées lors de la mutation d'une caractéristique.

state

CommonFeatureState

Uniquement en sortie. État de la fonctionnalité à l'échelle du Hub.

membership_states

map<string, MembershipFeatureState>

Uniquement en sortie. État de la fonctionnalité spécifique à l'appartenance. Si cette fonctionnalité signale un état par appartenance, ce champ peut être inutilisé.

Les clés indiquent à quelle appartenance l'état est associé, au format suivant :

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

Où {p} est le numéro de projet, {l} un emplacement valide et {m} une ressource Membership valide dans ce projet à cet emplacement. {p} DOIT correspondre au numéro de projet de la ressource Feature.

create_time

Timestamp

Uniquement en sortie. Date de création de la ressource Feature.

update_time

Timestamp

Uniquement en sortie. Date et heure de la dernière mise à jour de la ressource Feature.

delete_time

Timestamp

Uniquement en sortie. Date et heure de suppression de la ressource Feature.

fleet_default_member_config

CommonFleetDefaultMemberConfigSpec

Facultatif. Configuration de la ressource Feature applicable à toutes les appartenances du parc.

scope_specs

map<string, ScopeFeatureSpec>

Facultatif. Configuration spécifique au champ d'application de cette ressource Feature. Si cette ressource Feature n'est pas compatible avec la configuration par champ d'application, ce champ peut être inutilisé.

Les clés indiquent la ressource Scope à laquelle la configuration est destinée, sous la forme :

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

Où {p} est le projet et {s} une ressource Scope valide dans ce projet. {p} correspond au projet de la ressource Feature.

{p} est toujours renvoyé en tant que numéro de projet, mais l'ID de projet est également accepté lors de la saisie. Si la même ressource Scope est spécifiée deux fois dans le mappage (à l'aide du formulaire d'ID de projet et du formulaire de numéro de projet), seule UNE entrée sera enregistrée, sans qu'il soit possible de choisir cette entrée. Pour cette raison, il est recommandé d'utiliser le même format pour toutes les entrées lors de la mutation d'une caractéristique.

scope_states

map<string, ScopeFeatureState>

Uniquement en sortie. État de la fonctionnalité spécifique à la ressource Scope. Si cette fonctionnalité signale un état par champ d'application, ce champ peut être inutilisé.

Les clés indiquent la ressource Scope à laquelle l'état est destiné, sous la forme :

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

Où {p} est le projet et {s} une ressource Scope valide dans ce projet. {p} correspond au projet de la ressource Feature.

FeatureResourceState

FeatureResourceState décrit l'état d'une ressource Feature dans l'API GkeHub. Consultez FeatureState pour connaître l'état d'exécution de la ressource Feature dans le Hub et entre les appartenances.

Champs
state

FeatureResourceState.State

État actuel de la ressource Feature dans l'API Hub.

État

L'état décrit l'état du cycle de vie d'une ressource Feature.

Enums
STATE_UNSPECIFIED État inconnu ou non défini.
ENABLING La caractéristique est en cours d'activation et la ressource Feature est en cours de création. Une fois l'opération terminée, la caractéristique correspondante sera activée dans ce Hub.
ACTIVE La caractéristique est activée dans ce Hub et la ressource Feature est entièrement disponible.
DISABLING La caractéristique est en cours de désactivation dans ce Hub et la ressource Feature est en cours de suppression.
UPDATING La ressource Feature est en cours de mise à jour.
SERVICE_UPDATING La ressource Feature est en cours de mise à jour par le service Hub.

FeatureState

FeatureState décrit l'état général d'une ressource Feature. Il peut être utilisé pour décrire l'état d'une ressource Feature au niveau de l'environnement ou par appartenance, en fonction du contexte.

Champs
code

FeatureState.Code

État de haut niveau lisible par un ordinateur de cette ressource Feature.

description

string

Description lisible de l'état actuel.

update_time

Timestamp

Heure de mise à jour de cet état et des informations spécifiques de ressource Feature associées.

Code

Le code représente un état général lisible par un ordinateur de la ressource Feature.

Enums
CODE_UNSPECIFIED Inconnu ou non défini.
OK La ressource Feature fonctionne normalement.
WARNING La ressource Feature a rencontré un problème et fonctionne dans un état dégradé. Le retour à un fonctionnement normal de la ressource Feature peut nécessiter une intervention. Pour en savoir plus, consultez la description et les détails de ressource Feature associés.
ERROR La ressource Feature n'est pas opérationnelle ou est dans un état fortement dégradé. Le retour à un fonctionnement normal de la ressource Feature peut nécessiter une intervention. Pour en savoir plus, consultez la description et les détails de ressource Feature associés.

Parc

Le parc contient les métadonnées et la configuration à l'échelle du parc.

Champs
name

string

Uniquement en sortie. Nom de ressource unique complet de ce parc au format projects/{project}/locations/{location}/fleets/{fleet}.

Chaque projet Google Cloud peut comporter au maximum une ressource de parc, nommée "default".

display_name

string

Facultatif. Nom à afficher de la ressource Fleet attribué par l'utilisateur. Lorsqu'il est présent, il doit comporter entre 4 et 30 caractères. Les caractères autorisés sont les suivants : lettres minuscules et majuscules, chiffres, trait d'union, guillemets simples, guillemets doubles, espaces et point d'exclamation.

Exemple : Production Fleet

create_time

Timestamp

Uniquement en sortie. Date de création de la ressource Fleet.

update_time

Timestamp

Uniquement en sortie. Date de la dernière mise à jour de la ressource Fleet.

delete_time

Timestamp

Uniquement en sortie. Date de suppression de la ressource Fleet.

uid

string

Uniquement en sortie. UUID généré par Google pour cette ressource. Ce nom est unique pour toutes les ressources Fleet. Si une ressource Fleet est supprimée et qu'une autre ressource portant le même nom est créée, elle reçoit un uid différent.

state

FleetLifecycleState

Uniquement en sortie. État de la ressource d'espace de noms

default_cluster_config

DefaultClusterConfig

Facultatif. Configurations de cluster par défaut à appliquer à l'ensemble du parc.

labels

map<string, string>

Facultatif. Libellés de cette ressource Fleet.

FleetLifecycleState

FleetLifecycleState décrit l'état d'une ressource Fleet.

Champs
code

FleetLifecycleState.Code

Uniquement en sortie. État actuel de la ressource Fleet.

Code

Le code décrit l'état d'une ressource Fleet.

Enums
CODE_UNSPECIFIED Le code n'est pas défini.
CREATING Le parc est en cours de création.
READY Le parc est actif.
DELETING Le parc est en cours de suppression.
UPDATING Le parc est en cours de mise à jour.

GenerateConnectManifestRequest

Message de requête pour la méthode GkeHub.GenerateConnectManifest. .

Champs
name

string

Obligatoire. Nom de la ressource Membership à laquelle l'agent va associer, au format projects/*/locations/*/memberships/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.memberships.generateConnectManifest
namespace

string

Facultatif. Espace de noms des ressources de l'agent GKE Connect. La valeur par défaut est gke-connect.

L'agent Connect est automatiquement autorisé lorsqu'il est exécuté dans l'espace de noms par défaut. Sinon, vous devez accorder une autorisation explicite avec une liaison IAM supplémentaire.

proxy

bytes

Facultatif. URI d'un proxy si la connectivité de l'agent à gkeconnect.googleapis.com nécessite l'utilisation d'un proxy. Le format doit être au format http(s)://{proxy_address}, en fonction du protocole HTTP/HTTPS accepté par le proxy. Le trafic sortant de l'agent Connect sera acheminé via un proxy HTTP(S).

version

string

Facultatif. Version de l'agent Connect à utiliser. Correspond par défaut à la version la plus récente.

is_upgrade

bool

Facultatif. Si la valeur est définie sur "true", générez les ressources pour la mise à niveau uniquement. Certaines ressources générées uniquement pour l'installation (par exemple, les ressources Secret) seront exclues.

registry

string

Facultatif. Registre à partir duquel récupérer l'image de l'agent Connect. La valeur par défaut est gcr.io/gkeconnect.

image_pull_secret_content

bytes

Facultatif. Le contenu du secret d'extraction de l'image du registre, s'il n'est pas public.

GenerateConnectManifestResponse

GenerateConnectManifestResponse contient des informations du fichier manifeste pour l'installation/la mise à niveau d'un agent Connect.

Champs
manifest[]

ConnectAgentResource

Liste numérotée des ressources Kubernetes à appliquer au cluster pour l'installation ou la mise à niveau de l'agent GKE Connect.

GenerateMembershipRBACRoleBindingYAMLRequest

Requête permettant de générer un fichier YAML des stratégies RBAC pour l'objet RoleBinding spécifié et les ressources d'emprunt d'identité associées.

Champs
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel la ressource RBACRoleBindingRequest sera créée. Spécifié au format projects/*/locations/*/memberships/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.rbacrolebindings.get
rbacrolebinding_id

string

Obligatoire. ID choisi par le client pour la ressource RBACRoleBinding. rbacrolebinding_id doit être un libellé DNS valide conforme à la norme RFC 1123 :

  1. 63 caractères au maximum
  2. Doit être composé de caractères alphanumériques minuscules ou de -.
  3. Doit commencer et se terminer par un caractère alphanumérique.

Il peut être exprimé sous la forme de l'expression régulière [a-z0-9]([-a-z0-9]*[a-z0-9])?, d'une longueur maximale de 63 caractères.

rbacrolebinding

RBACRoleBinding

Obligatoire. Ressources RBACRoleBinding pour lesquelles générer le fichier YAML.

GenerateMembershipRBACRoleBindingYAMLResponse

Réponse pour GenerateRBACRoleBindingYAML.

Champs
role_bindings_yaml

string

Blob de texte yaml incluant les stratégies RBAC.

GetFeatureRequest

Message de requête pour la méthode GkeHub.GetFeature.

Champs
name

string

Obligatoire. Nom de la ressource Feature au format projects/*/locations/*/features/*

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.features.get

GetFleetRequest

Message de requête pour la méthode GkeHub.GetFleet.

Champs
name

string

Obligatoire. Nom de la ressource Fleet au format projects/*/locations/*/fleets/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.fleet.get

GetMembershipBindingRequest

Message de requête pour la méthode GkeHub.GetMembershipBinding.

Champs
name

string

Obligatoire. Nom de la ressource MembershipBinding au format projects/*/locations/*/memberships/*/bindings/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.membershipbindings.get

GetMembershipRBACRoleBindingRequest

Message de requête pour la méthode GkeHub.GetMembershipRBACRoleBinding.

Champs
name

string

Obligatoire. Nom de la ressource RBACRoleBinding au format projects/*/locations/*/memberships/*/rbacrolebindings/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.rbacrolebindings.get

GetMembershipRequest

Message de requête pour la méthode GkeHub.GetMembership.

Champs
name

string

Obligatoire. Nom de la ressource Membership au format projects/*/locations/*/memberships/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.memberships.get

GetScopeNamespaceRequest

Message de requête pour la méthode GkeHub.GetNamespace.

Champs
name

string

Obligatoire. Nom de la ressource d'espace de noms au format projects/*/locations/*/scopes/*/namespaces/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.namespaces.get

GetScopeRBACRoleBindingRequest

Message de requête pour la méthode GkeHub.GetScopeRBACRoleBinding.

Champs
name

string

Obligatoire. Nom de la ressource RBACRoleBinding au format projects/*/locations/*/scopes/*/rbacrolebindings/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.rbacrolebindings.get

GetScopeRequest

Message de requête pour la méthode GkeHub.GetScope.

Champs
name

string

Obligatoire. Nom de la ressource Scope au format projects/*/locations/*/scopes/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.scopes.get

GkeCluster

GkeCluster contient des informations spécifiques aux clusters GKE.

Champs
cluster_missing

bool

Uniquement en sortie. Si cluster_MISSING est défini, cela signifie que le cluster GKE n'existe plus dans le plan de contrôle GKE.

KubernetesMetadata

KubernetesMetadata fournit des métadonnées informatives sur les appartenances représentant des clusters Kubernetes.

Champs
kubernetes_api_server_version

string

Uniquement en sortie. Chaîne de version du serveur d'API Kubernetes indiquée par /version.

node_provider_id

string

Uniquement en sortie. ID du fournisseur de nœud indiqué par le premier nœud de la liste des nœuds sur le point de terminaison Kubernetes. Sur les plates-formes Kubernetes qui acceptent les clusters sans nœud (comme GKE-on-GCP), node_count est égal à zéro et node_provider_id est vide.

node_count

int32

Uniquement en sortie. Nombre de nœuds indiqué par les ressources de nœuds Kubernetes.

vcpu_count

int32

Uniquement en sortie. Nombre de processeurs virtuels indiqué par les ressources des nœuds Kubernetes.

memory_mb

int32

Uniquement en sortie. Capacité totale de la mémoire indiquée par la somme de toutes les ressources de nœuds Kubernetes, définie en Mo.

update_time

Timestamp

Uniquement en sortie. Date et heure de la dernière mise à jour de ces informations. Ce champ update_time est différent de update_time au niveau de l'appartenance, car EndpointDetails est mis à jour en interne pour les utilisateurs de l'API.

KubernetesResource

KubernetesResource contient les fichiers manifestes et la configuration YAML pour les ressources Membership Kubernetes dans le cluster. Après CreateMembership ou UpdateMembership, ces ressources doivent être réappliquées dans le cluster.

Champs
membership_cr_manifest

string

Uniquement en entrée. Représentation YAML de la RS de la ressource Membership. Ce champ est ignoré pour les clusters GKE sur lesquels la ressource Hub peut lire directement la RS.

Les appelants doivent fournir la RS actuellement présente dans le cluster lors de la tâche CreateMembership ou UpdateMembership, ou laisser ce champ vide s'il n'en existe pas. Le fichier manifeste de RS permet de vérifier que le cluster n'a pas été enregistré auprès d'une autre ressource Membership.

membership_resources[]

ResourceManifest

Uniquement en sortie. Ressources Kubernetes supplémentaires à appliquer au cluster après la création de la ressource Membership et après chaque mise à jour.

Ce champ n'est renseigné que dans la ressource Membership renvoyée par une opération de longue durée réussie par CreateMembership ou UpdateMembership. Il n'est pas renseigné lors des demandes GetMembership ou ListMemberships normales. Pour obtenir le fichier manifeste de la ressource après l'enregistrement initial, l'appelant doit effectuer un appel UpdateMembership avec un masque de champ vide.

connect_resources[]

ResourceManifest

Uniquement en sortie. Ressources Kubernetes pour l'installation de l'agent GKE Connect

Ce champ n'est renseigné que dans la ressource Membership renvoyée par une opération de longue durée réussie par CreateMembership ou UpdateMembership. Il n'est pas renseigné lors des demandes GetMembership ou ListMemberships normales. Pour obtenir le fichier manifeste de la ressource après l'enregistrement initial, l'appelant doit effectuer un appel UpdateMembership avec un masque de champ vide.

resource_options

ResourceOptions

Facultatif. Options de génération de ressources Kubernetes.

ListAdminClusterMembershipsRequest

Message de requête pour la méthode GkeHub.ListAdminClusterMemberships.

Champs
parent

string

Obligatoire. Parent (projet et emplacement) où les appartenances du cluster d'administrateur seront répertoriées. Spécifié au format projects/*/locations/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.memberships.list
page_size

int32

Facultatif. Lorsque vous demandez une "page" de ressources, page_size spécifie le nombre de ressources à renvoyer. Si cette valeur n'est pas spécifiée ou est définie sur 0, toutes les ressources sont renvoyées.

page_token

string

Facultatif. Jeton renvoyé par l'appel précédent à ListAdminClusterMemberships qui spécifie la position dans la liste à partir de laquelle continuer à répertorier les ressources.

filter

string

Facultatif. Répertorie les appartenances des clusters d'administrateur qui correspondent à l'expression de filtre.

order_by

string

Facultatif. Un ou plusieurs champs à comparer et à utiliser pour trier la sortie. Consultez la page https://google.aip.dev/132#ordering.

ListAdminClusterMembershipsResponse

Message de réponse pour la méthode GkeHub.ListAdminClusterMemberships.

Champs
admin_cluster_memberships[]

Membership

Liste des ressources Membership correspondantes des clusters d'administrateur.

next_page_token

string

Jeton permettant de demander la page de ressources suivante à la méthode ListAdminClusterMemberships. La valeur d'une chaîne vide signifie qu'il n'y a plus de ressources à renvoyer.

unreachable[]

string

Liste des zones géographiques inaccessibles lors de la récupération de cette liste.

ListFeaturesRequest

Message de requête pour la méthode GkeHub.ListFeatures.

Champs
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel les ressources Feature seront répertoriées. Spécifié au format projects/*/locations/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.features.list
page_size

int32

Lorsque vous demandez une "page" de ressources, page_size spécifie le nombre de ressources à renvoyer. Si cette valeur n'est pas spécifiée ou est définie sur 0, toutes les ressources sont renvoyées.

page_token

string

Jeton renvoyé par l'appel précédent à ListFeatures qui spécifie la position dans la liste à partir de laquelle continuer à répertorier les ressources.

filter

string

Répertorie les fonctionnalités qui correspondent à l'expression de filtre, en suivant la syntaxe décrite sur https://google.aip.dev/160.

Exemples :

  • Fonctionnalité nommée "servicemesh" dans le projet "foo-proj" :
  name = "projects/foo-proj/locations/global/features/servicemesh"
  • Fonctionnalités comportant un libellé appelé foo :
  labels.foo:*
  • Caractéristiques qui possèdent une étiquette appelée foo dont la valeur est bar :
  labels.foo = bar
order_by

string

Un ou plusieurs champs à comparer et à utiliser pour trier la sortie. Consultez la page https://google.aip.dev/132#ordering.

ListFeaturesResponse

Message de réponse pour la méthode GkeHub.ListFeatures.

Champs
resources[]

Feature

Liste des caractéristiques correspondantes

next_page_token

string

Jeton permettant de demander la page de ressources suivante à la méthode ListFeatures. La valeur d'une chaîne vide signifie qu'il n'y a plus de ressources à renvoyer.

ListFleetsRequest

Message de requête pour la méthode GkeHub.ListFleets.

Champs
parent

string

Obligatoire. Organisation ou projet dont vous souhaitez répertorier les ressources Fleet, au format organizations/*/locations/* ou projects/*/locations/*.

page_token

string

Facultatif. Jeton de page reçu d'un appel ListFleets précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListFleets doivent correspondre à l'appel ayant fourni le jeton de page.

page_size

int32

Facultatif. Nombre maximal de parcs à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si ce paramètre n'est pas spécifié, 200 parcs au maximum sont renvoyés. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.

ListFleetsResponse

Message de réponse pour la méthode GkeHub.ListFleetsResponse.

Champs
fleets[]

Fleet

Liste des parcs correspondants.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages. Le jeton n'est valide que pendant 1 heure.

ListMembershipBindingsRequest

Requête permettant de répertorier les ressources MembershipBinding.

Champs
parent

string

Obligatoire. Membre parent pour lequel les ressources MembershipBinding sont répertoriées. Spécifié au format projects/*/locations/*/memberships/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.membershipbindings.list
page_size

int32

Facultatif. Lorsque vous demandez une "page" de ressources, page_size spécifie le nombre de ressources à renvoyer. Si cette valeur n'est pas spécifiée ou est définie sur 0, toutes les ressources sont renvoyées.

page_token

string

Facultatif. Jeton renvoyé par l'appel précédent à ListMembershipBindings qui spécifie la position dans la liste à partir de laquelle continuer à répertorier les ressources.

filter

string

Facultatif. Répertorie les ressources MembershipBinding qui correspondent à l'expression de filtre, en suivant la syntaxe décrite sur https://google.aip.dev/160.

ListMembershipBindingsResponse

Liste des ressources MembershipBinding.

Champs
membership_bindings[]

MembershipBinding

Liste des ressources MembershipBinding

next_page_token

string

Jeton permettant de demander la page de ressources suivante à la méthode ListMembershipBindings. La valeur d'une chaîne vide signifie qu'il n'y a plus de ressources à renvoyer.

ListMembershipRBACRoleBindingsRequest

Requête permettant de répertorier les ressources MembershipRBACRoleBinding.

Champs
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel les ressources Feature seront répertoriées. Spécifié au format projects/*/locations/*/memberships/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.rbacrolebindings.list
page_size

int32

Facultatif. Lorsque vous demandez une "page" de ressources, page_size spécifie le nombre de ressources à renvoyer. Si cette valeur n'est pas spécifiée ou est définie sur 0, toutes les ressources sont renvoyées.

page_token

string

Facultatif. Jeton renvoyé par l'appel précédent à ListMembershipRBACRoleBindings qui spécifie la position dans la liste à partir de laquelle continuer à répertorier les ressources.

ListMembershipRBACRoleBindingsResponse

Liste des ressources MembershipRBACRoleBindingsResponse.

Champs
rbacrolebindings[]

RBACRoleBinding

Liste des ressources Membership RBACRoleBinding.

next_page_token

string

Jeton permettant de demander la page de ressources suivante à la méthode ListMembershipRBACRoleBindings. La valeur d'une chaîne vide signifie qu'il n'y a plus de ressources à renvoyer.

ListMembershipsRequest

Message de requête pour la méthode GkeHub.ListMemberships.

Champs
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel les appartenances seront répertoriées. Spécifié au format projects/*/locations/*. projects/*/locations/- répertorie les adhésions dans toutes les régions.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.memberships.list
page_size

int32

Facultatif. Lorsque vous demandez une "page" de ressources, page_size spécifie le nombre de ressources à renvoyer. Si cette valeur n'est pas spécifiée ou est définie sur 0, toutes les ressources sont renvoyées.

page_token

string

Facultatif. Jeton renvoyé par l'appel précédent à ListMemberships qui spécifie la position dans la liste à partir de laquelle continuer à répertorier les ressources.

filter

string

Facultatif. Répertorie les ressources Membership qui correspondent à l'expression de filtre, en suivant la syntaxe décrite sur https://google.aip.dev/160.

Exemples :

  • Le nom est bar dans le projet foo-proj et l'emplacement global :
  name = "projects/foo-proj/locations/global/membership/bar"
  • Ressources Membership dont le libellé est foo :
  labels.foo:*
  • Ressources Membership associées au libellé foo dont la valeur est bar :
  labels.foo = bar
  • Ressources Membership à l'état CREATING :
  state = CREATING
order_by

string

Facultatif. Un ou plusieurs champs à comparer et à utiliser pour trier la sortie. Consultez la page https://google.aip.dev/132#ordering.

ListMembershipsResponse

Message de réponse pour la méthode GkeHub.ListMemberships.

Champs
resources[]

Membership

Liste des ressources Membership correspondantes.

next_page_token

string

Jeton permettant de demander la page de ressources suivante à la méthode ListMemberships. La valeur d'une chaîne vide signifie qu'il n'y a plus de ressources à renvoyer.

unreachable[]

string

Liste des zones géographiques inaccessibles lors de la récupération de cette liste.

ListScopeNamespacesRequest

Requête permettant de répertorier les espaces de noms du parc.

Champs
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel les ressources Feature seront répertoriées. Spécifié au format projects/*/locations/*/scopes/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.namespaces.list
page_size

int32

Facultatif. Lorsque vous demandez une "page" de ressources, page_size spécifie le nombre de ressources à renvoyer. Si cette valeur n'est pas spécifiée ou est définie sur 0, toutes les ressources sont renvoyées.

page_token

string

Facultatif. Jeton renvoyé par l'appel précédent à ListFeatures qui spécifie la position dans la liste à partir de laquelle continuer à répertorier les ressources.

ListScopeNamespacesResponse

Liste des espaces de noms du parc.

Champs
scope_namespaces[]

Namespace

Liste des espaces de noms du parc

next_page_token

string

Jeton permettant de demander la page de ressources suivante à la méthode ListNamespaces. La valeur d'une chaîne vide signifie qu'il n'y a plus de ressources à renvoyer.

ListScopeRBACRoleBindingsRequest

Requête permettant de répertorier les ressources ScopeRBACRoleBinding.

Champs
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel les ressources Feature seront répertoriées. Spécifié au format projects/*/locations/*/scopes/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.rbacrolebindings.list
page_size

int32

Facultatif. Lorsque vous demandez une "page" de ressources, page_size spécifie le nombre de ressources à renvoyer. Si cette valeur n'est pas spécifiée ou est définie sur 0, toutes les ressources sont renvoyées.

page_token

string

Facultatif. Jeton renvoyé par l'appel précédent à ListScopeRBACRoleBindings qui spécifie la position dans la liste à partir de laquelle continuer à répertorier les ressources.

ListScopeRBACRoleBindingsResponse

Liste des requêtes ScopeRBACRoleBinding.

Champs
rbacrolebindings[]

RBACRoleBinding

Liste des requêtes ScopeRBACRoleBinding.

next_page_token

string

Jeton qui permet de demander la page de ressources suivante à la méthode ListScopeRBACRoleBindings. La valeur d'une chaîne vide signifie qu'il n'y a plus de ressources à renvoyer.

ListScopesRequest

Requête pour répertorier les ressources Scope.

Champs
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel les ressources Scope seront répertoriées. Spécifié au format projects/*/locations/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.scopes.list
page_size

int32

Facultatif. Lorsque vous demandez une "page" de ressources, page_size spécifie le nombre de ressources à renvoyer. Si cette valeur n'est pas spécifiée ou est définie sur 0, toutes les ressources sont renvoyées.

page_token

string

Facultatif. Jeton renvoyé par l'appel précédent à ListScopes qui spécifie la position dans la liste à partir de laquelle continuer à répertorier les ressources.

ListScopesResponse

Liste des requêtes Scope.

Champs
scopes[]

Scope

Liste des requêtes Scope.

next_page_token

string

Jeton qui permet de demander la page de ressources suivante à la méthode ListScopes. La valeur d'une chaîne vide signifie qu'il n'y a plus de ressources à renvoyer.

Accès

La ressource Membership contient des informations sur un cluster membre.

Champs
name

string

Uniquement en sortie. Nom complet et unique de cette ressource Membership au format projects/*/locations/*/memberships/{membership_id}, défini lors de la création.

membership_id doit être un libellé DNS valide conforme à la norme RFC 1123 :

  1. 63 caractères au maximum
  2. Doit être composé de caractères alphanumériques minuscules ou de -.
  3. Doit commencer et se terminer par un caractère alphanumérique.

Il peut être exprimé sous la forme de l'expression régulière [a-z0-9]([-a-z0-9]*[a-z0-9])?, d'une longueur maximale de 63 caractères.

labels

map<string, string>

Facultatif. Libellés de cette appartenance.

description

string

Uniquement en sortie. Description de cette appartenance, limitée à 63 caractères. Doit correspondre à l'expression régulière : [a-zA-Z0-9][a-zA-Z0-9_\-\.\ ]*

Ce champ est utilisé pour d'anciennes raisons.

state

MembershipState

Uniquement en sortie. État de la ressource Membership.

create_time

Timestamp

Uniquement en sortie. Date de création de la ressource Membership.

update_time

Timestamp

Uniquement en sortie. Date de la dernière mise à jour de la ressource Membership.

delete_time

Timestamp

Uniquement en sortie. Date de suppression de la ressource Membership.

external_id

string

Facultatif. ID généré et géré en externe pour cette ressource Membership. Cet ID peut être modifié après sa création, mais cela n'est pas recommandé.

L'ID doit correspondre à l'expression régulière : [a-zA-Z0-9][a-zA-Z0-9_\-\.]*

Si cette ressource Membership représente un cluster Kubernetes, cette valeur doit être définie sur l'UID de l'objet d'espace de noms kube-system.

last_connection_time

Timestamp

Uniquement en sortie. Pour les clusters utilisant Connect, horodatage de la connexion la plus récente établie avec Google Cloud. Cette heure est mise à jour toutes les quelques minutes, et non pas en continu. Pour les clusters qui n'utilisent pas GKE Connect ou qui ne se sont jamais connectés correctement, ce champ n'est pas défini.

unique_id

string

Uniquement en sortie. UUID généré par Google pour cette ressource. Ce nom est unique pour toutes les ressources Membership. Si une ressource Membership est supprimée et qu'une autre ressource portant le même nom est créée, elle obtient un "unique_id" différent.

authority

Authority

Facultatif. Comment identifier les charges de travail de cette ressource Membership. Pour en savoir plus, consultez la documentation sur Workload Identity : https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity.

monitoring_config

MonitoringConfig

Facultatif. Informations de configuration de la surveillance de cette appartenance.

Champ d'union type. Le type de ressource représenté par cette ressource Membership type ne peut être que l'un des suivants :
endpoint

MembershipEndpoint

Facultatif. Informations sur le point de terminaison pour atteindre ce membre.

MembershipBinding

MembershipBinding est une sous-ressource d'une appartenance, qui représente les champs d'application de parc (ou d'autres futures ressources de parc) auxquels une appartenance est liée.

Champs
name

string

Nom de ressource de la ressource MembershipBinding projects/{project}/locations/{location}/memberships/{membership}/bindings/{membershipbinding} elle-même.

uid

string

Uniquement en sortie. UUID généré par Google pour cette ressource. Celui-ci est unique pour toutes les ressources MembershipBinding. Si une ressource MembershipBinding est supprimée et qu'une autre ressource portant le même nom est créée, elle reçoit un uid différent.

create_time

Timestamp

Uniquement en sortie. Date de création de la liaison d'appartenance.

update_time

Timestamp

Uniquement en sortie. Date de la dernière mise à jour de la liaison d'appartenance.

delete_time

Timestamp

Uniquement en sortie. Date et heure de suppression de la liaison d'appartenance.

state

MembershipBindingLifecycleState

Uniquement en sortie. État de la ressource de liaison d'appartenance.

labels

map<string, string>

Facultatif. Libellés pour cette ressource MembershipBinding.

Champ d'union target. Type de ressource MembershipBinding dont il s'agit. target ne peut être qu'un des éléments suivants :
scope

string

Nom de ressource Scope au format projects/*/locations/*/scopes/*.

MembershipBindingLifecycleState

MembershipBindingLifecycleState décrit l'état d'une ressource Binding.

Champs
code

MembershipBindingLifecycleState.Code

Uniquement en sortie. État actuel de la ressource MembershipBinding.

Code

Le code décrit l'état d'une ressource MembershipBinding.

Enums
CODE_UNSPECIFIED Le code n'est pas défini.
CREATING La ressource MembershipBinding en cours de création.
READY La ressource MembershipBinding est active.
DELETING La ressource MembershipBinding est en cours de suppression.
UPDATING La ressource MembershipBinding est en cours de mise à jour.

MembershipEndpoint

La ressource MembershipEndpoint contient les informations nécessaires pour contacter une API Kubernetes, un point de terminaison et d'autres métadonnées Kubernetes.

Champs
kubernetes_metadata

KubernetesMetadata

Uniquement en sortie. Métadonnées spécifiques à Kubernetes utiles.

kubernetes_resource

KubernetesResource

Facultatif. Les ressources Kubernetes dans le cluster à appliquer à un cluster correctement enregistré, à l'état stable. Ces ressources :

  • Assurez-vous que le cluster est exclusivement enregistré auprès d'une seule ressource Membership Hub.
  • Propagez les informations de pool de charges de travail disponibles dans le champ Membership Authority.
  • Vérifiez la configuration initiale appropriée des fonctionnalités Hub par défaut.
google_managed

bool

Uniquement en sortie. Indique si le cycle de vie de cette appartenance est géré par un service Google Cluster Platform.

Champ d'union type. Informations sur le cluster enregistré. type ne peut être qu'un des éléments suivants :
gke_cluster

GkeCluster

Facultatif. Informations spécifiques pour un cluster GKE-on-GCP.

on_prem_cluster

OnPremCluster

Facultatif. Informations spécifiques pour un cluster GKE On-Prem. Un cluster d'utilisateur sur site qui n'a pas de lien de ressource n'est pas autorisé à utiliser ce champ. Il doit avoir un "type" nul à la place.

multi_cloud_cluster

MultiCloudCluster

Facultatif. Informations spécifiques pour un cluster GKE Multi-Cloud.

edge_cluster

EdgeCluster

Facultatif. Informations spécifiques pour un cluster Google Edge.

appliance_cluster

ApplianceCluster

Facultatif. Informations spécifiques pour un cluster GDC Edge Appliance.

MembershipFeatureSpec

MembershipFeatureSpec contient les informations de configuration pour une seule ressource Membership. REMARQUE : Veuillez utiliser snake case dans le nom de votre caractéristique.

Champs
origin

MembershipFeatureSpec.Origin

Indique si cette spécification par ressource Membership a été héritée d'une valeur par défaut au niveau du parc. Ce champ peut être mis à jour par les utilisateurs en remplaçant une configuration de ressource Membership (mise à jour implicitement vers USER) ou en étant explicitement défini sur FLEET.

Champ d'union feature_spec.

feature_spec ne peut être qu'un des éléments suivants :

configmanagement

MembershipSpec

Spécification propre à Config Management

cloudbuild

MembershipSpec

Spécification propre à Cloud Build

identityservice

MembershipSpec

Spécification propre à Identity Service

workloadcertificate

MembershipSpec

Spécification du certificat de charge de travail.

mesh

MembershipSpec

Spécification propre à Anthos Service Mesh

anthosobservability

AnthosObservabilityMembershipSpec

Spécification propre à l'observabilité Anthos

policycontroller

MembershipSpec

Spécification de Policy Controller.

fleetobservability

MembershipSpec

Spécification d'appartenance de l'observabilité du parc

namespaceactuation

MembershipSpec

Spécification d'appartenance de FNS Actuation

Provenance

Provenance définit l'origine de cette spécification MembershipFeatureSpec.

Champs
type

MembershipFeatureSpec.Origin.Type

Type spécifie le type d'origine défini.

Type

Type spécifie le persona qui a conservé la configuration.

Enums
TYPE_UNSPECIFIED Type est inconnu ou non défini.
FLEET La spécification par ressource Membership a été héritée de la valeur par défaut au niveau du parc.
FLEET_OUT_OF_SYNC La spécification par ressource Membership a été héritée de la valeur par défaut au niveau du parc, mais n'est plus synchronisée avec la valeur par défaut actuelle.
USER La spécification par ressource Membership a été héritée d'une spécification utilisateur.

MembershipFeatureState

MembershipFeatureState contient des informations sur l'état des fonctionnalités pour une seule ressource Membership.

Champs
state

FeatureState

État général de cette ressource Feature pour une seule appartenance.

Champ d'union feature_state.

feature_state ne peut être qu'un des éléments suivants :

servicemesh

MembershipState

État spécifique au maillage de services.

metering

MembershipState

État spécifique à la mesure.

configmanagement

MembershipState

État spécifique à Config Management.

identityservice

MembershipState

État spécifique à Identity Service.

appdevexperience

AppDevExperienceFeatureState

État spécifique de l'environnement de développement d'applications.

policycontroller

MembershipState

État spécifique à PolicyController.

clusterupgrade

MembershipState

État de ClusterUpgrade.

fleetobservability

MembershipState

État d'appartenance à l'observabilité du parc.

namespaceactuation

MembershipState

État d'appartenance de NS Actuation

MembershipState

MembershipState décrit l'état d'une ressource Membership.

Champs
code

MembershipState.Code

Uniquement en sortie. État actuel de la ressource Membership.

Code

Code décrit l'état d'une ressource Membership.

Enums
CODE_UNSPECIFIED Le code n'est pas défini.
CREATING Le cluster est en cours d'enregistrement.
READY Le cluster est enregistré.
DELETING L'enregistrement du cluster est en cours d'annulation.
UPDATING La ressource Membership est en cours de mise à jour.
SERVICE_UPDATING La ressource Membership est en cours de mise à jour par le service Hub.

MonitoringConfig

MonitoringConfig indique aux applications, services et interfaces utilisateur basés sur le parc comment les métriques du cluster sous-jacent sont transmises aux services de surveillance cloud. Il peut être défini sur une valeur vide ou non vide, mais ne peut pas être muté directement pour éviter de briser accidentellement la continuité des métriques.

Champs
project_id

string

Facultatif. Projet utilisé pour générer des rapports sur les métriques

location

string

Facultatif. Emplacement utilisé pour générer des rapports sur les métriques

cluster

string

Facultatif. Nom du cluster utilisé pour générer des rapports sur les métriques. Pour Anthos sur les clusters Anthos sur VMWare/Baremetal/MultiCloud, il serait au format {cluster_type}/{cluster_name} ; par exemple, "awsClusters/cluster_1".

kubernetes_metrics_prefix

string

Facultatif. Les métriques système Kubernetes, si elles sont disponibles, sont écrites dans ce préfixe. La valeur par défaut est kubernetes.io pour GKE, et kubernetes.io/anthos pour Anthos. Remarque : Anthos MultiCloud utilisera le préfixe kubernetes.io aujourd'hui, mais sera migré sous kubernetes.io/anthos.

cluster_hash

string

Facultatif. Pour les clusters GKE et multicloud, il s'agit de l'UUID de la ressource de cluster. Pour les clusters VMWare et Baremetal, il s'agit de l'UID kube-system.

MultiCloudCluster

MultiCloudCluster contient des informations spécifiques aux clusters GKE Multi-Cloud.

Champs
cluster_missing

bool

Uniquement en sortie. Si cluster_missing est défini, la ressource API(gkemulticloud.googleapis.com) n'existe plus pour ce cluster GKE Multi-Cloud.

Espace de noms

Namespace représente un espace de noms dans le parc

Champs
name

string

Nom de ressource de l'espace de noms projects/{project}/locations/{location}/namespaces/{namespace}

uid

string

Uniquement en sortie. UUID généré par Google pour cette ressource. Cet identifiant est unique pour toutes les ressources d'espace de noms. Si une ressource d'espace de noms est supprimée et qu'une autre ressource portant le même nom est créée, elle reçoit un uid différent.

create_time

Timestamp

Uniquement en sortie. Date de création de l'espace de noms.

update_time

Timestamp

Uniquement en sortie. Date de la dernière mise à jour de l'espace de noms.

delete_time

Timestamp

Uniquement en sortie. Date de suppression de l'espace de noms.

state

NamespaceLifecycleState

Uniquement en sortie. État de la ressource d'espace de noms

scope

string

Obligatoire. Champ d'application associé à l'espace de noms

namespace_labels

map<string, string>

Facultatif. Étiquettes d'espace de noms du cluster au niveau de l'espace de noms. Ces libellés sont appliqués à l'espace de noms associé des clusters membres liés au champ d'application parent. Les libellés au niveau de la ressource Scope (namespace_labels dans la ressource Fleet Scope) sont prioritaires sur les libellés au niveau de la ressource Namespace s'ils partagent une clé. Les clés et les valeurs doivent être conformes à Kubernetes.

labels

map<string, string>

Facultatif. Libellés de cette ressource Namespace.

NamespaceLifecycleState

NamespaceLifecycleState décrit l'état d'une ressource Namespace.

Champs
code

NamespaceLifecycleState.Code

Uniquement en sortie. État actuel de la ressource d'espace de noms.

Code

Code décrit l'état d'une ressource Namespace.

Enums
CODE_UNSPECIFIED Le code n'est pas défini.
CREATING L'espace de noms est en cours de création.
READY Espace de noms est actif.
DELETING L'espace de noms est en cours de suppression.
UPDATING L'espace de noms est en cours de mise à jour.

OnPremCluster

OnPremCluster contient des informations spécifiques aux clusters GKE On-Prem.

Champs
cluster_missing

bool

Uniquement en sortie. Si le champ cluster_existing est défini, cela signifie que la ressource API(gkeonprem.googleapis.com) de ce cluster GKE On-Prem n'existe plus.

admin_cluster

bool

Immuable. Si le cluster est un cluster d'administrateur.

cluster_type

OnPremCluster.ClusterType

Immuable. Type du cluster sur site.

ClusterType

ClusterType décrit le type de cluster sur site.

Enums
CLUSTERTYPE_UNSPECIFIED La ressource ClusterType n'est pas définie.
BOOTSTRAP La ressource ClusterType est un cluster d'amorçage.
HYBRID La ressource ClusterType est un cluster hybride Bare Metal.
STANDALONE La ressource ClusterType est un cluster autonome Bare Metal.
USER La ressource ClusterType est un cluster d'utilisateur.

OperationMetadata

Représente les métadonnées de l'opération de longue durée.

Champs
create_time

Timestamp

Uniquement en sortie. Heure à laquelle l'opération a été créée.

end_time

Timestamp

Uniquement en sortie. Heure à laquelle l'opération a terminé son exécution.

target

string

Uniquement en sortie. Chemin d'accès à la ressource défini par le serveur pour la cible de l'opération.

verb

string

Uniquement en sortie. Nom du verbe exécuté par l'opération.

status_detail

string

Uniquement en sortie. Statut lisible de l'opération, le cas échéant.

cancel_requested

bool

Uniquement en sortie. Détermine si l'utilisateur a demandé l'annulation de l'opération. Les opérations qui ont bien été annulées possèdent la valeur [Operation.error][] avec un code d'état google.rpc.Status.code de 1, correspondant au code Code.CANCELLED.

api_version

string

Uniquement en sortie. Version de l'API ayant permis de démarrer l'opération.

RBACRoleBinding

La ressource RBACRoleBinding représente un rbacrolebinding au sein du parc.

Champs
name

string

Nom de la ressource pour rbacrolebinding projects/{project}/locations/{location}/scopes/{scope}/rbacrolebindings/{rbacrolebinding} ou projects/{project}/locations/{location}/memberships/{membership}/rbacrolebindings/{rbacrolebinding}.

uid

string

Uniquement en sortie. UUID généré par Google pour cette ressource. Ce nom est unique pour toutes les ressources rbacrolebinding. Si une ressource rbacrolebinding est supprimée et qu'une autre ressource portant le même nom est créée, elle reçoit un uid différent.

create_time

Timestamp

Uniquement en sortie. Date de création de rbacrolebinding.

update_time

Timestamp

Uniquement en sortie. Date de la dernière mise à jour de rbacrolebinding.

delete_time

Timestamp

Uniquement en sortie. Date de suppression de la ressource rbacrolebinding.

state

RBACRoleBindingLifecycleState

Uniquement en sortie. État de la ressource rbacrolebinding.

role

RBACRoleBinding.Role

Obligatoire. Rôle à lier au compte principal

labels

map<string, string>

Facultatif. Libellés de cette ressource RBACRolebinding.

Champ d'union principal. Compte principal autorisé dans le cluster (au moins l'un des deux est requis). Si vous modifiez l'une de ces options, l'autre sera automatiquement désactivée. principal ne peut être qu'un des éléments suivants :
user

string

"user" est le nom de l'utilisateur tel qu'il est perçu par le cluster Kubernetes. Par exemple, "alice" ou "alice@domain.tld"

group

string

"group" est le groupe, tel que vu par le cluster Kubernetes.

Rôle

La ressource Role est le type des rôles Kubernetes.

Champs
predefined_role

RBACRoleBinding.Role.PredefinedRoles

prédéfini_role est le rôle Kubernetes par défaut à utiliser.

PredefinedRoles

La ressource PredefinedRoles est une représentation ENUM des rôles Kubernetes par défaut

Enums
UNKNOWN INCONNU
ADMIN Le rôle ADMIN dispose des autorisations EDIT et RBAC.
EDIT L'autorisation EDIT peut modifier toutes les ressources, sauf RBAC.
VIEW L'autorisation VIEW ne peut lire que les ressources.
ANTHOS_SUPPORT ANTHOS_SUPPORT donne à l'assistance Google un accès en lecture seule à un certain nombre de ressources de cluster.

RBACRoleBindingLifecycleState

La ressource RBACRoleBindingLifecycleState décrit l'état d'une ressource RbacRoleBinding.

Champs
code

RBACRoleBindingLifecycleState.Code

Uniquement en sortie. État actuel de la ressource rbacrolebinding.

Code

La ressource Code décrit l'état d'une ressource rbacrolebinding.

Enums
CODE_UNSPECIFIED Le code n'est pas défini.
CREATING Création de la ressource rbacrolebinding en cours.
READY La ressource rbacrolebinding est active.
DELETING Suppression de la ressource rbacrolebinding en cours.
UPDATING La ressource rbacrolebinding est en cours de mise à jour.

ResourceManifest

La ressource ResourceManifest représente une ressource Kubernetes unique à appliquer au cluster.

Champs
manifest

string

Fichier manifeste YAML de la ressource.

cluster_scoped

bool

Indique si la ressource fournie dans le fichier manifeste est cluster_scoped. Si cette valeur n'est pas définie, le fichier manifeste est supposé être à l'échelle d'un espace de noms.

Ce champ est utilisé pour le mappage REST lors de l'application de la ressource dans un cluster.

ResourceOptions

La ressource ResourceOptions représente les options de génération de ressources Kubernetes.

Champs
connect_version

string

Facultatif. Version de l'agent Connect à utiliser pour connect_resources. Correspond par défaut à la dernière version de GKE Connect. La version doit être une version actuellement compatible. Les versions obsolètes seront refusées.

v1beta1_crd

bool

Facultatif. Utilisez apiextensions/v1beta1 au lieu de apiextensions/v1 pour les ressources CustomResourceDefinition. Cette option doit être définie pour les clusters ayant des versions de serveur d'API Kubernetes <1.16.

k8s_version

string

Facultatif. Version majeure du cluster Kubernetes. Cela permet uniquement de déterminer la version à utiliser pour les ressources CustomResourceDefinition, apiextensions/v1beta1 ou apiextensions/v1.

Champ d'application

La ressource Scope représente un champ d'application dans un parc.

Champs
name

string

Nom de ressource du champ d'application projects/{project}/locations/{location}/scopes/{scope}

uid

string

Uniquement en sortie. UUID généré par Google pour cette ressource. Unique pour toutes les ressources de champ d'application. Si une ressource de champ d'application est supprimée et qu'une autre ressource portant le même nom est créée, elle reçoit un uid différent.

create_time

Timestamp

Uniquement en sortie. Date de création du champ d'application.

update_time

Timestamp

Uniquement en sortie. Date de la dernière mise à jour du champ d'application.

delete_time

Timestamp

Uniquement en sortie. Date de suppression du champ d'application.

state

ScopeLifecycleState

Uniquement en sortie. État de la ressource Scope.

namespace_labels

map<string, string>

Facultatif. Étiquettes d'espace de noms du cluster au niveau du champ d'application. Pour les clusters membres liés à la ressource Scope, ces libellés sont appliqués à chaque espace de noms sous la ressource Scope. Les libellés au niveau du champ d'application sont prioritaires par rapport aux libellés au niveau de l'espace de noms (namespace_labels dans la ressource d'espace de noms du parc) s'ils partagent une clé. Les clés et les valeurs doivent être conformes à Kubernetes.

labels

map<string, string>

Facultatif. Libellés de cette ressource Scope.

ScopeFeatureSpec

La ressource ScopeFeatureSpec contient des spécifications de fonctionnalités pour un champ d'application de parc.

Champs

Champ d'union feature_spec.

feature_spec ne peut être qu'un des éléments suivants :

clusterupgrade

ScopeSpec

Spécification de la fonctionnalité ClusterUpgrade au niveau du champ d'application

ScopeFeatureState

La ressource ScopeFeatureState contient des informations sur l'état de la ressource Feature à l'échelle du champ d'application.

Champs
state

FeatureState

Uniquement en sortie. "État d'exécution" de la ressource Feature de cette ressource Scope.

Champ d'union feature_state.

feature_state ne peut être qu'un des éléments suivants :

clusterupgrade

ScopeState

État de la fonctionnalité ClusterUpgrade au niveau du champ d'application

ScopeLifecycleState

La ressource ScopeLifecycleState décrit l'état d'une ressource de champ d'application.

Champs
code

ScopeLifecycleState.Code

Uniquement en sortie. État actuel de la ressource de champ d'application.

Code

La ressource Code décrit l'état d'une ressource Scope.

Enums
CODE_UNSPECIFIED Le code n'est pas défini.
CREATING Le champ d'application est en cours de création.
READY Le champ d'application est actif.
DELETING Le champ d'application est en cours de suppression.
UPDATING Le champ d'application est en cours de mise à jour.

SecurityPostureConfig

La ressource SecurityPostureConfig définit les options nécessaires pour activer/désactiver les fonctionnalités de l'API Security Posture.

Champs
mode

SecurityPostureConfig.Mode

Définit le mode à utiliser pour les fonctionnalités de Security Posture.

vulnerability_mode

SecurityPostureConfig.VulnerabilityMode

Définit le mode à utiliser pour l'analyse des failles.

Mode

La ressource Mode définit le mode d'activation pour les fonctionnalités de stratégie de sécurité GKE.

Enums
MODE_UNSPECIFIED Valeur par défaut non spécifiée.
DISABLED Désactive les fonctionnalités de stratégie de sécurité sur le cluster.
BASIC Applique les fonctionnalités de stratégie de sécurité sur le cluster.

VulnerabilityMode

La ressource VulnerabilityMode définit le mode d'activation pour l'analyse des failles.

Enums
VULNERABILITY_MODE_UNSPECIFIED Valeur par défaut non spécifiée.
VULNERABILITY_DISABLED Désactive l'analyse des failles sur le cluster.
VULNERABILITY_BASIC Applique l'analyse des failles de base sur le cluster.
VULNERABILITY_ENTERPRISE Applique la faille de la stratégie de sécurité aux fonctionnalités de cluster Enterprise.

TypeMeta

La ressource TypeMeta est l'information de type nécessaire au démarshaling de contenu des ressources Kubernetes dans le fichier manifeste.

Champs
kind

string

Genre de la ressource (par exemple, Deployment).

api_version

string

Version d'API de la ressource (par exemple, v1).

UpdateFeatureRequest

Message de requête pour la méthode GkeHub.UpdateFeature.

Champs
name

string

Obligatoire. Nom de la ressource Feature au format projects/*/locations/*/features/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.features.update
update_mask

FieldMask

Masque de champs à mettre à jour.

resource

Feature

Seuls les champs spécifiés dans le champ update_mask sont mis à jour. Si vous spécifiez un champ dans la ressource update_mask, mais ne spécifiez pas sa valeur ici, ce champ sera supprimé. Si vous mettez à jour un champ de mappage, définissez la valeur d'une clé sur NULL ou une chaîne vide pour supprimer la clé du mappage. Il n'est pas possible de remplacer la valeur d'une clé par une chaîne vide. Si vous spécifiez la ressource update_mask sur un chemin spécial "*", remplace complètement tous les champs modifiables par l'utilisateur pour qu'ils correspondent à resource.

request_id

string

ID de requête permettant d'identifier les requêtes. Spécifiez un ID de requête unique pour que le serveur sache qu'il doit ignorer la requête si vous devez la retenter alors qu'elle est déjà terminée. Le serveur garantit que pendant au moins 60 minutes après la première requête.

Par exemple, imaginons que vous effectuez une requête initiale et que celle-ci expire. Si vous effectuez à nouveau la requête avec le même ID de requête, le serveur peut vérifier si une opération d'origine ayant le même ID de requête a été reçue et, le cas échéant, ignorer la deuxième requête. Ainsi, les clients ne peuvent pas créer accidentellement des engagements en double.

L'ID de requête doit être un UUID valide, à ceci près qu'un UUID égal à zéro (00000000-0000-0000-0000-000000000000) n'est pas accepté.

UpdateFleetRequest

Message de requête pour la méthode GkeHub.UpdateFleet.

Champs
fleet

Fleet

Obligatoire. Ressource Fleet à mettre à jour.

Le champ name de l'objet Fleet identifie le parc qui sera mis à jour.

L'autorisation IAM suivante est requise pour la ressource fleet indiquée :

  • gkehub.fleet.update
update_mask

FieldMask

Obligatoire. Champs à mettre à jour.

UpdateMembershipBindingRequest

Requête de mise à jour d'une ressource MembershipBinding.

Champs
membership_binding

MembershipBinding

Obligatoire. Objet MembershipBinding avec des champs mis à jour.

L'autorisation IAM suivante est requise pour la ressource membershipBinding indiquée :

  • gkehub.membershipbindings.update
update_mask

FieldMask

Obligatoire. Champs à mettre à jour.

UpdateMembershipRBACRoleBindingRequest

Requête de mise à jour d'une appartenance rbacrolebinding.

Champs
rbacrolebinding

RBACRoleBinding

Obligatoire. Ressource rbacrolebinding avec des champs mis à jour. Le champ "name" de cette ressource rbacrolebinding permet d'identifier la ressource à mettre à jour.

L'autorisation IAM suivante est requise pour la ressource rbacrolebinding indiquée :

  • gkehub.rbacrolebindings.update
update_mask

FieldMask

Obligatoire. Champs à mettre à jour.

UpdateMembershipRequest

Message de requête pour la méthode GkeHub.UpdateMembership.

Champs
name

string

Obligatoire. Nom de la ressource Membership au format projects/*/locations/*/memberships/*.

L'autorisation IAM suivante est requise pour la ressource name indiquée :

  • gkehub.memberships.update
update_mask

FieldMask

Obligatoire. Masque de champs à mettre à jour.

resource

Membership

Obligatoire. Seuls les champs spécifiés dans le champ update_mask sont mis à jour. Si vous spécifiez un champ dans la ressource update_mask, mais ne spécifiez pas sa valeur ici, ce champ sera supprimé. Si vous mettez à jour un champ de mappage, définissez la valeur d'une clé sur NULL ou une chaîne vide pour supprimer la clé du mappage. Il n'est pas possible de remplacer la valeur d'une clé par une chaîne vide. Si vous spécifiez la ressource update_mask sur un chemin spécial "*", remplace complètement tous les champs modifiables par l'utilisateur pour qu'ils correspondent à resource.

request_id

string

Facultatif. ID de requête permettant d'identifier les requêtes. Spécifiez un ID de requête unique pour que le serveur sache qu'il doit ignorer la requête si vous devez la retenter alors qu'elle est déjà terminée. Le serveur garantit que pendant au moins 60 minutes après la première requête.

Par exemple, imaginons que vous effectuez une requête initiale et que celle-ci expire. Si vous effectuez à nouveau la requête avec le même ID de requête, le serveur peut vérifier si une opération d'origine ayant le même ID de requête a été reçue et, le cas échéant, ignorer la deuxième requête. Ainsi, les clients ne peuvent pas créer accidentellement des engagements en double.

L'ID de requête doit être un UUID valide, à ceci près qu'un UUID égal à zéro (00000000-0000-0000-0000-000000000000) n'est pas accepté.

UpdateScopeNamespaceRequest

Requête de mise à jour d'un espace de noms de parc.

Champs
scope_namespace

Namespace

Obligatoire. Espace de noms avec des champs mis à jour. Le champ "name" de cet espace de noms permet d'identifier la ressource à mettre à jour. Avec le préfixe "mis à jour" pour suivre go/proto-best-practices-checkers#keyword_conflict

L'autorisation IAM suivante est requise pour la ressource scopeNamespace indiquée :

  • gkehub.namespace.update
update_mask

FieldMask

Obligatoire. Champs à mettre à jour.

UpdateScopeRBACRoleBindingRequest

Requête de mise à jour d'un champ d'application rbacrolebinding.

Champs
rbacrolebinding

RBACRoleBinding

Obligatoire. Ressource rbacrolebinding avec des champs mis à jour. Le champ "name" de cette ressource rbacrolebinding permet d'identifier la ressource à mettre à jour.

L'autorisation IAM suivante est requise pour la ressource rbacrolebinding indiquée :

  • gkehub.rbacrolebindings.update
update_mask

FieldMask

Obligatoire. Champs à mettre à jour.

UpdateScopeRequest

Requête de mise à jour une ressource Scope.

Champs
scope

Scope

Obligatoire. Ressource Scope avec des champs mis à jour. Le champ "name" de cet espace de noms permet d'identifier la ressource à mettre à jour.

L'autorisation IAM suivante est requise pour la ressource scope indiquée :

  • gkehub.scopes.update
update_mask

FieldMask

Obligatoire. Champs à mettre à jour.

ValidateCreateMembershipRequest

Message de requête pour la méthode GkeHub.ValidateCreateMembership.

Champs
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel les appartenances seront créées. Spécifié au format projects/*/locations/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.memberships.create
membership_id

string

Obligatoire. ID d'abonnement choisi par le client.

membership

Membership

Obligatoire. Ressource Membership à créer.

ValidateCreateMembershipResponse

Message de réponse pour la méthode GkeHub.ValidateCreateMembership.

Champs
validation_results[]

ValidationResult

Encapsule tous les résultats du programme de validation.

ValidationResult

Les ressources ValidationResult sont les résultats définis par chaque programme de validation exécuté lors de ValidateCreateMembership.

Champs
validator

ValidationResult.ValidatorType

Type de programme de validation avec lequel valider l'appartenance.

success

bool

Indique si la validation est réussie ou non.

result

string

Informations supplémentaires pour la validation.

ValidatorType

Spécifie différents types de validation.

Enums
VALIDATOR_TYPE_UNSPECIFIED Programme de validation NON SPÉCIFIÉ.
MEMBERSHIP_ID Le programme de validation MEMBERSHIP_ID vérifie que la ressource membership_id est toujours disponible.
CROSS_PROJECT_PERMISSION Le programme de validation CROSS_PROJECT_PERMISSION vérifie que la liaison de rôle inter-projets pour l'agent de service est en place.