Create an asset filter

---

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

This article shows you how to create a Media Services asset filter.

Methods

You can use the following methods to create a Media Services asset filter.

Portal

Create, list or update an asset filter in the portal

1. Navigate to the Media Services account you want to work with.
2. Select Assets. The assets screen will appear.
3. Select the asset you want to work with from the list.

Add a filter

1. Select + Add an asset filter. The Add asset filter screen will appear.
2. Enter a name in the Asset filter name field.

List and update a filter

1. Select a filter from the filters list. The Update asset filter screen will appear.

Time constraints

1. Select the Time range constraints tab.
2. If you need to change the timescale of the filter, check the manifest to get the timescale and timestamps, enter a number into the Timescale field.
3. Optionally, you can set:
   1. The earliest timestamp that should appear in the playback manifest.
   2. The last timestamp that should appear in the playback manifest.
   3. The limit for rewinding content.
   4. How much time to delay your live broadcast.

Track constraints

1. Select the Track constraints tab.
2. Enter the bitrate in the HLS startup bitrate field to set the first video track to appear in the HLS playlist to allow HLS native players to start downloading from this quality level.
3. From the Track selection rules dropdown lists, select the track, video, audio or text.
4. From the Type dropdown list select one of the conditions for the rule.
5. In the Value field, enter the value for the condition of the rule.

Once you have finished configuring the asset filter select Save.

CLI

Create an asset filter with the CLI

For more information about this command, see the CLI reference.

REST

Create an asset filter with REST

See the REST API for creating an asset filter.

Python

Create an asset filter 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
from azure.mgmt.media.models import (
    AccountFilter,
    FirstQuality,
    AssetFilter
)
import os

# Get environment variables
load_dotenv()

subscription_id = os.getenv("SUBSCRIPTIONID")
account_name=os.getenv("ACCOUNTNAME")
resource_group_name=os.getenv("RESOURCEGROUP")
client_id = os.getenv("AZURE_CLIENT_ID")
storage_account_name=os.getenv("STORAGEACCOUNTNAME")

# Create the Media Services client and authenticate using the DefaultAzureCredential
default_credential = DefaultAzureCredential()
client = AzureMediaServices(default_credential, subscription_id)

# Set the name of the Asset filter you want to create
filter_name = "myassetfiltername"

# For this sample, we are using an existing asset to add the asset filter. If one doesn't already exist, create a new asset.
asset_name = "myoutputasset"

# Set the properties of the asset filter
# For this sample, you are setting the first quality bitrate for the asset filter.
first_quality = FirstQuality(bitrate=128000)
asset_filter = AssetFilter(first_quality=first_quality)

# From SDK:
# create_or_update(resource_group_name: str, account_name: str, asset_name: str, filter_name: str, parameters: azure.mgmt.media.models._models_py3.AssetFilter, **kwargs: Any) -> azure.mgmt.media.models._models_py3.AssetFilter
def create_asset_filter(resource_group_name, account_name, asset_name, filter_name, parameters):
    client.asset_filters.create_or_update(resource_group_name, account_name, asset_name, filter_name, parameters)
    
create_asset_filter(resource_group_name, account_name, asset_name, filter_name, parameters=asset_filter)