List Assets in the Media Services account with optional filtering and ordering
GET https://{{api-endpoint}}/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/assets?api-version={{api-version}}
GET https://{{api-endpoint}}/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/assets?api-version={{api-version}}&$filter={$filter}&$top={$top}&$orderby={$orderby}
URI Parameters
Name
In
Required
Type
Description
accountName
path
True
string
The Media Services account name.
resourceGroupName
path
True
string
The name of the resource group within the Azure subscription.
subscriptionId
path
True
string
The unique identifier for a Microsoft Azure subscription.
api-version
query
True
string
The version of the API to be used with the client request. Recommended value: 2026-04-14. This version enables automatic pagination - List responses return up to 1000 records per page with @odata.nextLink included when results continue. See RMS API: Listing large volumes of assets or jobs for details.
$filter
query
string
Restricts the set of items returned.
$orderby
query
string
Specifies the key by which the result collection should be ordered.
$top
query
integer
int32
Specifies a non-negative integer n that limits the number of items returned from a collection. The service returns the number of available items up to but not greater than the specified value n.
POST https://{{api-endpoint}}/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaServices/contosomedia/assets/ClimbingMountSaintHelens/listStreamingLocators?api-version={{api-version}}
Java
/** Samples for Assets ListStreamingLocators. */
public final class Main {
/*
* x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-streaming-locators.json
*/
/**
* Sample code: List Asset SAS URLs.
*
* @param manager Entry point to MediaServicesManager.
*/
public static void listAssetSASURLs(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
manager
.assets()
.listStreamingLocatorsWithResponse(
"contosorg", "contosomedia", "ClimbingMountSaintHelens", com.azure.core.util.Context.NONE);
}
}
Python
from azure.identity import DefaultAzureCredential
from azure.mgmt.media import AzureMediaServices
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-media
# USAGE
python assetsliststreaminglocators.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = AzureMediaServices(
credential=DefaultAzureCredential(),
subscription_id="00000000-0000-0000-0000-000000000000",
)
response = client.assets.list_streaming_locators(
resource_group_name="contoso",
account_name="contosomedia",
asset_name="ClimbingMountSaintHelens",
)
print(response)
# x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-streaming-locators.json
if __name__ == "__main__":
main()
using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Media;
// Generated from example definition: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-all.json
// this example is just showing the usage of "Assets_List" operation, for the dependent resources, they will have to be created separately.
// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);
// this example assumes you already have this MediaServicesAccountResource created on azure
// for more information of creating MediaServicesAccountResource, please refer to the document of MediaServicesAccountResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "contoso";
string accountName = "contosomedia";
ResourceIdentifier mediaServicesAccountResourceId = MediaServicesAccountResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName);
MediaServicesAccountResource mediaServicesAccount = client.GetMediaServicesAccountResource(mediaServicesAccountResourceId);
// get the collection of this MediaAssetResource
MediaAssetCollection collection = mediaServicesAccount.GetMediaAssets();
// invoke the operation and iterate over the result
await foreach (MediaAssetResource item in collection.GetAllAsync())
{
// the variable item is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
MediaAssetData resourceData = item.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}
Console.WriteLine($"Succeeded");
{
"value": [
{
"name": "ClimbingMountRainier",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountRainier",
"type": "Microsoft.Media/mediaservices/assets",
"properties": {
"assetId": "f8eea45c-b814-44c2-9c42-a5174ebdee4c",
"created": "2012-11-01T00:00:00Z",
"lastModified": "2012-11-01T00:00:00Z",
"alternateId": "CLIMB00001",
"description": "A documentary showing the ascent of Mount Rainier",
"container": "asset-f8eea45c-b814-44c2-9c42-a5174ebdee4c",
"storageEncryptionFormat": "None"
}
},
{
"name": "ClimbingMountAdams",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountAdams",
"type": "Microsoft.Media/mediaservices/assets",
"properties": {
"assetId": "1b648c1a-2268-461d-a1da-742bde23db40",
"created": "2013-02-01T00:00:00Z",
"lastModified": "2017-11-01T00:00:00Z",
"alternateId": "CLIMB00002",
"description": "A documentary showing the ascent of Mount Adams",
"container": "asset-1b648c1a-2268-461d-a1da-742bde23db40",
"storageEncryptionFormat": "None"
}
},
{
"name": "ClimbingMountSaintHelens",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountSaintHelens",
"type": "Microsoft.Media/mediaservices/assets",
"properties": {
"assetId": "14d58c40-ec1f-446c-b041-f5cff949bd1d",
"created": "2013-03-01T00:00:00Z",
"lastModified": "2013-04-01T00:00:00Z",
"alternateId": "CLIMB00005",
"description": "A documentary showing the ascent of Saint Helens",
"container": "asset-14d58c40-ec1f-446c-b041-f5cff949bd1d",
"storageEncryptionFormat": "MediaStorageClientEncryption"
}
}
]
}
List Asset created in a date range
Technology
Sample request
HTTP
GET https://{{api-endpoint}}/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaServices/contosomedia/assets?api-version={{api-version}}&$filter=properties/created gt 2012-06-01 and properties/created lt 2013-07-01&$orderby=properties/created
Java
/**
* Samples for Assets List.
*/
public final class Main {
/*
* x-ms-original-file:
* specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-in-
* date-range.json
*/
/**
* Sample code: List Asset created in a date range.
*
* @param manager Entry point to MediaServicesManager.
*/
public static void
listAssetCreatedInADateRange(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
manager.assets().list("contosorg", "contosomedia",
"properties/created gt 2012-06-01 and properties/created lt 2013-07-01", null, "properties/created",
com.azure.core.util.Context.NONE);
}
}
Python
from azure.identity import DefaultAzureCredential
from azure.mgmt.media import AzureMediaServices
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-media
# USAGE
python assetslistindaterange.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = AzureMediaServices(
credential=DefaultAzureCredential(),
subscription_id="00000000-0000-0000-0000-000000000000",
)
response = client.assets.list(
resource_group_name="contoso",
account_name="contosomedia",
)
for item in response:
print(item)
# x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-in-date-range.json
if __name__ == "__main__":
main()
using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Media;
// Generated from example definition: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-in-date-range.json
// this example is just showing the usage of "Assets_List" operation, for the dependent resources, they will have to be created separately.
// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);
// this example assumes you already have this MediaServicesAccountResource created on azure
// for more information of creating MediaServicesAccountResource, please refer to the document of MediaServicesAccountResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "contoso";
string accountName = "contosomedia";
ResourceIdentifier mediaServicesAccountResourceId = MediaServicesAccountResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName);
MediaServicesAccountResource mediaServicesAccount = client.GetMediaServicesAccountResource(mediaServicesAccountResourceId);
// get the collection of this MediaAssetResource
MediaAssetCollection collection = mediaServicesAccount.GetMediaAssets();
// invoke the operation and iterate over the result
string filter = "properties/created gt 2012-06-01 and properties/created lt 2013-07-01";
string orderby = "properties/created";
await foreach (MediaAssetResource item in collection.GetAllAsync(filter: filter, orderby: orderby))
{
// the variable item is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
MediaAssetData resourceData = item.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}
Console.WriteLine($"Succeeded");
{
"value": [
{
"name": "ClimbingMountRainier",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountRainier",
"type": "Microsoft.Media/mediaservices/assets",
"properties": {
"assetId": "f8eea45c-b814-44c2-9c42-a5174ebdee4c",
"created": "2012-11-01T00:00:00Z",
"lastModified": "2012-11-01T00:00:00Z",
"alternateId": "CLIMB00001",
"description": "A documentary showing the ascent of Mount Rainier",
"container": "asset-f8eea45c-b814-44c2-9c42-a5174ebdee4c",
"storageEncryptionFormat": "None"
}
},
{
"name": "ClimbingMountAdams",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountAdams",
"type": "Microsoft.Media/mediaservices/assets",
"properties": {
"assetId": "1b648c1a-2268-461d-a1da-742bde23db40",
"created": "2013-02-01T00:00:00Z",
"lastModified": "2017-11-01T00:00:00Z",
"alternateId": "CLIMB00002",
"description": "A documentary showing the ascent of Mount Adams",
"container": "asset-1b648c1a-2268-461d-a1da-742bde23db40",
"storageEncryptionFormat": "None"
}
},
{
"name": "ClimbingMountSaintHelens",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountSaintHelens",
"type": "Microsoft.Media/mediaservices/assets",
"properties": {
"assetId": "14d58c40-ec1f-446c-b041-f5cff949bd1d",
"created": "2013-03-01T00:00:00Z",
"lastModified": "2013-04-01T00:00:00Z",
"alternateId": "CLIMB00005",
"description": "A documentary showing the ascent of Saint Helens",
"container": "asset-14d58c40-ec1f-446c-b041-f5cff949bd1d",
"storageEncryptionFormat": "MediaStorageClientEncryption"
}
}
]
}
List Asset ordered by date
Technology
Sample request
HTTP
GET https://{{api-endpoint}}/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaServices/contosomedia/assets?api-version={{api-version}}&$orderby=properties/created
Java
/**
* Samples for Assets List.
*/
public final class Main {
/*
* x-ms-original-file:
* specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-by-
* date.json
*/
/**
* Sample code: List Asset ordered by date.
*
* @param manager Entry point to MediaServicesManager.
*/
public static void listAssetOrderedByDate(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
manager.assets().list("contosorg", "contosomedia", null, null, "properties/created",
com.azure.core.util.Context.NONE);
}
}
from azure.identity import DefaultAzureCredential
from azure.mgmt.media import AzureMediaServices
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-media
# USAGE
python assetslistbydate.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = AzureMediaServices(
credential=DefaultAzureCredential(),
subscription_id="00000000-0000-0000-0000-000000000000",
)
response = client.assets.list(
resource_group_name="contoso",
account_name="contosomedia",
)
for item in response:
print(item)
# x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-by-date.json
if __name__ == "__main__":
main()
using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Media;
// Generated from example definition: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-all.json
// this example is just showing the usage of "Assets_List" operation, for the dependent resources, they will have to be created separately.
// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);
// this example assumes you already have this MediaServicesAccountResource created on azure
// for more information of creating MediaServicesAccountResource, please refer to the document of MediaServicesAccountResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "contoso";
string accountName = "contosomedia";
ResourceIdentifier mediaServicesAccountResourceId = MediaServicesAccountResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName);
MediaServicesAccountResource mediaServicesAccount = client.GetMediaServicesAccountResource(mediaServicesAccountResourceId);
// get the collection of this MediaAssetResource
MediaAssetCollection collection = mediaServicesAccount.GetMediaAssets();
// invoke the operation and iterate over the result
await foreach (MediaAssetResource item in collection.GetAllAsync())
{
// the variable item is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
MediaAssetData resourceData = item.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}
Console.WriteLine($"Succeeded");
The type of the resource, e.g., "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts".
AssetStorageEncryptionFormat
The Asset encryption format. One of None or MediaStorageEncryption.
Name
Type
Description
MediaStorageClientEncryption
string
The Asset is encrypted with Media Services client-side encryption.
None
string
The Asset does not use client-side storage encryption (this is the only allowed value for new Assets).
AssetCollection
A collection of Asset items.
Name
Type
Description
@odata.nextLink
string
A link to the next page of the collection (when the collection contains too many results to return in one response). Supported for api-version=2026-04-14 , learn more.
With earlier versions: included only when $top is set and results exceed that value.
