调用DescribeImageSharePermission查询一份自定义镜像已经共享的所有用户。返回结果支持分页显示,每页的信息条目默认为10条。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeImageSharePermission

系统规定参数。取值:DescribeImageSharePermission

RegionId String cn-hangzhou

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

ImageId String m-bp1caf3yicx5jlfl****

自定义镜像ID。

PageNumber Integer 1

查询结果显示的页码。

起始值:1。

默认值:1。

PageSize Integer 10

查询结果显示的每页的信息条目数。

最大值:100。

默认值:10。

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

请求ID。

PageNumber Integer 1

查询结果显示的页码。

PageSize Integer 10

每页的信息条目数。

TotalCount Integer 1

记录总数。

ImageId String m-bp1caf3yicx5jlfl****

自定义镜像ID。

RegionId String cn-hangzhou

镜像所属地域ID。

ShareGroups Array of ShareGroup

共享组。

ShareGroup
Group String all

共享分组。

Accounts Array of Account

阿里云注册用户。

Account
AliyunId String 123456****

阿里云账号ID。

示例

请求示例

http(s)://ecs.aliyuncs.com/?Action=DescribeImageSharePermission
&ImageId=m-bp1caf3yicx5jlfl****
&RegionId=cn-hangzhou
&PageNumber=1
&PageSize=10
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeImageSharePermissionResponse>
    <ShareGroups>
        <ShareGroup>
            <Group>all</Group>
        </ShareGroup>
    </ShareGroups>
    <Accounts>
        <Account>
            <AliyunId>123456****</AliyunId>
        </Account>
    </Accounts>
    <ImageId>m-bp1caf3yicx5jlfl****</ImageId>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
    <RegionId>cn-qingdao</RegionId>
    <TotalCount>1</TotalCount>
    <RequestId>9AD96F49-0BE5-4868-A66A-22435254****</RequestId>
</DescribeImageSharePermissionResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "ShareGroups" : {
    "ShareGroup" : [ {
      "Group" : "all"
    } ]
  },
  "Accounts" : {
    "Account" : [ {
      "AliyunId" : "123456****"
    } ]
  },
  "ImageId" : "m-bp1caf3yicx5jlfl****",
  "PageNumber" : 1,
  "PageSize" : 10,
  "RegionId" : "cn-qingdao",
  "TotalCount" : 1,
  "RequestId" : "9AD96F49-0BE5-4868-A66A-22435254****"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidImageId.NotFound The specified ImageId does not exist. 指定的镜像在该用户账号下不存在,请您检查镜像 ID 是否正确。

访问错误中心查看更多错误码。