文档首页/镜像服务 IMS/API参考/OpenStack原生API/镜像共享（OpenStack原生）/获取镜像成员列表（OpenStack原生） - GlanceListImageMembers
更新时间：2026-03-12 GMT+08:00
查看PDF
分享

获取镜像成员列表（OpenStack原生） - GlanceListImageMembers

功能介绍

该接口用于共享镜像过程中，获取接受该镜像的成员列表。

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

GET /v2/images/{image_id}/members

参数说明请参见表1。
表1 参数说明

参数

是否必选

参数类型

描述

image_id

是

String

镜像ID

limit

否

Integer

参数解释：

查询镜像成员列表每页的数量。

约束限制：

正整数

取值范围:

[1,1000]

默认取值：

500

marker

否

String

参数解释：

分页标识，用于查询下一页内容。

约束限制：

marker的值需为base64编码内容。

取值范围：

不涉及

默认取值：

不涉及

请求消息

请求参数

无

请求示例

获取镜像成员列表。

GET https://{Endpoint}/v2/images/d164b5df-1bc3-4c3f-893e-3e471fd16e64/members

响应消息

  • 响应参数

    参数

    参数类型

    描述

    members

    Array of objects

    共享成员列表。

    详情请参见表2。

    schema

    String

    共享视图。

    page_info

    Object

    分页信息。

    详情请参见表3。

    表2 members字段说明

    参数

    参数类型

    描述

    status

    String

    共享状态。

    created_at

    String

    共享时间，格式为UTC时间。

    updated_at

    String

    更新时间，格式为UTC时间。

    image_id

    String

    镜像ID。

    member_id

    String

    成员ID。

    schema

    String

    共享视图。

    member_type

    string

    共享成员类型

    urn

    string

    共享组织的URN

    仅当member_type类型为organization时，才会返回urn字段。

    表3 page_info字段说明

    参数

    参数类型

    描述

    next_marker

    String

    分页时，作为查询下一页的marker，取值为镜像ID。如果查询结果中该字段有值，证明有下一页数据。

    current_count

    Integer

    当前分页记录数。

  • 响应样例 
    STATUS CODE 200
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
    {
    "members": [
        {
            "status": "accepted",
            "created_at": "2016-09-01T02:05:14Z",
            "updated_at": "2016-09-01T02:37:11Z",
            "image_id": "d164b5df-1bc3-4c3f-893e-3e471fd16e64",
            "member_id": "edc89b490d7d4392898e19b2deb34797",
            "schema": "/v2/schemas/member"
        }
    ],
    "schema": "/v2/schemas/members"
}

返回值

  • 正常

    200

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误。

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。