文档首页/ 镜像服务 IMS/ API参考/ API/ 镜像共享/ 批量删除镜像成员
更新时间：2025-09-23 GMT+08:00
查看PDF
分享

批量删除镜像成员

功能介绍

该接口为扩展接口，主要用于取消镜像共享。

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

调试

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

URI

DELETE /v1/cloudimages/members

请求消息

请求参数

参数

是否必选

参数类型

描述

images

是

Array of strings

镜像ID列表

projects

是

Array of strings

项目ID列表

domains

否

Array of strings

账号ID列表

organizations

否

Array of strings

组织URN列表

projects、domains和organizations参数字段必须存在其中一个 。

请求示例

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

DELETE https://{Endpoint}/v1/cloudimages/members
{
    "images": [
        "d164b5df-1bc3-4c3f-893e-3e471fd16e64",
        "0b680482-acaa-4045-b14c-9a8c7dfe9c70"
    ],
    "projects": [
        "9c61004714024f9586705d090530f9fa",
        "edc89b490d7d4392898e19b2deb34797"
    ],
    "domains": [
        "3a2d95404f964a6aba78819bf8ddc1e3"
    ],
    "organizations": [
        "o-wvntq58r3poyv180t5df1mdna4uwy9se",
        "r-2boe19iobnhxzs4hq3ncsgph9uz5mrj5",
        "ou-x29s62b1e4w3xasa39w8sg1hkmujqxqc",
        "ou-5x1bvygwrplokk622i9gbn3f5ftfb2l9"
    ]
}

响应消息

  • 响应参数

    参数

    参数类型

    描述

    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

    服务不可用。
父主题： 镜像共享

相关文档