REST API 함수
다음 함수는 작업 취소, 보호 키 검색 등과 같은 다양한 작업을 수행하여 Microsoft Azure Media Services 엔터티를 지원합니다.
CancelJob. 형식의 jobid 매개 변수를 Edm.String 사용합니다.
GetProtectionKeyId. 형식의 contentKeyType 매개 변수를 Edm.Int32 사용합니다. Edm.String를 반환합니다.
GetProtectionKey. 형식의 protectionKeyId 매개 변수를 Edm.String 사용합니다. Edm.String를 반환합니다.
CreateFileInfos. 형식의 assetid 매개 변수를 Edm.String 사용합니다.
RebindContentKey. 형식 의 ID , 형식의 Edm.Stringx509Certificate 매개 변수를 Edm.String 사용합니다. Edm.String를 반환합니다.
Publish. 형식의 assetid 매개 변수를 Microsoft.Cloud.Media.Vod.Rest.Data.Models.Asset 사용합니다.
GetKeyDeliveryUrl. 형식의 contentKey , 형식의 Microsoft.Cloud.Media.Vod.Rest.Data.Models.ContentKeykeyDeliveryType 매개 변수를 Edm.String 사용합니다. Edm.Int32를 반환합니다.
Start. 형식의 streamingEndpoint 매개 변수를 Microsoft.Cloud.Media.Vod.Rest.Data.Models.StreamingEndpoint 사용합니다.
Start. 형식의 채널 매개 변수를 Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel 사용합니다.
Start. 형식의 프로그램 매개 변수를 Microsoft.Cloud.Media.Vod.Rest.Data.Models.Program 사용합니다.
Stop. 형식의 streamingEndpoint 매개 변수를 Microsoft.Cloud.Media.Vod.Rest.Data.Models.StreamingEndpoint 사용합니다.
Stop. 형식의 채널 매개 변수를 Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel 사용합니다.
Stop. 형식의 프로그램 매개 변수를 Microsoft.Cloud.Media.Vod.Rest.Data.Models.Program 사용합니다.
Scale. 형식의 streamingEndpoint , 형식의 Microsoft.Cloud.Media.Vod.Rest.Data.Models.StreamingEndpointscaleUnits 매개 변수를 Edm.String 사용합니다.
ShowSlate. 형식 채널,형식 기간, 형식의 Microsoft.Cloud.Media.Vod.Rest.Data.Models.ChannelEdm.TimeassetId 매개 변수를 Edm.String 사용합니다.
StartAdvertisement. 형식 채널,형식 기간, 형식의 Edm.TimeMicrosoft.Cloud.Media.Vod.Rest.Data.Models.ChannelcueId, showSlate 형식의 Edm.BooleanEdm.Int32 매개 변수를 사용합니다.
HideSlate. 형식의 채널 매개 변수를 Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel 사용합니다.
EndAdvertisement. 형식의 채널 , 형식의 Microsoft.Cloud.Media.Vod.Rest.Data.Models.ChannelcueId 매개 변수를 Edm.Int32 사용합니다.
Reset. 형식의 채널 매개 변수를 Microsoft.Cloud.Media.Vod.Rest.Data.Models.Channel 사용합니다.
중요
Media Services에서 엔터티에 액세스할 때는 HTTP 요청에서 구체적인 헤더 필드와 값을 설정해야 합니다.
자세한 내용은 Media Services REST API 개발 설정 및 Media Services REST API를 사용하여 Media Services에 연결을 참조하세요.
이 항목의 나머지 부분에서는 REST를 사용하여 함수를 호출하는 방법을 보여 주는 몇 가지 예제를 제공합니다.
CancelJob
CancelJob을 호출하여 현재 실행 중인 Job의 Job ID를 전달하면 실행 중인 Job을 취소할 수 있습니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/CancelJob?jobid>='URL-encodedvalue' | HTTP/1.1 |
샘플 요청
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
GET https://<accountname>.restv2.<location>.media.azure.net/api/CancelJob?jobid='nb%3ajid%3aUUID%3a9e9533ba-2b9b-fa4c-a33d-73eebd49039b' HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.19
Authorization: Bearer <token value>
Host: media.windows.net
CreateFileInfos
File 엔터티를 만들려면 CreateFileInfos 함수를 호출하여 Blob 저장소에 업로드한 미디어 파일과 연관된 Asset Id를 전달합니다. 자세한 내용은 Blob 저장소에 파일 업로드를 참조하세요.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/CreateFileInfos?assetid>='URL-encodedvalue' | HTTP/1.1 |
샘플 요청
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
GET https://<accountname>.restv2.<location>.media.azure.net/api/CreateFileInfos?assetid='nb%3Acid%3AUUID%3Ac80d312d-7cb1-44aa-bb23-2c35d10c44bd' HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.19
Authorization: Bearer <token value>
Host: media.windows.net
Content-Length: 0
GetProtectionKeyId
GetProtectionKeyId 함수는 사용자 정의된 콘텐츠 키를 암호화할 때 컴퓨터에 올바른 인증서가 설치되어 있음을 확인할 수 있는 X.509 인증서 지문을 검색합니다. contentKeyType 매개 변수로 사용할 수 있는 값은 ContentKey 엔터티의 ContentKeyType 열거 값에 매핑됩니다. 자세한 내용은 ContentKey 엔터티 속성을 참조하세요.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/GetProtectionKeyId?contentKeyType>=value | HTTP/1.1 |
샘플 요청
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
GET https://<accountname>.restv2.<location>.media.azure.net/api/GetProtectionKeyId?contentKeyType=1 HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.19
Authorization: Bearer <token value>
Host: media.windows.net
GetProtectionKey
GetProtectionKey는 사용자 정의된 콘텐츠 키를 암호화하는 데 사용해야 하는 특정 X.509 인증서를 검색합니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/GetProtectionKey?ProtectionKeyId>='value' | HTTP/1.1 |
샘플 요청
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
GET https://<accountname>.restv2.<location>.media.azure.net/api/GetProtectionKey?ProtectionKeyId='B2FE17BEF56FFCB9A3FC4267D0F2AFE25CD2DE22' HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.19
Authorization: Bearer <token value>
Host: media.windows.net
RebindContentKey
Media Services에서 암호화된 콘텐츠 키를 다시 검색하려면 RebindContentKey를 호출하고 Clear Storage 암호화/일반적인 보호 콘텐츠 키를 암호화하는 데 사용된 ContentKey ID 및 X.509 인증서(공개 키만 포함)를 전달합니다. RebindContentKey를 호출하여 x509Certificate 매개 변수에 빈 문자열을 전달하면 콘텐츠가 base64 인코딩되며 암호화되지 않은 상태로 반환됩니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/RebindContentKey?id>='contentkeyid'&x509Certificate='URL-encodedvalue' | HTTP/1.1 |
샘플 요청
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
GET https://<accountname>.restv2.<location>.media.azure.net/api/RebindContentKey?id='nb%3akid%3aUUID%3a2eeba14e-613e-4af7-a926-413372cca8d5'&x509Certificate='' HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.19
Authorization: Bearer <token value>
Host: media.windows.net