Method: projects.locations.deliveryPipelines.targets.patch

更新单个共享目标的参数。

HTTP 请求

PATCH https://clouddeploy.googleapis.com/v1/{target.name=projects/*/locations/*/deliveryPipelines/*/targets/*}

网址采用 gRPC 转码语法。

路径参数

参数
target.name

string

可选。Target 的名称。格式为 projects/{project}/locations/{location}/ deliveryPipelines/{deliveryPipeline}/targets/[a-z][a-z0-9-]{0,62}。

查询参数

参数
updateMask

string (FieldMask format)

必需。字段掩码用于指定要在目标资源中被更新覆盖的字段。updateMask 中指定的字段与资源相关，而不是与完整请求相关。如果字段位于掩码中，则该字段将被覆盖。如果用户未提供掩码，则所有字段都将被覆盖。

这是完全限定字段名称的逗号分隔列表。示例："user.displayName,photo"。
requestId

string

可选。这是用来标识请求的请求 ID。您可以指定一个唯一的请求 ID，这样，在您必须重试请求时，服务器就会知道忽略该请求（如果该请求已完成）。服务器将保证自第一次请求起至少 60 分钟。

例如，假设在您最初发出一个请求后，该请求超时，然后您使用相同的请求 ID 再次发出该请求，那么服务器便可检查是否收到了最初那个具有该请求 ID 的操作。如果收到了，服务器便会忽略这第二个请求。这样可以防止客户端意外创建重复的承诺。

请求 ID 必须是有效的 UUID，且不支持全部由零组成的 UUID（即 00000000-0000-0000-0000-000000000000）。
allowMissing

boolean

可选。如果设置为 true，则更新不存在的 Target 会导致创建新的 Target。
validateOnly

boolean

可选。如果设为 true，系统会验证请求并向用户提供预期结果，但不会做出实际更改。

请求正文

请求正文包含一个 Target 实例。

响应正文

如果成功，则响应正文包含一个 Operation 实例。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。