Method: projects.locations.deliveryPipelines.releases.create

在给定的项目和位置中创建新的 Release。

HTTP 请求

POST https://clouddeploy.googleapis.com/v1/{parent=projects/*/locations/*/deliveryPipelines/*}/releases

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。应在其中创建 Release 的父集合。格式应为 projects/{projectId}/locations/{location_name}/deliveryPipelines/{pipeline_name}

查询参数

参数
releaseId

string

必需。Release 的 ID。

requestId

string

可选。这是用来标识请求的请求 ID。指定一个唯一的请求 ID,这样,在您的请求必须重试时,服务器就会知道在该请求已经完成的情况下将其忽略。服务器将在第一次请求后至少 60 分钟内保证这一点。

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

请求 ID 必须是有效的 UUID,且不支持全部由零组成的 UUID(即 00000000-0000-0000-0000-000000000000)。

validateOnly

boolean

可选。如果设置为 true,则对请求进行验证,并向用户提供预期结果,但不会进行任何实际更改。

请求正文

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

响应正文

如果成功,响应正文将包含一个新创建的 Operation 实例。

授权范围

需要以下 OAuth 范围:

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

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

IAM 权限

需要拥有 parent 资源的以下 IAM 权限:

  • clouddeploy.releases.create

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