다음을 통해 공유

Streaming Policies - List

  • 참조
서비스:
Media Services
API 버전:
2022-08-01

스트리밍 정책 나열
계정에서 스트리밍 정책 Lists

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingPolicies?api-version=2022-08-01
선택적 매개 변수: 
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingPolicies?api-version=2022-08-01&$filter={$filter}&$top={$top}&$orderby={$orderby}

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
accountName
 path True

string

Media Services 계정 이름입니다.
resourceGroupName
 path True

string

Azure 구독 내 리소스 그룹의 이름입니다.
subscriptionId
 path True

string

Microsoft Azure 구독의 고유 식별자입니다.
api-version
 query True

string

클라이언트 요청과 함께 사용할 API의 버전입니다.
$filter
 query

string

반환된 항목 집합을 제한합니다.
$orderby
 query

string

결과 컬렉션을 정렬할 키를 지정합니다.
$top
 query

integer

int32

컬렉션에서 반환되는 항목 수를 제한하는 음수가 아닌 정수 n을 지정합니다. 서비스는 최대 사용 가능한 항목 수를 반환하지만 지정된 값 n보다 크지는 않습니다.

응답

Name 형식 Description
200 OK

StreamingPolicyCollection

정상
Other Status Codes

ErrorResponse

자세한 오류 정보입니다.

예제

Lists Streaming Policies

샘플 요청

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

샘플 응답

상태 코드:
200 
{
  "value": [
    {
      "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.676067Z",
        "noEncryption": {
          "enabledProtocols": {
            "download": true,
            "dash": true,
            "hls": true,
            "smoothStreaming": true
          }
        }
      }
    },
    {
      "name": "secureStreamingPolicy",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/streamingPolicies/secureStreamingPolicy",
      "type": "Microsoft.Media/mediaservices/streamingPolicies",
      "properties": {
        "created": "2018-08-08T18:29:30.6781134Z",
        "defaultContentKeyPolicyName": "PolicyWithMultipleOptions",
        "envelopeEncryption": {
          "enabledProtocols": {
            "download": false,
            "dash": true,
            "hls": true,
            "smoothStreaming": true
          },
          "clearTracks": [],
          "contentKeys": {
            "defaultKey": {
              "label": "aesDefaultKey"
            },
            "keyToTrackMappings": []
          },
          "customKeyAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/envelope/{ContentKeyId}"
        },
        "commonEncryptionCenc": {
          "enabledProtocols": {
            "download": false,
            "dash": true,
            "hls": false,
            "smoothStreaming": true
          },
          "clearTracks": [
            {
              "trackSelections": [
                {
                  "property": "FourCC",
                  "operation": "Unknown",
                  "value": "hev1"
                }
              ]
            }
          ],
          "contentKeys": {
            "defaultKey": {
              "label": "cencDefaultKey"
            },
            "keyToTrackMappings": []
          },
          "drm": {
            "playReady": {
              "customLicenseAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/playready/{ContentKeyId}",
              "playReadyCustomAttributes": "PlayReady CustomAttributes"
            },
            "widevine": {
              "customLicenseAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/widevine/{ContentKeyId"
            }
          }
        },
        "commonEncryptionCbcs": {
          "enabledProtocols": {
            "download": false,
            "dash": false,
            "hls": true,
            "smoothStreaming": false
          },
          "clearTracks": [],
          "contentKeys": {
            "defaultKey": {
              "label": "cbcsDefaultKey"
            },
            "keyToTrackMappings": []
          },
          "drm": {
            "fairPlay": {
              "customLicenseAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/fairplay/{ContentKeyId}",
              "allowPersistentLicense": true
            }
          }
        }
      }
    },
    {
      "name": "secureStreamingPolicyWithCommonEncryptionCbcsOnly",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/streamingPolicies/secureStreamingPolicyWithCommonEncryptionCbcsOnly",
      "type": "Microsoft.Media/mediaservices/streamingPolicies",
      "properties": {
        "created": "2018-08-08T18:29:30.6781134Z",
        "defaultContentKeyPolicyName": "PolicyWithMultipleOptions",
        "commonEncryptionCbcs": {
          "enabledProtocols": {
            "download": false,
            "dash": false,
            "hls": true,
            "smoothStreaming": false
          },
          "clearTracks": [],
          "contentKeys": {
            "defaultKey": {
              "label": "cbcsDefaultKey"
            },
            "keyToTrackMappings": []
          },
          "drm": {
            "fairPlay": {
              "customLicenseAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/fairplay/{ContentKeyId}",
              "allowPersistentLicense": true
            }
          }
        }
      }
    },
    {
      "name": "secureStreamingPolicyWithCommonEncryptionCencOnly",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/streamingPolicies/secureStreamingPolicyWithCommonEncryptionCencOnly",
      "type": "Microsoft.Media/mediaservices/streamingPolicies",
      "properties": {
        "created": "2018-08-08T18:29:30.6781134Z",
        "defaultContentKeyPolicyName": "PolicyWithMultipleOptions",
        "commonEncryptionCenc": {
          "enabledProtocols": {
            "download": false,
            "dash": true,
            "hls": false,
            "smoothStreaming": true
          },
          "clearTracks": [
            {
              "trackSelections": [
                {
                  "property": "FourCC",
                  "operation": "Unknown",
                  "value": "hev1"
                }
              ]
            }
          ],
          "contentKeys": {
            "defaultKey": {
              "label": "cencDefaultKey"
            },
            "keyToTrackMappings": []
          },
          "drm": {
            "playReady": {
              "customLicenseAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/playready/{ContentKeyId}",
              "playReadyCustomAttributes": "PlayReady CustomAttributes"
            },
            "widevine": {
              "customLicenseAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/widevine/{ContentKeyId"
            }
          }
        }
      }
    },
    {
      "name": "secureStreamingPolicyWithEnvelopeEncryptionOnly",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/streamingPolicies/secureStreamingPolicyWithEnvelopeEncryptionOnly",
      "type": "Microsoft.Media/mediaservices/streamingPolicies",
      "properties": {
        "created": "2018-08-08T18:29:30.6781134Z",
        "defaultContentKeyPolicyName": "PolicyWithClearKeyOptionAndTokenRestriction",
        "envelopeEncryption": {
          "enabledProtocols": {
            "download": false,
            "dash": true,
            "hls": true,
            "smoothStreaming": true
          },
          "clearTracks": [],
          "contentKeys": {
            "defaultKey": {
              "label": "aesDefaultKey"
            },
            "keyToTrackMappings": []
          },
          "customKeyAcquisitionUrlTemplate": "https://contoso.com/{AssetAlternativeId}/envelope/{ContentKeyId}"
        }
      }
    }
  ],
  "@odata.nextLink": "http://server/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaServices/contosomedia/streamingPolicies?api-version=2022-08-01&$skiptoken=secureStreamingPolicyWithEnvelopeEncryptionOnly"
}

정의

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

스트리밍 정책 리소스
StreamingPolicyCollection

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"

StreamingPolicyCollection

StreamingPolicy 항목의 컬렉션입니다.

Name 형식 Description
@odata.nextLink

string

컬렉션의 다음 페이지에 대한 링크입니다(컬렉션에 하나의 응답으로 반환할 결과가 너무 많은 경우).
value

StreamingPolicy[]

StreamingPolicy 항목의 컬렉션입니다.

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를 사용할 때는 필요하지 않습니다. 템플릿은 서비스가 런타임 시 요청별 값으로 업데이트할 교체 가능한 토큰을 지원합니다. 현재 지원되는 토큰 값은 {AlternativeMediaId}이며, 이 값은 StreamingLocatorId.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를 사용할 때는 필요하지 않습니다. 템플릿은 서비스가 런타임 시 요청별 값으로 업데이트할 교체 가능한 토큰을 지원합니다. 현재 지원되는 토큰 값은 {AlternativeMediaId}이며, 이 값은 StreamingLocatorId.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을 지정할 수 있는 트랙 속성 조건 목록입니다.