Skip to content
v2.278.0

OrganizationCustomPolicyRuleMetadataProperty Struct ​

An object that specifies metadata for your organization's AWS Config Custom Policy rule.

The metadata includes the runtime system in use, which accounts have debug logging enabled, and other custom rule metadata, such as resource type, resource ID of AWS resource, and organization trigger types that initiate AWS Config to evaluate AWS resources against a rule.

Example ​

ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_config as config } from 'aws-cdk-lib';
const organizationCustomPolicyRuleMetadataProperty: config.CfnOrganizationConfigRule.OrganizationCustomPolicyRuleMetadataProperty = {
  policyText: 'policyText',
  runtime: 'runtime',

  // the properties below are optional
  debugLogDeliveryAccounts: ['debugLogDeliveryAccounts'],
  description: 'description',
  inputParameters: 'inputParameters',
  maximumExecutionFrequency: 'maximumExecutionFrequency',
  organizationConfigRuleTriggerTypes: ['organizationConfigRuleTriggerTypes'],
  resourceIdScope: 'resourceIdScope',
  resourceTypesScope: ['resourceTypesScope'],
  tagKeyScope: 'tagKeyScope',
  tagValueScope: 'tagValueScope',
};
python
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk import aws_config as config

organization_custom_policy_rule_metadata_property = config.CfnOrganizationConfigRule.OrganizationCustomPolicyRuleMetadataProperty(
    policy_text="policyText",
    runtime="runtime",

    # the properties below are optional
    debug_log_delivery_accounts=["debugLogDeliveryAccounts"],
    description="description",
    input_parameters="inputParameters",
    maximum_execution_frequency="maximumExecutionFrequency",
    organization_config_rule_trigger_types=["organizationConfigRuleTriggerTypes"],
    resource_id_scope="resourceIdScope",
    resource_types_scope=["resourceTypesScope"],
    tag_key_scope="tagKeyScope",
    tag_value_scope="tagValueScope"
)
java
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.config.*;

OrganizationCustomPolicyRuleMetadataProperty organizationCustomPolicyRuleMetadataProperty = OrganizationCustomPolicyRuleMetadataProperty.builder()
        .policyText("policyText")
        .runtime("runtime")

        // the properties below are optional
        .debugLogDeliveryAccounts(List.of("debugLogDeliveryAccounts"))
        .description("description")
        .inputParameters("inputParameters")
        .maximumExecutionFrequency("maximumExecutionFrequency")
        .organizationConfigRuleTriggerTypes(List.of("organizationConfigRuleTriggerTypes"))
        .resourceIdScope("resourceIdScope")
        .resourceTypesScope(List.of("resourceTypesScope"))
        .tagKeyScope("tagKeyScope")
        .tagValueScope("tagValueScope")
        .build();
csharp
// Install: dotnet add package Amazon.CDK.Lib
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.Config;

var organizationCustomPolicyRuleMetadataProperty = new OrganizationCustomPolicyRuleMetadataProperty {
    PolicyText = "policyText",
    Runtime = "runtime",

    // the properties below are optional
    DebugLogDeliveryAccounts = new [] { "debugLogDeliveryAccounts" },
    Description = "description",
    InputParameters = "inputParameters",
    MaximumExecutionFrequency = "maximumExecutionFrequency",
    OrganizationConfigRuleTriggerTypes = new [] { "organizationConfigRuleTriggerTypes" },
    ResourceIdScope = "resourceIdScope",
    ResourceTypesScope = new [] { "resourceTypesScope" },
    TagKeyScope = "tagKeyScope",
    TagValueScope = "tagValueScope"
};
go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import "github.com/aws/aws-cdk-go/awscdk"

organizationCustomPolicyRuleMetadataProperty := &OrganizationCustomPolicyRuleMetadataProperty{
	PolicyText: jsii.String("policyText"),
	Runtime: jsii.String("runtime"),

	// the properties below are optional
	DebugLogDeliveryAccounts: []*string{
		jsii.String("debugLogDeliveryAccounts"),
	},
	Description: jsii.String("description"),
	InputParameters: jsii.String("inputParameters"),
	MaximumExecutionFrequency: jsii.String("maximumExecutionFrequency"),
	OrganizationConfigRuleTriggerTypes: []*string{
		jsii.String("organizationConfigRuleTriggerTypes"),
	},
	ResourceIdScope: jsii.String("resourceIdScope"),
	ResourceTypesScope: []*string{
		jsii.String("resourceTypesScope"),
	},
	TagKeyScope: jsii.String("tagKeyScope"),
	TagValueScope: jsii.String("tagValueScope"),
}

Properties ​

debugLogDeliveryAccountsoptionalstring[]debug_log_delivery_accountsoptionaltyping.List[str]debugLogDeliveryAccountsoptionalList<String>DebugLogDeliveryAccountsoptionalstring[]DebugLogDeliveryAccountsoptional*[]*string #
A list of accounts that you can enable debug logging for your organization AWS Config Custom Policy rule.

List is null when debug logging is enabled for all accounts.

descriptionoptionalstringdescriptionoptionalstrdescriptionoptionalStringDescriptionoptionalstringDescriptionoptional*string #
The description that you provide for your organization AWS Config Custom Policy rule.
inputParametersoptionalstringinput_parametersoptionalstrinputParametersoptionalStringInputParametersoptionalstringInputParametersoptional*string #
A string, in JSON format, that is passed to your organization AWS Config Custom Policy rule.
maximumExecutionFrequencyoptionalstringmaximum_execution_frequencyoptionalstrmaximumExecutionFrequencyoptionalStringMaximumExecutionFrequencyoptionalstringMaximumExecutionFrequencyoptional*string #
The maximum frequency with which AWS Config runs evaluations for a rule.

Your AWS Config Custom Policy rule is triggered when AWS Config delivers the configuration snapshot. For more information, see ConfigSnapshotDeliveryProperties .

organizationConfigRuleTriggerTypesoptionalstring[]organization_config_rule_trigger_typesoptionaltyping.List[str]organizationConfigRuleTriggerTypesoptionalList<String>OrganizationConfigRuleTriggerTypesoptionalstring[]OrganizationConfigRuleTriggerTypesoptional*[]*string #
The type of notification that initiates AWS Config to run an evaluation for a rule.
notes

For AWS Config Custom Policy rules, AWS Config supports change-initiated notification types:

  • ConfigurationItemChangeNotification - Initiates an evaluation when AWS Config delivers a configuration item as a result of a resource change.
  • OversizedConfigurationItemChangeNotification - Initiates an evaluation when AWS Config delivers an oversized configuration item. AWS Config may generate this notification type when a resource changes and the notification exceeds the maximum size allowed by Amazon SNS.
policyTextstringpolicy_textstrpolicyTextStringPolicyTextstringPolicyText*string required #
The policy definition containing the logic for your organization AWS Config Custom Policy rule.
resourceIdScopeoptionalstringresource_id_scopeoptionalstrresourceIdScopeoptionalStringResourceIdScopeoptionalstringResourceIdScopeoptional*string #
The ID of the AWS resource that was evaluated.
resourceTypesScopeoptionalstring[]resource_types_scopeoptionaltyping.List[str]resourceTypesScopeoptionalList<String>ResourceTypesScopeoptionalstring[]ResourceTypesScopeoptional*[]*string #
The type of the AWS resource that was evaluated.
runtimestringruntimestrruntimeStringRuntimestringRuntime*string required #
The runtime system for your organization AWS Config Custom Policy rules.
notes

Guard is a policy-as-code language that allows you to write policies that are enforced by AWS Config Custom Policy rules. For more information about Guard, see the Guard GitHub Repository .

tagKeyScopeoptionalstringtag_key_scopeoptionalstrtagKeyScopeoptionalStringTagKeyScopeoptionalstringTagKeyScopeoptional*string #
One part of a key-value pair that make up a tag.

A key is a general label that acts like a category for more specific tag values.

tagValueScopeoptionalstringtag_value_scopeoptionalstrtagValueScopeoptionalStringTagValueScopeoptionalstringTagValueScopeoptional*string #
The optional part of a key-value pair that make up a tag.

A value acts as a descriptor within a tag category (key).