기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 메시지 보강을 위한 전파 속성 추가
에서는 사물 속성 또는 연결 세부 정보의 컨텍스트 메타데이터인 전파 속성을 추가하여 디바이스의 MQTT 메시지를 보강 AWS IoT Core할 수 있습니다. 메시지 보강이라고 하는 이 프로세스는 다양한 시나리오에서 유용할 수 있습니다. 예를 들어, 디바이스 측을 변경하거나 규칙을 사용하지 않고도 모든 인바운드 게시 작업의 메시지를 보강할 수 있습니다. 전파 속성을 활용하면 복잡하게 규칙을 구성하거나 재게시 구성을 관리하지 않고도 더 효율적이고 비용 효율적인 방법으로 IoT 데이터를 보강할 수 있습니다.
메시지 보강 기능은 [기본 수집](https://docs.aws.amazon.com//iot/latest/developerguide/iot-basic-ingest.html) 및 [메시지 브로커](https://docs.aws.amazon.com//iot/latest/developerguide/mqtt.html)를 사용하는 AWS IoT Core 고객이 사용할 수 있습니다. 디바이스를 게시할 때 모든 MQTT 버전을 사용할 수 있지만, 구독자(메시지를 사용하는 애플리케이션 또는 서비스)는 전파 속성으로 보강된 메시지를 수신하려면 [MQTT 5](https://docs.oasis-open.org/mqtt/mqtt/v5.0/mqtt-v5.0.html)를 지원해야 합니다. 보강된 메시지는 디바이스에서 게시된 모든 메시지에 MQTT 5 사용자 속성으로 추가됩니다. [규칙](https://docs.aws.amazon.com//iot/latest/developerguide/iot-rules.html)을 사용하는 경우, [get\$1user\$1properties](https://docs.aws.amazon.com//iot/latest/developerguide/iot-sql-functions.html#iot-sql-function-get-user-properties) 함수를 활용하여, 데이터를 기반으로 메시지 라우팅 또는 처리를 위해 보강된 데이터를 검색할 수 있습니다.
에서 AWS Management Console 또는를 사용하여 사물 유형을 생성하거나 업데이트할 때 전파 속성을 추가할 AWS IoT Core수 있습니다 AWS CLI.
**중요**
전파 속성을 추가할 때, 메시지를 게시하는 클라이언트가 인증서로 인증되었는지 확인해야 합니다. 자세한 내용은 [클라이언트 인증](client-authentication.md) 단원을 참조하십시오.
**참고**
콘솔 내에서 MQTT 테스트 클라이언트를 사용하여 이 기능을 테스트하려고 할 경우, 이 기능을 사용하기 위해서는 연결된 인증서로 인증된 MQTT 클라이언트가 필요하므로 해당 기능이 작동하지 않을 수 있습니다.
## AWS Management Console
**를 사용하여 메시지 보강에 대한 전파 속성을 추가하려면 AWS Management Console**
1. AWS IoT 콘솔에서 [AWS IoT 홈 페이지를](https://console.aws.amazon.com//iot/home#/home) 엽니다. 왼쪽 탐색 창의 **관리**에서 **모든 디바이스**를 선택합니다. 그 다음에 **사물 유형**을 선택합니다.
1. **사물 유형** 페이지에서 **사물 유형 생성**을 선택합니다.
사물 유형을 업데이트하여 메시지 보강을 구성하려면, 사물 유형을 선택합니다. 그 다음에 사물 유형 세부 정보 페이지에서 **업데이트**를 선택합니다.
1. **사물 유형 생성** 페이지의 **사물 유형 속성**에서 사물 유형 정보를 선택하거나 입력합니다.
사물 유형을 업데이트하도록 선택하면, 이전 단계에서 **업데이트**를 선택한 후에 **사물 유형 속성**이 표시됩니다.
1. **추가 구성**에서 **전파 속성**을 펼칩니다. 그 다음에 **사물 속성**을 선택하고, 게시된 MQTT5 메시지에 채우고자 하는 사물 속성을 입력합니다. 콘솔을 사용하여, 최대 3개의 사물 속성을 추가할 수 있습니다.
**전파 속성** 섹션에서 **연결 속성**을 선택하고, 속성 유형을 입력합니다. 속성 이름은 선택 입력 사항입니다.
1. 원한다면, 태그를 추가합니다. 그 다음에 **사물 유형 생성**을 선택합니다.
사물 유형을 업데이트하도록 선택한 경우, **사물 유형 업데이트**를 선택합니다.
## AWS CLI
1. 를 사용하여 새 사물 유형을 생성하여 메시지 보강에 대한 전파 속성을 추가하려면 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-thing-type.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-thing-type.html) 명령을 AWS CLI실행합니다. 예제 명령은 다음과 같을 수 있습니다.
```
aws iot create-thing-type \
--thing-type-name "LightBulb" \
--thing-type-properties "{\"mqtt5Configuration\":{\"propagatingAttributes\":[{\"userPropertyKey\":\"iot:ClientId\", \"connectionAttribute\":\"iot:ClientId\"}, {\"userPropertyKey\":\"test\", \"thingAttribute\":\"A\"}]}}" \
```
명령의 출력은 다음과 같을 수 있습니다.
```
{
"thingTypeName": "LightBulb",
"thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb",
"thingTypeId": "ce3573b0-0a3c-45a7-ac93-4e0ce14cd190"
}
```
1. 를 사용하여 사물 유형을 업데이트하여 메시지 보강을 구성하려면 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-thing-type.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-thing-type.html) 명령을 AWS CLI실행합니다. 단, 이 명령을 실행할 때 `mqtt5Configuration`만 업데이트할 수 있습니다. 예제 명령은 다음과 같을 수 있습니다.
```
aws iot update-thing-type \
--thing-type-name "MyThingType" \
--thing-type-properties "{\"mqtt5Configuration\":{\"propagatingAttributes\":[{\"userPropertyKey\":\"iot:ClientId\", \"connectionAttribute\":\"iot:ClientId\"}, {\"userPropertyKey\":\"test\", \"thingAttribute\":\"A\"}]}}" \
```
이 명령은 출력을 생성하지 않습니다.
1. 사물 유형을 설명하려면 `describe-thing-type` 명령을 실행합니다. 이 명령은 `thing-type-properties` 필드에 메시지 보강 구성 정보가 포함된 출력을 생성합니다. 예제 명령은 다음과 같을 수 있습니다.
```
aws iot describe-thing-type \
--thing-type-name "LightBulb"
```
출력은 다음과 같습니다.
```
{
"thingTypeName": "LightBulb",
"thingTypeId": "bdf72512-0116-4392-8d79-bf39b17ef73d",
"thingTypeArn": "arn:aws:iot:us-east-1:123456789012:thingtype/LightBulb",
"thingTypeProperties": {
"mqtt5Configuration": {
"propagatingAttributes": [
{
"userPropertyKey": "iot:ClientId",
"connectionAttribute": "iot:ClientId"
},
{
"userPropertyKey": "test",
"thingAttribute": "attribute"
}
]
}
},
"thingTypeMetadata": {
"deprecated": false,
"creationDate": "2024-10-18T17:37:46.656000+00:00"
}
}
```
자세한 내용은 [사물 유형](thing-types.md) 단원을 참조하십시오.