투케이2K

492. (javaScript) 자바스크립트 AWS Iot Core 에 생성 된 특정 Rule 룰엔진 상세 정보 조회 - GetTopicRule 본문

JavaScript

492. (javaScript) 자바스크립트 AWS Iot Core 에 생성 된 특정 Rule 룰엔진 상세 정보 조회 - GetTopicRule

투케이2K 2026. 2. 20. 20:17
728x90
반응형

[개발 환경 설정]

​

개발 툴 : Edit++

​

개발 언어 : JavaScript

​

 

[소스 코드]

​

-----------------------------------------------------------------------------------------
[사전 설명 및 설정 사항]
-----------------------------------------------------------------------------------------

- 개발 환경 : Web


- 개발 기술 : JavaScript (자바스크립트) / AWS / Iot / Rule / 룰엔진 / GetTopicRule


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

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

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

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


- 사전) Aws Rule Engine 간략 설명 : 

  >> Rule Engine (룰 엔진) 이란 Aws Iot Core MQTT 메시지를 실시간으로 분석하고, 이를 기반으로 AWS 다양한 서비스와 연동할 수 있는 기능입니다

  >> 룰 엔진에서는 MQTT 메시지를 분석해 AWS 다른 서비스를 호출 하도록 라우팅 처리를 수행합니다

  >> Rule Engine (룰 엔진) 주요 기능 :

    - AWS 서비스 연동 : AWS 다양한 서비스는 DynamoDB, S3, Lambda, SNS, SQS, Kinesis 등으로 데이터 전송

    - 멀티 액션 지원 : 하나의 규칙에서 여러개의 액션을 동시에 실행

    - 메시지 필터링 및 변환 : SQL 기반의 Query 쿼리 언어를 사용하여 데이터 필터링 및 변환

    - 데이터 프로세싱 : JSON 형식의 데이터를 분석하고 변환 및 활용

-----------------------------------------------------------------------------------------





-----------------------------------------------------------------------------------------
[소스 코드]
-----------------------------------------------------------------------------------------

<!DOCTYPE HTML>
<html lang="ko">
<head>
    <title>javaScriptTest</title>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">


    <!-- 반응형 구조 만들기 -->
    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0, user-scalable=no">


    <!-- 내부 CSS 스타일 지정 -->
    <style>

        html, body {
            width: 100%;
            height: 100%;
            margin : 0 auto;
            padding : 0;
            border : none;
            background-color: #666;
        }

    </style>





    <!-- [CDN 주소 설정] -->
    <script src="https://code.jquery.com/jquery-latest.min.js"></script>
    <script src="https://sdk.amazonaws.com/js/aws-sdk-2.1416.0.min.js"></script>






    <!-- [자바스크립트 코드 지정] -->
    <script>

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

        // [전역 변수 선언]        
        const region = 'ap-northeast-2';
        const accessKey = 'AK..A6';
        const secretKey = 'mP..5J';

        const ruleName = 'device_keepalive';

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

        // [html 최초 로드 및 이벤트 상시 대기 실시]
        window.onload = async function() {
          console.log("");
          console.log("=========================================");
          console.log("[window onload] : [start]");
          console.log("=========================================");
          console.log("");

          try {

            // -----------------------------------------
            // [AWS.config 지정]
            // -----------------------------------------       
            AWS.config.update({        
              region: region,      
              accessKeyId: accessKey,
              secretAccessKey: secretKey
            });


            // -----------------------------------------
            // [AWS 객체 생성]
            // -----------------------------------------
            const aws = new AWS.Iot();


            // -----------------------------------------
            // [요청 파라미터 생성]
            // -----------------------------------------
            const param = { // ✅ Request_파라미터
              ruleName: ruleName
            };


            // -----------------------------------------
            // [getTopicRule] : AWS IoT Core Rule Engine 에서 특정 룰(rule) 의 상세 정보 조회 수행
            // -----------------------------------------
            // AWS 참고 사이트 : https://docs.aws.amazon.com/iot/latest/apireference/API_GetTopicRule.html
            // -----------------------------------------

            aws.getTopicRule( param , function(err, data) { 
              if (err) {
                console.error("");
                console.error("=========================================");
                console.error("[getTopicRule] : [Error]");
                console.error("---------------------------------------");
                console.error(err);
                console.error("=========================================");
                console.error("");

                // ---------------------------------------------
                // ✅ [주요 에러 정리]
                // ---------------------------------------------
                // ResourceNotFoundException : 존재하지 않는 ruleName을 호출할 때 발생
                // ---------------------------------------------
                // UnauthorizedException : 호출한 IAM 자격에 iot:GetTopicRule 권한이 없음
                // ---------------------------------------------
                // ThrottlingException : 너무 많은 호출을 짧은 시간에 보냈을 때, IoT 제어 플레인 API는 초당 요청량 제한 존재
                // ---------------------------------------------
                // InternalFailureException : AWS IoT 내부 오류
                // ---------------------------------------------
                // InvalidRequestException : 잘못된 ruleName 형식
                // ---------------------------------------------


                // ---------------------------------------------
                // [Body 표시 JSON]
                // ---------------------------------------------
                var errJson = {
                  response: "error",
                  data: err
                }
                // ---------------------------------------------


                // ---------------------------------------------
                // [에러 출력]
                // ---------------------------------------------
                document.write(JSON.stringify(errJson));
                // ---------------------------------------------

              } else {
                console.log("");
                console.log("=========================================");
                console.log("[getTopicRule] : [Success]");
                console.log("---------------------------------------");
                console.log(JSON.stringify(data));
                console.log("=========================================");
                console.log("");

                // ---------------------------------------------
                // ✅ [로그 출력 예시 첨부]
                // ---------------------------------------------
                /*                
                {
                  "ruleArn": "arn:aws:iot:us-west-2:123456789012:rule/MyTestRule",
                  "rule": {
                    "ruleName": "MyTestRule",
                    "sql": "SELECT * FROM 'devices/+/data' WHERE temperature > 30",
                    "description": "High temperature rule",
                    "createdAt": "2025-07-08T19:56:00Z",
                    "actions": [
                      {
                        "lambda": {
                          "functionArn": "arn:aws:lambda:us-west-2:123456789012:function:HighTempHandler"
                        }
                      },
                      {
                        "sns": {
                          "targetArn": "arn:aws:sns:us-west-2:123456789012:HighTempTopic",
                          "roleArn": "arn:aws:iam::123456789012:role/SNSTopicRole",
                          "messageFormat": "RAW"
                        }
                      }
                    ],
                    "ruleDisabled": false,
                    "awsIotSqlVersion": "2016-03-23",
                    "errorAction": {
                      "sqs": {
                        "roleArn": "arn:aws:iam::123456789012:role/SQSRole",
                        "queueUrl": "https://sqs.us-west-2.amazonaws.com/123456789012/RuleErrorQueue",
                        "useBase64": false
                      }
                    }
                  }
                }
                */
                // ---------------------------------------------


                // ---------------------------------------------
                // [Body 표시 JSON]
                // ---------------------------------------------
                var resJson = {
                  response: "success",
                  data: data
                }
                // ---------------------------------------------


                // ---------------------------------------------
                // [결과 출력]
                // ---------------------------------------------
                document.write(JSON.stringify(resJson));
                // ---------------------------------------------

              }

            });

          }
          catch (exception) {
            console.error("");
            console.error("=========================================");
            console.error("[window onload] : [Exception] : 예외 상황 발생");
            console.error("-----------------------------------------");
            console.error(exception);
            console.error("=========================================");
            console.error("");

            // ---------------------------------------------
            // [Body 표시 JSON]
            // ---------------------------------------------
            var errJson = {
              response: "exception",
              data: exception.message
            }
            // ---------------------------------------------


            // ---------------------------------------------
            // [에러 출력]
            // ---------------------------------------------
            document.write(JSON.stringify(errJson));
            // ---------------------------------------------

          }

        };

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

    </script>


</head>


<body>

</body>

</html>

-----------------------------------------------------------------------------------------





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

[자바스크립트 AWS Iot Core 룰엔진 리스트 nextToken 사용해 전체 조회 수행 - listTopicRules]

https://kkh0977.tistory.com/8461

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


[Aws Iot Core] 메시지 라우팅 규칙 Rule Engine 룰 엔진 개념 학습

https://kkh0977.tistory.com/8130

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


[Aws Iot Core] Rule Engine 룰 엔진 생성 목록 확인 방법 - 메시지 라우팅 규칙 확인

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

-----------------------------------------------------------------------------------------
 
728x90
반응형
저작자표시 (새창열림)

'JavaScript' 카테고리의 다른 글

494. (javaScript) 자바스크립트 AWS Lambda 함수 세부 정보 조회 수행 - GetFunction  (0) 2026.02.23
493. (javaScript) 자바스크립트 AWS Lambda 함수 목록 리스트 조회 수행 - ListFunctions  (0) 2026.02.21
491. (javaScript) [간단 소스] document.addEventListener('fullscreenchange') 사용해 전체 화면 활성 및 비활성 상태 감지 수행  (0) 2026.02.20
490. (javaScript) 자바스크립트 describeLogGroups 사용해 AWS CloudWatchLogs 로그 그룹 목록 리스트 조회  (0) 2026.02.19
489. (javaScript) [설명 정리] 로컬스토리지 LocalStorage 내에 저장 가능한 데이터 용량 사이즈 정리  (0) 2026.02.14
'JavaScript' Related Articles more
Comments