You need to enable JavaScript to run this app.
导航
云防火墙
  • 文档首页
    • /
  • 云防火墙

AssetList - 资产列表查询

最近更新时间：2024.03.28 17:09:34

首次发布时间：2024.03.28 17:09:34

我的收藏

资产列表查询

调试

API Explorer
您可以通过API Explorer在线发起调用，无需关注签名生成过程，快速获取调用结果。
去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数
类型
是否必填
示例值
描述
Action
String
是

AssetList

要执行的操作，取值：AssetList

Version
String
是

2021-09-06

API的版本，取值：2021-09-06

page_size
Integer
否

1

分页大小，默认值为 10

current_page
Integer
否

1

当前页码，默认值为 1

stat
Integer
是

0

开关状态

  • 0：全部
  • 1：开
  • 2：关
asset
String
否

test

资产名称 或 资产IP

asset_type
Array of String
否

["ECS"]

资产类型

  • NAT
  • ECS
  • CLB
  • HAVIP
  • ENI
  • ALB
  • WAF

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数
类型
示例值
描述
TotalCount
Integer

1

返回数据总数量
当查询数据为空时，且使用python SDK调用时此项为None

PageSize
Integer

1

返回数据的分页大小

PageNumber
Integer

1

返回数据的当前页码

Count
Integer

1

返回数据的实际数量
当查询数据为空时，且使用python SDK调用时此项为None

Data
Array of Asset

参见结构示例值

返回的资产数据

请求示例

POST /AssetList HTTP/1.1

{
  "page_size": 5,
  "current_page": 1,
  "stat": 0,
  "asset_type": [
    "ECS",
    "NAT"
  ]
}

返回示例

{
    "ResponseMetadata":{
        "RequestId":"",
        "Action":"",
        "Version":"",
        "Service":"",
        "Region":""
    },
    "Result":{
        "TotalCount":1,
        "PageSize":5,
        "PageNumber":1,
        "Count":1,
        "Data":[
            {
                "ID":1234567,
                "AccountID":"21*****",
                "ip":"10.249.156.150",
                "name":"ECS-eEuE",
                "region":"西南7（桂林）",
                "cluster":1234567,
                "type":"ECS",
                "enable":false,
                "UpdateTime":0
            }
        ]
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
400
InvalidParameter
Invalid Parameter

无效的参数

400
QueryDbFailed
Query configuration failed

查询数据库失败

400
BadRequest
The http request is bad due to some reason: %s.

由于某些原因，http请求不正确

400
MissingParameter
The required parameter %s is missing.

缺少所需的参数

500
InternalError
Internal service error. %s

内部服务错误