AWS IoT 1-Click Esempi di dispositivi che utilizzano AWS CLI - Esempi di codice dell'AWS SDK
Azioni

Ci sono altri AWS SDK esempi disponibili nel repository AWS Doc SDK Examples GitHub .

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWS IoT 1-Click Esempi di dispositivi che utilizzano AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with AWS IoT 1-Click Devices.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni di servizio, è possibile visualizzare le azioni nel contesto negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzareclaim-devices-by-claim-code.

AWS CLI

Per richiedere uno o più dispositivi AWS IoT 1-Click utilizzando un codice promozionale

L'claim-devices-by-claim-codeesempio seguente dichiara che il dispositivo AWS IoT 1-Click specificato utilizza un codice di attestazione (anziché un ID dispositivo).

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

Output:

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

Per ulteriori informazioni, consulta Utilizzo di AWS IoT 1-Click con la Guida per AWS CLI sviluppatori IoT AWS 1-Click.

Il seguente esempio di codice mostra come utilizzaredescribe-device.

AWS CLI

Per descrivere un dispositivo

L'describe-deviceesempio seguente descrive il dispositivo specificato.

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

Output:

{
    "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": {}
    }
}

Per ulteriori informazioni, consulta Utilizzo di AWS IoT 1-Click con la Guida per AWS CLI sviluppatori IoT AWS 1-Click.

  • Per API i dettagli, consulta AWS CLI Command DescribeDeviceReference.

Il seguente esempio di codice mostra come utilizzarefinalize-device-claim.

AWS CLI

Per finalizzare una richiesta di reclamo per un dispositivo AWS IoT 1-Click utilizzando un ID dispositivo

L'finalize-device-claimesempio seguente finalizza una richiesta di reclamo per il dispositivo IoT AWS 1-Click specificato utilizzando un ID dispositivo (anziché un codice di reclamo).

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

Output:

{
    "State": "CLAIMED"
}

Per ulteriori informazioni, consulta Utilizzo di AWS IoT 1-Click con la Guida per AWS CLI sviluppatori IoT AWS 1-Click.

Il seguente esempio di codice mostra come utilizzareget-device-methods.

AWS CLI

Per elencare i metodi disponibili per un dispositivo

L'get-device-methodsesempio seguente elenca i metodi disponibili per un dispositivo.

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

Output:

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

Per ulteriori informazioni, consulta Utilizzo di AWS IoT 1-Click con la Guida per AWS CLI sviluppatori IoT AWS 1-Click.

Il seguente esempio di codice mostra come utilizzareinitiate-device-claim.

AWS CLI

Per avviare una richiesta di reclamo per un dispositivo AWS IoT 1-Click utilizzando un ID dispositivo

L'initiate-device-claimesempio seguente avvia una richiesta di reclamo per il dispositivo AWS IoT 1-Click specificato utilizzando un ID dispositivo (anziché un codice di reclamo).

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

Output:

{
    "State": "CLAIM_INITIATED"
}

Per ulteriori informazioni, consulta Utilizzo di AWS IoT 1-Click con la Guida per AWS CLI sviluppatori IoT AWS 1-Click.

Il seguente esempio di codice mostra come utilizzareinvoke-device-method.

AWS CLI

Per richiamare un metodo di dispositivo su un dispositivo

L'invoke-device-methodesempio seguente richiama il metodo specificato su un dispositivo.

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

Contenuto di invoke-device-method.json.

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

Output:

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

Per ulteriori informazioni, consulta Utilizzo di AWS IoT 1-Click con la Guida per AWS CLI sviluppatori IoT AWS 1-Click.

Il seguente esempio di codice mostra come utilizzarelist-device-events.

AWS CLI

Per elencare gli eventi di un dispositivo per un intervallo di tempo specificato

L'list-device-eventsesempio seguente elenca gli eventi del dispositivo specificato per l'intervallo di tempo specificato.

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

Output:

{
    "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}"
        }
    ]
}

Per ulteriori informazioni, consulta Utilizzo di AWS IoT 1-Click con la Guida per AWS CLI sviluppatori IoT AWS 1-Click.

Il seguente esempio di codice mostra come utilizzarelist-devices.

AWS CLI

Per elencare i dispositivi di un tipo specificato

L'list-devicesesempio seguente elenca i dispositivi di un tipo specificato.

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

Questo comando non produce alcun output.

Output:

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

Per ulteriori informazioni, consulta Utilizzo di AWS IoT 1-Click con la Guida per AWS CLI sviluppatori IoT AWS 1-Click.

  • Per API i dettagli, consulta AWS CLI Command ListDevicesReference.

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Per elencare i tag di un dispositivo

L'list-tags-for-resourceesempio seguente elenca i tag per il dispositivo specificato.

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

Output:

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

Per ulteriori informazioni, consulta Utilizzo di AWS IoT 1-Click con la Guida per AWS CLI sviluppatori IoT AWS 1-Click.

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Per aggiungere tag a una AWS risorsa del dispositivo

L'tag-resourceesempio seguente aggiunge due tag alla risorsa specificata.

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

Contenuto di devices-tag-resource.json.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Utilizzo di AWS IoT 1-Click con la Guida per AWS CLI sviluppatori IoT AWS 1-Click.

  • Per API i dettagli, consulta AWS CLI Command TagResourceReference.

Il seguente esempio di codice mostra come utilizzareunclaim-device.

AWS CLI

Per rimuovere (annullare la registrazione) di un dispositivo dal tuo account AWS

L'unclaim-deviceesempio seguente annulla (annulla la registrazione) del dispositivo specificato dal tuo account. AWS 

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

Output:

{
    "State": "UNCLAIMED"
}

Per ulteriori informazioni, consulta Utilizzo di AWS IoT 1-Click con la Guida per AWS CLI sviluppatori IoT AWS 1-Click.

  • Per API i dettagli, consulta AWS CLI Command UnclaimDeviceReference.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Per rimuovere i tag da una AWS risorsa del dispositivo

L'untag-resourceesempio seguente rimuove i tag con i nomi Driver Phone e Driver dalla risorsa del dispositivo specificata.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Utilizzo di AWS IoT 1-Click con la Guida per AWS CLI sviluppatori IoT AWS 1-Click.

  • Per API i dettagli, consulta AWS CLI Command UntagResourceReference.

Il seguente esempio di codice mostra come utilizzareupdate-device-state.

AWS CLI

Per aggiornare lo stato ``abilitato`` per un dispositivo

Quanto segue update-device-state imposta lo stato del dispositivo specificato su. enabled

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Utilizzo di AWS IoT 1-Click con la Guida per AWS CLI sviluppatori IoT AWS 1-Click.