6.4.1 添加镜像成员（OpenStack 原生）
功能介绍
用户共享镜像给其他用户时，使用该接口向该镜像成员中添加接受镜像用户的项目 ID。
调试
您可以在API Explorer中调试该接口。
URI
POST /v2/images/{image_id}/members
请求消息
● 请求参数
参数 是否必选 参数类型 描述
member 是 String 镜像成员。
取值为目标用户的项目ID。
● 请求样例
POST https://{Endpoint}/v2/images/d164b5df-1bc3-4c3f-893e-3e471fd16e64/members { "member":"edc89b490d7d4392898e19b2deb34797"
}
响应消息
● 响应参数
参数 参数类型 描述 status String 共享状态。
created_at String 共享时间，格式为UTC时间。
updated_at String 更新时间，格式为UTC时间。
image_id String 镜像ID
member_id String 成员ID，即接受镜像用户的项目ID。
schema String 共享视图
● 响应样例
STATUS CODE 200 { "status": "pending",
"created_at": "2016-09-01T02:05:14Z", "updated_at": "2016-09-01T02:05:14Z",
"image_id": "d164b5df-1bc3-4c3f-893e-3e471fd16e64", "member_id": "edc89b490d7d4392898e19b2deb34797", "schema": "/v2/schemas/member"
}
返回值
● 正常 200
● 异常
返回值 说明
400 Bad Request 请求错误。
401 Unauthorized 鉴权失败。
403 Forbidden 没有操作权限。
404 Not Found 找不到资源。
500 Internal Server Error 服务内部错误。
503 Service Unavailable 服务不可用。
6.4.2 更新镜像成员状态（OpenStack 原生）
功能介绍
用户接受或者拒绝共享镜像时，使用该接口更新镜像成员的状态。
调试
URI
PUT /v2/images/{image_id}/members/{member_id}
参数说明请参见表6-19。
表6-19 参数说明
参数 是否必选 参数类型 描述
image_id 是 String 镜像ID
member_id 是 String 成员ID
请求消息
● 请求参数
参数 是否必选 参数类型 描述
status 是 String 镜像成员的状态。
取值如下：
● accepted：表示接受共享镜像。
接受后，该镜像在用户镜像列表 中可见，用户可以使用该镜像创 建云服务器。
● rejected：表示拒绝共享镜像。拒 绝后，该镜像在用户镜像列表中 不可见，但是，用户仍然可以使 用该镜像创建云服务器。
vault_id 否 String 存储库ID。
如果是CBR创建的整机镜像，则在接 受该共享镜像时，为必选参数，需 传入该值。
存储库ID可以从云备份服务控制台 获取，或者参考“查询存储库列 表”查询。
● 请求样例
– 镜像为非整机镜像时
PUT https://{Endpoint}/v2/images/d164b5df-1bc3-4c3f-893e-3e471fd16e64/
members/edc89b490d7d4392898e19b2deb34797 { "status": "accepted"
}
– 镜像为整机镜像时
PUT https://{Endpoint}/v2/images/d164b5df-1bc3-4c3f-893e-3e471fd16e64/
members/edc89b490d7d4392898e19b2deb34797 { "status": "accepted",
"vault_id": "6yhtb5df-1bc3-4c3f-893e-3e4716yhgt61"
}
响应消息
● 响应参数
参数 参数类型 描述
status String 共享状态
created_at String 共享时间，格式为UTC时间 updated_at String 更新时间，格式为UTC时间 image_id String 镜像ID
member_id String 成员ID
schema String 共享视图
● 响应样例
STATUS CODE 200 { "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"
}
返回值
● 正常 200
● 异常
返回值 说明
400 Bad Request 请求错误。
401 Unauthorized 鉴权失败。
403 Forbidden 没有操作权限。
404 Not Found 找不到资源。
500 Internal Server Error 服务内部错误。
503 Service Unavailable 服务不可用。
6.4.3 获取镜像成员详情（OpenStack 原生）
功能介绍
该接口主要用于镜像共享中查询某个镜像成员的详情。
调试
您可以在API Explorer中调试该接口。
URI
GET /v2/images/{image_id}/members/{member_id}
参数说明请参见表6-20。
表6-20 参数说明
参数 是否必选 参数类型 描述
image_id 是 String 镜像ID
member_id 是 String 成员ID
请求消息
● 请求参数 无
● 请求样例
GET https://{Endpoint}/v2/images/d164b5df-1bc3-4c3f-893e-3e471fd16e64/members/
edc89b490d7d4392898e19b2deb34797
响应消息
● 响应参数
参数 参数类型 描述
status String 共享状态
created_at String 共享时间，格式为UTC时间 updated_at String 更新时间，格式为UTC时间 image_id String 镜像ID
member_id String 成员ID
schema String 共享视图
● 响应样例
STATUS CODE 200 { "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"
}
返回值
● 正常 200
● 异常
返回值 说明
400 Bad Request 请求错误。
401 Unauthorized 鉴权失败。
403 Forbidden 没有操作权限。
404 Not Found 找不到资源。
500 Internal Server Error 服务内部错误。
503 Service Unavailable 服务不可用。
6.4.4 获取镜像成员列表（OpenStack 原生）
功能介绍
该接口用于共享镜像过程中，获取接受该镜像的成员列表。
调试
您可以在API Explorer中调试该接口。
URI
GET /v2/images/{image_id}/members 参数说明请参见表6-21。
表6-21 参数说明
参数 是否必选 参数类型 描述
image_id 是 String 镜像ID
请求消息
● 请求参数 无
● 请求样例
响应消息
● 响应参数
参数 参数类型 描述
members Array of objects 共享成员列表。
详情请参见表6-22。
schema String 共享视图。
表6-22 members 字段说明
参数 参数类型 描述
status String 共享状态。
created_at String 共享时间，格式为UTC时间。
updated_at String 更新时间，格式为UTC时间。
image_id String 镜像ID。
member_id String 成员ID。
schema String 共享视图。
● 响应样例
STATUS CODE 200 { "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 服务不可用。
6.4.5 删除指定的镜像成员（OpenStack 原生）
功能介绍
该接口用于取消对某个用户的镜像共享。
调试
您可以在API Explorer中调试该接口。
URI
DELETE /v2/images/{image_id}/members/{member_id}
参数说明请参见表6-23。
表6-23 参数说明
参数 是否必选 参数类型 描述
image_id 是 String 镜像ID
member_id 是 String 成员ID
请求消息
● 请求参数 无
● 请求样例
DELETE https://{Endpoint}/v2/images/d164b5df-1bc3-4c3f-893e-3e471fd16e64/members/
edc89b490d7d4392898e19b2deb34797
响应消息
● 响应参数 无
● 响应样例 204 No Content
返回值
204
● 异常
返回值 说明
400 Bad Request 请求错误。
401 Unauthorized 鉴权失败。
403 Forbidden 没有操作权限。
404 Not Found 找不到资源。
500 Internal Server Error 服务内部错误。
503 Service Unavailable 服务不可用。