接口說明
推送文件到 云手機(jī) 文件系統(tǒng)中。系統(tǒng)會將所指定的文件下載解壓后,將解壓后的內(nèi)容全部推送到云手機(jī)的根目錄下。只支持指定tar格式的文件進(jìn)行推送,您需要將tar文件提前上傳至您的OBS桶中。
URL
POST https://cph.cn-north-4.myhuaweicloud.com/v1/{project_id}/cloud-phone/phones/commands
請求參數(shù)
| 名稱 | 類型 | IN | 必選 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用戶Token。 通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲取(響應(yīng)消息頭中X-Subject-Token的值)。 |
|
project_id
|
string | path | 是 |
項(xiàng)目id。 |
Body參數(shù)
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
command
|
string | 是 |
推送文件固定填寫push。 |
|
content
|
string | 是 |
推送的文件只支持tar文件類型,指定OBS桶中的tar文件。 最大長度為1024字節(jié),只支持大小寫字母、數(shù)字、下劃線(_)、點(diǎn)(.)、斜線(/)、冒號(:)、中劃線(-)。 |
|
phone_ids
|
Array of strings | 否 |
云手機(jī)ID列表。 server_ids參數(shù)不存在時必選,同時存在只處理phone_ids。 |
|
server_ids
|
Array of strings | 否 |
云手機(jī)服務(wù)器ID列表。 phone_ids參數(shù)不存在時必選,同時存在只處理phone_ids。 |
返回參數(shù)
返回碼: 200
OK
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
request_id
|
string | 否 |
請求的唯一標(biāo)識ID。 |
|
jobs
|
Array of PhoneJob objects | 否 |
任務(wù)列表。 |
200 jobs
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
phone_id
|
string | 否 |
云手機(jī)的唯一標(biāo)識ID,云手機(jī)相關(guān)任務(wù)包含此字段。 |
|
job_id
|
string | 否 |
任務(wù)的唯一標(biāo)識。 |
|
error_code
|
string | 否 |
錯誤碼。 |
|
error_msg
|
string | 否 |
錯誤說明。 |
請求示例
示例 1
推送文件到云手機(jī)文件系統(tǒng)中。
"POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/commands"
{ "command": "push", "content": "obs://push-bucket/my_apps/test.tar", "phone_ids": [ "1234567b8bab40ffb711234cb80d0234", "1678567b8bab40f93711234cb80d0764" ] }
返回示例
返回碼：200
OK
示例 1
{
"request_id": "6837531fd3f54550927b930180a706bf",
"jobs": [
{
"phone_id": "1234567b8bab40ffb711234cb80d0234",
"job_id": "1564567b8bab40f34711234cb80d0123"
},
{
"phone_id": "1678567b8bab40f93711234cb80d0764",
"job_id": "1564567b8bab40f34711234cb80d5678"
}
]
}
"request_id": "6837531fd3f54550927b930180a706bf",
"jobs": [
{
"phone_id": "1234567b8bab40ffb711234cb80d0234",
"job_id": "1564567b8bab40f34711234cb80d0123"
},
{
"phone_id": "1678567b8bab40f93711234cb80d0764",
"job_id": "1564567b8bab40f34711234cb80d5678"
}
]
}
SDK
點(diǎn)擊 云手機(jī) (CPH) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認(rèn)證方式等在SDK文檔中對應(yīng)語言類型的【使用】目錄下。
錯誤碼
請參考 錯誤碼說明。
