获取可以进行自定义检查项配置列表。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| CurrentPage |
integer |
否 |
设置从返回结果的第几页开始显示查询结果。默认值为 1,表示从第 1 页开始显示。 |
1 |
| PageSize |
integer |
否 |
分页查询时,每页显示的数据的最大条数。默认值为 20。 |
10 |
| Lang |
string |
否 |
设置请求和接收消息的语言类型。默认值 zh。取值:
|
zh |
| TaskSources |
array |
否 |
任务来源列表。 |
|
|
string |
否 |
任务来源。取值为:
|
YAO_CHI |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
结构体。 |
||
| CheckItems |
array<object> |
检查项信息列表。 |
|
|
array<object> |
检查项信息。 |
||
| InstanceSubType |
string |
云产品的资产子类型。取值:
|
INSTANCE |
| CheckId |
integer |
检查项 id。 |
21 |
| CheckShowName |
string |
检查项名称。 |
IPv4 Access Control |
| InstanceType |
string |
云产品的资产类型。取值:
|
API_GATEWAY |
| RiskLevel |
string |
检查项的风险等级。取值:
|
HIGH |
| Vendor |
string |
云资产厂商。取值:
|
0 |
| SectionIds |
array |
检查项关联章节列表。 |
|
|
integer |
检查项关联章节 ID。 |
102 |
|
| Description |
object |
检查项描述。 |
|
| Type |
string |
检查描述属性类型。取值:
|
text |
| Value |
string |
检查项风险的描述类型为 text 时的文本内容。 |
Checks whether strict access control policies are configured. Requirements: 1. If no blacklists and whitelist are configured, configure a whitelist first. 2. If a blacklist is configured, find the blacklist in the list of access control policies. We recommend that you do not configure an empty blacklist. 3. If a whitelist is configured, find the whitelist in the list of access control policies. We recommend that you do not configure an empty whitelist. Make sure that the whitelist does not contain 0.0.0.0. You can add the following IP addresses to the whitelist: ${IPList}. |
| CustomConfigs |
array<object> |
用户自定义检查配置信息列表。 |
|
|
object |
用户自定义检查配置信息。 |
||
| Name |
string |
用户自定义检查配置名称。 |
IPList |
| TypeDefine |
string |
检查项自定义配置项类型 JSON 字符串。 |
{\"type\":\"LIST\",\"range\":[1,512],\"listType\":{\"type\":\"STRING\",\"range\":[0,22]}} |
| DefaultValue |
string |
检查项自定义配置项默认值字符串。 |
0 |
| Value |
string |
检查项自定义配置项用户配置字符串。 |
1 |
| ShowName |
string |
用户自定义检查配置展示名称。 |
IP列表 |
| EstimatedCount |
integer |
预估的该检查项将消耗的授权数量。 |
30 |
| CheckType |
string |
态势感知检查项的来源类型:
|
SYSTEM |
| InstanceEstimatedCount |
integer |
||
| PageInfo |
object |
分页查询时的页面信息。 |
|
| CurrentPage |
integer |
分页查询时,显示的当前页的页码。 |
1 |
| PageSize |
integer |
分页大小。 |
10 |
| TotalCount |
integer |
查询结果的总数。 |
149 |
| Count |
integer |
分页查询时,当前页显示的数据条数。 |
10 |
| RequestId |
string |
本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。 |
9F4E6157-9600-5588-86B9-38F09067**** |
示例
正常返回示例
JSON格式
{
"CheckItems": [
{
"InstanceSubType": "INSTANCE",
"CheckId": 21,
"CheckShowName": "IPv4 Access Control",
"InstanceType": "API_GATEWAY",
"RiskLevel": "HIGH",
"Vendor": "0",
"SectionIds": [
102
],
"Description": {
"Type": "text",
"Value": "Checks whether strict access control policies are configured. Requirements: 1. If no blacklists and whitelist are configured, configure a whitelist first. 2. If a blacklist is configured, find the blacklist in the list of access control policies. We recommend that you do not configure an empty blacklist. 3. If a whitelist is configured, find the whitelist in the list of access control policies. We recommend that you do not configure an empty whitelist. Make sure that the whitelist does not contain 0.0.0.0. You can add the following IP addresses to the whitelist: ${IPList}."
},
"CustomConfigs": [
{
"Name": "IPList",
"TypeDefine": "{\\\"type\\\":\\\"LIST\\\",\\\"range\\\":[1,512],\\\"listType\\\":{\\\"type\\\":\\\"STRING\\\",\\\"range\\\":[0,22]}}",
"DefaultValue": "0",
"Value": "1",
"ShowName": "IP列表"
}
],
"EstimatedCount": 30,
"CheckType": "SYSTEM",
"InstanceEstimatedCount": 0
}
],
"PageInfo": {
"CurrentPage": 1,
"PageSize": 10,
"TotalCount": 149,
"Count": 10
},
"RequestId": "9F4E6157-9600-5588-86B9-38F09067****"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 500 | ServerError | ServerError | |
| 403 | NoPermission | caller has no permission |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。