elastictranscoder

This provider is a derived work of the Terraform Provider distributed under MPL 2.0. If you encounter a bug or missing feature, first check the pulumi/pulumi-aws repo; however, if that doesn’t turn up anything, please consult the source terraform-providers/terraform-provider-aws repo.

class pulumi_aws.elastictranscoder.Pipeline(resource_name, opts=None, aws_kms_key_arn=None, content_config=None, content_config_permissions=None, input_bucket=None, name=None, notifications=None, output_bucket=None, role=None, thumbnail_config=None, thumbnail_config_permissions=None, __props__=None, __name__=None, __opts__=None)

Provides an Elastic Transcoder pipeline resource.

Parameters
  • resource_name (str) – The name of the resource.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • aws_kms_key_arn (pulumi.Input[str]) – The AWS Key Management Service (AWS KMS) key that you want to use with this pipeline.

  • content_config (pulumi.Input[dict]) – The ContentConfig object specifies information about the Amazon S3 bucket in which you want Elastic Transcoder to save transcoded files and playlists. (documented below)

  • content_config_permissions (pulumi.Input[list]) – The permissions for the content_config object. (documented below)

  • input_bucket (pulumi.Input[str]) – 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 (pulumi.Input[str]) – The name of the pipeline. Maximum 40 characters

  • notifications (pulumi.Input[dict]) – The Amazon Simple Notification Service (Amazon SNS) topic that you want to notify to report job status. (documented below)

  • output_bucket (pulumi.Input[str]) – The Amazon S3 bucket in which you want Elastic Transcoder to save the transcoded files.

  • role (pulumi.Input[str]) – The IAM Amazon Resource Name (ARN) for the role that you want Elastic Transcoder to use to transcode jobs for this pipeline.

  • thumbnail_config (pulumi.Input[dict]) – The ThumbnailConfig object specifies information about the Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files. (documented below)

  • thumbnail_config_permissions (pulumi.Input[list]) – The permissions for the thumbnail_config object. (documented below)

The content_config object supports the following:

  • bucket (pulumi.Input[str]) - The Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files.

  • storageClass (pulumi.Input[str]) - 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 content_config_permissions object supports the following:

  • accesses (pulumi.Input[list]) - The permission that you want to give to the AWS user that you specified in thumbnail_config_permissions.grantee.

  • grantee (pulumi.Input[str]) - The AWS user or group that you want to have access to thumbnail files.

  • granteeType (pulumi.Input[str]) - Specify the type of value that appears in the thumbnail_config_permissions.grantee object.

The notifications object supports the following:

  • completed (pulumi.Input[str]) - 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 (pulumi.Input[str]) - 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 (pulumi.Input[str]) - 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 (pulumi.Input[str]) - 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 thumbnail_config object supports the following:

  • bucket (pulumi.Input[str]) - The Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files.

  • storageClass (pulumi.Input[str]) - 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 thumbnail_config_permissions object supports the following:

  • accesses (pulumi.Input[list]) - The permission that you want to give to the AWS user that you specified in thumbnail_config_permissions.grantee.

  • grantee (pulumi.Input[str]) - The AWS user or group that you want to have access to thumbnail files.

  • granteeType (pulumi.Input[str]) - Specify the type of value that appears in the thumbnail_config_permissions.grantee object.

aws_kms_key_arn = None

The AWS Key Management Service (AWS KMS) key that you want to use with this pipeline.

content_config = None

The ContentConfig object specifies information about the Amazon S3 bucket in which you want Elastic Transcoder to save transcoded files and playlists. (documented below)

  • bucket (str) - The Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files.

  • storageClass (str) - 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.

content_config_permissions = None

The permissions for the content_config object. (documented below)

  • accesses (list) - The permission that you want to give to the AWS user that you specified in thumbnail_config_permissions.grantee.

  • grantee (str) - The AWS user or group that you want to have access to thumbnail files.

  • granteeType (str) - Specify the type of value that appears in the thumbnail_config_permissions.grantee object.

input_bucket = None

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 = None

The name of the pipeline. Maximum 40 characters

notifications = None

The Amazon Simple Notification Service (Amazon SNS) topic that you want to notify to report job status. (documented below)

  • completed (str) - 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 (str) - 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 (str) - 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 (str) - 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.

output_bucket = None

The Amazon S3 bucket in which you want Elastic Transcoder to save the transcoded files.

role = None

The IAM Amazon Resource Name (ARN) for the role that you want Elastic Transcoder to use to transcode jobs for this pipeline.

thumbnail_config = None

The ThumbnailConfig object specifies information about the Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files. (documented below)

  • bucket (str) - The Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files.

  • storageClass (str) - 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.

thumbnail_config_permissions = None

The permissions for the thumbnail_config object. (documented below)

  • accesses (list) - The permission that you want to give to the AWS user that you specified in thumbnail_config_permissions.grantee.

  • grantee (str) - The AWS user or group that you want to have access to thumbnail files.

  • granteeType (str) - Specify the type of value that appears in the thumbnail_config_permissions.grantee object.

static get(resource_name, id, opts=None, arn=None, aws_kms_key_arn=None, content_config=None, content_config_permissions=None, input_bucket=None, name=None, notifications=None, output_bucket=None, role=None, thumbnail_config=None, thumbnail_config_permissions=None)

Get an existing Pipeline resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • aws_kms_key_arn (pulumi.Input[str]) – The AWS Key Management Service (AWS KMS) key that you want to use with this pipeline.

  • content_config (pulumi.Input[dict]) – The ContentConfig object specifies information about the Amazon S3 bucket in which you want Elastic Transcoder to save transcoded files and playlists. (documented below)

  • content_config_permissions (pulumi.Input[list]) – The permissions for the content_config object. (documented below)

  • input_bucket (pulumi.Input[str]) – 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 (pulumi.Input[str]) – The name of the pipeline. Maximum 40 characters

  • notifications (pulumi.Input[dict]) – The Amazon Simple Notification Service (Amazon SNS) topic that you want to notify to report job status. (documented below)

  • output_bucket (pulumi.Input[str]) – The Amazon S3 bucket in which you want Elastic Transcoder to save the transcoded files.

  • role (pulumi.Input[str]) – The IAM Amazon Resource Name (ARN) for the role that you want Elastic Transcoder to use to transcode jobs for this pipeline.

  • thumbnail_config (pulumi.Input[dict]) – The ThumbnailConfig object specifies information about the Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files. (documented below)

  • thumbnail_config_permissions (pulumi.Input[list]) – The permissions for the thumbnail_config object. (documented below)

The content_config object supports the following:

  • bucket (pulumi.Input[str]) - The Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files.

  • storageClass (pulumi.Input[str]) - 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 content_config_permissions object supports the following:

  • accesses (pulumi.Input[list]) - The permission that you want to give to the AWS user that you specified in thumbnail_config_permissions.grantee.

  • grantee (pulumi.Input[str]) - The AWS user or group that you want to have access to thumbnail files.

  • granteeType (pulumi.Input[str]) - Specify the type of value that appears in the thumbnail_config_permissions.grantee object.

The notifications object supports the following:

  • completed (pulumi.Input[str]) - 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 (pulumi.Input[str]) - 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 (pulumi.Input[str]) - 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 (pulumi.Input[str]) - 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 thumbnail_config object supports the following:

  • bucket (pulumi.Input[str]) - The Amazon S3 bucket in which you want Elastic Transcoder to save thumbnail files.

  • storageClass (pulumi.Input[str]) - 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 thumbnail_config_permissions object supports the following:

  • accesses (pulumi.Input[list]) - The permission that you want to give to the AWS user that you specified in thumbnail_config_permissions.grantee.

  • grantee (pulumi.Input[str]) - The AWS user or group that you want to have access to thumbnail files.

  • granteeType (pulumi.Input[str]) - Specify the type of value that appears in the thumbnail_config_permissions.grantee object.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

class pulumi_aws.elastictranscoder.Preset(resource_name, opts=None, audio=None, audio_codec_options=None, container=None, description=None, name=None, thumbnails=None, type=None, video=None, video_codec_options=None, video_watermarks=None, __props__=None, __name__=None, __opts__=None)

Provides an Elastic Transcoder preset resource.

Parameters
  • resource_name (str) – The name of the resource.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • audio (pulumi.Input[dict]) – Audio parameters object (documented below).

  • audio_codec_options (pulumi.Input[dict]) – Codec options for the audio parameters (documented below)

  • container (pulumi.Input[str]) – The container type for the output file. Valid values are flac, flv, fmp4, gif, mp3, mp4, mpg, mxf, oga, ogg, ts, and webm.

  • description (pulumi.Input[str]) – A description of the preset (maximum 255 characters)

  • name (pulumi.Input[str]) – The name of the preset. (maximum 40 characters)

  • thumbnails (pulumi.Input[dict]) – Thumbnail parameters object (documented below)

  • video (pulumi.Input[dict]) – Video parameters object (documented below)

  • video_watermarks (pulumi.Input[list]) – Watermark parameters for the video parameters (documented below)

* `video_codec_options` (Optional, Forces new resource) Codec options for the video parameters

The audio object supports the following:

  • audioPackingMode (pulumi.Input[str]) - The method of organizing audio channels and tracks. Use Audio:Channels to specify the number of channels in your output, and Audio:AudioPackingMode to specify the number of tracks and their relation to the channels. If you do not specify an Audio:AudioPackingMode, Elastic Transcoder uses SingleTrack.

  • bitRate (pulumi.Input[str]) - The bit rate of the video stream in the output file, in kilobits/second. You can configure variable bit rate or constant bit rate encoding.

  • channels (pulumi.Input[str]) - The number of audio channels in the output file

  • codec (pulumi.Input[str]) - The video codec for the output file. Valid values are gif, H.264, mpeg2, vp8, and vp9.

  • sampleRate (pulumi.Input[str]) - The sample rate of the audio stream in the output file, in hertz. Valid values are: auto, 22050, 32000, 44100, 48000, 96000

The audio_codec_options object supports the following:

  • bitDepth (pulumi.Input[str]) - The bit depth of a sample is how many bits of information are included in the audio samples. Valid values are 16 and 24. (FLAC/PCM Only)

  • bitOrder (pulumi.Input[str]) - The order the bits of a PCM sample are stored in. The supported value is LittleEndian. (PCM Only)

  • profile (pulumi.Input[str]) - If you specified AAC for Audio:Codec, choose the AAC profile for the output file.

  • signed (pulumi.Input[str]) - Whether audio samples are represented with negative and positive numbers (signed) or only positive numbers (unsigned). The supported value is Signed. (PCM Only)

The thumbnails object supports the following:

  • aspectRatio (pulumi.Input[str]) - The display aspect ratio of the video in the output file. Valid values are: auto, 1:1, 4:3, 3:2, 16:9. (Note; to better control resolution and aspect ratio of output videos, we recommend that you use the values max_width, max_height, sizing_policy, padding_policy, and display_aspect_ratio instead of resolution and aspect_ratio.)

  • format (pulumi.Input[str]) - The format of thumbnails, if any. Valid formats are jpg and png.

  • interval (pulumi.Input[str]) - The approximate number of seconds between thumbnails. The value must be an integer. The actual interval can vary by several seconds from one thumbnail to the next.

  • maxHeight (pulumi.Input[str]) - The maximum height of the watermark.

  • maxWidth (pulumi.Input[str]) - The maximum width of the watermark.

  • paddingPolicy (pulumi.Input[str]) - When you set PaddingPolicy to Pad, Elastic Transcoder might add black bars to the top and bottom and/or left and right sides of the output video to make the total size of the output video match the values that you specified for max_width and max_height.

  • resolution (pulumi.Input[str]) - The width and height of the video in the output file, in pixels. Valid values are auto and widthxheight. (see note for aspect_ratio)

  • sizingPolicy (pulumi.Input[str]) - A value that controls scaling of the watermark. Valid values are: Fit, Stretch, ShrinkToFit

The video object supports the following:

  • aspectRatio (pulumi.Input[str]) - The display aspect ratio of the video in the output file. Valid values are: auto, 1:1, 4:3, 3:2, 16:9. (Note; to better control resolution and aspect ratio of output videos, we recommend that you use the values max_width, max_height, sizing_policy, padding_policy, and display_aspect_ratio instead of resolution and aspect_ratio.)

  • bitRate (pulumi.Input[str]) - The bit rate of the video stream in the output file, in kilobits/second. You can configure variable bit rate or constant bit rate encoding.

  • codec (pulumi.Input[str]) - The video codec for the output file. Valid values are gif, H.264, mpeg2, vp8, and vp9.

  • displayAspectRatio (pulumi.Input[str]) - The value that Elastic Transcoder adds to the metadata in the output file. If you set DisplayAspectRatio to auto, Elastic Transcoder chooses an aspect ratio that ensures square pixels. If you specify another option, Elastic Transcoder sets that value in the output file.

  • fixedGop (pulumi.Input[str]) - Whether to use a fixed value for Video:FixedGOP. Not applicable for containers of type gif. Valid values are true and false. Also known as, Fixed Number of Frames Between Keyframes.

  • frameRate (pulumi.Input[str]) - The frames per second for the video stream in the output file. The following values are valid: auto, 10, 15, 23.97, 24, 25, 29.97, 30, 50, 60.

  • keyframesMaxDist (pulumi.Input[str]) - The maximum number of frames between key frames. Not applicable for containers of type gif.

  • maxFrameRate (pulumi.Input[str]) - If you specify auto for FrameRate, Elastic Transcoder uses the frame rate of the input video for the frame rate of the output video, up to the maximum frame rate. If you do not specify a MaxFrameRate, Elastic Transcoder will use a default of 30.

  • maxHeight (pulumi.Input[str]) - The maximum height of the watermark.

  • maxWidth (pulumi.Input[str]) - The maximum width of the watermark.

  • paddingPolicy (pulumi.Input[str]) - When you set PaddingPolicy to Pad, Elastic Transcoder might add black bars to the top and bottom and/or left and right sides of the output video to make the total size of the output video match the values that you specified for max_width and max_height.

  • resolution (pulumi.Input[str]) - The width and height of the video in the output file, in pixels. Valid values are auto and widthxheight. (see note for aspect_ratio)

  • sizingPolicy (pulumi.Input[str]) - A value that controls scaling of the watermark. Valid values are: Fit, Stretch, ShrinkToFit

The video_watermarks object supports the following:

  • horizontalAlign (pulumi.Input[str]) - The horizontal position of the watermark unless you specify a nonzero value for horzontal_offset.

  • horizontalOffset (pulumi.Input[str]) - The amount by which you want the horizontal position of the watermark to be offset from the position specified by horizontal_align.

  • id (pulumi.Input[str]) - A unique identifier for the settings for one watermark. The value of Id can be up to 40 characters long. You can specify settings for up to four watermarks.

  • maxHeight (pulumi.Input[str]) - The maximum height of the watermark.

  • maxWidth (pulumi.Input[str]) - The maximum width of the watermark.

  • opacity (pulumi.Input[str]) - A percentage that indicates how much you want a watermark to obscure the video in the location where it appears.

  • sizingPolicy (pulumi.Input[str]) - A value that controls scaling of the watermark. Valid values are: Fit, Stretch, ShrinkToFit

  • target (pulumi.Input[str]) - A value that determines how Elastic Transcoder interprets values that you specified for video_watermarks.horizontal_offset, video_watermarks.vertical_offset, video_watermarks.max_width, and video_watermarks.max_height. Valid values are Content and Frame.

  • verticalAlign (pulumi.Input[str]) - The vertical position of the watermark unless you specify a nonzero value for vertical_align. Valid values are Top, Bottom, Center.

  • verticalOffset (pulumi.Input[str]) - The amount by which you want the vertical position of the watermark to be offset from the position specified by vertical_align

audio = None

Audio parameters object (documented below).

  • audioPackingMode (str) - The method of organizing audio channels and tracks. Use Audio:Channels to specify the number of channels in your output, and Audio:AudioPackingMode to specify the number of tracks and their relation to the channels. If you do not specify an Audio:AudioPackingMode, Elastic Transcoder uses SingleTrack.

  • bitRate (str) - The bit rate of the video stream in the output file, in kilobits/second. You can configure variable bit rate or constant bit rate encoding.

  • channels (str) - The number of audio channels in the output file

  • codec (str) - The video codec for the output file. Valid values are gif, H.264, mpeg2, vp8, and vp9.

  • sampleRate (str) - The sample rate of the audio stream in the output file, in hertz. Valid values are: auto, 22050, 32000, 44100, 48000, 96000

audio_codec_options = None

Codec options for the audio parameters (documented below)

  • bitDepth (str) - The bit depth of a sample is how many bits of information are included in the audio samples. Valid values are 16 and 24. (FLAC/PCM Only)

  • bitOrder (str) - The order the bits of a PCM sample are stored in. The supported value is LittleEndian. (PCM Only)

  • profile (str) - If you specified AAC for Audio:Codec, choose the AAC profile for the output file.

  • signed (str) - Whether audio samples are represented with negative and positive numbers (signed) or only positive numbers (unsigned). The supported value is Signed. (PCM Only)

container = None

The container type for the output file. Valid values are flac, flv, fmp4, gif, mp3, mp4, mpg, mxf, oga, ogg, ts, and webm.

description = None

A description of the preset (maximum 255 characters)

name = None

The name of the preset. (maximum 40 characters)

thumbnails = None

Thumbnail parameters object (documented below)

  • aspectRatio (str) - The display aspect ratio of the video in the output file. Valid values are: auto, 1:1, 4:3, 3:2, 16:9. (Note; to better control resolution and aspect ratio of output videos, we recommend that you use the values max_width, max_height, sizing_policy, padding_policy, and display_aspect_ratio instead of resolution and aspect_ratio.)

  • format (str) - The format of thumbnails, if any. Valid formats are jpg and png.

  • interval (str) - The approximate number of seconds between thumbnails. The value must be an integer. The actual interval can vary by several seconds from one thumbnail to the next.

  • maxHeight (str) - The maximum height of the watermark.

  • maxWidth (str) - The maximum width of the watermark.

  • paddingPolicy (str) - When you set PaddingPolicy to Pad, Elastic Transcoder might add black bars to the top and bottom and/or left and right sides of the output video to make the total size of the output video match the values that you specified for max_width and max_height.

  • resolution (str) - The width and height of the video in the output file, in pixels. Valid values are auto and widthxheight. (see note for aspect_ratio)

  • sizingPolicy (str) - A value that controls scaling of the watermark. Valid values are: Fit, Stretch, ShrinkToFit

video = None

Video parameters object (documented below)

  • aspectRatio (str) - The display aspect ratio of the video in the output file. Valid values are: auto, 1:1, 4:3, 3:2, 16:9. (Note; to better control resolution and aspect ratio of output videos, we recommend that you use the values max_width, max_height, sizing_policy, padding_policy, and display_aspect_ratio instead of resolution and aspect_ratio.)

  • bitRate (str) - The bit rate of the video stream in the output file, in kilobits/second. You can configure variable bit rate or constant bit rate encoding.

  • codec (str) - The video codec for the output file. Valid values are gif, H.264, mpeg2, vp8, and vp9.

  • displayAspectRatio (str) - The value that Elastic Transcoder adds to the metadata in the output file. If you set DisplayAspectRatio to auto, Elastic Transcoder chooses an aspect ratio that ensures square pixels. If you specify another option, Elastic Transcoder sets that value in the output file.

  • fixedGop (str) - Whether to use a fixed value for Video:FixedGOP. Not applicable for containers of type gif. Valid values are true and false. Also known as, Fixed Number of Frames Between Keyframes.

  • frameRate (str) - The frames per second for the video stream in the output file. The following values are valid: auto, 10, 15, 23.97, 24, 25, 29.97, 30, 50, 60.

  • keyframesMaxDist (str) - The maximum number of frames between key frames. Not applicable for containers of type gif.

  • maxFrameRate (str) - If you specify auto for FrameRate, Elastic Transcoder uses the frame rate of the input video for the frame rate of the output video, up to the maximum frame rate. If you do not specify a MaxFrameRate, Elastic Transcoder will use a default of 30.

  • maxHeight (str) - The maximum height of the watermark.

  • maxWidth (str) - The maximum width of the watermark.

  • paddingPolicy (str) - When you set PaddingPolicy to Pad, Elastic Transcoder might add black bars to the top and bottom and/or left and right sides of the output video to make the total size of the output video match the values that you specified for max_width and max_height.

  • resolution (str) - The width and height of the video in the output file, in pixels. Valid values are auto and widthxheight. (see note for aspect_ratio)

  • sizingPolicy (str) - A value that controls scaling of the watermark. Valid values are: Fit, Stretch, ShrinkToFit

video_watermarks = None

Watermark parameters for the video parameters (documented below)

  • video_codec_options (Optional, Forces new resource) Codec options for the video parameters

    • horizontalAlign (str) - The horizontal position of the watermark unless you specify a nonzero value for horzontal_offset.

    • horizontalOffset (str) - The amount by which you want the horizontal position of the watermark to be offset from the position specified by horizontal_align.

    • id (str) - A unique identifier for the settings for one watermark. The value of Id can be up to 40 characters long. You can specify settings for up to four watermarks.

    • maxHeight (str) - The maximum height of the watermark.

    • maxWidth (str) - The maximum width of the watermark.

    • opacity (str) - A percentage that indicates how much you want a watermark to obscure the video in the location where it appears.

    • sizingPolicy (str) - A value that controls scaling of the watermark. Valid values are: Fit, Stretch, ShrinkToFit

    • target (str) - A value that determines how Elastic Transcoder interprets values that you specified for video_watermarks.horizontal_offset, video_watermarks.vertical_offset, video_watermarks.max_width, and video_watermarks.max_height. Valid values are Content and Frame.

    • verticalAlign (str) - The vertical position of the watermark unless you specify a nonzero value for vertical_align. Valid values are Top, Bottom, Center.

    • verticalOffset (str) - The amount by which you want the vertical position of the watermark to be offset from the position specified by vertical_align

static get(resource_name, id, opts=None, arn=None, audio=None, audio_codec_options=None, container=None, description=None, name=None, thumbnails=None, type=None, video=None, video_codec_options=None, video_watermarks=None)

Get an existing Preset resource’s state with the given name, id, and optional extra properties used to qualify the lookup.

Parameters
  • resource_name (str) – The unique name of the resulting resource.

  • id (str) – The unique provider ID of the resource to lookup.

  • opts (pulumi.ResourceOptions) – Options for the resource.

  • audio (pulumi.Input[dict]) – Audio parameters object (documented below).

  • audio_codec_options (pulumi.Input[dict]) – Codec options for the audio parameters (documented below)

  • container (pulumi.Input[str]) – The container type for the output file. Valid values are flac, flv, fmp4, gif, mp3, mp4, mpg, mxf, oga, ogg, ts, and webm.

  • description (pulumi.Input[str]) – A description of the preset (maximum 255 characters)

  • name (pulumi.Input[str]) – The name of the preset. (maximum 40 characters)

  • thumbnails (pulumi.Input[dict]) – Thumbnail parameters object (documented below)

  • video (pulumi.Input[dict]) – Video parameters object (documented below)

  • video_watermarks (pulumi.Input[list]) – Watermark parameters for the video parameters (documented below)

* `video_codec_options` (Optional, Forces new resource) Codec options for the video parameters

The audio object supports the following:

  • audioPackingMode (pulumi.Input[str]) - The method of organizing audio channels and tracks. Use Audio:Channels to specify the number of channels in your output, and Audio:AudioPackingMode to specify the number of tracks and their relation to the channels. If you do not specify an Audio:AudioPackingMode, Elastic Transcoder uses SingleTrack.

  • bitRate (pulumi.Input[str]) - The bit rate of the video stream in the output file, in kilobits/second. You can configure variable bit rate or constant bit rate encoding.

  • channels (pulumi.Input[str]) - The number of audio channels in the output file

  • codec (pulumi.Input[str]) - The video codec for the output file. Valid values are gif, H.264, mpeg2, vp8, and vp9.

  • sampleRate (pulumi.Input[str]) - The sample rate of the audio stream in the output file, in hertz. Valid values are: auto, 22050, 32000, 44100, 48000, 96000

The audio_codec_options object supports the following:

  • bitDepth (pulumi.Input[str]) - The bit depth of a sample is how many bits of information are included in the audio samples. Valid values are 16 and 24. (FLAC/PCM Only)

  • bitOrder (pulumi.Input[str]) - The order the bits of a PCM sample are stored in. The supported value is LittleEndian. (PCM Only)

  • profile (pulumi.Input[str]) - If you specified AAC for Audio:Codec, choose the AAC profile for the output file.

  • signed (pulumi.Input[str]) - Whether audio samples are represented with negative and positive numbers (signed) or only positive numbers (unsigned). The supported value is Signed. (PCM Only)

The thumbnails object supports the following:

  • aspectRatio (pulumi.Input[str]) - The display aspect ratio of the video in the output file. Valid values are: auto, 1:1, 4:3, 3:2, 16:9. (Note; to better control resolution and aspect ratio of output videos, we recommend that you use the values max_width, max_height, sizing_policy, padding_policy, and display_aspect_ratio instead of resolution and aspect_ratio.)

  • format (pulumi.Input[str]) - The format of thumbnails, if any. Valid formats are jpg and png.

  • interval (pulumi.Input[str]) - The approximate number of seconds between thumbnails. The value must be an integer. The actual interval can vary by several seconds from one thumbnail to the next.

  • maxHeight (pulumi.Input[str]) - The maximum height of the watermark.

  • maxWidth (pulumi.Input[str]) - The maximum width of the watermark.

  • paddingPolicy (pulumi.Input[str]) - When you set PaddingPolicy to Pad, Elastic Transcoder might add black bars to the top and bottom and/or left and right sides of the output video to make the total size of the output video match the values that you specified for max_width and max_height.

  • resolution (pulumi.Input[str]) - The width and height of the video in the output file, in pixels. Valid values are auto and widthxheight. (see note for aspect_ratio)

  • sizingPolicy (pulumi.Input[str]) - A value that controls scaling of the watermark. Valid values are: Fit, Stretch, ShrinkToFit

The video object supports the following:

  • aspectRatio (pulumi.Input[str]) - The display aspect ratio of the video in the output file. Valid values are: auto, 1:1, 4:3, 3:2, 16:9. (Note; to better control resolution and aspect ratio of output videos, we recommend that you use the values max_width, max_height, sizing_policy, padding_policy, and display_aspect_ratio instead of resolution and aspect_ratio.)

  • bitRate (pulumi.Input[str]) - The bit rate of the video stream in the output file, in kilobits/second. You can configure variable bit rate or constant bit rate encoding.

  • codec (pulumi.Input[str]) - The video codec for the output file. Valid values are gif, H.264, mpeg2, vp8, and vp9.

  • displayAspectRatio (pulumi.Input[str]) - The value that Elastic Transcoder adds to the metadata in the output file. If you set DisplayAspectRatio to auto, Elastic Transcoder chooses an aspect ratio that ensures square pixels. If you specify another option, Elastic Transcoder sets that value in the output file.

  • fixedGop (pulumi.Input[str]) - Whether to use a fixed value for Video:FixedGOP. Not applicable for containers of type gif. Valid values are true and false. Also known as, Fixed Number of Frames Between Keyframes.

  • frameRate (pulumi.Input[str]) - The frames per second for the video stream in the output file. The following values are valid: auto, 10, 15, 23.97, 24, 25, 29.97, 30, 50, 60.

  • keyframesMaxDist (pulumi.Input[str]) - The maximum number of frames between key frames. Not applicable for containers of type gif.

  • maxFrameRate (pulumi.Input[str]) - If you specify auto for FrameRate, Elastic Transcoder uses the frame rate of the input video for the frame rate of the output video, up to the maximum frame rate. If you do not specify a MaxFrameRate, Elastic Transcoder will use a default of 30.

  • maxHeight (pulumi.Input[str]) - The maximum height of the watermark.

  • maxWidth (pulumi.Input[str]) - The maximum width of the watermark.

  • paddingPolicy (pulumi.Input[str]) - When you set PaddingPolicy to Pad, Elastic Transcoder might add black bars to the top and bottom and/or left and right sides of the output video to make the total size of the output video match the values that you specified for max_width and max_height.

  • resolution (pulumi.Input[str]) - The width and height of the video in the output file, in pixels. Valid values are auto and widthxheight. (see note for aspect_ratio)

  • sizingPolicy (pulumi.Input[str]) - A value that controls scaling of the watermark. Valid values are: Fit, Stretch, ShrinkToFit

The video_watermarks object supports the following:

  • horizontalAlign (pulumi.Input[str]) - The horizontal position of the watermark unless you specify a nonzero value for horzontal_offset.

  • horizontalOffset (pulumi.Input[str]) - The amount by which you want the horizontal position of the watermark to be offset from the position specified by horizontal_align.

  • id (pulumi.Input[str]) - A unique identifier for the settings for one watermark. The value of Id can be up to 40 characters long. You can specify settings for up to four watermarks.

  • maxHeight (pulumi.Input[str]) - The maximum height of the watermark.

  • maxWidth (pulumi.Input[str]) - The maximum width of the watermark.

  • opacity (pulumi.Input[str]) - A percentage that indicates how much you want a watermark to obscure the video in the location where it appears.

  • sizingPolicy (pulumi.Input[str]) - A value that controls scaling of the watermark. Valid values are: Fit, Stretch, ShrinkToFit

  • target (pulumi.Input[str]) - A value that determines how Elastic Transcoder interprets values that you specified for video_watermarks.horizontal_offset, video_watermarks.vertical_offset, video_watermarks.max_width, and video_watermarks.max_height. Valid values are Content and Frame.

  • verticalAlign (pulumi.Input[str]) - The vertical position of the watermark unless you specify a nonzero value for vertical_align. Valid values are Top, Bottom, Center.

  • verticalOffset (pulumi.Input[str]) - The amount by which you want the vertical position of the watermark to be offset from the position specified by vertical_align

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str

translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters

prop (str) – A property name.

Returns

A potentially transformed property name.

Return type

str