DescribeImageUsers¶
可根据映像ID, 查询该映像分享给的用户的列表
如果指定不存在的映像ID，或非法状态值，则会返回错误信息。
Request Parameters
| Parameter name | Type | Description | Required |
|---|---|---|---|
| image_id | String | 映像ID | Yes |
| offset | Integer | 数据偏移量，默认为0 | No |
| limit | Integer | 返回数据长度，默认为20 | No |
| zone | String | 区域 ID，注意要小写 | Yes |
Response Elements
| Name | Type | Description |
|---|---|---|
| action | String | 响应动作 |
| image_user_set | Array | JSON 格式的映像数据列表，每项参数可见下面 Response Item |
| total_count | Integer | 根据过滤条件得到的总数 |
| ret_code | Integer | 执行成功与否，0 表示成功，其他值则为错误代码 |
Response Item
| Name | Type | Description |
|---|---|---|
| image_id | String | 映像ID |
| user | Dict | 用户的信息 email: 用户的邮箱 user_id: 用户的ID |
| create_time | TimeStamp | 创建时间，为UTC时间，格式可参见 ISO8601. |
Example
Example Request:
https://api.qingcloud.com/iaas/?action=DescribeImageUsers&image_id=img-c5hx2ay5
&COMMON_PARAMS
Example Response:
{
"action":"DescribeImageUsersResponse",
"image_user_set":[
{
"image_id":"img-c5hx2ay5",
"create_time":"2015-12-10T07:02:52Z",
"user":{
"user_id":"usr-kXg2pqJb",
"email":"steven@gmail.com"
}
},
{
"image_id":"img-c5hx2ay5",
"create_time":"2015-12-10T07:14:12Z",
"user":{
"user_id":"usr-V9iGGGQB",
"email":"steven@foxmail.com"
}
}
],
"ret_code":0,
"total_count":2
}