查询镜像共享的账号信息

最近更新时间:2019-12-03 14:41:22

说明:

当前页面接口为旧版 API,未来可能停止维护,目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范,访问时延下降显著,建议使用 云服务器 API 3.0

1. 接口描述

本接口 (GetImageShareUinInfo) 用于查询本账户的镜像共享情况,包括共享的账户列表。

接口请求域名:image.api.qcloud.com

可以通过镜像ID进行查询,最多10个。

2. 输入参数

以下请求参数列表仅列出了接口请求参数,其它参数见公共请求参数页面。

参数名称 是否必选 类型 描述
imageIds.n String 镜像ID,可通过 DescribeImages 接口值中的 unImgId 获取(此接口支持同时传入多个ID。此参数的具体格式可参考API简介id.n一节)。

3. 输出参数

参数名称 类型 描述
code Int 公共错误码。0表示成功,其他值表示失败。
message String 模块错误信息描述,与接口相关。
data Array 镜像分享数据

其中,data包含了镜像分享数据,数据结构如下:

参数名称 类型 描述
imageNum Int 镜像个数。
maxImgShareNum Int 允许共享的镜像最大数量。
imageList Array 共享镜像列表。

其中,imageList包含了若干个镜像数据。每个镜像数据结构如下:

参数名称 类型 描述
imageId String 镜像ID。
shareUinInfo Array 共享信息。

在imageList中,shareUinInfo包含了若干个分享人的详细信息,每个分享人的详细信息的具体数据结构为:

参数名称 类型 描述
uin Int 共享的账号。
shareTimeStamp String 共享时间。

4. 示例

输入

https://image.api.qcloud.com/v2/index.php?Action=GetImageShareUinInfo
&imageIds.0=img-jgggrva9
&<公共请求参数>

输出

{
    "code":"0",
    "message":"",
    "data":{
        "imageNum":"1",
        "maxImgShareNum":"50",
        "imageList":[
            {
                "imageId":"img-jgggrva9",
                "shareUinInfo":[
                    {
                        "uin":"1621874004",
                        "shareTimeStamp":"2016-01-13 15:16:53"
                    },
                    {
                        "uin":"877354327",
                        "shareTimeStamp":"2016-01-18 13:14:17"
                    }
                ]
            }
        ]
    }
}