查询设备列表详情

1. 接口描述

接口请求域名： ioa.tencentcloudapi.com 。

查询满足条件的终端数据详情，私有化调用path为：/capi/Assets/Device/DescribeDevices

默认接口请求频率限制：20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

3. 输出参数

4. 示例

示例1 获取设备列表详情

获取租户满足条件：最近登录账号包含'cc'（不区分大小写）的设备列表详情

输入示例

POST / HTTP/1.1
Host: ioa.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeDevices
<公共请求参数>

{
    "Condition": {
        "FilterGroups": [
            {
                "Filters": [
                    {
                        "Field": "IOAUserName",
                        "Operator": "ilike",
                        "Values": [
                            "cc"
                        ]
                    }
                ]
            }
        ],
        "PageSize": 10,
        "PageNum": 1
    },
    "GroupId": 93,
    "OsType": 0
}

输出示例

{
    "Response": {
        "Data": {
            "Items": [
                {
                    "AccountGroupId": 298,
                    "AccountGroupName": "cc",
                    "AccountName": "cc",
                    "AccountUsers": "cc",
                    "BaseBoardSn": "N0CV1740MB0020008",
                    "ComputerName": "DESKTOP-AL8RU6H",
                    "ConnActiveTime": "2023-12-01T12:11:47.076416+08:00",
                    "CriticalVulListCount": 0,
                    "DeviceNewStrategyVer": "2023-12-01 12:11:00",
                    "DeviceStrategyVer": "2023-12-01 11:10:00",
                    "DomainName": "obsolete",
                    "FirewallStatus": 1,
                    "GroupId": 93,
                    "GroupName": "未分组终端",
                    "GroupNamePath": "全网终端.未分组终端",
                    "HostId": 0,
                    "HostName": "obsolete",
                    "IOAUserName": "cc",
                    "Id": 54,
                    "IdentityNewStrategyVer": "2024-11-06 02:44:00",
                    "IdentityStrategyVer": "2024-10-24 22:33:00",
                    "Ip": "113.108.77.51",
                    "Itime": "2023-12-01T09:37:38.505458+08:00",
                    "LocalIpList": "192.168.0.128",
                    "Locked": 0,
                    "MacAddr": "00:0C:29:10:00:5C",
                    "Mid": "75129D715480905B6A9C4569893C7634656938E2",
                    "NGNNewStrategyVer": "2023-11-20 15:54:00",
                    "NGNStrategyVer": "2023-11-20 15:54:00",
                    "Name": "DESKTOP-AL8RU6H",
                    "OnlineStatus": 1,
                    "Os": "Microsoft Windows 10 专业版",
                    "OsBits": 64,
                    "OsInstallDate": "20220812112555.000000+480",
                    "OsLanguage": "简体中文",
                    "OsType": 0,
                    "OsVersion": "10.0.19045",
                    "RiskCount": 0,
                    "SerialNum": "VMware-56 4d 76 2d d7 24 e1 ab-43 f3 af 25 e3 10 00 5c",
                    "StrVersion": "209.12.18590.201",
                    "SysRepVersion": "2023.11.30.19.52.38",
                    "Tags": "commpany assert",
                    "UserName": "cc",
                    "Version": "58828322890449097",
                    "VirusVer": "2.0.13712.288",
                    "VulCount": 0,
                    "VulCriticalList": [
                        "5043051",
                        "4132216"
                    ],
                    "VulVersion": "2023.11.21.16.28.52"
                }
            ],
            "Paging": {
                "PageCount": 1,
                "PageNum": 1,
                "PageSize": 10,
                "Total": 1
            }
        },
        "RequestId": "807938c5-9308-4c87-918d-e84a05f226a1"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

• Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
• Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。