Skip to content

Commit 7573b34

Browse files
author
AWS
committed
AWS Elemental MediaConvert Update: AWS Elemental MediaConvert SDK adds support for queue hopping. Jobs can now hop from their original queue to a specified alternate queue, based on the maximum wait time that you specify in the job settings.
1 parent 56da2ae commit 7573b34

File tree

2 files changed

+109
-20
lines changed

2 files changed

+109
-20
lines changed

‎.changes/next-release/feature-AWSElementalMediaConvert-27aebd8.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
{
2+
"type": "feature",
3+
"category": "AWS Elemental MediaConvert",
4+
"description": "AWS Elemental MediaConvert SDK adds support for queue hopping. Jobs can now hop from their original queue to a specified alternate queue, based on the maximum wait time that you specify in the job settings."
5+
}

‎services/mediaconvert/src/main/resources/codegen-resources/service-2.json

Lines changed: 104 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1264,7 +1264,7 @@
12641264
"documentation": "Specify the conditions when the service will run your job with accelerated transcoding."
12651265
}
12661266
},
1267-
"documentation": "Accelerated transcoding can significantly speed up jobs with long, visually complex content. Outputs that use this feature incur pro-tier pricing. For information about feature limitations, see the AWS Elemental MediaConvert User Guide.",
1267+
"documentation": "Accelerated transcoding can significantly speed up jobs with long, visually complex content.",
12681268
"required": [
12691269
"Mode"
12701270
]
@@ -1824,7 +1824,7 @@
18241824
},
18251825
"BillingTagsSource": {
18261826
"type": "string",
1827-
"documentation": "Optional. Choose a tag type that AWS Billing and Cost Management will use to sort your AWS Elemental MediaConvert costs on any billing report that you set up. Any transcoding outputs that don't have an associated tag will appear in your billing report unsorted. If you don't choose a valid value for this field, your job outputs will appear on the billing report unsorted.",
1827+
"documentation": "The tag type that AWS Billing and Cost Management will use to sort your AWS Elemental MediaConvert costs on any billing report that you set up.",
18281828
"enum": [
18291829
"QUEUE",
18301830
"PRESET",
@@ -2664,7 +2664,7 @@
26642664
"AccelerationSettings": {
26652665
"shape": "AccelerationSettings",
26662666
"locationName": "accelerationSettings",
2667-
"documentation": "Accelerated transcoding can significantly speed up jobs with long, visually complex content. Outputs that use this feature incur pro-tier pricing. For information about feature limitations, see the AWS Elemental MediaConvert User Guide."
2667+
"documentation": "Optional. Accelerated transcoding can significantly speed up jobs with long, visually complex content. Outputs that use this feature incur pro-tier pricing. For information about feature limitations, see the AWS Elemental MediaConvert User Guide."
26682668
},
26692669
"BillingTagsSource": {
26702670
"shape": "BillingTagsSource",
@@ -2674,18 +2674,23 @@
26742674
"ClientRequestToken": {
26752675
"shape": "__string",
26762676
"locationName": "clientRequestToken",
2677-
"documentation": "Idempotency token for CreateJob operation.",
2677+
"documentation": "Optional. Idempotency token for CreateJob operation.",
26782678
"idempotencyToken": true
26792679
},
2680+
"HopDestinations": {
2681+
"shape": "__listOfHopDestination",
2682+
"locationName": "hopDestinations",
2683+
"documentation": "Optional. Use queue hopping to avoid overly long waits in the backlog of the queue that you submit your job to. Specify an alternate queue and the maximum time that your job will wait in the initial queue before hopping. For more information about this feature, see the AWS Elemental MediaConvert User Guide."
2684+
},
26802685
"JobTemplate": {
26812686
"shape": "__string",
26822687
"locationName": "jobTemplate",
2683-
"documentation": "When you create a job, you can either specify a job template or specify the transcoding settings individually"
2688+
"documentation": "Optional. When you create a job, you can either specify a job template or specify the transcoding settings individually."
26842689
},
26852690
"Priority": {
26862691
"shape": "__integerMinNegative50Max50",
26872692
"locationName": "priority",
2688-
"documentation": "Specify the relative priority for this job. In any given queue, the service begins processing the job with the highest value first. When more than one job has the same priority, the service begins processing the job that you submitted first. If you don't specify a priority, the service uses the default value 0."
2693+
"documentation": "Optional. Specify the relative priority for this job. In any given queue, the service begins processing the job with the highest value first. When more than one job has the same priority, the service begins processing the job that you submitted first. If you don't specify a priority, the service uses the default value 0."
26892694
},
26902695
"Queue": {
26912696
"shape": "__string",
@@ -2705,22 +2710,22 @@
27052710
"SimulateReservedQueue": {
27062711
"shape": "SimulateReservedQueue",
27072712
"locationName": "simulateReservedQueue",
2708-
"documentation": "Enable this setting when you run a test job to estimate how many reserved transcoding slots (RTS) you need. When this is enabled, MediaConvert runs your job from an on-demand queue with similar performance to what you will see with one RTS in a reserved queue. This setting is disabled by default."
2713+
"documentation": "Optional. Enable this setting when you run a test job to estimate how many reserved transcoding slots (RTS) you need. When this is enabled, MediaConvert runs your job from an on-demand queue with similar performance to what you will see with one RTS in a reserved queue. This setting is disabled by default."
27092714
},
27102715
"StatusUpdateInterval": {
27112716
"shape": "StatusUpdateInterval",
27122717
"locationName": "statusUpdateInterval",
2713-
"documentation": "Specify how often MediaConvert sends STATUS_UPDATE events to Amazon CloudWatch Events. Set the interval, in seconds, between status updates. MediaConvert sends an update at this interval from the time the service begins processing your job to the time it completes the transcode or encounters an error."
2718+
"documentation": "Optional. Specify how often MediaConvert sends STATUS_UPDATE events to Amazon CloudWatch Events. Set the interval, in seconds, between status updates. MediaConvert sends an update at this interval from the time the service begins processing your job to the time it completes the transcode or encounters an error."
27142719
},
27152720
"Tags": {
27162721
"shape": "__mapOf__string",
27172722
"locationName": "tags",
2718-
"documentation": "The tags that you want to add to the resource. You can tag resources with a key-value pair or with only a key."
2723+
"documentation": "Optional. The tags that you want to add to the resource. You can tag resources with a key-value pair or with only a key."
27192724
},
27202725
"UserMetadata": {
27212726
"shape": "__mapOf__string",
27222727
"locationName": "userMetadata",
2723-
"documentation": "User-defined metadata that you want to associate with an MediaConvert job. You specify metadata in key/value pairs."
2728+
"documentation": "Optional. User-defined metadata that you want to associate with an MediaConvert job. You specify metadata in key/value pairs."
27242729
}
27252730
},
27262731
"required": [
@@ -2756,6 +2761,11 @@
27562761
"locationName": "description",
27572762
"documentation": "Optional. A description of the job template you are creating."
27582763
},
2764+
"HopDestinations": {
2765+
"shape": "__listOfHopDestination",
2766+
"locationName": "hopDestinations",
2767+
"documentation": "Optional. Use queue hopping to avoid overly long waits in the backlog of the queue that you submit your job to. Specify an alternate queue and the maximum time that your job will wait in the initial queue before hopping. For more information about this feature, see the AWS Elemental MediaConvert User Guide."
2768+
},
27592769
"Name": {
27602770
"shape": "__string",
27612771
"locationName": "name",
@@ -5589,6 +5599,27 @@
55895599
"TDRL"
55905600
]
55915601
},
5602+
"HopDestination": {
5603+
"type": "structure",
5604+
"members": {
5605+
"Priority": {
5606+
"shape": "__integerMinNegative50Max50",
5607+
"locationName": "priority",
5608+
"documentation": "Optional. When you set up a job to use queue hopping, you can specify a different relative priority for the job in the destination queue. If you don't specify, the relative priority will remain the same as in the previous queue."
5609+
},
5610+
"Queue": {
5611+
"shape": "__string",
5612+
"locationName": "queue",
5613+
"documentation": "Optional unless the job is submitted on the default queue. When you set up a job to use queue hopping, you can specify a destination queue. This queue cannot be the original queue to which the job is submitted. If the original queue isn't the default queue and you don't specify the destination queue, the job will move to the default queue."
5614+
},
5615+
"WaitMinutes": {
5616+
"shape": "__integer",
5617+
"locationName": "waitMinutes",
5618+
"documentation": "Required for setting up a job to use queue hopping. Minimum wait time in minutes until the job can hop to the destination queue. Valid range is 1 to 1440 minutes, inclusive."
5619+
}
5620+
},
5621+
"documentation": "Optional. Configuration for a destination queue to which the job can hop once a customer-defined minimum wait time has passed."
5622+
},
55925623
"Id3Insertion": {
55935624
"type": "structure",
55945625
"members": {
@@ -6013,7 +6044,7 @@
60136044
"BillingTagsSource": {
60146045
"shape": "BillingTagsSource",
60156046
"locationName": "billingTagsSource",
6016-
"documentation": "Optional. Choose a tag type that AWS Billing and Cost Management will use to sort your AWS Elemental MediaConvert costs on any billing report that you set up. Any transcoding outputs that don't have an associated tag will appear in your billing report unsorted. If you don't choose a valid value for this field, your job outputs will appear on the billing report unsorted."
6047+
"documentation": "The tag type that AWS Billing and Cost Management will use to sort your AWS Elemental MediaConvert costs on any billing report that you set up."
60176048
},
60186049
"CreatedAt": {
60196050
"shape": "__timestampUnix",
@@ -6035,6 +6066,11 @@
60356066
"locationName": "errorMessage",
60366067
"documentation": "Error message of Job"
60376068
},
6069+
"HopDestinations": {
6070+
"shape": "__listOfHopDestination",
6071+
"locationName": "hopDestinations",
6072+
"documentation": "Optional list of hop destinations."
6073+
},
60386074
"Id": {
60396075
"shape": "__string",
60406076
"locationName": "id",
@@ -6068,7 +6104,12 @@
60686104
"Queue": {
60696105
"shape": "__string",
60706106
"locationName": "queue",
6071-
"documentation": "Optional. When you create a job, you can specify a queue to send it to. If you don't specify, the job will go to the default queue. For more about queues, see the User Guide topic at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html"
6107+
"documentation": "When you create a job, you can specify a queue to send it to. If you don't specify, the job will go to the default queue. For more about queues, see the User Guide topic at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html"
6108+
},
6109+
"QueueTransitions": {
6110+
"shape": "__listOfQueueTransition",
6111+
"locationName": "queueTransitions",
6112+
"documentation": "The job's queue hopping history."
60726113
},
60736114
"RetryCount": {
60746115
"shape": "__integer",
@@ -6232,6 +6273,11 @@
62326273
"locationName": "description",
62336274
"documentation": "An optional description you create for each job template."
62346275
},
6276+
"HopDestinations": {
6277+
"shape": "__listOfHopDestination",
6278+
"locationName": "hopDestinations",
6279+
"documentation": "Optional list of hop destinations."
6280+
},
62356281
"LastUpdated": {
62366282
"shape": "__timestampUnix",
62376283
"locationName": "lastUpdated",
@@ -6561,7 +6607,7 @@
65616607
"Order": {
65626608
"shape": "Order",
65636609
"locationName": "order",
6564-
"documentation": "When you request lists of resources, you can optionally specify whether they are sorted in ASCENDING or DESCENDING order. Default varies by resource.",
6610+
"documentation": "Optional. When you request lists of resources, you can specify whether they are sorted in ASCENDING or DESCENDING order. Default varies by resource.",
65656611
"location": "querystring"
65666612
}
65676613
}
@@ -6593,25 +6639,25 @@
65936639
"NextToken": {
65946640
"shape": "__string",
65956641
"locationName": "nextToken",
6596-
"documentation": "Use this string, provided with the response to a previous request, to request the next batch of jobs.",
6642+
"documentation": "Optional. Use this string, provided with the response to a previous request, to request the next batch of jobs.",
65976643
"location": "querystring"
65986644
},
65996645
"Order": {
66006646
"shape": "Order",
66016647
"locationName": "order",
6602-
"documentation": "When you request lists of resources, you can optionally specify whether they are sorted in ASCENDING or DESCENDING order. Default varies by resource.",
6648+
"documentation": "Optional. When you request lists of resources, you can specify whether they are sorted in ASCENDING or DESCENDING order. Default varies by resource.",
66036649
"location": "querystring"
66046650
},
66056651
"Queue": {
66066652
"shape": "__string",
66076653
"locationName": "queue",
6608-
"documentation": "Provide a queue name to get back only jobs from that queue.",
6654+
"documentation": "Optional. Provide a queue name to get back only jobs from that queue.",
66096655
"location": "querystring"
66106656
},
66116657
"Status": {
66126658
"shape": "JobStatus",
66136659
"locationName": "status",
6614-
"documentation": "A job's status can be SUBMITTED, PROGRESSING, COMPLETE, CANCELED, or ERROR.",
6660+
"documentation": "Optional. A job's status can be SUBMITTED, PROGRESSING, COMPLETE, CANCELED, or ERROR.",
66156661
"location": "querystring"
66166662
}
66176663
}
@@ -6661,7 +6707,7 @@
66616707
"Order": {
66626708
"shape": "Order",
66636709
"locationName": "order",
6664-
"documentation": "When you request lists of resources, you can optionally specify whether they are sorted in ASCENDING or DESCENDING order. Default varies by resource.",
6710+
"documentation": "Optional. When you request lists of resources, you can specify whether they are sorted in ASCENDING or DESCENDING order. Default varies by resource.",
66656711
"location": "querystring"
66666712
}
66676713
}
@@ -6705,7 +6751,7 @@
67056751
"Order": {
67066752
"shape": "Order",
67076753
"locationName": "order",
6708-
"documentation": "When you request lists of resources, you can optionally specify whether they are sorted in ASCENDING or DESCENDING order. Default varies by resource.",
6754+
"documentation": "Optional. When you request lists of resources, you can specify whether they are sorted in ASCENDING or DESCENDING order. Default varies by resource.",
67096755
"location": "querystring"
67106756
}
67116757
}
@@ -7997,7 +8043,7 @@
79978043
},
79988044
"Order": {
79998045
"type": "string",
8000-
"documentation": "When you request lists of resources, you can optionally specify whether they are sorted in ASCENDING or DESCENDING order. Default varies by resource.",
8046+
"documentation": "Optional. When you request lists of resources, you can specify whether they are sorted in ASCENDING or DESCENDING order. Default varies by resource.",
80018047
"enum": [
80028048
"ASCENDING",
80038049
"DESCENDING"
@@ -8476,6 +8522,27 @@
84768522
"PAUSED"
84778523
]
84788524
},
8525+
"QueueTransition": {
8526+
"type": "structure",
8527+
"members": {
8528+
"DestinationQueue": {
8529+
"shape": "__string",
8530+
"locationName": "destinationQueue",
8531+
"documentation": "The queue that the job was on after the transition."
8532+
},
8533+
"SourceQueue": {
8534+
"shape": "__string",
8535+
"locationName": "sourceQueue",
8536+
"documentation": "The queue that the job was on before the transition."
8537+
},
8538+
"Timestamp": {
8539+
"shape": "__timestampUnix",
8540+
"locationName": "timestamp",
8541+
"documentation": "The time, in Unix epoch format, that the job moved from the source queue to the destination queue."
8542+
}
8543+
},
8544+
"documentation": "Description of the source and destination queues between which the job has moved, along with the timestamp of the move"
8545+
},
84798546
"Rectangle": {
84808547
"type": "structure",
84818548
"members": {
@@ -9095,6 +9162,11 @@
90959162
"locationName": "description",
90969163
"documentation": "The new description for the job template, if you are changing it."
90979164
},
9165+
"HopDestinations": {
9166+
"shape": "__listOfHopDestination",
9167+
"locationName": "hopDestinations",
9168+
"documentation": "Optional list of hop destinations."
9169+
},
90989170
"Name": {
90999171
"shape": "__string",
91009172
"locationName": "name",
@@ -9947,6 +10019,12 @@
994710019
"shape": "HlsCaptionLanguageMapping"
994810020
}
994910021
},
10022+
"__listOfHopDestination": {
10023+
"type": "list",
10024+
"member": {
10025+
"shape": "HopDestination"
10026+
}
10027+
},
995010028
"__listOfId3Insertion": {
995110029
"type": "list",
995210030
"member": {
@@ -10037,6 +10115,12 @@
1003710115
"shape": "Queue"
1003810116
}
1003910117
},
10118+
"__listOfQueueTransition": {
10119+
"type": "list",
10120+
"member": {
10121+
"shape": "QueueTransition"
10122+
}
10123+
},
1004010124
"__listOfTeletextPageType": {
1004110125
"type": "list",
1004210126
"member": {

0 commit comments

Comments
 (0)