调用ModifyImageSharePermission管理镜像共享权限。您可以将自己的自定义镜像共享给其他阿里云账号，也可以发布为社区镜像供他人使用。
接口说明
调用该接口时，您需要注意：
- 您只能共享自己的自定义镜像给其他阿里云用户。
- 每份自定义镜像一次最多共享给10个阿里云账号。所以，参数AddAccount.n或者参数RemoveAccount.n单次最多可以传入10个阿里云账号，超过10个账号系统会忽略该参数。
- 每份自定义镜像最多可以共享给50个阿里云账号。
- 使用共享镜像创建ECS实例（RunInstances）后，一旦自定义镜像拥有者解除了镜像共享关系，或者删除了自定义镜像（DeleteImage），该实例将无法初始化系统盘（ReInitDisk）。
发布或下架社区镜像，您需要注意：
- 社区镜像的所有者需要为对应的社区镜像的质量与迭代负责，阿里云仅提供平台支撑。请确保您已知晓社区镜像协议内容，并已签订协议，否则不允许发布社区镜像。更多信息，请参见发布社区镜像。
- 加密镜像不允许发布为社区镜像。
- 社区镜像完全公开，在镜像所属地域下，所有阿里云账号均可使用。
- 社区镜像不支持共享、导出与复制。
- 已发布的社区镜像一旦下架，将不再对其他所有的阿里云账号公开。如果该自定义镜像已共享至其它阿里云账号，共享关系会继续保持。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | ModifyImageSharePermission |
系统规定参数。取值：ModifyImageSharePermission。 |
| RegionId | String | 是 | cn-hangzhou |
自定义镜像所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
| ImageId | String | 是 | m-bp18ygjuqnwhechc**** |
被共享的自定义镜像ID。 |
| LaunchPermission | String | 否 | hide | 说明 该参数正在邀测中，暂不支持使用。 |
| AddAccount.N | String | 否 | 1234567890 |
授权共享镜像的阿里云账号ID。N的取值范围：1~10，超过10系统会忽略该参数。 |
| RemoveAccount.N | String | 否 | 1234567890 |
删除镜像共享的阿里云账号ID。n的取值范围：1~10，超过10系统会忽略该参数。 |
| IsPublic | Boolean | 否 | false |
是否发布或下架社区镜像。取值范围：
默认值：false。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| 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格式
HTTP/1.1 200 OK
Content-Type:application/xml
C8B26B44-0189-443E-9816-D951F59623A9
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "C8B26B44-0189-443E-9816-D951F59623A9"
}错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidGroup.Malformed | The specified Group is wrongly formed. | 指定的组不存在。 |
| 403 | QuotaExceed.ShareImage | The shared Image Quota exceeds. | 已经超过自定义镜像共享配额限制。 |
| 403 | QuotaExceed.ShareImageUser | The shared Image user Quota exceeds. | 已经超过单个镜像共享给用户数量的配额限制。 |
| 403 | InvalidImageId.BidMismatch | Cannot share image with other bid user. | 镜像无法跨运营商共享。 |
| 403 | OperationDeined.EncryptedSnapshot | The image contains encrypted snapshots, which do not support share. | 指定的镜像含有加密快照，不支持共享这种镜像。 |
| 404 | InvalidImageId.NotFound | The specified ImageId does not exist. | 指定的镜像在该用户账号下不存在，请您检查镜像 ID 是否正确。 |
| 404 | InvalidAccount.Forbbiden | The specified Account does not yourself. | 不能把镜像共享给自己。 |
访问错误中心查看更多错误码。
腾讯云1折，限时活动，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠
转转请注明出处：https://www.yunxiaoer.com/152530.html
