Content Key Policies - Get
콘텐츠 키 정책 가져오기
Media Services 계정에서 콘텐츠 키 정책의 세부 정보 가져오기
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/contentKeyPolicies/{contentKeyPolicyName}?api-version=2022-08-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
account
|
path | True |
string |
Media Services 계정 이름입니다. |
content
|
path | True |
string |
콘텐츠 키 정책 이름입니다. |
resource
|
path | True |
string |
Azure 구독 내 리소스 그룹의 이름입니다. |
subscription
|
path | True |
string |
Microsoft Azure 구독의 고유 식별자입니다. |
api-version
|
query | True |
string |
클라이언트 요청과 함께 사용할 API의 버전입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
정상 |
|
Other Status Codes |
자세한 오류 정보입니다. |
예제
Get a Content Key Policy by name
Sample Request
Sample Response
{
"name": "PolicyWithMultipleOptions",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosorg/providers/Microsoft.Media/mediaservices/contosomedia/contentKeyPolicies/PolicyWithMultipleOptions",
"type": "Microsoft.Media/mediaservices/contentKeyPolicies",
"properties": {
"policyId": "ed7f3d1b-cfa7-4181-b966-e0b3027eec3a",
"created": "2015-12-01T00:00:00Z",
"lastModified": "2016-12-02T00:00:00Z",
"description": "A policy with multiple options.",
"options": [
{
"policyOptionId": "caf1e28c-8288-4301-8c46-c0f9312c512f",
"configuration": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicyClearKeyConfiguration"
},
"restriction": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicyTokenRestriction",
"issuer": "http://testacs",
"audience": "urn:test",
"primaryVerificationKey": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicySymmetricTokenKey",
"keyValue": ""
},
"alternateVerificationKeys": [],
"requiredClaims": [
{
"claimType": "urn:microsoft:azure:mediaservices:contentkeyidentifier"
},
{
"claimType": "DRM",
"claimValue": "Widevine"
}
],
"restrictionTokenType": "Jwt"
}
},
{
"policyOptionId": "da346259-0cd6-4609-89dc-15ac131bd92f",
"configuration": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicyWidevineConfiguration",
"widevineTemplate": "{\"allowed_track_types\":\"SD_HD\",\"content_key_specs\":[{\"track_type\":\"SD\",\"security_level\":1,\"required_output_protection\":{\"hdcp\":\"HDCP_V2\"}}],\"policy_overrides\":{\"can_play\":true,\"can_persist\":true,\"can_renew\":false}}"
},
"restriction": {
"@odata.type": "#Microsoft.Media.ContentKeyPolicyOpenRestriction"
}
}
]
}
}
정의
ContentKeyPolicy
콘텐츠 키 정책 리소스입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
리소스의 이름입니다. |
properties.created |
string |
정책을 만든 날짜입니다. |
properties.description |
string |
정책에 대한 설명입니다. |
properties.lastModified |
string |
정책을 마지막으로 수정한 날짜입니다. |
properties.options |
키 정책 옵션입니다. |
|
properties.policyId |
string |
레거시 정책 ID입니다. |
systemData |
이 리소스와 관련된 시스템 메타데이터입니다. |
|
type |
string |
리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
ContentKeyPolicyClearKeyConfiguration
DRM이 아닌 키에 대한 구성을 나타냅니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
ContentKeyPolicyFairPlayConfiguration
FairPlay 라이선스에 대한 구성을 지정합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
ask |
string |
FairPlay 애플리케이션 비밀 키로 사용해야 하는 키입니다. 이는 base64로 인코딩되어야 합니다. |
fairPlayPfx |
string |
PKCS 12(pfx) 형식(프라이빗 키 포함)으로 FairPlay 인증서의 Base64 표현입니다. |
fairPlayPfxPassword |
string |
PKCS 12(pfx) 형식의 FairPlay 인증서를 암호화하는 암호입니다. |
offlineRentalConfiguration |
오프라인 임대 정책 |
|
rentalAndLeaseKeyType |
임대 및 임대 키 유형입니다. |
|
rentalDuration |
integer |
대여 기간입니다. 0보다 크거나 같아야 합니다. |
ContentKeyPolicyFairPlayOfflineRentalConfiguration
Name | 형식 | Description |
---|---|---|
playbackDurationSeconds |
integer |
재생 기간 |
storageDurationSeconds |
integer |
스토리지 기간 |
ContentKeyPolicyFairPlayRentalAndLeaseKeyType
임대 및 임대 키 유형입니다.
Name | 형식 | Description |
---|---|---|
DualExpiry |
string |
오프라인 임대에 대한 이중 만료. |
PersistentLimited |
string |
콘텐츠 키를 유지할 수 있으며 유효한 기간은 임대 기간 값으로 제한됩니다. |
PersistentUnlimited |
string |
콘텐츠 키는 무제한으로 유지할 수 있습니다. |
Undefined |
string |
키 기간이 지정되지 않았습니다. |
Unknown |
string |
현재 API 버전에서 사용할 수 없는 ContentKeyPolicyFairPlayRentalAndLeaseKeyType을 나타냅니다. |
ContentKeyPolicyOpenRestriction
열린 제한을 나타냅니다. 라이선스 또는 키는 모든 요청에 따라 전달됩니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
ContentKeyPolicyOption
정책 옵션을 나타냅니다.
Name | 형식 | Description |
---|---|---|
configuration | ContentKeyPolicyConfiguration: |
키 배달 구성입니다. |
name |
string |
정책 옵션 설명입니다. |
policyOptionId |
string |
레거시 정책 옵션 ID입니다. |
restriction | ContentKeyPolicyRestriction: |
이 구성을 사용하여 키를 제공하기 위해 충족해야 하는 요구 사항 |
ContentKeyPolicyPlayReadyConfiguration
PlayReady 라이선스에 대한 구성을 지정합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
licenses |
PlayReady 라이선스. |
|
responseCustomData |
string |
사용자 지정 응답 데이터입니다. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromHeader
콘텐츠 키 ID가 PlayReady 헤더에 있는지 지정합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
ContentKeyPolicyPlayReadyContentEncryptionKeyFromKeyIdentifier
콘텐츠 키 ID가 PlayReady 구성에 지정되도록 지정합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
keyId |
string |
콘텐츠 키 ID입니다. |
ContentKeyPolicyPlayReadyContentType
PlayReady 콘텐츠 형식입니다.
Name | 형식 | Description |
---|---|---|
UltraVioletDownload |
string |
자외선 다운로드 콘텐츠 형식입니다. |
UltraVioletStreaming |
string |
자외선 스트리밍 콘텐츠 형식입니다. |
Unknown |
string |
현재 API 버전에서 사용할 수 없는 ContentKeyPolicyPlayReadyContentType을 나타냅니다. |
Unspecified |
string |
지정되지 않은 콘텐츠 형식입니다. |
ContentKeyPolicyPlayReadyExplicitAnalogTelevisionRestriction
명시적 아날로그 텔레비전 출력 제한 제어 비트를 구성합니다. 자세한 내용은 PlayReady 준수 규칙을 참조하세요.
Name | 형식 | Description |
---|---|---|
bestEffort |
boolean |
이 제한이 최선의 노력을 기준으로 적용되는지 여부를 나타냅니다. |
configurationData |
integer |
제한 컨트롤 비트를 구성합니다. 0에서 3 사이여야 합니다. |
ContentKeyPolicyPlayReadyLicense
PlayReady 라이선스
Name | 형식 | Description |
---|---|---|
allowTestDevices |
boolean |
테스트 디바이스에서 라이선스를 사용할 수 있는지 여부를 나타내는 플래그입니다. |
beginDate |
string |
라이선스 시작 날짜 |
contentKeyLocation | ContentKeyPolicyPlayReadyContentKeyLocation: |
콘텐츠 키 위치입니다. |
contentType |
PlayReady 콘텐츠 형식입니다. |
|
expirationDate |
string |
라이선스의 만료 날짜입니다. |
gracePeriod |
string |
라이선스의 유예 기간입니다. |
licenseType |
라이선스 유형입니다. |
|
playRight |
라이선스 PlayRight |
|
relativeBeginDate |
string |
라이선스의 상대 시작 날짜입니다. |
relativeExpirationDate |
string |
라이선스의 상대 만료 날짜입니다. |
securityLevel |
보안 수준입니다. |
ContentKeyPolicyPlayReadyLicenseType
라이선스 유형입니다.
Name | 형식 | Description |
---|---|---|
NonPersistent |
string |
비영구 라이선스. |
Persistent |
string |
영구 라이선스. 오프라인 재생을 허용합니다. |
Unknown |
string |
현재 API 버전에서 사용할 수 없는 ContentKeyPolicyPlayReadyLicenseType을 나타냅니다. |
ContentKeyPolicyPlayReadyPlayRight
PlayReady 라이선스에서 Play Right를 구성합니다.
Name | 형식 | Description |
---|---|---|
agcAndColorStripeRestriction |
integer |
라이선스에서 AGC(자동 게인 제어) 및 Color Stripe를 구성합니다. 0에서 3 사이여야 합니다. |
allowPassingVideoContentToUnknownOutput |
라이선스의 알 수 없는 출력 처리 설정을 구성합니다. |
|
analogVideoOpl |
integer |
압축된 디지털 오디오의 출력 보호 수준을 지정합니다. |
compressedDigitalAudioOpl |
integer |
압축된 디지털 오디오의 출력 보호 수준을 지정합니다. |
compressedDigitalVideoOpl |
integer |
압축된 디지털 비디오의 출력 보호 수준을 지정합니다. |
digitalVideoOnlyContentRestriction |
boolean |
라이선스에서 아날로그 구성 요소 비디오 제한에 대한 이미지 제약 조건을 사용하도록 설정합니다. |
explicitAnalogTelevisionOutputRestriction |
Content |
라이선스에 명시적 아날로그 텔레비전 출력 제한을 구성합니다. 구성 데이터는 0에서 3 사이여야 합니다. |
firstPlayExpiration |
string |
라이선스가 콘텐츠를 재생하는 데 처음 사용된 후 라이선스가 유효한 시간입니다. |
imageConstraintForAnalogComponentVideoRestriction |
boolean |
라이선스에서 아날로그 구성 요소 비디오 제한에 대한 이미지 제약 조건을 사용하도록 설정합니다. |
imageConstraintForAnalogComputerMonitorRestriction |
boolean |
라이선스에서 아날로그 구성 요소 비디오 제한에 대한 이미지 제약 조건을 사용하도록 설정합니다. |
scmsRestriction |
integer |
라이선스에서 SCMS(직렬 복사 관리 시스템)를 구성합니다. 0에서 3 사이여야 합니다. |
uncompressedDigitalAudioOpl |
integer |
압축되지 않은 디지털 오디오의 출력 보호 수준을 지정합니다. |
uncompressedDigitalVideoOpl |
integer |
압축되지 않은 디지털 비디오의 출력 보호 수준을 지정합니다. |
ContentKeyPolicyPlayReadyUnknownOutputPassingOption
라이선스의 알 수 없는 출력 처리 설정을 구성합니다.
Name | 형식 | Description |
---|---|---|
Allowed |
string |
보호된 콘텐츠의 비디오 부분을 알 수 없는 출력에 전달할 수 있습니다. |
AllowedWithVideoConstriction |
string |
보호된 콘텐츠의 비디오 부분을 알 수 없는 출력에 전달할 수 있지만 해상도가 제한됩니다. |
NotAllowed |
string |
보호된 콘텐츠의 비디오 부분을 알 수 없는 출력에 전달할 수 없습니다. |
Unknown |
string |
현재 API 버전에서 사용할 수 없는 ContentKeyPolicyPlayReadyUnknownOutputPassingOption을 나타냅니다. |
ContentKeyPolicyRestrictionTokenType
토큰의 형식입니다.
Name | 형식 | Description |
---|---|---|
Jwt |
string |
JSON 웹 토큰. |
Swt |
string |
단순 웹 토큰입니다. |
Unknown |
string |
현재 API 버전에서 사용할 수 없는 ContentKeyPolicyRestrictionTokenType을 나타냅니다. |
ContentKeyPolicyRsaTokenKey
토큰 유효성 검사에 대한 RSA 키를 지정합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
exponent |
string |
RSA 매개 변수 지수 |
modulus |
string |
RSA 매개 변수 모듈러스 |
ContentKeyPolicySymmetricTokenKey
토큰 유효성 검사를 위한 대칭 키를 지정합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
keyValue |
string |
키의 키 값 |
ContentKeyPolicyTokenClaim
토큰 클레임을 나타냅니다.
Name | 형식 | Description |
---|---|---|
claimType |
string |
토큰 클레임 유형입니다. |
claimValue |
string |
토큰 클레임 값입니다. |
ContentKeyPolicyTokenRestriction
토큰 제한을 나타냅니다. 제공된 토큰은 성공적인 라이선스 또는 키 배달을 위해 이러한 요구 사항과 일치해야 합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
alternateVerificationKeys | ContentKeyPolicyRestrictionTokenKey[]: |
대체 확인 키 목록입니다. |
audience |
string |
토큰의 대상 그룹입니다. |
issuer |
string |
토큰 발급자입니다. |
openIdConnectDiscoveryDocument |
string |
OpenID 연결 검색 문서입니다. |
primaryVerificationKey | ContentKeyPolicyRestrictionTokenKey: |
기본 확인 키입니다. |
requiredClaims |
필요한 토큰 클레임 목록입니다. |
|
restrictionTokenType |
토큰의 형식입니다. |
ContentKeyPolicyUnknownConfiguration
현재 API 버전에서 사용할 수 없는 ContentKeyPolicyConfiguration을 나타냅니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
ContentKeyPolicyUnknownRestriction
현재 API 버전에서 사용할 수 없는 ContentKeyPolicyRestriction을 나타냅니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
ContentKeyPolicyWidevineConfiguration
Widevine 라이선스에 대한 구성을 지정합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
widevineTemplate |
string |
Widevine 템플릿입니다. |
ContentKeyPolicyX509CertificateTokenKey
토큰 유효성 검사에 대한 인증서를 지정합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
rawBody |
string |
PKCS 12 형식의 인증서 원시 데이터 필드(.NET의 X509Certificate2) |
createdByType
리소스를 만든 ID의 형식입니다.
Name | 형식 | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
Error 개체. |
SecurityLevel
보안 수준입니다.
Name | 형식 | Description |
---|---|---|
SL150 |
string |
개발 또는 테스트 중인 클라이언트의 경우. 무단 사용에 대한 보호가 없습니다. |
SL2000 |
string |
상업용 콘텐츠를 소비하는 강화된 디바이스 및 애플리케이션의 경우 소프트웨어 또는 하드웨어 보호. |
SL3000 |
string |
강화된 디바이스에만 해당합니다. 하드웨어 보호. |
Unknown |
string |
현재 API 버전에서 사용할 수 없는 SecurityLevel을 나타냅니다. |
systemData
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.
Name | 형식 | Description |
---|---|---|
createdAt |
string |
UTC(리소스 만들기)의 타임스탬프입니다. |
createdBy |
string |
리소스를 만든 ID입니다. |
createdByType |
리소스를 만든 ID의 형식입니다. |
|
lastModifiedAt |
string |
리소스 마지막 수정의 타임스탬프(UTC) |
lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
lastModifiedByType |
리소스를 마지막으로 수정한 ID 유형입니다. |