在给定的项目和位置创建新版本。
HTTP 请求
POST https://clouddeploy.googleapis.com/v1/{parent=projects/*/locations/*/deliveryPipelines/*}/releases
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
parent |
必需。应在其中创建 |
查询参数
参数 | |
---|---|
releaseId |
必需。 |
requestId |
可选。这是用来标识请求的请求 ID。指定一个唯一的请求 ID,这样,在您必须重试请求时,服务器就会知道忽略该请求(如果请求已经完成)。服务器保证在首次请求后至少 60 分钟内。 例如,假设在您最初发出一个请求后,该请求超时,然后您使用相同的请求 ID 再次发出该请求,那么服务器便可检查是否收到了最初那个具有该请求 ID 的操作。如果收到了,服务器便会忽略这第二个请求。这样可以防止客户端意外创建重复的承诺。 请求 ID 必须是有效的 UUID,且不支持全部由零组成的 UUID(即 00000000-0000-0000-0000-000000000000)。 |
validateOnly |
可选。如果设为 true,系统会验证请求并向用户提供预期结果,但不会做出实际更改。 |
请求正文
请求正文包含一个 Release
实例。
响应正文
如果成功,响应正文将包含一个新创建的 Operation
实例。
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/cloud-platform
如需了解详情,请参阅身份验证概览。
IAM 权限
需要拥有 parent
资源的以下 IAM 权限:
clouddeploy.releases.create
如需了解详情,请参阅 IAM 文档。