» Resource: aws_kinesis_video_stream

Provides a Kinesis Video Stream resource. Amazon Kinesis Video Streams makes it easy to securely stream video from connected devices to AWS for analytics, machine learning (ML), playback, and other processing.

For more details, see the Amazon Kinesis Documentation.

» Example Usage

resource "aws_kinesis_video_stream" "default" {
  name                    = "terraform-kinesis-video-stream"
  data_retention_in_hours = 1
  device_name             = "kinesis-video-device-name"
  media_type              = "video/h264"

  tags = {
    Name = "terraform-kinesis-video-stream"
  }
}

» Argument Reference

The following arguments are supported:

  • name - (Required) A name to identify the stream. This is unique to the AWS account and region the Stream is created in.
  • data_retention_in_hours – (Optional) The number of hours that you want to retain the data in the stream. Kinesis Video Streams retains the data in a data store that is associated with the stream. The default value is 0, indicating that the stream does not persist data.
  • device_name - (Optional) The name of the device that is writing to the stream. In the current implementation, Kinesis Video Streams does not use this name.
  • kms_key_id - (Optional) The ID of the AWS Key Management Service (AWS KMS) key that you want Kinesis Video Streams to use to encrypt stream data. If no key ID is specified, the default, Kinesis Video-managed key (aws/kinesisvideo) is used.
  • media_type - (Optional) The media type of the stream. Consumers of the stream can use this information when processing the stream. For more information about media types, see Media Types. If you choose to specify the MediaType, see Naming Requirements for guidelines.
  • tags - (Optional) A mapping of tags to assign to the resource.

» Attributes Reference

  • id - The unique Stream id
  • arn - The Amazon Resource Name (ARN) specifying the Stream (same as id)
  • creation_time - A time stamp that indicates when the stream was created.
  • version - The version of the stream.

» Timeouts

aws_kinesis_video_stream provides the following Timeouts configuration options:

  • create - (Default 5 minutes) Used for Creating a Kinesis Stream
  • update - (Default 120 minutes) Used for Updating a Kinesis Stream
  • delete - (Default 120 minutes) Used for Destroying a Kinesis Stream

» Import

Kinesis Streams can be imported using the arn, e.g.

$ terraform import aws_kinesis_video_stream.test_stream arn:aws:kinesisvideo:us-west-2:123456789012:stream/terraform-kinesis-test/1554978910975