modifyimagesharepermission
管理镜像共享权限。您可以将自己的自定义镜像共享给其他阿里云用户,该用户可以使用共享的自定义镜像创建 ecs 实例(runinstances)或者更换实例的系统盘(replacesystemdisk)。
描述
调用该接口时,您需要注意:
您只能共享自己的自定义镜像给其他阿里云用户。
每份自定义镜像一次最多共享给 10 个阿里云账号。所以,参数 addaccount.n 或者参数 removeaccount.n 单次最多可以传入 10 个阿里云账号,超过 10 个账号系统会忽略该参数。
每份自定义镜像最多可以共享给 50 个阿里云账号。您可以 提交工单 申请共享给更多的用户。
使用共享镜像创建 ecs 实例(runinstances)后,一旦自定义镜像拥有者解除了镜像共享关系,或者删除了自定义镜像(deleteimage),该实例将无法初始化系统盘(reinitdisk)。
请求参数
返回参数
全是公共返回参数。参阅 公共参数
示例
请求示例
https://ecs.aliyuncs.com/?action=modifyimagesharepermission®ionid=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"}
错误码
以下为本接口特有的错误码。更多错误码,请访问 api 错误中心。
以上就是如何使用共享的自定义镜像创建ecs实例或者更换实例的系统盘的详细内容。