Skip to main content

Search

Ravnur Knowledge Base

Streaming locator - List

Alla Blinova
  • Updated

In this article:

URI Parameters
Responses
Examples
Definitions

List Streaming Locators
Lists the Streaming Locators in the account

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

With optional parameters:

GET https://{{api-endpoint}}/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingLocators?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 entities 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.

 

Responses

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

 

Examples

Lists Streaming Locators

Sample request

GET https://{{api-endpoint}}/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaServices/contosomedia/streamingLocators?api-version={{api-version}}

Sample response

Status code: 200

{
  "value": [
    {
      "name": "clearStreamingLocator",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/streamingLocators/clearStreamingLocator",
      "type": "Microsoft.Media/mediaservices/streamingLocators",
      "properties": {
        "assetName": "ClimbingMountRainier",
        "created": "2018-08-08T18:29:31.9341192Z",
        "endTime": "9999-12-31T23:59:59.9999999Z",
        "streamingLocatorId": "262a87b6-b538-4657-bac1-b6897924471d",
        "streamingPolicyName": "clearStreamingPolicy",
        "contentKeys": []
      }
    },
    {
      "name": "secureStreamingLocator",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/streamingLocators/secureStreamingLocator",
      "type": "Microsoft.Media/mediaservices/streamingLocators",
      "properties": {
        "assetName": "ClimbingMountRainier",
        "created": "2018-08-08T18:29:31.9544387Z",
        "endTime": "9999-12-31T23:59:59.9999999Z",
        "streamingLocatorId": "7338ef90-ffc8-42de-8bff-de8f99973300",
        "streamingPolicyName": "secureStreamingPolicy",
        "contentKeys": []
      }
    }
  ]
}

 

Definitions

Name Description
createdByType The type of identity that created the resource.
ErrorAdditionalInfo The resource management error additional info.
ErrorDetail The error detail.
ErrorResponse Error response.
StreamingLocator A Streaming Locator resource.
StreamingLocatorCollection A collection of StreamingLocator items.
StreamingLocatorContentKey Class for content key in Streaming Locator
StreamingLocatorContentKeyType Encryption type of Content Key.
systemData Metadata pertaining to creation and last modification of the resource.
TrackPropertyCompareOperation Track property condition operation.
TrackPropertyCondition Class to specify one track property condition.
TrackPropertyType Track property type.
TrackSelection Class to select a track.

 

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.

 

StreamingLocator

A Streaming Locator resource

Name Type Description
id string

Fully qualified resource ID for the resource. E.g. 

/subscriptions/{subscriptionId}/resource
Groups/{resourceGroupName}/providers/
{resourceProviderNamespace}/{resourceType}
/{resourceName}
name string The name of the resource.
properties.alternativeMediaId string Alternative Media ID of this Streaming Locator.
properties.assetName string Asset Name.
properties.contentKeys

StreamingLocator

ContentKey

 The ContentKeys used by this Streaming Locator.
properties.created string The creation time of the Streaming Locator.

properties.default

ContentKeyPolicyName

 string Name of the default ContentKeyPolicy used by this Streaming Locator.
properties.endTime string The end time of the Streaming Locator.
properties.filters string A list of asset or account filters which apply to this Streaming Locator.
properties.startTime string The start time of the Streaming Locator.
properties.streamingLocatorId string The StreamingLocatorId of the Streaming Locator.

properties.streaming

PolicyName

 string

Name of the Streaming Policy used by this Streaming Locator. Specify the name of your Streaming Policy or use one of the predefined policies, such as:

  • 'Predefined_DownloadOnly'
  • 'Predefined_ClearStreamingOnly'
  • 'Predefined_DownloadAndClearStreaming'
  • 'Predefined_ClearKey'
  • 'Predefined_MultiDrmCencStreaming'
  • 'Predefined_MultiDrmStreaming'
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".

 

StreamingLocatorCollection

A collection of StreamingLocator 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.
value StreamingLocator A collection of StreamingLocator items.

 

StreamingLocatorContentKey

Class for content key in Streaming Locator

Name Type Description
id string ID of the content key
labelReferenceInStreamingPolicy string Label of the content key as specified in the streaming policy
policyName string The ContentKeyPolicy used by the content key
tracks TrackSelection Tracks that use this content key
type StreamingLocatorContentKeyType Encryption type of the content key
value string Value of the content key

 

StreamingLocatorContentKeyType

Encryption type of Content Key

Name Type Description
CommonEncryptionCbcs string Common encryption using CBCS
CommonEncryptionCenc string Common encryption using CENC
EnvelopeEncryption string Envelope encryption

 

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.

 

TrackPropertyCompareOperation

Track property condition operation

Name Type Description
Equal string Equal operation
Unknown string Unknown track property compare operation

 

TrackPropertyCondition

Class to specify one track property condition

Name Type Description
operation TrackPropertyCompareOperation Track property condition operation
property TrackPropertyType Track property type
value string Track property value

 

TrackPropertyType

Track property type

Name Type Description
FourCC string Track FourCC
Unknown string Unknown track property

 

TrackSelection

Class to select a track

Name Type Description
trackSelections TrackPropertyCondition Track selections is a list of track property conditions that can specify track(s).
 

Related to

Powered by Zendesk