Task

아티클
08/05/2023

태스크는 자산에 대한 개별 업무이며 작업(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
할당량 및 제한 사항

Share via