调用本接口查询资产列表。
该API可以分页查询所有资产;可以查询用户阿里云资产。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeAssets |
系统规定参数。取值:DescribeAssets。 |
Assets.N | RepeatList | 否 | ['1.2.3.5'] |
指定待查询的资产列表。 |
CurrentPage | Integer | 否 | 1 |
指定返回列表的当前页码。 |
GmtCreateFrom | Long | 否 | 1112121000000 |
资产创建时间的开始区间。 |
GmtCreateTo | Long | 否 | 1212121000000 |
资产创建时间的结束区间。 |
PageSize | Integer | 否 | 20 |
指定返回的列表每页的数据条数。 |
Search | String | 否 | test |
指定查询特定资产信息。 |
Source | String | 否 | UserAdd |
指定返回特定资产来源下的资产信息。可选
|
SourceIp | String | 否 | 1.2.3.4 |
指定访问者源IP地址。 |
Status | String | 否 | WaitingForVerification |
指定查询特定资产认证状态的资产信息。
|
Types.N | RepeatList | 否 | ip |
指定返回特定资产类型下的资产信息。可选:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Count | Integer | 20 |
返回结果的当前页显示数据条数。 |
CurrentPage | Integer | 1 |
返回结果的当前页码。 |
List |
资产列表。 |
||
Asset | String | test.cn |
返回资产的名称。 |
AssetId | String | eb293323-ccc9-417d-bb03-****** |
返回资产的ID。 |
ExpireTime | Long | 1592044480000 |
用户资产的到期时间。 |
GmtCreate | Long | 1533543752000 |
返回资产的创建时间。 |
LastScanDate | Long | 1533543752000 |
返回资产的最后漏洞扫描时间。 |
Source | String | UserAdd |
返回资产的来源类型。 |
Type | String | domain |
返回资产的所属资产类型。 |
PageCount | Integer | 2 |
回结果页数。 |
PageSize | Integer | 20 |
返回结果每页显示的总数据条数。 |
RequestId | String | 6D584A17-4DA1-4CFD-BB31-****** |
请求结果ID。 |
TotalCount | Integer | 36 |
返回的资产总数。 |
示例
请求示例
/?Action=DescribeAssets
&Assets.1='1.2.3.5'
&CurrentPage=1
&GmtCreateFrom=1112121
&GmtCreateTo=1212121
&PageSize=20
&Search=test
&Source=AutoImport
&SourceIp=1.2.3.4
&Types.1=ip
&<公共请求参数>
正常返回示例
XML
格式
<DescribeAssets>
<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>
<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>
<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>
</DescribeAssets>
JSON
格式
{
"requestId":"6D584A17-4DA1-4CFD-BB31-BDABDF60F906",
"data":{
"PageCount":2,
"Count":20,
"TotalCount":36,
"PageSize":20,
"List":[
{
"Source":"UserAdd",
"Type":"domain",
"Asset":"test.cn",
"GmtCreate":1533543752000,
"AssetId":"eb293323-ccc9-417d-bb03-93f7227ea128"
},
{
"Source":"UserAdd",
"LastScanDate":"2018-07-10T11:11Z",
"Type":"subdomain",
"Asset":"***.***.io",
"GmtCreate":1531125482000,
"AssetId":"0b77e27e-c0d9-40ef-b52d-7d6588e5ea7a"
},
{
"Source":"ScanDiscover",
"LastScanDate":"2018-05-21T09:38Z",
"Type":"ip",
"Asset":"1.2.3.4",
"GmtCreate":1524177510000,
"AssetId":"b7691e9e-205d-4681-bd39-1b9a7c0d810a"
}
],
"CurrentPage":1
},
"code":200,
"success":true
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交