AWS IoT 1-Click 를 사용한 디바이스 예제 AWS CLI

다음 코드 예제에서는 AWS IoT 1-Click 디바이스와 AWS Command Line Interface 함께를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.

주제

작업

작업

다음 코드 예시에서는 claim-devices-by-claim-code을 사용하는 방법을 보여 줍니다.

AWS CLI

클레임 코드를 사용하여 하나 이상의 AWS IoT 1-Click 디바이스를 클레임하려면

다음 claim-devices-by-claim-code 예제에서는 클레임 코드(디바이스 ID 대신)를 사용하여 지정된 AWS IoT 1-Click 디바이스를 클레임합니다.


aws iot1click-devices claim-devices-by-claim-code \
    --claim-code C-123EXAMPLE

출력:


{
   "Total": 9
   "ClaimCode": "C-123EXAMPLE"
}

자세한 내용은 AWS IoT 1-Click 개발자 안내서의 IoT 1-Click with the AWS CLI 사용을 참조하세요. AWS IoT 1-Click

API 세부 정보는 AWS CLI 명령 참조의 ClaimDevicesByClaimCode를 참조하세요.

다음 코드 예시에서는 describe-device을 사용하는 방법을 보여 줍니다.

AWS CLI

디바이스를 설명하려면

다음 describe-device 예제에서는 지정된 디바이스를 설명합니다.


aws iot1click-devices describe-device \
    --device-id G030PM0123456789

출력:


{
    "DeviceDescription": {
        "Arn": "arn:aws:iot1click:us-west-2:012345678901:devices/G030PM0123456789",
        "Attributes": {
            "projectRegion": "us-west-2",
            "projectName": "AnytownDumpsters",
            "placementName": "customer217",
            "deviceTemplateName": "empty-dumpster-request"
        },
        "DeviceId": "G030PM0123456789",
        "Enabled": false,
        "RemainingLife": 99.9,
        "Type": "button",
        "Tags": {}
    }
}

자세한 내용은 AWS IoT 1-Click 개발자 안내서의 IoT 1-Click with the AWS CLI 사용을 참조하세요. AWS IoT 1-Click

API 세부 정보는 AWS CLI 명령 참조의 DescribeDevice를 참조하세요.

다음 코드 예시에서는 finalize-device-claim을 사용하는 방법을 보여 줍니다.

AWS CLI

디바이스 ID를 사용하여 AWS IoT 1-Click 디바이스에 대한 클레임 요청을 완료하려면

다음 finalize-device-claim 예제에서는 디바이스 ID(클레임 코드 대신)를 사용하여 지정된 AWS IoT 1-Click 디바이스에 대한 클레임 요청을 완료합니다.


aws iot1click-devices finalize-device-claim \
    --device-id G030PM0123456789

출력:


{
    "State": "CLAIMED"
}

자세한 내용은 AWS IoT 1-Click 개발자 안내서의 IoT 1-Click with the AWS CLI 사용을 참조하세요. AWS IoT 1-Click

API 세부 정보는 AWS CLI 명령 참조의 FinalizeDeviceClaim를 참조하세요.

다음 코드 예시에서는 get-device-methods을 사용하는 방법을 보여 줍니다.

AWS CLI

디바이스에 사용 가능한 메서드를 나열하려면

다음 get-device-methods 예제에서는 디바이스에 사용할 수 있는 방법을 나열합니다.


aws iot1click-devices get-device-methods \
    --device-id G030PM0123456789

출력:


{
    "DeviceMethods": [
        {
            "MethodName": "getDeviceHealthParameters"
        },
        {
            "MethodName": "setDeviceHealthMonitorCallback"
        },
        {
            "MethodName": "getDeviceHealthMonitorCallback"
        },
        {
            "MethodName": "setOnClickCallback"
        },
        {
            "MethodName": "getOnClickCallback"
        }
    ]
}

자세한 내용은 AWS IoT 1-Click 개발자 안내서의 IoT 1-Click with the AWS CLI 사용을 참조하세요. AWS IoT 1-Click

API 세부 정보는 AWS CLI 명령 참조의 GetDeviceMethods를 참조하세요.

다음 코드 예시에서는 initiate-device-claim을 사용하는 방법을 보여 줍니다.

AWS CLI

디바이스 ID를 사용하여 AWS IoT 1-Click 디바이스에 대한 클레임 요청을 시작하려면

다음 initiate-device-claim 예제에서는 디바이스 ID(클레임 코드 대신)를 사용하여 지정된 AWS IoT 1-Click 디바이스에 대한 클레임 요청을 시작합니다.


aws iot1click-devices initiate-device-claim \
    --device-id G030PM0123456789

출력:


{
    "State": "CLAIM_INITIATED"
}

자세한 내용은 AWS IoT 1-Click 개발자 안내서의 IoT 1-Click with the AWS CLI 사용을 참조하세요. AWS IoT 1-Click

API 세부 정보는 AWS CLI 명령 참조의 InitiateDeviceClaim를 참조하세요.

다음 코드 예시에서는 invoke-device-method을 사용하는 방법을 보여 줍니다.

AWS CLI

디바이스에서 디바이스 메서드를 호출하려면

다음 invoke-device-method 예제에서는 디바이스에서 지정된 메서드를 호출합니다.


aws iot1click-devices invoke-device-method \
    --cli-input-json file://invoke-device-method.json

invoke-device-method.json의 콘텐츠:


{
    "DeviceId": "G030PM0123456789",
    "DeviceMethod": {
        "DeviceType": "device",
        "MethodName": "getDeviceHealthParameters"
    }
}

출력:


{
    "DeviceMethodResponse": "{\"remainingLife\": 99.8}"
}

자세한 내용은 AWS IoT 1-Click 개발자 안내서의 IoT 1-Click with the AWS CLI 사용을 참조하세요. AWS IoT 1-Click

API 세부 정보는 AWS CLI 명령 참조의 InvokeDeviceMethod를 참조하세요.

다음 코드 예시에서는 list-device-events을 사용하는 방법을 보여 줍니다.

AWS CLI

지정된 시간 범위에 대한 디바이스의 이벤트를 나열하려면

다음 list-device-events 예제에서는 지정된 시간 범위에 대해 지정된 디바이스의 이벤트를 나열합니다.


aws iot1click-devices list-device-events \
    --device-id G030PM0123456789 \
    --from-time-stamp 2019-07-17T15:45:12.880Z --to-time-stamp 2019-07-19T15:45:12.880Z

출력:


{
    "Events": [
        {
            "Device": {
                "Attributes": {},
                "DeviceId": "G030PM0123456789",
                "Type": "button"
            },
            "StdEvent": "{\"clickType\": \"SINGLE\", \"reportedTime\": \"2019-07-18T23:47:55.015Z\", \"certificateId\": \"fe8798a6c97c62ef8756b80eeefdcf2280f3352f82faa8080c74cc4f4a4d1811\", \"remainingLife\": 99.85000000000001, \"testMode\": false}"
        },
        {
            "Device": {
                "Attributes": {},
                "DeviceId": "G030PM0123456789",
                "Type": "button"
            },
            "StdEvent": "{\"clickType\": \"DOUBLE\", \"reportedTime\": \"2019-07-19T00:14:41.353Z\", \"certificateId\": \"fe8798a6c97c62ef8756b80eeefdcf2280f3352f82faa8080c74cc4f4a4d1811\", \"remainingLife\": 99.8, \"testMode\": false}"
        }
    ]
}

자세한 내용은 AWS IoT 1-Click 개발자 안내서의 IoT 1-Click with the AWS CLI 사용을 참조하세요. AWS IoT 1-Click

API 세부 정보는 AWS CLI 명령 참조의 ListDeviceEvents를 참조하세요.

다음 코드 예시에서는 list-devices을 사용하는 방법을 보여 줍니다.

AWS CLI

지정된 유형의 디바이스를 나열하려면

다음 list-devices 예제에서는 지정된 유형의 디바이스를 나열합니다.


aws iot1click-devices list-devices \
    --device-type button

이 명령은 출력을 생성하지 않습니다.

출력:


{
    "Devices": [
        {
            "remainingLife": 99.9,
            "attributes": {
                "arn": "arn:aws:iot1click:us-west-2:123456789012:devices/G030PM0123456789",
                "type": "button",
                "deviceId": "G030PM0123456789",
                "enabled": false
            }
        }
    ]
}

자세한 내용은 AWS IoT 1-Click 개발자 안내서의 IoT 1-Click with the AWS CLI 사용을 참조하세요. AWS IoT 1-Click

API 세부 정보는 AWS CLI 명령 참조의 ListDevices를 참조하세요.

다음 코드 예시에서는 list-tags-for-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

디바이스의 태그를 나열하려면

다음 list-tags-for-resource 예제에서는 지정된 디바이스의 태그를 나열합니다.


aws iot1click-devices list-tags-for-resource \
    --resource-arn "arn:aws:iot1click:us-west-2:012345678901:devices/G030PM0123456789"

출력:


{
    "Tags": {
        "Driver Phone": "123-555-0199",
        "Driver": "Jorge Souza"
    }
}

자세한 내용은 AWS IoT 1-Click 개발자 안내서의 IoT 1-Click with the AWS CLI 사용을 참조하세요. AWS IoT 1-Click

API 세부 정보는 AWS CLI 명령 참조의 ListTagsForResource를 참조하세요.

다음 코드 예시에서는 tag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

디바이스 AWS 리소스에 태그를 추가하려면

다음 tag-resource 예제에서는 지정된 리소스에 두 개의 태그를 추가합니다.


aws iot1click-devices tag-resource \
    --cli-input-json file://devices-tag-resource.json

devices-tag-resource.json의 콘텐츠:


{
    "ResourceArn": "arn:aws:iot1click:us-west-2:123456789012:devices/G030PM0123456789",
    "Tags": {
        "Driver": "Jorge Souza",
        "Driver Phone": "123-555-0199"
    }
}

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS IoT 1-Click 개발자 안내서의 IoT 1-Click with the AWS CLI 사용을 참조하세요. AWS IoT 1-Click

API 세부 정보는 AWS CLI 명령 참조의 TagResource를 참조하세요.

다음 코드 예시에서는 unclaim-device을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS 계정에서 디바이스를 요청 취소(등록 취소)하려면

다음 unclaim-device 예제에서는 AWS 계정에서 지정된 디바이스를 요청 취소(등록 취소)합니다.


aws iot1click-devices unclaim-device \
    --device-id G030PM0123456789

출력:


{
    "State": "UNCLAIMED"
}

자세한 내용은 AWS IoT 1-Click 개발자 안내서의 IoT 1-Click with the AWS CLI 사용을 참조하세요. AWS IoT 1-Click

API 세부 정보는 AWS CLI 명령 참조의 UnclaimDevice를 참조하세요.

다음 코드 예시에서는 untag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

디바이스 AWS 리소스에서 태그를 제거하려면

다음 untag-resource 예제에서는 이름이 Driver Phone 및 인 태그를 지정된 디바이스 리소스Driver에서 제거합니다.


aws iot1click-devices untag-resource \
    --resource-arn "arn:aws:iot1click:us-west-2:123456789012:projects/AnytownDumpsters" \
    --tag-keys "Driver Phone" "Driver"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS IoT 1-Click 개발자 안내서의 IoT 1-Click with the AWS CLI 사용을 참조하세요. AWS IoT 1-Click

API 세부 정보는 AWS CLI 명령 참조의 UntagResource를 참조하세요.

다음 코드 예시에서는 update-device-state을 사용하는 방법을 보여 줍니다.

AWS CLI

디바이스의 ``enabled`` 상태를 업데이트하려면

다음은 지정된 디바이스의 상태를 로 update-device-state 설정합니다enabled.


aws iot1click-devices update-device-state \
    --device-id G030PM0123456789 \
    --enabled

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS IoT 1-Click 개발자 안내서의 IoT 1-Click with the AWS CLI 사용을 참조하세요. AWS IoT 1-Click

API 세부 정보는 AWS CLI 명령 참조의 UpdateDeviceState를 참조하세요.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

AWS IoT

AWS IoT 1-Click 프로젝트