華為云計算 云知識 推送共享應用PushShareApps
推送共享應用PushShareApps

 

功能介紹

推送應用tar文件至共享應用存儲目錄中,該功能僅在支持共享應用的 云手機 規(guī)格上可實現(xiàn)。接口調(diào)用前請先確保已完成CPH服務操作OBS桶的委托授權(quán)。委托CPH操作OBS桶請參見委托CPH操作OBS桶。

調(diào)試

您可以在API Explorer中調(diào)試該接口,支持自動認證鑒權(quán)。API Explorer可以自動生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。

URI

POST /v1/{project_id}/cloud-phone/phones/share-apps

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項目id。

請求參數(shù)

表2 請求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。 通過調(diào)用 IAM 服務獲取用戶Token接口獲?。憫㈩^中X-Subject-Token的值)。

表3 請求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

package_name

String

合法的應用包名。

pre_install_app

Integer

是否預裝應用。

  • 1:預裝
  • 0:不預裝;默認不預裝

bucket_name

String

合法的OBS桶名,3-63個字符,只能由小寫字母、數(shù)字、中劃線(-)和小數(shù)點組成

object_path

String

合法的OBS對象key,最大長度1024字符。僅支持大小寫字母、數(shù)字、小數(shù)點(.)、斜線(/)、中劃線(-)、下劃線(_)、加號(+)、井號(#)、等號等這些字符。 推送的文件只支持tar文件類型。推送時,按tar文件解壓后的文件目錄結(jié)構(gòu)推送到手機。

server_ids

Array of strings

云手機服務器ID列表。

響應參數(shù)

狀態(tài)碼: 200

表4 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

request_id

String

請求的唯一標識ID。

jobs

Array of ServerJob objects

任務列表。

表5 ServerJob

參數(shù)

參數(shù)類型

描述

server_id

String

云手機服務器的唯一標識ID,云手機服務器相關(guān)任務包含此字段。

job_id

String

任務的唯一標識。

error_code

String

錯誤碼。

error_msg

String

錯誤說明。

請求示例

將應用推送到服務器列表中的服務器上,應用來自于obs桶中

POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/share-apps

{
  "package_name" : "com.miniteck.miniworld",
  "bucket_name" : "bucket",
  "object_path" : "my_apps/test.tar",
  "server_ids" : [ "1234567b8bab40ffb711234cb80d0234", "1678567b8bab40f93711234cb80d0764" ]
}

響應示例

狀態(tài)碼: 200

OK

{
  "request_id" : "6837531fd3f54550927b930180a706bf",
  "jobs" : [ {
    "server_id" : "1234567b8bab40ffb711234cb80d0234",
    "job_id" : "1564567b8bab40f34711234cb80d0123"
  }, {
    "server_id" : "1678567b8bab40f93711234cb80d0764",
    "job_id" : "1564567b8bab40f34711234cb80d5678"
  } ]
}

狀態(tài)碼

狀態(tài)碼

描述

200

OK

錯誤碼

請參見錯誤碼。