Streaming Policies - List
스트리밍 정책 나열
계정에서 스트리밍 정책 Lists
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/streamingPolicies?api-version=2022-08-01GET 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 |
|---|---|---|---|---|
|
account
|
path | True |
string |
Media Services 계정 이름입니다. |
|
resource
|
path | True |
string |
Azure 구독 내 리소스 그룹의 이름입니다. |
|
subscription
|
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 |
정상 |
|
| Other Status Codes |
자세한 오류 정보입니다. |
예제
Lists Streaming Policies
Sample Request
Sample Response
{
"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 |
|---|---|
|
Cbcs |
스트리밍 정책에서 CommonEncryptionCbcs 체계의 DRM 구성을 지정하는 클래스 |
|
Cenc |
스트리밍 정책에서 CommonEncryptionCenc 스키마의 DRM 구성을 지정하는 클래스 |
|
Clear |
스트리밍 정책에서 일반적인 암호화 체계의 ClearKey 구성을 지정하는 클래스 |
|
Common |
CommonEncryptionCbcs 암호화 체계에 대한 클래스 |
|
Common |
봉투 암호화 체계에 대한 클래스 |
|
created |
리소스를 만든 ID의 형식입니다. |
|
Default |
각 암호화 체계에 대한 기본 콘텐츠 키의 속성을 지정하는 클래스 |
|
Enabled |
사용할 프로토콜을 지정하는 클래스 |
|
Envelope |
EnvelopeEncryption 암호화 체계에 대한 클래스 |
|
Error |
리소스 관리 오류 추가 정보입니다. |
|
Error |
오류 세부 정보입니다. |
|
Error |
오류 응답 |
|
No |
NoEncryption 스키마에 대한 클래스 |
|
Streaming |
스트리밍 정책 리소스 |
|
Streaming |
StreamingPolicy 항목의 컬렉션입니다. |
|
Streaming |
콘텐츠 키의 속성을 지정하는 클래스 |
|
Streaming |
스트리밍 정책에서 모든 콘텐츠 키의 속성을 지정하는 클래스 |
|
Streaming |
스트리밍 정책에서 FairPlay 구성을 지정하는 클래스 |
|
Streaming |
스트리밍 정책에서 PlayReady의 구성을 지정하는 클래스 |
|
Streaming |
스트리밍 정책에서 Widevine의 구성을 지정하는 클래스 |
|
system |
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다. |
|
Track |
속성 조건 작업 추적 |
|
Track |
하나의 트랙 속성 조건을 지정하는 클래스 |
|
Track |
추적 속성 유형 |
|
Track |
트랙을 선택하는 클래스 |
CbcsDrmConfiguration
스트리밍 정책에서 CommonEncryptionCbcs 체계의 DRM 구성을 지정하는 클래스
| Name | 형식 | Description |
|---|---|---|
| fairPlay |
FairPlay 구성 |
|
| playReady |
PlayReady 구성 |
|
| widevine |
Widevine 구성 |
CencDrmConfiguration
스트리밍 정책에서 CommonEncryptionCenc 스키마의 DRM 구성을 지정하는 클래스
| Name | 형식 | Description |
|---|---|---|
| playReady |
PlayReady 구성 |
|
| widevine |
Widevine 구성 |
ClearKeyEncryptionConfiguration
스트리밍 정책에서 일반적인 암호화 체계의 ClearKey 구성을 지정하는 클래스
| Name | 형식 | Description |
|---|---|---|
| customKeysAcquisitionUrlTemplate |
string |
최종 사용자 플레이어에게 콘텐츠 키를 제공하는 사용자 지정 서비스의 URL에 대한 템플릿입니다. 라이선스 발급에 Azure Media Services를 사용할 때는 필요하지 않습니다. 템플릿은 서비스가 런타임 시 요청별 값으로 업데이트할 교체 가능한 토큰을 지원합니다. 현재 지원되는 토큰 값은 {AlternativeMediaId}이며 StreamingLocatorId.AlternativeMediaId 값으로 바뀝니다. |
CommonEncryptionCbcs
CommonEncryptionCbcs 암호화 체계에 대한 클래스
| Name | 형식 | Description |
|---|---|---|
| clearKeyEncryptionConfiguration |
CommonEncryptionCbcs 암호화 체계에서 ClearKey를 지원하는 선택적 구성입니다. |
|
| clearTracks |
암호화하면 안 되는 트랙을 나타냅니다. |
|
| contentKeys |
각 암호화 체계에 대한 기본 콘텐츠 키 및 특정 트랙에 대한 별도의 콘텐츠 키 표시 |
|
| drm |
현재 암호화 체계에 대한 DRM 구성 |
|
| enabledProtocols |
지원되는 프로토콜 표시 |
CommonEncryptionCenc
봉투 암호화 체계에 대한 클래스
| Name | 형식 | Description |
|---|---|---|
| clearKeyEncryptionConfiguration |
CommonEncryptionCenc 암호화 체계에서 ClearKey를 지원하는 선택적 구성입니다. |
|
| clearTracks |
암호화하면 안 되는 트랙을 나타냅니다. |
|
| contentKeys |
각 암호화 체계에 대한 기본 콘텐츠 키 및 특정 트랙에 대한 별도의 콘텐츠 키 표시 |
|
| drm |
CommonEncryptionCenc 암호화 체계에 대한 DRM 구성 |
|
| 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 |
암호화하면 안 되는 트랙을 나타냅니다. |
|
| contentKeys |
각 암호화 체계에 대한 기본 콘텐츠 키 및 특정 트랙에 대한 별도의 콘텐츠 키 표시 |
|
| customKeyAcquisitionUrlTemplate |
string |
최종 사용자 플레이어에게 키를 제공하는 사용자 지정 서비스의 URL에 대한 템플릿입니다. 키를 발급하기 위해 Azure Media Services를 사용할 때는 필요하지 않습니다. 템플릿은 서비스가 런타임 시 요청별 값으로 업데이트할 교체 가능한 토큰을 지원합니다. 현재 지원되는 토큰 값은 StreamingLocatorId.AlternativeMediaId 값으로 대체되는 {AlternativeMediaId}와 요청되는 키의 식별자 값으로 대체되는 {ContentKeyId}입니다. |
| enabledProtocols |
지원되는 프로토콜 표시 |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| info |
object |
추가 정보입니다. |
| type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| additionalInfo |
오류 추가 정보입니다. |
|
| code |
string |
오류 코드입니다. |
| details |
오류 세부 정보입니다. |
|
| message |
string |
오류 메시지입니다. |
| target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
| Name | 형식 | Description |
|---|---|---|
| error |
Error 개체. |
NoEncryption
NoEncryption 스키마에 대한 클래스
| Name | 형식 | Description |
|---|---|---|
| enabledProtocols |
지원되는 프로토콜 표시 |
StreamingPolicy
스트리밍 정책 리소스
| Name | 형식 | Description |
|---|---|---|
| id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| name |
string |
리소스의 이름입니다. |
| properties.commonEncryptionCbcs |
CommonEncryptionCbcs 구성 |
|
| properties.commonEncryptionCenc |
CommonEncryptionCenc 구성 |
|
| properties.created |
string |
스트리밍 정책을 만든 시간 |
| properties.defaultContentKeyPolicyName |
string |
현재 스트리밍 정책에서 사용하는 기본 ContentKey |
| properties.envelopeEncryption |
EnvelopeEncryption 구성 |
|
| properties.noEncryption |
NoEncryption 구성 |
|
| systemData |
이 리소스와 관련된 시스템 메타데이터입니다. |
|
| type |
string |
리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
StreamingPolicyCollection
StreamingPolicy 항목의 컬렉션입니다.
| Name | 형식 | Description |
|---|---|---|
| @odata.nextLink |
string |
컬렉션의 다음 페이지에 대한 링크입니다(컬렉션에 하나의 응답으로 반환할 결과가 너무 많은 경우). |
| value |
StreamingPolicy 항목의 컬렉션입니다. |
StreamingPolicyContentKey
콘텐츠 키의 속성을 지정하는 클래스
| Name | 형식 | Description |
|---|---|---|
| label |
string |
레이블을 사용하여 스트리밍 로케이터를 만들 때 콘텐츠 키를 지정할 수 있습니다. |
| policyName |
string |
콘텐츠 키에서 사용하는 정책 |
| tracks |
이 콘텐츠 키를 사용하는 추적 |
StreamingPolicyContentKeys
스트리밍 정책에서 모든 콘텐츠 키의 속성을 지정하는 클래스
| Name | 형식 | Description |
|---|---|---|
| defaultKey |
암호화 체계에 대한 기본 콘텐츠 키 |
|
| keyToTrackMappings |
트랙을 나타내려면 별도의 콘텐츠 키가 필요합니다. |
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 |
리소스를 만든 ID의 형식입니다. |
|
| lastModifiedAt |
string |
리소스 마지막 수정의 타임스탬프(UTC) |
| lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
| lastModifiedByType |
리소스를 마지막으로 수정한 ID 유형입니다. |
TrackPropertyCompareOperation
속성 조건 작업 추적
| Name | 형식 | Description |
|---|---|---|
| Equal |
string |
같음 연산 |
| Unknown |
string |
알 수 없는 트랙 속성 비교 작업 |
TrackPropertyCondition
하나의 트랙 속성 조건을 지정하는 클래스
| Name | 형식 | Description |
|---|---|---|
| operation |
속성 조건 작업 추적 |
|
| property |
추적 속성 유형 |
|
| value |
string |
속성 값 추적 |
TrackPropertyType
추적 속성 유형
| Name | 형식 | Description |
|---|---|---|
| FourCC |
string |
FourCC 추적 |
| Unknown |
string |
알 수 없는 트랙 속성 |
TrackSelection
트랙을 선택하는 클래스
| Name | 형식 | Description |
|---|---|---|
| trackSelections |
TrackSelections는 track을 지정할 수 있는 트랙 속성 조건 목록입니다. |