通过阿里云CLI调用ModifyImageSharePermission API管理镜像共享权限。

背景信息

您可以调用ModifyImageSharePermission管理镜像共享权限。您可以将自己的自定义镜像共享给其他阿里云用户,该用户可以使用共享的自定义镜像创建 ECS 实例(RunInstances)或者更换实例的系统盘(ReplaceSystemDisk)。相关API文档请参见ModifyImageSharePermission

通过阿里云CLI调用API时,不同数据类型的请求参数取值必须遵循格式要求,详情请参见参数格式说明

接口说明

调用该接口时,您需要注意:

  • 您只能共享自己的自定义镜像给其他阿里云用户。
  • 每份自定义镜像一次最多共享给 10 个阿里云账号。所以,参数 AddAccount.n 或者参数 RemoveAccount.n 单次最多可以传入 10 个阿里云账号,超过 10 个账号系统会忽略该参数。
  • 每份自定义镜像最多可以共享给 50 个阿里云账号。您可以 提交工单 申请共享给更多的用户。
  • 使用共享镜像创建 ECS 实例(RunInstances)后,一旦自定义镜像拥有者解除了镜像共享关系,或者删除了自定义镜像(DeleteImage),该实例将无法初始化系统盘(ReInitDisk)。

CLI请求示例

  1. 通过DescribeImages API查询您需要的镜像ID。
    本示例通过镜像名称查询镜像ID。
    aliyun ecs DescribeImages --RegionId cn-hangzhou --ImageName demoName --output cols=Images.Image[].ImageId
    返回结果示例:
    Images.Image[].ImageId
    ----------------------
    [m-bp1503ydxxrppctb****]
  2. 将镜像的权限共享给其他阿里云用户。
    aliyun ecs ModifyImageSharePermission --RegionId cn-hangzhou --ImageId m-bp1503ydxxrppctb**** --AddAccount.1 1234567890

执行结果

{
    "RequestId":"C8B26B44-0189-443E-9816-D951F59623A9"
}