Task Notification & Query

고급 리소스 관리(Fmgr) 작업은 비동기적으로 실행됩니다. 플랫폼은 작업 완료 시 사전 알림 기능과 수동으로 작업 상태를 조회하는 기능을 모두 지원합니다.

작업 알림

1. 작업을 제출할 때 notifyURL을 지정하면, 시스템은 작업이 완료된 후 해당 주소로 자동으로 알림을 전송합니다.
2. 알림 요청에는 연결 타임아웃 20초, 요청 타임아웃 60초가 설정되어 있습니다.
3. 알림 내용은 안전한 Base64 형식으로 인코딩되어 전송됩니다. 데이터를 수신한 후 먼저 Base64로 디코딩한 다음, 결과 문자열을 JSON 형식으로 파싱해야 합니다.

알림 보안 메커니즘

CDNetworks 오브젝트 스토리지는 콜백 요청 헤더에 Authorization 필드를 포함합니다.

형식:

<Accesskey>:<Urlsafe_Base64_Encode(hmac_sha1(callBackUrlWithQuery+"\n"+urlsafe_base64_encode(callbackBody),SecretKey))>

예시:
d0e56f9f4a75267eba123348f839fbedcd9464c6:OTQzNzU5YWVjOTZlNTRlMWIwYmQzZTA2ZDhjMTFhOWEyNGM1ZjIzZg==

알림 재시도 메커니즘

• 업로드 콜백이 실패할 경우, 시스템은 즉시 3회 재시도 후, 이후 5회는 1분 간격으로 재시도를 진행하여 총 8회까지 시도합니다.
• 재시도 중 콜백이 성공하면 200 상태 코드가 반환됩니다.
• 모든 재시도가 실패하고 콜백 서버로부터 유효한 응답이 없으면 579 상태 코드가 반환됩니다.

알림 예시

POST www.test-notify.com
Authorization: f4880395bc1624277f0cf1ee2d6d332fbc1ef11b:NGEyMDVjMDc1NTlkNTE3NDRhMzI3YmFjMzdlOGQ5NzRjNWUyYmE1OQ==
content-length: 652
content-type: text/plain; charset=UTF-8
host: www.test-notify.com
connection: Keep-Alive
user-agent: Apache-HttpClient/4.5.12 (Java/1.8.0_242)
accept-encoding: gzip,deflate

eyJpZCI6IjIwMTA1NDY0NTQwZjE5NzQxNGQ1MWE4NjEyNDBkOTIxZWYyMDYiLCJjb2RlIjozLCJkZXNjIjoiZmlsZU9wZXJhdGVTdWNjZWVkIiwic2VwYXJhdGUiOjAsIml0ZW1zIjpbeyJjbWQiOiJyZXNvdXJjZS9kSEpoYm5OamIyUmxNVEExT25SbGMzUmZjM0pqWDJacGJHVmZNVFk1TVRrM09ESTFNVEUyTmk1dGNEUT0vYnVja2V0L2R5MTBjbUZ1YzJOdlpHVXRjbVZuYVc5dU1UQTEva2V5L2RHVnpkRjl6Y21OZlptbHNaVjh4TmpreE9UYzRNalV4TVRZMkxtMXdOQT09IiwiY29kZSI6MywiZGVzYyI6ImZpbGVPcGVyYXRlU3VjY2VlZCIsImVycm9yIjpudWxsLCJoYXNoIjoibGo2Tkg4Q0V1dUNLZDJmQm94ZTJGSmxybDVsVCIsImZzaXplIjo2NDM3ODM2LCJrZXkiOiJ0ZXN0X3NyY19maWxlXzE2OTE5NzgyNTExNjYubXA0IiwidXJsIjoiaHR0cDovL3ctdHJhbnNjb2RlLXJlZ2lvbjEwNS5jb20vdGVzdF9zcmNfZmlsZV8xNjkxOTc4MjUxMTY2Lm1wNCJ9XX0=

작업 조회

이 API는 고급 리소스 관리(Fmgr) 작업의 실행 상태를 조회하는 데 사용됩니다.

Note: Fmgr 작업이 notifyURL을 통해 수신하는 알림 콘텐츠의 형식은 이 인터페이스의 응답 내용 형식과 동일합니다.

요청 설명

GET /fmgr/status?persistentId=<persistentId>
HOST: <MgrDomain>

파라미터 설명

응답 설명

• 요청이 성공하면 아래와 같은 내용을 가진 Json 문자열을 반환합니다:

{
  "id": "<id string>",
  "code": <code int>,
  "desc": "<desc string>",
  "separate": "<separate string>",
  "items": [
    {
      "cmd": "<cmd string>",
      "code": "<code string>",
      "desc": "<desc string>",
      "error": "<error string>",
      "hash": "<hash string>",
      "fsize": "<fsize int>",
      "key": "<key string>",
      "url": "<url string>"
      "decompresslist": "<list string>"
    }
  ]
}

• 요청이 실패하면 아래와 같은 내용을 가진 Json 문자열을 반환합니다:

{
    "code":"<httpCode  int>", 
    "message":"<errMsg string>"
}

조회 예시

curl -v http://mgrDomain/fmgr/status?persistentId=ff80808149deceff014a7090b6700000