阅读975 返回首页    go 微信


管理镜像共享__镜像相关接口_API 参考_云服务器 ECS-阿里云

描述

管理镜像共享可以把用户的自定义镜像共享给其他阿里云账号,该账号可以使用共享的自定义镜像进行创建实例和更换系统盘操作。

  • 用户只能把自己拥有的自定义镜像共享给阿里云其他账号。
  • 每个镜像单次最多共享给 10 个账号。单次最多可以删除 10 个共享账号。超过 10 系统会忽略该参数。
  • 每个用户最多可以获得 30 个共享镜像。白名单可配置。
  • 每个镜像最多可以共享给 50 个用户。可以申请白名单,该账号下的自定义镜像可以共享给更多的用户。
  • 如果镜像的拥有者删除共享给您的镜像或者共享关系,您的已经使用的该共享镜像的实例重置系统盘会失败。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,取值:ModifyImageSharePermission
RegionId String 自定义镜像所属的 regionId
ImageId String 自定义镜像的 Id
AddAccount.n String 添加镜像共享的阿里云账号 Id,n 的取值范围 [1 - 10],超过 10 系统会忽略该参数
RemoveAccount.n String 删除镜像共享的阿里云账号 Id,n 的取值范围 [1 - 10],超过 10 系统会忽略该参数

返回参数

全是公共返回参数,详见公共返回参数

错误码

错误代码 描述 Http 状态码 语义
MissingParameter An input parameter "RegionId" that is mandatory for processing the request is not supplied. 400 缺少 RegionId 值
MissingParameter An input parameter "ImageId" that is mandatory for processing the request is not supplied. 400 缺少 ImageId 的值
InvalidRegionId.NotFound The specified region does not exist. 400 指定的 RegionId 不存在
InvalidImageId.NotFound The specified Image does not exist or not you onwer. 403 指定的镜像 Id 不存在
IncorrectImageStatus The image is not available. 400 指定的镜像状态不正确
InvalidAccount.NotFound The specified parameter "AddAccount.n" or "RemoveAccount.n" does not exist. 404 指定的账号不存在
QuotaExceed.ShareImage The share Image Quota exceeds. 403 已经超过自定义镜像共享配额限制
QuotaExceed.ShareImageUser The shared image user quota exceeds. 403 已经超过单个镜像共享给用户数量的配额限制
InvalidAccount.Forbbiden The specified account does not yourself. 404 不能把镜像共享给自己

示例

请求示例

https://ecs.aliyuncs.com/?Action=ModifyImageSharePermission
&RegionId=cn-hangzhou
&ImageId=m-281234567
&AddAccount.1=23412345234
&<公共请求参数>

返回示例

XML格式

<ModifyImageSharePermissionResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
</ModifyImageSharePermissionResponse>

JSON格式

{
    "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9"
}

最后更新:2016-11-23 16:03:50

  上一篇:go 取消复制镜像__镜像相关接口_API 参考_云服务器 ECS-阿里云
  下一篇:go 查询镜像共享__镜像相关接口_API 参考_云服务器 ECS-阿里云