Obbligatorio. La maschera per i campi viene utilizzata per specificare i campi che devono essere sovrascritti nella risorsa Automation dall'aggiornamento. I campi specificati in updateMask sono relativi alla risorsa, non alla richiesta completa. Un campo presente nella maschera verrà sovrascritto. Se l'utente non fornisce una maschera, tutti i campi vengono sovrascritti.
Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".
requestId
string
Facoltativo. Un ID richiesta per identificare le richieste. Specifica un ID richiesta univoco in modo che, se devi ritentare la richiesta, il server sappia di ignorarla se è già stata completata. Il server lo garantisce per almeno 60 minuti dopo la prima richiesta.
Ad esempio, prendi in considerazione una situazione in cui effettui una richiesta iniziale e la richiesta scade. Se effettui di nuovo la richiesta con lo stesso ID richiesta, il server può verificare se è stata ricevuta l'operazione originale con lo stesso ID richiesta e, in questo caso, ignorerà la seconda richiesta. Questo impedisce ai client di creare accidentalmente impegni duplicati.
L'ID richiesta deve essere un UUID valido, ad eccezione del fatto che un UUID zero non è supportato (00000000-0000-0000-0000-000000000000).
allowMissing
boolean
Facoltativo. Se il criterio viene impostato su true, l'aggiornamento di un Automation che non esiste comporterà la creazione di un nuovo Automation.
validateOnly
boolean
Facoltativo. Se il criterio viene impostato su true, la richiesta viene convalidata e all'utente viene fornito un risultato previsto, ma non viene apportata alcuna modifica effettiva.
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di Automation.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2024-06-27 UTC."],[[["\u003cp\u003eThis webpage details how to update the parameters of a single Automation resource using a PATCH request to a specific URL.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eautomation.name\u003c/code\u003e parameter, found in the URL's path, is required to identify the specific Automation to be updated.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eupdateMask\u003c/code\u003e query parameter is required and specifies which fields within the Automation resource should be overwritten during the update, with the option to overwrite all fields if no mask is provided.\u003c/p\u003e\n"],["\u003cp\u003eSeveral other optional query parameters exist, including \u003ccode\u003erequestId\u003c/code\u003e for request tracking, \u003ccode\u003eallowMissing\u003c/code\u003e to allow creation of new Automations, and \u003ccode\u003evalidateOnly\u003c/code\u003e for testing the update without making changes.\u003c/p\u003e\n"],["\u003cp\u003eThe request body needs to include an \u003ccode\u003eAutomation\u003c/code\u003e resource and a successful operation will return an \u003ccode\u003eOperation\u003c/code\u003e resource, with authorization requiring the \u003ccode\u003ecloud-platform\u003c/code\u003e scope and \u003ccode\u003eclouddeploy.automations.update\u003c/code\u003e IAM permission.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.deliveryPipelines.automations.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\nUpdates the parameters of a single Automation resource.\n\n### HTTP request\n\n`PATCH https://clouddeploy.googleapis.com/v1/{automation.name=projects/*/locations/*/deliveryPipelines/*/automations/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [Automation](/deploy/docs/api/reference/rest/v1/projects.locations.deliveryPipelines.automations#Automation).\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/deploy/docs/api/reference/rest/v1/projects.locations.operations#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource:\n\n- `clouddeploy.automations.update`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
