功能介紹
該接口為擴(kuò)展接口，主要用于用戶將一個已有 鏡像 復(fù)制為另一個鏡像。復(fù)制鏡像時，可以更改鏡像的加密等屬性，以滿足不同的場景。
該接口為異步接口，返回job_id說明任務(wù)下發(fā)成功，查詢異步任務(wù)狀態(tài)，如果是success說明任務(wù)執(zhí)行成功，如果是failed說明任務(wù)執(zhí)行失敗。如何查詢異步任務(wù)，請參見異步任務(wù)查詢。
約束與限制
- 整機(jī)鏡像不支持區(qū)域內(nèi)復(fù)制。
- 使用ISO文件創(chuàng)建的私有鏡像不支持區(qū)域內(nèi)復(fù)制。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
請求消息
- 請求參數(shù)
參數(shù)
是否必選
參數(shù)類型
描述
name
是
String
鏡像名稱。name參數(shù)說明請參考鏡像屬性。
description
否
String
鏡像描述信息。_description參數(shù)說明請參考鏡像屬性。支持字母、數(shù)字、中文等，不支持回車、<、>，長度不能超過1024個字符。默認(rèn)為空。
cmk_id
否
String
加密密鑰。默認(rèn)為空。
enterprise_project_id
否
String
表示當(dāng)前鏡像所屬的企業(yè)項(xiàng)目。
- 取值為0或無該值，表示屬于default企業(yè)項(xiàng)目。
- 取值為UUID，表示屬于該UUID對應(yīng)的企業(yè)項(xiàng)目。
關(guān)于企業(yè)項(xiàng)目ID的獲取及企業(yè)項(xiàng)目特性的詳細(xì)信息，請參考“企業(yè)中心總覽”。
請求示例
Region內(nèi)復(fù)制鏡像，其中，鏡像名稱為“ims_encrypted_copy3”。
POST https://{Endpoint}/v1/cloudimages/465076de-dc36-4aec-80f5-ef9d8009428f/copy { "name": "ims_encrypted_copy3", "description": "test copy", "cmk_id": "bd66288c-9081-460a-8227-4cbd0c814cb4" } |
響應(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ù)不可用。
