DescribeApps
接口描述
获取一个或多个应用的信息。
您可以根据应用 ID,名称,标签等作为过滤条件,来获取应用信息。
请求参数
参数名 | 类型 | 描述 | 是否必填 |
---|---|---|---|
app |
String |
应用 ID |
否 |
app_name |
String |
应用名称 |
否 |
category |
String |
类别,如:database、 bigdata、 container、 shield |
否 |
tags |
Array |
标签数组 |
否 |
app_type |
String |
应用类型,如:web、 image、 cluster、 license、 sass,默认 web |
否 |
verbose |
Integer |
是否返回冗长的信息,若为 1,则返回应用相关其他信息字段,默认为 0 |
否 |
search_word |
String |
关键字(匹配应用名称,描述,摘要) |
否 |
offset |
Integer |
数据偏移量,默认 0 |
否 |
limit |
Integer |
返回数据长度,默认 20,最大 100 |
否 |
sort_key |
String |
结果排序的列 |
否 |
reverse |
Integer |
是否逆序,1 为逆序,0 为正序 |
否 |
返回数据
公共参数:
名称 | 类型 | 描述 |
---|---|---|
action |
String |
响应动作 |
total_count |
Integer |
应用总数量 |
app_set |
Array |
应用集合 |
ret_code |
Integer |
执行成功与否,0 表示成功,其他值则为错误代码 |
APP 信息:
名称 | 类型 | 描述 |
---|---|---|
app_name |
String |
应用名称 |
cover_img |
String |
封面图片地址 |
app_id |
String |
应用 ID |
edition |
Object |
系列信息 |
create_time |
String |
创建时间 |
screenshots |
Array |
截图地址列表 |
category |
String |
类别 |
app_type |
String |
应用类型 |
status_time |
String |
状态时间 |
status |
String |
应用状态 |
abstraction |
String |
应用摘要 |
description |
String |
应用描述 |
tags |
Array |
标签列表 |
visibility |
String |
可见范围(公开、私有) |
icon |
String |
图表地址 |
contact |
String |
开发者联系方式 |
company_url |
String |
开发者公司主页 |
示例
请求示例:
https://api.shanhe.com/iaas/?action=DescribeApps &app=app-00r26u27 &limit=20 &app_type=cluster
返回示例:
{
"action":"DescribeAppsResponse",
"total_count":1,
"app_set":[
{
"company_url":"https://www.shanhe.com/",
"app_id":"app-00r26u27",
"edition":[
{
"edition_id":"default",
"name":"default",
"description":"default"
}
],
"create_time":"2017-04-20T13:55:32Z",
"screenshots":[
"ca-35yq08gp",
"ca-xl65n015",
"ca-he8rh81t",
"ca-mp0e587w",
"ca-qifdpo2y",
"ca-hq6ycrk9"
],
"app_name":"QingCloud MySQL Plus",
"category":"database",
"app_type":"cluster",
"screenshot_links":[
"https://jn1a.is.shanhe.com/attachment-4-appcenter/public/ca-35yq08gp",
"https://jn1a.is.shanhe.com/attachment-4-appcenter/public/ca-xl65n015",
"https://jn1a.is.shanhe.com/attachment-4-appcenter/public/ca-he8rh81t",
"https://jn1a.is.shanhe.com/attachment-4-appcenter/public/ca-mp0e587w",
"https://jn1a.is.shanhe.com/attachment-4-appcenter/public/ca-qifdpo2y",
"https://jn1a.is.shanhe.com/attachment-4-appcenter/public/ca-hq6ycrk9"
],
"status_time":"2021-12-21T16:04:39Z",
"status":"active",
"abstraction":"\u91d1\u878d\u7ea7\u5f3a\u4e00\u81f4\u6027\u3001\u4e3b\u4ece\u79d2\u7ea7\u5207\u6362\u3001\u53cc\u5f15\u64ce\u652f\u6301\u7684 MySQL \u96c6\u7fa4",
"description":"- QingCloud MySQL Plus \u662f\u91d1\u878d\u7ea7\u9ad8\u53ef\u9760\u7684 MySQL \u96c6\u7fa4\uff1b\n- \u63d0\u4f9b\u4e86 InnoDB \u548c TokuDB \u4e24\u5927\u4e8b\u52a1\u5f15\u64ce\uff1b\n- \u4e3b\u4ece\u5f00\u542f Semi-sync\uff0c\u4e25\u683c\u4fdd\u8bc1\u8282\u70b9\u95f4\u7684\u6570\u636e\u4e00\u81f4\u6027\uff1b\n- \u4f7f\u7528 Raft \u534f\u8bae\u7ba1\u7406\u96c6\u7fa4\u4e3b\u4ece\u8282\u70b9\uff0c\u6545\u969c\u65f6\u53ef\u5b9e\u73b0\u79d2\u7ea7\u4e3b\u4ece\u5207\u6362\uff0c\u4fdd\u969c\u4e1a\u52a1\u8fde\u7eed\u6027\uff1b\n- \u96c6\u7fa4\u4e3a\u4e00\u4e3b\u591a\u4ece\u67b6\u6784\uff0c\u9ed8\u8ba4\u4e24\u4e2a\u4ece\u8282\u70b9\uff0c\u6700\u5927\u652f\u6301\u516d\u4e2a\u4ece\u8282\u70b9\u3002",
"tags":[],
"icon":"ca-j0r9swvj",
"contact":"",
"cover_img":"",
"icon_link":"https://jn1a.is.shanhe.com/attachment-4-appcenter/public/ca-j0r9swvj"
}
],
"ret_code":0
}