AI 助理
文档备案控制台
官方文档
首页 云安全中心 开发参考 API参考指南 API目录 云平台配置检查 ListCheckItem - 获取可以进行自定义检查项配置模版列表

ListCheckItem - 获取可以进行自定义检查项配置模版列表

更新时间：
复制 MD 格式
产品详情
我的收藏

获取可以进行自定义检查项配置列表。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-sas:ListCheckItem

list

*全部资源

*

 无 无

请求参数

名称

类型

必填

描述

示例值
CurrentPage

integer

否

设置从返回结果的第几页开始显示查询结果。默认值为 1，表示从第 1 页开始显示。

1
PageSize

integer

否

分页查询时，每页显示的数据的最大条数。默认值为 20。

10
Lang

string

否

设置请求和接收消息的语言类型。默认值 zh。取值：

  • zh：中文

  • en：英文

zh
TaskSources

array

否

任务来源列表。

string

否

任务来源。取值为：

  • YAO_CHI： 瑶池。

YAO_CHI

返回参数

名称

类型

描述

示例值

object

结构体。

CheckItems

array<object>

检查项信息列表。

array<object>

检查项信息。

InstanceSubType

string

云产品的资产子类型。取值：

  • 当 InstanceType 取值为 ECS 时，本参数的取值：

    • INSTANCE

    • DISK

    • SECURITY_GROUP

  • 当 InstanceType 取值为 ACR 时，本参数的取值：

    • REPOSITORY_ENTERPRISE

    • REPOSITORY_PERSON

  • 当 InstanceType 取值为 RAM 时，本参数的取值：

    • ALIAS

    • USER

    • POLICY

    • GROUP

  • 当 InstanceType 取值为 WAF 时，本参数的取值：

    • DOMAIN

  • 当 InstanceType 取值为其他时，本参数的取值：

    • INSTANCE

INSTANCE
CheckId

integer

检查项 id。

21
CheckShowName

string

检查项名称。

IPv4 Access Control
InstanceType

string

云产品的资产类型。取值：

  • ECS：云服务器

  • SLB：负载均衡

  • RDS：RDS 数据库

  • MONGODB：MongoDb 数据库

  • KVSTORE：Redis 数据库

  • ACR：ACR

  • CSK：CSK

  • VPC：VPC

  • ACTIONTRAIL：操作审计

  • CDN：CDN

  • CAS：数字证书管理服务[原 SSL 证书]

  • RDC：云效

  • RAM：RAM

  • DDOS：分布式拒绝服务

  • WAF：WAF

  • OSS：访问控制

  • POLARDB：POLARDB

  • POSTGRESQL：PostgreSQL

  • MSE：MSE

  • NAS：NAS

  • SDDP：SDDP

  • EIP：EIP

API_GATEWAY
RiskLevel

string

检查项的风险等级。取值：

  • HIGH：高危

  • MEDIUM：中危

  • LOW：低危

HIGH
Vendor

string

云资产厂商。取值：

  • 0：阿里云资产

  • 1：云外资产

  • 2：IDC 资产

  • 3、4、5、7：其它云资产

  • 8：轻量应用服务器

0
SectionIds

array

检查项关联章节列表。

integer

检查项关联章节 ID。

102
Description

object

检查项描述。

Type

string

检查描述属性类型。取值：

  • text：文本

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

态势感知检查项的来源类型：

  • CUSTOM：用户自定义

  • SYSTEM：态势感知平台预定义

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 当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。

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

变更历史

更多信息，参考变更详情。

上一篇：ListCheckStandard - 云平台配置检查获取标准列表下一篇：StartBaselineSecurityCheck - 执行云产品配置检查任务