调用DescribePorts查询任务实例对应攻击面数据项中的端口服务信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribePorts |
要执行的操作。取值:DescribePorts。 |
TaskId | Integer | 是 | 12345 |
任务ID。获取指定任务ID数据。 |
Asset | String | 否 | foo.com |
资产名称。查询指定资产下的检测数据。 |
CurrentPage | Integer | 否 | 1 |
指定返回结果的当前页码。默认值为1。 |
PageSize | Integer | 否 | 10 |
指定列表每页显示数据条数。默认值为10,且可设置值最大为10。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Records | Array |
返回结果的记录列表。 |
|
Fingerprint | String | HTTP Apache |
端口指纹。 |
IP | String | 1.2.3.4 |
IP地址。 |
Index | Integer | 1 |
记录索引号。 |
Port | String | 843 |
端口号。 |
Product | String | Apache Tomcat/****** 1.1 |
产品名。 |
Protocol | String | tcp |
网络协议。 |
Service | String | http |
服务类型。 |
UpdatedAt | Long | 1561392000000 |
扫描时间戳。 |
Version | String | 1.1 |
版本信息。 |
RequestId | String | DD73CB0A-6E99-49AB-9569-5A00C9732795 |
返回结果的请求ID。 |
Total | Integer | 120 |
返回数据的总数量。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DescribePorts
&<公共请求参数>
正常返回示例
XML
格式
<DescribePortsResponse>
<code>200</code>
<requestId>DD73CB0A-6E99-49AB-9569-5A00C9732795</requestId>
<success>true</success>
<data>
<Total>120</Total>
<Records>
<Index>1</Index>
<IP>1.2.3.4</IP>
<Protocol>tcp</Protocol>
<Port>843</Port>
<Service>http</Service>
<Product>Apache Tomcat/Coyote JSP engine 1.1</Product>
<Version>1.1</Version>
<Fingerprint></Fingerprint>
<UpdatedAt>1561392000000</UpdatedAt>
</Records>
<Records>
<Index>2</Index>
<IP>1.2.3.5</IP>
<Protocol>tcp</Protocol>
<Port>843</Port>
<Service>http</Service>
<Product>Apache Tomcat/Coyote JSP engine 1.1</Product>
<Version>1.1</Version>
<Fingerprint></Fingerprint>
<UpdatedAt>1561392000000</UpdatedAt>
</Records>
</data>
</DescribePortsResponse>
JSON
格式
{
"code": "200",
"requestId": "DD73CB0A-6E99-49AB-9569-5A00C9732795",
"success": true,
"data": {
"Total": 120,
"Records": [
{
"Index": 1,
"IP": "1.2.3.4",
"Protocol": "tcp",
"Port": "843",
"Service": "http",
"Product": "Apache Tomcat/Coyote JSP engine 1.1",
"Version": "1.1",
"Fingerprint": "",
"UpdatedAt": 1561392000000
},
{
"Index": 2,
"IP": "1.2.3.5",
"Protocol": "tcp",
"Port": "843",
"Service": "http",
"Product": "Apache Tomcat/Coyote JSP engine 1.1",
"Version": "1.1",
"Fingerprint": "",
"UpdatedAt": 1561392000000
}
]
}
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交