功能介紹
該接口為擴展接口,主要用于 鏡像 共享時用戶將多個鏡像共享給多個用戶。
該接口為異步接口,返回job_id說明任務(wù)下發(fā)成功,查詢異步任務(wù)狀態(tài),如果是success說明任務(wù)執(zhí)行成功,如果是failed說明任務(wù)執(zhí)行失敗。如何查詢異步任務(wù),請參見異步任務(wù)查詢。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v1/cloudimages/members
請求消息
- 請求參數(shù)
參數(shù)
是否必選
參數(shù)類型
描述
images
是
Array of strings
鏡像ID列表
projects
是
Array of strings
項目ID列表
請求示例
批量添加鏡像成員,其中,鏡像ID為“d164b5df-1bc3-4c3f-893e-3e471fd16e64”、“0b680482-acaa-4045-b14c-9a8c7dfe9c70”,項目ID為"9c61004714024f9586705d090530f9fa", "edc89b490d7d4392898e19b2deb34797"。
POST https://{Endpoint}/v1/cloudimages/members { "images": [ "d164b5df-1bc3-4c3f-893e-3e471fd16e64", "0b680482-acaa-4045-b14c-9a8c7dfe9c70" ], "projects": [ "9c61004714024f9586705d090530f9fa", "edc89b490d7d4392898e19b2deb34797" ] } |
響應(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ù)不可用。
