调用DescribeAssets查询资产列表。

说明 调用本接口可以分页查询所有的资产(包括阿里云资产)。

调试

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

请求参数

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

要执行的操作。取值:DescribeAssets

SourceIp String 1.2.3.4

指定访问者源的IP地址。

Status String WaitingForVerification

指定查询特定资产的认证状态。取值:

  • WaitingForVerification:等待验证
  • VerificationSuccess:验证成功
  • VerificationFailure:验证失败
  • Verifying:验证中
Search String test

指定查询特定资产信息。

Types.N RepeatList ip

指定返回特定资产类型下的资产信息。取值:

  • domain:资产根域名
  • ip:资产IP
  • subdomain:资产子域名
Source String UserAdd

指定返回特定资产来源下的资产信息。取值:

  • UserAdd:用户添加
  • AutoImport:自动导入
  • ScanDiscover:资产发现
Assets.N RepeatList ['1.2.3.5']

指定待查询的资产列表。

GmtCreateFrom Long 1112121000000

资产创建时间的开始区间。

GmtCreateTo Long 1212121000000

资产创建时间的结束区间。

CurrentPage Integer 1

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

PageSize Integer 20

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

返回数据

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

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

CurrentPage Integer 1

返回结果的当前页码。

List Array

资产列表。

Asset String test.cn

返回资产的名称。

AssetGroupId String 11111

资产标签分组的ID。

AssetId String eb293323-ccc9-417d-bb03-******

返回资产的ID。

ExpireTime Long 1592044480000

返回资产的到期时间。

GmtCreate Long 1533543752000

返回资产的创建时间。

LastScanDate Long 1533543752000

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

Source String UserAdd

返回资产的来源类型。

Status String Success

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

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

Type String domain

(此参数已废弃)返回资产的所属资产类型。

VerifyFailureReason String Null

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

VerifyType String Cname

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

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

返回结果的页数。

PageSize Integer 20

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

RequestId String 6D584A17-4DA1-4CFD-BB31-******

请求结果ID。

TotalCount Integer 36

返回的资产总数。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeAssets
&<公共请求参数>

正常返回示例

XML 格式

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

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",
        "AssetId":"0b77e27e-c0d9-40ef-b52d-7d6588e5ea7a",
        "GmtCreate":1531125482000,
        "LastScanDate":"2018-07-10T11:11Z",
        "Source":"UserAdd",
        "Type":"subdomain"
      },
      {
        "Asset":"1.2.3.4",
        "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
}

错误码

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