# 获取镜像成员列表（OpenStack原生） - GlanceListImageMembers
#### 功能介绍
该接口用于共享镜像过程中，获取接受该镜像的成员列表。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?locale=zh-cn&consoleCurrentProductId=ims&consoleCurrentProductshort=&product=IMS&api=GlanceListImageMembers)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ims/ims_03_appendix_03.html)。
#### 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]。 |
     
   表2members字段说明 
  | 参数          | 参数类型   | 描述                                                                               |
  |:---|:---|:---|
  | 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字段。 |
     
   表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   | 服务不可用。  |