DescribeSubUsers
更新时间:2024-11-16 11:03:11
PDF
获取符合条件的子帐户信息。
Request Parameters
Parameter name | Type | Description | Required |
---|---|---|---|
users.n |
String |
子帐户的 ID 列表 |
No |
status |
String |
子帐户的状态:active - 活跃的;disabled - 禁用的;deleted - 删除的 |
No |
offset |
Integer |
结果集偏移量,默认为 0 |
No |
limit |
Integer |
结果集长度,默认为 20 |
No |
Response Elements
Name | Type | Description |
---|---|---|
action |
String |
响应动作 |
user_set |
Array |
返回的子帐户列表,每项参数可见下面 Response Item |
total_count |
Integer |
符合指定过滤条件的子帐户总数量 |
ret_code |
Integer |
执行成功与否,0 表示成功,其他值则为错误代码 |
Response Item
Name | Type | Description |
---|---|---|
user_id |
String |
帐户 ID |
user_name |
String |
帐户名 |
create_time |
TimeStamp |
帐户创建时间,为 UTC 时间,格式可参见 ISO8601. |
String |
登录邮箱 |
|
zones |
String |
帐户可访问的区域列表 |
status |
String |
帐户状态 |
Example
Example Request
https://api.qingcloud.com/iaas/?action=DescribeSubUsers &limit=20 &offset=0 &COMMON_PARAMS
Example Response
{ "action":"DescribeSubUsersResponse", "total_count":2, "user_set":[ { "status":"active", "user_id":"usr-EttbFmBc", "nologin":0, "zones":[ "gd2" ], "create_time":"2014-03-23T18:08:43Z", "user_name":"guest2@guest", "email":"guest@test.com#guest2", }, { "status":"active", "user_id":"usr-K3c2gpjq", "nologin":1, "zones":[ "gd2" ], "create_time":"2014-03-23T17:51:18Z", "user_name":"guest1", "email":"guest@test.com#guest1", } ], "ret_code":0 }