功能介紹
該接口為擴展接口，主要用于用戶接受或者拒絕多個共享 鏡像 時批量更新鏡像成員的狀態(tài)。
該接口為異步接口，返回job_id說明任務下發(fā)成功，查詢異步任務狀態(tài)，如果是success說明任務執(zhí)行成功，如果是failed說明任務執(zhí)行失敗。如何查詢異步任務，請參見異步任務查詢。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
PUT /v1/cloudimages/members
請求消息
請求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
images |
是 |
Array of strings |
鏡像ID列表。 |
|
project_id |
是 |
String |
項目ID。 |
|
status |
是 |
String |
鏡像成員的狀態(tài)。 取值如下：
|
|
vault_id |
否 |
String |
存儲庫ID。 如果是通過CBR創(chuàng)建的整機鏡像，則在接受該共享鏡像時，為必選參數(shù)，需傳入該值。 |
請求示例
- 批量更新鏡像成員狀態(tài)，其中，鏡像狀態(tài)為“接受共享鏡像”。
PUT https://{Endpoint}/v1/cloudimages/members { "images": [ "d164b5df-1bc3-4c3f-893e-3e471fd16e64", "0b680482-acaa-4045-b14c-9a8c7dfe9c70" ], "project_id": "edc89b490d7d4392898e19b2deb34797", "status": "accepted" }
- 批量更新通過CBR創(chuàng)建的整機鏡像成員狀態(tài)，其中，鏡像狀態(tài)為“接受共享鏡像”，存儲庫ID為“d14r5tef-1bc3-4c4f-823e-3e471rg65e65”
PUT https://{Endpoint}/v1/cloudimages/members { "images": [ "d164b5df-1bc3-4c3f-893e-3e471fd16e64", "0b680482-acaa-4045-b14c-9a8c7dfe9c70" ], "project_id": "edc89b490d7d4392898e19b2deb34797", "status": "accepted", "vault_id": "d14r5tef-1bc3-4c4f-823e-3e471rg65e65" }
響應消息
- 響應參數(shù)
參數(shù)
參數(shù)類型
描述
job_id
String
異步任務ID。
詳情請參見異步任務查詢。
- 響應樣例
STATUS CODE 200
{ "job_id": "edc89b490d7d4392898e19b2deb34797" }
返回值
- 正常
- 異常
返回值
說明
400 Bad Request
請求錯誤，具體返回錯誤碼請參錯誤碼。
401 Unauthorized
鑒權失敗。
403 Forbidden
沒有操作權限。
404 Not Found
找不到資源。
500 Internal Server Error
服務內(nèi)部錯誤。
503 Service Unavailable
服務不可用。
