Method: projects.locations.dataAgents.patch

Actualiza los parámetros de un solo DataAgent.

Solicitud HTTP

PATCH https://geminidataanalytics.googleapis.com/v1beta/{dataAgent.name=projects/*/locations/*/dataAgents/*}

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

Parámetros de ruta

Parámetros
dataAgent.name

string

Opcional. Identificador. Nombre de recurso único de un DataAgent. Formato: projects/{project}/locations/{location}/dataAgents/{dataAgentId} {dataAgent} es el ID del recurso y debe tener 63 caracteres o menos, así como coincidir con el formato descrito en https://google.aip.dev/122#resource-id-segments.

Ejemplo: projects/1234567890/locations/us-central1/dataAgents/my-agent

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

Los parámetros de consulta

Parámetros
updateMask

string (FieldMask format)

Opcional. La máscara de campo se usa para especificar los campos que se van a sobrescribir en el recurso DataAgent mediante la actualización. Los campos especificados en updateMask son relativos al recurso, no a la solicitud completa. Si un campo está en la máscara, se sobrescribirá. Si el usuario no proporciona una máscara, se sobrescribirán todos los campos con valores no predeterminados presentes en la solicitud. Si se proporciona una máscara de comodín, se sobrescribirán todos los campos.

Es una lista de nombres completos de campos separados por comas. Ejemplo: "user.displayName,photo"
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 hace correctamente, en el cuerpo de la respuesta se incluye 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 el Authentication Overview.

Permisos de IAM

Requiere el siguiente permiso de gestión de identidades y accesos en el recurso name:

  • geminidataanalytics.dataAgents.update

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