文档首页/ 应用平台 AppStage/ API参考/ API/ 应用中心/ 分页查询MCP列表（AK/SK认证）
更新时间：2025-08-04 GMT+08:00
查看PDF
分享

分页查询MCP列表（AK/SK认证）

功能介绍

通过传入的limit参数查询资产中心MCP列表。

  • 传输limit参数，则表示需要分页。查询首页时，marker为null。

  • 未传输limit参数，则查询全部资产。

调用方法

请参见如何调用API。

URI

GET https://aiae.appstage.myhuaweicloud.com/v1/routes/open/user/mcp/list

表1 Query参数

参数

是否必选

参数类型

描述

limit

否

String

参数解释：

分页条数。

  • 传输limit参数，则表示需要分页。查询首页时，marker为null。

  • 未传输limit参数，则查询全部资产。

约束限制：

不涉及。

取值范围：

数字，最大1000。

默认取值：

不涉及。

marker

否

String

参数解释：

页码。查询首页时，marker为null。

约束限制：

不涉及。

取值范围：

数字。最大100000。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-User-Info

是

String

参数解释：

鉴权信息。示例：{"iam_user_info":{"domain_id":"087708f382d2471bbd4649a97346530d","domain_name":"","user_id":"fb55057381ff41748cbdbc3c9ea8df0a","user_id_type":"0","user_name":"","project_id":"","project_name":""}}。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

data

Array of data objects

参数解释：

不同响应类型的响应体中包含不同的参数，见示例。

取值范围：

不涉及。

page_info

page_info object

参数解释：

不同响应类型的响应体中包含不同的参数，见示例。

取值范围：

不涉及。
表4 data

参数

参数类型

描述

name

String

参数解释：

agent名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

asset_id

String

参数解释：

资产的唯一ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

asset_type_display_name

String

参数解释：

资产类型的国际化展示名。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

asset_type_name

String

参数解释：

资产类型名称，对应URL请求参数中的{assetType}。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

description

String

参数解释：

资产相关描述。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

created_by

String

参数解释：

资产创建人。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

create_time

Number

参数解释：

资产创建时间，13位毫秒级时间戳。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

updated_by

String

参数解释：

资产的最新更新人，新创建的Agent最新更新人默认为资产创建人。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

update_time

Number

参数解释：

资产的最近一次更新时间，13位毫秒级时间戳。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

properties

McpProperties object

MCP属性对象。
表5 McpProperties

参数

参数类型

描述

fc_instance_status

String

参数解释：

托管的MPC服务函数实例在FG侧的状态。

取值范围：

枚举值：

  • deletionFail：失败

  • success：成功

view_times

Number

参数解释：

查看次数。

取值范围：

不涉及。

install_times

Number

参数解释：

安装次数。

取值范围：

不涉及。

icon

String

参数解释：

图标信息。

取值范围：

不涉及。

deploy_type

String

参数解释：

MCP安装类型。

取值范围：

枚举值：

  • NPX：JS类型。

  • UVX：python类型。

  • SSE：远程连接类型。

type

String

参数解释：

类型。

取值范围：

枚举值：

  • inner：内置

  • private：个人

fc_instance_id

String

参数解释：

托管的MPC服务函数实例在FG侧的ID。

取值范围：

不涉及。
表6 page_info

参数

参数类型

描述

next_marker

String

参数解释：

下一页标记，用于下次调用请求入参中的marker使用，标识要翻到本次请求的下一页。如果是末页，此项为null。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

previous_marker

String

参数解释：

前一页标记，用于下次调用请求入参中的marker使用，标识要翻到本次请求的前一页。如果是首页，此项为null。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

current_count

Number

参数解释：

当前页的元素实际个数。

例如，单页个数为10，元素总数为93，那前9页的current_count为10，末页的current_count为3。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

状态码：400

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

状态码：500

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

请求示例

无

响应示例

状态码：200

  • 表示接口调用成功，正常响应。- 响应采用Server-Sent Events（SSE）机制进行流式输出，数据内容用data字段表示，示例如下：data: message。

data字段并不是一个JSON数据。此外，还可以有冒号开头的行，表示注释，通常可忽略。 
{
  "data" : [ {
    "name" : "WeLink考勤服务_B4",
    "asset_id" : "2c307014a85a4c2f84e2923613bc3f7b",
    "asset_type_name" : "ai-mcp",
    "asset_type_display_name" : "资产中心mcp",
    "description" : "我的服务：\n1. 请假申请\n2. 出差申请\n3. 加班申请\n4. 补卡申请\n5. 外出申请\n6. 查询我的待处理考勤申请",
    "created_by" : "fb55057381ff41748cbdbc3c9ea8df0a",
    "create_time" : 1751105847000,
    "updated_by" : "fb55057381ff41748cbdbc3c9ea8df0a",
    "update_time" : 1751105848000,
    "properties" : {
      "name_en" : "",
      "description_en" : "",
      "deploy_type" : "sse",
      "fc_instance_status" : "success",
      "view_times" : 0,
      "install_times" : 0
    }
  } ],
  "page_info" : {
    "next_marker" : "1",
    "previous_marker" : null,
    "current_count" : 10
  }
}

状态码：400

缺少请求体。

{
  "error_code" : "AIAE.00001400",
  "error_msg" : "Request body is missing"
}

状态码：500

服务器内部错误或三方服务器内部错误。

[ {
  "error_code" : "AIAE.00001500",
  "error_msg" : "Internal Server Error."
}, {
  "error_code" : "AIAE.00001500",
  "error_msg" : "Internal Server Error2."
} ]

状态码

状态码

描述

200

  • 表示接口调用成功，正常响应。- 响应采用Server-Sent Events（SSE）机制进行流式输出，数据内容用data字段表示，示例如下：data: message。

说明：
data字段并不是一个JSON数据。此外，还可以有冒号开头的行，表示注释，通常可忽略。

400

缺少请求体。

500

服务器内部错误或三方服务器内部错误。

错误码

请参见错误码。

父主题： 应用中心

相关文档