Method: projects.locations.targets.delete

删除单个目标。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。要删除的 Target 的名称。格式应为 projects/{projectId}/locations/{location_name}/targets/{target_name}。

查询参数

参数
requestId

string

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

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

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

boolean

可选。如果设为 true，则已删除已删除或不存在的 Target 将会成功删除。
validateOnly

boolean

可选。如果设置了此字段，则会验证请求并预览评价，但不要实际发布。
etag

string

可选。此校验和由服务器根据其他字段的值计算，并且可能会在更新和删除请求时发送，以确保客户端在继续操作之前拥有最新的值。

请求正文

请求正文必须为空。

响应正文

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

授权范围

需要以下 OAuth 范围：

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

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

IAM 权限

需要拥有 name 资源的以下 IAM 权限：

  • clouddeploy.targets.delete

如需了解详情，请参阅 IAM 文档。