Amazon Config · JSON Structure

Config Organization Custom Rule Metadata Structure

organization custom rule metadata such as resource type, resource ID of Amazon Web Services resource, Lambda function ARN, and organization trigger types that trigger Config to evaluate your Amazon Web Services resources against a rule. It also provides the frequency with which you want Config to run evaluations for the rule if the trigger type is periodic.

Type: object Properties: 9 Required: 2
AuditingComplianceConfiguration ManagementGovernanceSecurity

OrganizationCustomRuleMetadata is a JSON Structure definition published by Amazon Config, describing 9 properties, of which 2 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

Description LambdaFunctionArn OrganizationConfigRuleTriggerTypes InputParameters MaximumExecutionFrequency ResourceTypesScope ResourceIdScope TagKeyScope TagValueScope

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-config/refs/heads/main/json-structure/config-organization-custom-rule-metadata-structure.json",
  "name": "OrganizationCustomRuleMetadata",
  "description": " organization custom rule metadata such as resource type, resource ID of Amazon Web Services resource, Lambda function ARN, and organization trigger types that trigger Config to evaluate your Amazon Web Services resources against a rule. It also provides the frequency with which you want Config to run evaluations for the rule if the trigger type is periodic.",
  "type": "object",
  "properties": {
    "Description": {
      "allOf": [
        {
          "$ref": "#/components/schemas/StringWithCharLimit256Min0"
        },
        {
          "description": "The description that you provide for your organization Config rule."
        }
      ]
    },
    "LambdaFunctionArn": {
      "allOf": [
        {
          "$ref": "#/components/schemas/StringWithCharLimit256"
        },
        {
          "description": "The lambda function ARN."
        }
      ]
    },
    "OrganizationConfigRuleTriggerTypes": {
      "allOf": [
        {
          "$ref": "#/components/schemas/OrganizationConfigRuleTriggerTypes"
        },
        {
          "description": "<p>The type of notification that triggers Config to run an evaluation for a rule. You can specify the following notification types:</p> <ul> <li> <p> <code>ConfigurationItemChangeNotification</code> - Triggers an evaluation when Config delivers a configuration item as a result of a resource change.</p> </li> <li> <p> <code>OversizedConfigurationItemChangeNotification</code> - Triggers an evaluation when Config delivers an oversized configuration item. Config may generate this notification type when a resource changes and the notification exceeds the maximum size allowed by Amazon SNS.</p> </li> <li> <p> <code>ScheduledNotification</code> - Triggers a periodic evaluation at the frequency specified for <code>MaximumExecutionFrequency</code>.</p> </li> </ul>"
        }
      ]
    },
    "InputParameters": {
      "allOf": [
        {
          "$ref": "#/components/schemas/StringWithCharLimit2048"
        },
        {
          "description": "A string, in JSON format, that is passed to your organization Config rule Lambda function."
        }
      ]
    },
    "MaximumExecutionFrequency": {
      "allOf": [
        {
          "$ref": "#/components/schemas/MaximumExecutionFrequency"
        },
        {
          "description": "<p>The maximum frequency with which Config runs evaluations for a rule. Your custom rule is triggered when Config delivers the configuration snapshot. For more information, see <a>ConfigSnapshotDeliveryProperties</a>.</p> <note> <p>By default, rules with a periodic trigger are evaluated every 24 hours. To change the frequency, specify a valid value for the <code>MaximumExecutionFrequency</code> parameter.</p> </note>"
        }
      ]
    },
    "ResourceTypesScope": {
      "allOf": [
        {
          "$ref": "#/components/schemas/ResourceTypesScope"
        },
        {
          "description": "The type of the Amazon Web Services resource that was evaluated."
        }
      ]
    },
    "ResourceIdScope": {
      "allOf": [
        {
          "$ref": "#/components/schemas/StringWithCharLimit768"
        },
        {
          "description": "The ID of the Amazon Web Services resource that was evaluated."
        }
      ]
    },
    "TagKeyScope": {
      "allOf": [
        {
          "$ref": "#/components/schemas/StringWithCharLimit128"
        },
        {
          "description": "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. "
        }
      ]
    },
    "TagValueScope": {
      "allOf": [
        {
          "$ref": "#/components/schemas/StringWithCharLimit256"
        },
        {
          "description": "The optional part of a key-value pair that make up a tag. A value acts as a descriptor within a tag category (key). "
        }
      ]
    }
  },
  "required": [
    "LambdaFunctionArn",
    "OrganizationConfigRuleTriggerTypes"
  ]
}