查询服务器已安装共享应用列表 - ListShareAppsSnapshot

功能介绍

该接口查询云手机服务器上最新采集的已安装的共享应用快照，采集在云手机服务器上定时每两小时执行一次。

注意存在以下限制：

1.云手机服务器安装不同的共享应用数量不能超过10000个，超过限制不会采集该服务器数据。

2.推送安装的共享应用包名只包含大小写字母、数字、下划线、点，不能以数字和下划线开头，点不能作为结尾且包名中至少有一个点，点后必须以字母开头，长度不超过128。不符合该限制的共享应用包名不会采集。

3.推送安装的共享应用版本只包含字母、数字、连字符、下划线、点，无空格，不能以连字符、点开头，长度不超过32。不符合该限制的共享应用包版本不会采集。

4.同一个服务器上同一个已安装的共享应用版本建议不要超过60个。超过会影响该应用的采集。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。

如果使用身份策略授权，需具备如下身份策略权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
cph:servers:listShareAppsSnapshot	List	server *	g:EnterpriseProjectId g:ResourceTag/<tag-key>	-	-

URI

GET /v1/{project_id}/servers/{server_id}/share-apps-snapshot

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目id。
server_id	是	String	云手机服务器的唯一标识。

表2 Query参数
参数	是否必选	参数类型	描述
limit	否	Integer	每页返回的资源个数。取值范围：1~500（默认值为100）。
marker	否	String	分页标记。
package_name	否	String	应用包名称，只包含大小写字母、数字、下划线、点，不能以数字和下划线开头，点不能作为结尾且包名中至少有一个点，长度不超过128

请求参数

无

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
request_id	String	请求的唯一标识ID。
collect_time	String	采集时间。
share_apps	Array of share_apps objects	采集的共享应用信息
page_info	page_info object	页标记。

表4 share_apps
参数	参数类型	描述
package_name	String	应用包名
versions	Array of strings	应用对应的版本号列表

表5 page_info
参数	参数类型	描述
next_marker	String	返回下一页查询地址。

请求示例

无

响应示例

状态码：200

{
  "page_info" : {
    "next_marker" : "Y29tLmFpcWl5aS52aWRlbw"
  },
  "request_id" : "9db75f108877fbfbfaf9d41943286759",
  "collect_time" : "2026-03-11T06:00:00Z",
  "share_apps" : [ {
    "package_name" : "com.aiqiyi.video",
    "versions" : [ "1773113892" ]
  } ]
}