- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Permisos de IAM
Actualiza los parámetros de un solo DataAgent.
Solicitud HTTP
PATCH https://geminidataanalytics.googleapis.com/v1alpha/{dataAgent.name=projects/*/locations/*/dataAgents/*}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros | |
|---|---|
dataAgent.name |
Opcional. Es el identificador. Es el nombre único del recurso de un DataAgent. Formato: Ejemplo: Se recomienda omitir la configuración de este campo durante la creación del agente, ya que se inferirá automáticamente y se sobrescribirá con {parent}/dataAgents/{dataAgentId}. |
Parámetros de consulta
| Parámetros | |
|---|---|
updateMask |
Opcional. La máscara de campo se usa para especificar los campos que la actualización reemplazará en el recurso DataAgent. Los campos especificados en updateMask se relacionan con el recurso, no con la solicitud completa. Un campo se reemplazará si está en la máscara. Si el usuario no proporciona una máscara, se reemplazarán todos los campos con valores no predeterminados presentes en la solicitud. Si se proporciona una máscara de comodín, se reemplazarán todos los campos. Esta es una lista separada por comas de los nombres de campos completamente calificados. Ejemplo: |
requestId |
Opcional. 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 DataAgent.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia 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 Authentication Overview.
Permisos de IAM
Se requiere el siguiente permiso de IAM en el recurso name:
geminidataanalytics.dataAgents.update
Para obtener más información, consulta la documentación de IAM.