功能介紹
該接口為擴(kuò)展接口，主要用于用戶(hù)將一個(gè)已有 鏡像 復(fù)制為另一個(gè)鏡像。復(fù)制鏡像時(shí)，可以更改鏡像的加密等屬性，以滿(mǎn)足不同的場(chǎng)景。
該接口為異步接口，返回job_id說(shuō)明任務(wù)下發(fā)成功，查詢(xún)異步任務(wù)狀態(tài)，如果是success說(shuō)明任務(wù)執(zhí)行成功，如果是failed說(shuō)明任務(wù)執(zhí)行失敗。如何查詢(xún)異步任務(wù)，請(qǐng)參見(jiàn)異步任務(wù)查詢(xún)。
約束與限制
- 整機(jī)鏡像不支持區(qū)域內(nèi)復(fù)制。
- 使用ISO文件創(chuàng)建的私有鏡像不支持區(qū)域內(nèi)復(fù)制。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v1/cloudimages/{image_id}/copy
|
參數(shù) |
是否必選 |
參數(shù)類(lèi)型 |
描述 |
|---|---|---|---|
|
image_id |
是 |
String |
鏡像ID。 如何獲取鏡像ID，請(qǐng)參見(jiàn)查詢(xún)鏡像列表。 |
請(qǐng)求消息
- 請(qǐng)求參數(shù)
參數(shù)
是否必選
參數(shù)類(lèi)型
描述
name
是
String
鏡像名稱(chēng)。name參數(shù)說(shuō)明請(qǐng)參考鏡像屬性。
description
否
String
鏡像描述信息。_description參數(shù)說(shuō)明請(qǐng)參考鏡像屬性。支持字母、數(shù)字、中文等，不支持回車(chē)、<、>，長(zhǎng)度不能超過(guò)1024個(gè)字符。默認(rèn)為空。
cmk_id
否
String
加密密鑰。默認(rèn)為空。
enterprise_project_id
否
String
表示當(dāng)前鏡像所屬的企業(yè)項(xiàng)目。
- 取值為0或無(wú)該值，表示屬于default企業(yè)項(xiàng)目。
- 取值為UUID，表示屬于該UUID對(duì)應(yīng)的企業(yè)項(xiàng)目。
關(guān)于企業(yè)項(xiàng)目ID的獲取及企業(yè)項(xiàng)目特性的詳細(xì)信息，請(qǐng)參考“企業(yè)中心總覽”。
請(qǐng)求示例
Region內(nèi)復(fù)制鏡像，其中，鏡像名稱(chēng)為“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ù)類(lèi)型
描述
job_id
String
異步任務(wù)ID。
詳情請(qǐng)參見(jiàn)異步任務(wù)查詢(xún)。
- 響應(yīng)樣例
STATUS CODE 200
{ "job_id": "edc89b490d7d4392898e19b2deb34797" }
返回值
- 正常
- 異常
返回值
說(shuō)明
400 Bad Request
請(qǐng)求錯(cuò)誤，具體返回錯(cuò)誤碼請(qǐng)參錯(cuò)誤碼。
401 Unauthorized
鑒權(quán)失敗。
403 Forbidden
沒(méi)有操作權(quán)限。
404 Not Found
找不到資源。
500 Internal Server Error
服務(wù)內(nèi)部錯(cuò)誤。
503 Service Unavailable
服務(wù)不可用。
