获取区域主机列表

1. 接口描述

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

本接口 (DescribeMachines) 用于获取区域主机列表。

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

2. 输入参数

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

3. 输出参数

4. 示例

示例1 获取区域主机列表

本接口 (DescribeMachines) 用于获取区域主机列表。

输入示例

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

{
    "Limit": 10,
    "MachineRegion": "ap-shanghai",
    "MachineType": "CVM",
    "Filters": [
        {
            "Values": [
                "10.0.1.1"
            ],
            "Name": "Keywords"
        }
    ],
    "Offset": 0
}

输出示例

{
    "Response": {
        "Machines": [
            {
                "BaselineNum": 0,
                "CloudTags": [
                    {
                        "TagKey": "Department",
                        "TagValue": "dev"
                    }
                ],
                "CyberAttackNum": 0,
                "HasAssetScan": 0,
                "InstanceId": "ins-111",
                "InstanceState": "NORMAL",
                "InvasionNum": 3,
                "IpList": "1.1.1.1",
                "IsAddedOnTheFifteen": 1,
                "IsProVersion": false,
                "KernelVersion": "3.10.0-1160.88.1.el7.x86_64",
                "LicenseStatus": 0,
                "MachineExtraInfo": {
                    "HostName": "demo-instance",
                    "InstanceID": "ins-111",
                    "NetworkName": "vpc-111",
                    "NetworkType": 1,
                    "PrivateIP": "1.1.1.1",
                    "WanIP": "1.1.1.1"
                },
                "MachineIp": "1.1.1.1",
                "MachineName": "name01",
                "MachineOs": "CentOS 7.6 64位",
                "MachineStatus": "ONLINE",
                "MachineType": "CVM",
                "MachineWanIp": "1.1.1.1",
                "MalwareNum": 0,
                "PayMode": "POSTPAY",
                "ProjectId": 0,
                "ProtectType": "BASIC_VERSION",
                "Quuid": "3377add2-ee61-4c9a-99a3-************",
                "RegionInfo": {
                    "Region": "ap-nanjing",
                    "RegionCode": "nj",
                    "RegionId": 33,
                    "RegionName": "华东地区（南京）",
                    "RegionNameEn": "East China (Nanjing)"
                },
                "Remark": "do not remove",
                "SecurityStatus": "RISK",
                "Tag": [
                    {
                        "Rid": 1001,
                        "Name": "cwp",
                        "TagId": 1022
                    }
                ],
                "Uuid": "3377add2-ee61-4c9a-99a3-************",
                "VpcId": "vpc-1dj4***",
                "VulNum": 0
            }
        ],
        "RequestId": "621b6063-12b2-43fa-809e-************",
        "TotalCount": 192
    }
}

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: GitHub Gitee
• Tencent Cloud SDK 3.0 for Java: GitHub Gitee
• Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
• Tencent Cloud SDK 3.0 for Go: GitHub Gitee
• Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
• Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
• Tencent Cloud SDK 3.0 for C++: GitHub Gitee
• Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee

命令行工具

• Tencent Cloud CLI 3.0

6. 错误码

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