github.com/ves/terraform@v0.8.0-beta2/website/source/docs/providers/aws/r/kinesis_stream.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_kinesis_stream"
     4  sidebar_current: "docs-aws-resource-kinesis-stream"
     5  description: |-
     6    Provides a AWS Kinesis Stream
     7  ---
     8  
     9  # aws\_kinesis\_stream
    10  
    11  Provides a Kinesis Stream resource. Amazon Kinesis is a managed service that 
    12  scales elastically for real-time processing of streaming big data.
    13  
    14  For more details, see the [Amazon Kinesis Documentation][1].
    15  
    16  ## Example Usage
    17  
    18  ```
    19  resource "aws_kinesis_stream" "test_stream" {
    20  	name = "terraform-kinesis-test"
    21  	shard_count = 1
    22  	retention_period = 48
    23  	shard_level_metrics = [
    24  		"IncomingBytes",
    25  		"OutgoingBytes"
    26  	]
    27  	tags {
    28  		Environment = "test"
    29  	}
    30  }
    31  ```
    32  
    33  ## Argument Reference
    34  
    35  The following arguments are supported:
    36  
    37  * `name` - (Required) A name to identify the stream. This is unique to the 
    38  AWS account and region the Stream is created in.
    39  * `shard_count` – (Required) The number of shards that the stream will use.
    40  Amazon has guidlines for specifying the Stream size that should be referenced 
    41  when creating a Kinesis stream. See [Amazon Kinesis Streams][2] for more.
    42  * `retention_period` - (Optional) Length of time data records are accessible after they are added to the stream. The maximum value of a stream's retention period is 168 hours. Minimum value is 24. Default is 24.
    43  * `shard_level_metrics` - (Optional) A list of shard-level CloudWatch metrics which can be enabled for the stream. See [Monitoring with CloudWatch][3] for more. Note that the value ALL should not be used; instead you should provide an explicit list of metrics you wish to enable.
    44  * `tags` - (Optional) A mapping of tags to assign to the resource.
    45  
    46  ## Attributes Reference
    47  
    48  * `id` - The unique Stream id
    49  * `name` - The unique Stream name (same as `id`)
    50  * `shard_count` - The count of Shards for this Stream
    51  * `arn` - The Amazon Resource Name (ARN) specifying the Stream
    52  
    53  
    54  [1]: https://aws.amazon.com/documentation/kinesis/
    55  [2]: https://docs.aws.amazon.com/kinesis/latest/dev/amazon-kinesis-streams.html
    56  [3]: https://docs.aws.amazon.com/streams/latest/dev/monitoring-with-cloudwatch.html