阿里云服务器ModifyImageSharePermission-[云淘科技_教程]

调用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	是否发布或下架社区镜像。取值范围： true：发布该镜像为社区镜像。 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	AssumeRoleError	Requires a RAM role of AliyunECSShareEncryptImageDefaultRole before sharing encrypted image.	您在共享加密镜像前需要添加 AliyunECSShareEncryptImageDefaultRole RAM 角色。
403	ImageDescription.ContainsSensitiveWords	The specified image description contains sensitive words.	指定的镜像描述包含敏感词汇。
403	ImageName.ContainsSensitiveWords	The specified image name contains sensitive words.	指定的镜像名称包含敏感词汇。
403	Image.NotPublic	The specified image is not public image.	您指定的镜像不是公共权限，不能修改为私有权限。
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.	指定的镜像含有加密快照，不支持共享这种镜像。
403	OperationDenied.InvalidImageStatus	The specified image cannot be shared when it is deprecated.	不能共享已经被弃用的镜像。
403	PublicImageAgreement.NotSigned	The current account has not signed “Community Image Terms of Service”.	当前账户没有签署社区镜像协议。
403	InvalidParameter.IsPublic	The specified parameter IsPublic is conflicted with other parameters.	指定的参数IsPublic与其他参数冲突。
404	InvalidImageId.NotFound	The specified ImageId does not exist.	指定的镜像在该用户账号下不存在，请您检查镜像 ID 是否正确。
404	InvalidAccount.Forbbiden	The specified Account does not yourself.	不能把镜像共享给自己。