Method: projects.locations.customTargetTypes.patch

Actualiza un solo CustomTargetType.

Solicitud HTTP

PATCH https://clouddeploy.googleapis.com/v1/{customTargetType.name=projects/*/locations/*/customTargetTypes/*}

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customTargetType.name

string

Opcional. Es el nombre de CustomTargetType. El formato es projects/{project}/locations/{location}/customTargetTypes/{customTargetType}. El componente customTargetType debe coincidir con [a-z]([a-z0-9-]{0,61}[a-z0-9])?

Parámetros de consulta

Parámetros
updateMask

string (FieldMask format)

Obligatorio. La máscara de campo se usa para especificar los campos que la actualización reemplazará en el recurso CustomTargetType. Los campos especificados en updateMask están relacionados con el recurso, no con la solicitud completa. Los campos se reemplazarán si están en la máscara. Si el usuario no proporciona una máscara, se reemplazarán 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 tu solicitud, el servidor sepa que debe ignorarla si ya se completó. El servidor lo garantiza 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, la actualización de una CustomTargetType que no existe dará como resultado la creación de una CustomTargetType nueva.

validateOnly

boolean

Opcional. Si se configura como verdadera, la solicitud se valida y el usuario recibe un resultado esperado, pero no se realiza ningún cambio.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de CustomTargetType.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • clouddeploy.customTargetTypes.update

Para obtener más información, consulta la documentación de IAM.