功能介紹
在 云手機(jī) 中執(zhí)行shell命令。該接口為異步接口。
-
管理面性能有限，對(duì)相同服務(wù)器批量執(zhí)行的ADB命令，將會(huì)阻塞云手機(jī)其他任務(wù)執(zhí)行。
調(diào)試
您可以在API Explorer中調(diào)試該接口，支持自動(dòng)認(rèn)證鑒權(quán)。API Explorer可以自動(dòng)生成SDK代碼示例，并提供SDK代碼示例調(diào)試功能。
URI
POST /v1/{project_id}/cloud-phone/phones/commands
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
項(xiàng)目id。 |
請(qǐng)求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用戶Token。 通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲?。憫?yīng)消息頭中X-Subject-Token的值）。 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
command |
是 |
String |
ADB命令，固定填寫shell。 |
|
content |
是 |
String |
待執(zhí)行的命令。 最大長度為1024字節(jié)，只支持大小寫字母、數(shù)字、下劃線（_）、點(diǎn)（.）、斜線（/）、冒號(hào)（:）、中劃線（-）。 |
|
phone_ids |
否 |
Array of strings |
云手機(jī)ID列表。 server_ids參數(shù)不存在時(shí)必選，同時(shí)存在只處理phone_ids。 |
|
server_ids |
否 |
Array of strings |
云手機(jī)服務(wù)器ID列表。 phone_ids參數(shù)不存在時(shí)必選，同時(shí)存在只處理phone_ids。 |
響應(yīng)參數(shù)
狀態(tài)碼： 200
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
request_id |
String |
請(qǐng)求的唯一標(biāo)識(shí)ID。 |
|
jobs |
任務(wù)列表。 |
請(qǐng)求示例
向手機(jī)列表中的手機(jī)異步執(zhí)行shell命令，命令為ls -l /system
POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/commands
{
"command" : "shell",
"content" : "ls -l /system",
"phone_ids" : [ "1234567b8bab40ffb711234cb80d0234", "1678567b8bab40f93711234cb80d0764" ]
}
響應(yīng)示例
狀態(tài)碼： 200
OK
{
"request_id" : "6837531fd3f54550927b930180a706bf",
"jobs" : [ {
"phone_id" : "1234567b8bab40ffb711234cb80d0234",
"job_id" : "1564567b8bab40f34711234cb80d0123"
}, {
"phone_id" : "1678567b8bab40f93711234cb80d0764",
"job_id" : "1564567b8bab40f34711234cb80d5678"
} ]
}
狀態(tài)碼
|
狀態(tài)碼 |
描述 |
|---|---|
|
200 |
OK |
錯(cuò)誤碼
請(qǐng)參見錯(cuò)誤碼。
