调用ModifyImageSharePermission管理镜像共享权限。您可以将自己的自定义镜像共享给其他阿里云用户，该用户可以使用共享的自定义镜像创建ECS实例（RunInstances）或者更换实例的系统盘（ReplaceSystemDisk）。
接口说明
调用该接口时，您需要注意：
- 您只能共享自己的自定义镜像给其他阿里云用户。
- 每份自定义镜像一次最多共享给10个阿里云账号。所以，参数AddAccount.n或者参数RemoveAccount.n单次最多可以传入10个阿里云账号，超过10个账号系统会忽略该参数。
- 每份自定义镜像最多可以共享给50个阿里云账号。您可以提交工单申请共享给更多的用户。
- 使用共享镜像创建ECS实例（RunInstances）后，一旦自定义镜像拥有者解除了镜像共享关系，或者删除了自定义镜像（DeleteImage），该实例将无法初始化系统盘（ReInitDisk）。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | ModifyImageSharePermission | 系统规定参数。取值：ModifyImageSharePermission |
| ImageId | String | 是 | m-bp18ygjuqnwhechc**** | 被共享的自定义镜像ID。 |
| RegionId | String | 是 | cn-hangzhou | 自定义镜像所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
| AddAccount.N | RepeatList | 否 | 1234567890 | 授权共享镜像的阿里云账号ID。N的取值范围：1~10，超过10系统会忽略该参数。 |
| RemoveAccount.N | RepeatList | 否 | 1234567890 | 删除镜像共享的阿里云账号ID。N的取值范围：1~10，超过10系统会忽略该参数。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E | 请求ID。 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=ModifyImageSharePermission &ImageId=m-bp18ygjuqnwhechc**** &RegionId=cn-hangzhou &AddAccount.1=1234567890 &RemoveAccount.1=1234567890 &<公共请求参数>
正常返回示例
XML 格式
<ModifyImageSharePermissionResponse>
<RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
</ModifyImageSharePermissionResponse>
JSON 格式
{
"RequestId": "C8B26B44-0189-443E-9816-D951F59623A9"
}
错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | MissingParameter | The input parameter "RegionId" that is mandatory for processing this request is not supplied. | RegionId不得为空。 |
| 404 | InvalidImageId.NotFound | The specified ImageId does not exist. | 指定的镜像在该用户账号下不存在，请您检查镜像ID是否正确。 |
| 404 | InvalidAccount.NotFound | The specified parameter "AddAccount.n" or "RemoveAccount.n" does not exist. | 参数AddAccount.N或者RemoveAccount.N不存在。 |
| 404 | InvalidAccount.Forbbiden | The specified Account does not yourself. | 不能把镜像共享给自己。 |
| 403 | QuotaExceed.ShareImage | The shared Image Quota exceeds. | 已经超过自定义镜像共享配额限制。 |
| 403 | QuotaExceed.ShareImageUser | The shared Image user Quota exceeds. | 已经超过单个镜像共享给用户数量的配额限制。 |
| 400 | InvalidGroup.Malformed | The specified Group is wrongly formed. | 指定的组不存在。 |
| 403 | InvalidImageId.BidMismatch | Cannot share image with other bid user. | 镜像无法跨运营商共享。 |
| 403 | OperationDeined.EncryptedSnapshot | The image contains encrypted snapshots, which do not support share. | 指定的镜像含有加密快照，不支持共享这种镜像。 |
访问错误中心查看更多错误码。