Method: projects.locations.memberships.validateCreate

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

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

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

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

  • gkehub.memberships.create

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "membershipId": string,
  "membership": {
    object (Membership)
  }
}
Felder
membershipId

string

Erforderlich. Vom Client ausgewählte Mitgliedschafts-ID.

membership

object (Membership)

Erforderlich. Zu erstellende Mitgliedschaftsressource.

Antworttext

Antwortnachricht für die Methode GkeHub.ValidateCreateMembership.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung
{
  "validationResults": [
    {
      object (ValidationResult)
    }
  ]
}
Felder
validationResults[]

object (ValidationResult)

Bettet alle Validierungsergebnisse ein.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

ValidationResult

ValidationResults sind Ergebnisse, die von die von den einzelnen Validierungen festgelegt werden, die während memberships.validateCreate ausgeführt werden.

JSON-Darstellung
{
  "validator": enum (ValidationResult.ValidatorType),
  "success": boolean,
  "result": string
}
Felder
validator

enum (ValidationResult.ValidatorType)

Validatortyp, mit dem die Mitgliedschaft validiert werden soll.

success

boolean

Gibt an, ob die Validierung bestanden wurde oder nicht.

result

string

Zusätzliche Informationen zur Validierung.

ValidationResult.ValidatorType

Gibt verschiedene Validierungstypen an.

Enums
VALIDATOR_TYPE_UNSPECIFIED UNSPECIFIED-Validator.
MEMBERSHIP_ID Der MEMBERSHIP_ID-Validator prüft, ob die Mitgliedschafts-ID noch verfügbar ist.
CROSS_PROJECT_PERMISSION Der CROSS_PROJECT_PERMISSION-Validator prüft, ob die projektübergreifende Rollenbindung für den Dienst-Agent vorhanden ist.