调用DescribePorts接口,查询任务实例对应攻击面数据项中的端口服务信息。

调用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

返回结果的记录列表。

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 格式

<DescribePorts>
	  <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>
</DescribePorts>

JSON 格式

{
	"requestId":"DD73CB0A-6E99-49AB-9569-5A00C9732795",
	"data":{
		"Records":[
			{
				"UpdatedAt":1561392000000,
				"Service":"http",
				"Port":"843",
				"Index":1,
				"Product":"Apache Tomcat/Coyote JSP engine 1.1",
				"IP":"1.2.3.4",
				"Version":"1.1",
				"Protocol":"tcp",
				"Fingerprint":""
			},
			{
				"UpdatedAt":1561392000000,
				"Service":"http",
				"Port":"843",
				"Index":2,
				"Product":"Apache Tomcat/Coyote JSP engine 1.1",
				"IP":"1.2.3.5",
				"Version":"1.1",
				"Protocol":"tcp",
				"Fingerprint":""
			}
		],
		"Total":120
	},
	"code":"200",
	"success":true
}

错误码

访问错误中心查看更多错误码。