基线影响主机列表
最近更新时间: 2026-09-17 00:02:45
1. 接口描述
接口请求域名: cwp.api3.fincloud.tencent.cn。
根据基线id查询基线影响主机列表
默认接口请求频率限制:20次/秒。
接口更新时间:2023-03-28 01:21:07。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数,本接口取值:DescribeBaselineEffectHostList |
| Version | 是 | 否 | String | 公共参数,本接口取值:2018-02-28 |
| Region | 是 | 否 | String | 公共参数,地域信息本接口不需要传递此参数。 |
| BaselineId | 是 | 否 | Uint64 | 基线id 示例值: 12 |
| Filters | 否 | 否 | Array of Filters | 过滤条件。 示例值:查看 |
| Limit | 是 | 否 | Uint64 | 分页参数 最大100条 示例值: 10 |
| Offset | 是 | 否 | Uint64 | 分页参数 示例值: 0 |
| StrategyId | 否 | 否 | Uint64 | 策略id 示例值: 1124 |
| UuidList | 否 | 否 | Array of String | 主机uuid数组 示例值: ["5a540076-d38a-4078-aa98-qwert371d322"] |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| EffectHostList | Array of BaselineEffectHost | 影响服务器列表 示例值:查看 |
| TotalCount | Uint64 | 记录总数 示例值: 12 |
| RequestId | String | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InternalError | 内部错误。 |
| InvalidParameter.ParsingError | 参数解析错误。 |
| InvalidParameter.MissingParameter | 参数缺失。 |
| MissingParameter | 缺少参数错误。 |
| InvalidParameter.IllegalRequest | 非法请求。 |
| InvalidParameter | 参数错误。 |
| InvalidParameterValue | 参数取值错误。 |
5. 示例
示例1 基线影响主机列表接口
根据基线id查询基线影响主机列表数据
输入示例
https://cwp.api3.fincloud.tencent.cn/?Action=DescribeBaselineEffectHostList
&Limit=10
&Offset=0
&BaselineId=100441
&StrategyId=1
&<Public request parameters>
输出示例
{"Response ":{" Effectiveness HostList":[{"AliasName ":" Sales License Test Machine "," FailCount ": 100," FirstScanTime ":" 2019 - 12 - 25 11:57:15 "," HostIp ":"www.example.com","LastScanTime":"2019 - 12 - 25 11:57:15","MaxStatus": 2,"PassCount": 100,"Quuid":" 1c 26308c-5493 - 4 eaf-a817 - 112ec25 f499e "," Status ": 0," Uuid ":"1c 26308 c-5493 - 4 eaf-a817 - 112 ec25 f499 e "}]," RequestId ":" 354 f4ac 3 - 8546 - 4516 - 8c8a-69 e3 ab 73 aa 8a"," TotalCount": 21}}}