调用DescribeAssetsByTags查询多个标签下的资产列表信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeAssetsByTags

要执行的操作。取值:DescribeAssetsByTags

SourceIp String 1.2.3.4

指定访问者的源IP。

Lang String zh

指定返回结果的语言环境。取值:

  • zh:中文
  • en:英文
Tags.N RepeatList ['tag1', 'tag2']

指定标签下待显示的资产列表。

Type String ip

指定目标资产类型的标签信息。取值:

  • ip:IP类型资产
  • domain:根域名类型资产
Search String 1.2.3.5

指定待查询的目标资产信息。

Untagged Integer 0

指定是否获取无标签下的资产信息。

CurrentPage Integer 2

指定返回资产列表的当前页码。

PageSize Integer 20

指定返回资产列表的每页显示数据总条数。

返回数据

名称 类型 示例值 描述
Count Integer 14

返回结果的当前页中显示的数据条数。

CurrentPage Integer 5

返回结果的当前页码。

List Array

返回的资产列表。

Asset String test

返回资产列表中的资产名称。

AssetGroupId String group1

资产标签分组的ID。

AssetId String 13183b57-f77c-459b-8512-******

返回资产列表中的资产ID。

ExpireTime Long 1592044480000

返回资产的到期时间。

GmtCreate Long 1545972690000

返回资产列表中资产的创建时间。

LastScanDate Long 1540744470000

返回资产列表中资产的最后漏洞扫描时间。

Source String UserAdd

返回资产列表中的资产来源类型。

Status String Success

(此参数已废弃)资产的验证状态。

唯一值:Success,表示验证成功

Type String ip

(此参数已废弃)返回资产列表中的资产类型。

VerifyFailureReason String Null

(此参数已废弃)资产验证失败的原因。

VerifyType String Cname

(此参数已废弃)资产的验证类型。

取值:

  • Cname:域名解析验证。
  • File:MD5文件验证。
  • Html:网站的html文件验证。
PageCount Integer 7

返回结果的总页数。

PageSize Integer 20

返回结果每页显示的数据总条数。

RequestId String 6A218865-5D7C-42EE-9509-33069D66F284

返回结果的请求ID。

TotalCount Integer 60

返回结果的资产总数量。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeAssetsByTags
&Tags.1=['tag1', 'tag2']
&<公共请求参数>

正常返回示例

XML 格式

<DescribeAssetsByTagsResponse>
	  <code>200</code>
	  <data>
		    <Count>20</Count>
		    <CurrentPage>1</CurrentPage>
		    <List>
			      <Asset>test.cn</Asset>
			      <AssetId>eb293323-ccc9-417d-bb03-93f7227ea128</AssetId>
			      <GmtCreate>1533543752000</GmtCreate>
			      <Source>UserAdd</Source>
			      <Type>domain</Type>
		    </List>
		    <List>
			      <Asset>***.***.io</Asset>
			      <AssetGroupId>default</AssetGroupId>
			      <AssetId>0b77e27e-c0d9-40ef-b52d-7d6588e5ea7a</AssetId>
			      <GmtCreate>1531125482000</GmtCreate>
			      <LastScanDate>2018-07-10T11:11Z</LastScanDate>
			      <Source>UserAdd</Source>
			      <Type>subdomain</Type>
		    </List>
		    <List>
			      <Asset>1.2.3.4</Asset>
			      <AssetGroupId>default</AssetGroupId>
			      <AssetId>b7691e9e-205d-4681-bd39-1b9a7c0d810a</AssetId>
			      <GmtCreate>1524177510000</GmtCreate>
			      <LastScanDate>2018-05-21T09:38Z</LastScanDate>
			      <Source>ScanDiscover</Source>
			      <Type>ip</Type>
		    </List>
		    <PageCount>2</PageCount>
		    <PageSize>20</PageSize>
		    <TotalCount>36</TotalCount>
	  </data>
	  <requestId>6D584A17-4DA1-4CFD-BB31-BDABDF60F906</requestId>
	  <success>true</success>
</DescribeAssetsByTagsResponse>

JSON 格式

{
  "code":200,
  "data":{
    "Count":20,
    "CurrentPage":1,
    "List":[
      {
        "Asset":"test.cn",
        "AssetId":"eb293323-ccc9-417d-bb03-93f7227ea128",
        "GmtCreate":1533543752000,
        "Source":"UserAdd",
        "Type":"domain"
      },
      {
        "Asset":"***.***.io",
        "AssetGroupId":"default",
        "AssetId":"0b77e27e-c0d9-40ef-b52d-7d6588e5ea7a",
        "GmtCreate":1531125482000,
        "LastScanDate":"2018-07-10T11:11Z",
        "Source":"UserAdd",
        "Type":"subdomain"
      },
      {
        "Asset":"1.2.3.4",
        "AssetGroupId":"default",
        "AssetId":"b7691e9e-205d-4681-bd39-1b9a7c0d810a",
        "GmtCreate":1524177510000,
        "LastScanDate":"2018-05-21T09:38Z",
        "Source":"ScanDiscover",
        "Type":"ip"
      }
    ],
    "PageCount":2,
    "PageSize":20,
    "TotalCount":36
  },
  "requestId":"6D584A17-4DA1-4CFD-BB31-BDABDF60F906",
  "success":true
}

错误码

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