批量创建账号组自定义规则模板,并为每个模板定义资源范围、触发方式、允许执行效果、参数和 Rego 策略;成功后发布模板创建事件并返回模板 ID 列表。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | CreateAccountGroupRuleTemplates | 要执行的操作,取值:CreateAccountGroupRuleTemplates。 |
Version | String | 是 | 2025-01-01 | API的版本,取值:2025-01-01。 |
AccountGroupId | String | 是 | ag-001 | 账号组 ID。 |
Templates | Array of Object | 是 | [{"TemplateName":"example-template","Description":"example description","RiskLevel":"Low","Scope":{"ResourceTypes":["Volcengine::Ecs::Instance"]},"Triggers":[{"TriggerType":"ConfigurationItemChange"}],"AllowedEffects":["Audit","Modify"],"PolicyRule":"package volcengine.config\n\ncompliant if { input.ConfigurationItem.Region == "cn-beijing" }"}] | 待创建的规则模板列表;一次请求 1 到 100 个模板。 |
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
TemplateIds | Array of String | ["rt-123456","rt-234567"] | 批量创建成功后的规则模板 ID 列表。 |
POST /?Action=CreateAccountGroupRuleTemplates&Version=2025-01-01 HTTP/1.1 Host: config.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20260629T093000Z X-Content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=<Credential>/20260629/cn-beijing/config/request, SignedHeaders=host;x-content-sha256;x-date, Signature=<Signature> { "AccountGroupId": "ag-001", "Templates": [ { "TemplateName": "example-template", "Description": "example description", "RiskLevel": "Low", "Scope": { "ResourceTypes": [ "Volcengine::Ecs::Instance" ] }, "Triggers": [ { "TriggerType": "ConfigurationItemChange" } ], "AllowedEffects": [ "Audit", "Modify" ], "Parameters": [], "PolicyRule": "package volcengine.config\n\ncompliant if { input.ConfigurationItem.Region == \"cn-beijing\" }" } ] }
{ "ResponseMetadata": { "RequestId": "202606291730000000000000000000", "Action": "CreateAccountGroupRuleTemplates", "Version": "2025-01-01", "Service": "config", "Region": "cn-beijing" }, "Result": { "TemplateIds": [ "rt-123456" ] } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 说明 |
|---|---|---|
400 | InvalidParameter | |
400 | MissingParameter.Templates | 批量模板列表不能为空。 |
400 | InvalidParameter.Templates | 批量模板数量超过限制,或单个模板结构不合法。 |
400 | Conflict.TemplateName | 请求内或存量规则模板中存在重复模板名称。 |
400 | QuotaExceeded.RuleTemplate | 规则模板配额超限。 |
400 | InvalidParameter.PolicyRule | 规则模板 Rego 策略内容不合法,或 Modify 策略不满足修正契约。 |
400 | MissingParameter.Scope.ResourceTypes | 模板适用资源类型不能为空。 |
400 | InvalidParameter.Scope.ResourceTypes | 模板适用资源类型不存在或当前账号不可用。 |
400 | MissingParameter.Triggers | 模板触发方式不能为空。 |
400 | InvalidParameter.TriggerType | 模板触发类型不合法、重复或包含不允许的 Manual 触发。 |
500 | InternalError |