功能介紹
推送文件至共享存儲目錄中，該功能僅在支持共享存儲的 云手機(jī) 規(guī)格上可實現(xiàn)。接口調(diào)用前請先確保已完成CPH服務(wù)操作OBS桶的委托授權(quán)。委托CPH操作OBS桶請參見委托CPH操作OBS桶。
調(diào)試
您可以在API Explorer中調(diào)試該接口，支持自動認(rèn)證鑒權(quán)。API Explorer可以自動生成SDK代碼示例，并提供SDK代碼示例調(diào)試功能。
URI
POST /v1/{project_id}/cloud-phone/phones/share-files
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
項目id。 |
請求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用戶Token。 通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲?。憫?yīng)消息頭中X-Subject-Token的值）。 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
bucket_name |
是 |
String |
合法的OBS桶名，3-63個字符，只能由小寫字母、數(shù)字、中劃線（-）和小數(shù)點組成。僅推送共享存儲接口使用。 |
|
object_path |
是 |
String |
合法的OBS對象路徑，最大長度1024字符。僅支持大小寫字母、數(shù)字、小數(shù)點（.）、斜線（/）、中劃線（-）、下劃線（_）、加號（+）、井號（#）、等號等這些字符。推送的文件只支持tar文件類型。推送時，按tar文件解壓后的文件目錄結(jié)構(gòu)推送到手機(jī)。當(dāng)前只支持/data和/cache目錄推送。僅推送共享存儲接口使用。 |
|
server_ids |
是 |
Array of strings |
云手機(jī)服務(wù)器ID列表。 |
響應(yīng)參數(shù)
狀態(tài)碼： 200
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
request_id |
String |
請求的唯一標(biāo)識ID。 |
|
jobs |
任務(wù)列表。 |
請求示例
將共享存儲文件推送到服務(wù)器列表中的服務(wù)器上，文件來自于obs桶
POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/share-files
{
"bucket_name" : "bucketA",
"object_path" : "my_apps/test.tar",
"server_ids" : [ "1234567b8bab40ffb711234cb80d0234", "1678567b8bab40f93711234cb80d0764" ]
}
響應(yīng)示例
狀態(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 |
錯誤碼
請參見錯誤碼。
