批量添加镜像成员

功能介绍

该接口为扩展接口，主要用于镜像共享时用户将多个镜像共享给多个用户。

该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请参见异步任务查询。

华为云不再提供Windows操作系统类型的镜像，该接口不再支持Windows镜像的共享。

URI

POST /v1/cloudimages/members

请求消息

• 请求参数

  参数	是否必选	参数类型	描述
  images	是	Array of strings	镜像ID列表
  projects	是	Array of strings	项目ID列表

请求示例

批量添加镜像成员，其中，镜像ID为“d164b5df-1bc3-4c3f-893e-3e471fd16e64”、“0b680482-acaa-4045-b14c-9a8c7dfe9c70”，项目ID为"9c61004714024f9586705d090530f9fa", "edc89b490d7d4392898e19b2deb34797"。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

POST https://{Endpoint}/v1/cloudimages/members
{
    "images": [
        "d164b5df-1bc3-4c3f-893e-3e471fd16e64",
        "0b680482-acaa-4045-b14c-9a8c7dfe9c70"
    ],
    "projects": [
        "9c61004714024f9586705d090530f9fa",
        "edc89b490d7d4392898e19b2deb34797"
    ]
}

响应消息

• 响应参数

  参数	参数类型	描述
  job_id	String	异步任务ID。 详情请参见异步任务查询。

• 响应样例

  STATUS CODE 200

  1 2 3

  { "job_id": "edc89b490d7d4392898e19b2deb34797" }

返回值

• 正常

  200

• 异常

  返回值	说明
  400 Bad Request	请求错误，具体返回错误码请参错误码。
  401 Unauthorized	鉴权失败。
  403 Forbidden	没有操作权限。
  404 Not Found	找不到资源。
  500 Internal Server Error	服务内部错误。
  503 Service Unavailable	服务不可用。