ListCheckItems - 查詢自訂檢查項 - Security Center

查詢雲安全態勢管理自訂檢查項列表。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

yundun-sas:ListCheckItems

get

*CustomCheckItem

acs:yundun-sas:{#regionId}:{#accountId}:customcheckitem/{#CheckId}

無

請求文法

GET  HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
CheckId	integer	否	檢查項的 ID。	100000000001
CheckShowName	string	否	自訂檢查項名稱。	testCheckItemName
CheckTypes	array	否	Security Center檢查項的來源類型。
	string	否	檢查項的類型（標識策略是系統檢查項還是使用者檢查項）： CUSTOM：使用者自訂 SYSTEM：系統預定義	SYSTEM
Lang	string	否	請求和接收訊息的語言類型。預設值為 zh。取值： zh：中文 en：英文	zh
Statuses	array	否	檢查項狀態。
	string	否	檢查項狀態。取值： EDIT：編輯中 RELEASE：發行	RELEASE
PageSize	integer	否	指定分頁查詢時，每頁顯示的資料最大條數。每頁預設顯示的資料條數為 20 條，PageSize 參數值為空白時，將預設返回 20 條資料。說明建議 PageSize 取值不要為空白。	20
CurrentPage	integer	否	指定分頁查詢時，顯示的當前頁的頁碼。起始值為 1，預設值為 1。	1

返回參數

名稱	類型	描述	樣本值
	object	介面返回的資料體。
RequestId	string	本次調用請求的 ID，是由阿里雲為該請求產生的唯一識別碼，可用於排查和定位問題。	7BC55C8F-226E-5AF5-9A2C-2EC43864****
CheckItems	array<object>	檢查項資訊。
	array<object>	檢查項資訊。
CheckId	integer	檢查項 ID。	100000000001
CheckShowName	string	檢查項名稱。	testCheckItemName
Vendor	string	雲資產廠商。	ALIYUN
InstanceType	string	雲產品的資產類型。	ECS
InstanceSubType	string	雲產品的資產子類型。	DISK
RiskLevel	string	檢查項的風險等級。取值： HIGH：高危 MEDIUM：中危 LOW：低危	HIGH
Status	string	檢查項狀態。取值： EDIT：編輯中 RELEASE：發行	EDIT
CheckPolicies	array<object>	檢查結果關聯的標準、條例、章節資訊列表。
	object	檢查結果關聯的標準、條例、章節資訊。
StandardId	integer	檢查項的標準 ID。	10000000001
StandardShowName	string	檢查項的標準展示名稱。	testStandardShowName
RequirementId	integer	檢查項的條例 ID。	10000000001
RequirementShowName	string	檢查項的條例展示名稱。	testRequirementShowName
SectionId	integer	檢查項的章節 ID。	10000000001
SectionShowName	string	檢查項的章節展示名稱。	testSectionShowName
Type	string	關聯的策略大類的名稱： AISPM：AI 組態管理（AI-SPM） KISPM：Kubernetes 組態管理(KSPM) IDENTITY_PERMISSION：身份許可權管理(CIEM) RISK：安全風險 COMPLIANCE：合規風險	AISPM
Description	object	檢查項的描述資訊。
Type	string	檢查描述屬性類型。取值： text：文本	text
Value	string	描述的具體內容資訊。	custom description.
Solution	object	檢查項解決方案資訊。
Type	string	檢查項解決方案資訊類型。取值： text：文本	text
Value	string	檢查項風險的解決方案內容。	test solution.
AssistInfo	object	檢查項協助資訊。
Type	string	檢查項風險的協助資訊類型。取值： text：文本	text
Value	string	檢查項風險的協助資訊的內容。	test assistInfo.
CheckRule	string	自訂檢查項定義規則。	{"AssociatedData":{"ToDataList":[{"DataName":"ACS_ECS_Instance","PropertyPath":"InstanceId","FromPropertyPath":"InstanceId"}]},"MatchProperty":{"Operator":"AND","MatchProperties":[{"DataName":"ACS_ECS_Disk","PropertyPath":"InstanceId","MatchOperator":"EQ","MatchPropertyValue":"testId"},{"DataName":"ACS_ECS_Instance","PropertyPath":"InstanceId","MatchOperator":"EQ","MatchPropertyValue":"testInstanceId"}]}}
CheckType	string	Security Center檢查項的來源類型： CUSTOM：使用者自訂 SYSTEM：Security Center平台預定義	SYSTEM
Remark	string	備忘資訊。	remark.
PageInfo	object	分頁查詢時的頁面資訊。
TotalCount	integer	查詢到的資料總條數。	100
Count	integer	分頁查詢時，當前頁顯示資料條數。	20
CurrentPage	integer	分頁查詢時，當前頁的頁碼。	1
PageSize	integer	分頁查詢時，顯示的每頁資料的最大條數。	20

樣本

正常返回樣本

JSON格式

{
  "RequestId": "7BC55C8F-226E-5AF5-9A2C-2EC43864****",
  "CheckItems": [
    {
      "CheckId": 100000000001,
      "CheckShowName": "testCheckItemName",
      "Vendor": "ALIYUN",
      "InstanceType": "ECS",
      "InstanceSubType": "DISK",
      "RiskLevel": "HIGH",
      "Status": "EDIT",
      "CheckPolicies": [
        {
          "StandardId": 10000000001,
          "StandardShowName": "testStandardShowName",
          "RequirementId": 10000000001,
          "RequirementShowName": "testRequirementShowName",
          "SectionId": 10000000001,
          "SectionShowName": "testSectionShowName",
          "Type": "AISPM"
        }
      ],
      "Description": {
        "Type": "text",
        "Value": "custom description."
      },
      "Solution": {
        "Type": "text",
        "Value": "test solution."
      },
      "AssistInfo": {
        "Type": "text",
        "Value": "test assistInfo."
      },
      "CheckRule": "{\"AssociatedData\":{\"ToDataList\":[{\"DataName\":\"ACS_ECS_Instance\",\"PropertyPath\":\"InstanceId\",\"FromPropertyPath\":\"InstanceId\"}]},\"MatchProperty\":{\"Operator\":\"AND\",\"MatchProperties\":[{\"DataName\":\"ACS_ECS_Disk\",\"PropertyPath\":\"InstanceId\",\"MatchOperator\":\"EQ\",\"MatchPropertyValue\":\"testId\"},{\"DataName\":\"ACS_ECS_Instance\",\"PropertyPath\":\"InstanceId\",\"MatchOperator\":\"EQ\",\"MatchPropertyValue\":\"testInstanceId\"}]}}",
      "CheckType": "SYSTEM",
      "Remark": "remark."
    }
  ],
  "PageInfo": {
    "TotalCount": 100,
    "Count": 20,
    "CurrentPage": 1,
    "PageSize": 20
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	ParamIllegal.%s	The parameter %s is invalid, please fill it in again.	參數非法，請重新填寫

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。