Method: projects.locations.dataAgents.create

Crea un DataAgent en un proyecto y una ubicación determinados.

Solicitud HTTP

POST https://geminidataanalytics.googleapis.com/v1beta/{parent=projects/*/locations/*}/dataAgents

La URL utiliza la sintaxis de transcodificación a gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Valor del elemento superior.

Los parámetros de consulta

Parámetros
dataAgentId

string

Opcional. ID del objeto solicitante. Debe ser único en el elemento superior. El formato permitido es ^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$. Si no se proporciona, el servidor generará automáticamente un valor para el ID.

requestId

string

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 DataAgent.

Cuerpo de la respuesta

Si la solicitud se completa correctamente, en el cuerpo de la respuesta se incluye una instancia recién creada de Operation.

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:

  • geminidataanalytics.dataAgents.create

Para obtener más información, consulta la documentación de gestión de identidades y accesos.