View a markdown version of this page

Updating Amazon Config Rules - Amazon Config
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Updating Amazon Config Rules

你可以使用 Amazon Config 控制台或 Amazon 用于更新规则的 SDK。

更新规则(控制台)

规则页面在一个表中显示您的规则及其当前的合规性结果。每条规则的结果是 正在评估... 直到 Amazon Config 已根据规则完成对资源的评估。您可以使用刷新按钮更新结果。什么时候 Amazon Config 完成评估后,您可以看到合规或不合规的规则和资源类型。有关更多信息,请参阅 查看您的合规性信息和评估结果 Amazon 资源有 Amazon Config。

更新规则
  1. 登录 Amazon Web Services 管理控制台 然后打开 Amazon Config 控制台在 https://console.aws.amazon.com/config/home。

  2. 在 Amazon Web Services 管理控制台 菜单,验证区域选择器是否设置为支持的区域 Amazon Config 规则。有关支持的区域的列表,请参阅《Amazon Web Services 一般参考》中的 Amazon Config 区域和终端节点。

  3. 在左侧导航窗格中,选择 Rules。

  4. 选择规则,然后为要更新的规则选择编辑规则。

  5. 在编辑规则页面上修改设置,以根据需要更改您的规则。

  6. 选择保存。

更新规则 (Amazon 软件开发工具包)

如果要更新之前添加的规则,请在此请求中使用的 ConfigRuleName 数据类型中按、ConfigRuleIdConfigRuleArn 或 ConfigRule 指定规则。您使用的 PutConfigRule 命令与添加规则时使用的命令相同。

以下代码示例显示了如何使用 PutConfigRule。

CLI
Amazon CLI

示例 1:添加 Amazon 托管配置规则

以下 put-config-rule 示例提供了 JSON 代码来添加 Amazon 托管配置规则。

aws configservice put-config-rule \ --config-rule file://RequiredTagsForEC2Instances.json

RequiredTagsForEC2Instances.json 是包含规则配置的 JSON 文件。

RequiredTagsForEC2Instances.json 的内容:

{ "ConfigRuleName": "RequiredTagsForEC2Instances", "Description": "Checks whether the CostCenter and Owner tags are applied to EC2 instances.", "Scope": { "ComplianceResourceTypes": [ "AWS::EC2::Instance" ] }, "Source": { "Owner": "AWS", "SourceIdentifier": "REQUIRED_TAGS" }, "InputParameters": "{\"tag1Key\":\"CostCenter\",\"tag2Key\":\"Owner\"}" }

对于 ComplianceResourceTypes 属性,此 JSON 代码将范围限制为的资源 AWS::EC2::Instance 键入,所以 Amazon Config 将仅根据规则评估 EC2 实例。由于该规则是托管规则,因此 Owner 属性设置为,AWSSourceIdentifier 属性设置为规则标识符。REQUIRED_TAGS对于 InputParameters 属性,指定了规则所需的标签键 CostCenter 和 Owner。

此命令不生成任何输出。要验证规则配置,请运行 描述配置规则 命令,然后指定规则名称。

有关更多信息,请参阅 Amazon 配置管理规则 在 Amazon 配置开发者指南。

示例 2:添加客户管理的配置规则

以下 put-config-rule 示例提供用于添加客户管理的配置规则的 JSON 代码。

aws configservice put-config-rule \ --config-rule file://InstanceTypesAreT2micro.json

InstanceTypesAreT2micro.json 是包含规则配置的 JSON 文件。

InstanceTypesAreT2micro.json 的内容:

{ "ConfigRuleName": "InstanceTypesAreT2micro", "Description": "Evaluates whether EC2 instances are the t2.micro type.", "Scope": { "ComplianceResourceTypes": [ "AWS::EC2::Instance" ] }, "Source": { "Owner": "CUSTOM_LAMBDA", "SourceIdentifier": "arn:aws:lambda:us-west-2:123456789012:function:InstanceTypeCheck", "SourceDetails": [ { "EventSource": "aws.config", "MessageType": "ConfigurationItemChangeNotification" } ] }, "InputParameters": "{\"desiredInstanceType\":\"t2.micro\"}" }

对于 ComplianceResourceTypes 属性,此 JSON 代码将范围限制为的资源 AWS::EC2::Instance 键入,所以 Amazon Config 将仅根据规则评估 EC2 实例。由于此规则是客户管理的规则, Owner 属性设置为 CUSTOM_LAMBDA,以及 SourceIdentifier 属性设置为的 ARN Amazon Lambda 函数。SourceDetails 对象为必填项。为指定的参数 InputParameters 属性被传递给 Amazon 何时 Lambda 函数 Amazon Config 调用它来根据规则评估资源。

此命令不生成任何输出。要验证规则配置,请运行 描述配置规则 命令,然后指定规则名称。

有关更多信息,请参阅 Amazon 配置自定义规则 在 Amazon 配置开发者指南。

  • 有关 API 的详细信息,请参阅 PutConfigRule 在 Amazon CLI 命令参考。

Python
适用于 Python 的 SDK(Boto3)
注意

还有更多关于 GitHub。在 Amazon 代码示例存储库中查找完整示例,了解如何进行设置和运行。

class ConfigWrapper: """ Encapsulates AWS Config functions. """ def __init__(self, config_client): """ :param config_client: A Boto3 AWS Config client. """ self.config_client = config_client def put_config_rule(self, rule_name): """ Sets a configuration rule that prohibits making Amazon S3 buckets publicly readable. :param rule_name: The name to give the rule. """ try: self.config_client.put_config_rule( ConfigRule={ "ConfigRuleName": rule_name, "Description": "S3 Public Read Prohibited Bucket Rule", "Scope": { "ComplianceResourceTypes": [ "AWS::S3::Bucket", ], }, "Source": { "Owner": "AWS", "SourceIdentifier": "S3_BUCKET_PUBLIC_READ_PROHIBITED", }, "InputParameters": "{}", "ConfigRuleState": "ACTIVE", } ) logger.info("Created configuration rule %s.", rule_name) except ClientError: logger.exception("Couldn't create configuration rule %s.", rule_name) raise
  • 有关 API 的详细信息,请参阅 PutConfigRule 在 Amazon 适用于 Python 的 SDK (Boto3) API 参考。

SAP ABAP
适用于 SAP ABAP 的 SDK
注意

还有更多关于 GitHub。在 Amazon 代码示例存储库中查找完整示例,了解如何进行设置和运行。

" Create a config rule for S3 bucket public read prohibition lo_cfs->putconfigrule( io_configrule = NEW /aws1/cl_cfsconfigrule( iv_configrulename = iv_rule_name iv_description = |S3 Public Read Prohibited Bucket Rule| io_scope = NEW /aws1/cl_cfsscope( it_complianceresourcetypes = VALUE /aws1/cl_cfscplncresrctypes_w=>tt_complianceresourcetypes( ( NEW /aws1/cl_cfscplncresrctypes_w( |AWS::S3::Bucket| ) ) ) ) io_source = NEW /aws1/cl_cfssource( iv_owner = |AWS| iv_sourceidentifier = |S3_BUCKET_PUBLIC_READ_PROHIBITED| ) iv_inputparameters = '{}' iv_configrulestate = |ACTIVE| ) ). MESSAGE 'Created AWS Config rule.' TYPE 'I'.
  • 有关 API 的详细信息,请参阅 PutConfigRule 在 Amazon 适用于 SAP 的 SDK ABAP API 参考。