功能介紹
該接口為擴展接口，用于用戶將自己的私有 鏡像 導(dǎo)出到指定的OBS桶中。
導(dǎo)出鏡像前請確保用戶已擁有 對象存儲服務(wù) 的Tenant Administrator權(quán)限。
約束與限制
- 僅支持導(dǎo)出到存儲類別為標(biāo)準(zhǔn)存儲的桶，并且桶和鏡像在同一區(qū)域。
- 如下類型的私有鏡像不允許導(dǎo)出：
- 整機鏡像
- ISO鏡像
- Windows、SUSE、Red Hat、Ubuntu、Oracle Linux公共鏡像所創(chuàng)建的私有鏡像
- 市場鏡像所創(chuàng)建的私有鏡像
- 鏡像大小必須小于1TB；大于128GB的鏡像僅支持快速導(dǎo)出。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
請求消息
- 請求參數(shù)
參數(shù)
是否必選
參數(shù)類型
描述
bucket_url
是
String
目的文件的URL，格式：:。
說明：此處的OBS桶和鏡像文件的存儲類別必須是標(biāo)準(zhǔn)存儲。
file_format
是
String
文件格式，支持qcow2、vhd、zvhd和vmdk。
is_quick_export
否
Boolean
是否使用快速導(dǎo)出，取值為true或者false。
說明：若使用快速導(dǎo)出，則無法指定file_format參數(shù)。
請求示例
導(dǎo)出鏡像，其中，鏡像文件格式為“qcow2”，目的文件的URL為“ims-image:centos7_5.qcow2”
POST https://{Endpoint}/v1/cloudimages/d164b5df-1bc3-4c3f-893e-3e471fd16e64/file { "bucket_url": "ims-image:centos7_5.qcow2", "file_format": "qcow2", "is_quick_export": false } |
響應(yīng)消息
- 響應(yīng)參數(shù)
參數(shù)
參數(shù)類型
描述
job_id
String
異步任務(wù)ID。
詳情請參見異步任務(wù)查詢。
- 響應(yīng)樣例
STATUS CODE 200
{ "job_id": "edc89b490d7d4392898e19b2deb34797" }
返回值
- 正常
- 異常
返回值
說明
400 Bad Request
請求錯誤，具體返回錯誤碼請參見錯誤碼。
401 Unauthorized
鑒權(quán)失敗。
403 Forbidden
沒有操作權(quán)限。
404 Not Found
找不到資源。
500 Internal Server Error
服務(wù)內(nèi)部錯誤。
503 Service Unavailable
服務(wù)不可用。
