Method: projects.locations.memberships.validateCreate

memberships.validateCreate es una verificación previa para memberships.create. Verifica lo siguiente: 1. El emisor tiene el permiso gkehub.memberships.create requerido. 2. El membershipId aún está disponible.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El elemento superior (proyecto y ubicación) en el que se crearán los recursos Membership. Especificado en el formato projects/*/locations/*.

La autorización requiere el siguiente permiso IAM en el recurso especificado parent:

  • gkehub.memberships.create

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "membershipId": string,
  "membership": {
    object (Membership)
  }
}
Campos
membershipId

string

Obligatorio. ID de membresía elegido por el cliente.
membership

object (Membership)

Obligatorio. Recurso de la membresía que se creará.

Cuerpo de la respuesta

Mensaje de respuesta para el método GkeHub.ValidateCreateMembership.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "validationResults": [
    {
      object (ValidationResult)
    }
  ]
}
Campos
validationResults[]

object (ValidationResult)

Une todos los resultados del validador.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

ValidationResult

ValidationResults son resultados que establece cada validador que se ejecuta durante memberships.validateCreate.

Representación JSON 
{
  "validator": enum (ValidationResult.ValidatorType),
  "success": boolean,
  "result": string
}
Campos
validator

enum (ValidationResult.ValidatorType)

Tipo de validador con el que se debe validar la membresía.
success

boolean

Si la validación se aprueba o no.
result

string

Información adicional para la validación.

ValidationResult.ValidatorType

Especifica diferentes tipos de validación.

Enums
VALIDATOR_TYPE_UNSPECIFIED Validador UNSPECIFIED.
MEMBERSHIP_ID El validador de MEMBERSHIP_ID valida que el membershipId aún esté disponible.
CROSS_PROJECT_PERMISSION El validador CROSS_PROJECT_PERMISSION valida que se aplique la vinculación de roles entre proyectos para el agente de servicio.