云安全中心获取测绘列表-API 文档-文档中心-腾讯云

1. 接口描述

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

获取测绘列表

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

推荐使用 API Explorer

点击调试

API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

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

参数名称	必选	类型	描述
Action	是	String	公共参数，本接口取值：DescribeMappingResults。
Version	是	String	公共参数，本接口取值：2018-06-08。
Region	否	String	公共参数，本接口不需要传递此参数。
Filter.N	否	Array of AssetQueryFilter	过滤条件，FilterKey 取值范围：AssetId，AssetIp，PrivateIp，Protocol，Service，OS，Process，Component，AssetType，Domain，Port，LastMappingTime，MappingType，Disposal，Vpc
Sorter.N	否	Array of QuerySort	排序条件，SortKey取值范围：CreateTime，LastMappingTime
PageIndex	否	Integer	页码
PageSize	否	Integer	页大小，默认大小20

3. 输出参数

参数名称	类型	描述
Total	Integer	总记录数注意：此字段可能返回 null，表示取不到有效值。
Data	Results	列表注意：此字段可能返回 null，表示取不到有效值。
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 DescribeMappingResults

输入示例

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

{
    "Filter": [
        {
            "Filter": [
                {
                    "FilterValue": "ins-3u7e8ki2",
                    "FilterOperatorType": "1",
                    "FilterKey": "AssetId"
                }
            ],
            "Logic": "1"
        }
    ],
    "PageIndex": "1",
    "PageSize": "1",
    "Sorter": [
        {
            "SortType": "1",
            "SortKey": "LastMappingTime"
        }
    ]
}

输出示例

{
    "Response": {
        "Data": {
            "TaskMaxCount": 2,
            "TaskCount": 0,
            "Statistics": [
                {
                    "AssetCount": 1,
                    "AssetType": "cvm"
                }
            ],
            "Result": [
                {
                    "Component": "OpenSSH",
                    "Protocol": "TCP",
                    "DisposalRecommendations": "限制访问",
                    "DisposalRecommendation": 2,
                    "SecurityStatus": [
                        {},
                        {}
                    ],
                    "Region": "ap-guangzhou",
                    "Port": "22",
                    "AssetType": "cvm",
                    "MappingStatus": 2,
                    "LastMappingTime": "2022-04-08 02:35:00",
                    "PrivateIp": "172.16.16.29",
                    "Domain": "22",
                    "AssetId": "ins-3u7e8ki2",
                    "Process": "sshd",
                    "Service": "ssh",
                    "AssetIp": "106.55.242.82",
                    "OS": "CentOS 7.7 64位",
                    "DisposalRecommendationDetails": "<li>1、通知业务方说明端口互联网暴露的必要性和需要面向哪些场景暴露</li><li>2、如果是业务端口，需要确保建议的安全防护均已具备</li><li>3、如果是远程运维用端口，应能关则关，改为使用堡垒机等手段运维。</li><li>4、如果是必须开放的端口，尽可能配置安全组入站规则或使用 <a target=\"_blank\" rel=\"noreferrer\" href=\"https://console.cloud.tencent.com/cfw/ac/auth?tab=user\">云防火墙微信远程运维</a> 来对端口访问做控制</li><li>5、无法关闭的端口，需要检查安全防护状态，尽可能保证所有建议的安全防护均已具备</li><li>6、可鼠标悬浮安全防护状态查看具体说明和建议</li>",
                    "AssetName": "数据安全组virustotal检测6"
                }
            ]
        },
        "Total": 1,
        "RequestId": "fd1ed4b0-5534-406d-a2ff-cdf486536761"
    }
}

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. 错误码

该接口暂无业务逻辑相关的错误码，其他错误码详见公共错误码。