AWS IoT 1-Click Esempi di progetti che utilizzano AWS CLI - AWS Command Line Interface
Azioni

Questa documentazione è valida AWS CLI solo per la versione 1. Per la documentazione relativa alla versione 2 di AWS CLI, consulta la Guida per l'utente della versione 2.

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 progetti 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 Projects.

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 nei relativi scenari.

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 utilizzareassociate-device-with-placement.

AWS CLI

Per associare un dispositivo AWS IoT 1-Click a un posizionamento esistente

L'associate-device-with-placementesempio seguente associa il dispositivo AWS IoT 1-Click specificato a un posizionamento esistente.

aws iot1click-projects associate-device-with-placement \
    --project-name AnytownDumpsters \
    --placement-name customer217 \
    --device-template-name empty-dumpster-request \
    --device-id G030PM0123456789

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.

Il seguente esempio di codice mostra come utilizzarecreate-placement.

AWS CLI

Per creare un posizionamento AWS IoT 1-Click per un progetto

L'create-placementesempio seguente crea un posizionamento AWS IoT 1-Click per il progetto specificato.

aws iot1click-projects create-placement \
    --project-name AnytownDumpsters \
    --placement-name customer217 \
    --attributes "{"location": "123 Any Street Anytown, USA 10001", "phone": "123-456-7890"}"

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.

Il seguente esempio di codice mostra come utilizzarecreate-project.

AWS CLI

Per creare un progetto AWS IoT 1-Click per zero o più posizionamenti

L'create-projectesempio seguente crea un progetto AWS IoT 1-Click per un posizionamento.

aws iot1click-projects create-project -- file: //create-project.json cli-input-json

Contenuto di create-project.json.

{
     "projectName": "AnytownDumpsters",
     "description": "All dumpsters in the Anytown region.",
     "placementTemplate": {
         "defaultAttributes": {
             "City" : "Anytown"
         },
         "deviceTemplates": {
             "empty-dumpster-request" : {
                 "deviceType": "button"
             }
         }
     }
}

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 CreateProjectReference.

Il seguente esempio di codice mostra come utilizzaredelete-placement.

AWS CLI

Per eliminare un posizionamento da un progetto

L'delete-placementesempio seguente elimina il posizionamento specificato da un progetto.

aws iot1click-projects delete-placement \
    --project-name AnytownDumpsters \
    --placement-name customer217

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.

Il seguente esempio di codice mostra come utilizzaredelete-project.

AWS CLI

Per eliminare un progetto dal tuo AWS account

L'delete-projectesempio seguente elimina il progetto specificato dal tuo AWS account.

aws iot1click-projects delete-project \
    --project-name AnytownDumpsters

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 DeleteProjectReference.

Il seguente esempio di codice mostra come utilizzaredescribe-placement.

AWS CLI

Per descrivere il posizionamento di un progetto

L'describe-placementesempio seguente descrive un posizionamento per il progetto specificato.

aws iot1click-projects describe-placement \
    --project-name AnytownDumpsters \
    --placement-name customer217

Output:

{
    "placement": {
        "projectName": "AnytownDumpsters",
        "placementName": "customer217",
        "attributes": {
            "phone": "123-555-0110",
            "location": "123 Any Street Anytown, USA 10001"
        },
        "createdDate": 1563488454,
        "updatedDate": 1563488454
    }
}

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-project.

AWS CLI

Per descrivere un progetto AWS IoT 1-Click

L'describe-projectesempio seguente descrive il progetto AWS IoT 1-Click specificato.

aws iot1click-projects describe-project \
    --project-name AnytownDumpsters

Output:

{
    "project": {
        "arn": "arn:aws:iot1click:us-west-2:012345678901:projects/AnytownDumpsters",
        "projectName": "AnytownDumpsters",
        "description": "All dumpsters in the Anytown region.",
        "createdDate": 1563483100,
        "updatedDate": 1563483100,
        "placementTemplate": {
            "defaultAttributes": {
                "City": "Anytown"
            },
            "deviceTemplates": {
                "empty-dumpster-request": {
                    "deviceType": "button",
                    "callbackOverrides": {}
                }
            }
        },
        "tags": {}
    }
}

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 utilizzaredisassociate-device-from-placement.

AWS CLI

Dissociare un dispositivo da un posizionamento

L'disassociate-device-from-placementesempio seguente dissocia il dispositivo specificato da un posizionamento.

aws iot1click-projects disassociate-device-from-placement \
    --project-name AnytownDumpsters \
    --placement-name customer217 \
    --device-template-name empty-dumpster-request

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.

Il seguente esempio di codice mostra come utilizzareget-devices-in-placement.

AWS CLI

Per elencare tutti i dispositivi in una posizione contenuta in un progetto

L'get-devices-in-placementesempio seguente elenca tutti i dispositivi in una posizione specificata contenuta nel progetto specificato.

aws iot1click-projects get-devices-in-placement \
    --project-name AnytownDumpsters \
    --placement-name customer217

Output:

{
    "devices": {
        "empty-dumpster-request": "G030PM0123456789"
    }
}

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-placements.

AWS CLI

Per elencare tutti i posizionamenti AWS IoT 1-Click per un progetto

L'list-placementsesempio seguente elenca tutti i posizionamenti AWS IoT 1-Click per il progetto specificato.

aws iot1click-projects list-placements \
    --project-name AnytownDumpsters

Output:

{
    "placements": [
        {
            "projectName": "AnytownDumpsters",
            "placementName": "customer217",
            "createdDate": 1563488454,
            "updatedDate": 1563488454
        }
    ]
}

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 ListPlacementsReference.

Il seguente esempio di codice mostra come utilizzarelist-projects.

AWS CLI

Per elencare tutti i progetti AWS IoT 1-Click

L'list-projectsesempio seguente elenca tutti i progetti AWS IoT 1-Click presenti nel tuo account.

aws iot1click-projects list-projects

Output:

{
    "projects": [
        {
            "arn": "arn:aws:iot1click:us-west-2:012345678901:projects/AnytownDumpsters",
            "projectName": "AnytownDumpsters",
            "createdDate": 1563483100,
            "updatedDate": 1563483100,
            "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 ListProjectsReference.

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

AWS CLI

Per elencare i tag di una risorsa del progetto

L'list-tags-for-resourceesempio seguente elenca i tag per la risorsa di progetto specificata.

aws iot1click-projects list-tags-for-resource \
    --resource-arn "arn:aws:iot1click:us-west-2:123456789012:projects/AnytownDumpsters"

Output:

{
    "tags": {
        "Manager": "Li Juan",
        "Account": "45215"
    }
}

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 risorsa del progetto

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

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

Contenuto di devices-tag-resource.json.

{
    "resourceArn": "arn:aws:iot1click:us-west-2:123456789012:projects/AnytownDumpsters",
    "tags": {
        "Account": "45215",
        "Manager": "Li Juan"
    }
}

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 utilizzareuntag-resource.

AWS CLI

Per rimuovere i tag da una risorsa del progetto

L'untag-resourceesempio seguente rimuove il tag con il nome della chiave Manager dal progetto specificato.

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

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-placement.

AWS CLI

Per aggiornare le coppie chiave-valore «attributi» di un posizionamento

L'update-placementesempio seguente aggiorna le coppie chiave-valore «attributi» di un posizionamento.

aws iot1click-projects update-placement \
    --cli-input-json file://update-placement.json

Contenuto di update-placement.json.

{
    "projectName": "AnytownDumpsters",
    "placementName": "customer217",
    "attributes": {
        "phone": "123-456-7890",
        "location": "123 Any Street Anytown, USA 10001"
    }
}

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.

Il seguente esempio di codice mostra come utilizzareupdate-project.

AWS CLI

Per aggiornare le impostazioni di un progetto

L'update-projectesempio seguente aggiorna la descrizione di un progetto.

aws iot1click-projects update-project \
    --project-name AnytownDumpsters \
    --description "All dumpsters (yard waste, recycling, garbage) in the Anytown region."

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 UpdateProjectReference.