
# 创建队列定时扩缩容计划（废弃）
#### 功能介绍
该API用于创建队列定时扩缩容计划，对指定的队列创建定时规格变更计划。
![](https://support.huaweicloud.com/api-dli/public_sys-resources/note_3.0-zh-cn.png)
当前接口已废弃，不推荐使用。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DLI&api=CreateQueuePlan)中调试该接口。
#### URI
- URI格式： POST /v1/{project_id}/queues/{queue_name}/plans
  
- 参数说明
  表1URI参数 
  | 参数名称       | 是否必选 | 参数类型   | 说明                                                                                     |
  |:---|:---|:---|:---|
  | project_id | 是    | String | 项目编号，用于资源隔离。获取方式请参考[获取项目ID](https://support.huaweicloud.com/api-dli/dli_02_0183.html)。 |
  | queue_name | 是    | String | 需要设置定时扩缩计划的队列名称，名称只能包含数字、英文字母和下划线，但不能是纯数字，且不能以下划线开头。名称长度为1\~128个字符。                    |
     
  
 
#### 请求消息
表2请求参数 
| 参数名称             | 是否必选 | 参数类型             | 说明                                                                                                                                                                                          |
|:---|:---|:---|:---|
| plan_name        | 是    | String           | 队列扩缩容计划名称，名称只能包含数字、英文字母和下划线，但不能是纯数字，且不能以下划线开头。                                                                                                                                              |
| target_cu        | 是    | Integer          | 队列扩缩容计划CU的目标值。                                                                                                                                                                              |
| start_hour       | 是    | Integer          | 队列扩缩容计划起始小时时间。                                                                                                                                                                              |
| start_minute     | 是    | Integer          | 队列扩缩容计划的起始分钟时间。                                                                                                                                                                             |
| repeat_day       | 是    | Array of strings | 定时扩缩容计划的重复周期，可以选择周一到周日的某一天、某几天、或者不选择。如果不选择，则会在当前时间后的start_hour：start_minute时间点执行扩缩容计划。例如： ``` "repeat_day": ["MONDAY", "TUESDAY", "WEDNESDAY","SUNDAY"] ``` |
| valid_date_begin | 否    | Long             | 有效期开始时间（13位时间戳）。                                                                                                                                                                            |
| valid_date_end   | 否    | Long             | 有效期结束时间（13位时间戳）。                                                                                                                                                                            |
| activate         | 否    | Boolean          | 当前设置的扩缩容计划是否激活，默认为"true"，表示激活。                                                                                                                                                              |
   
#### 响应消息
表3响应参数 
| 参数名称       | 是否必选 | 参数类型    | 说明                       |
|:---|:---|:---|:---|
| is_success | 否    | Boolean | 请求执行是否成功。"true"表示请求执行成功。 |
| message    | 否    | String  | 系统提示信息，执行成功时，信息可能为空。     |
   
#### 请求示例
为队列创建名为plan_A的扩缩容计划，要求队列在星期一、星期二、星期三、星期日的20：30分开始扩缩容，目标CU为64CUs。
```
{
    "plan_name": "plan_A",
    "target_cu": 64,
    "start_hour": 20,
    "start_minute": 30,
    "repeat_day": [
        "MONDAY",
        "TUESDAY",
        "WEDNESDAY",
        "SUNDAY"
    ],
    "valid_date_begin": 1590949800000,
    "valid_date_end": 1591727400000,
    "activate": true
}
```
#### 响应示例
```
{
    "is_success": true,
    "message": ""
}
```
#### 状态码
状态码如[表4]所示。
 表4状态码 
| 状态码 | 描述           |
|:---|:---|
| 200 | 创建队列扩缩容计划成功。 |
| 400 | 请求失败。        |
| 500 | 内部服务器错误。     |
   
#### 错误码
调用接口出错后，将不会返回上述结果，而是返回错误码和错误信息，更多介绍请参见[错误码](https://support.huaweicloud.com/api-dli/dli_02_0056.html)。
表5错误码 
| 错误码      | 错误信息                                                                                                                   |
|:---|:---|
| DLI.0999 | Queue plans create failed. The plan plan_A can not generate a scale plan, please check all time settings for the plan. |
   
