Connect to Media Services v3 API - Python

This article shows you how to connect to the Azure Media Services v3 Python SDK using the service principal sign in method.


  • Download Python from
  • Make sure to set the PATH environment variable
  • Create a Media Services account. Be sure to remember the resource group name and the Media Services account name.
  • Follow the steps in the Access APIs topic. Record the subscription ID, application ID (client ID), the authentication key (secret), and the tenant ID that you need in the later step.

Install the modules

To work with Azure Media Services using Python, you need to install these modules.

  • The azure-mgmt-resource module, which includes Azure modules for Active Directory.
  • The azure-mgmt-media module, which includes the Media Services entities.

Open a command-line tool and use the following commands to install the modules.

pip3 install azure-mgmt-resource
pip3 install azure-mgmt-media==1.1.1

Connect to the Python client

  1. Create a file with a .py extension

  2. Open the file in your favorite editor

  3. Add the code that follows to the file. The code imports the required modules and creates the Active Directory credentials object you need to connect to Media Services.

    Set the variables' values to the values you got from Access APIs

    import adal
    from msrestazure.azure_active_directory import AdalAuthentication
    from msrestazure.azure_cloud import AZURE_PUBLIC_CLOUD
    from import AzureMediaServices
    from import MediaService
    RESOURCE = ''
    # Tenant ID for your Azure Subscription
    TENANT_ID = '00000000-0000-0000-000000000000'
    # Your Service Principal App ID
    CLIENT = '00000000-0000-0000-000000000000'
    # Your Service Principal Password
    KEY = '00000000-0000-0000-000000000000'
    # Your Azure Subscription ID
    SUBSCRIPTION_ID = '00000000-0000-0000-000000000000'
    # Your Azure Media Service (AMS) Account Name
    ACCOUNT_NAME = 'amsv3account'
    # Your Resource Group Name
    RESOUCE_GROUP_NAME = 'AMSv3ResourceGroup'
    LOGIN_ENDPOINT = AZURE_PUBLIC_CLOUD.endpoints.active_directory
    RESOURCE = AZURE_PUBLIC_CLOUD.endpoints.active_directory_resource_id
    context = adal.AuthenticationContext(LOGIN_ENDPOINT + '/' + TENANT_ID)
    credentials = AdalAuthentication(
    # The AMS Client
    # You can now use this object to perform different operations to your AMS account.
    client = AzureMediaServices(credentials, SUBSCRIPTION_ID)
    print("signed in")
    # Now that you are authenticated, you can manipulate the entities.
    # For example, list assets in your AMS account
    print (client.assets.list(RESOUCE_GROUP_NAME, ACCOUNT_NAME).get(0))
  4. Run the file

Next steps