文档首页/智能边缘平台 IEF/API参考/API/应用模板管理/查询应用模板列表 - ListApps
更新时间：2025-11-18 GMT+08:00
查看PDF
分享

查询应用模板列表 - ListApps

功能介绍

该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"
                }
            ]
        }
    ]
}

错误码

请参见错误码。

父主题：应用模板管理