华为云计算 云知识 批量添加镜像成员BatchAddMembers
批量添加镜像成员BatchAddMembers

 

功能介绍

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

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

调试

您可以在API Explorer中调试该接口。

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"。

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
    {
        "job_id": "edc89b490d7d4392898e19b2deb34797"
    }
    

返回值

  • 正常

    200

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误,具体返回错误码请参错误码

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。

上一篇:H型高性能计算型弹性云服务器规格及使用场景介绍 下一篇:为各行各业量身定做的特色OA应用来了-上

镜像服务 IMS

镜像是用于创建服务器或磁盘的模板。镜像服务提供镜像生命周期管理能力。可以通过服务器或外部文件创建系统盘镜像或数据盘镜像,也可以使用弹性云服务器或云服务器备份创建带数据盘的整机镜像。创建镜像功能免费,仅需支付使用对象存储服务或云服务器备份的费用。