帮你快速理解、总结文档立即下载
文档中心>云服务器>API 文档>云服务器API（旧版）>镜像相关接口>查询镜像共享的账号信息

查询镜像共享的账号信息

最近更新时间：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"
                    }
                ]
            }
        ]
    }
}

中国站