DescribeAssetsByTags-阿里云

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DescribeAssetsByTags	要执行的操作。取值：DescribeAssetsByTags。
SourceIp	String	否	47.100.XX.XX	指定访问者的源IP。
Lang	String	否	zh	指定返回结果的语言环境。取值： zh：中文 en：英文
Tags.N	RepeatList	否	['tag1', 'tag2']	指定标签下待显示的资产列表。
Type	String	否	ip	指定目标资产类型的标签信息。取值： ip：IP类型资产 domain：根域名类型资产
Search	String	否	47.100.XX.XX	指定待查询的目标资产信息。
Untagged	Integer	否	0	指定是否获取无标签下的资产信息。
CurrentPage	Integer	否	2	指定返回资产列表的当前页码。
PageSize	Integer	否	20	指定返回资产列表的每页显示数据总条数。

返回数据


名称	类型	示例值	描述
Count	Integer	14	返回结果的当前页中显示的数据条数。
CurrentPage	Integer	5	返回结果的当前页码。
List	Array of Asset		返回的资产列表。
Asset	String	test	返回资产列表中的资产名称。
AssetId	String	13183b57-f77c-459b-8512-******	返回资产列表中的资产ID。
ExpireTime	Long	1592044480000	返回资产的到期时间。
GmtCreate	Long	1545972690000	返回资产列表中资产的创建时间。
LastScanDate	Long	1540744470000	返回资产列表中资产的最后漏洞扫描时间。
Source	String	UserAdd	返回资产列表中的资产来源类型。
Type	String	ip	（此参数已废弃）返回资产列表中的资产类型。
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>47.100.XX.XX</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
}

错误码

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