调用DescribeAssetsByTags查询多个标签下的资产列表信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeAssetsByTags |
要执行的操作。取值:DescribeAssetsByTags。 |
SourceIp | String | 否 | 1.2.3.4 |
指定访问者的源IP。 |
Lang | String | 否 | zh |
指定返回结果的语言环境。取值:
|
Tags.N | RepeatList | 否 | ['tag1', 'tag2'] |
指定标签下待显示的资产列表。 |
Type | String | 否 | ip |
指定目标资产类型的标签信息。取值:
|
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 |
(此参数已废弃)资产的验证类型。 取值:
|
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
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交