# 获取组件实例快照
#### 功能介绍
通过此API获取应用组件实例的快照信息。
实例快照是指升级后，之前版本的实例信息，可以用于回滚。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=ServiceStage&api=ListInstanceSnapshots)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
GET /v2/{project_id}/cas/applications/{application_id}/components/{component_id}/instances/{instance_id}/snapshots
表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查询参数 
| 参数       | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| limit    | 否    | Integer | 指定个数，取值\[0, 100\]或者1000，指定的值不在该范围内的话相当于赋值为10。默认1000，用于不分页的场景。分页的场景取值请用\[0, 100\]。                                                                                                                                                                                                         |
| offset   | 否    | Integer | 指定偏移量。                                                                                                                                                                                                                                                                                    |
| order_by | 否    | String  | 排序字段，默认按创建时间排序。                                                                                                                                                                                                                                                                           |
| order    | 否    | String  | 排序方式。 - desc，降序排序，默认为desc。  - asc，升序排序。   |
   
#### 请求消息
表3请求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)。 |
   
#### 响应消息
表4响应参数 
| 参数        | 参数类型             | 描述                                                                              |
|:---|:---|:---|
| count     | Integer          | 快照总数。                                                                           |
| snapshots | Array of objects | 快照参数，请参考[表5]。 |
   
 表5snapshot 
| 参数          | 参数类型    | 描述       |
|:---|:---|:---|
| create_time | Integer | 创建时间     |
| description | String  | 描述       |
| instance_id | String  | 应用组件实例ID |
| version     | String  | 版本号      |
   
#### 请求示例
无
#### 响应示例
```
{
"snapshots": [
{
"version": "1.0.0",
"description": "{\"action\":\"New Version: 1.0.0\"}",
"instance_id": "11eddb33-140b-4e51-b1e2-6ec265373ca3",
"create_time": 1610331830841
}
],
"count": 1
}
```
#### 状态码
| 状态码 | 描述       |
|:---|:---|
| 200 | 操作成功。    |
| 400 | 错误的请求。   |
| 404 | 请求对象不存在。 |
| 500 | 内部错误。    |
   
#### 错误码
请参考[ServiceStage错误码](https://support.huaweicloud.com/api-servicestage/servicestage_06_0162.html)。