查询包周期和按需资源列表
功能介绍
查询用户可使用套餐和按需资源列表。
购买套餐后会生成套餐资源；创建企业时默认创建视图接入调阅、连续云存储、动检云存储、行业数据流按需资源。
URI
GET /v1/{user_id}/resources
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
user_id |
是 |
String |
用户ID：由数字组成，长度范围[15,25]，获取方式参考获取user ID与下载AK/SK章节 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
limit |
否 |
Integer |
单页内显示记录数：取值范围为[1,300]，不填时默认为10 |
|
offset |
否 |
Integer |
偏移量：offset为0时表示查询第一页的数据，取值范围[0,2142147483646]，不填写时默认为0 |
|
resource_id |
否 |
String |
包周期资源ID：32位数字、字母组成 |
|
resource_type_code |
否 |
String |
资源类型
|
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Access-Token |
是 |
String |
用户认证AccessToken：从获取用户北向接口认证AccessToken中获取 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total |
Integer |
可使用资源总数 |
|
resources |
Array of UserResource objects |
资源列表 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
resource_id |
String |
资源id |
|
resource_type_code |
String |
资源规格编码
|
|
total_num |
Integer |
资源可使用总量，套餐资源为订购的路数，按需为 -1 |
|
usage_num |
Integer |
资源当前已使用量，设备通道每绑定一路，该使用量增加一路，反之则减少一路 |
|
resource_name |
String |
资源名 |
|
mode |
String |
按需或包周期
|
|
version |
String |
资源版本
|
|
resource_state |
String |
资源状态：
|
|
Exp_time |
String |
资源过期时间 |
请求示例
查询套餐列表
GET /v1/48sa5478924655sa5*****/resources?offset=1&limit=15&resource_type_code=MANAGE&resource_id=c0d3c9f9b70b4c3599fe4a98e*******
响应示例
状态码： 200
{
"total" : 2,
"resources" : [ {
"resource_id" : "156",
"resource_type_code" : "MOTION",
"resource_name" : "设备按需动检收录套餐",
"resource_state" : "NORMAL",
"total_num" : 1,
"usage_num" : 0,
"version" : "ENTERPRISE",
"mode" : "PACKAGE ",
"Exp_time" : "2023-09-22 02:22:00"
}, {
"resource_id" : "157",
"resource_type_code" : "MOTION",
"resource_name" : "90天动检检云存储月套餐",
"resource_state" : "NORMAL",
"total_num" : 1,
"usage_num" : 0,
"version" : "ADVANCED",
"mode" : "ONDEMAND ",
"Exp_time" : "2023-08-15 14:24:33"
} ]
}
状态码
请参见状态码
错误码
请参见错误码。
