全部产品
云服务器 ECS

ModifyImageSharePermission

更新时间:2017-09-13 12:56:34   分享:   

描述

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

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

请求参数

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

返回参数

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

错误码

错误代码 描述 HTTP 状态码 语义
IncorrectImageStatus The image is not available. 400 指定的镜像状态不正确。
InvalidRegionId.NotFound The specified region does not exist. 400 指定的 RegionId 不存在。RegionId 的列表详见 地域列表
MissingParameter An input parameter RegionId that is mandatory for processing the request is not supplied. 400 缺少 RegionId 值。RegionId 的列表详见 地域列表
MissingParameter An input parameter ImageId that is mandatory for processing the request is not supplied. 400 缺少 ImageId 的值。
OperationDeined.EncryptedSnapshot The image contains encrypted snapshots, which do not support share. 403 该镜像包含加密快照,不支持共享。
InvalidImageId.NotFound The specified ImageId does not exist. 403 指定的镜像 ID 不存在。
QuotaExceed.ShareImageUser The shared image user quota exceeds. 403 已经超过单个镜像共享给用户数量的配额限制。
InvalidAccount.Forbbiden The specified account does not yourself. 404 不能把镜像共享给自己。
InvalidAccount.NotFound The specified parameter AddAccount.n or RemoveAccount.n does not exist. 404 指定的账号不存在。

示例

请求示例

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

返回示例

XML 格式

  1. <ModifyImageSharePermissionResponse>
  2. <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
  3. </ModifyImageSharePermissionResponse>

JSON 格式

  1. {
  2. "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9"
  3. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?