Skip to content

Resource: awsElastictranscoderPipeline

Provides an Elastic Transcoder pipeline resource.

Example Usage

/*Provider bindings are generated by running cdktf get.
See https://cdk.tf/provider-generation for more details.*/
import * as aws from "./.gen/providers/aws";
new aws.elastictranscoderPipeline.ElastictranscoderPipeline(this, "bar", {
  contentConfig: {
    bucket: "${aws_s3_bucket.content_bucket.id}",
    storageClass: "Standard",
  },
  inputBucket: "${aws_s3_bucket.input_bucket.id}",
  name: "aws_elastictranscoder_pipeline_tf_test_",
  role: "${aws_iam_role.test_role.arn}",
  thumbnailConfig: {
    bucket: "${aws_s3_bucket.thumb_bucket.id}",
    storageClass: "Standard",
  },
});

Argument Reference

See "Create Pipeline" in the AWS docs for reference.

The following arguments are supported:

  • awsKmsKeyArn - (Optional) The AWS Key Management Service (AWS KMS) key that you want to use with this pipeline.
  • contentConfig - (Optional) The ContentConfig object specifies information about the Amazon S3 bucket in which you want Elastic Transcoder to save transcoded files and playlists. (documented below)
  • contentConfigPermissions - (Optional) The permissions for the contentConfig object. (documented below)
  • inputBucket - (Required) The Amazon S3 bucket in which you saved the media files that you want to transcode and the graphics that you want to use as watermarks.
  • name - (Optional, Forces new resource) The name of the pipeline. Maximum 40 characters
  • notifications - (Optional) The Amazon Simple Notification Service (Amazon SNS) topic that you want to notify to report job status. (documented below)
  • outputBucket - (Optional) The Amazon S3 bucket in which you want Elastic Transcoder to save the transcoded files.
  • role - (Required) The IAM Amazon Resource Name (ARN) for the role that you want Elastic Transcoder to use to transcode jobs for this pipeline.
  • thumbnailConfig - (Optional) The ThumbnailConfig object specifies information about the Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files. (documented below)
  • thumbnailConfigPermissions - (Optional) The permissions for the thumbnailConfig object. (documented below)

The contentConfig object specifies information about the Amazon S3 bucket in which you want Elastic Transcoder to save transcoded files and playlists: which bucket to use, and the storage class that you want to assign to the files. If you specify values for contentConfig, you must also specify values for thumbnailConfig. If you specify values for contentConfig and thumbnailConfig, omit the outputBucket object.

The contentConfig object supports the following:

  • bucket - The Amazon S3 bucket in which you want Elastic Transcoder to save transcoded files and playlists.
  • storageClass - The Amazon S3 storage class, standard or reducedRedundancy, that you want Elastic Transcoder to assign to the files and playlists that it stores in your Amazon S3 bucket.

The contentConfigPermissions object supports the following:

  • access - The permission that you want to give to the AWS user that you specified in contentConfigPermissionsGrantee. Valid values are read, readAcp, writeAcp or fullControl.
  • grantee - The AWS user or group that you want to have access to transcoded files and playlists.
  • granteeType - Specify the type of value that appears in the contentConfigPermissionsGrantee object. Valid values are canonical, email or group.

The notifications object supports the following:

  • completed - The topic ARN for the Amazon SNS topic that you want to notify when Elastic Transcoder has finished processing a job in this pipeline.
  • error - The topic ARN for the Amazon SNS topic that you want to notify when Elastic Transcoder encounters an error condition while processing a job in this pipeline.
  • progressing - The topic ARN for the Amazon Simple Notification Service (Amazon SNS) topic that you want to notify when Elastic Transcoder has started to process a job in this pipeline.
  • warning - The topic ARN for the Amazon SNS topic that you want to notify when Elastic Transcoder encounters a warning condition while processing a job in this pipeline.

The thumbnailConfig object specifies information about the Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files: which bucket to use, which users you want to have access to the files, the type of access you want users to have, and the storage class that you want to assign to the files. If you specify values for contentConfig, you must also specify values for thumbnailConfig even if you don't want to create thumbnails. (You control whether to create thumbnails when you create a job. For more information, see ThumbnailPattern in the topic Create Job.) If you specify values for contentConfig and thumbnailConfig, omit the OutputBucket object.

The thumbnailConfig object supports the following:

  • bucket - The Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files.
  • storageClass - The Amazon S3 storage class, Standard or ReducedRedundancy, that you want Elastic Transcoder to assign to the thumbnails that it stores in your Amazon S3 bucket.

The thumbnailConfigPermissions object supports the following:

  • access - The permission that you want to give to the AWS user that you specified in thumbnailConfigPermissionsGrantee. Valid values are read, readAcp, writeAcp or fullControl.
  • grantee - The AWS user or group that you want to have access to thumbnail files.
  • granteeType - Specify the type of value that appears in the thumbnailConfigPermissionsGrantee object. Valid values are canonical, email or group.

Attributes Reference

In addition to all arguments above, the following attributes are exported:

  • id - The ID of the Elastictranscoder pipeline.
  • arn - The ARN of the Elastictranscoder pipeline.

Import

Elastic Transcoder pipelines can be imported using the id, e.g.,

$ terraform import aws_elastictranscoder_pipeline.basic_pipeline 1407981661351-cttk8b