开通服务定时扩缩容功能。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| eas:CreateServiceCronScaler | create | *全部资源 * |
| 无 |
请求语法
POST /api/v2/services/{ClusterId}/{ServiceName}/cronscaler HTTP/1.1
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ClusterId | string | 是 | 服务所在地域。 | cn-shanghai |
| ServiceName | string | 是 | 服务名称。如何查看服务名称，请参见ListServices 。 | foo |
| body | object | 否 | 请求 Body。 | |
| ScaleJobs | array<object> | 是 | 定时伸缩任务描述。 | |
| object | 否 | |||
| TargetSize | integer | 是 | 执行伸缩任务的目标实例数。 | 1 |
| Schedule | string | 是 | 要执行伸缩任务的 Cron 表达式。如何配置 Cron 表达式，请参见请求参数补充说明章节。 | 0 18 * * * * |
| Name | string | 否 | 定时扩缩容任务名称。 | scale-job-1 |
| ExcludeDates | array | 否 | 需要排除的时间点的 Cron 表达式列表。 | |
| string | 否 | Cron 表达式。如何配置 Cron 表达式，请参见请求参数补充说明章节。 | * * * * * 0,6 |
Cron 表达式
| 名称 | 可用值 | 可用特殊符号 |
|---|---|---|
| 秒 | 0-59 | * / , - |
| 分 | 0-59 | * / , - |
| 小时 | 0-23 | * / , - |
| 日 | 1-31 | * / , - |
| 月 | 1-12 或 JAN-DEC | * / , - |
| 星期 | 0-6 或 SUN-SAT | * / , - |
特殊符号说明
星号(*) 星号代表任意值，例如：0 0 0 1 * * 代表每月 1 号的 0 点整。
连字符(-) 连字符代表一段连续的取值范围，例如：0 0 12-14 * * * 代表每天的 12:00、13:00 和 14:00。
逗号(,) 连字符代表一段取值范围，例如：0 0 12,14 * * * 代表每天的 12:00 和 14:00。
斜杠(/) 斜杠用来代表一段增量的区间，例如：0 */15 * * * * 代表每小时的 0 分、15 分、30 分和 45 分。 斜杠可以和连字符配合使用，例如：0 5-40/15 * * * * 代表每小时从 5 分到 40 分钟之间，每隔 15 分钟取一个值，有效时间点可以是 0:05, 0:20, 0:35。
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "40325405-579C-4D82****",
"Message": "Create cron scaler for service [foo] successfully"
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2022-02-22 | 新增 OpenAPI | 查看变更详情 |