Method: projects.locations.memberships.validateCreate

memberships.validateCreate est une vérification préliminaire de memberships.create. Il vérifie les points suivants : 1. L'appelant dispose de l'autorisation gkehub.memberships.create requise. 2. L'ID de membre est toujours disponible.

Requête HTTP

POST https://gkehub.googleapis.com/v1alpha/{parent=projects/*/locations/*}/memberships:validateCreate

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

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

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

  • gkehub.memberships.create

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "membershipId": string,
  "membership": {
    object (Membership)
  }
}
Champs
membershipId

string

Obligatoire. ID d'abonnement choisi par le client.

membership

object (Membership)

Obligatoire. Ressource d'abonnement à créer.

Corps de la réponse

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

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "validationResults": [
    {
      object (ValidationResult)
    }
  ]
}
Champs
validationResults[]

object (ValidationResult)

Encapsule tous les résultats du programme de validation.

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.

ValidationResult

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

Représentation JSON
{
  "validator": enum (ValidationResult.ValidatorType),
  "success": boolean,
  "result": string
}
Champs
validator

enum (ValidationResult.ValidatorType)

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

success

boolean

Indique si la validation est réussie ou non.

result

string

Informations supplémentaires pour la validation.

ValidationResult.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 l'ID de membre (membershipId) 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.