Getting Started with AWS Elemental MediaConvert Using the AWS SDKs or the
AWS CLI

To get started with AWS Elemental MediaConvert using one of the AWS SDKS or the AWS
Command Line Interface (AWS CLI), follow
this general procedure. For specific instructions and examples, choose a language
in the
final step of this procedure.

Set up AWS Identity and Access Management (IAM) permissions for both yourself and
for the MediaConvert service
to access your resources on your behalf:

For information about setting up permissions for the service to access
your resources, see Set Up IAM Permissions in the MediaConvert User
Guide.

In your client configuration, specify your authentication credentials and your
AWS Region. For instructions that are specific to the programming language that
you use, choose from this list of links to open the relevant topics in the AWS CLI
or
SDK guides:

Get your account-specific endpoint and send your MediaConvert requests to it. With
most
AWS services, you send your service request to a public endpoint. But with MediaConvert,
you request an endpoint that is specific to your account, and then you send your
service requests to that.

For specific instructions and code samples, choose one of the following
tabs:

AWS CLIC++GoJavaJavaScript.NETPHPPythonRubyTools for Powershell

AWS CLI

To create a transcoding job using the AWS CLI:

Use describe-endpoints to get your account
endpoint and set your region. In this example, the region is set
to ap-northeast-3:

aws mediaconvert describe-endpoints --region ap-northeast-3

Use the --endpoint-url option to send your
request to your account endpoint:

In the preceding example, job.json
specifies your transcoding job settings. You can use the MediaConvert
console to generate the JSON job specification by choosing your
job settings, and then choosing Show job
JSON at the bottom of the
Job section. For sample job
specifications, see Sample Job Settings Specifications in JSON.

Make the DescribeEndpoints call only once in your application. Don't use DescribeEndpoints to create your AWS client each time that you make a request to MediaConvert. Otherwise,
you will reach the throttle maximum on the public API endpoint.

Make the DescribeEndpoints call only once in your application. Don't use DescribeEndpoints to create your AWS client each time that you make a request to MediaConvert. Otherwise,
you will reach the throttle maximum on the public API endpoint.

Make the DescribeEndpoints call only once in your application. Don't use DescribeEndpoints to create your AWS client each time that you make a request to MediaConvert. Otherwise,
you will reach the throttle maximum on the public API endpoint.

Make the DescribeEndpoints call only once in your application. Don't use DescribeEndpoints to create your AWS client each time that you make a request to MediaConvert. Otherwise,
you will reach the throttle maximum on the public API endpoint.

Python

Follow these steps to send requests using the AWS SDK for Python (Boto):

Make the DescribeEndpoints call only once in your application. Don't use DescribeEndpoints to create your AWS client each time that you make a request to MediaConvert. Otherwise,
you will reach the throttle maximum on the public API endpoint.

Specify the transcoding settings for your job in a JSON
file.

You can use the AWS Elemental MediaConvert console to generate the JSON job
specification by choosing your job settings, and then choosing
Show job JSON at the bottom of the
Job section. For sample job
specifications, see Sample Job Settings Specifications in JSON.

Perform these steps in your Python code, as demonstrated in
the example that follows these steps:

Make the DescribeEndpoints call only once in your application. Don't use DescribeEndpoints to create your AWS client each time that you make a request to MediaConvert. Otherwise,
you will reach the throttle maximum on the public API endpoint.

Tools for Powershell

After you use the Get-EMCEndpoint Cmdlet to request an account-specific
endpoint, send your requests to it as described in Specifying a Custom or Nonstandard Endpoint in the
AWS Tools for PowerShell User Guide. In brief, you specify
your account-specific endpoint as a URL by adding the
-EndpointUrl common parameter to your AWS Tools for
PowerShell command.

In this example, replace
https://abcd1234.mediaconvert.us-west-1.amazonaws.com
with the endpoint that you get back from your Get-EMCEndpoint
Cmdlet request:

Make the DescribeEndpoints call only once in your application. Don't use DescribeEndpoints to create your AWS client each time that you make a request to MediaConvert. Otherwise,
you will reach the throttle maximum on the public API endpoint.

Javascript is disabled or is unavailable in your browser.

To use the AWS Documentation, Javascript must be enabled. Please refer to your browser's
Help pages for instructions.