批量更新镜像成员状态BatchUpdateMembers
功能介绍
该接口为扩展接口，主要用于用户接受或者拒绝多个共享 镜像 时批量更新镜像成员的状态。
该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。
调试
您可以在API Explorer中调试该接口。
URI
PUT /v1/cloudimages/members
请求消息
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
images |
是 |
Array of strings |
镜像ID列表。 |
|
project_id |
是 |
String |
项目ID。 |
|
status |
是 |
String |
镜像成员的状态。 取值如下： |
|
vault_id |
否 |
String |
存储库ID。 如果是通过CBR创建的整机镜像，则在接受该共享镜像时，为必选参数，需传入该值。 |
请求示例
- 批量更新镜像成员状态，其中，镜像状态为“接受共享镜像”。
PUT https://{Endpoint}/v1/cloudimages/members { "images": [ "d164b5df-1bc3-4c3f-893e-3e471fd16e64", "0b680482-acaa-4045-b14c-9a8c7dfe9c70" ], "project_id": "edc89b490d7d4392898e19b2deb34797", "status": "accepted" }
- 批量更新通过CBR创建的整机镜像成员状态，其中，镜像状态为“接受共享镜像”，存储库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" }
响应消息
- 响应参数
参数
参数类型
描述
job_id
String
异步任务ID。
详情请参见异步任务查询。
- 响应样例
STATUS CODE 200
{ "job_id": "edc89b490d7d4392898e19b2deb34797" }
返回值
- 正常
- 异常
返回值
说明
400 Bad Request
请求错误，具体返回错误码请参错误码。
401 Unauthorized
鉴权失败。
403 Forbidden
没有操作权限。
404 Not Found
找不到资源。
500 Internal Server Error
服务内部错误。
503 Service Unavailable
服务不可用。
