批量查询软件库软件
接口说明
使用 CurrentPage 与 PageSize 进行分页，NextToken 与 MaxResults 当前不生效。
SoftwareName 支持模糊查询。
返回结果中的 Versions（软件版本列表）当前不返回，如需查询软件版本请调用 ListSoftwarelibVersion 。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
csas:ListSoftwarelibSoftware |
list |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| CurrentPage |
integer |
是 |
分页查询时显示的当前页的页码。取值：1~10000。 |
1 |
| PageSize |
integer |
是 |
分页查询时设置的每页数量。取值：1~500。 |
10 |
| NextToken |
string |
否 |
查询凭证（Token）。当前接口不支持该参数，请使用 CurrentPage 与 PageSize 进行分页。 |
AAAAARbaCuN6hiD08qrLdwJ9Fh27/Jy4SXvlU9WgqeV7az+t |
| MaxResults |
integer |
否 |
每页的最大条目数。当前接口不支持该参数，请使用 CurrentPage 与 PageSize 进行分页。 |
0 |
| SoftwareName |
string |
否 |
软件名称，支持模糊查询。 |
Thunder |
| ClassifyId |
string |
否 |
软件分类 ID。取值来源： ListSoftwarelibClassify 。 |
softwarelib-classify-61b7ccc63cae**** |
| Os |
string |
否 |
软件包适用的操作系统。取值：
枚举值：
|
Windows |
| SourceType |
string |
否 |
软件来源。取值：
枚举值：
|
builtin |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
BE4FB974-11BC-5453-9BE1-1606A73EACA6 |
| TotalCount |
integer |
符合查询条件的软件总数。 |
2 |
| NextToken |
string |
查询凭证（Token）。当前接口不返回该参数。 |
FFM+3L1WZbKngBeLWcDmQrzLuGDDwAw7JA5q2AjvTSJm9WyhQ0MwJoOWpky9ZhgcWfIgtGpZ+4NQX97+EIwsqUNQ== |
| MaxResults |
integer |
每页的最大条目数。当前接口不返回该参数。 |
100 |
| DataList |
array<object> |
软件列表。 |
|
|
array<object> |
软件信息。 |
||
| SoftwareId |
string |
软件 ID。 |
softwarelib-software-1da844a39729**** |
| SoftwareName |
string |
软件名称。 |
Thunder |
| Description |
string |
软件描述。 |
This is a demo software. |
| ClassifyId |
string |
软件分类 ID。 |
softwarelib-classify-61b7ccc63cae**** |
| MatchMode |
string |
策略匹配目标类型。取值：
枚举值：
|
UserGroupAll |
| WindowsVersion |
string |
Windows 系统下最大软件版本号。 |
1.0.0 |
| MacAppleVersion |
string |
Mac(Apple)系统下最大软件版本号。 |
1.0.0 |
| MacIntelVersion |
string |
Mac(Intel)系统下最大软件版本号。 |
1.0.0 |
| DownloadTimes |
integer |
从客户端手动下载软件的次数。 |
1 |
| UserGroupIds |
array |
关联的用户组 ID 列表。 |
|
|
string |
用户组 ID。 |
usergroup-1912084bbaeb**** |
|
| DevTags |
array |
关联的终端设备 ID 列表。 |
|
|
string |
终端设备 ID。 |
4ae87d7d-5c1e-4b91-b915-df3e0d1c**** |
|
| DeviceGroupIds |
array |
关联的设备组 ID 列表。 |
|
|
string |
设备组 ID。 |
device-group-96594a7858c6**** |
|
| LogoUrl |
string |
软件 Logo 地址。 |
https://img.alicdn.com/imgextra/i4/O1CN01mXKAQX1P3a5fbS0Dp_!!6000000001785-2-tps-40-40.png |
| CheckSoftwareName |
string |
用于校验的软件名称。 |
test software |
| CheckBundleId |
string |
用于校验的软件 BundleId。 |
test software |
| Versions |
array<object> |
软件版本列表。当前接口不返回该字段，请调用 ListSoftwarelibVersion 查询软件版本。 |
|
|
object |
软件版本信息。 |
||
| VersionId |
string |
软件版本 ID。 |
softwarelib-version-21ae186e2ac9**** |
| SoftwareId |
string |
所属软件的 ID。 |
softwarelib-software-1da844a39729**** |
| Os |
string |
软件包适用的操作系统。取值：
枚举值：
|
Windows |
| Version |
string |
软件版本号。 |
1.0.0 |
| SoftwareUrl |
string |
软件包下载地址。 |
https://****.com/**** |
| Md5 |
string |
软件包的 MD5 值。 |
0b5824cdd509d3ed560e2d20d29a1bcb |
| SoftwarePkgName |
string |
软件包名称。 |
test softwarename |
| SoftwarePkgSize |
integer |
软件包大小。 |
100 |
| Status |
string |
版本发布状态。取值：
枚举值：
|
published |
| DownloadTimes |
integer |
从客户端下载软件的次数。 |
1 |
| CreateTime |
string |
软件版本创建时间。 |
2026-08-05 18:03:58 |
| ModifyTime |
string |
软件版本最后修改时间。 |
2026-08-05 18:03:58 |
| PublisherType |
string |
软件发布者类型。取值：
枚举值：
|
local |
| CreateTime |
string |
软件创建时间，秒级 Unix 时间戳。 |
1781748302 |
| SourceType |
string |
软件来源。取值：
枚举值：
|
custom |
| HasNewVersion |
boolean |
该软件下是否有新版本。 |
false |
| SourceRemoved |
boolean |
内置库来源是否删除。 |
false |
| BuiltinSoftwareId |
string |
关联的内置软件 ID。 |
softwarelib-software-1da844a39729**** |
| OfficialDownloadUrl |
string |
软件官方下载地址。 |
http://xxx.com/**** |
| RunAsAccount |
string |
执行账号（仅支持 Windows 系统）。 |
admin |
示例
正常返回示例
JSON格式
{
"RequestId": "BE4FB974-11BC-5453-9BE1-1606A73EACA6",
"TotalCount": 2,
"NextToken": "FFM+3L1WZbKngBeLWcDmQrzLuGDDwAw7JA5q2AjvTSJm9WyhQ0MwJoOWpky9ZhgcWfIgtGpZ+4NQX97+EIwsqUNQ==",
"MaxResults": 100,
"DataList": [
{
"SoftwareId": "softwarelib-software-1da844a39729****",
"SoftwareName": "Thunder",
"Description": "This is a demo software.",
"ClassifyId": "softwarelib-classify-61b7ccc63cae****",
"MatchMode": "UserGroupAll",
"WindowsVersion": "1.0.0",
"MacAppleVersion": "1.0.0",
"MacIntelVersion": "1.0.0",
"DownloadTimes": 1,
"UserGroupIds": [
"usergroup-1912084bbaeb****"
],
"DevTags": [
"4ae87d7d-5c1e-4b91-b915-df3e0d1c****"
],
"DeviceGroupIds": [
"device-group-96594a7858c6****"
],
"LogoUrl": "https://img.alicdn.com/imgextra/i4/O1CN01mXKAQX1P3a5fbS0Dp_!!6000000001785-2-tps-40-40.png",
"CheckSoftwareName": "test software",
"CheckBundleId": "test software",
"Versions": [
{
"VersionId": "softwarelib-version-21ae186e2ac9****",
"SoftwareId": "softwarelib-software-1da844a39729****",
"Os": "Windows",
"Version": "1.0.0",
"SoftwareUrl": "https://****.com/****",
"Md5": "0b5824cdd509d3ed560e2d20d29a1bcb",
"SoftwarePkgName": "test softwarename",
"SoftwarePkgSize": 100,
"Status": "published",
"DownloadTimes": 1,
"CreateTime": "2026-08-05 18:03:58",
"ModifyTime": "2026-08-05 18:03:58",
"PublisherType": "local"
}
],
"CreateTime": "1781748302",
"SourceType": "custom",
"HasNewVersion": false,
"SourceRemoved": false,
"BuiltinSoftwareId": "softwarelib-software-1da844a39729****",
"OfficialDownloadUrl": "http://xxx.com/****",
"RunAsAccount": "admin"
}
]
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。