{ "values": [""], "key": "key8"
},
{ "values":
["valueXX", "value3"], "key": "key3"
}]
}
返回值
● 正常 200
● 异常
返回值 说明
400 Bad Request 请求错误。
401 Unauthorized 鉴权失败。
403 Forbidden 没有操作权限。
404 Not Found 找不到资源。
500 Internal Server Error 服务内部错误。
503 Service Unavailable 服务不可用。
5.3 镜像共享
5.3.1 批量删除镜像成员
功能介绍
该接口为扩展接口，主要用于取消镜像共享。
该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是 success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请 参见异步任务查询。
调试
您可以在API Explorer中调试该接口。
URI
DELETE /v1/cloudimages/members
请求消息
● 请求参数
参数 是否必选 参数类型 描述
images 是 Array of strings 镜像ID列表 projects 是 Array of strings 项目ID列表
● 请求样例
DELETE https://{Endpoint}/v1/cloudimages/members { "images": [
"d164b5df-1bc3-4c3f-893e-3e471fd16e64", "0b680482-acaa-4045-b14c-9a8c7dfe9c70"
], "projects": [
"9c61004714024f9586705d090530f9fa", "edc89b490d7d4392898e19b2deb34797"
] }
响应消息
● 响应参数
参数 参数类型 描述
job_id String 异步任务ID。
详情请参见异步任务查询。
● 响应样例
STATUS CODE 200
{ "job_id": "edc89b490d7d4392898e19b2deb34797"
}
返回值
● 正常 200
● 异常
返回值 说明
400 Bad Request 请求错误，具体返回错误码请参错误码。
401 Unauthorized 鉴权失败。
403 Forbidden 没有操作权限。
404 Not Found 找不到资源。
500 Internal Server Error 服务内部错误。
503 Service Unavailable 服务不可用。
5.3.2 批量添加镜像成员
功能介绍
该接口为扩展接口，主要用于镜像共享时用户将多个镜像共享给多个用户。
该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是 success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请 参见异步任务查询。
调试
您可以在API Explorer中调试该接口。
URI
POST /v1/cloudimages/members
请求消息
● 请求参数
参数 是否必选 参数类型 描述
images 是 Array of strings 镜像ID列表 projects 是 Array of strings 项目ID列表
● 请求样例
POST https://{Endpoint}/v1/cloudimages/members { "images": [
"d164b5df-1bc3-4c3f-893e-3e471fd16e64",
"projects": [
"9c61004714024f9586705d090530f9fa", "edc89b490d7d4392898e19b2deb34797"
] }
响应消息
● 响应参数
参数 参数类型 描述
job_id String 异步任务ID。
详情请参见异步任务查询。
● 响应样例
STATUS CODE 200
{ "job_id": "edc89b490d7d4392898e19b2deb34797"
}
返回值
● 正常 200
● 异常
返回值 说明
400 Bad Request 请求错误，具体返回错误码请参错误码。
401 Unauthorized 鉴权失败。
403 Forbidden 没有操作权限。
404 Not Found 找不到资源。
500 Internal Server Error 服务内部错误。
503 Service Unavailable 服务不可用。
5.3.3 批量更新镜像成员状态
功能介绍
该接口为扩展接口，主要用于用户接受或者拒绝多个共享镜像时批量更新镜像成员的 状态。
该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是 success说明任务执行成功，如果是failed说明任务执行失败。如何查询异步任务，请 参见异步任务查询。
调试
您可以在API Explorer中调试该接口。
URI
PUT /v1/cloudimages/members
请求消息
● 请求参数
参数 是否必选 参数类型 描述
images 是 Array of
strings 镜像ID列表。
project_id 是 String 项目ID。
status 是 String 镜像成员的状态。
取值如下：
vault_id 否 String 存储库ID。
如果是通过CBR创建的整机镜像，则在
"d164b5df-1bc3-4c3f-893e-3e471fd16e64", "0b680482-acaa-4045-b14c-9a8c7dfe9c70"
],
"project_id": "edc89b490d7d4392898e19b2deb34797", "status": "accepted"
}
– 共享镜像中包含整机镜像时
PUT https://{Endpoint}/v1/cloudimages/members { "images": [
"d164b5df-1bc3-4c3f-893e-3e471fd16e64", "0b680482-acaa-4045-b14c-9a8c7dfe9c70"
],
"project_id": "edc89b490d7d4392898e19b2deb34797", "status": "accepted",
响应消息
● 响应参数
参数 参数类型 描述
job_id String 异步任务ID。
详情请参见异步任务查询。
● 响应样例
STATUS CODE 200
{ "job_id": "edc89b490d7d4392898e19b2deb34797"
}
返回值
● 正常 200
● 异常
返回值 说明
400 Bad Request 请求错误，具体返回错误码请参错误码。
401 Unauthorized 鉴权失败。
403 Forbidden 没有操作权限。
404 Not Found 找不到资源。
500 Internal Server Error 服务内部错误。
503 Service Unavailable 服务不可用。