# 变更知识仓实例 - ScaleStore
#### 功能介绍
对指定的知识仓实例进行扩容或缩容。
#### URI
POST /v1/stores/scale
#### 请求参数
表1请求Body参数 
| 参数         | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| store_name | 是    | String  | **参数解释：** 知识仓实例名称，region内唯一。 **约束限制：** 长度范围为3到63个字符，支持小写字母、数字、中划线（ - ），第一个字符只能够是小写字母，中划线（ - ）不得出现在字符串末尾。 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                |
| action     | 否    | String  | **参数解释：** 变更动作。 **约束限制：** 不涉及 **取值范围：** SCALE_OUT：扩容 SCALE_IN：缩容 **默认取值：** SCALE_OUT                                                                                                  |
| cu_num     | 是    | Integer | **参数解释：** 扩容或缩容后cu规格的最终数量 **约束限制：** "action"为"SCALE_OUT"时，cu_num值要大于当前已有cu规格的数量；cu_num不能超过CU配额，如有大量需求，请提工单申请。 "action"为"SCALE_IN"时，cu_num值要小于当前已有cu规格的数量。 **取值范围：** 大于0 **默认取值：** 不涉及 |
   
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数      | 参数类型                                                              | 描述                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|
| code    | String                                                            | **参数解释：** 返回码。参见错误码章节。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值:** 不涉及。 |
| message | String                                                            | **参数解释：** 描述信息。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值:** 不涉及。        |
| data    | [scale_store_data] object | **参数解释：** 扩容详情。 **约束限制：** 不涉及。                                                                                                                                                                                                                                                        |
   
 表3scale_store_data 
| 参数         | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|
| id         | String  | **参数解释：** 知识仓实例id。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值:** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                       |
| job_id     | String  | **参数解释：** 创建知识仓实例的任务id。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值:** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                  |
| store_name | String  | **参数解释：** 知识仓实例名称，region内唯一。 **约束限制：** 长度范围为3到63个字符，支持小写字母、数字、中划线（ - ），第一个字符只能够是小写字母，中划线（ - ）不得出现在字符串末尾。 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                  |
| status     | String  | **参数解释：** 知识仓实例状态。 **约束限制：** 不涉及。 **取值范围：** CREATING：创建中 NORMAL：正常 CREATED_FAILED：创建失败 ABNORMAL：异常 FROZEN：冻结 DISK_FULL：存储空间已满 DELETING：删除中 DELETE_FAILED：删除失败 SCALING：扩容中 SCALING_IN：缩容中 **默认取值:** 不涉及。 |
| cu_num     | Integer | **参数解释：** 扩容后cu规格的数量 **约束限制：** cu_num值要大于当前已有cu规格的数量 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                      |
   
#### 请求示例
```
/v1/stores/scale
{
  "store_name" : "test-storename",
  "action" : "SCALE_OUT",
  "cu_num" : 10
}
```
#### 响应示例
**状态码：200**
执行成功，返回扩容或缩容相关信息。
```
{
  "code" : "LMS.00000000",
  "message" : "Request success, store is scaling",
  "data" : {
    "id" : "a3dbc6b6-4279-4472-8ff0-f031ed7cf96c",
    "job_id" : "8aa4baba-84ea-4a23-b129-06bf7353778a",
    "store_name" : "test-storename",
    "status" : "SCALING",
    "cu_num" : 10
  }
}
```
#### 状态码
| 状态码 | 描述                |
|:---|:---|
| 200 | 执行成功，返回扩容或缩容相关信息。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dwr/ErrorCode.html)。