云主机

产品文档

云主机

shareImage

描述

共享私有镜像。

详细操作说明请参考帮助文档:共享私有镜像

接口说明

  • 只允许对自己账户下的私有镜像执行此操作。
  • 被共享者无法将共享镜像再次共享给其他京东云用户。
  • ready(可用)状态的私有镜像支持共享,包含加密快照的私有镜像不支持共享。
  • 每个镜像默认最多支持共享给10个其他用户,如需共享给更多用户请提交工单申请。

请求方式

POST

请求地址

https://vm.jdcloud-api.com/v1/regions/{regionId}/images/{imageId}:share

名称 类型 是否必需 示例值 描述
regionId String cn-north-1 地域ID。
imageId String i-eumm****d6 镜像ID。

请求参数

名称 类型 是否必选 示例值 描述
pins String[ ] 共享的目标京东云帐户列表。

返回参数

名称 类型 示例值 描述
requestId String c2hmmaan8w06w19qcdfuic4w03f7ft2d 请求ID。

请求示例

POST

/v1/regions/cn-north-1/images/img-m5s0****29:share
{
  "pins" : ["pin1","pin2"]
}

返回示例

{
    "requestId": "a0633f72670e59f8c6db36b1ee257011"
}

返回码

HTTP状态码 错误码 描述 错误解析
200 OK
400 FAILED_PRECONDITION Can't use this image 不可以共享非私有镜像。
400 FAILED_PRECONDITION Community image can't be shared 不可以共享社区镜像。
400 FAILED_PRECONDITION Conflict with underlay image task 'xx' 镜像正在处理其它任务,请稍后再试。
400 FAILED_PRECONDITION Share encrypted snapshot 'xx' is not support. 不可以共享带有加密快照的镜像。
400 FAILED_PRECONDITION Invalid pin 'xx' 用户pin不正确。
400 FAILED_PRECONDITION Pin 'xx' not found 用户pin不存在。
429 QUOTA_EXCEEDED Image share quota limit exceeded 镜像共享配额不足。
404 NOT_FOUND Image 'xx' not found 镜像不存在。
500 INTERNAL Internal server error 系统内部错误,请稍后重试。如果多次尝试失败,请提交工单。
500 UNKNOWN Unknown server error 服务暂时不可用,请稍后重试。如果多次尝试失败,请提交工单。
更新时间:2021-09-01 20:20:29
文档反馈 docs feedback