Create a transform

---

AMS website | Media Services v2 documentation | Code Samples | Troubleshooting guide

The Azure CLI script in this article shows how to create a transform. Transforms describe a simple workflow of tasks for processing your video or audio files (often referred to as a "recipe"). You should always check if a Transform with desired name and "recipe" already exist. If it does, you should reuse it.

Prerequisites

Create a Media Services account.

Methods

You can use the following methods to create a transform.

Portal

Create a transform with the portal

1. Navigate to the Media Service account you want to work with.
2. Select Transforms + jobs.
3. Select Add transform. The Add transform screen will appear.
4. Enter a transform name in the Transform name field.
5. Select the Encoding radio button.
6. Select the prest you want to use from the Built-in preset name dropdown list.
7. Select Add.

CLI

Create a transform with the CLI

For more information about this command, see the Media Services CLI reference

REST

Create a transform with REST

See the Media Services REST API for creating a transform.

Python

Create a transform with Python

The functions in the Python code snippets assume that you have:

1. Imported the necessary modules. You may not need all of the modules shown here. If the code below doesn't use the module, you can omit it.
2. Created and edited an .env file that contains your authentication values. You can get a sample.env file from the Media Services Python samples.
3. Read and instantiated environment variables by using load_env() as below. Depending on what you are doing, you may or may not need some of the variables.
4. Created a Media Services client as below.

from dotenv import load_dotenv
from azure.identity import DefaultAzureCredential
from azure.mgmt.media import AzureMediaServices
# BuiltInEncoderPreset is used here but you should import the preset that you want to use.
from azure.mgmt.media.models import (Transform,TransformOutput,BuiltInStandardEncoderPreset)
import os

# Get environment variables
load_dotenv()

subscriptionId = os.getenv("SUBSCRIPTIONID")
accountName=os.getenv("ACCOUNTNAME")
resourceGroupName=os.getenv("RESOURCEGROUP")
clientId = os.getenv("AZURE_CLIENT_ID")
storageAccountName=os.getenv("STORAGEACCOUNTNAME")

# Create the Media Services client and authenticate using the DefaultAzureCredential
default_credential = DefaultAzureCredential()
# From SDK
# AzureMediaServices(credentials, subscription_id, base_url=None)
client = AzureMediaServices(default_credential, subscriptionId)

# Create a Transform
# Set the name of the transform you want to create.
transformName='MyTransform'

# Create at least one transform output.
# Don't forget to import the preset that you want to use.
# From SDK
# TransformOutput(*, preset, on_error=None, relative_priority=None, **kwargs) -> None
transform_output = TransformOutput(preset=BuiltInStandardEncoderPreset(preset_name="AdaptiveStreaming"))

# Add the transform output to the outputs list
outputs = [transform_output]

# Create the transform object
# From SDK
# Transform(*, description: Optional[str] = None, outputs: Optional[List[azure.mgmt.media.models._models_py3.TransformOutput]] = None, **kwargs)
transform = Transform(description="My description",outputs=outputs)

print("Creating transform " + transformName)
# From SDK
# Create_or_update(resource_group_name, account_name, transform_name, outputs, description=None, custom_headers=None, raw=False, **operation_config)

def createTransform(resource_group_name, account_name, transform_name,transform):
    client.transforms.create_or_update(resource_group_name,account_name,transform_name,transform)

createTransform(resourceGroupName,accountName,transformName,transform)