From e288b161d78f4facc3e0e81326c1f23de8ce2331 Mon Sep 17 00:00:00 2001
From: Radek Simko <radek.simko@timeinc.com>
Date: Thu, 4 Feb 2016 23:19:30 +0000
Subject: [PATCH] provider/aws: Document CloudWatch Events

---
 .../aws/r/cloudwatch_event_rule.html.markdown | 57 +++++++++++++++++++
 .../r/cloudwatch_event_target.html.markdown   | 57 +++++++++++++++++++
 website/source/layouts/aws.erb                |  7 +++
 3 files changed, 121 insertions(+)
 create mode 100644 website/source/docs/providers/aws/r/cloudwatch_event_rule.html.markdown
 create mode 100644 website/source/docs/providers/aws/r/cloudwatch_event_target.html.markdown

diff --git a/website/source/docs/providers/aws/r/cloudwatch_event_rule.html.markdown b/website/source/docs/providers/aws/r/cloudwatch_event_rule.html.markdown
new file mode 100644
index 000000000..f3ed87cb7
--- /dev/null
+++ b/website/source/docs/providers/aws/r/cloudwatch_event_rule.html.markdown
@@ -0,0 +1,57 @@
+---
+layout: "aws"
+page_title: "AWS: aws_cloudwatch_event_rule"
+sidebar_current: "docs-aws-resource-cloudwatch-event-rule"
+description: |-
+  Provides a CloudWatch Event Rule resource.
+---
+
+# aws\_cloudwatch\_event\_rule
+
+Provides a CloudWatch Event Rule resource.
+
+## Example Usage
+
+```
+resource "aws_cloudwatch_event_rule" "console" {
+  name = "capture-aws-sign-in"
+  description = "Capture each AWS Console Sign In"
+  event_pattern = <<PATTERN
+{
+  "detail-type": [
+    "AWS Console Sign In via CloudTrail"
+  ]
+}
+PATTERN
+}
+
+resource "aws_cloudwatch_event_target" "sns" {
+  rule = "${aws_cloudwatch_event_rule.console.name}"
+  target_id = "SendToSNS"
+  arn = "${aws_sns_topic.aws_logins.arn}"
+}
+
+resource "aws_sns_topic" "aws_logins" {
+  name = "aws-console-logins"
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `name` - (Required) The rule's name.
+* `schedule_expression` - (Required, if `event_pattern` isn't specified) The scheduling expression.
+	For example, `cron(0 20 * * ? *)` or `rate(5 minutes)`.
+* `event_pattern` - (Required, if `schedule_expression` isn't specified) Event pattern
+	described a JSON object.
+	See full documentation of [CloudWatch Events and Event Patterns](http://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/CloudWatchEventsandEventPatterns.html) for details.
+* `description` - (Optional) The description of the rule.
+* `role_arn` - (Optional) The Amazon Resource Name (ARN) associated with the role that is used for target invocation.
+* `is_enabled` - (Optional) Whether the rule should be enabled (defaults to `true`).
+
+## Attributes Reference
+
+The following attributes are exported:
+
+* `arn` - The Amazon Resource Name (ARN) of the rule.
diff --git a/website/source/docs/providers/aws/r/cloudwatch_event_target.html.markdown b/website/source/docs/providers/aws/r/cloudwatch_event_target.html.markdown
new file mode 100644
index 000000000..e7555da9b
--- /dev/null
+++ b/website/source/docs/providers/aws/r/cloudwatch_event_target.html.markdown
@@ -0,0 +1,57 @@
+---
+layout: "aws"
+page_title: "AWS: aws_cloudwatch_event_target"
+sidebar_current: "docs-aws-resource-cloudwatch-event-target"
+description: |-
+  Provides a CloudWatch Event Target resource.
+---
+
+# aws\_cloudwatch\_event\_target
+
+Provides a CloudWatch Event Target resource.
+
+## Example Usage
+
+```
+resource "aws_cloudwatch_event_target" "yada" {
+  target_id = "Yada"
+  rule = "${aws_cloudwatch_event_rule.console.arn}"
+  arn = "${aws_kinesis_stream.test_stream.arn}"
+}
+
+resource "aws_cloudwatch_event_rule" "console" {
+  name = "capture-ec2-scaling-events"
+  description = "Capture all EC2 scaling events"
+  event_pattern = <<PATTERN
+{
+  "source": [
+    "aws.autoscaling"
+  ],
+  "detail-type": [
+    "EC2 Instance Launch Successful",
+    "EC2 Instance Terminate Successful",
+    "EC2 Instance Launch Unsuccessful",
+    "EC2 Instance Terminate Unsuccessful"
+  ]
+}
+PATTERN
+}
+
+resource "aws_kinesis_stream" "test_stream" {
+    name = "terraform-kinesis-test"
+    shard_count = 1
+}
+```
+
+## Argument Reference
+
+-> **Note:** `input` and `input_path` are mutually exclusive options.
+
+The following arguments are supported:
+
+* `rule` - (Required) The name of the rule you want to add targets to.
+* `target_id` - (Required) The unique target assignment ID.
+* `arn` - (Required) The Amazon Resource Name (ARN) associated of the target.
+* `input` - (Optional) Valid JSON text passed to the target.
+* `input_path` - (Optional) The value of the [JSONPath](http://goessner.net/articles/JsonPath/)
+	that is used for extracting part of the matched event when passing it to the target.
diff --git a/website/source/layouts/aws.erb b/website/source/layouts/aws.erb
index 4f1319dda..c9298f34a 100644
--- a/website/source/layouts/aws.erb
+++ b/website/source/layouts/aws.erb
@@ -31,6 +31,13 @@
                 <li<%= sidebar_current(/^docs-aws-resource-cloudwatch/) %>>
                     <a href="#">CloudWatch Resources</a>
                     <ul class="nav nav-visible">
+                        <li<%= sidebar_current("docs-aws-resource-cloudwatch-event-rule") %>>
+                            <a href="/docs/providers/aws/r/cloudwatch_event_rule.html">aws_cloudwatch_event_rule</a>
+                        </li>
+
+                        <li<%= sidebar_current("docs-aws-resource-cloudwatch-event-target") %>>
+                            <a href="/docs/providers/aws/r/cloudwatch_event_target.html">aws_cloudwatch_event_target</a>
+                        </li>
 
                         <li<%= sidebar_current("docs-aws-resource-cloudwatch-log-group") %>>
                             <a href="/docs/providers/aws/r/cloudwatch_log_group.html">aws_cloudwatch_log_group</a>