- Solicitud HTTP
- Parámetros de ruta
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Permisos de gestión de identidades y accesos
Crea una investigación en un proyecto y una ubicación determinados.
Solicitud HTTP
POST https://geminicloudassist.googleapis.com/v1alpha/{parent=projects/*/locations/*}/investigations
La URL utiliza la sintaxis de transcodificación a gRPC.
Parámetros de ruta
| Parámetros | |
|---|---|
parent |
Obligatorio. Valor del elemento superior. |
Los parámetros de consulta
| Parámetros | |
|---|---|
investigationId |
Opcional. ID que se usará en la investigación y que se convertirá en el componente final del nombre del recurso de la investigación. Este valor debe tener entre 4 y 63 caracteres, y los caracteres válidos son /[a-z][0-9]-/. Si no se proporciona, el servidor generará un ID único para la investigación. |
requestId |
Opcional. ID de solicitud opcional para identificar solicitudes. Especifica un ID de solicitud único para que, si tienes que volver a enviar la solicitud, el servidor sepa que debe ignorarla si ya se ha completado. El servidor garantizará que esto sea así durante al menos 60 minutos desde la primera solicitud. Por ejemplo, supongamos que haces una solicitud inicial y se agota el tiempo de espera. Si vuelves a enviar la solicitud con el mismo ID, el servidor puede comprobar si se ha recibido la operación original con ese ID y, si es así, ignorará la segunda solicitud. De esta forma, se evita que los clientes creen compromisos duplicados por error. El ID de solicitud debe ser un UUID válido, excepto el UUID cero (00000000-0000-0000-0000-000000000000). |
Cuerpo de la solicitud
En el cuerpo de la solicitud se incluye una instancia de Investigation.
Cuerpo de la respuesta
Si la solicitud se completa correctamente, en el cuerpo de la respuesta se incluye una instancia recién creada de Investigation.
Permisos de autorización
Requiere el siguiente permiso de OAuth:
https://www.googleapis.com/auth/cloud-platform
Para obtener más información, consulta el Authentication Overview.
Permisos de IAM
Requiere el siguiente permiso de gestión de identidades y accesos en el recurso parent:
geminicloudassist.investigations.create
Para obtener más información, consulta la documentación de gestión de identidades y accesos.