阅读151 返回首页    go 阿里云

查询镜像共享__镜像相关接口_API 参考_云服务器 ECS-阿里云

描述

查询用户的自定义镜像共享给其他用户列表。此接口支持分页查询。每页的数量默认为10条。

请求参数

名称 类型 是否必须 描述
Action String 是 系统规定参数，取值：DescribeImageSharePermission
RegionId String 是 镜像所属的 RegionID
ImageId String 是 镜像 ID
PageNumber Integer 否 列表的页码，起始值为 1，默认值为 1
PageSize Integer 否 分页查询时设置的每页行数，最大值 50 行，默认值为 10

返回参数

名称 类型 描述
ImageId String 镜像的 ID
RegionId String 镜像所属地域 Id
ShareGroups ShareGroupType 共享组类型
Accounts AccountType 阿里云账号类型
TotalCount Integer 记录总数
PageNumber Integer 页数
PageSize Integer 每页最大行数，默认 10 行，最大值 50 行

错误码

错误代码 描述 Http 状态码 语义
InvalidRegionId.NotFound The source region not found. 404 指定的 regionId 不存在
InvalidImageId.NotFound The image does not exist. 404 指定的 ImageId 不存在

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeImageSharePermission
&RegionId=cn-qingdao
&ImageId=m-282dzntc7
&<公共请求参数>

返回示例

XML格式

<DescribeImageSharePermissionResponse>
    <ImageId>m-282dzntc7</ImageId>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
    <RegionId>cn-qingdao</RegionId>
    <TotalCount>1</TotalCount>
    <RequestId>441CF898-42FF-47CF-9348-3C3BFF557278</RequestId>
    <ShareGroups>
        <ShareGroup>
            <Group>all</Group>
        </ShareGroup>
    </ShareGroups>
    <Accounts>
        <Account>
            <AliyunId>1886508529898586</AliyunId>
        </Account>
    </Accounts>
</DescribeImageSharePermissionResponse>

JSON格式

{
    "ShareGroups": {
        "ShareGroup": [
            {
                "Group": "all"
            }
        ]
    },
    "Accounts": {
        "Account": [
            {
                "AliyunId": "1886508529898586"
            }
        ]
    },
    "ImageId": "m-282dzntc7",
    "PageNumber": 1,
    "PageSize": 10,
    "RegionId": "cn-qingdao",
    "TotalCount": 1,
    "RequestId": "9AD96F49-0BE5-4868-A66A-224352549CEC"
}

最后更新：2016-11-23 17:16:02

  上一篇：go 管理镜像共享__镜像相关接口_API 参考_云服务器 ECS-阿里云
  下一篇：go 导入镜像__镜像相关接口_API 参考_云服务器 ECS-阿里云