aws-sdk 1.9.5 → 1.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. data/lib/aws/api_config/DynamoDB-2012-08-10.yml +4 -0
  2. data/lib/aws/api_config/EC2-2013-02-01.yml +1 -1
  3. data/lib/aws/api_config/ElasticTranscoder-2012-09-25.yml +948 -19
  4. data/lib/aws/api_config/OpsWorks-2013-02-18.yml +83 -2
  5. data/lib/aws/auto_scaling/client.rb +15 -0
  6. data/lib/aws/cloud_formation/client.rb +11 -0
  7. data/lib/aws/cloud_front/client.rb +58 -40
  8. data/lib/aws/cloud_search/client.rb +20 -0
  9. data/lib/aws/cloud_watch/client.rb +5 -0
  10. data/lib/aws/core.rb +5 -4
  11. data/lib/aws/core/configuration.rb +3 -1
  12. data/lib/aws/core/policy.rb +27 -1
  13. data/lib/aws/data_pipeline/client.rb +12 -0
  14. data/lib/aws/direct_connect/client.rb +11 -0
  15. data/lib/aws/dynamo_db/client.rb +17 -0
  16. data/lib/aws/dynamo_db/client_v2.rb +905 -417
  17. data/lib/aws/ec2.rb +1 -1
  18. data/lib/aws/ec2/client.rb +88 -0
  19. data/lib/aws/ec2/instance.rb +3 -1
  20. data/lib/aws/ec2/security_group.rb +1 -1
  21. data/lib/aws/elastic_beanstalk/client.rb +21 -0
  22. data/lib/aws/elastic_transcoder/client.rb +681 -114
  23. data/lib/aws/elasticache/client.rb +23 -0
  24. data/lib/aws/elb/client.rb +13 -0
  25. data/lib/aws/emr/client.rb +3 -0
  26. data/lib/aws/glacier/client.rb +7 -0
  27. data/lib/aws/iam/client.rb +35 -0
  28. data/lib/aws/import_export/client.rb +5 -0
  29. data/lib/aws/ops_works/client.rb +718 -238
  30. data/lib/aws/rds/client.rb +46 -0
  31. data/lib/aws/redshift/client.rb +30 -0
  32. data/lib/aws/route_53/client.rb +10 -0
  33. data/lib/aws/s3.rb +1 -1
  34. data/lib/aws/s3/client.rb +42 -27
  35. data/lib/aws/s3/client/xml.rb +10 -0
  36. data/lib/aws/s3/multipart_upload.rb +43 -16
  37. data/lib/aws/s3/s3_object.rb +61 -26
  38. data/lib/aws/s3/uploaded_part.rb +3 -1
  39. data/lib/aws/s3/uploaded_part_collection.rb +1 -1
  40. data/lib/aws/simple_db/client.rb +10 -0
  41. data/lib/aws/simple_email_service/client.rb +11 -0
  42. data/lib/aws/simple_workflow/client.rb +18 -0
  43. data/lib/aws/sns/client.rb +9 -0
  44. data/lib/aws/sqs/client.rb +9 -0
  45. data/lib/aws/storage_gateway/client.rb +72 -37
  46. data/lib/aws/sts/client.rb +3 -0
  47. data/lib/aws/version.rb +1 -1
  48. metadata +17 -9
  49. checksums.yaml +0 -7
@@ -50,6 +50,8 @@ module AWS
50
50
  # * "terminate"] When the instance shuts down, it will be
51
51
  # terminated.
52
52
  #
53
+ # @attr [Boolean] source_dest_check
54
+ #
53
55
  # @attr_reader [String] image_id Image ID of the AMI used to
54
56
  # launch the instance.
55
57
  #
@@ -708,7 +710,7 @@ module AWS
708
710
  #
709
711
  # Given a completed export task you can download the final image:
710
712
  #
711
- # File.open('image.ova', 'w') {|f| f.write(task.s3_object.read) }
713
+ # File.open('image.ova', 'wb') {|f| f.write(task.s3_object.read) }
712
714
  #
713
715
  # @param [S3::Bucket,String] bucket The destination bucket. May
714
716
  # be the name of the bucket (string) or a {S3::Bucket} object. The
@@ -148,7 +148,7 @@ module AWS
148
148
 
149
149
  # Add an ingress rules to this security group.
150
150
  # Ingress rules permit inbound traffic over a given protocol for
151
- # a given port range from one or more souce ip addresses.
151
+ # a given port range from one or more source ip addresses.
152
152
  #
153
153
  # This example grants the whole internet (0.0.0.0/0) access to port 80
154
154
  # over TCP (HTTP web traffic).
@@ -30,6 +30,7 @@ module AWS
30
30
  # @return [Core::Response]
31
31
  # The #data method of the response object returns
32
32
  # a hash with the following structure:
33
+ #
33
34
  # * `:available` - (Boolean)
34
35
  # * `:fully_qualified_cname` - (String)
35
36
 
@@ -44,6 +45,7 @@ module AWS
44
45
  # @return [Core::Response]
45
46
  # The #data method of the response object returns
46
47
  # a hash with the following structure:
48
+ #
47
49
  # * `:application` - (Hash)
48
50
  # * `:application_name` - (String)
49
51
  # * `:description` - (String)
@@ -90,6 +92,7 @@ module AWS
90
92
  # @return [Core::Response]
91
93
  # The #data method of the response object returns
92
94
  # a hash with the following structure:
95
+ #
93
96
  # * `:application_version` - (Hash)
94
97
  # * `:application_name` - (String)
95
98
  # * `:description` - (String)
@@ -153,6 +156,7 @@ module AWS
153
156
  # @return [Core::Response]
154
157
  # The #data method of the response object returns
155
158
  # a hash with the following structure:
159
+ #
156
160
  # * `:solution_stack_name` - (String)
157
161
  # * `:application_name` - (String)
158
162
  # * `:template_name` - (String)
@@ -227,6 +231,7 @@ module AWS
227
231
  # @return [Core::Response]
228
232
  # The #data method of the response object returns
229
233
  # a hash with the following structure:
234
+ #
230
235
  # * `:environment_name` - (String)
231
236
  # * `:environment_id` - (String)
232
237
  # * `:application_name` - (String)
@@ -254,6 +259,7 @@ module AWS
254
259
  # @return [Core::Response]
255
260
  # The #data method of the response object returns
256
261
  # a hash with the following structure:
262
+ #
257
263
  # * `:s3_bucket` - (String)
258
264
 
259
265
  # @!method delete_application(options = {})
@@ -308,6 +314,7 @@ module AWS
308
314
  # @return [Core::Response]
309
315
  # The #data method of the response object returns
310
316
  # a hash with the following structure:
317
+ #
311
318
  # * `:application_versions` - (Array<Hash>)
312
319
  # * `:application_name` - (String)
313
320
  # * `:description` - (String)
@@ -327,6 +334,7 @@ module AWS
327
334
  # @return [Core::Response]
328
335
  # The #data method of the response object returns
329
336
  # a hash with the following structure:
337
+ #
330
338
  # * `:applications` - (Array<Hash>)
331
339
  # * `:application_name` - (String)
332
340
  # * `:description` - (String)
@@ -356,6 +364,7 @@ module AWS
356
364
  # @return [Core::Response]
357
365
  # The #data method of the response object returns
358
366
  # a hash with the following structure:
367
+ #
359
368
  # * `:solution_stack_name` - (String)
360
369
  # * `:options` - (Array<Hash>)
361
370
  # * `:namespace` - (String)
@@ -392,6 +401,7 @@ module AWS
392
401
  # @return [Core::Response]
393
402
  # The #data method of the response object returns
394
403
  # a hash with the following structure:
404
+ #
395
405
  # * `:configuration_settings` - (Array<Hash>)
396
406
  # * `:solution_stack_name` - (String)
397
407
  # * `:application_name` - (String)
@@ -421,6 +431,7 @@ module AWS
421
431
  # @return [Core::Response]
422
432
  # The #data method of the response object returns
423
433
  # a hash with the following structure:
434
+ #
424
435
  # * `:environment_resources` - (Hash)
425
436
  # * `:environment_name` - (String)
426
437
  # * `:auto_scaling_groups` - (Array<Hash>)
@@ -459,6 +470,7 @@ module AWS
459
470
  # @return [Core::Response]
460
471
  # The #data method of the response object returns
461
472
  # a hash with the following structure:
473
+ #
462
474
  # * `:environments` - (Array<Hash>)
463
475
  # * `:environment_name` - (String)
464
476
  # * `:environment_id` - (String)
@@ -524,6 +536,7 @@ module AWS
524
536
  # @return [Core::Response]
525
537
  # The #data method of the response object returns
526
538
  # a hash with the following structure:
539
+ #
527
540
  # * `:events` - (Array<Hash>)
528
541
  # * `:event_date` - (Time)
529
542
  # * `:message` - (String)
@@ -541,6 +554,7 @@ module AWS
541
554
  # @return [Core::Response]
542
555
  # The #data method of the response object returns
543
556
  # a hash with the following structure:
557
+ #
544
558
  # * `:solution_stacks` - (Array<String>)
545
559
  # * `:solution_stack_details` - (Array<Hash>)
546
560
  # * `:solution_stack_name` - (String)
@@ -611,6 +625,7 @@ module AWS
611
625
  # @return [Core::Response]
612
626
  # The #data method of the response object returns
613
627
  # a hash with the following structure:
628
+ #
614
629
  # * `:environment_info` - (Array<Hash>)
615
630
  # * `:info_type` - (String)
616
631
  # * `:ec2_instance_id` - (String)
@@ -668,6 +683,7 @@ module AWS
668
683
  # @return [Core::Response]
669
684
  # The #data method of the response object returns
670
685
  # a hash with the following structure:
686
+ #
671
687
  # * `:environment_name` - (String)
672
688
  # * `:environment_id` - (String)
673
689
  # * `:application_name` - (String)
@@ -701,6 +717,7 @@ module AWS
701
717
  # @return [Core::Response]
702
718
  # The #data method of the response object returns
703
719
  # a hash with the following structure:
720
+ #
704
721
  # * `:application` - (Hash)
705
722
  # * `:application_name` - (String)
706
723
  # * `:description` - (String)
@@ -723,6 +740,7 @@ module AWS
723
740
  # @return [Core::Response]
724
741
  # The #data method of the response object returns
725
742
  # a hash with the following structure:
743
+ #
726
744
  # * `:application_version` - (Hash)
727
745
  # * `:application_name` - (String)
728
746
  # * `:description` - (String)
@@ -761,6 +779,7 @@ module AWS
761
779
  # @return [Core::Response]
762
780
  # The #data method of the response object returns
763
781
  # a hash with the following structure:
782
+ #
764
783
  # * `:solution_stack_name` - (String)
765
784
  # * `:application_name` - (String)
766
785
  # * `:template_name` - (String)
@@ -817,6 +836,7 @@ module AWS
817
836
  # @return [Core::Response]
818
837
  # The #data method of the response object returns
819
838
  # a hash with the following structure:
839
+ #
820
840
  # * `:environment_name` - (String)
821
841
  # * `:environment_id` - (String)
822
842
  # * `:application_name` - (String)
@@ -860,6 +880,7 @@ module AWS
860
880
  # @return [Core::Response]
861
881
  # The #data method of the response object returns
862
882
  # a hash with the following structure:
883
+ #
863
884
  # * `:messages` - (Array<Hash>)
864
885
  # * `:message` - (String)
865
886
  # * `:severity` - (String)
@@ -46,13 +46,13 @@ module AWS
46
46
  # @!method create_job(options = {})
47
47
  # Calls the POST CreateJob API operation.
48
48
  # @param [Hash] options
49
- # * `:pipeline_id` - *required* - (String) The Id of the pipeline that
50
- # you want Elastic Transcoder to use for transcoding. The pipeline
51
- # determines several settings, including the Amazon S3 bucket from
52
- # which Elastic Transcoder gets the files to transcode and the bucket
53
- # into which Elastic Transcoder puts the transcoded files.
54
- # * `:input` - *required* - (Hash) A section of the request body that
55
- # provides information about the file that is being transcoded.
49
+ # * `:pipeline_id` - (String) The Id of the pipeline that you want
50
+ # Elastic Transcoder to use for transcoding. The pipeline determines
51
+ # several settings, including the Amazon S3 bucket from which Elastic
52
+ # Transcoder gets the files to transcode and the bucket into which
53
+ # Elastic Transcoder puts the transcoded files.
54
+ # * `:input` - (Hash) A section of the request body that provides
55
+ # information about the file that is being transcoded.
56
56
  # * `:key` - (String) The name of the file to transcode. Elsewhere in
57
57
  # the body of the JSON block is the the ID of the pipeline to use for
58
58
  # processing the job. The InputBucket object in that pipeline tells
@@ -67,13 +67,9 @@ module AWS
67
67
  # 23.97, 24, 25, 29.97, 30, 60 If you specify a value other than
68
68
  # auto, Elastic Transcoder disables automatic detection of the frame
69
69
  # rate.
70
- # * `:resolution` - (String) The resolution, in pixels, of the input
71
- # file. If you want Elastic Transcoder to automatically detect the
72
- # resolution of the input file, specify auto. If you want to specify
73
- # the resolution for the input file, enter values in the format width
74
- # in pixels by height in pixels. If you specify a value other than
75
- # auto, Elastic Transcoder disables automatic detection of the
76
- # resolution.
70
+ # * `:resolution` - (String) This value must be auto, which causes
71
+ # Elastic Transcoder to automatically detect the resolution of the
72
+ # input file.
77
73
  # * `:aspect_ratio` - (String) The aspect ratio of the input file. If
78
74
  # you want Elastic Transcoder to automatically detect the aspect
79
75
  # ratio of the input file, specify auto. If you want to specify the
@@ -93,8 +89,7 @@ module AWS
93
89
  # container type for the input file, enter one of the following
94
90
  # values: 3gp, asf, avi, divx, flv, mkv, mov, mp4, mpeg, mpeg-ps,
95
91
  # mpeg-ts, mxf, ogg, vob, wav, webm
96
- # * `:output` - *required* - (Hash) A section of the request body that
97
- # provides information about the transcoded (target) file.
92
+ # * `:output` - (Hash)
98
93
  # * `:key` - (String) The name to assign to the transcoded file.
99
94
  # Elastic Transcoder saves the file in the Amazon S3 bucket specified
100
95
  # by the OutputBucket object in the pipeline that is specified by the
@@ -127,15 +122,87 @@ module AWS
127
122
  # applicable file name extension.
128
123
  # * `:rotate` - (String) The number of degrees clockwise by which you
129
124
  # want Elastic Transcoder to rotate the output relative to the input.
130
- # Enter one of the following values: auto, 0, 90, 180, 270 The value
125
+ # Enter one of the following values: auto, 0, 90, 180, 270. The value
131
126
  # auto generally works only if the file that you're transcoding
132
127
  # contains rotation metadata.
133
128
  # * `:preset_id` - (String) The Id of the preset to use for this job.
134
129
  # The preset determines the audio, video, and thumbnail settings that
135
130
  # Elastic Transcoder uses for transcoding.
131
+ # * `:segment_duration` - (String) If you specify a preset in PresetId
132
+ # for which the value of Container is ts (MPEG-TS), SegmentDuration
133
+ # is the duration of each .ts file in seconds. The range of valid
134
+ # values is 1 to 60 seconds.
135
+ # * `:outputs` - (Array<Hash>) A section of the request body that
136
+ # provides information about the transcoded (target) files. We
137
+ # recommend that you use the Outputs syntax instead of the Output
138
+ # syntax.
139
+ # * `:key` - (String) The name to assign to the transcoded file.
140
+ # Elastic Transcoder saves the file in the Amazon S3 bucket specified
141
+ # by the OutputBucket object in the pipeline that is specified by the
142
+ # pipeline ID. If a file with the specified name already exists in
143
+ # the output bucket, the job fails.
144
+ # * `:thumbnail_pattern` - (String) Whether you want Elastic Transcoder
145
+ # to create thumbnails for your videos and, if so, how you want
146
+ # Elastic Transcoder to name the files. If you don't want Elastic
147
+ # Transcoder to create thumbnails, specify "". If you do want Elastic
148
+ # Transcoder to create thumbnails, specify the information that you
149
+ # want to include in the file name for each thumbnail. You can
150
+ # specify the following values in any sequence: {count} (Required):
151
+ # If you want to create thumbnails, you must include {count} in the
152
+ # ThumbnailPattern object. Wherever you specify {count}, Elastic
153
+ # Transcoder adds a five-digit sequence number (beginning with 00001)
154
+ # to thumbnail file names. The number indicates where a given
155
+ # thumbnail appears in the sequence of thumbnails for a transcoded
156
+ # file. If you specify a literal value and/or {resolution} but you
157
+ # omit {count}, Elastic Transcoder returns a validation error and
158
+ # does not create the job. Literal values (Optional): You can specify
159
+ # literal values anywhere in the ThumbnailPattern object. For
160
+ # example, you can include them as a file name prefix or as a
161
+ # delimiter between {resolution} and {count}. {resolution}
162
+ # (Optional): If you want Elastic Transcoder to include the
163
+ # resolution in the file name, include {resolution} in the
164
+ # ThumbnailPattern object. When creating thumbnails, Elastic
165
+ # Transcoder automatically saves the files in the format (.jpg or
166
+ # .png) that appears in the preset that you specified in the PresetID
167
+ # value of CreateJobOutput. Elastic Transcoder also appends the
168
+ # applicable file name extension.
169
+ # * `:rotate` - (String) The number of degrees clockwise by which you
170
+ # want Elastic Transcoder to rotate the output relative to the input.
171
+ # Enter one of the following values: auto, 0, 90, 180, 270. The value
172
+ # auto generally works only if the file that you're transcoding
173
+ # contains rotation metadata.
174
+ # * `:preset_id` - (String) The Id of the preset to use for this job.
175
+ # The preset determines the audio, video, and thumbnail settings that
176
+ # Elastic Transcoder uses for transcoding.
177
+ # * `:segment_duration` - (String) If you specify a preset in PresetId
178
+ # for which the value of Container is ts (MPEG-TS), SegmentDuration
179
+ # is the duration of each .ts file in seconds. The range of valid
180
+ # values is 1 to 60 seconds.
181
+ # * `:output_key_prefix` - (String) The value, if any, that you want
182
+ # Elastic Transcoder to prepend to the names of all files that this job
183
+ # creates, including output files, thumbnails, and playlists.
184
+ # * `:playlists` - (Array<Hash>) If you specify a preset in PresetId for
185
+ # which the value of Container is ts (MPEG-TS), Playlists contains
186
+ # information about the master playlists that you want Elastic
187
+ # Transcoder to create. We recommend that you create only one master
188
+ # playlist. The maximum number of master playlists in a job is 30.
189
+ # * `:name` - (String) The name that you want Elastic Transcoder to
190
+ # assign to the master playlist, for example, nyc-vacation.m3u8. The
191
+ # name cannot include a / character. If you create more than one
192
+ # master playlist (not recommended), the values of all Name objects
193
+ # must be unique. Elastic Transcoder automatically appends .m3u8 to
194
+ # the file name. If you include .m3u8 in Name, it will appear twice
195
+ # in the file name.
196
+ # * `:format` - (String) This value must currently be HLSv3.
197
+ # * `:output_keys` - (Array<String>) For each output in this job that
198
+ # you want to include in a master playlist, the value of the
199
+ # Outputs:Key object. If you include more than one output in a
200
+ # playlist, the value of SegmentDuration for all of the outputs must
201
+ # be the same.
136
202
  # @return [Core::Response]
137
203
  # The #data method of the response object returns
138
204
  # a hash with the following structure:
205
+ #
139
206
  # * `:job` - (Hash)
140
207
  # * `:id` - (String)
141
208
  # * `:pipeline_id` - (String)
@@ -147,37 +214,84 @@ module AWS
147
214
  # * `:interlaced` - (String)
148
215
  # * `:container` - (String)
149
216
  # * `:output` - (Hash)
217
+ # * `:id` - (String)
218
+ # * `:key` - (String)
219
+ # * `:thumbnail_pattern` - (String)
220
+ # * `:rotate` - (String)
221
+ # * `:preset_id` - (String)
222
+ # * `:segment_duration` - (String)
223
+ # * `:status` - (String)
224
+ # * `:status_detail` - (String)
225
+ # * `:duration` - (Integer)
226
+ # * `:width` - (Integer)
227
+ # * `:height` - (Integer)
228
+ # * `:outputs` - (Array<Hash>)
229
+ # * `:id` - (String)
150
230
  # * `:key` - (String)
151
231
  # * `:thumbnail_pattern` - (String)
152
232
  # * `:rotate` - (String)
153
233
  # * `:preset_id` - (String)
234
+ # * `:segment_duration` - (String)
235
+ # * `:status` - (String)
236
+ # * `:status_detail` - (String)
237
+ # * `:duration` - (Integer)
238
+ # * `:width` - (Integer)
239
+ # * `:height` - (Integer)
240
+ # * `:output_key_prefix` - (String)
241
+ # * `:playlists` - (Array<Hash>)
242
+ # * `:name` - (String)
243
+ # * `:format` - (String)
244
+ # * `:output_keys` - (Array<String>)
154
245
  # * `:status` - (String)
155
246
  # * `:status_detail` - (String)
247
+ # * `:status` - (String)
156
248
 
157
249
  # @!method create_pipeline(options = {})
158
250
  # Calls the POST CreatePipeline API operation.
159
251
  # @param [Hash] options
160
- # * `:name` - *required* - (String) The name of the pipeline. We
161
- # recommend that the name be unique within the AWS account, but
162
- # uniqueness is not enforced. Constraints: Maximum 40 characters.
163
- # * `:input_bucket` - *required* - (String) The Amazon S3 bucket in which
164
- # you saved the media files that you want to transcode.
165
- # * `:output_bucket` - *required* - (String) The Amazon S3 bucket in
166
- # which you want Elastic Transcoder to save the transcoded files.
167
- # * `:role` - *required* - (String) The IAM Amazon Resource Name (ARN)
168
- # for the role that you want Elastic Transcoder to use to create the
169
- # pipeline.
170
- # * `:notifications` - *required* - (Hash) The Amazon Simple Notification
171
- # Service (Amazon SNS) topic that you want to notify to report job
172
- # status. To receive notifications, you must also subscribe to the new
173
- # topic in the Amazon SNS console. Progressing: The Amazon Simple
174
- # Notification Service (Amazon SNS) topic that you want to notify when
175
- # Elastic Transcoder has started to process the job. Completed: The
176
- # Amazon SNS topic that you want to notify when Elastic Transcoder has
177
- # finished processing the job. Warning: The Amazon SNS topic that you
178
- # want to notify when Elastic Transcoder encounters a warning
179
- # condition. Error: The Amazon SNS topic that you want to notify when
180
- # Elastic Transcoder encounters an error condition.
252
+ # * `:name` - (String) The name of the pipeline. We recommend that the
253
+ # name be unique within the AWS account, but uniqueness is not
254
+ # enforced. Constraints: Maximum 40 characters.
255
+ # * `:input_bucket` - (String) The Amazon S3 bucket in which you saved
256
+ # the media files that you want to transcode.
257
+ # * `:output_bucket` - (String) The Amazon S3 bucket in which you want
258
+ # Elastic Transcoder to save the transcoded files. (Use this, or use
259
+ # ContentConfig:Bucket plus ThumbnailConfig:Bucket.) Specify this value
260
+ # when all of the following are `true` : You want to save transcoded
261
+ # files, thumbnails (if any), and playlists (if any) together in one
262
+ # bucket. You do not want to specify the users or groups who have
263
+ # access to the transcoded files, thumbnails, and playlists. You do not
264
+ # want to specify the permissions that Elastic Transcoder grants to the
265
+ # files. When Elastic Transcoder saves files in OutputBucket, it grants
266
+ # full control over the files only to the AWS account that owns the
267
+ # role that is specified by Role. You want to associate the transcoded
268
+ # files and thumbnails with the Amazon S3 Standard storage class. If
269
+ # you want to save transcoded files and playlists in one bucket and
270
+ # thumbnails in another bucket, specify which users can access the
271
+ # transcoded files or the permissions the users have, or change the
272
+ # Amazon S3 storage class, omit OutputBucket and specify values for
273
+ # ContentConfig and ThumbnailConfig instead.
274
+ # * `:role` - (String) The IAM Amazon Resource Name (ARN) for the role
275
+ # that you want Elastic Transcoder to use to create the pipeline.
276
+ # * `:notifications` - (Hash) The Amazon Simple Notification Service
277
+ # (Amazon SNS) topic that you want to notify to report job status. To
278
+ # receive notifications, you must also subscribe to the new topic in
279
+ # the Amazon SNS console. Progressing: The topic ARN for the Amazon
280
+ # Simple Notification Service (Amazon SNS) topic that you want to
281
+ # notify when Elastic Transcoder has started to process a job in this
282
+ # pipeline. This is the ARN that Amazon SNS returned when you created
283
+ # the topic. For more information, see Create a Topic in the Amazon
284
+ # Simple Notification Service Developer Guide. Completed: The topic ARN
285
+ # for the Amazon SNS topic that you want to notify when Elastic
286
+ # Transcoder has finished processing a job in this pipeline. This is
287
+ # the ARN that Amazon SNS returned when you created the topic. Warning:
288
+ # The topic ARN for the Amazon SNS topic that you want to notify when
289
+ # Elastic Transcoder encounters a warning condition while processing a
290
+ # job in this pipeline. This is the ARN that Amazon SNS returned when
291
+ # you created the topic. Error: The topic ARN for the Amazon SNS topic
292
+ # that you want to notify when Elastic Transcoder encounters an error
293
+ # condition while processing a job in this pipeline. This is the ARN
294
+ # that Amazon SNS returned when you created the topic.
181
295
  # * `:progressing` - (String) The Amazon Simple Notification Service
182
296
  # (Amazon SNS) topic that you want to notify when Elastic Transcoder
183
297
  # has started to process the job.
@@ -187,11 +301,111 @@ module AWS
187
301
  # when Elastic Transcoder encounters a warning condition.
188
302
  # * `:error` - (String) The Amazon SNS topic that you want to notify
189
303
  # when Elastic Transcoder encounters an error condition.
304
+ # * `:content_config` - (Hash) The optional ContentConfig object
305
+ # specifies information about the Amazon S3 bucket in which you want
306
+ # Elastic Transcoder to save transcoded files and playlists: which
307
+ # bucket to use, which users you want to have access to the files, the
308
+ # type of access you want users to have, and the storage class that you
309
+ # want to assign to the files. If you specify values for ContentConfig,
310
+ # you must also specify values for ThumbnailConfig. If you specify
311
+ # values for ContentConfig and ThumbnailConfig, omit the OutputBucket
312
+ # object. Bucket: The Amazon S3 bucket in which you want Elastic
313
+ # Transcoder to save transcoded files and playlists. Permissions
314
+ # (Optional): The Permissions object specifies which users you want to
315
+ # have access to transcoded files and the type of access you want them
316
+ # to have. You can grant permissions to a maximum of 30 users and/or
317
+ # predefined Amazon S3 groups. Grantee Type: Specify the type of value
318
+ # that appears in the Grantee object: Canonical: The value in the
319
+ # Grantee object is either the canonical user ID for an AWS account or
320
+ # an origin access identity for an Amazon CloudFront distribution. For
321
+ # more information about canonical user IDs, see Access Control List
322
+ # (ACL) Overview in the Amazon Simple Storage Service Developer Guide.
323
+ # For more information about using CloudFront origin access identities
324
+ # to require that users use CloudFront URLs instead of Amazon S3 URLs,
325
+ # see Using an Origin Access Identity to Restrict Access to Your Amazon
326
+ # S3 Content. A canonical user ID is not the same as an AWS account
327
+ # number. Email: The value in the Grantee object is the registered
328
+ # email address of an AWS account. Group: The value in the Grantee
329
+ # object is one of the following predefined Amazon S3 groups: AllUsers,
330
+ # AuthenticatedUsers, or LogDelivery. Grantee: The AWS user or group
331
+ # that you want to have access to transcoded files and playlists. To
332
+ # identify the user or group, you can specify the canonical user ID for
333
+ # an AWS account, an origin access identity for a CloudFront
334
+ # distribution, the registered email address of an AWS account, or a
335
+ # predefined Amazon S3 group Access: The permission that you want to
336
+ # give to the AWS user that you specified in Grantee. Permissions are
337
+ # granted on the files that Elastic Transcoder adds to the bucket,
338
+ # including playlists and video files. Valid values include: READ: The
339
+ # grantee can read the objects and metadata for objects that Elastic
340
+ # Transcoder adds to the Amazon S3 bucket. READ_ACP: The grantee can
341
+ # read the object ACL for objects that Elastic Transcoder adds to the
342
+ # Amazon S3 bucket. WRITE_ACP: The grantee can write the ACL for the
343
+ # objects that Elastic Transcoder adds to the Amazon S3 bucket.
344
+ # FULL_CONTROL: The grantee has READ, READ_ACP, and WRITE_ACP
345
+ # permissions for the objects that Elastic Transcoder adds to the
346
+ # Amazon S3 bucket. StorageClass: The Amazon S3 storage class, Standard
347
+ # or ReducedRedundancy, that you want Elastic Transcoder to assign to
348
+ # the video files and playlists that it stores in your Amazon S3
349
+ # bucket.
350
+ # * `:bucket` - (String)
351
+ # * `:storage_class` - (String)
352
+ # * `:permissions` - (Array<Hash>)
353
+ # * `:grantee_type` - (String)
354
+ # * `:grantee` - (String)
355
+ # * `:access` - (Array<String>)
356
+ # * `:thumbnail_config` - (Hash) The ThumbnailConfig object specifies
357
+ # several values, including the Amazon S3 bucket in which you want
358
+ # Elastic Transcoder to save thumbnail files, which users you want to
359
+ # have access to the files, the type of access you want users to have,
360
+ # and the storage class that you want to assign to the files. If you
361
+ # specify values for ContentConfig, you must also specify values for
362
+ # ThumbnailConfig even if you don't want to create thumbnails. If you
363
+ # specify values for ContentConfig and ThumbnailConfig, omit the
364
+ # OutputBucket object. Bucket: The Amazon S3 bucket in which you want
365
+ # Elastic Transcoder to save thumbnail files. Permissions (Optional):
366
+ # The Permissions object specifies which users and/or predefined Amazon
367
+ # S3 groups you want to have access to thumbnail files, and the type of
368
+ # access you want them to have. You can grant permissions to a maximum
369
+ # of 30 users and/or predefined Amazon S3 groups. GranteeType: Specify
370
+ # the type of value that appears in the Grantee object: Canonical: The
371
+ # value in the Grantee object is either the canonical user ID for an
372
+ # AWS account or an origin access identity for an Amazon CloudFront
373
+ # distribution. A canonical user ID is not the same as an AWS account
374
+ # number. Email: The value in the Grantee object is the registered
375
+ # email address of an AWS account. Group: The value in the Grantee
376
+ # object is one of the following predefined Amazon S3 groups: AllUsers,
377
+ # AuthenticatedUsers, or LogDelivery. Grantee: The AWS user or group
378
+ # that you want to have access to thumbnail files. To identify the user
379
+ # or group, you can specify the canonical user ID for an AWS account,
380
+ # an origin access identity for a CloudFront distribution, the
381
+ # registered email address of an AWS account, or a predefined Amazon S3
382
+ # group. Access: The permission that you want to give to the AWS user
383
+ # that you specified in Grantee. Permissions are granted on the
384
+ # thumbnail files that Elastic Transcoder adds to the bucket. Valid
385
+ # values include: READ: The grantee can read the thumbnails and
386
+ # metadata for objects that Elastic Transcoder adds to the Amazon S3
387
+ # bucket. READ_ACP: The grantee can read the object ACL for thumbnails
388
+ # that Elastic Transcoder adds to the Amazon S3 bucket. WRITE_ACP: The
389
+ # grantee can write the ACL for the thumbnails that Elastic Transcoder
390
+ # adds to the Amazon S3 bucket. FULL_CONTROL: The grantee has READ,
391
+ # READ_ACP, and WRITE_ACP permissions for the thumbnails that Elastic
392
+ # Transcoder adds to the Amazon S3 bucket. StorageClass: The Amazon S3
393
+ # storage class, Standard or ReducedRedundancy, that you want Elastic
394
+ # Transcoder to assign to the thumbnails that it stores in your Amazon
395
+ # S3 bucket.
396
+ # * `:bucket` - (String)
397
+ # * `:storage_class` - (String)
398
+ # * `:permissions` - (Array<Hash>)
399
+ # * `:grantee_type` - (String)
400
+ # * `:grantee` - (String)
401
+ # * `:access` - (Array<String>)
190
402
  # @return [Core::Response]
191
403
  # The #data method of the response object returns
192
404
  # a hash with the following structure:
405
+ #
193
406
  # * `:pipeline` - (Hash)
194
407
  # * `:id` - (String)
408
+ # * `:arn` - (String)
195
409
  # * `:name` - (String)
196
410
  # * `:status` - (String)
197
411
  # * `:input_bucket` - (String)
@@ -202,20 +416,34 @@ module AWS
202
416
  # * `:completed` - (String)
203
417
  # * `:warning` - (String)
204
418
  # * `:error` - (String)
419
+ # * `:content_config` - (Hash)
420
+ # * `:bucket` - (String)
421
+ # * `:storage_class` - (String)
422
+ # * `:permissions` - (Array<Hash>)
423
+ # * `:grantee_type` - (String)
424
+ # * `:grantee` - (String)
425
+ # * `:access` - (Array<String>)
426
+ # * `:thumbnail_config` - (Hash)
427
+ # * `:bucket` - (String)
428
+ # * `:storage_class` - (String)
429
+ # * `:permissions` - (Array<Hash>)
430
+ # * `:grantee_type` - (String)
431
+ # * `:grantee` - (String)
432
+ # * `:access` - (Array<String>)
205
433
 
206
434
  # @!method create_preset(options = {})
207
435
  # Calls the POST CreatePreset API operation.
208
436
  # @param [Hash] options
209
- # * `:name` - *required* - (String) The name of the preset. We recommend
210
- # that the name be unique within the AWS account, but uniqueness is not
211
- # enforced.
437
+ # * `:name` - (String) The name of the preset. We recommend that the name
438
+ # be unique within the AWS account, but uniqueness is not enforced.
212
439
  # * `:description` - (String) A description of the preset.
213
- # * `:container` - *required* - (String) The container type for the
214
- # output file. This value must be mp4.
215
- # * `:video` - *required* - (Hash) A section of the request body that
216
- # specifies the video parameters.
217
- # * `:codec` - (String) The video codec for the output file. This value
218
- # must be H.264.
440
+ # * `:container` - (String) The container type for the output file. This
441
+ # value must be mp4.
442
+ # * `:video` - (Hash) A section of the request body that specifies the
443
+ # video parameters.
444
+ # * `:codec` - (String) The video codec for the output file. Valid
445
+ # values include H.264 and vp8. You can only specify vp8 when the
446
+ # container type is webm.
219
447
  # * `:codec_options` - (Hash) Profile The H.264 profile that you want
220
448
  # to use for the output file. Elastic Transcoder supports the
221
449
  # following profiles: baseline: The profile most commonly used for
@@ -256,14 +484,16 @@ module AWS
256
484
  # `false` : The distance between key frames can vary.
257
485
  # * `:bit_rate` - (String) The bit rate of the video stream in the
258
486
  # output file, in kilobits/second. Valid values depend on the values
259
- # of Level and Profile. We recommend that you specify a value less
260
- # than or equal to the maximum H.264-compliant value listed in the
261
- # following list for your level and profile: Level - Maximum video
262
- # bit rate in kilobits/second (baseline and main Profile) : maximum
263
- # video bit rate in kilobits/second (high Profile) 1 - 64 : 80 1b -
264
- # 128 : 160 1.1 - 192 : 240 1.2 - 384 : 480 1.3 - 768 : 960 2 - 2000
265
- # : 2500 3 - 10000 : 12500 3.1 - 14000 : 17500 3.2 - 20000 : 25000 4
266
- # - 20000 : 25000 4.1 - 50000 : 62500
487
+ # of Level and Profile. If you specify auto, Elastic Transcoder uses
488
+ # the detected bit rate of the input source. If you specify a value
489
+ # other than auto, we recommend that you specify a value less than or
490
+ # equal to the maximum H.264-compliant value listed for your level
491
+ # and profile: Level - Maximum video bit rate in kilobits/second
492
+ # (baseline and main Profile) : maximum video bit rate in
493
+ # kilobits/second (high Profile) 1 - 64 : 80 1b - 128 : 160 1.1 - 192
494
+ # : 240 1.2 - 384 : 480 1.3 - 768 : 960 2 - 2000 : 2500 3 - 10000 :
495
+ # 12500 3.1 - 14000 : 17500 3.2 - 20000 : 25000 4 - 20000 : 25000 4.1
496
+ # - 50000 : 62500
267
497
  # * `:frame_rate` - (String) The frames per second for the video stream
268
498
  # in the output file. Valid values include: auto, 10, 15, 23.97, 24,
269
499
  # 25, 29.97, 30, 60 If you specify auto, Elastic Transcoder uses the
@@ -280,34 +510,83 @@ module AWS
280
510
  # (Level - Decoding speed): 1 - 380160 1b - 380160 1.1 - 76800 1.2 -
281
511
  # 1536000 1.3 - 3041280 2 - 3041280 2.1 - 5068800 2.2 - 5184000 3 -
282
512
  # 10368000 3.1 - 27648000 3.2 - 55296000 4 - 62914560 4.1 - 62914560
283
- # * `:resolution` - (String) The width and height of the video in the
284
- # output file, in pixels. Valid values are auto and width x height:
285
- # auto: Elastic Transcoder attempts to preserve the width and height
286
- # of the input file, subject to the following rules. width x height:
287
- # The width and height of the output video in pixels. Note the
288
- # following about specifying the width and height: The width must be
289
- # an even integer between 128 and 4096, inclusive. The height must be
290
- # an even integer between 96 and 3072, inclusive. If you specify a
291
- # resolution that is less than the resolution of the input file,
292
- # Elastic Transcoder rescales the output file to the lower
293
- # resolution. If you specify a resolution that is greater than the
294
- # resolution of the input file, Elastic Transcoder rescales the
295
- # output to the higher resolution. We recommend that you specify a
296
- # resolution for which the product of width and height is less than
297
- # or equal to the applicable value in the following list (List - Max
298
- # width x height value): 1 - 25344 1b - 25344 1.1 - 101376 1.2 -
299
- # 101376 1.3 - 101376 2 - 101376 2.1 - 202752 2.2 - 404720 3 - 404720
300
- # 3.1 - 921600 3.2 - 1310720 4 - 2097152 4.1 - 2097152
301
- # * `:aspect_ratio` - (String) The display aspect ratio of the video in
302
- # the output file. Valid values include: auto, 1:1, 4:3, 3:2, 16:9 If
303
- # you specify auto, Elastic Transcoder tries to preserve the aspect
304
- # ratio of the input file. If you specify an aspect ratio for the
305
- # output file that differs from aspect ratio of the input file,
306
- # Elastic Transcoder adds pillarboxing (black bars on the sides) or
307
- # letterboxing (black bars on the top and bottom) to maintain the
308
- # aspect ratio of the active region of the video.
309
- # * `:audio` - *required* - (Hash) A section of the request body that
310
- # specifies the audio parameters
513
+ # * `:resolution` - (String) To better control resolution and aspect
514
+ # ratio of output videos, we recommend that you use the values
515
+ # MaxWidth, MaxHeight, SizingPolicy, PaddingPolicy, and
516
+ # DisplayAspectRatio instead of Resolution and AspectRatio. The two
517
+ # groups of settings are mutually exclusive. Do not use them
518
+ # together. The width and height of the video in the output file, in
519
+ # pixels. Valid values are auto and width x height: auto: Elastic
520
+ # Transcoder attempts to preserve the width and height of the input
521
+ # file, subject to the following rules. width x height: The width and
522
+ # height of the output video in pixels. Note the following about
523
+ # specifying the width and height: The width must be an even integer
524
+ # between 128 and 4096, inclusive. The height must be an even integer
525
+ # between 96 and 3072, inclusive. If you specify a resolution that is
526
+ # less than the resolution of the input file, Elastic Transcoder
527
+ # rescales the output file to the lower resolution. If you specify a
528
+ # resolution that is greater than the resolution of the input file,
529
+ # Elastic Transcoder rescales the output to the higher resolution. We
530
+ # recommend that you specify a resolution for which the product of
531
+ # width and height is less than or equal to the applicable value in
532
+ # the following list (List - Max width x height value): 1 - 25344 1b
533
+ # - 25344 1.1 - 101376 1.2 - 101376 1.3 - 101376 2 - 101376 2.1 -
534
+ # 202752 2.2 - 404720 3 - 404720 3.1 - 921600 3.2 - 1310720 4 -
535
+ # 2097152 4.1 - 2097152
536
+ # * `:aspect_ratio` - (String) To better control resolution and aspect
537
+ # ratio of output videos, we recommend that you use the values
538
+ # MaxWidth, MaxHeight, SizingPolicy, PaddingPolicy, and
539
+ # DisplayAspectRatio instead of Resolution and AspectRatio. The two
540
+ # groups of settings are mutually exclusive. Do not use them
541
+ # together. The display aspect ratio of the video in the output file.
542
+ # Valid values include: auto, 1:1, 4:3, 3:2, 16:9 If you specify
543
+ # auto, Elastic Transcoder tries to preserve the aspect ratio of the
544
+ # input file. If you specify an aspect ratio for the output file that
545
+ # differs from aspect ratio of the input file, Elastic Transcoder
546
+ # adds pillarboxing (black bars on the sides) or letterboxing (black
547
+ # bars on the top and bottom) to maintain the aspect ratio of the
548
+ # active region of the video.
549
+ # * `:max_width` - (String) The maximum width of the output video in
550
+ # pixels. If you specify auto, Elastic Transcoder uses 1920 (Full HD)
551
+ # as the default value. If you specify a numeric value, enter an even
552
+ # integer between 128 and 4096.
553
+ # * `:max_height` - (String) The maximum height of the output video in
554
+ # pixels. If you specify auto, Elastic Transcoder uses 1080 (Full HD)
555
+ # as the default value. If you specify a numeric value, enter an even
556
+ # integer between 96 and 3072.
557
+ # * `:display_aspect_ratio` - (String) The value that Elastic
558
+ # Transcoder adds to the metadata in the output file.
559
+ # * `:sizing_policy` - (String) Specify one of the following values to
560
+ # control scaling of the output video: Fit: Elastic Transcoder scales
561
+ # the output video so it matches the value that you specified in
562
+ # either MaxWidth or MaxHeight without exceeding the other value.
563
+ # Fill: Elastic Transcoder scales the output video so it matches the
564
+ # value that you specified in either MaxWidth or MaxHeight and
565
+ # matches or exceeds the other value. Elastic Transcoder centers the
566
+ # output video and then crops it in the dimension (if any) that
567
+ # exceeds the maximum value. Stretch: Elastic Transcoder stretches
568
+ # the output video to match the values that you specified for
569
+ # MaxWidth and MaxHeight. If the relative proportions of the input
570
+ # video and the output video are different, the output video will be
571
+ # distorted. Keep: Elastic Transcoder does not scale the output
572
+ # video. If either dimension of the input video exceeds the values
573
+ # that you specified for MaxWidth and MaxHeight, Elastic Transcoder
574
+ # crops the output video. ShrinkToFit: Elastic Transcoder scales the
575
+ # output video down so that its dimensions match the values that you
576
+ # specified for at least one of MaxWidth and MaxHeight without
577
+ # exceeding either value. If you specify this option, Elastic
578
+ # Transcoder does not scale the video up. ShrinkToFill: Elastic
579
+ # Transcoder scales the output video down so that its dimensions
580
+ # match the values that you specified for at least one of MaxWidth
581
+ # and MaxHeight without dropping below either value. If you specify
582
+ # this option, Elastic Transcoder does not scale the video up.
583
+ # * `:padding_policy` - (String) When you set PaddingPolicy to Pad,
584
+ # Elastic Transcoder may add black bars to the top and bottom and/or
585
+ # left and right sides of the output video to make the total size of
586
+ # the output video match the values that you specified for MaxWidth
587
+ # and MaxHeight.
588
+ # * `:audio` - (Hash) A section of the request body that specifies the
589
+ # audio parameters.
311
590
  # * `:codec` - (String) The audio codec for the output file. This value
312
591
  # must be AAC.
313
592
  # * `:sample_rate` - (String) The sample rate of the audio stream in
@@ -315,30 +594,77 @@ module AWS
315
594
  # 32000, 44100, 48000, 96000 If you specify auto, Elastic Transcoder
316
595
  # automatically detects the sample rate.
317
596
  # * `:bit_rate` - (String) The bit rate of the audio stream in the
318
- # output file, in kilobits/second. Enter an integer between 8 and
597
+ # output file, in kilobits/second. Enter an integer between 64 and
319
598
  # 320, inclusive.
320
599
  # * `:channels` - (String) The number of audio channels in the output
321
600
  # file. Valid values include: auto, 0, 1, 2 If you specify auto,
322
601
  # Elastic Transcoder automatically detects the number of channels in
323
602
  # the input file.
324
- # * `:thumbnails` - *required* - (Hash) A section of the request body
325
- # that specifies the thumbnail parameters, if any.
603
+ # * `:thumbnails` - (Hash) A section of the request body that specifies
604
+ # the thumbnail parameters, if any.
326
605
  # * `:format` - (String) The format of thumbnails, if any. Valid values
327
606
  # are jpg and png. You specify whether you want Elastic Transcoder to
328
607
  # create thumbnails when you create a job.
329
608
  # * `:interval` - (String) The number of seconds between thumbnails.
330
609
  # Specify an integer value.
331
- # * `:resolution` - (String) The width and height of thumbnail files in
332
- # pixels. Specify a value in the format width x height where both
610
+ # * `:resolution` - (String) To better control resolution and aspect
611
+ # ratio of thumbnails, we recommend that you use the values MaxWidth,
612
+ # MaxHeight, SizingPolicy, and PaddingPolicy instead of Resolution
613
+ # and AspectRatio. The two groups of settings are mutually exclusive.
614
+ # Do not use them together. The width and height of thumbnail files
615
+ # in pixels. Specify a value in the format width x height where both
333
616
  # values are even integers. The values cannot exceed the width and
334
617
  # height that you specified in the Video:Resolution object.
335
- # * `:aspect_ratio` - (String) The aspect ratio of thumbnails. Valid
618
+ # * `:aspect_ratio` - (String) To better control resolution and aspect
619
+ # ratio of thumbnails, we recommend that you use the values MaxWidth,
620
+ # MaxHeight, SizingPolicy, and PaddingPolicy instead of Resolution
621
+ # and AspectRatio. The two groups of settings are mutually exclusive.
622
+ # Do not use them together. The aspect ratio of thumbnails. Valid
336
623
  # values include: auto, 1:1, 4:3, 3:2, 16:9 If you specify auto,
337
624
  # Elastic Transcoder tries to preserve the aspect ratio of the video
338
625
  # in the output file.
626
+ # * `:max_width` - (String) The maximum width of thumbnails in pixels.
627
+ # If you specify auto, Elastic Transcoder uses 1920 (Full HD) as the
628
+ # default value. If you specify a numeric value, enter an even
629
+ # integer between 32 and 4096.
630
+ # * `:max_height` - (String) The maximum height of thumbnails in
631
+ # pixels. If you specify auto, Elastic Transcoder uses 1080 (Full HD)
632
+ # as the default value. If you specify a numeric value, enter an even
633
+ # integer between 32 and 3072.
634
+ # * `:sizing_policy` - (String) Specify one of the following values to
635
+ # control scaling of thumbnails: Fit: Elastic Transcoder scales
636
+ # thumbnails so they match the value that you specified in thumbnail
637
+ # MaxWidth or MaxHeight settings without exceeding the other value.
638
+ # Fill: Elastic Transcoder scales thumbnails so they match the value
639
+ # that you specified in thumbnail MaxWidth or MaxHeight settings and
640
+ # matches or exceeds the other value. Elastic Transcoder centers the
641
+ # image in thumbnails and then crops in the dimension (if any) that
642
+ # exceeds the maximum value. Stretch: Elastic Transcoder stretches
643
+ # thumbnails to match the values that you specified for thumbnail
644
+ # MaxWidth and MaxHeight settings. If the relative proportions of the
645
+ # input video and thumbnails are different, the thumbnails will be
646
+ # distorted. Keep: Elastic Transcoder does not scale thumbnails. If
647
+ # either dimension of the input video exceeds the values that you
648
+ # specified for thumbnail MaxWidth and MaxHeight settings, Elastic
649
+ # Transcoder crops the thumbnails. ShrinkToFit: Elastic Transcoder
650
+ # scales thumbnails down so that their dimensions match the values
651
+ # that you specified for at least one of thumbnail MaxWidth and
652
+ # MaxHeight without exceeding either value. If you specify this
653
+ # option, Elastic Transcoder does not scale thumbnails up.
654
+ # ShrinkToFill: Elastic Transcoder scales thumbnails down so that
655
+ # their dimensions match the values that you specified for at least
656
+ # one of MaxWidth and MaxHeight without dropping below either value.
657
+ # If you specify this option, Elastic Transcoder does not scale
658
+ # thumbnails up.
659
+ # * `:padding_policy` - (String) When you set PaddingPolicy to Pad,
660
+ # Elastic Transcoder may add black bars to the top and bottom and/or
661
+ # left and right sides of thumbnails to make the total size of the
662
+ # thumbnails match the values that you specified for thumbnail
663
+ # MaxWidth and MaxHeight settings.
339
664
  # @return [Core::Response]
340
665
  # The #data method of the response object returns
341
666
  # a hash with the following structure:
667
+ #
342
668
  # * `:preset` - (Hash)
343
669
  # * `:id` - (String)
344
670
  # * `:name` - (String)
@@ -358,11 +684,20 @@ module AWS
358
684
  # * `:frame_rate` - (String)
359
685
  # * `:resolution` - (String)
360
686
  # * `:aspect_ratio` - (String)
687
+ # * `:max_width` - (String)
688
+ # * `:max_height` - (String)
689
+ # * `:display_aspect_ratio` - (String)
690
+ # * `:sizing_policy` - (String)
691
+ # * `:padding_policy` - (String)
361
692
  # * `:thumbnails` - (Hash)
362
693
  # * `:format` - (String)
363
694
  # * `:interval` - (String)
364
695
  # * `:resolution` - (String)
365
696
  # * `:aspect_ratio` - (String)
697
+ # * `:max_width` - (String)
698
+ # * `:max_height` - (String)
699
+ # * `:sizing_policy` - (String)
700
+ # * `:padding_policy` - (String)
366
701
  # * `:type` - (String)
367
702
  # * `:warning` - (String)
368
703
 
@@ -394,6 +729,7 @@ module AWS
394
729
  # @return [Core::Response]
395
730
  # The #data method of the response object returns
396
731
  # a hash with the following structure:
732
+ #
397
733
  # * `:jobs` - (Array<Hash>)
398
734
  # * `:id` - (String)
399
735
  # * `:pipeline_id` - (String)
@@ -405,12 +741,37 @@ module AWS
405
741
  # * `:interlaced` - (String)
406
742
  # * `:container` - (String)
407
743
  # * `:output` - (Hash)
744
+ # * `:id` - (String)
408
745
  # * `:key` - (String)
409
746
  # * `:thumbnail_pattern` - (String)
410
747
  # * `:rotate` - (String)
411
748
  # * `:preset_id` - (String)
749
+ # * `:segment_duration` - (String)
412
750
  # * `:status` - (String)
413
751
  # * `:status_detail` - (String)
752
+ # * `:duration` - (Integer)
753
+ # * `:width` - (Integer)
754
+ # * `:height` - (Integer)
755
+ # * `:outputs` - (Array<Hash>)
756
+ # * `:id` - (String)
757
+ # * `:key` - (String)
758
+ # * `:thumbnail_pattern` - (String)
759
+ # * `:rotate` - (String)
760
+ # * `:preset_id` - (String)
761
+ # * `:segment_duration` - (String)
762
+ # * `:status` - (String)
763
+ # * `:status_detail` - (String)
764
+ # * `:duration` - (Integer)
765
+ # * `:width` - (Integer)
766
+ # * `:height` - (Integer)
767
+ # * `:output_key_prefix` - (String)
768
+ # * `:playlists` - (Array<Hash>)
769
+ # * `:name` - (String)
770
+ # * `:format` - (String)
771
+ # * `:output_keys` - (Array<String>)
772
+ # * `:status` - (String)
773
+ # * `:status_detail` - (String)
774
+ # * `:status` - (String)
414
775
  # * `:next_page_token` - (String)
415
776
 
416
777
  # @!method list_jobs_by_status(options = {})
@@ -419,7 +780,7 @@ module AWS
419
780
  # * `:status` - *required* - (String) To get information about all of the
420
781
  # jobs associated with the current AWS account that have a given
421
782
  # status, specify the following status: Submitted, Progressing,
422
- # Completed, Canceled, or Error.
783
+ # Complete, Canceled, or Error.
423
784
  # * `:ascending` - (String) To list jobs in chronological order by the
424
785
  # date and time that they were submitted, enter `true` . To list jobs
425
786
  # in reverse chronological order, enter `false` .
@@ -429,6 +790,7 @@ module AWS
429
790
  # @return [Core::Response]
430
791
  # The #data method of the response object returns
431
792
  # a hash with the following structure:
793
+ #
432
794
  # * `:jobs` - (Array<Hash>)
433
795
  # * `:id` - (String)
434
796
  # * `:pipeline_id` - (String)
@@ -440,12 +802,37 @@ module AWS
440
802
  # * `:interlaced` - (String)
441
803
  # * `:container` - (String)
442
804
  # * `:output` - (Hash)
805
+ # * `:id` - (String)
443
806
  # * `:key` - (String)
444
807
  # * `:thumbnail_pattern` - (String)
445
808
  # * `:rotate` - (String)
446
809
  # * `:preset_id` - (String)
810
+ # * `:segment_duration` - (String)
811
+ # * `:status` - (String)
812
+ # * `:status_detail` - (String)
813
+ # * `:duration` - (Integer)
814
+ # * `:width` - (Integer)
815
+ # * `:height` - (Integer)
816
+ # * `:outputs` - (Array<Hash>)
817
+ # * `:id` - (String)
818
+ # * `:key` - (String)
819
+ # * `:thumbnail_pattern` - (String)
820
+ # * `:rotate` - (String)
821
+ # * `:preset_id` - (String)
822
+ # * `:segment_duration` - (String)
823
+ # * `:status` - (String)
824
+ # * `:status_detail` - (String)
825
+ # * `:duration` - (Integer)
826
+ # * `:width` - (Integer)
827
+ # * `:height` - (Integer)
828
+ # * `:output_key_prefix` - (String)
829
+ # * `:playlists` - (Array<Hash>)
830
+ # * `:name` - (String)
831
+ # * `:format` - (String)
832
+ # * `:output_keys` - (Array<String>)
447
833
  # * `:status` - (String)
448
834
  # * `:status_detail` - (String)
835
+ # * `:status` - (String)
449
836
  # * `:next_page_token` - (String)
450
837
 
451
838
  # @!method list_pipelines(options = {})
@@ -454,8 +841,10 @@ module AWS
454
841
  # @return [Core::Response]
455
842
  # The #data method of the response object returns
456
843
  # a hash with the following structure:
844
+ #
457
845
  # * `:pipelines` - (Array<Hash>)
458
846
  # * `:id` - (String)
847
+ # * `:arn` - (String)
459
848
  # * `:name` - (String)
460
849
  # * `:status` - (String)
461
850
  # * `:input_bucket` - (String)
@@ -466,6 +855,20 @@ module AWS
466
855
  # * `:completed` - (String)
467
856
  # * `:warning` - (String)
468
857
  # * `:error` - (String)
858
+ # * `:content_config` - (Hash)
859
+ # * `:bucket` - (String)
860
+ # * `:storage_class` - (String)
861
+ # * `:permissions` - (Array<Hash>)
862
+ # * `:grantee_type` - (String)
863
+ # * `:grantee` - (String)
864
+ # * `:access` - (Array<String>)
865
+ # * `:thumbnail_config` - (Hash)
866
+ # * `:bucket` - (String)
867
+ # * `:storage_class` - (String)
868
+ # * `:permissions` - (Array<Hash>)
869
+ # * `:grantee_type` - (String)
870
+ # * `:grantee` - (String)
871
+ # * `:access` - (Array<String>)
469
872
 
470
873
  # @!method list_presets(options = {})
471
874
  # Calls the GET ListPresets API operation.
@@ -473,6 +876,7 @@ module AWS
473
876
  # @return [Core::Response]
474
877
  # The #data method of the response object returns
475
878
  # a hash with the following structure:
879
+ #
476
880
  # * `:presets` - (Array<Hash>)
477
881
  # * `:id` - (String)
478
882
  # * `:name` - (String)
@@ -492,11 +896,20 @@ module AWS
492
896
  # * `:frame_rate` - (String)
493
897
  # * `:resolution` - (String)
494
898
  # * `:aspect_ratio` - (String)
899
+ # * `:max_width` - (String)
900
+ # * `:max_height` - (String)
901
+ # * `:display_aspect_ratio` - (String)
902
+ # * `:sizing_policy` - (String)
903
+ # * `:padding_policy` - (String)
495
904
  # * `:thumbnails` - (Hash)
496
905
  # * `:format` - (String)
497
906
  # * `:interval` - (String)
498
907
  # * `:resolution` - (String)
499
908
  # * `:aspect_ratio` - (String)
909
+ # * `:max_width` - (String)
910
+ # * `:max_height` - (String)
911
+ # * `:sizing_policy` - (String)
912
+ # * `:padding_policy` - (String)
500
913
  # * `:type` - (String)
501
914
 
502
915
  # @!method read_job(options = {})
@@ -507,6 +920,7 @@ module AWS
507
920
  # @return [Core::Response]
508
921
  # The #data method of the response object returns
509
922
  # a hash with the following structure:
923
+ #
510
924
  # * `:job` - (Hash)
511
925
  # * `:id` - (String)
512
926
  # * `:pipeline_id` - (String)
@@ -518,12 +932,37 @@ module AWS
518
932
  # * `:interlaced` - (String)
519
933
  # * `:container` - (String)
520
934
  # * `:output` - (Hash)
935
+ # * `:id` - (String)
521
936
  # * `:key` - (String)
522
937
  # * `:thumbnail_pattern` - (String)
523
938
  # * `:rotate` - (String)
524
939
  # * `:preset_id` - (String)
940
+ # * `:segment_duration` - (String)
525
941
  # * `:status` - (String)
526
942
  # * `:status_detail` - (String)
943
+ # * `:duration` - (Integer)
944
+ # * `:width` - (Integer)
945
+ # * `:height` - (Integer)
946
+ # * `:outputs` - (Array<Hash>)
947
+ # * `:id` - (String)
948
+ # * `:key` - (String)
949
+ # * `:thumbnail_pattern` - (String)
950
+ # * `:rotate` - (String)
951
+ # * `:preset_id` - (String)
952
+ # * `:segment_duration` - (String)
953
+ # * `:status` - (String)
954
+ # * `:status_detail` - (String)
955
+ # * `:duration` - (Integer)
956
+ # * `:width` - (Integer)
957
+ # * `:height` - (Integer)
958
+ # * `:output_key_prefix` - (String)
959
+ # * `:playlists` - (Array<Hash>)
960
+ # * `:name` - (String)
961
+ # * `:format` - (String)
962
+ # * `:output_keys` - (Array<String>)
963
+ # * `:status` - (String)
964
+ # * `:status_detail` - (String)
965
+ # * `:status` - (String)
527
966
 
528
967
  # @!method read_pipeline(options = {})
529
968
  # Calls the GET ReadPipeline API operation.
@@ -532,8 +971,10 @@ module AWS
532
971
  # @return [Core::Response]
533
972
  # The #data method of the response object returns
534
973
  # a hash with the following structure:
974
+ #
535
975
  # * `:pipeline` - (Hash)
536
976
  # * `:id` - (String)
977
+ # * `:arn` - (String)
537
978
  # * `:name` - (String)
538
979
  # * `:status` - (String)
539
980
  # * `:input_bucket` - (String)
@@ -544,6 +985,20 @@ module AWS
544
985
  # * `:completed` - (String)
545
986
  # * `:warning` - (String)
546
987
  # * `:error` - (String)
988
+ # * `:content_config` - (Hash)
989
+ # * `:bucket` - (String)
990
+ # * `:storage_class` - (String)
991
+ # * `:permissions` - (Array<Hash>)
992
+ # * `:grantee_type` - (String)
993
+ # * `:grantee` - (String)
994
+ # * `:access` - (Array<String>)
995
+ # * `:thumbnail_config` - (Hash)
996
+ # * `:bucket` - (String)
997
+ # * `:storage_class` - (String)
998
+ # * `:permissions` - (Array<Hash>)
999
+ # * `:grantee_type` - (String)
1000
+ # * `:grantee` - (String)
1001
+ # * `:access` - (Array<String>)
547
1002
 
548
1003
  # @!method read_preset(options = {})
549
1004
  # Calls the GET ReadPreset API operation.
@@ -553,6 +1008,7 @@ module AWS
553
1008
  # @return [Core::Response]
554
1009
  # The #data method of the response object returns
555
1010
  # a hash with the following structure:
1011
+ #
556
1012
  # * `:preset` - (Hash)
557
1013
  # * `:id` - (String)
558
1014
  # * `:name` - (String)
@@ -572,48 +1028,127 @@ module AWS
572
1028
  # * `:frame_rate` - (String)
573
1029
  # * `:resolution` - (String)
574
1030
  # * `:aspect_ratio` - (String)
1031
+ # * `:max_width` - (String)
1032
+ # * `:max_height` - (String)
1033
+ # * `:display_aspect_ratio` - (String)
1034
+ # * `:sizing_policy` - (String)
1035
+ # * `:padding_policy` - (String)
575
1036
  # * `:thumbnails` - (Hash)
576
1037
  # * `:format` - (String)
577
1038
  # * `:interval` - (String)
578
1039
  # * `:resolution` - (String)
579
1040
  # * `:aspect_ratio` - (String)
1041
+ # * `:max_width` - (String)
1042
+ # * `:max_height` - (String)
1043
+ # * `:sizing_policy` - (String)
1044
+ # * `:padding_policy` - (String)
580
1045
  # * `:type` - (String)
581
1046
 
582
1047
  # @!method test_role(options = {})
583
1048
  # Calls the POST TestRole API operation.
584
1049
  # @param [Hash] options
585
- # * `:role` - *required* - (String) The IAM Amazon Resource Name (ARN)
586
- # for the role that you want Elastic Transcoder to use to create the
587
- # pipeline.
588
- # * `:input_bucket` - *required* - (String) The Amazon S3 bucket in which
589
- # you saved the media files that you want to transcode.
590
- # * `:output_bucket` - *required* - (String) The Amazon S3 bucket in
591
- # which you want Elastic Transcoder to save the transcoded files.
592
- # * `:topics` - *required* - (Array<String>) The Amazon Simple
593
- # Notification Service (Amazon SNS) topics that you want to notify to
594
- # report job status.
1050
+ # * `:role` - (String) The IAM Amazon Resource Name (ARN) for the role
1051
+ # that you want Elastic Transcoder to test.
1052
+ # * `:input_bucket` - (String) The Amazon S3 bucket that contains media
1053
+ # files to be transcoded. The action attempts to read from this bucket.
1054
+ # * `:output_bucket` - (String) The Amazon S3 bucket that Elastic
1055
+ # Transcoder will write transcoded media files to. The action attempts
1056
+ # to read from this bucket.
1057
+ # * `:topics` - (Array<String>) The ARNs of one or more Amazon Simple
1058
+ # Notification Service (Amazon SNS) topics that you want the action to
1059
+ # send a test notification to.
595
1060
  # @return [Core::Response]
596
1061
  # The #data method of the response object returns
597
1062
  # a hash with the following structure:
1063
+ #
598
1064
  # * `:success` - (String)
599
1065
  # * `:messages` - (Array<String>)
600
1066
 
1067
+ # @!method update_pipeline(options = {})
1068
+ # Calls the PUT UpdatePipeline API operation.
1069
+ # @param [Hash] options
1070
+ # * `:id` - *required* - (String)
1071
+ # * `:name` - (String)
1072
+ # * `:input_bucket` - (String)
1073
+ # * `:role` - (String)
1074
+ # * `:notifications` - (Hash)
1075
+ # * `:progressing` - (String) The Amazon Simple Notification Service
1076
+ # (Amazon SNS) topic that you want to notify when Elastic Transcoder
1077
+ # has started to process the job.
1078
+ # * `:completed` - (String) The Amazon SNS topic that you want to
1079
+ # notify when Elastic Transcoder has finished processing the job.
1080
+ # * `:warning` - (String) The Amazon SNS topic that you want to notify
1081
+ # when Elastic Transcoder encounters a warning condition.
1082
+ # * `:error` - (String) The Amazon SNS topic that you want to notify
1083
+ # when Elastic Transcoder encounters an error condition.
1084
+ # * `:content_config` - (Hash)
1085
+ # * `:bucket` - (String)
1086
+ # * `:storage_class` - (String)
1087
+ # * `:permissions` - (Array<Hash>)
1088
+ # * `:grantee_type` - (String)
1089
+ # * `:grantee` - (String)
1090
+ # * `:access` - (Array<String>)
1091
+ # * `:thumbnail_config` - (Hash)
1092
+ # * `:bucket` - (String)
1093
+ # * `:storage_class` - (String)
1094
+ # * `:permissions` - (Array<Hash>)
1095
+ # * `:grantee_type` - (String)
1096
+ # * `:grantee` - (String)
1097
+ # * `:access` - (Array<String>)
1098
+ # @return [Core::Response]
1099
+ # The #data method of the response object returns
1100
+ # a hash with the following structure:
1101
+ #
1102
+ # * `:pipeline` - (Hash)
1103
+ # * `:id` - (String)
1104
+ # * `:arn` - (String)
1105
+ # * `:name` - (String)
1106
+ # * `:status` - (String)
1107
+ # * `:input_bucket` - (String)
1108
+ # * `:output_bucket` - (String)
1109
+ # * `:role` - (String)
1110
+ # * `:notifications` - (Hash)
1111
+ # * `:progressing` - (String)
1112
+ # * `:completed` - (String)
1113
+ # * `:warning` - (String)
1114
+ # * `:error` - (String)
1115
+ # * `:content_config` - (Hash)
1116
+ # * `:bucket` - (String)
1117
+ # * `:storage_class` - (String)
1118
+ # * `:permissions` - (Array<Hash>)
1119
+ # * `:grantee_type` - (String)
1120
+ # * `:grantee` - (String)
1121
+ # * `:access` - (Array<String>)
1122
+ # * `:thumbnail_config` - (Hash)
1123
+ # * `:bucket` - (String)
1124
+ # * `:storage_class` - (String)
1125
+ # * `:permissions` - (Array<Hash>)
1126
+ # * `:grantee_type` - (String)
1127
+ # * `:grantee` - (String)
1128
+ # * `:access` - (Array<String>)
1129
+
601
1130
  # @!method update_pipeline_notifications(options = {})
602
1131
  # Calls the POST UpdatePipelineNotifications API operation.
603
1132
  # @param [Hash] options
604
1133
  # * `:id` - *required* - (String) The identifier of the pipeline for
605
1134
  # which you want to change notification settings.
606
- # * `:notifications` - *required* - (Hash) The Amazon Simple Notification
607
- # Service (Amazon SNS) topic that you want to notify to report job
608
- # status. To receive notifications, you must also subscribe to the new
609
- # topic in the Amazon SNS console. Progressing: The Amazon Simple
610
- # Notification Service (Amazon SNS) topic that you want to notify when
611
- # Elastic Transcoder has started to process the job. Completed: The
612
- # Amazon SNS topic that you want to notify when Elastic Transcoder has
613
- # finished processing the job. Warning: The Amazon SNS topic that you
614
- # want to notify when Elastic Transcoder encounters a warning
615
- # condition. Error: The Amazon SNS topic that you want to notify when
616
- # Elastic Transcoder encounters an error condition.
1135
+ # * `:notifications` - (Hash) The topic ARN for the Amazon Simple
1136
+ # Notification Service (Amazon SNS) topic that you want to notify to
1137
+ # report job status. To receive notifications, you must also subscribe
1138
+ # to the new topic in the Amazon SNS console. Progressing: The topic
1139
+ # ARN for the Amazon Simple Notification Service (Amazon SNS) topic
1140
+ # that you want to notify when Elastic Transcoder has started to
1141
+ # process jobs that are added to this pipeline. This is the ARN that
1142
+ # Amazon SNS returned when you created the topic. Completed: The topic
1143
+ # ARN for the Amazon SNS topic that you want to notify when Elastic
1144
+ # Transcoder has finished processing a job. This is the ARN that Amazon
1145
+ # SNS returned when you created the topic. Warning: The topic ARN for
1146
+ # the Amazon SNS topic that you want to notify when Elastic Transcoder
1147
+ # encounters a warning condition. This is the ARN that Amazon SNS
1148
+ # returned when you created the topic. Error: The topic ARN for the
1149
+ # Amazon SNS topic that you want to notify when Elastic Transcoder
1150
+ # encounters an error condition. This is the ARN that Amazon SNS
1151
+ # returned when you created the topic.
617
1152
  # * `:progressing` - (String) The Amazon Simple Notification Service
618
1153
  # (Amazon SNS) topic that you want to notify when Elastic Transcoder
619
1154
  # has started to process the job.
@@ -626,8 +1161,10 @@ module AWS
626
1161
  # @return [Core::Response]
627
1162
  # The #data method of the response object returns
628
1163
  # a hash with the following structure:
1164
+ #
629
1165
  # * `:pipeline` - (Hash)
630
1166
  # * `:id` - (String)
1167
+ # * `:arn` - (String)
631
1168
  # * `:name` - (String)
632
1169
  # * `:status` - (String)
633
1170
  # * `:input_bucket` - (String)
@@ -638,20 +1175,36 @@ module AWS
638
1175
  # * `:completed` - (String)
639
1176
  # * `:warning` - (String)
640
1177
  # * `:error` - (String)
1178
+ # * `:content_config` - (Hash)
1179
+ # * `:bucket` - (String)
1180
+ # * `:storage_class` - (String)
1181
+ # * `:permissions` - (Array<Hash>)
1182
+ # * `:grantee_type` - (String)
1183
+ # * `:grantee` - (String)
1184
+ # * `:access` - (Array<String>)
1185
+ # * `:thumbnail_config` - (Hash)
1186
+ # * `:bucket` - (String)
1187
+ # * `:storage_class` - (String)
1188
+ # * `:permissions` - (Array<Hash>)
1189
+ # * `:grantee_type` - (String)
1190
+ # * `:grantee` - (String)
1191
+ # * `:access` - (Array<String>)
641
1192
 
642
1193
  # @!method update_pipeline_status(options = {})
643
1194
  # Calls the POST UpdatePipelineStatus API operation.
644
1195
  # @param [Hash] options
645
1196
  # * `:id` - *required* - (String) The identifier of the pipeline to
646
1197
  # update.
647
- # * `:status` - *required* - (String) The new status of the pipeline:
648
- # active: Enable the pipeline, so it starts processing jobs. paused:
649
- # Disable the pipeline, so it stops processing jobs.
1198
+ # * `:status` - (String) The desired status of the pipeline: Active: The
1199
+ # pipeline is processing jobs. Paused: The pipeline is not currently
1200
+ # processing jobs.
650
1201
  # @return [Core::Response]
651
1202
  # The #data method of the response object returns
652
1203
  # a hash with the following structure:
1204
+ #
653
1205
  # * `:pipeline` - (Hash)
654
1206
  # * `:id` - (String)
1207
+ # * `:arn` - (String)
655
1208
  # * `:name` - (String)
656
1209
  # * `:status` - (String)
657
1210
  # * `:input_bucket` - (String)
@@ -662,6 +1215,20 @@ module AWS
662
1215
  # * `:completed` - (String)
663
1216
  # * `:warning` - (String)
664
1217
  # * `:error` - (String)
1218
+ # * `:content_config` - (Hash)
1219
+ # * `:bucket` - (String)
1220
+ # * `:storage_class` - (String)
1221
+ # * `:permissions` - (Array<Hash>)
1222
+ # * `:grantee_type` - (String)
1223
+ # * `:grantee` - (String)
1224
+ # * `:access` - (Array<String>)
1225
+ # * `:thumbnail_config` - (Hash)
1226
+ # * `:bucket` - (String)
1227
+ # * `:storage_class` - (String)
1228
+ # * `:permissions` - (Array<Hash>)
1229
+ # * `:grantee_type` - (String)
1230
+ # * `:grantee` - (String)
1231
+ # * `:access` - (Array<String>)
665
1232
 
666
1233
  # end client methods #
667
1234