Method: projects.locations.units.create

Crea una unidad nueva.

Solicitud HTTP

POST https://saasservicemgmt.googleapis.com/v1/{parent=projects/*/locations/*}/units

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

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es el elemento principal de la unidad.

Parámetros de consulta

Parámetros
unitId

string

Obligatorio. Es el valor del ID de la unidad nueva.
validateOnly

boolean

Si "validateOnly" se establece como verdadero, el servicio intentará validar que esta solicitud se realice correctamente, pero no realizará cambios.
requestId

string

Un ID de solicitud opcional para identificar solicitudes. Especifica un ID de solicitud único para que, si debes reintentar la solicitud, el servidor sepa que debe ignorarla si ya se completó. El servidor lo garantizará durante, al menos, 60 minutos después de la primera solicitud.

Por ejemplo, imagina una situación en la que haces una solicitud inicial y se agota el tiempo de espera. Si vuelves a hacer la solicitud con el mismo ID, el servidor puede verificar si se recibió la operación original con el mismo ID y, de ser así, ignorar la segunda solicitud. Esto evita que los clientes creen compromisos duplicados por accidente.

El ID de solicitud debe ser un UUID válido, con la excepción de que no se admite ningún UUID cero (00000000-0000-0000-0000-000000000000).

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Unit.

Cuerpo de la respuesta

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Unit.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Authentication Overview.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • saasservicemgmt.units.create

Para obtener más información, consulta la documentación de IAM.