Streaming Policies - Get

Tjänst:

Media Services

API-version:

2022-08-01

Hämta en strömningsprincip
Hämta information om en strömningsprincip i Media Services-kontot

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
accountName	path	True	string	Media Services-kontonamnet.
resourceGroupName	path	True	string	Namnet på resursgruppen i Azure-prenumerationen.
streamingPolicyName	path	True	string	Namnet på strömningsprincipen.
subscriptionId	path	True	string	Den unika identifieraren för en Microsoft Azure-prenumeration.
api-version	query	True	string	Den version av API:et som ska användas med klientbegäran.

Svar

Name	Typ	Description
200 OK	StreamingPolicy	OK
Other Status Codes	ErrorResponse	Detaljerad felinformation.

Exempel

Get a Streaming Policy by name

Exempelbegäran

HTTP

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

Java

/**
 * 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

Python

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

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/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

JavaScript

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

dotnet

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

Exempelsvar

Statuskod:

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
      }
    }
  }
}

Definitioner

Name	Description
CbcsDrmConfiguration	Klass för att ange DRM-konfigurationer för CommonEncryptionCbcs-schema i strömningsprincipen
CencDrmConfiguration	Klass för att ange DRM-konfigurationer för CommonEncryptionCenc-schema i direktuppspelningsprincip
ClearKeyEncryptionConfiguration	Klass för att ange ClearKey-konfiguration av vanliga krypteringsscheman i strömningsprincipen
CommonEncryptionCbcs	Klass för CommonEncryptionCbcs-krypteringsschema
CommonEncryptionCenc	Klass för kuvertkrypteringsschema
createdByType	Den typ av identitet som skapade resursen.
DefaultKey	Klass för att ange egenskaper för standardinnehållsnyckeln för varje krypteringsschema
EnabledProtocols	Klass för att ange vilka protokoll som är aktiverade
EnvelopeEncryption	Klass för Krypteringsschema för EnvelopeEncryption
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
NoEncryption	Klass för NoEncryption-schema
StreamingPolicy	En resurs för direktuppspelningsprincip
StreamingPolicyContentKey	Klass för att ange egenskaper för innehållsnyckeln
StreamingPolicyContentKeys	Klass för att ange egenskaper för alla innehållsnycklar i direktuppspelningsprincip
StreamingPolicyFairPlayConfiguration	Klass för att ange konfigurationer av FairPlay i direktuppspelningsprincip
StreamingPolicyPlayReadyConfiguration	Klass för att ange konfigurationer av PlayReady i direktuppspelningsprincip
StreamingPolicyWidevineConfiguration	Klass för att ange konfigurationer av Widevine i direktuppspelningsprincip
systemData	Metadata som rör skapande och senaste ändring av resursen.
TrackPropertyCompareOperation	Spåra egenskapsvillkorsåtgärd
TrackPropertyCondition	Klass för att ange ett egenskapsvillkor för spår
TrackPropertyType	Spåra egenskapstyp
TrackSelection	Klass för att välja ett spår

CbcsDrmConfiguration

Klass för att ange DRM-konfigurationer för CommonEncryptionCbcs-schema i strömningsprincipen

Name	Typ	Description
fairPlay	StreamingPolicyFairPlayConfiguration	FairPlay-konfigurationer
playReady	StreamingPolicyPlayReadyConfiguration	PlayReady-konfigurationer
widevine	StreamingPolicyWidevineConfiguration	Widevine-konfigurationer

CencDrmConfiguration

Klass för att ange DRM-konfigurationer för CommonEncryptionCenc-schema i direktuppspelningsprincip

Name	Typ	Description
playReady	StreamingPolicyPlayReadyConfiguration	PlayReady-konfigurationer
widevine	StreamingPolicyWidevineConfiguration	Widevine-konfigurationer

ClearKeyEncryptionConfiguration

Klass för att ange ClearKey-konfiguration av vanliga krypteringsscheman i strömningsprincipen

Name	Typ	Description
customKeysAcquisitionUrlTemplate	string	Mall för URL:en för den anpassade tjänsten som levererar innehållsnycklar till slutanvändarspelare. Krävs inte när du använder Azure Media Services för att utfärda licenser. Mallen stöder utbytbara token som tjänsten kommer att uppdatera vid körning med det värde som är specifikt för begäran. Tokenvärdet som stöds för närvarande är {AlternativeMediaId}, som ersätts med värdet StreamingLocatorId.AlternativeMediaId.

CommonEncryptionCbcs

Klass för CommonEncryptionCbcs-krypteringsschema

Name	Typ	Description
clearKeyEncryptionConfiguration	ClearKeyEncryptionConfiguration	Valfri konfiguration som stöder ClearKey i CommonEncryptionCbcs-krypteringsschema.
clearTracks	TrackSelection[]	Representerar vilka spår som inte ska krypteras
contentKeys	StreamingPolicyContentKeys	Representerar standardinnehållsnyckeln för varje krypteringsschema och separata innehållsnycklar för specifika spår
drm	CbcsDrmConfiguration	Konfiguration av DRM:er för aktuellt krypteringsschema
enabledProtocols	EnabledProtocols	Representerar protokoll som stöds

CommonEncryptionCenc

Klass för kuvertkrypteringsschema

Name	Typ	Description
clearKeyEncryptionConfiguration	ClearKeyEncryptionConfiguration	Valfri konfiguration som stöder ClearKey i CommonEncryptionCenc-krypteringsschema.
clearTracks	TrackSelection[]	Representerar vilka spår som inte ska krypteras
contentKeys	StreamingPolicyContentKeys	Representerar standardinnehållsnyckeln för varje krypteringsschema och separata innehållsnycklar för specifika spår
drm	CencDrmConfiguration	Konfiguration av DRM:er för CommonEncryptionCenc-krypteringsschema
enabledProtocols	EnabledProtocols	Representerar protokoll som stöds

createdByType

Den typ av identitet som skapade resursen.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DefaultKey

Klass för att ange egenskaper för standardinnehållsnyckeln för varje krypteringsschema

Name	Typ	Description
label	string	Etikett kan användas för att ange innehållsnyckel när du skapar en positionerare för direktuppspelning
policyName	string	Princip som används av standardnyckeln

EnabledProtocols

Klass för att ange vilka protokoll som är aktiverade

Name	Typ	Description
dash	boolean	Aktivera DASH-protokoll eller inte
download	boolean	Aktivera nedladdningsprotokoll eller inte
hls	boolean	Aktivera HLS-protokoll eller inte
smoothStreaming	boolean	Aktivera SmoothStreaming-protokollet eller inte

EnvelopeEncryption

Klass för Krypteringsschema för EnvelopeEncryption

Name	Typ	Description
clearTracks	TrackSelection[]	Representerar vilka spår som inte ska krypteras
contentKeys	StreamingPolicyContentKeys	Representerar standardinnehållsnyckeln för varje krypteringsschema och separata innehållsnycklar för specifika spår
customKeyAcquisitionUrlTemplate	string	Mall för URL:en för den anpassade tjänsten som levererar nycklar till slutanvändare. Krävs inte när du använder Azure Media Services för att utfärda nycklar. Mallen stöder utbytbara token som tjänsten kommer att uppdatera vid körning med det värde som är specifikt för begäran. De tokenvärden som stöds för närvarande är {AlternativeMediaId}, som ersätts med värdet StreamingLocatorId.AlternativeMediaId och {ContentKeyId}, som ersätts med värdet för identifieraren för nyckeln som begärs.
enabledProtocols	EnabledProtocols	Representerar protokoll som stöds

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Den ytterligare informationstypen.

ErrorDetail

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

NoEncryption

Klass för NoEncryption-schema

Name	Typ	Description
enabledProtocols	EnabledProtocols	Representerar protokoll som stöds

StreamingPolicy

En resurs för direktuppspelningsprincip

Name	Typ	Description
id	string	Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Namnet på resursen
properties.commonEncryptionCbcs	CommonEncryptionCbcs	Konfiguration av CommonEncryptionCbcs
properties.commonEncryptionCenc	CommonEncryptionCenc	Konfiguration av CommonEncryptionCenc
properties.created	string	Skapandetid för direktuppspelningsprincip
properties.defaultContentKeyPolicyName	string	Standardinnehållsnyckel som används av aktuell direktuppspelningsprincip
properties.envelopeEncryption	EnvelopeEncryption	Konfiguration av EnvelopeEncryption
properties.noEncryption	NoEncryption	Konfigurationer av NoEncryption
systemData	systemData	Systemmetadata som är relaterade till den här resursen.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

StreamingPolicyContentKey

Klass för att ange egenskaper för innehållsnyckeln

Name	Typ	Description
label	string	Etikett kan användas för att ange innehållsnyckel när du skapar en positionerare för direktuppspelning
policyName	string	Princip som används av innehållsnyckel
tracks	TrackSelection[]	Spårar vilka som använder den här innehållsnyckeln

StreamingPolicyContentKeys

Klass för att ange egenskaper för alla innehållsnycklar i direktuppspelningsprincip

Name	Typ	Description
defaultKey	DefaultKey	Standardinnehållsnyckel för ett krypteringsschema
keyToTrackMappings	StreamingPolicyContentKey[]	För att representera spår krävs en separat innehållsnyckel

StreamingPolicyFairPlayConfiguration

Klass för att ange konfigurationer av FairPlay i direktuppspelningsprincip

Name	Typ	Description
allowPersistentLicense	boolean	Alla licenser ska vara beständiga eller inte
customLicenseAcquisitionUrlTemplate	string	Mall för URL:en för den anpassade tjänsten som levererar licenser till slutanvändarspelare. Krävs inte när du använder Azure Media Services för att utfärda licenser. Mallen stöder utbytbara token som tjänsten kommer att uppdatera vid körning med det värde som är specifikt för begäran. De tokenvärden som stöds för närvarande är {AlternativeMediaId}, som ersätts med värdet StreamingLocatorId.AlternativeMediaId och {ContentKeyId}, som ersätts med värdet för identifieraren för nyckeln som begärs.

StreamingPolicyPlayReadyConfiguration

Klass för att ange konfigurationer av PlayReady i direktuppspelningsprincip

Name	Typ	Description
customLicenseAcquisitionUrlTemplate	string	Mall för URL:en för den anpassade tjänsten som levererar licenser till slutanvändarspelare. Krävs inte när du använder Azure Media Services för att utfärda licenser. Mallen stöder utbytbara token som tjänsten kommer att uppdatera vid körning med det värde som är specifikt för begäran. De tokenvärden som stöds för närvarande är {AlternativeMediaId}, som ersätts med värdet StreamingLocatorId.AlternativeMediaId och {ContentKeyId}, som ersätts med värdet för identifieraren för nyckeln som begärs.
playReadyCustomAttributes	string	Anpassade attribut för PlayReady

StreamingPolicyWidevineConfiguration

Klass för att ange konfigurationer av Widevine i direktuppspelningsprincip

Name	Typ	Description
customLicenseAcquisitionUrlTemplate	string	Mall för URL:en för den anpassade tjänsten som levererar licenser till slutanvändarspelare. Krävs inte när du använder Azure Media Services för att utfärda licenser. Mallen stöder utbytbara token som tjänsten kommer att uppdatera vid körning med det värde som är specifikt för begäran. De tokenvärden som stöds för närvarande är {AlternativeMediaId}, som ersätts med värdet StreamingLocatorId.AlternativeMediaId och {ContentKeyId}, som ersätts med värdet för identifieraren för nyckeln som begärs.

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

TrackPropertyCompareOperation

Spåra egenskapsvillkorsåtgärd

Name	Typ	Description
Equal	string	Lika med åtgärd
Unknown	string	Jämförelseåtgärd för okänd spårningsegenskap

TrackPropertyCondition

Klass för att ange ett egenskapsvillkor för spår

Name	Typ	Description
operation	TrackPropertyCompareOperation	Spåra egenskapsvillkorsåtgärd
property	TrackPropertyType	Spåra egenskapstyp
value	string	Spåra egenskapsvärde

TrackPropertyType

Spåra egenskapstyp

Name	Typ	Description
FourCC	string	Spåra FourCC
Unknown	string	Okänd spåregenskap

TrackSelection

Klass för att välja ett spår

Name	Typ	Description
trackSelections	TrackPropertyCondition[]	TrackSelections är en lista med villkor för spåregenskaper som kan ange spår