管理镜像共享__镜像相关接口_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
上一篇:
取消复制镜像__镜像相关接口_API 参考_云服务器 ECS-阿里云
下一篇:
查询镜像共享__镜像相关接口_API 参考_云服务器 ECS-阿里云
阿里云付费用户破100万;腾讯人均薪酬40万;李强调研世界物联网博览会筹备
附录一 元数据库数据字典__附录_使用手册_分析型数据库-阿里云
镜像部署 Linux 环境__建站教程_云服务器 ECS-阿里云
配置__产品简介_高性能计算-阿里云
运维和运营__产品简介_推荐引擎-阿里云
JobInstanceWorker__数据类型_API参考_E-MapReduce-阿里云
查看存储空间列表__管理存储空间_开发人员指南_对象存储 OSS-阿里云
Phpwind如何存储远程附件到oss__ossftp_常用工具_对象存储 OSS-阿里云
NULL值处理__分区_SQL语法参考_云数据库 OceanBase-阿里云
简单深度学习在线预测__应用场景_产品简介_高性能计算-阿里云
相关内容
常见错误说明__附录_大数据计算服务-阿里云
发送短信接口__API使用手册_短信服务-阿里云
接口文档__Android_安全组件教程_移动安全-阿里云
运营商错误码(联通)__常见问题_短信服务-阿里云
设置短信模板__使用手册_短信服务-阿里云
OSS 权限问题及排查__常见错误及排除_最佳实践_对象存储 OSS-阿里云
消息通知__操作指南_批量计算-阿里云
设备端快速接入(MQTT)__快速开始_阿里云物联网套件-阿里云
查询API调用流量数据__API管理相关接口_API_API 网关-阿里云
使用STS访问__JavaScript-SDK_SDK 参考_对象存储 OSS-阿里云