AWS::CloudWatch::InsightRule - Amazon CloudFormation
SyntaxPropertiesReturn values
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::CloudWatch::InsightRule

Creates or updates a Contributor Insights rule. Rules evaluate log events in a CloudWatch Logs log group, enabling you to find contributor data for the log events in that log group. For more information, see Using Contributor Insights to Analyze High-Cardinality Data in the Amazon CloudWatch User Guide.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::CloudWatch::InsightRule",
  "Properties" : {
      "RuleBody" : String,
      "RuleName" : String,
      "RuleState" : String,
      "Tags" : Tags
    }
}

YAML

Type: AWS::CloudWatch::InsightRule
Properties: 
  RuleBody: String
  RuleName: String
  RuleState: String
  Tags: 
    Tags

Properties

RuleBody

The definition of the rule, as a JSON object. For details about the syntax, see Contributor Insights Rule Syntax in the Amazon CloudWatch User Guide.

Required: Yes

Type: String

Update requires: No interruption

RuleName

The name of the rule.

Required: Yes

Type: String

Update requires: Replacement

RuleState

The current state of the rule. Valid values are ENABLED and DISABLED.

Required: Yes

Type: String

Update requires: No interruption

Tags

A list of key-value pairs to associate with the Contributor Insights rule. You can associate as many as 50 tags with a rule.

Tags can help you organize and categorize your resources. For more information, see Tagging Your Amazon CloudWatch Resources.

To be able to associate tags with a rule, you must have the cloudwatch:TagResource permission in addition to the cloudwatch:PutInsightRule permission.

Required: No

Type: Tags

Update requires: No interruption

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Reffunction, Refreturns the ARN of the rule.

For more information about using the Reffunction, see Ref.

Fn::GetAtt

The Fn::GetAttintrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAttintrinsic function, see Fn::GetAtt.

Arn

The ARN of the Contributor Insights rule, such as arn:aws:cloudwatch:us-west-2:123456789012:insight-rule/MyInsightRuleName.

RuleName

The name of the Contributor Insights rule.