Streaming Locators - Get

Référence

Service:: Media Services

Version d'API:: 2022-08-01

Obtenir un localisateur de streaming
Obtenir les détails d’un localisateur de streaming dans le compte Media Services

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingLocators/{streamingLocatorName}?api-version=2022-08-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
accountName	path	True	string	Nom du compte Media Services.
resourceGroupName	path	True	string	Nom du groupe de ressources au sein de l’abonnement Azure.
streamingLocatorName	path	True	string	Nom du localisateur de streaming.
subscriptionId	path	True	string	Identificateur unique d’un abonnement Microsoft Azure.
api-version	query	True	string	Version de l’API à utiliser avec la demande cliente.

Réponses

Nom	Type	Description
200 OK	StreamingLocator	Ok
Other Status Codes	ErrorResponse	Informations détaillées sur les erreurs.

Exemples

Get a Streaming Locator by name

Exemple de requête

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaServices/contosomedia/streamingLocators/clearStreamingLocator?api-version=2022-08-01

/** Samples for StreamingLocators Get. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/streaming-locators-get-by-name.json
     */
    /**
     * Sample code: Get a Streaming Locator by name.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void getAStreamingLocatorByName(
        com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .streamingLocators()
            .getWithResponse("contosorg", "contosomedia", "clearStreamingLocator", 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

from azure.identity import DefaultAzureCredential
from azure.mgmt.media import AzureMediaServices

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-media
# USAGE
    python streaminglocatorsgetbyname.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.streaming_locators.get(
        resource_group_name="contoso",
        account_name="contosomedia",
        streaming_locator_name="clearStreamingLocator",
    )
    print(response)


# x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/streaming-locators-get-by-name.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

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/streaming-locators-get-by-name.json
func ExampleStreamingLocatorsClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armmediaservices.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewStreamingLocatorsClient().Get(ctx, "contoso", "contosomedia", "clearStreamingLocator", 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.StreamingLocator = armmediaservices.StreamingLocator{
	// 	Name: to.Ptr("clearStreamingLocator"),
	// 	Type: to.Ptr("Microsoft.Media/mediaservices/streamingLocators"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/streamingLocators/clearStreamingLocator"),
	// 	Properties: &armmediaservices.StreamingLocatorProperties{
	// 		AssetName: to.Ptr("ClimbingMountRainier"),
	// 		ContentKeys: []*armmediaservices.StreamingLocatorContentKey{
	// 		},
	// 		Created: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-08-08T18:29:32.115Z"); return t}()),
	// 		EndTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "9999-12-31T23:59:59.999Z"); return t}()),
	// 		StreamingLocatorID: to.Ptr("7684043b-f6d1-44a7-8bed-8a4aa474c5a4"),
	// 		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

const { AzureMediaServices } = require("@azure/arm-mediaservices");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Get the details of a Streaming Locator in the Media Services account
 *
 * @summary Get the details of a Streaming Locator in the Media Services account
 * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/streaming-locators-get-by-name.json
 */
async function getAStreamingLocatorByName() {
  const subscriptionId =
    process.env["MEDIASERVICES_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["MEDIASERVICES_RESOURCE_GROUP"] || "contoso";
  const accountName = "contosomedia";
  const streamingLocatorName = "clearStreamingLocator";
  const credential = new DefaultAzureCredential();
  const client = new AzureMediaServices(credential, subscriptionId);
  const result = await client.streamingLocators.get(
    resourceGroupName,
    accountName,
    streamingLocatorName
  );
  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

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/streaming-locators-get-by-name.json
// this example is just showing the usage of "StreamingLocators_Get" 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 StreamingLocatorResource created on azure
// for more information of creating StreamingLocatorResource, please refer to the document of StreamingLocatorResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "contoso";
string accountName = "contosomedia";
string streamingLocatorName = "clearStreamingLocator";
ResourceIdentifier streamingLocatorResourceId = StreamingLocatorResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName, streamingLocatorName);
StreamingLocatorResource streamingLocator = client.GetStreamingLocatorResource(streamingLocatorResourceId);

// invoke the operation
StreamingLocatorResource result = await streamingLocator.GetAsync();

// the variable result 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
StreamingLocatorData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Exemple de réponse

Code d’état:: 200

{
  "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:32.1154071Z",
    "endTime": "9999-12-31T23:59:59.9999999Z",
    "streamingLocatorId": "7684043b-f6d1-44a7-8bed-8a4aa474c5a4",
    "streamingPolicyName": "clearStreamingPolicy",
    "contentKeys": []
  }
}

Définitions

Nom	Description
createdByType	Type d’identité qui a créé la ressource.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
StreamingLocator	Une ressource De localisateur de streaming
StreamingLocatorContentKey	Classe pour la clé de contenu dans Le Localisateur de streaming
StreamingLocatorContentKeyType	Type de chiffrement de la clé de contenu
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
TrackPropertyCompareOperation	Suivi de l’opération de condition de propriété
TrackPropertyCondition	Classe pour spécifier une condition de propriété de suivi
TrackPropertyType	Type de propriété track
TrackSelection	Classe pour sélectionner une piste

createdByType

Type d’identité qui a créé la ressource.

Nom	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires
type	string	Type d’informations supplémentaires.

ErrorDetail

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d'erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

StreamingLocator

Une ressource De localisateur de streaming

Nom	Type	Description
id	string	ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	nom de la ressource.
properties.alternativeMediaId	string	AUTRE ID multimédia de ce localisateur de streaming
properties.assetName	string	Nom de la ressource
properties.contentKeys	StreamingLocatorContentKey[]	Les ContentKeys utilisées par ce localisateur de diffusion en continu.
properties.created	string	L’heure de création du localisateur de diffusion en continu.
properties.defaultContentKeyPolicyName	string	Nom de la valeur ContentKeyPolicy par défaut utilisée par ce localisateur de diffusion en continu.
properties.endTime	string	Heure de fin du localisateur de diffusion en continu.
properties.filters	string[]	Liste des filtres de ressources ou de comptes qui s’appliquent à ce localisateur de streaming
properties.startTime	string	Heure de début du localisateur de diffusion en continu.
properties.streamingLocatorId	string	ID du localisateur de diffusion en continu.
properties.streamingPolicyName	string	Nom de la stratégie de diffusion en continu utilisée par ce localisateur de diffusion en continu. Spécifiez le nom de la stratégie de streaming que vous avez créée ou utilisez l’une des stratégies de streaming prédéfinies. Les stratégies de streaming prédéfinies disponibles sont les suivantes : « Predefined_DownloadOnly », « Predefined_ClearStreamingOnly », « Predefined_DownloadAndClearStreaming », « Predefined_ClearKey », « Predefined_MultiDrmCencStreaming » et « Predefined_ MultiDrmStreaming ».
systemData	systemData	Métadonnées système relatives à cette ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

StreamingLocatorContentKey

Classe pour la clé de contenu dans Le Localisateur de streaming

Nom	Type	Description
id	string	ID de la clé de contenu
labelReferenceInStreamingPolicy	string	Étiquette de clé de contenu comme spécifié dans la stratégie de streaming
policyName	string	ContentKeyPolicy utilisé par la clé de contenu
tracks	TrackSelection[]	Suivis qui utilisent cette clé de contenu
type	StreamingLocatorContentKeyType	Type de chiffrement de la clé de contenu
value	string	Valeur de la clé de contenu

StreamingLocatorContentKeyType

Type de chiffrement de la clé de contenu

Nom	Type	Description
CommonEncryptionCbcs	string	Chiffrement courant à l’aide de CBCS
CommonEncryptionCenc	string	Chiffrement courant à l’aide de CENC
EnvelopeEncryption	string	Chiffrement d'enveloppe

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string	Horodatage de la dernière modification de la ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la dernière ressource.
lastModifiedByType	createdByType	Type d’identité qui a modifié la dernière ressource.

TrackPropertyCompareOperation

Suivi de l’opération de condition de propriété

Nom	Type	Description
Equal	string	Opération égale
Unknown	string	Opération de comparaison de propriétés de suivi inconnu

TrackPropertyCondition

Classe pour spécifier une condition de propriété de suivi

Nom	Type	Description
operation	TrackPropertyCompareOperation	Suivi de l’opération de condition de propriété
property	TrackPropertyType	Type de propriété track
value	string	Suivre la valeur de la propriété

TrackPropertyType

Type de propriété track

Nom	Type	Description
FourCC	string	Suivre fourCC
Unknown	string	Propriété de piste inconnue

TrackSelection

Classe pour sélectionner une piste

Nom	Type	Description
trackSelections	TrackPropertyCondition[]	TrackSelections est une liste de conditions de propriétés de suivi qui peut spécifier la ou les pistes