ModifyImageSharePermission
管理镜像共享权限。您可以将自己的自定义镜像共享给其他阿里云账号,也可以发布为社区镜像供他人使用
服务地址:
华东1 金融云
输入参数
只看必填
RegionId自定义镜像所属的地域ID
ImageId被共享的自定义镜像ID
LaunchPermission>该参数正在邀测中
AddAccount授权共享镜像的阿里云账号ID
0授权共享镜像的阿里云账号ID
RemoveAccount删除镜像共享的阿里云账号ID
0删除镜像共享的阿里云账号ID
IsPublic是否发布或下架社区镜像
请选择布尔值
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

调用该接口前,请您仔细阅读共享自定义镜像

调用该接口时,请注意以下共享规则:

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

发布或下架社区镜像,您需要注意:

  • 社区镜像的所有者需要为对应的社区镜像的质量与迭代负责,阿里云仅提供平台支撑。请确保您已知晓社区镜像协议内容,并已签订协议,否则不允许发布社区镜像。更多信息,请参见发布社区镜像
  • 加密镜像不允许发布为社区镜像。
  • 社区镜像完全公开,在镜像所属地域下,所有阿里云账号均可使用。
  • 社区镜像不支持共享、导出与复制。
  • 已发布的社区镜像一旦下架,将不再对其他所有的阿里云账号公开。如果该自定义镜像已共享至其它阿里云账号,共享关系会继续保持。

请求参数

字段名称字段详情
RegionIdstring

自定义镜像所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
ImageIdstring

被共享的自定义镜像 ID。

示例值:m-bp18ygjuqnwhechc****参考取值来源:
    ImportImage
    CopyImage
    CreateImage
    ExportImage
    DescribeImages
LaunchPermissionstring
说明 该参数正在邀测中,暂不支持使用。
示例值:hide
AddAccountarray<string>

授权共享镜像的阿里云账号 ID。N 的取值范围:1~10,若一次提交超过 10 个阿里云账号,系统将只处理前 10 个,忽略多余的账号。

示例值:1234567890子级条数 <= 10
RemoveAccountarray<string>

删除镜像共享的阿里云账号 ID。N 的取值范围:1~10,若一次提交超过 10 个阿里云账号,系统将只处理前 10 个,忽略多余的账号。

示例值:1234567890子级条数 <= 10
IsPublicboolean

是否发布或下架社区镜像。取值范围:展开详情

示例值:false

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
变更历史
变更时间变更内容概要操作
2025-04-03
变更错误码403
2025-03-13
变更错误码403
2025-02-27
变更错误码403
变更错误码404
2023-12-11
变更错误码403
2023-04-19
变更错误码403
  • 1
  • 2
  • 10 条/页