Task
태스크는 자산에 대한 개별 업무이며 작업(Job)에 정의됩니다.
이 항목에서는 Task 엔터티에 대해 간략하게 설명하는 동시에 미디어 서비스 REST API를 사용하여 다양한 작업을 실행하는 방법도 보여 줍니다.
중요
Media Services에서 엔터티에 액세스할 때는 HTTP 요청에서 구체적인 헤더 필드와 값을 설정해야 합니다.
자세한 내용은 Media Services REST API 개발 설정 및 Media Services REST API를 사용하여 Media Services에 연결을 참조하세요.
Task 엔터티 속성
| 속성 | 형식 | 설명 |
|---|---|---|
Id읽기 전용입니다. 만들 때 Media Services에서 설정합니다. |
Edm.String | 고유 식별자입니다. |
Configuration선택 사항입니다. |
Edm.String | 인코딩, 보호 등과 같이 태스크가 수행하는 처리 작업을 정의하는 사전 설정입니다. 최대 길이는 100000입니다. |
EndTime읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.DateTime | 태스크가 완료, 실패 또는 취소된 datetime입니다. |
ErrorDetails읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Collection(ErrorDetail) | 태스크가 실행되는 동안 발생하는 오류를 설명하는 코드와 자세한 메시지의 컬렉션입니다. |
HistoricalEvents읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Collection(TaskHistoricalEvent) | 작업 실행과 관련된 이벤트를 설명하는 TaskHistoricalEvent 개체의 컬렉션입니다. |
MediaProcessorId필수 요소. |
Edm.String | 태스크에 사용될 MediaProcessor의 ID입니다. /API/MediaProcessors에서 GET 요청을 수행하면 유효한 값을 검색할 수 있습니다. |
Name선택 사항입니다. |
Edm.String | 선택 사항입니다. 태스크의 식별 이름입니다. 최대 길이는 4000입니다. |
PerfMessage읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.String | 태스크에 대한 성능 정보를 포함합니다. |
Priority선택 사항입니다. |
Edm.Int32 | 태스크의 우선 순위입니다. 값이 클수록 다른 태스크에 비해 우선 순위가 더 높습니다. . 예를 들어 우선 순위 = 40인 작업은 우선 순위 = 30인 작업 전에 처리됩니다. 상한은 MaxInt와 같습니다. |
Progress읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.Double | 0에서 100%를 나타내는 값입니다. |
RunningDuration읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.Double | 태스크의 경과 시간(초)입니다. |
StartTime읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.DateTime | 태스크가 시작된 datetime입니다. |
State읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.Int32 | 태스크의 상태입니다. 유효한 값은 다음과 같습니다. - 없음 = 0 - 활성 = 1 - 실행 = 2 - 완료됨 = 3 |
TaskBody필수 요소. |
Edm.String | 태스크를 다시 실행해야 하는 입력 및 출력 자산에 대한 정보를 포함하는 XML 문서입니다. 태스크에는 입력 자산과 출력 자산이 각각 1개 이상 있어야 합니다. XML 문서는 다음과 같은 형식입니다. <taskBody> <inputAsset> JobInputAsset(0)</inputAsset> <inputAsset> JobInputAsset(1)</inputAsset> <outputAsset assetCreationOptions=”1” assetName=”output” storageAccountName=”mystoreagename”> JobOutputAsset(0) </outputAsset> <taskBody><outputAsset> 요소에는 다음 특성이 있을 수 있습니다. - assetCreationOptions(또는 AssetCreationOptions). 이 특성에는 None=0x0, StorageEncrypted=0x1, CommonEncryptionProtected=0x2, EnvelopeEncryptionProtected=0x4 값 중 하나가 있을 수 있습니다. 기본값은 StorageEncrypted입니다. - assetName(또는 AssetName). 지정하지 않은 경우 Media Services는 작업 이름(또는 작업 이름이 비어 있는 경우 작업 ID)으로 접미사가 지정된 부모 outputAsset 요소 형식으로 이름을 설정합니다. - storageAccountName(또는 StorageAccountName). 출력 자산이 있게 될 저장소 계정의 이름입니다. 지정하지 않을 경우 사용자의 기본 저장소 계정이 사용됩니다. 태스크는 여러 태스크에 따라 달라질 수 있으며 여러 종속 태스크를 가질 수도 있습니다. 예를 들어 작업 A에 <작업 B에서 inputAsset로 <참조되는 outputAsset>>가 있는 경우 작업 B는 작업 A에 종속됩니다. 따라서 Media Services는 작업 B를 처리하기 전에 작업 A 처리를 완료해야 합니다. |
Options필수 요소. 생성 후 읽기 전용입니다. |
Edm.Int32 | 태스크를 만들 때 사용할 수 있는 암호화 옵션을 설명하는 열거형 값입니다. 유효한 값은 다음과 같습니다. - 없음 = 0 - ProtectedConfiguration = 1 |
EncryptionKeyId선택 사항입니다. |
Edm.String | 암호화 키 ID입니다. |
EncryptionScheme선택 사항입니다. |
Edm.String | 구성 파일에 사용되는 EncryptionScheme입니다. 유효한 값은 "ConfigurationEncryption"입니다. |
EncryptionVersion선택 사항입니다. |
Edm.String | 사용할 구성 암호화의 버전입니다. 현재 지원되는 버전은 "1.0"입니다. |
InitializationVector선택 사항입니다. |
Edm.String | 구성 파일의 InitializationVector입니다. 최대 길이는 4000입니다. |
OutputMediaAssets읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
자산 엔터티 집합 | ID 값으로 특정 태스크를 참조하여 액세스할 수 있는 탐색 속성입니다. 반환된 엔터티 집합에는 지정된 태스크에 연결된 모든 OutputMediaAsset 엔터티가 포함됩니다. |
InputMediaAssets읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
자산 엔터티 집합 | ID 값으로 특정 태스크를 참조하여 액세스할 수 있는 탐색 속성입니다. 반환된 엔터티 집합에는 지정된 태스크에 연결된 모든 InputMediaAsset 엔터티가 포함됩니다. |
TaskNotificationSubscriptions필수 요소. |
TaskNotificationSubscription 엔터티 집합 | 알림 엔드포인트 작업 상태 변경을 정의합니다. 또한 는 알림을 받을 작업 진행률을 포함할지 여부를 나타냅니다. |
태스크 만들기
태스크는 작업(Job)을 만들어 만듭니다. 예제는 Media Encoder Standard 사용하여 자산을 인코딩하는 방법을 참조하세요.
태스크 나열
작업은 GET HTTP 요청을 사용하여 검색됩니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/Tasks> | HTTP/1.1 |
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/Jobs>('jobid')/Tasks | HTTP/1.1 |
샘플 요청
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
GET https://<accountname>.restv2.<location>.media.azure.net/api/Jobs('nb:jid:UUID:b1f956b3-774c-bb44-a3f7-ee47e23add31')/Tasks 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
참고 항목
AccessPolicy
자산
ContentKey
작업
작업
JobTemplate
로케이터
MediaProcessor
TaskTemplate
할당량 및 제한 사항