Opcional. Es el nombre del Target. El formato es projects/{project}/locations/{location}/targets/{target}. El componente target debe coincidir con [a-z]([a-z0-9-]{0,61}[a-z0-9])?.
Obligatorio. La máscara de campo se usa para especificar los campos que la actualización reemplazará en el recurso de destino. Los campos especificados en updateMask se relacionan con el recurso, no con la solicitud completa. Se reemplazará un campo si está en la máscara. Si el usuario no proporciona una máscara, se reemplazan todos los campos.
Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".
requestId
string
Opcional. Un ID de solicitud 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 garantiza eso 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 de la solicitud. Si vuelves a hacer la solicitud con el mismo ID de solicitud, el servidor puede verificar si se recibió la operación original con el mismo ID de solicitud 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).
allowMissing
boolean
Opcional. Si se configura como verdadera y se actualiza una Target que no existe, se creará una Target nueva.
validateOnly
boolean
Opcional. Si se configura como verdadera, se valida la solicitud y se le proporciona al usuario un resultado esperado, pero no se realiza ningún cambio real.
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de Target.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2024-06-25 (UTC)"],[[["\u003cp\u003eThis page details how to update the parameters of a single Target using a PATCH HTTP request to the specified URL, which follows gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eThe update operation requires specific path parameters, such as the \u003ccode\u003etarget.name\u003c/code\u003e, which is a string identifier specifying the target to be modified.\u003c/p\u003e\n"],["\u003cp\u003eQuery parameters such as \u003ccode\u003eupdateMask\u003c/code\u003e, \u003ccode\u003erequestId\u003c/code\u003e, \u003ccode\u003eallowMissing\u003c/code\u003e, and \u003ccode\u003evalidateOnly\u003c/code\u003e are available to control the update operation's behavior, like which fields to update and whether to create a new Target if one does not exist.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain an instance of \u003ccode\u003eTarget\u003c/code\u003e, and upon successful completion, the response body will contain an instance of \u003ccode\u003eOperation\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eUpdating a target requires the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e and the IAM permission \u003ccode\u003eclouddeploy.targets.update\u003c/code\u003e on the specified resource.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.targets.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 Target.\n\n### HTTP request\n\n`PATCH https://clouddeploy.googleapis.com/v1/{target.name=projects/*/locations/*/targets/*}`\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 [Target](/deploy/docs/api/reference/rest/v1/projects.locations.targets#Target).\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.targets.update`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]