작업

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

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

• Operation 엔터티 속성

• 쿼리 작업

• 작업 오류 코드

중요

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	업데이트가 이미 진행 중입니다.