# 对组件实例的操作
#### 功能介绍
通过此API操作组件实例。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=ServiceStage&api=UpdateInstanceAction)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
POST /v2/{project_id}/cas/applications/{application_id}/components/{component_id}/instances/{instance_id}/action
表1路径参数 
| 参数             | 是否必选 | 参数类型   | 描述                                                                                                   |
|:---|:---|:---|:---|
| project_id     | 是    | String | 租户项目ID。获取方法，请参考[获取项目ID](https://support.huaweicloud.com/api-servicestage/servicestage_06_0164.html)。 |
| application_id | 是    | String | 应用ID。获取方法，请参考[获取所有应用](https://support.huaweicloud.com/api-servicestage/servicestage_06_0031.html)。   |
| component_id   | 是    | String | 组件ID。获取方法，请参考[获取应用所有组件](https://support.huaweicloud.com/api-servicestage/servicestage_06_0040.html)。 |
| instance_id    | 是    | String | 组件实例ID。获取方法，请参考[获取组件实例](https://support.huaweicloud.com/api-servicestage/servicestage_06_0046.html)。 |
   
#### 请求消息
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                           |
|:---|:---|:---|:---|
| Content-Type | 是    | String | 消息体的类型（格式），默认取值为"application/json;charset=utf8"。                                                                                             |
| X-Auth-Token | 是    | String | 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)。 |
   
表3请求Body参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| action     | 是    | String | 操作，支持start、stop、restart、scale、rollback。 - start：启动组件实例。  - stop：停止组件实例。  - restart：重启组件实例。  - scale：伸缩组件实例。  - rollback：回滚组件实例到上个版本。   |
| parameters | 否    | Object | 操作参数，action为scale和rollback时必选，请参考[表4]。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   
 表4parameters 
| 参数      | 是否必选 | 参数类型    | 描述                                                                                                             |
|:---|:---|:---|:---|
| replica | 否    | Integer | 实例数，在scale操作时必选。                                                                                               |
| hosts   | 否    | Array   | ECS id列表，指定虚机伸缩的时候部署的ECS主机，在scale操作时必选。                                                                        |
| version | 否    | String  | 版本号，在rollback操作时必选，通过[获取组件实例快照](https://support.huaweicloud.com/api-servicestage/servicestage_06_0051.html)获取。 |
   
#### 响应消息
表5响应参数 
| 参数     | 参数类型   | 描述      |
|:---|:---|:---|
| job_id | String | Job ID。 |
   
#### 请求示例
伸缩组件实例，修改组件实例数到4个。
```
{
  "action": "scale",
  "parameters": {
    "replica": 4
  }
}
```
#### 响应示例
```
{
    "job_id": "JOB66761060-f209-407c-a093-4df6f531b9dc"
}
```
#### 状态码
| 状态码 | 描述       |
|:---|:---|
| 200 | 操作成功。    |
| 400 | 错误的请求。   |
| 404 | 请求对象不存在。 |
| 500 | 内部错误。    |
   
#### 错误码
请参考[ServiceStage错误码](https://support.huaweicloud.com/api-servicestage/servicestage_06_0162.html)。