182. (Aws/Amazon) [Aws Iot Core] Jobs 현재 나에게 할당 된 원격 작업 목록 확인 토픽 설명 - $aws/things/thingName/jobs/get

---

[개발 환경 설정]

​

개발 환경 : Aws / Amazon Web Services

​

 

---

[설명 정리]

​

// --------------------------------------------------------------------------------------
[개발 및 환경]
// --------------------------------------------------------------------------------------

- 인프라 : Aws / Amazon Web Services


- 기술 구분 : Aws / Aws Iot Core / Job / OTA


- 사전) Aws Iot Core 간단 설명 : 

  >> AWS IoT 는 IoT 디바이스를 다른 디바이스 및 AWS 클라우드 서비스에 연결하는 클라우드 서비스를 제공합니다.

  >> 디바이스가에 연결할 수 있는 경우 AWS IoT는 AWS 가 제공하는 클라우드 서비스에 디바이스를 AWS IoT 연결할 수 있습니다.

  >> AWS IoT Core 메시지 브로커는 MQTT 및 MQTT over WSS 프로토콜을 사용하여 메시지를 게시하고 구독하는 디바이스 및 클라이언트를 지원합니다. 
  
    - HTTPS 프로토콜을 사용하여 메시지를 게시하는 디바이스와 클라이언트도 지원합니다.


- 사전) AWS Iot Core Job 간략 설명 : 

  >> AWS 원격 작업 이란 작업자 또는 기술자의 물리적 존재 없이 원격으로 수행할 수 있는 업데이트 작업입니다 (무선 업데이트 (OTA) 수행)

  >> AWS IoT 작업 서비스는 AWS IoT 에 연결 되는 하나 이상의 디바이스로 전송 된 후 실행 되는 원격 작업 세트를 정의하는데 사용됩니다

    - 주목적 : 소프트웨어 및 펌웨어 업데이트를 디바이스 기기에게 알리는데 사용 (기기에게 작업 문서 전송)

    - 작업 문서 : AWS IoT Job 생성 시 대상이 되는 디바이스로 전송 되는 문서 (펌웨어 다운로드 URL 정보 등 포함)

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[설 명] 
// --------------------------------------------------------------------------------------

1. AWS IoT Core 에서는 /jobs/get 토픽을 사용해 '현재 나에게 할당 된 원격 작업 목록' 을 확인할 수 있습니다

  >> Publish 요청 토픽 : $aws/things/<thingName>/jobs/get

  >> accepted 구독 토픽 (성공 응답) : $aws/things/<thingName>/jobs/get/accepted

  >> rejected 구독 토픽 (실패 응답) : $aws/things/<thingName>/jobs/get/rejected

  >> thingName 설명 참고 사항 : <thingName> 는 Aws Iot Core 에 등록 된 특정 ThingName 사물 명칭입니다

  >> /jobs/get 토픽을 구독 및 Publish 하기 위한 IAM / IoT 정책 권한 설정

    iot:Publish → $aws/things/<thingName>/jobs/get
    iot:Subscribe → $aws/things/<thingName>/jobs/get/accepted
    iot:Receive → $aws/things/<thingName>/jobs/get/accepted
    (오류 응답도 동일하게 추가 권한 필요)


2. /jobs/get 토픽 호출 시 AWS IoT Jobs 시스템에 '대기 중인 작업 목록', '진행 중인 작업 목록' 을 조회할 수 있습니다


3. ✅ /jobs/get 토픽 호출 후 accepted 응답 예시 : 
  
  >> 응답 JSON 샘플

  {
    "timestamp": 1770678156,
    "inProgressJobs": [      
      {
        "jobId": "TWOK_0000001_20260126_3",
        "queuedAt": 1769389000,
        "lastUpdatedAt": 1769389050,
        "executionNumber": 1,
        "versionNumber": 3
      }
    ],
    "queuedJobs": [      
      {
        "jobId": "TWOK_0000001_20260126_1",
        "queuedAt": 1769388196,
        "lastUpdatedAt": 1769388196,
        "executionNumber": 1,
        "versionNumber": 1
      },
      {
        "jobId": "TWOK_0000001_20260126_2",
        "queuedAt": 1769388607,
        "lastUpdatedAt": 1769388607,
        "executionNumber": 1,
        "versionNumber": 1
      }
    ]
  }

  >> ✅ Queued 상태의 JobExecution 목록을 초기화 방법

    - $aws/things/<thingName>/jobs/<jobId>/update 토픽에  { "status": "CANCELED" }  publish 수행 : JobExecution이 QUEUED → CANCELED 상태로 전환되어 /jobs/get 호출 시 더 이상 queuedJobs 리스트에 나타나지 않게 됩니다

    - Job 자체를 삭제 (delete-job) : Job 리소스 자체를 삭제하면 해당 Job과 관련된 모든 JobExecution이 함께 사라집니다

      ✔ 삭제 가능한 조건 : JobExecution 이 모두 terminal 상태(SUCCEEDED / FAILED / CANCELED / REJECTED / TIMED_OUT) 이어야 함



4. ✅ /jobs/get 토픽 호출 시 반환 되는 정보 정리 : 

  >> queuedJobs : 아직 실행되지 않은 작업 (QUEUED)

  >> inProgressJobs : 현재 디바이스에서 수행 중인 작업 (IN_PROGRESS)

  >> timestamp : 메시지 전송 시각

  >> clientToken : 요청 메시지와 상관관계 확인용


5. ✅ /jobs/get 토픽 사용 실제 시나리오 예시 정리 : 

  >> 부팅 직후 “할 일(Job)이 있는지” 확인할 때 : 기기가 켜졌을 때 대기 중 작업이 있는지 확인하기 위해 /jobs/get 요청을 보냄

  >> 주기적 폴링 방식으로 Jobs 상태를 확인할 때 : 디바이스가 일정 시간마다 Jobs 목록을 체크할 때 사용

  >> notify-next 를 놓친 경우 다시 상태 동기화할 때 : Jobs 시스템에서는 $aws/things/<thingName>/jobs/notify-next 를 통해 새 Job이 있을 때 푸시 알림을 줍니다. 하지만 네트워크 환경 상 응답을 놓치는 경우 → /jobs/get 을 호출하여 상태를 다시 맞출 수 있습니다.


6. 참고 정리 : Jobs 기능을 제대로 사용하기 위해 디바이스가 최소 구독 해야하는 설정

  $aws/things/<thingName>/jobs/get/accepted
  $aws/things/<thingName>/jobs/get/rejected
  $aws/things/<thingName>/jobs/notify-next
  $aws/things/<thingName>/jobs/+/update
  $aws/things/<thingName>/jobs/+/update/accepted
  $aws/things/<thingName>/jobs/+/update/rejected

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[참고 사이트]
// --------------------------------------------------------------------------------------

[Aws Iot Core] 원격 작업 무선 업데이트 (OTA) job 개념 학습 및 펌웨어 업데이트 프로세스 정리

https://kkh0977.tistory.com/8133

https://blog.naver.com/kkh0977/223926549194?trackingCode=blog_bloghome_searchlist


[Aws Iot Core] AWS 원격 펌웨어 업데이트 job 알림 수신 jobs/notify 토픽과 jobs/notify-next 토픽 차이점 정리

https://kkh0977.tistory.com/8178

https://blog.naver.com/kkh0977/223954213087?trackingCode=blog_bloghome_searchlist


[Aws Iot Core] AWS 펌웨어 업데이트 Job Execution Rollout 설정 값 snapshot 과 continuous 차이점 정리

https://blog.naver.com/kkh0977/223960153729?trackingCode=blog_bloghome_searchlist


[Aws Iot Core] AWS 원격 펌웨어 업데이트 OTA 수동 job 생성 및 특정 사물 notify 펌웨어 업데이트 요청 방법 정리

https://blog.naver.com/kkh0977/223944636139?trackingCode=blog_bloghome_searchlist

[안드로이드 AWS Iot Core 원격 업데이트 Job 리스트 목록 확인]

https://blog.naver.com/kkh0977/223926528254?trackingCode=blog_bloghome_searchlist


[업무 이슈] Aws Iot Core 에서 Job 원격 펌웨어 업데이트 요청 시 상태가 완료 로 처리 되지 않는 이슈 발생

https://blog.naver.com/kkh0977/223944640508?trackingCode=blog_bloghome_searchlist


[업무 이슈] AWS Job 디바이스 펌웨어 업데이트 파일 순차 업데이트 미동작 이슈 - IN_PROGRESS, QUEUED 배열 펌웨어 처리

https://blog.naver.com/kkh0977/223955019266?trackingCode=blog_bloghome_searchlist


[업무 이슈] AWS Job 디바이스 펌웨어 업데이트 시 동일 버전 펌웨어 버전 체크 및 업데이트 진행 미완료 표시 - publish status

https://blog.naver.com/kkh0977/223955010876?trackingCode=blog_bloghome_searchlist


[업무 이슈] 디바이스 Aws Job OTA 펌웨어 업데이트 시 STS 임시 자격 증명 S3 Presigned URL 프리 사인 주소 파싱 문제 발생

https://blog.naver.com/kkh0977/223951554000?trackingCode=blog_bloghome_searchlist

// --------------------------------------------------------------------------------------

 

---

[참고 사이트]

​

https://kkh0977.tistory.com/8133

83. (Aws/Amazon) [Aws Iot Core] 원격 작업 무선 업데이트 (OTA) job 개념 학습 및 펌웨어 업데이트 프로세

---