Streaming Policies - Get

Riferimento

Service:: Media Services

API Version:: 2022-08-01

Ottenere un criterio di streaming
Ottenere i dettagli di un criterio di streaming nell'account servizi multimediali

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
accountName	path	True	string	Nome dell'account di Servizi multimediali.
resourceGroupName	path	True	string	Nome del gruppo di risorse all'interno della sottoscrizione di Azure.
streamingPolicyName	path	True	string	Nome criteri di streaming.
subscriptionId	path	True	string	Identificatore univoco per una sottoscrizione di Microsoft Azure.
api-version	query	True	string	Versione dell'API da usare con la richiesta client.

Risposte

Nome	Tipo	Descrizione
200 OK	StreamingPolicy	OK
Other Status Codes	ErrorResponse	Informazioni dettagliate sull'errore.

Esempio

Get a Streaming Policy by name

Sample Request

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

/** Samples for StreamingPolicies Get. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/streaming-policy-get-by-name.json
     */
    /**
     * Sample code: Get a Streaming Policy by name.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void getAStreamingPolicyByName(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .streamingPolicies()
            .getWithResponse("contosorg", "contosomedia", "clearStreamingPolicy", 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 streamingpolicygetbyname.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_policies.get(
        resource_group_name="contoso",
        account_name="contosomedia",
        streaming_policy_name="clearStreamingPolicy",
    )
    print(response)


# x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/streaming-policy-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-policy-get-by-name.json
func ExampleStreamingPoliciesClient_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.NewStreamingPoliciesClient().Get(ctx, "contoso", "contosomedia", "clearStreamingPolicy", 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.StreamingPolicy = armmediaservices.StreamingPolicy{
	// 	Name: to.Ptr("clearStreamingPolicy"),
	// 	Type: to.Ptr("Microsoft.Media/mediaservices/streamingPolicies"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contoso/providers/Microsoft.Media/mediaservices/contosomedia/streamingPolicies/clearStreamingPolicy"),
	// 	Properties: &armmediaservices.StreamingPolicyProperties{
	// 		Created: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-08-08T18:29:30.850Z"); return t}()),
	// 		NoEncryption: &armmediaservices.NoEncryption{
	// 			EnabledProtocols: &armmediaservices.EnabledProtocols{
	// 				Dash: to.Ptr(true),
	// 				Download: to.Ptr(true),
	// 				Hls: to.Ptr(true),
	// 				SmoothStreaming: to.Ptr(true),
	// 			},
	// 		},
	// 	},
	// }
}

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 Policy in the Media Services account
 *
 * @summary Get the details of a Streaming Policy in the Media Services account
 * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Metadata/stable/2022-08-01/examples/streaming-policy-get-by-name.json
 */
async function getAStreamingPolicyByName() {
  const subscriptionId =
    process.env["MEDIASERVICES_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["MEDIASERVICES_RESOURCE_GROUP"] || "contoso";
  const accountName = "contosomedia";
  const streamingPolicyName = "clearStreamingPolicy";
  const credential = new DefaultAzureCredential();
  const client = new AzureMediaServices(credential, subscriptionId);
  const result = await client.streamingPolicies.get(
    resourceGroupName,
    accountName,
    streamingPolicyName
  );
  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-policy-get-by-name.json
// this example is just showing the usage of "StreamingPolicies_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 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 StreamingPolicyResource
StreamingPolicyCollection collection = mediaServicesAccount.GetStreamingPolicies();

// invoke the operation
string streamingPolicyName = "clearStreamingPolicy";
bool result = await collection.ExistsAsync(streamingPolicyName);

Console.WriteLine($"Succeeded: {result}");

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

{
  "name": "clearStreamingPolicy",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/streamingPolicies/clearStreamingPolicy",
  "type": "Microsoft.Media/mediaservices/streamingPolicies",
  "properties": {
    "created": "2018-08-08T18:29:30.8501486Z",
    "noEncryption": {
      "enabledProtocols": {
        "download": true,
        "dash": true,
        "hls": true,
        "smoothStreaming": true
      }
    }
  }
}

Definizioni

Nome	Descrizione
CbcsDrmConfiguration	Classe per specificare configurazioni DRM dello schema CommonEncryptionCbcs in Criteri di streaming
CencDrmConfiguration	Classe per specificare configurazioni DRM dello schema CommonEncryptionCenc in Criteri di streaming
ClearKeyEncryptionConfiguration	Classe per specificare la configurazione ClearKey degli schemi di crittografia comuni nei criteri di streaming
CommonEncryptionCbcs	Classe per CommonEncryptionCbcs schema di crittografia
CommonEncryptionCenc	Classe per lo schema di crittografia busta
createdByType	Tipo di identità che ha creato la risorsa.
DefaultKey	Classe per specificare le proprietà della chiave di contenuto predefinita per ogni schema di crittografia
EnabledProtocols	Classe per specificare quali protocolli sono abilitati
EnvelopeEncryption	Classe per lo schema di crittografia EnvelopeEncryption
ErrorAdditionalInfo	Informazioni aggiuntive sulla gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
NoEncryption	Classe per lo schema NoEncryption
StreamingPolicy	Risorsa Criteri di streaming
StreamingPolicyContentKey	Classe per specificare le proprietà della chiave di contenuto
StreamingPolicyContentKeys	Classe per specificare le proprietà di tutte le chiavi di contenuto nei criteri di streaming
StreamingPolicyFairPlayConfiguration	Classe per specificare le configurazioni di FairPlay nei criteri di streaming
StreamingPolicyPlayReadyConfiguration	Classe per specificare le configurazioni di PlayReady nei criteri di streaming
StreamingPolicyWidevineConfiguration	Classe per specificare le configurazioni di Widevine nei criteri di streaming
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
TrackPropertyCompareOperation	Tenere traccia dell'operazione della condizione delle proprietà
TrackPropertyCondition	Classe per specificare una condizione di proprietà track
TrackPropertyType	Tipo di proprietà Track
TrackSelection	Classe per selezionare una traccia

CbcsDrmConfiguration

Classe per specificare configurazioni DRM dello schema CommonEncryptionCbcs in Criteri di streaming

Nome	Tipo	Descrizione
fairPlay	StreamingPolicyFairPlayConfiguration	Configurazioni FairPlay
playReady	StreamingPolicyPlayReadyConfiguration	Configurazioni playReady
widevine	StreamingPolicyWidevineConfiguration	Configurazioni Widevine

CencDrmConfiguration

Classe per specificare configurazioni DRM dello schema CommonEncryptionCenc in Criteri di streaming

Nome	Tipo	Descrizione
playReady	StreamingPolicyPlayReadyConfiguration	Configurazioni playReady
widevine	StreamingPolicyWidevineConfiguration	Configurazioni Widevine

ClearKeyEncryptionConfiguration

Classe per specificare la configurazione ClearKey degli schemi di crittografia comuni nei criteri di streaming

Nome	Tipo	Descrizione
customKeysAcquisitionUrlTemplate	string	Modello per l'URL del servizio personalizzato che fornisce chiavi di contenuto ai lettori utente finali. Non richiesto quando si usano Servizi multimediali di Azure per l'emissione di licenze. Il modello supporta i token sostituibili che il servizio aggiornerà in fase di esecuzione con il valore specifico della richiesta. Il valore del token attualmente supportato è {AlternativeMediaId}, sostituito con il valore di StreamingLocatorId.AlternativeMediaId.

CommonEncryptionCbcs

Classe per CommonEncryptionCbcs schema di crittografia

Nome	Tipo	Descrizione
clearKeyEncryptionConfiguration	ClearKeyEncryptionConfiguration	Configurazione facoltativa che supporta ClearKey nello schema di crittografia CommonEncryptionCbcs.
clearTracks	TrackSelection[]	Rappresentazione delle tracce che non devono essere crittografate
contentKeys	StreamingPolicyContentKeys	Rappresentazione della chiave di contenuto predefinita per ogni schema di crittografia e chiavi di contenuto separate per tracce specifiche
drm	CbcsDrmConfiguration	Configurazione delle macchine di ripristino di emergenza per lo schema di crittografia corrente
enabledProtocols	EnabledProtocols	Rappresentazione dei protocolli supportati

CommonEncryptionCenc

Classe per lo schema di crittografia busta

Nome	Tipo	Descrizione
clearKeyEncryptionConfiguration	ClearKeyEncryptionConfiguration	Configurazione facoltativa che supporta ClearKey nello schema di crittografia CommonEncryptionCenc.
clearTracks	TrackSelection[]	Rappresentazione delle tracce che non devono essere crittografate
contentKeys	StreamingPolicyContentKeys	Rappresentazione della chiave di contenuto predefinita per ogni schema di crittografia e chiavi di contenuto separate per tracce specifiche
drm	CencDrmConfiguration	Configurazione delle macchine di ripristino di emergenza per lo schema di crittografia CommonEncryptionCenc
enabledProtocols	EnabledProtocols	Rappresentazione dei protocolli supportati

createdByType

Tipo di identità che ha creato la risorsa.

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

DefaultKey

Classe per specificare le proprietà della chiave di contenuto predefinita per ogni schema di crittografia

Nome	Tipo	Descrizione
label	string	L'etichetta può essere usata per specificare la chiave di contenuto durante la creazione di un localizzatore di streaming
policyName	string	Criteri usati dalla chiave predefinita

EnabledProtocols

Classe per specificare quali protocolli sono abilitati

Nome	Tipo	Descrizione
dash	boolean	Abilitare il protocollo DASH o meno
download	boolean	Abilitare il protocollo di download o meno
hls	boolean	Abilitare il protocollo HLS o meno
smoothStreaming	boolean	Abilitare il protocollo SmoothStreaming o meno

EnvelopeEncryption

Classe per lo schema di crittografia EnvelopeEncryption

Nome	Tipo	Descrizione
clearTracks	TrackSelection[]	Rappresentazione delle tracce che non devono essere crittografate
contentKeys	StreamingPolicyContentKeys	Rappresentazione della chiave di contenuto predefinita per ogni schema di crittografia e chiavi di contenuto separate per tracce specifiche
customKeyAcquisitionUrlTemplate	string	Modello per l'URL del servizio personalizzato che fornisce chiavi ai giocatori finali. Non richiesto quando si usano Servizi multimediali di Azure per l'emissione di chiavi. Il modello supporta i token sostituibili che il servizio aggiornerà in fase di esecuzione con il valore specifico della richiesta. I valori del token attualmente supportati sono {AlternativeMediaId}, che viene sostituito con il valore di StreamingLocatorId.AlternativeMediaId e {ContentKeyId}, che viene sostituito con il valore dell'identificatore della chiave richiesta.
enabledProtocols	EnabledProtocols	Rappresentazione dei protocolli supportati

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

NoEncryption

Classe per lo schema NoEncryption

Nome	Tipo	Descrizione
enabledProtocols	EnabledProtocols	Rappresentazione dei protocolli supportati

StreamingPolicy

Risorsa Criteri di streaming

Nome	Tipo	Descrizione
id	string	ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	nome della risorsa.
properties.commonEncryptionCbcs	CommonEncryptionCbcs	Configurazione di CommonEncryptionCbcs
properties.commonEncryptionCenc	CommonEncryptionCenc	Configurazione di CommonEncryptionCenc
properties.created	string	Ora di creazione dei criteri di streaming
properties.defaultContentKeyPolicyName	string	ContentKey predefinita usata dai criteri di streaming correnti
properties.envelopeEncryption	EnvelopeEncryption	Configurazione di EnvelopeEncryption
properties.noEncryption	NoEncryption	Configurazione di NoEncryption
systemData	systemData	Metadati di sistema relativi a questa risorsa.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

StreamingPolicyContentKey

Classe per specificare le proprietà della chiave di contenuto

Nome	Tipo	Descrizione
label	string	L'etichetta può essere usata per specificare la chiave di contenuto durante la creazione di un localizzatore di streaming
policyName	string	Criteri usati da Content Key
tracks	TrackSelection[]	Tiene traccia che usano questa chiave di contenuto

StreamingPolicyContentKeys

Classe per specificare le proprietà di tutte le chiavi di contenuto nei criteri di streaming

Nome	Tipo	Descrizione
defaultKey	DefaultKey	Chiave di contenuto predefinita per uno schema di crittografia
keyToTrackMappings	StreamingPolicyContentKey[]	Rappresentazione delle tracce richiede una chiave di contenuto separata

StreamingPolicyFairPlayConfiguration

Classe per specificare le configurazioni di FairPlay nei criteri di streaming

Nome	Tipo	Descrizione
allowPersistentLicense	boolean	Tutte le licenze da mantenere o meno
customLicenseAcquisitionUrlTemplate	string	Modello per l'URL del servizio personalizzato che fornisce licenze ai giocatori dell'utente finale. Non richiesto quando si usano Servizi multimediali di Azure per l'emissione di licenze. Il modello supporta i token sostituibili che il servizio aggiornerà in fase di esecuzione con il valore specifico della richiesta. I valori del token attualmente supportati sono {AlternativeMediaId}, che viene sostituito con il valore di StreamingLocatorId.AlternativeMediaId e {ContentKeyId}, che viene sostituito con il valore dell'identificatore della chiave richiesta.

StreamingPolicyPlayReadyConfiguration

Classe per specificare le configurazioni di PlayReady nei criteri di streaming

Nome	Tipo	Descrizione
customLicenseAcquisitionUrlTemplate	string	Modello per l'URL del servizio personalizzato che fornisce licenze ai giocatori dell'utente finale. Non richiesto quando si usano Servizi multimediali di Azure per l'emissione di licenze. Il modello supporta i token sostituibili che il servizio aggiornerà in fase di esecuzione con il valore specifico della richiesta. I valori del token attualmente supportati sono {AlternativeMediaId}, che viene sostituito con il valore di StreamingLocatorId.AlternativeMediaId e {ContentKeyId}, che viene sostituito con il valore dell'identificatore della chiave richiesta.
playReadyCustomAttributes	string	Attributi personalizzati per PlayReady

StreamingPolicyWidevineConfiguration

Classe per specificare le configurazioni di Widevine nei criteri di streaming

Nome	Tipo	Descrizione
customLicenseAcquisitionUrlTemplate	string	Modello per l'URL del servizio personalizzato che fornisce licenze ai giocatori dell'utente finale. Non richiesto quando si usano Servizi multimediali di Azure per l'emissione di licenze. Il modello supporta i token sostituibili che il servizio aggiornerà in fase di esecuzione con il valore specifico della richiesta. I valori del token attualmente supportati sono {AlternativeMediaId}, che viene sostituito con il valore di StreamingLocatorId.AlternativeMediaId e {ContentKeyId}, che viene sostituito con il valore dell'identificatore della chiave richiesta.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string	Timestamp della creazione di risorse (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima risorsa.

TrackPropertyCompareOperation

Tenere traccia dell'operazione della condizione delle proprietà

Nome	Tipo	Descrizione
Equal	string	Operazione uguale
Unknown	string	Operazione di confronto delle proprietà di traccia sconosciuta

TrackPropertyCondition

Classe per specificare una condizione di proprietà track

Nome	Tipo	Descrizione
operation	TrackPropertyCompareOperation	Tenere traccia dell'operazione della condizione delle proprietà
property	TrackPropertyType	Tipo di proprietà Track
value	string	Tenere traccia del valore della proprietà

TrackPropertyType

Tipo di proprietà Track

Nome	Tipo	Descrizione
FourCC	string	Tenere traccia di FourCC
Unknown	string	Proprietà track sconosciuta

TrackSelection

Classe per selezionare una traccia

Nome	Tipo	Descrizione
trackSelections	TrackPropertyCondition[]	TrackSelections è un elenco di condizioni di proprietà di traccia che può specificare tracce