github.com/nathanielks/terraform@v0.6.1-0.20170509030759-13e1a62319dc/website/source/docs/providers/aws/r/cloudwatch_log_destination.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_cloudwatch_log_destination"
     4  sidebar_current: "docs-aws-resource-cloudwatch-log-destination"
     5  description: |-
     6    Provides a CloudWatch Logs destination.
     7  ---
     8  
     9  # aws\_cloudwatch\_log\_destination
    10  
    11  Provides a CloudWatch Logs destination resource.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  resource "aws_cloudwatch_log_destination" "test_destination" {
    17    name       = "test_destination"
    18    role_arn   = "${aws_iam_role.iam_for_cloudwatch.arn}"
    19    target_arn = "${aws_kinesis_stream.kinesis_for_cloudwatch.arn}"
    20  }
    21  ```
    22  
    23  ## Argument Reference
    24  
    25  The following arguments are supported:
    26  
    27  * `name` - (Required) A name for the log destination
    28  * `role_arn` - (Required) The ARN of an IAM role that grants Amazon CloudWatch Logs permissions to put data into the target
    29  * `target_arn` - (Required) The ARN of the target Amazon Kinesis stream or Amazon Lambda resource for the destination
    30  
    31  ## Attributes Reference
    32  
    33  The following attributes are exported:
    34  
    35  * `arn` - The Amazon Resource Name (ARN) specifying the log destination.
    36  
    37  ## Import
    38  
    39  CloudWatch Logs destinations can be imported using the `name`, e.g.
    40  
    41  ```
    42  $ terraform import aws_cloudwatch_log_destination.test_destination test_destination
    43  ```