DescribeAppVersions
获取一个或多个应用版本的信息
可根据应用版本ID,状态,应用ID,标签等作为过滤条件,来获取应用信息。
请求参数
Parameter name | Type | Description | Required |
---|---|---|---|
app_ids.n |
String |
应用ID,可以是一个或多个。app_ids和version_ids两者必须至少有一个 |
No |
version_ids.n |
String |
应用版本ID,可以是一个或多个。app_ids和version_ids两者必须至少有一个 |
No |
name |
String |
应用的名称 |
No |
sort_key |
String |
结果排序的列 |
No |
owner |
String |
按照用户账户过滤,只返回指定账户的资源 |
No |
verbose |
Integer |
是否返回冗长的信息,若为1,则返回集群相关其它资源信息 |
No |
offset |
Integer |
数据偏移量,默认为0 |
No |
limit |
Integer |
返回数据长度,默认为20,最大100 |
No |
reverse |
Integer |
是否逆序,1为逆序,0为正序 |
No |
除上述请求参数外,还包含公共参数。
返回数据
Name | Type | Description |
---|---|---|
action |
String |
响应动作 |
total_count |
Integer |
应用版本的总数量 |
version_set |
Array |
应用的版本集合 |
ret_code |
Integer |
执行成功与否,0 表示成功,其他值则为错误代码 |
Response Item
Name | Type | Description |
---|---|---|
status |
String |
状态,active,suspended |
description |
String |
应用版本描述 |
resource_kit |
String |
应用的配置文件ID |
version_id |
String |
应用版本的ID |
app_id |
String |
应用ID |
create_time |
TimeStamp |
应用版本的创建时间 |
visibility |
String |
应用版本的可见范围,public即为所有人可见,private为仅自己可见 |
name |
String |
版本的名称 |
console_id |
String |
版本的console ID |
下列返回结果为应用https://appcenter.qingcloud.com/apps/app-tg3lbp0a/ZooKeeper%20on%20QingCloud[ZooKeeper]
请求示例
https://api.qingcloud.com/iaas/?action=DescribeAppVersions
&app_ids.1=app-tg3lbp0a
&limit=20
&COMMON_PARAMS
返回示例
{
"action":"DescribeAppVersionsResponse",
"total_count":1,
"version_set":[
{
"status":"active",
"description":"\u6b64\u7248\u672c\u63d0\u4f9b\u7684\u662f\u539f\u751f Apache ZooKeeper 3.4.9 \u53d1\u884c\u7248\uff0c\u540c\u65f6\u63d0\u4f9b ZooKeeper REST \u670d\u52a1",
"resource_kit":"ca-nx8rerlv",
"version_id":"appv-70gegwmp",
"app_id":"app-tg3lbp0a",
"create_time":"2017-04-21T02:34:24Z",
"visibility":"public",
"status_time":"2017-04-21T02:34:24Z",
"console_id":"qingcloud",
"name":"QingCloud 1.0 - ZooKeeper 3.4.9"
}
],
"ret_code":0
}