# 获取镜像成员列表 - ListImageMembers #### 功能介绍 该接口用于共享镜像过程中，获取接受该镜像的成员列表。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IMS/doc?locale=zh-cn&consoleCurrentProductId=ims&consoleCurrentProductshort=&api=ListImageMembers)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ims/ims_03_appendix_03.html)。 #### URI GET /v1/{project_id}/cloudimages/{image_id}/members 参数说明请参见[表1]。 表1参数说明 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目ID。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-ims/ims_03_0909.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | image_id | 是 | String | **参数解释：** 镜像ID。获取方式请参见[查询镜像列表 - ListImages](https://support.huaweicloud.com/api-ims/ims_03_0602.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | limit | 否 | Integer | **参数解释：** 查询镜像成员列表每页的数量。 **约束限制：** 正整数 **取值范围：** \[1,1000\] **默认取值：** 500 | | marker | 否 | String | **参数解释：** 分页标识，用于查询下一页内容。 **约束限制：** marker的值需为base64编码内容。 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 请求消息 请求参数 无 #### 请求示例 获取镜像成员列表。 ``` https://{Endpoint}/v1/1bed856811654c1cb661a6ca845ebc77/cloudimages/d164b5df-1bc3-4c3f-893e-3e471fd16e64/members ``` #### 响应消息 - 响应参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | members | Array of objects | **参数解释：** 共享成员列表。详情请参见[表2]。 **取值范围：** 不涉及 | | schema | String | **参数解释：** 共享视图。 **取值范围：** 不涉及 | | page_info | Object | **参数解释：** 分页信息。详情请参见[表3]。 **取值范围：** 不涉及 | 表2members字段说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | status | String | **参数解释：** 共享状态。 **取值范围：** - accepted：表示接受共享镜像。接受后，该镜像在用户镜像列表中可见，用户可以使用该镜像创建云服务器。 - rejected：表示拒绝共享镜像。拒绝后，该镜像在用户镜像列表中不可见，但是，用户仍然可以使用该镜像创建云服务器。 | | created_at | String | **参数解释：** 共享时间，格式为UTC时间，如yyyy-MM-ddTHH:mm:ssZ。示例值如：2015-12-04T09:45:33Z。 **取值范围：** 不涉及 | | updated_at | String | **参数解释：** 更新时间，格式为UTC时间，yyyy-MM-ddTHH:mm:ssZ，例如：2023-08-23T04:07:52Z。 **取值范围：** 不涉及 | | image_id | String | **参数解释：** 镜像ID。 **取值范围：** 不涉及 | | member_id | String | **参数解释：** 成员ID。 **取值范围：** 不涉及 | | schema | String | **参数解释：** 共享视图。 **取值范围：** 不涉及 | | member_type | String | **参数解释：** 共享成员类型。 **取值范围：** - project 项目成员 - domain 账号成员 - organization 组织成员 | | urn | String | **参数解释：** 共享组织的URN。 仅当member_type类型为organization时，才会返回urn字段。 **取值范围：** 不涉及 | 表3page_info字段说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | next_marker | String | **参数解释：** 分页时，作为查询下一页的marker，取值为镜像ID。如果查询结果中该字段有值，证明有下一页数据。 **取值范围：** 不涉及 | | current_count | Integer | **参数解释：** 当前分页记录数。 **取值范围：** 不涉及 | - 响应样例 ``` STATUS CODE 200 ``` ``` { "members": [ { "status": "accepted", "created_at": "2023-08-23T04:07:52Z", "updated_at": "2023-08-23T04:07:52Z", "image_id": "370befec-a369-475e-a224-44a45927a8fe", "member_id": "ou-5x1bvygwrplokk622i9gbn3f5ftfb2l9", "schema": "/v2/schemas/member", "member_type": "organization", "urn": "organizations::3a2d95404f964a6aba78819bf8ddc1e3:ou:o-wvntq58r3poyv180t5df1mdna4uwy9se/ou-5x1bvygwrplokk622i9gbn3f5ftfb2l9" } ], "schema": "/v2/schemas/members" } ``` #### 返回值 - 正常 200 - 异常 | 返回值 | 说明 | |:---|:---| | 400 Bad Request | 请求错误。 | | 401 Unauthorized | 鉴权失败。 | | 403 Forbidden | 没有操作权限。 | | 404 Not Found | 找不到资源。 | | 500 Internal Server Error | 服务内部错误。 | | 503 Service Unavailable | 服务不可用。 |