文档中心

云手机

ADB 管理

获取 ADB 列表 ListAdbKey

获取 ADB 列表 ListAdbKey

查询已添加的 ADB 授权密钥列表。

请求说明

请求方式：POST

请求地址：https://open.volcengineapi.com?Action=ListAdbKey&Version=2025-05-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	ListAdbKey	接口名称。当前 API 的名称为 ListAdbKey。
Version	String	是	2025-05-01	接口版本。当前 API 的版本为 2025-05-01。

Body

参数	类型	是否必选	示例值	描述
ProductId	String	是	1749281594201***	业务 ID，管理云手机资源、开展云手机业务的标识。可登录云手机控制台，在已创建的业务卡片中获取。
KeyId	String	否	adbkey-***	用于指定要查询的 ADB 密钥 ID。
KeyName	String	否	test-adb-key-***	用于指定要查询的 ADB 密钥名称。
AuthType	Integer	否	1	用于筛选 ADB 密钥的权限类型，取值： 1：root。 2：user。说明不传本参数或者参数值为空时，将查询所有权限类型的密钥。
FuzzyKey	String	否	test-adb-***	用于对 ADB 密钥的相关信息进行模糊查询。
EffectType	Integer	否	1	用于筛选 ADB 密钥的生效范围，取值： 1：业务维度。 2：实例维度。说明不传本参数或者参数值为空时，将查询所有权限类型的密钥。
MaxResults	Integer	否	20	分页查询时设置的每页行数。取值范围为 1 到 100，默认值为 10。
NextToken	String	否	eyJ0YXNrS*****	分页查询标识，用于标记分页的位置。初次调用该接口时无需设置。下次查询时，取值为上一次 API 调用返回的 NextToken 参数值。如果 NextToken无效，会从第一条记录开始返回，不会产生错误。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
Row	Array of AdbKey	-	获取到的 ADB 列表数据集。
NextToken	String	eyJ0YXNrS*****	分页查询标识，用于标记分页的位置。初次调用该接口时无需设置。下次查询时，取值为上一次 API 调用返回的 NextToken 参数值。如果 NextToken无效，会从第一条记录开始返回，不会产生错误。

AdbKey

参数	类型	示例值	描述
KeyId	String	adbkey-*****	查询的 ADB 密钥 ID。
KeyName	String	test-adb-key-***	查询的 ADB 密钥名称。
AuthType	Integer	1	ADB 密钥的权限类型，取值： 1：root 权限。 2：user 权限。
DeployNum	Long	5	该 ADB 密钥已部署的云手机实例数量。
ProductId	String	product-78***	ADB 密钥所属业务 ID。
Annotation	String	测试专用ADB密钥	ADB 密钥的备注信息，用于对该密钥进行额外说明或标记。
CreateTime	Long	1620000000000	ADB 密钥的创建时间，以 Unix 时间戳形式表示。
EffectType	Integer	1	ADB 密钥的生效范围，取值： 1：业务维度。 2：实例维度。
Fingerprint	String	5A:7B:9C:1D:3E:5F:7A:9B:1C:3D:5E:7F*****	ADB 密钥的指纹信息，用于唯一标识该 ADB 密钥。

请求示例

返回示例

错误码

您可访问公共错误码，获取更多错误码信息。

最近更新时间：2026.07.10 10:06:48

这个页面对您有帮助吗？

有用

有用

无用

无用