Streaming Policies - Get

서비스:

Media Services

API 버전:

2022-08-01

스트리밍 정책 가져오기
Media Services 계정에서 스트리밍 정책의 세부 정보 가져오기

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
accountName	path	True	string	Media Services 계정 이름입니다.
resourceGroupName	path	True	string	Azure 구독 내의 리소스 그룹 이름입니다.
streamingPolicyName	path	True	string	스트리밍 정책 이름입니다.
subscriptionId	path	True	string	Microsoft Azure 구독의 고유 식별자입니다.
api-version	query	True	string	클라이언트 요청과 함께 사용할 API의 버전입니다.

응답

Name	형식	Description
200 OK	StreamingPolicy	정상
Other Status Codes	ErrorResponse	자세한 오류 정보입니다.

예제

Get a Streaming Policy by name

샘플 요청

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

샘플 응답

상태 코드:

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

정의

Name	Description
CbcsDrmConfiguration	스트리밍 정책에서 CommonEncryptionCbcs 체계의 DRM 구성을 지정하는 클래스
CencDrmConfiguration	스트리밍 정책에서 CommonEncryptionCenc 스키마의 DRM 구성을 지정하는 클래스
ClearKeyEncryptionConfiguration	스트리밍 정책에서 일반적인 암호화 체계의 ClearKey 구성을 지정하는 클래스
CommonEncryptionCbcs	CommonEncryptionCbcs 암호화 체계에 대한 클래스
CommonEncryptionCenc	봉투 암호화 체계에 대한 클래스
createdByType	리소스를 만든 ID의 형식입니다.
DefaultKey	각 암호화 체계에 대한 기본 콘텐츠 키의 속성을 지정하는 클래스
EnabledProtocols	사용할 프로토콜을 지정하는 클래스
EnvelopeEncryption	EnvelopeEncryption 암호화 체계에 대한 클래스
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
NoEncryption	NoEncryption 스키마에 대한 클래스
StreamingPolicy	스트리밍 정책 리소스
StreamingPolicyContentKey	콘텐츠 키의 속성을 지정하는 클래스
StreamingPolicyContentKeys	스트리밍 정책에서 모든 콘텐츠 키의 속성을 지정하는 클래스
StreamingPolicyFairPlayConfiguration	스트리밍 정책에서 FairPlay의 구성을 지정하는 클래스
StreamingPolicyPlayReadyConfiguration	스트리밍 정책에서 PlayReady의 구성을 지정하는 클래스
StreamingPolicyWidevineConfiguration	스트리밍 정책에서 Widevine의 구성을 지정하는 클래스
systemData	리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.
TrackPropertyCompareOperation	속성 조건 작업 추적
TrackPropertyCondition	하나의 트랙 속성 조건을 지정하는 클래스
TrackPropertyType	추적 속성 유형
TrackSelection	트랙을 선택하는 클래스

CbcsDrmConfiguration

스트리밍 정책에서 CommonEncryptionCbcs 체계의 DRM 구성을 지정하는 클래스

Name	형식	Description
fairPlay	StreamingPolicyFairPlayConfiguration	FairPlay 구성
playReady	StreamingPolicyPlayReadyConfiguration	PlayReady 구성
widevine	StreamingPolicyWidevineConfiguration	Widevine 구성

CencDrmConfiguration

스트리밍 정책에서 CommonEncryptionCenc 스키마의 DRM 구성을 지정하는 클래스

Name	형식	Description
playReady	StreamingPolicyPlayReadyConfiguration	PlayReady 구성
widevine	StreamingPolicyWidevineConfiguration	Widevine 구성

ClearKeyEncryptionConfiguration

스트리밍 정책에서 일반적인 암호화 체계의 ClearKey 구성을 지정하는 클래스

Name	형식	Description
customKeysAcquisitionUrlTemplate	string	최종 사용자 플레이어에게 콘텐츠 키를 제공하는 사용자 지정 서비스의 URL에 대한 템플릿입니다. 라이선스 발급에 Azure Media Services를 사용할 때는 필요하지 않습니다. 템플릿은 서비스가 런타임 시 요청별 값으로 업데이트할 교체 가능한 토큰을 지원합니다. 현재 지원되는 토큰 값은 {AlternativeMediaId}이며 StreamingLocatorId.AlternativeMediaId 값으로 바뀝니다.

CommonEncryptionCbcs

CommonEncryptionCbcs 암호화 체계에 대한 클래스

Name	형식	Description
clearKeyEncryptionConfiguration	ClearKeyEncryptionConfiguration	CommonEncryptionCbcs 암호화 체계에서 ClearKey를 지원하는 선택적 구성입니다.
clearTracks	TrackSelection[]	암호화하면 안 되는 트랙을 나타냅니다.
contentKeys	StreamingPolicyContentKeys	각 암호화 체계에 대한 기본 콘텐츠 키 및 특정 트랙에 대한 별도의 콘텐츠 키 표시
drm	CbcsDrmConfiguration	현재 암호화 체계에 대한 DRM 구성
enabledProtocols	EnabledProtocols	지원되는 프로토콜 표시

CommonEncryptionCenc

봉투 암호화 체계에 대한 클래스

Name	형식	Description
clearKeyEncryptionConfiguration	ClearKeyEncryptionConfiguration	CommonEncryptionCenc 암호화 체계에서 ClearKey를 지원하는 선택적 구성입니다.
clearTracks	TrackSelection[]	암호화하면 안 되는 트랙을 나타냅니다.
contentKeys	StreamingPolicyContentKeys	각 암호화 체계에 대한 기본 콘텐츠 키 및 특정 트랙에 대한 별도의 콘텐츠 키 표시
drm	CencDrmConfiguration	CommonEncryptionCenc 암호화 체계에 대한 DRM 구성
enabledProtocols	EnabledProtocols	지원되는 프로토콜 표시

createdByType

리소스를 만든 ID의 형식입니다.

Name	형식	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DefaultKey

각 암호화 체계에 대한 기본 콘텐츠 키의 속성을 지정하는 클래스

Name	형식	Description
label	string	레이블을 사용하여 스트리밍 로케이터를 만들 때 콘텐츠 키를 지정할 수 있습니다.
policyName	string	기본 키에서 사용하는 정책

EnabledProtocols

사용할 프로토콜을 지정하는 클래스

Name	형식	Description
dash	boolean	DASH 프로토콜 사용 여부
download	boolean	다운로드 프로토콜 사용 여부
hls	boolean	HLS 프로토콜 사용 여부
smoothStreaming	boolean	SmoothStreaming 프로토콜 사용 여부

EnvelopeEncryption

EnvelopeEncryption 암호화 체계에 대한 클래스

Name	형식	Description
clearTracks	TrackSelection[]	암호화하면 안 되는 트랙을 나타냅니다.
contentKeys	StreamingPolicyContentKeys	각 암호화 체계에 대한 기본 콘텐츠 키 및 특정 트랙에 대한 별도의 콘텐츠 키 표시
customKeyAcquisitionUrlTemplate	string	최종 사용자 플레이어에게 키를 제공하는 사용자 지정 서비스의 URL에 대한 템플릿입니다. 키를 발급하기 위해 Azure Media Services를 사용할 때는 필요하지 않습니다. 템플릿은 서비스가 런타임 시 요청별 값으로 업데이트할 교체 가능한 토큰을 지원합니다. 현재 지원되는 토큰 값은 StreamingLocatorId.AlternativeMediaId 값으로 대체되는 {AlternativeMediaId}와 요청되는 키의 식별자 값으로 대체되는 {ContentKeyId}입니다.
enabledProtocols	EnabledProtocols	지원되는 프로토콜 표시

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

오류 응답

Name	형식	Description
error	ErrorDetail	Error 개체.

NoEncryption

NoEncryption 스키마에 대한 클래스

Name	형식	Description
enabledProtocols	EnabledProtocols	지원되는 프로토콜 표시

StreamingPolicy

스트리밍 정책 리소스

Name	형식	Description
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	리소스의 이름입니다.
properties.commonEncryptionCbcs	CommonEncryptionCbcs	CommonEncryptionCbcs 구성
properties.commonEncryptionCenc	CommonEncryptionCenc	CommonEncryptionCenc 구성
properties.created	string	스트리밍 정책을 만든 시간
properties.defaultContentKeyPolicyName	string	현재 스트리밍 정책에서 사용하는 기본 ContentKey
properties.envelopeEncryption	EnvelopeEncryption	EnvelopeEncryption 구성
properties.noEncryption	NoEncryption	NoEncryption 구성
systemData	systemData	이 리소스와 관련된 시스템 메타데이터입니다.
type	string	리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

StreamingPolicyContentKey

콘텐츠 키의 속성을 지정하는 클래스

Name	형식	Description
label	string	레이블을 사용하여 스트리밍 로케이터를 만들 때 콘텐츠 키를 지정할 수 있습니다.
policyName	string	콘텐츠 키에서 사용하는 정책
tracks	TrackSelection[]	이 콘텐츠 키를 사용하는 추적

StreamingPolicyContentKeys

스트리밍 정책에서 모든 콘텐츠 키의 속성을 지정하는 클래스

Name	형식	Description
defaultKey	DefaultKey	암호화 체계에 대한 기본 콘텐츠 키
keyToTrackMappings	StreamingPolicyContentKey[]	트랙을 나타내려면 별도의 콘텐츠 키가 필요합니다.

StreamingPolicyFairPlayConfiguration

스트리밍 정책에서 FairPlay의 구성을 지정하는 클래스

Name	형식	Description
allowPersistentLicense	boolean	모든 라이선스가 영구인지 여부
customLicenseAcquisitionUrlTemplate	string	최종 사용자 플레이어에게 라이선스를 제공하는 사용자 지정 서비스의 URL에 대한 템플릿입니다. 라이선스 발급에 Azure Media Services를 사용할 때는 필요하지 않습니다. 템플릿은 서비스가 런타임 시 요청별 값으로 업데이트할 교체 가능한 토큰을 지원합니다. 현재 지원되는 토큰 값은 StreamingLocatorId.AlternativeMediaId 값으로 대체되는 {AlternativeMediaId}와 요청되는 키의 식별자 값으로 대체되는 {ContentKeyId}입니다.

StreamingPolicyPlayReadyConfiguration

스트리밍 정책에서 PlayReady의 구성을 지정하는 클래스

Name	형식	Description
customLicenseAcquisitionUrlTemplate	string	최종 사용자 플레이어에게 라이선스를 제공하는 사용자 지정 서비스의 URL에 대한 템플릿입니다. 라이선스 발급에 Azure Media Services를 사용할 때는 필요하지 않습니다. 템플릿은 서비스가 런타임 시 요청별 값으로 업데이트할 교체 가능한 토큰을 지원합니다. 현재 지원되는 토큰 값은 StreamingLocatorId.AlternativeMediaId 값으로 대체되는 {AlternativeMediaId}와 요청되는 키의 식별자 값으로 대체되는 {ContentKeyId}입니다.
playReadyCustomAttributes	string	PlayReady에 대한 사용자 지정 특성

StreamingPolicyWidevineConfiguration

스트리밍 정책에서 Widevine의 구성을 지정하는 클래스

Name	형식	Description
customLicenseAcquisitionUrlTemplate	string	최종 사용자 플레이어에게 라이선스를 제공하는 사용자 지정 서비스의 URL에 대한 템플릿입니다. 라이선스 발급에 Azure Media Services를 사용할 때는 필요하지 않습니다. 템플릿은 서비스가 런타임 시 요청별 값으로 업데이트할 교체 가능한 토큰을 지원합니다. 현재 지원되는 토큰 값은 StreamingLocatorId.AlternativeMediaId 값으로 대체되는 {AlternativeMediaId}와 요청되는 키의 식별자 값으로 대체되는 {ContentKeyId}입니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string	UTC(리소스 만들기)의 타임스탬프입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID 유형입니다.

TrackPropertyCompareOperation

속성 조건 작업 추적

Name	형식	Description
Equal	string	같음 연산
Unknown	string	알 수 없는 추적 속성 비교 작업

TrackPropertyCondition

하나의 트랙 속성 조건을 지정하는 클래스

Name	형식	Description
operation	TrackPropertyCompareOperation	속성 조건 작업 추적
property	TrackPropertyType	추적 속성 유형
value	string	속성 값 추적

TrackPropertyType

추적 속성 유형

Name	형식	Description
FourCC	string	FourCC 추적
Unknown	string	알 수 없는 트랙 속성

TrackSelection

트랙을 선택하는 클래스

Name	형식	Description
trackSelections	TrackPropertyCondition[]	TrackSelections는 track을 지정할 수 있는 트랙 속성 조건 목록입니다.