更新时间:2024-04-22 GMT+08:00

查询应用模板列表

功能介绍

该API用于查询应用模板列表。

URI

GET /v2/{project_id}/edgemgr/apps?{name=xxx,limit=xxx,offset=xxx,visibility=xxx,alias=xxx}

表1 Path参数

名称

是否必选

说明

project_id

项目ID,获取方法请参见获取项目ID

表2 查询参数

名称

是否必选

参数类型

说明

name

String

应用模板名称,模糊匹配

limit

String

每页显示的条目数量,取值范围1~1000,默认为1000

offset

String

查询的起始位置,取值范围为非负整数,默认为0

alias

String

通过别名过滤,模糊匹配

visibility

String

  • public:公共模板
  • private:用户创建的应用模板,默认
  • shared:第三方应用,其他用户共享类型的模板(保留,未实现)
  • 如果不携带任何检索参数,将返回该租户的所有应用信息。
  • 可以同时携带多个检索参数,同时生效。

请求消息

表3 请求Header参数

参数

是否必选

类型

描述

Content-Type

String

消息体的类型(格式)

推荐您使用默认值application/json。

X-Auth-Token

String

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

ief-instance-id

String

铂金版实例ID,专业版实例为空值

响应消息

响应参数

表4 响应Body参数

名称

参数类型

说明

apps

Array of 表5 objects

应用模板列表

count

Integer

满足条件的应用模板个数

表5 app

名称

参数类型

说明

id

String

应用模板ID

name

String

应用模板名称

description

String

应用模板描述

created_at

String

创建时间

updated_at

String

更新时间

project_id

String

项目ID

visibility

String

模板类型

app_versions

表17 object

应用版本信息

alias

String

应用模板别名

icon_url

String

应用图标存储url地址,最大长度2083

响应示例
{
    "app": [{
        "name": "test",
        "created_at": "2018-05-25T03:26:33",
        "updated_at": "2018-05-25T03:29:48",
        "visibility": "private",
        "alias": "边缘文字识别",
        "icon_url": null,
        "project_id": "{project_id}",
        "id": "2873e595-a55c-4d55-aa8f-eefcbd2b5027",
        "description": "This is a test.",
            "app_versions": [
                {
                    "envs": [],
                    "created_at": "2018-05-23T03:58:41",
                    "args": [],
                    "updated_at": null,
                    "cpu": 0.01,
                    "version": "1.0.0",
                    "image_url": "",
                    "volumes": [],
                    "memory": 1,                    "configs": {
                        "host_network": true,
                        "privileged": false
                    },
                    "project_id": "{project_id}",
                    "id": "6670f491-72d9-46e8-85f3-3a480b636205"
                }
            ]
        }
    ]
}

错误码

请参见错误码