所有文档

          云服务器 BCC

          共享自定义镜像

          描述

          • 该接口用于共享用户自己的指定的自定义镜像,仅限自定义镜像,系统镜像和服务集成镜像不能共享。
          • imageId 所指定的镜像不存在,提示404错误。
          • 镜像共享后,被共享的用户可以使用此镜像创建、重置实例。
          • 请求参数中的account和accountId均为可选参数,但不能全部为空,当两个参数同时出现时,服务端会自动去重。

          请求结构

          POST /v{version}/image/{imageId}?{action} HTTP/1.1
          Host: bcc.bj.baidubce.com
          Authorization: authorization string
          
          {
              "account" : "account",
              "accountId" : "accountId"
          }

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URL参数 API版本号
          imageId String URL参数 待共享的镜像ID
          action String Query参数 对镜像执行的动作,当前取值share
          account String Request Body参数 待共享的用户名
          accountId String Request Body参数 待共享的用户ID
          ucAccount String RequestBody参数 uc账号

          返回头域

          除公共头域,无其它特殊头域。

          返回参数

          无特殊返回参数

          错误码

          错误码 错误描述 HTTP状态码 中文解释
          Image.UnCustomImageCannotBeShared Only custom image can be shared. 403 非自定义镜像不能共享
          Image.InvalidAccount Account is invalid. 400 无效的用户
          Image.AccountListIsEmpty Account list is empty. 400 用户列表为空
          Image.ExceedSharedToUserNumQuota Exceed shared to user num quota. 413 超出可共享的用户数量限制
          Image.CannotShareToOwner Cannot share to owner. 403 镜像不能共享给所属用户
          Image.AccountHasBeenShared Account has been shared. 409 用户已接收到此共享镜像,不能重复共享
          Image.ExceedAcceptSharedImageNumQuota Exceed accept shared image num quota 413 超出可接受共享的镜像数量限制

          请求示例

          POST /v2/image/m-nky7qeom?share HTTP/1.1
          Host: bcc.bj.baidubce.com
          ContentType: application/json
          Date: Wed, 01 Mar 2006 12:00:00 GMT
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          
          {
              "account" : "ceshizhanghao",
              "accountId" : "ab1d7802cb9b436bafaf3361fe482ca6"
          }

          返回示例

          HTTP/1.1 200 OK
          x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
          Date: Wed, 03 Dec 2014 06:42:19 GMT
          Content-Type: application/json;charset=UTF-8
          Server: BWS
          上一篇
          取消跨区域复制自定义镜像
          下一篇
          取消共享自定义镜像