# 套餐包列表 - ListTracePackages
#### 功能介绍
查询套餐包列表
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dac/dac_api_006.html)。
#### URI
GET /v1/{project_id}/trace/packages
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                            |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户从IAM申请到的projectid，一般为32位字符串 |
表2Query参数 
| 参数     | 是否必选 | 参数类型    | 描述                             |
|:---|:---|:---|:---|
| offset | 否    | Integer | 分页，从第几项开始                      |
| limit  | 否    | Integer | 每页大小，默认是10,可取值范围为10，20，50,1000 |
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数       | 参数类型                                                                       | 描述    |
|:---|:---|:---|
| count    | Integer                                                                    | 总数    |
| packages | Array of [PackagesInfo] objects | 套餐包信息 |
   
 表5PackagesInfo 
| 参数                    | 参数类型    | 描述                                                                      |
|:---|:---|:---|
| id                    | String  | 唯一标识                                                                    |
| period_type           | Integer | 包周期类型                                                                   |
| edition               | String  | 版本，标准版（standard），企业版（enterprise）                                        |
| period_num            | Integer | 周期大小，取值范围1-10                                                           |
| subscribe_num         | Integer | 订购数量                                                                    |
| status                | String  | 套餐包状态(Unpaid:未支付，Activating：激活中，Inactive：未激活，Expired：已过期，Activated：已激活) |
| order_id              | String  | 订单ID                                                                    |
| usage                 | Integer | 溯源码使用量                                                                  |
| amount                | Integer | 溯源码总量                                                                   |
| effective_time        | String  | 生效时间                                                                    |
| expired_time          | String  | 过期时间                                                                    |
| countdown             | Integer | 保留期倒计时时间，最多保留7天                                                         |
| enterprise_project_id | String  | 企业项目id,默认为"0"                                                           |
| resource_spec_code    | String  | 规格编码                                                                    |
   
**状态码：401**
表6响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误码  |
| error_msg  | String | 错误描述 |
   
**状态码：403**
表7响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误码  |
| error_msg  | String | 错误描述 |
   
**状态码：500**
表8响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误码  |
| error_msg  | String | 错误描述 |
   
#### 请求示例
无
#### 响应示例
**状态码：200**
success
```
{
  "count" : 1,
  "packages" : [ {
    "id" : "string",
    "period_type" : 2,
    "edition" : "string",
    "period_num" : 1,
    "subscribe_num" : 1,
    "status" : "Inactive",
    "order_id" : "CS2404180951BTYCQ",
    "usage" : 100,
    "amount" : 100,
    "effective_time" : "2021-08-17T15:14:30.689952+08:00",
    "expired_time" : "2021-08-17T15:14:30.689952+08:00",
    "countdown" : 0,
    "enterprise_project_id" : "0",
    "resource_spec_code" : "dac.times.public.100amount"
  } ]
}
```
**状态码：500**
Error response
```
{
  "error_code" : "500",
  "error_msg" : "系统异常"
}
```
#### 状态码
| 状态码 | 描述             |
|:---|:---|
| 200 | success        |
| 401 | Unauthorized   |
| 403 | Forbidden      |
| 500 | Error response |