aws-sdk 1.9.5 → 1.10.0

Sign up to get free protection for your applications and to get access to all the features.
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