管理镜像共享
描述
管理镜像共享可以把用户的自定义镜像共享给其他阿里云账号，该账号可以使用共享的自定义镜像进行创建实例和更换系统盘操作。
用户只能把自己拥有的自定义镜像共享给阿里云其他账号。
每个镜像单次最多共享给 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
&<公共请求参数>
返回示例
【点击图片进入下一页或下一篇】
JSON格式
{
"RequestId": "C8B26B44-0189-443E-9816-D951F59623A9"
}
所属专题:
