修改当前账号指定合规包的信息。
接口说明
本文将提供一个示例,将合规包cp-a8a8626622af0082****
中规则eip-bandwidth-limit
的参数值修改为20
。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
config:UpdateCompliancePack | update | *全部资源 * |
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
CompliancePackId | string | 是 | 合规包 ID。 关于如何获取合规包 ID,请参见 ListCompliancePacks 。 | cp-a8a8626622af0082**** |
Description | string | 否 | 合规包描述。 | 基于等保2.0三级标准,提供持续检测合规性的建议模板,帮助您提前自检并修复问题,以便快速通过正式检测。 |
RiskLevel | integer | 否 | 合规包的风险等级。取值:
| 1 |
ConfigRules | array<object> | 否 | 合规包中的规则列表。 当您修改合规包时,如果规则列表为空,则保持原有规则列表不变;如果规则列表不为空,则使用新规则替换原有规则列表中的规则。 | |
object | 否 | 无 | ||
ManagedRuleIdentifier | string | 否 | 规则模板标识。配置审计根据规则模板标识自动创建规则,并将该规则加入到当前合规包中。
| eip-bandwidth-limit |
ConfigRuleParameters | array<object> | 否 | 规则参数信息。 | |
object | 否 | 无 | ||
ParameterName | string | 否 | 规则参数名称。 参数 | bandwidth |
ParameterValue | string | 否 | 规则参数值。 参数 | 20 |
ConfigRuleId | string | 否 | 规则 ID。配置审计将已有规则加入到当前合规包中。
| cr-e918626622af000f**** |
ConfigRuleName | string | 否 | 规则名称。 | 检测闲置弹性公网IP |
Description | string | 否 | 规则描述。 | 弹性公网已绑定到ECS或者NAT实例,非闲置状态,视为“合规”。 |
RiskLevel | integer | 否 | 规则风险等级。取值:
| 1 |
ClientToken | string | 否 | 保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。 | 1594295238-f9361358-5843-4294-8d30-b5183fac**** |
CompliancePackName | string | 否 | 合规包名称。 关于如何获取合规包名称,请参见 ListCompliancePacks 。 | 等保三级预检合规包 |
RegionIdsScope | string | 否 | 合规包仅对指定地域 ID 中的资源生效。多个地域 ID 之间用半角逗号(,)分隔。 | cn-hangzhou |
ExcludeRegionIdsScope | string | 否 | 规则对指定地域内资源无效,即不对该地域内资源执行评估。多个地域 ID 之间用半角逗号(,)分隔。 | cn-shanghai |
ExcludeResourceIdsScope | string | 否 | 合规包对指定资源 ID 无效,即不对该资源执行评估。多个资源 ID 之间用半角逗号(,)分隔。 | 23642660635687**** |
ResourceIdsScope | string | 否 | 规则对指定资源 ID 生效。多个资源 ID 之间用半角逗号(,)分隔。 | lb-5cmbowstbkss9ta03**** |
ResourceGroupIdsScope | string | 否 | 合规包仅对指定资源组 ID 中的资源生效。多个资源组 ID 之间用半角逗号(,)分隔。 | rg-aekzdibsjjc**** |
ExcludeResourceGroupIdsScope | string | 否 | 规则对指定资源组 ID 中的资源无效,即不对该资源组内的资源评估。多个资源组 ID 之间用半角逗号(,)分隔。 | rg-bnczc6r7rml**** |
TagKeyScope | string | 否 | 合规包仅对绑定指定标签键的资源生效。 | ECS |
TagValueScope | string | 否 | 合规包仅对绑定指定标签键值的资源生效。 说明
TagValueScope 需结合 TagKeyScope 一起使用。
| test |
TagsScope | array<object> | 否 | 标签范围 | |
object | 否 | |||
TagKey | string | 否 | 标签键。 | key-1 |
TagValue | string | 否 | 标签值。 | value-1 |
ExcludeTagsScope | array<object> | 否 | 排除的标签范围 | |
object | 否 | |||
TagKey | string | 否 | 标签键。 | key-2 |
TagValue | string | 否 | 标签值 | value-2 |
关于公共请求参数的详情,请参见公共参数。
返回参数
示例
正常返回示例
JSON
格式
{
"CompliancePackId": "cp-a8a8626622af0082****",
"RequestId": "6EC7AED1-172F-42AE-9C12-295BC2ADB751"
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | Invalid.CompliancePackId.Value | The specified CompliancePackId does not exist. | 合规包ID不存在。 |
400 | CompliancePackExceedMaxCount | The maximum number of compliance pack is exceeded. | - |
400 | Invalid.ConfigRules.Empty | You must specify ConfigRules. | - |
400 | Invalid.ConfigRules.Value | The specified ConfigRules is invalid. | 合规包规则中参数输入错误。 |
400 | ConfigRuleExceedMaxRuleCount | The maximum number of config rules is exceeded. | - |
400 | CompliancePackAlreadyPending | The compliance pack has a pending operation and cannot be updated. | 如果合规包状态非“正常”,不能被更新。 |
400 | CompliancePackExists | The compliance pack already exists. | 合规包名称重复。 |
404 | AccountNotExisted | Your account does not exist. | - |
503 | ServiceUnavailable | The request has failed due to a temporary failure of the server. | 服务不可用。 |
访问错误中心查看更多错误码。