Method: projects.locations.dataAgents.patch

Met à jour les paramètres d'un DataAgent unique.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
dataAgent.name

string

Facultatif. Identifiant. Nom de ressource unique d'un agent. Format : projects/{project}/locations/{location}/dataAgents/{dataAgentId} {dataAgent} correspond à l'ID de ressource. Il doit contenir 63 caractères au maximum et respecter le format décrit sur la page https://google.aip.dev/122#resource-id-segments.

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

Paramètres de requête

Paramètres
updateMask

string (FieldMask format)

Facultatif. Le masque de champ permet de spécifier les champs à écraser dans la ressource DataAgent lors de la mise à jour. Les champs spécifiés dans l'updateMask sont relatifs à la ressource, et non à la requête complète. Un champ sera écrasé s'il figure dans le masque. Si l'utilisateur ne fournit pas de masque, tous les champs dont les valeurs ne sont pas celles par défaut et qui figurent dans la requête seront écrasés. Si un masque générique est fourni, tous les champs seront écrasés.

Liste de noms complets de champs, séparés par une virgule. Exemple : "user.displayName,photo".
requestId

string

Facultatif. ID de requête facultatif permettant d'identifier les requêtes. Spécifiez un ID de requête unique pour indiquer au serveur d'ignorer la requête si vous devez la relancer alors qu'elle a déjà été traitée. Le serveur garantira cette logique pendant au moins 60 minutes après la première requête.

Imaginons que vous effectuez une requête initiale et que celle-ci expire. Si vous effectuez de nouveau la requête avec le même ID, le serveur peut vérifier si une opération initiale avec cet ID de requête a déjà été reçue et, si c'est le cas, ignorer la deuxième requête. Cela permet d'éviter que les clients ne créent accidentellement des engagements en double.

L'ID de requête doit être un UUID valide, sachant qu'un UUID égal à zéro (00000000-0000-0000-0000-000000000000) n'est pas accepté.

Corps de la requête

Le corps de la requête contient une instance de DataAgent.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource name :

  • geminidataanalytics.dataAgents.update

Pour en savoir plus, consultez la documentation IAM.