POST

/2017-08-29/queues

http://mediaconvert.{region}.amazonaws.com/2017-08-29/queues

Create a new transcoding queue. For information about queues, see Working With Queues in the User Guide at https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html

Access Token Required: API Key

Body Params

namestringrequired

The name of the queue that you are creating.

tagsobject

The tags that you want to add to the resource. You can tag resources with a key-value pair or with only a key.

statusstring

Queues can be ACTIVE or PAUSED. If you pause a queue, jobs in that queue won't begin. Jobs that are running when you pause a queue continue to run until they finish or result in an error.

descriptionstring

Optional. A description of the queue that you are creating.

pricingPlanstring

Specifies whether the pricing plan for the queue is on-demand or reserved. For on-demand, you pay per minute, billed in increments of .01 minute. For reserved, you pay for the transcoding capacity of the entire queue, regardless of how much or how little you use it. Reserved pricing requires a 12-month commitment.

reservationPlanSettingsobject

Details about the pricing plan for your reserved queue. Required for reserved queues and not applicable to on-demand queues.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://mediaconvert.{region}.amazonaws.com/2017-08-29/queues' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}