다음을 통해 공유


작업

장기 실행 작업의 현재 상태를 나타냅니다. Origin 시작 중, 중지 중 및 삭제 중과 같은 장기 실행 작업의 예입니다.

이 항목에서는 Operation 엔터티에 대해 간략하게 설명하는 동시에 미디어 서비스 REST API를 사용하여 다양한 작업을 실행하는 방법도 보여 줍니다.

중요

Media Services에서 엔터티에 액세스할 때는 HTTP 요청에서 구체적인 헤더 필드와 값을 설정해야 합니다.
자세한 내용은 Media Services REST API 개발 설정 및 Media Services REST API를 사용하여 Media Services에 연결을 참조하세요.

Operation 엔터티 속성

Property 형식 설명
Id

읽기 전용입니다.
문자열 작업을 만들 때 Media Services에서 할당한 작업 ID입니다. 형식:

nb:opid:UUID:<GUID>.
ErrorCode

읽기 전용입니다.
문자열 실패한 작업에 대한 오류 코드입니다. 가능한 오류 코드에 대한 자세한 내용은 작업 오류 코드를 참조하세요.
ErrorMessage

읽기 전용입니다.
문자열 실패한 작업에 대한 자세한 오류 메시지입니다.
State

읽기 전용입니다.
문자열 현재 상태입니다. 가능한 값은 다음과 같습니다.

- Succeeded입니다.
- 실패
- InProgress입니다.
TargetEntityId

읽기 전용입니다.
문자열 작업 대상의 ID입니다.

쿼리 작업

지정된 작업을 쿼리합니다.

메서드 요청 URI HTTP 버전
GET <https:// accountname.restv2>.<location.media.azure.net/api/Operations>('OperationId') HTTP/1.1

샘플 요청

최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.

GET api/Operations('nb:opid:UUID:ab66eff9-8945-4323-9f91-d257a695899b') HTTP/1.1  
MaxDataServiceVersion: 3.0;NetFx  
Content-Type: application/json;odata=minimalmetadata  
Accept: application/json;odata=minimalmetadata  
Authorization: Bearer <token value>  
x-ms-version: 2.19  
Host: <host URI>  
Content-Length: 0  
  

이 코드가 성공적으로 실행되면 다음 예제에서와 같이 응답 본문에 상태 메시지와 함께 200 정상 상태 코드가 반환됩니다.

샘플 응답

HTTP/1.1 200 OK  
Cache-Control: no-cache  
Content-Length: 280  
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8  
Server: Microsoft-IIS/7.5  
request-id: c3f3501a-8563-4cff-8aeb-66f68f9bdb8b  
x-ms-request-id: c3f3501a-8563-4cff-8aeb-66f68f9bdb8b  
X-Content-Type-Options: nosniff  
DataServiceVersion: 3.0;  
X-Powered-By: ASP.NET  
Date: Wed, 15 Jan 2014 19:31:13 GMT  
  
{"odata.metadata":"https://wamsbayclus001rest-hs.cloudapp.net/api/$metadata#Operations/@Element","Id":"nb:opid:UUID:ab66eff9-8945-4323-9f91-d257a695899b","State":"Succeeded","TargetEntityId":"nb:chid:UUID:1e518dbc-91ef-4044-a8bd-d20769dae833","ErrorCode":null,"ErrorMessage":null}  

작업 오류 코드

다음은 작업 오류 코드 목록입니다.

오류 코드 Description
BadRequest 다른 오류에 해당되지 않거나 정확한 오류를 알 수 없는 경우에 전송됩니다.
InsufficientCapacity 데이터 센터의 용량이 부족합니다.
InternalError 서비스에서 예기치 않은 오류가 발생했습니다.
InvalidIdentifierFormat 엔터티 ID 형식이 잘못되었습니다.
InvalidOperation 엔터티의 현재 상태에서 요청이 잘못되었습니다.
InvalidResourceName 지정된 Origin 이름이 잘못되었습니다.
OperationInProgress 지정된 엔터티에서 다른 작업이 이미 진행 중입니다.
OperationNotFound 지정된 작업 ID에 대한 작업 레코드를 찾을 수 없습니다. 시간 범위가 지나면 작업이 제거되었거나 ID가 잘못되었을 수 있습니다.
ResourceNameTaken 이미 사용 중인 이름을 사용하여 새 Origin을 만들려고 합니다.
ResourceNotFound 지정된 리소스를 찾을 수 없습니다.
ExceededResourceQuota 요청이 리소스 할당량 제한을 초과합니다.
제한 시간 비동기 작업 시간이 초과되었습니다.
DeleteNotAllowedOnDefaultOrigin 기본 Origin을 삭제하려고 했습니다.
SettingsUpdateInProgress 업데이트가 이미 진행 중입니다.