Skip to content
v2.278.0

OrganizationCustomRuleMetadataProperty Struct ​

An object that specifies organization custom rule metadata such as resource type, resource ID of AWS resource, Lambda function ARN, and organization trigger types that trigger AWS Config to evaluate your AWS resources against a rule.

It also provides the frequency with which you want AWS Config to run evaluations for the rule if the trigger type is periodic.

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 organizationCustomRuleMetadataProperty: config.CfnOrganizationConfigRule.OrganizationCustomRuleMetadataProperty = {
  lambdaFunctionArn: 'lambdaFunctionArn',
  organizationConfigRuleTriggerTypes: ['organizationConfigRuleTriggerTypes'],

  // the properties below are optional
  description: 'description',
  inputParameters: 'inputParameters',
  maximumExecutionFrequency: 'maximumExecutionFrequency',
  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_rule_metadata_property = config.CfnOrganizationConfigRule.OrganizationCustomRuleMetadataProperty(
    lambda_function_arn="lambdaFunctionArn",
    organization_config_rule_trigger_types=["organizationConfigRuleTriggerTypes"],

    # the properties below are optional
    description="description",
    input_parameters="inputParameters",
    maximum_execution_frequency="maximumExecutionFrequency",
    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.*;

OrganizationCustomRuleMetadataProperty organizationCustomRuleMetadataProperty = OrganizationCustomRuleMetadataProperty.builder()
        .lambdaFunctionArn("lambdaFunctionArn")
        .organizationConfigRuleTriggerTypes(List.of("organizationConfigRuleTriggerTypes"))

        // the properties below are optional
        .description("description")
        .inputParameters("inputParameters")
        .maximumExecutionFrequency("maximumExecutionFrequency")
        .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 organizationCustomRuleMetadataProperty = new OrganizationCustomRuleMetadataProperty {
    LambdaFunctionArn = "lambdaFunctionArn",
    OrganizationConfigRuleTriggerTypes = new [] { "organizationConfigRuleTriggerTypes" },

    // the properties below are optional
    Description = "description",
    InputParameters = "inputParameters",
    MaximumExecutionFrequency = "maximumExecutionFrequency",
    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"

organizationCustomRuleMetadataProperty := &OrganizationCustomRuleMetadataProperty{
	LambdaFunctionArn: jsii.String("lambdaFunctionArn"),
	OrganizationConfigRuleTriggerTypes: []*string{
		jsii.String("organizationConfigRuleTriggerTypes"),
	},

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

Properties ​

descriptionoptionalstringdescriptionoptionalstrdescriptionoptionalStringDescriptionoptionalstringDescriptionoptional*string #
The description that you provide for your organization AWS Config rule.
inputParametersoptionalstringinput_parametersoptionalstrinputParametersoptionalStringInputParametersoptionalstringInputParametersoptional*string #
A string, in JSON format, that is passed to your organization AWS Config rule Lambda function.
lambdaFunctionArnstringlambda_function_arnstrlambdaFunctionArnStringLambdaFunctionArnstringLambdaFunctionArn*string required #
The lambda function ARN.
maximumExecutionFrequencyoptionalstringmaximum_execution_frequencyoptionalstrmaximumExecutionFrequencyoptionalStringMaximumExecutionFrequencyoptionalstringMaximumExecutionFrequencyoptional*string #
The maximum frequency with which AWS Config runs evaluations for a rule.
notes

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

By default, rules with a periodic trigger are evaluated every 24 hours. To change the frequency, specify a valid value for the MaximumExecutionFrequency parameter.

organizationConfigRuleTriggerTypesstring[]organization_config_rule_trigger_typestyping.List[str]organizationConfigRuleTriggerTypesList<String>OrganizationConfigRuleTriggerTypesstring[]OrganizationConfigRuleTriggerTypes*[]*string required #
The type of notification that triggers AWS Config to run an evaluation for a rule.
notes

You can specify the following notification types:

  • ConfigurationItemChangeNotification - Triggers an evaluation when AWS Config delivers a configuration item as a result of a resource change.
  • OversizedConfigurationItemChangeNotification - Triggers 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.
  • ScheduledNotification - Triggers a periodic evaluation at the frequency specified for MaximumExecutionFrequency .
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.
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).