Method: projects.locations.dataAgents.patch

Atualiza os parâmetros de um único DataAgent.

Pedido HTTP

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

O URL usa a sintaxe de transcodificação de gRPC.

Parâmetros de caminho

Parâmetros
dataAgent.name

string

Opcional. Identificador. O nome do recurso exclusivo de um DataAgent. Formato: projects/{project}/locations/{location}/dataAgents/{dataAgentId} {dataAgent} é o ID do recurso e deve ter 63 carateres ou menos, e corresponder ao formato descrito em https://google.aip.dev/122#resource-id-segments

Exemplo: projects/1234567890/locations/us-central1/dataAgents/my-agent.

Recomendamos que ignore a definição deste campo durante a criação do agente, uma vez que é inferido automaticamente e substituído por {parent}/dataAgents/{dataAgentId}.

Parâmetros de consulta

Parâmetros
updateMask

string (FieldMask format)

Opcional. A máscara de campo é usada para especificar os campos a serem substituídos no recurso DataAgent pela atualização. Os campos especificados no updateMask são relativos ao recurso e não ao pedido completo. Um campo é substituído se estiver na máscara. Se o utilizador não fornecer uma máscara, todos os campos com valores não predefinidos presentes no pedido são substituídos. Se for fornecida uma máscara com carateres universais, todos os campos são substituídos.

Esta é uma lista separada por vírgulas de nomes totalmente qualificados de campos. Exemplo: "user.displayName,photo".
requestId

string

Opcional. Um ID de pedido opcional para identificar pedidos. Especifique um ID de pedido exclusivo para que, se tiver de repetir o pedido, o servidor saiba que deve ignorá-lo se já tiver sido concluído. O servidor garante que, durante, pelo menos, 60 minutos desde o primeiro pedido.

Por exemplo, considere uma situação em que faz um pedido inicial e o pedido excede o tempo limite. Se fizer o pedido novamente com o mesmo ID do pedido, o servidor pode verificar se a operação original com o mesmo ID do pedido foi recebida e, em caso afirmativo, ignora o segundo pedido. Isto impede que os clientes criem acidentalmente compromissos duplicados.

O ID do pedido tem de ser um UUID válido, exceto o UUID zero, que não é suportado (00000000-0000-0000-0000-000000000000).

Corpo do pedido

O corpo do pedido contém uma instância de DataAgent.

Corpo da resposta

Se for bem-sucedido, o corpo da resposta contém uma instância de Operation.

Âmbitos de autorização

Requer o seguinte âmbito do OAuth:

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

Para mais informações, consulte o Authentication Overview.

Autorizações de IAM

Requer a seguinte autorização de IAM no recurso name:

  • geminidataanalytics.dataAgents.update

Para mais informações, consulte a documentação do IAM.