租户端 计算 云服务器（CVM） 镜像相关接口 ModifyImageSharePermission

ModifyImageSharePermission

最近更新时间: 2024-12-21 13:01:32

1. 接口描述

接口请求域名： cvm.api3.gsesgpucloud.com。

本接口（ModifyImageSharePermission）用于修改镜像分享信息。

  • 分享镜像后，被分享账户可以通过该镜像创建实例。
  • 每个自定义镜像最多可共享给50个账户。
  • 分享镜像无法更改名称，描述，仅可用于创建实例。
  • 只支持分享到对方账户相同地域。

默认接口请求频率限制：10次/秒。

接口更新时间：2018-04-03 17:23:06。

接口只验签名不鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：ModifyImageSharePermission
Version 是 否 String 公共参数，本接口取值：2017-03-12
Region 是 否 String 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
ImageId 是 否 String 镜像ID，形如img-gvbnzy6f。镜像Id可以通过如下方式获取：
  • 通过DescribeImages接口返回的ImageId获取。
  • 通过DescribeImages获取。 
    镜像ID必须指定为状态为NORMAL的镜像。镜像状态请参考镜像数据表。
    示例值： img-6pb6lrmy
    		•
    AccountIds 是 否 Array of String 接收分享镜像的账号Id列表，array型参数的格式可以参考API简介。帐号ID不同于QQ号，查询用户帐号ID请查看帐号信息中的帐号ID栏。
    示例值： ["103849387508"]
    Permission 是 否 String 操作，包括 SHARE，CANCEL。其中SHARE代表分享操作，CANCEL代表取消分享操作。
    示例值： SHARE

    3. 输出参数

    参数名称 类型 描述
    RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

    4. 错误码

    以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

    错误码 描述
    InvalidAccountId.NotFound 无效的账户Id。
    InvalidAccountIs.YourSelf 你无法共享镜像给自己。
    OverQuota 镜像共享超过配额。