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