153. (Aws/Amazon) [Aws Iot Core] Aws Iot Core Job 원격 작업 설정 업데이트 UpdateJob API 설명 정리

---

[개발 환경 설정]

​

개발 환경 : 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 UpdateJob 는 이미 존재하는 “job” (작업) 의 설정을 업데이트할 때 사용하는 API입니다

  >> AWS 사이트 : https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateJob.html


2. AWS IoT UpdateJob API 는 CreateJob 으로 만든 Job 에 대해 설정을 변경할 때 호출하는 API 입니다


3. AWS IoT UpdateJob API 요청 형식 및 주요 매개변수

  >> PATCH /jobs/jobId?namespaceId=namespaceId HTTP/1.1

  >> jobId : 업데이트하려는 작업의 고유 ID (최소 길이 1, 최대 64자, 허용 문자: [a-zA-Z0-9_-])

  >> namespaceId (선택): 네임스페이스 ID. 현재는 주로 AWS IoT Greengrass 환경에서 사용되는 옵션입니다

  >> 요청 본문 (JSON) : 

    - description : 작업에 대한 설명 (문자열) : 최대 길이 2028자

    - abortConfig : 실패 기준에 따라 Job 전체를 중단할 수 있는 조건들 설정

    - jobExecutionsRolloutConfig : Job이 대상 디바이스들에 배포되는 “롤아웃 방식(배포 속도)” 설정

    - presignedUrlConfig : 만약 Job이 S3에서 파일을 가져와야 하는 경우, presigned URL로 다운로드할 수 있도록 설정

    - timeoutConfig : 각 디바이스가 Job을 완료하기까지 허용되는 시간 설정


4. AWS IoT UpdateJob 응답 본문 예시 구문   

  >> HTTP/1.1 200 : 성공하면 HTTP 상태 코드 200을 반환하며, 본문은 비어 있습니다

  >> 에러 상황 : 

    - InvalidRequestException : 요청이 유효하지 않을 때 (예: 파라미터 형식/제약 위반) 

    - ResourceNotFoundException : 지정한 jobId가 존재하지 않을 때 

    - ServiceUnavailableException : 서비스가 일시적으로 사용 불가한 경우 

    - ThrottlingException : 요청 비율이 제한을 초과했을 때


5. AWS IoT UpdateJob 사용 주의할 점 / 제약점

  >> UpdateJob API 를 호출하려면, IAM 정책으로 iot:UpdateJob 권한이 필요합니다

  >> 롤아웃 설정이나 타임아웃, 중단(abort) 정책, S3 presigned URL 만료 시간 등은 Job 생성 후에도 유연하게 조정할 수 있기 때문에, 현실 운영 도중에 조건이 바뀔 경우 UpdateJob를 사용하는 것이 유용합니다

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






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

[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 개념 학습 및 펌웨어 업데이트 프로세

---