161. (Aws/Amazon) [Aws Iot Core] Aws Iot Core Thing 사물 에 대한 정보 업데이트 UpdateThing API 설명 정리

---

[개발 환경 설정]

​

개발 환경 : Aws / Amazon Web Services

​

 

---

[설명 정리]

 

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

- 인프라 : Aws / Amazon Web Services


- 기술 구분 : Aws / Aws Iot Core / Thing


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

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

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

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

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






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

1. AWS IoT UpdateThing 는 AWS IoT 레지스트리에 등록된 하나의 Thing (사물) 에 대한 정보를 업데이트 하는데 사용되는 API 입니다

  >> ✅ Thing 의 속성(Attribute) 수정

  >> ✅ Thing 의 ThingType 연결 추가/제거

  >> ❌ Thing 이름 변경 불가


2. AWS IoT UpdateThing 는 Thing 의 속성(attributes) 또는 사물 유형(thing type) 연결 상태 등을 수정할 수 있지만, 사물 이름 자체는 변경할 수 없습니다


3. AWS IoT UpdateThing API 호출 Request , Response 전문 예시 : 

    // ✅ Request 전문 예시
    PATCH /things/thingName HTTP/1.1 // ---------> {thingName}은 수정하려는 Thing의 이름입니다
    Content-type: application/json

    {
    "attributePayload": { 
        "attributes": { // -----------> attributes: 수정하거나 새로 추가할 속성(키/값 쌍)을 지정합니다
            "string" : "string" 
        },
        "merge": boolean // ----------> merge: 기존 속성과 병합할지 여부입니다 (true: 기존 속성과 병합 / false: 기존 속성을 덮어쓰기)
    },
    "expectedVersion": number, // --------> expectedVersion: Thing 데이터의 예상 버전입니다
    "removeThingType": boolean, // -------> removeThingType: Thing에 연결된 Thing Type의 연결을 제거하려면 true로 설정합니다
    "thingTypeName": "string" // ---------> thingTypeName: Thing이 속한 Thing Type 이름을 지정할 수 있습니다
    }


    // ✅ Response 전문 예시
    HTTP/1.1 200

    응답 바디는 비어 있습니다. 업데이트 결과는 별도로 DescribeThing을 호출하여 확인합니다.


4. AWS IoT UpdateThing 호출 오류 종류 : 

  >> InvalidRequestException : 요청 형식 또는 내용이 유효하지 않음

  >> ResourceNotFoundException : 지정한 Thing이 존재하지 않음

  >> VersionConflictException : expectedVersion과 서버 버전 불일치

  >> UnauthorizedException : 권한 없음

  >> ThrottlingException : 요청 한도 초과

  >> InternalFailureException : 서비스 내부 오류

  >> ServiceUnavailableException : 서비스가 일시적으로 사용 불가

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






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

[MQTT (Message Queueing Telemetry Transport) 통신 설명]

https://kkh0977.tistory.com/3631

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


[투케이 학습] : AWS IoT Shadow (섀도우) 개념 학습

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


[자바스크립트 AWS Iot Core 특정 Thing 사물에 생성 된 Shadow 페이로드 JSON 조회 수행 - getThingShadow]

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


[AWS] [Lambda] 런타임 Python 3.13 - boto3 모듈 사용해 SigV4Auth 서명 및 GetThingShadow 확인

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

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

 

---

[참고 사이트]

​

https://kkh0977.tistory.com/3631

150. [IT 기술] MQTT (Message Queueing Telemetry Transport) 통신 설명

---