AWS IoT 1-Click 를 사용한 디바이스 예제 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 개발자 안내서 AWS CLIAWS 의 에서 IoT 1-Click 사용을 참조하세요.

디바이스를 설명하려면

다음 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 개발자 안내서 AWS CLIAWS 의 에서 IoT 1-Click 사용을 참조하세요.

디바이스 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 개발자 안내서 AWS CLIAWS 의 에서 IoT 1-Click 사용을 참조하세요.

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

다음 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 개발자 안내서 AWS CLIAWS 의 에서 IoT 1-Click 사용을 참조하세요.

디바이스 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 개발자 안내서 AWS CLIAWS 의 에서 IoT 1-Click 사용을 참조하세요.

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

다음 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 개발자 안내서 AWS CLIAWS 의 에서 IoT 1-Click 사용을 참조하세요.

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

다음 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 개발자 안내서 AWS CLIAWS 의 에서 IoT 1-Click 사용을 참조하세요.

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

다음 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 개발자 안내서 AWS CLIAWS 의 에서 IoT 1-Click 사용을 참조하세요.

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

다음 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 개발자 안내서 AWS CLIAWS 의 에서 IoT 1-Click 사용을 참조하세요.

디바이스 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 개발자 안내서 AWS CLIAWS 의 에서 IoT 1-Click 사용을 참조하세요.

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

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

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

출력:

{
    "State": "UNCLAIMED"
}

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

디바이스 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 개발자 안내서 AWS CLIAWS 의 에서 IoT 1-Click 사용을 참조하세요.

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

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

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

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

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