获取镜像成员列表 - ListImageMembers
功能介绍
该接口用于共享镜像过程中，获取接受该镜像的成员列表。
调试
您可以在API Explorer中调试该接口。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
GET /v1/{project_id}/cloudimages/{image_id}/members
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释： 项目ID。获取方式请参见获取项目ID。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
| image_id | 是 | String | 参数解释： 镜像ID。获取方式请参见查询镜像列表 - ListImages。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
| 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。
取值范围：
不涉及
表2 members字段说明 参数
参数类型
描述
status
String
参数解释：
共享状态。
取值范围：
- accepted：表示接受共享镜像。接受后，该镜像在用户镜像列表中可见，用户可以使用该镜像创建云服务器。
- rejected：表示拒绝共享镜像。拒绝后，该镜像在用户镜像列表中不可见，但是，用户仍然可以使用该镜像创建云服务器。
created_at
String
参数解释：
共享时间，格式为UTC时间。
取值范围：
不涉及
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字段。
取值范围：
不涉及
- 响应样例
STATUS CODE 200
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
{ "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" }
