查询已添加的 ADB 授权密钥列表。 ## 请求说明 * 请求方式：POST * 请求地址：https://open.volcengineapi.com?Action=ListAdbKey&Version=2025\-05\-01 ## 请求参数下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 ### Query |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |ListAdbKey |接口名称。当前 API 的名称为 `ListAdbKey`。 | |Version |String |是 |2025\-05\-01 |接口版本。当前 API 的版本为 `2025-05-01`。 | ### Body |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |ProductId |String |是 |1749281594201\*\*\* |业务 ID，管理云手机资源、开展云手机业务的标识。可登录 [云手机控制台](https://console.volcengine.com/ACEP)，在已创建的业务卡片中获取。 | |KeyId |String |否 |adbkey\-\*\*\* |用于指定要查询的 ADB 密钥 ID。 | |KeyName |String |否 |test\-adb\-key\-\*\*\* |用于指定要查询的 ADB 密钥名称。 | |AuthType |Integer |否 |1 |用于筛选 ADB 密钥的权限类型，取值：

* `1`：root。

* `2`：user。

说明

不传本参数或者参数值为空时，将查询所有权限类型的密钥。

说明

不传本参数或者参数值为空时，将查询所有权限类型的密钥。

| |MaxResults |Integer |否 |20 |分页查询时设置的每页行数。取值范围为 `1` 到 `100`，默认值为 `10`。 | |NextToken |String |否 |eyJ0YXNrS\*\*\*\*\* |分页查询标识，用于标记分页的位置。初次调用该接口时无需设置。下次查询时，取值为上一次 API 调用返回的 `NextToken` 参数值。如果 `NextToken`无效，会从第一条记录开始返回，不会产生错误。 | ## 返回参数下表仅列出本接口特有的返回参数。更多信息请参见 [返回结构](https://www.volcengine.com/docs/6394/75748#%E8%BF%94%E5%9B%9E%E7%BB%93%E6%9E%9C)。 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Row |Array of [AdbKey](https://www.volcengine.com/docs/6394/2571039#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 密钥。 | ## 请求示例 ```JSON POST https://open.volcengineapi.com?Action=ListAdbKey&Version=2025-05-01 { "ProductId": "1749281594201***", "KeyId": "adbkey-***", "KeyName": "test-adb-key-***", "AuthType": 1, "FuzzyKey": "test-adb-***", "EffectType": 1, "MaxResults": 20, "NextToken": "eyJ0YXNrS*****" } ``` ## 返回示例 ```JSON { "ResponseMetadata": { "Action": "ListAdbKey", "Region": "cn-north-1", "Service": "ACEP", "Version": "2025-05-01", "RequestId": "20230604110420****100232280022D31" }, "Result": { "Row": [ { "KeyId": "adbkey-*****", "KeyName": "test-adb-key-***", "AuthType": 1, "DeployNum": 5, "ProductId": "product-78***", "Annotation": "测试专用ADB密钥", "CreateTime": 1620000000000, "EffectType": 1, "Fingerprint": "5A:7B:9C:1D:3E:5F:7A:9B:1C:3D:5E:7F*****" } ], "NextToken": "eyJ0YXNrS*****" } } ``` ## 错误码您可访问 [公共错误码](https://www.volcengine.com/docs/6394/1134303)，获取更多错误码信息。