更新时间:2026-01-09 GMT+08:00

查询插件版本号

功能介绍

查询插件版本号

调用方法

请参见如何调用API。

URI

GET /v1/{domain_id}/agent-plugin/all-version

表1 路径参数

参数

是否必选

参数类型

描述

domain_id

是

String

参数解释:

租户ID,用户的domainId。

约束限制:

不涉及。

取值范围:

32位字符,由数字和字母组成。

默认取值:

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

plugin_name

是

String

参数解释:

扩展插件名称。

约束限制:

仅支持输入大小写英文字母、数字、'-'、'_'。

取值范围:

1到50位字符。

默认取值:

不涉及。

offset

是

String

参数解释:

偏移量,表示从此偏移量开始查询需配合limit一起使用。

约束限制:

不涉及。

取值范围:

offset大于等于0。

默认取值:

不涉及。

limit

是

String

参数解释:

每次查询的条目数量。

约束限制:

不涉及。

取值范围:

1到100。

默认取值:

不涉及。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

offset

Integer

参数解释:

偏移量,表示从此偏移量开始查询。

取值范围:

offset大于等于0。

limit

Integer

参数解释:

每次查询的条目数量。

取值范围:

大于等于0。

total

Integer

参数解释:

本次查询的静态规则总数。

取值范围:

不涉及。

data

Array of strings

参数解释:

结果集。

取值范围:

不涉及。

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释:

错误信息。

取值范围:

不涉及。

error_code

String

参数解释:

错误码。

取值范围:

不涉及。

请求示例

GET https://{endpoint}/v1/ce8df55870164338a72d7e828a966a2a/agent-plugin/all-version?plugin_name=apie_test&offset=0&limit=999

响应示例

状态码:200

OK

{
  "offset" : 0,
  "limit" : 10,
  "total" : 2,
  "data" : [ "0.0.2", "0.0.1" ]
}

状态码

状态码

描述

200

OK

400

Bad request

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码。