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

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_elastictranscoder_pipeline"
     4  sidebar_current: "docs-aws-resource-elastic-transcoder-pipeline"
     5  description: |-
     6    Provides an Elastic Transcoder pipeline resource.
     7  ---
     8  
     9  # aws\_elastictranscoder\_pipeline
    10  
    11  Provides an Elastic Transcoder pipeline resource.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  resource "aws_elastictranscoder_pipeline" "bar" {
    17    input_bucket = "${aws_s3_bucket.input_bucket.bucket}"
    18    name         = "aws_elastictranscoder_pipeline_tf_test_"
    19    role         = "${aws_iam_role.test_role.arn}"
    20  
    21    content_config = {
    22      bucket        = "${aws_s3_bucket.content_bucket.bucket}"
    23      storage_class = "Standard"
    24    }
    25  
    26    thumbnail_config = {
    27      bucket        = "${aws_s3_bucket.thumb_bucket.bucket}"
    28      storage_class = "Standard"
    29    }
    30  }
    31  ```
    32  
    33  ## Argument Reference
    34  
    35  See ["Create Pipeline"](http://docs.aws.amazon.com/elastictranscoder/latest/developerguide/create-pipeline.html) in the AWS docs for reference.
    36  
    37  The following arguments are supported:
    38  
    39  * `aws_kms_key_arn` - (Optional) The AWS Key Management Service (AWS KMS) key that you want to use with this pipeline.
    40  * `content_config` - (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)
    41  * `content_config_permissions` - (Optional) The permissions for the `content_config` object. (documented below)
    42  * `input_bucket` - (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.
    43  * `name` - (Optional, Forces new resource) The name of the pipeline. Maximum 40 characters
    44  * `notifications` - (Optional) The Amazon Simple Notification Service (Amazon SNS) topic that you want to notify to report job status. (documented below)
    45  * `output_bucket` - (Optional) The Amazon S3 bucket in which you want Elastic Transcoder to save the transcoded files.
    46  * `role` - (Required) The IAM Amazon Resource Name (ARN) for the role that you want Elastic Transcoder to use to transcode jobs for this pipeline.
    47  * `thumbnail_config` - (Optional) The ThumbnailConfig object specifies information about the Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files. (documented below)
    48  * `thumbnail_config_permissions` - (Optional) The permissions for the `thumbnail_config` object. (documented below)
    49  
    50  The `content_config` object specifies information about the Amazon S3 bucket in
    51  which you want Elastic Transcoder to save transcoded files and playlists: which
    52  bucket to use, and the storage class that you want to assign to the files. If
    53  you specify values for `content_config`, you must also specify values for
    54  `thumbnail_config`. If you specify values for `content_config` and
    55  `thumbnail_config`, omit the `output_bucket` object.
    56  
    57  The `content_config` object supports the following:
    58  
    59  * `bucket` - The Amazon S3 bucket in which you want Elastic Transcoder to save transcoded files and playlists.
    60  * `storage_class` - 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.
    61  
    62  The `content_config_permissions` object supports the following:
    63  * `access` - The permission that you want to give to the AWS user that you specified in `content_config_permissions.grantee`
    64  * `grantee` - The AWS user or group that you want to have access to transcoded files and playlists.
    65  * `grantee_type` - Specify the type of value that appears in the `content_config_permissions.grantee` object. Valid values are `Canonical`, `Email` or `Group`.
    66  
    67  
    68  The `notifications` object supports the following:
    69  
    70  * `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.
    71  * `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.
    72  * `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.
    73  * `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.
    74  
    75  The `thumbnail_config` object specifies information about the Amazon S3 bucket in
    76  which you want Elastic Transcoder to save thumbnail files: which bucket to use,
    77  which users you want to have access to the files, the type of access you want
    78  users to have, and the storage class that you want to assign to the files. If
    79  you specify values for `content_config`, you must also specify values for
    80  `thumbnail_config` even if you don't want to create thumbnails. (You control
    81  whether to create thumbnails when you create a job. For more information, see
    82  ThumbnailPattern in the topic Create Job.) If you specify values for
    83  `content_config` and `thumbnail_config`, omit the OutputBucket object.
    84  
    85  The `thumbnail_config` object supports the following:
    86  
    87  * `bucket` - The Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files.
    88  * `storage_class` - 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.
    89  
    90  The `thumbnail_config_permissions` object supports the following:
    91  
    92  * `access` - The permission that you want to give to the AWS user that you specified in `thumbnail_config_permissions.grantee`.
    93  * `grantee` - The AWS user or group that you want to have access to thumbnail files.
    94  * `grantee_type` - Specify the type of value that appears in the `thumbnail_config_permissions.grantee` object.