Skip to main content

Search

Ravnur Knowledge Base

List

Alla Blinova
  • Updated

In this article:

List Assets in the Media Services account with optional filtering and ordering

GET https://{{apiEndpoint}}/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/assets?api-version={{api-version}}

With optional parameters:

GET https://{{apiEndpoint}}/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.
$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.

 

Responses

Name Type Description
200 OK Asset OK
Other Status Codes ErrorResponse Detailed error information.

 

Examples

Technology Sample request
HTTP 
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);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue.
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()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue.
Go 
package armmediaservices_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/mediaservices/armmediaservices/v3"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/e7bf3adfa2d5e5cdbb804eec35279501794f461c/specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-streaming-locators.json
func ExampleAssetsClient_ListStreamingLocators() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armmediaservices.NewClientFactory("", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewAssetsClient().ListStreamingLocators(ctx, "contoso", "contosomedia", "ClimbingMountSaintHelens", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.ListStreamingLocatorsResponse = armmediaservices.ListStreamingLocatorsResponse{
	// 	StreamingLocators: []*armmediaservices.AssetStreamingLocator{
	// 		{
	// 			Name: to.Ptr("secureStreamingLocator"),
	// 			AssetName: to.Ptr("ClimbingMountSaintHelens"),
	// 			Created: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-08-08T18:29:26.972Z"); return t}()),
	// 			EndTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "9999-12-31T23:59:59.999Z"); return t}()),
	// 			StreamingLocatorID: to.Ptr("36b74ce3-20b4-4de0-84f1-97e9138e886c"),
	// 			StreamingPolicyName: to.Ptr("secureStreamingPolicy"),
	// 		},
	// 		{
	// 			Name: to.Ptr("clearStreamingLocator"),
	// 			AssetName: to.Ptr("ClimbingMountSaintHelens"),
	// 			Created: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-08-08T18:29:26.948Z"); return t}()),
	// 			EndTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "9999-12-31T23:59:59.999Z"); return t}()),
	// 			StreamingLocatorID: to.Ptr("3e8d9ac3-50f6-4f6d-8482-078ceb56f23a"),
	// 			StreamingPolicyName: to.Ptr("clearStreamingPolicy"),
	// 	}},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue.
JavaScript 
const { AzureMediaServices } = require("@azure/arm-mediaservices");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Lists Streaming Locators which are associated with this asset.
 *
 * @summary Lists Streaming Locators which are associated with this asset.
 * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-streaming-locators.json
 */
async function listAssetSasUrLs() {
  const subscriptionId =
    process.env["MEDIASERVICES_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["MEDIASERVICES_RESOURCE_GROUP"] || "contoso";
  const accountName = "contosomedia";
  const assetName = "ClimbingMountSaintHelens";
  const credential = new DefaultAzureCredential();
  const client = new AzureMediaServices(credential, subscriptionId);
  const result = await client.assets.listStreamingLocators(
    resourceGroupName,
    accountName,
    assetName
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue.
.NET 
using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Media;
using Azure.ResourceManager.Media.Models;

// Generated from example definition: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-streaming-locators.json
// this example is just showing the usage of "Assets_ListStreamingLocators" 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 MediaAssetResource created on azure
// for more information of creating MediaAssetResource, please refer to the document of MediaAssetResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "contoso";
string accountName = "contosomedia";
string assetName = "ClimbingMountSaintHelens";
ResourceIdentifier mediaAssetResourceId = MediaAssetResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName, assetName);
MediaAssetResource mediaAsset = client.GetMediaAssetResource(mediaAssetResourceId);

// invoke the operation and iterate over the result
await foreach (MediaAssetStreamingLocator item in mediaAsset.GetStreamingLocatorsAsync())
{
    Console.WriteLine($"Succeeded: {item}");
}

Console.WriteLine($"Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue.

 

Sample response

Status code: 200

{
  "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);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue.
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()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue.
Go 
package armmediaservices_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/mediaservices/armmediaservices/v3"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/e7bf3adfa2d5e5cdbb804eec35279501794f461c/specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-in-date-range.json
func ExampleAssetsClient_NewListPager_listAssetCreatedInADateRange() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armmediaservices.NewClientFactory("", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewAssetsClient().NewListPager("contoso", "contosomedia", &armmediaservices.AssetsClientListOptions{Filter: to.Ptr("properties/created gt 2012-06-01 and properties/created lt 2013-07-01"),
		Top:     nil,
		Orderby: to.Ptr("properties/created"),
	})
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.AssetCollection = armmediaservices.AssetCollection{
		// 	Value: []*armmediaservices.Asset{
		// 		{
		// 			Name: to.Ptr("ClimbingMountRainier"),
		// 			Type: to.Ptr("Microsoft.Media/mediaservices/assets"),
		// 			ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountRainier"),
		// 			Properties: &armmediaservices.AssetProperties{
		// 				Description: to.Ptr("A documentary showing the ascent of Mount Rainier"),
		// 				AlternateID: to.Ptr("CLIMB00001"),
		// 				AssetID: to.Ptr("f8eea45c-b814-44c2-9c42-a5174ebdee4c"),
		// 				Container: to.Ptr("asset-f8eea45c-b814-44c2-9c42-a5174ebdee4c"),
		// 				Created: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2012-11-01T00:00:00.000Z"); return t}()),
		// 				LastModified: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2012-11-01T00:00:00.000Z"); return t}()),
		// 				StorageEncryptionFormat: to.Ptr(armmediaservices.AssetStorageEncryptionFormatNone),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("ClimbingMountAdams"),
		// 			Type: to.Ptr("Microsoft.Media/mediaservices/assets"),
		// 			ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountAdams"),
		// 			Properties: &armmediaservices.AssetProperties{
		// 				Description: to.Ptr("A documentary showing the ascent of Mount Adams"),
		// 				AlternateID: to.Ptr("CLIMB00002"),
		// 				AssetID: to.Ptr("1b648c1a-2268-461d-a1da-742bde23db40"),
		// 				Container: to.Ptr("asset-1b648c1a-2268-461d-a1da-742bde23db40"),
		// 				Created: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2013-02-01T00:00:00.000Z"); return t}()),
		// 				LastModified: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-11-01T00:00:00.000Z"); return t}()),
		// 				StorageEncryptionFormat: to.Ptr(armmediaservices.AssetStorageEncryptionFormatNone),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("ClimbingMountSaintHelens"),
		// 			Type: to.Ptr("Microsoft.Media/mediaservices/assets"),
		// 			ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountSaintHelens"),
		// 			Properties: &armmediaservices.AssetProperties{
		// 				Description: to.Ptr("A documentary showing the ascent of Saint Helens"),
		// 				AlternateID: to.Ptr("CLIMB00005"),
		// 				AssetID: to.Ptr("14d58c40-ec1f-446c-b041-f5cff949bd1d"),
		// 				Container: to.Ptr("asset-14d58c40-ec1f-446c-b041-f5cff949bd1d"),
		// 				Created: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2013-03-01T00:00:00.000Z"); return t}()),
		// 				LastModified: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2013-04-01T00:00:00.000Z"); return t}()),
		// 				StorageEncryptionFormat: to.Ptr(armmediaservices.AssetStorageEncryptionFormatMediaStorageClientEncryption),
		// 			},
		// 	}},
		// }
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue.
JavaScript 
const { AzureMediaServices } = require("@azure/arm-mediaservices");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to List Assets in the Media Services account with optional filtering and ordering
 *
 * @summary List Assets in the Media Services account with optional filtering and ordering
 * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-in-date-range.json
 */
async function listAssetCreatedInADateRange() {
  const subscriptionId =
    process.env["MEDIASERVICES_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["MEDIASERVICES_RESOURCE_GROUP"] || "contoso";
  const accountName = "contosomedia";
  const filter = "properties/created gt 2012-06-01 and properties/created lt 2013-07-01";
  const orderby = "properties/created";
  const options = { filter, orderby };
  const credential = new DefaultAzureCredential();
  const client = new AzureMediaServices(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.assets.list(resourceGroupName, accountName, options)) {
    resArray.push(item);
  }
  console.log(resArray);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue.
.NET 
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");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue.

 

Sample response

Status code: 200

{
  "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);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue.
Python 
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()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue.
Go 
package armmediaservices_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/mediaservices/armmediaservices/v3"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/e7bf3adfa2d5e5cdbb804eec35279501794f461c/specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-by-date.json
func ExampleAssetsClient_NewListPager_listAssetOrderedByDate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armmediaservices.NewClientFactory("", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewAssetsClient().NewListPager("contoso", "contosomedia", &armmediaservices.AssetsClientListOptions{Filter: nil,
		Top:     nil,
		Orderby: to.Ptr("properties/created"),
	})
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.AssetCollection = armmediaservices.AssetCollection{
		// 	Value: []*armmediaservices.Asset{
		// 		{
		// 			Name: to.Ptr("ClimbingMountBaker"),
		// 			Type: to.Ptr("Microsoft.Media/mediaservices/assets"),
		// 			ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountBaker"),
		// 			Properties: &armmediaservices.AssetProperties{
		// 				Description: to.Ptr("A documentary showing the ascent of Mount Baker"),
		// 				AlternateID: to.Ptr("CLIMB00004"),
		// 				AssetID: to.Ptr("89af1750-e681-4fbe-8c4c-9a5567867a6b"),
		// 				Container: to.Ptr("asset-89af1750-e681-4fbe-8c4c-9a5567867a6b"),
		// 				Created: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2011-02-01T00:00:00.000Z"); return t}()),
		// 				LastModified: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-11-01T00:00:00.000Z"); return t}()),
		// 				StorageEncryptionFormat: to.Ptr(armmediaservices.AssetStorageEncryptionFormatNone),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("ClimbingLittleTahoma"),
		// 			Type: to.Ptr("Microsoft.Media/mediaservices/assets"),
		// 			ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingLittleTahoma"),
		// 			Properties: &armmediaservices.AssetProperties{
		// 				Description: to.Ptr("A documentary showing the ascent of Little Tahoma"),
		// 				AlternateID: to.Ptr("CLIMB00003"),
		// 				AssetID: to.Ptr("e6c7ee55-d1f5-48bc-9c36-2d2157aadbbe"),
		// 				Container: to.Ptr("asset-e6c7ee55-d1f5-48bc-9c36-2d2157aadbbe"),
		// 				Created: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2012-04-01T00:00:00.000Z"); return t}()),
		// 				LastModified: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-11-01T00:00:00.000Z"); return t}()),
		// 				StorageEncryptionFormat: to.Ptr(armmediaservices.AssetStorageEncryptionFormatNone),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("ClimbingMountRainier"),
		// 			Type: to.Ptr("Microsoft.Media/mediaservices/assets"),
		// 			ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountRainier"),
		// 			Properties: &armmediaservices.AssetProperties{
		// 				Description: to.Ptr("A documentary showing the ascent of Mount Rainier"),
		// 				AlternateID: to.Ptr("CLIMB00001"),
		// 				AssetID: to.Ptr("f8eea45c-b814-44c2-9c42-a5174ebdee4c"),
		// 				Container: to.Ptr("asset-f8eea45c-b814-44c2-9c42-a5174ebdee4c"),
		// 				Created: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2012-11-01T00:00:00.000Z"); return t}()),
		// 				LastModified: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2012-11-01T00:00:00.000Z"); return t}()),
		// 				StorageEncryptionFormat: to.Ptr(armmediaservices.AssetStorageEncryptionFormatNone),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("ClimbingMountAdams"),
		// 			Type: to.Ptr("Microsoft.Media/mediaservices/assets"),
		// 			ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountAdams"),
		// 			Properties: &armmediaservices.AssetProperties{
		// 				Description: to.Ptr("A documentary showing the ascent of Mount Adams"),
		// 				AlternateID: to.Ptr("CLIMB00002"),
		// 				AssetID: to.Ptr("1b648c1a-2268-461d-a1da-742bde23db40"),
		// 				Container: to.Ptr("asset-1b648c1a-2268-461d-a1da-742bde23db40"),
		// 				Created: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2013-02-01T00:00:00.000Z"); return t}()),
		// 				LastModified: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2017-11-01T00:00:00.000Z"); return t}()),
		// 				StorageEncryptionFormat: to.Ptr(armmediaservices.AssetStorageEncryptionFormatNone),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("ClimbingMountSaintHelens"),
		// 			Type: to.Ptr("Microsoft.Media/mediaservices/assets"),
		// 			ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountSaintHelens"),
		// 			Properties: &armmediaservices.AssetProperties{
		// 				Description: to.Ptr("A documentary showing the ascent of Saint Helens"),
		// 				AlternateID: to.Ptr("CLIMB00005"),
		// 				AssetID: to.Ptr("14d58c40-ec1f-446c-b041-f5cff949bd1d"),
		// 				Container: to.Ptr("asset-14d58c40-ec1f-446c-b041-f5cff949bd1d"),
		// 				Created: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2013-03-01T00:00:00.000Z"); return t}()),
		// 				LastModified: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2013-04-01T00:00:00.000Z"); return t}()),
		// 				StorageEncryptionFormat: to.Ptr(armmediaservices.AssetStorageEncryptionFormatMediaStorageClientEncryption),
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("ClimbingMountRainer"),
		// 			Type: to.Ptr("Microsoft.Media/mediaservices/assets"),
		// 			ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountRainer"),
		// 			Properties: &armmediaservices.AssetProperties{
		// 				Description: to.Ptr("descClimbingMountRainer"),
		// 				AlternateID: to.Ptr("altClimbingMountRainer"),
		// 				AssetID: to.Ptr("8cdacfe5-8473-413a-9aec-dd2a478b37c8"),
		// 				Container: to.Ptr("testasset0"),
		// 				Created: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-08-08T18:29:25.051Z"); return t}()),
		// 				LastModified: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-08-08T21:29:25.051Z"); return t}()),
		// 				StorageAccountName: to.Ptr("storage0"),
		// 				StorageEncryptionFormat: to.Ptr(armmediaservices.AssetStorageEncryptionFormatNone),
		// 			},
		// 	}},
		// }
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue.
JavaScript 
const { AzureMediaServices } = require("@azure/arm-mediaservices");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to List Assets in the Media Services account with optional filtering and ordering
 *
 * @summary List Assets in the Media Services account with optional filtering and ordering
 * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/assets-list-by-date.json
 */
async function listAssetOrderedByDate() {
  const subscriptionId =
    process.env["MEDIASERVICES_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["MEDIASERVICES_RESOURCE_GROUP"] || "contoso";
  const accountName = "contosomedia";
  const orderby = "properties/created";
  const options = { orderby };
  const credential = new DefaultAzureCredential();
  const client = new AzureMediaServices(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.assets.list(resourceGroupName, accountName, options)) {
    resArray.push(item);
  }
  console.log(resArray);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue.
.NET 
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-by-date.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 orderby = "properties/created";
await foreach (MediaAssetResource item in collection.GetAllAsync(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");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue.

 

Sample response

Status code: 200

{
  "value": [
    {
      "name": "ClimbingMountBaker",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountBaker",
      "type": "Microsoft.Media/mediaservices/assets",
      "properties": {
        "assetId": "89af1750-e681-4fbe-8c4c-9a5567867a6b",
        "created": "2011-02-01T00:00:00Z",
        "lastModified": "2017-11-01T00:00:00Z",
        "alternateId": "CLIMB00004",
        "description": "A documentary showing the ascent of Mount Baker",
        "container": "asset-89af1750-e681-4fbe-8c4c-9a5567867a6b",
        "storageEncryptionFormat": "None"
      }
    },
    {
      "name": "ClimbingLittleTahoma",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingLittleTahoma",
      "type": "Microsoft.Media/mediaservices/assets",
      "properties": {
        "assetId": "e6c7ee55-d1f5-48bc-9c36-2d2157aadbbe",
        "created": "2012-04-01T00:00:00Z",
        "lastModified": "2017-11-01T00:00:00Z",
        "alternateId": "CLIMB00003",
        "description": "A documentary showing the ascent of Little Tahoma",
        "container": "asset-e6c7ee55-d1f5-48bc-9c36-2d2157aadbbe",
        "storageEncryptionFormat": "None"
      }
    },
    {
      "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"
      }
    },
    {
      "name": "ClimbingMountRainer",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/assets/ClimbingMountRainer",
      "type": "Microsoft.Media/mediaservices/assets",
      "properties": {
        "assetId": "8cdacfe5-8473-413a-9aec-dd2a478b37c8",
        "created": "2018-08-08T18:29:25.0514734Z",
        "lastModified": "2018-08-08T21:29:25.0514734Z",
        "alternateId": "altClimbingMountRainer",
        "description": "descClimbingMountRainer",
        "container": "testasset0",
        "storageAccountName": "storage0",
        "storageEncryptionFormat": "None"
      }
    }
  ]
}

 

Definitions

Name Description
Asset An Asset.
AssetCollection A collection of Asset items.
AssetStorageEncryptionFormat The Asset encryption format. One of None or MediaStorageEncryption.
createdByType The type of identity that created the resource.
ErrorAdditionalInfo The resource management error additional info.
ErrorDetail The error detail.
ErrorResponse Error response
systemData Metadata pertaining to creation and last modification of the resource.

 

Asset

Name Type Description
id string

Fully qualified resource ID for the resource. Ex -

/subscriptions/{subscriptionId}/resourceGroups/
{resourceGroupName}/providers/{resourceProvider
Namespace}/{resourceType}/{resourceName}
name string The name of the resource.
properties.alternateId string The alternate ID of the Asset.
properties.assetId string The Asset ID.
properties.container string The name of the asset blob container.
properties.created string The creation date of the Asset.
properties.description string The Asset description.
properties.lastModified string The last modified date of the Asset.
properties.storageAccountName string The name of the storage account.
properties.storageEncryptionFormat

AssetStorage

EncryptionFormat

 The Asset encryption format. One of None or MediaStorageEncryption.
systemData systemData The system metadata relating to this resource.
type string 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).
value Asset A collection of Asset items.

 

createdByType

The type of identity that created the resource.

Name Type
Application string
Key string
ManagedIdentity string
User string

 

ErrorAdditionalInfo

The resource management error additional info.

Name Type Description
info object The additional info.
type string The additional info type.

 

ErrorDetail

Name Type Description
additionalInfo ErrorAdditionalInfo The error additional info.
code string The error code.
details ErrorDetail The error details.
message string The error message.
target string The error target.

 

ErrorResponse

Name Type Description
error ErrorDetail The error object.

 

systemData

Metadata pertaining to creation and last modification of the resource.

Name Type Description
createdAt string The timestamp of resource creation (UTC).
createdBy string The identity that created the resource.
createdByType createdByType The type of identity that created the resource.
lastModifiedAt string The timestamp of resource last modification (UTC).
lastModifiedBy string The identity that last modified the resource.
lastModifiedByType createdByType The type of identity that last modified the resource.

Related to

Powered by Zendesk