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

* `1`：root，以最高系统权限连接设备，执行系统级操作（如修改系统文件、访问受保护目录等）。

* `2`：user，以普通用户权限连接设备，执行常规调试操作。 | |PublicKey |String |是 |AAAAB3NzaC1yc2EA\*\*\* |用于 ADB 密钥认证的公钥内容，可以通过该公钥进行云手机实例的 ADB 连接身份验证。 | |EffectType |Integer |否 |1 |ADB 密钥的生效范围，为空表示添加所有生效范围的密钥，取值：

* `1`：（默认值）业务维度。

* `2`：实例维度。 | |Annotation |String |否 |测试专用 ADB 密钥 |ADB 密钥的备注信息，用于对该密钥进行额外说明或标记。不超过 256 个字符。 | ## 返回参数下表仅列出本接口特有的返回参数。更多信息请参见 [返回结构](https://www.volcengine.com/docs/6394/75748#%E8%BF%94%E5%9B%9E%E7%BB%93%E6%9E%9C)。 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |KeyId |String |adbkey\-7890\*\*\* |添加成功的 ADB 密钥 ID。 | ## 请求示例 ```JSON POST https://open.volcengineapi.com?Action=AddAdbKey&Version=2025-05-01 { "ProductId": "1749281594201***", "KeyName": "test-adb-key-***", "AuthType": 1, "PublicKey": "AAAAB3NzaC1yc2EA***", "EffectType": 1, "Annotation": "测试专用 ADB 密钥" } ``` ## 返回示例 ```JSON { "ResponseMetadata": { "Action": "AddAdbKey", "Region": "cn-north-1", "Service": "ACEP", "Version": "2025-05-01", "RequestId": "20230604110420****100232280022D31" }, "Result": { "KeyId": "adbkey-7890***" } } ``` ## 错误码您可访问 [公共错误码](https://www.volcengine.com/docs/6394/1134303)，获取更多错误码信息。