使用 CreateCheckItem API 建立自訂安全檢查 - Security Center

在雲安全態勢管理自訂檢查項功能中，使用者建立自訂檢查項。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

yundun-sas:CreateCheckItem

create

*CustomCheckItem

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

無

請求文法

POST  HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
SectionIds	array	是	檢查項關聯的章節 ID 數組。
	integer	否	檢查項關聯章節 ID。說明您可調用 ListCheckPolicies 介面擷取檢查項 ID。	1000000000001
Vendor	string	是	雲資產廠商。說明您可調用 ListCloudAssetSchemas 介面擷取可填入的廠商。	ALIYUN
InstanceType	string	是	雲產品的資產類型。說明您可調用 ListCloudAssetSchemas 介面擷取該參數。	ECS
InstanceSubType	string	是	雲產品的資產子類型。說明您可調用 ListCloudAssetSchemas 介面擷取該參數。	DISK
CheckShowName	string	是	自訂檢查項名稱。	testCheckItemName
RiskLevel	string	是	檢查項的風險等級。取值： HIGH：高危 MEDIUM：中危 LOW：低危	LOW
Status	string	是	檢查項狀態。取值： EDIT：編輯中 RELEASE：發行說明從發行改為編輯中會清除所有記錄只有發行狀態才能使用檢查項檢查。	EDIT
Remark	string	否	備忘資訊。	remark
Description	object	否	檢查項的描述資訊。
Type	string	否	檢查項描述資訊類型。取值： text：文本	text
Value	string	否	描述的具體內容資訊。	custom description.
AssistInfo	object	否	檢查項協助資訊。
Type	string	否	檢查項風險的協助資訊類型。取值： text：文本	text
Value	string	否	檢查項風險的協助資訊的內容。	custom assistInfo.
Solution	object	否	檢查項解決方案資訊。
Type	string	否	檢查項解決方案資訊類型。取值： text：文本	text
Value	string	否	檢查項風險的解決方案內容。	text
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"}]}}

返回參數

名稱	類型	描述	樣本值
	object	介面返回的資料結構體。
RequestId	string	本次調用請求的 ID，是由阿里雲為該請求產生的唯一識別碼，可用於排查和定位問題。	F8B6F758-BCD4-597A-8A2C-DA5A552C****
Data	object	調用成功時，返回的資料。
CheckId	integer	建立成功返回的檢查項 ID。	100000000001

樣本

正常返回樣本

JSON格式

{
  "RequestId": "F8B6F758-BCD4-597A-8A2C-DA5A552C****",
  "Data": {
    "CheckId": 100000000001
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	ParamIllegal.%s	The parameter %s is invalid, please fill it in again.	參數非法，請重新填寫
400	CspmParamOverSize	The parameter is too long.	參數過長，請重新填寫。
400	NoPurchase	The user did not purchase this product.	使用者未購買本產品
400	CspmCreateCheckCustomItemExceedLimit	The number of custom check items created exceeds the limit.	建立自訂檢查項超出數量限制。
400	CspmCheckCustomItemSectionsError	The chapter associated with the custom check item does not exist.	自訂檢查項關聯章節不存在
400	CspmVerifyItemRuleError.%s	Audit check item check rule error: %s.	檢查項規則檢驗格式不通過，詳情請查看返回錯誤碼。
400	CspmCreateCheckCustomItemError	Failed to create custom check item.	建立自訂檢查項失敗。

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

變更歷史

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