CreateServiceRollout - 创建服务更新计划

更新时间:
复制为 MD 格式

创建服务更新计划

接口说明

请求说明

  • 策略互斥Partition(分区发布)和Batch(批量发布)两种策略只能选择其中一种,不能同时使用。

  • 请求速率限制:每秒最多 100 次请求。

  • 授权信息:需要具备eas:CreateServiceRollout权限才能调用此接口。

  • 资源 ARNacs:eas:{#regionId}:{#accountId}:service/{#ServiceName}

  • 暂停发布:通过设置Paused参数为true可以暂停发布流程,之后可通过UpdateServiceRollout接口恢复或取消发布。

  • 监控与回滚:在发布过程中建议持续监控服务指标,以便及时发现并处理问题;如需回滚,可以通过调整Partition值或删除发布策略来实现。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /api/v2/services/{ClusterId}/{ServiceName}/rollout HTTP/1.1

路径参数

名称

类型

必填

描述

示例值

ClusterId

string

地域 ID。服务所在的地域标识,可通过 ListServices 接口获取可用地域列表。

cn-shanghai

ServiceName

string

服务名称。要创建发布策略的服务名称,服务名称在同一地域内必须唯一。可通过 DescribeService 接口获取服务详情。

my-service

请求参数

名称

类型

必填

描述

示例值

body

object

请求 Body。

Partition

object

手动分批配置。

Partition

string

需要更新到新版本的实例数。

1

Batch

object

自动分批配置。

BatchSize

string

每批更新的实例数。

1

Interval

string

每批更新完成后的等待间隔。

5m

Paused

boolean

是否暂停更新。

False

返回参数

名称

类型

描述

示例值

object

响应 Body。

RequestId

string

请求 ID。每次请求返回的唯一标识,用于问题排查和追踪。

40325405-579C-4D82****

Message

string

返回信息。描述请求处理结果。

Rollout created successfully

示例

正常返回示例

JSON格式

{
  "RequestId": "40325405-579C-4D82****\n",
  "Message": "Rollout created successfully"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情