AWS IoT Greengrass V2 esempi utilizzando AWS CLI

Per associare il ruolo di servizio Greengrass al tuo account AWS

L'associate-service-role-to-accountesempio seguente associa un ruolo di servizio a AWS IoT Greengrass per AWS il tuo account.

aws greengrassv2 associate-service-role-to-account \
    --role-arn arn:aws:iam::123456789012:role/service-role/Greengrass_ServiceRole

Output:

{
    "associatedAt": "2022-01-19T19:21:53Z"
}

Per ulteriori informazioni, consulta il ruolo del servizio Greengrass nella Guida per sviluppatori IoT AWS Greengrass V2.

Per associare i dispositivi client a un dispositivo principale

L'batch-associate-client-device-with-core-deviceesempio seguente associa due dispositivi client a un dispositivo principale.

aws greengrassv2 batch-associate-client-device-with-core-device \
  --core-device-thing-name MyGreengrassCore \
  --entries thingName=MyClientDevice1 thingName=MyClientDevice2

Output:

{
    "errorEntries": []
}

Per ulteriori informazioni, consulta Interagire con i dispositivi IoT locali nella Guida per AWS sviluppatori IoT Greengrass V2.

Per dissociare i dispositivi client da un dispositivo principale

L'batch-disassociate-client-device-from-core-deviceesempio seguente dissocia due dispositivi client da un dispositivo principale.

aws greengrassv2 batch-disassociate-client-device-from-core-device \
  --core-device-thing-name MyGreengrassCore \
  --entries thingName=MyClientDevice1 thingName=MyClientDevice2

Output:

{
    "errorEntries": []
}

Per ulteriori informazioni, consulta Interagire con i dispositivi IoT locali nella Guida per AWS sviluppatori IoT Greengrass V2.

Per annullare una distribuzione

L'cancel-deploymentesempio seguente interrompe una distribuzione continua in un gruppo di oggetti.

aws greengrassv2 cancel-deployment \
    --deployment-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Output:

{
    "message": "SUCCESS"
}

Per ulteriori informazioni, consulta Annullare le implementazioni nella Guida per gli sviluppatori di IoT AWS Greengrass V2.

Esempio 1: creare una versione di un componente da una ricetta

L'create-component-versionesempio seguente crea una versione di un componente Hello World da un file di ricette.

aws greengrassv2 create-component-version \
    --inline-recipe fileb://com.example.HelloWorld-1.0.0.json

Contenuto di com.example.HelloWorld-1.0.0.json.

{
    "RecipeFormatVersion": "2020-01-25",
    "ComponentName": "com.example.HelloWorld",
    "ComponentVersion": "1.0.0",
    "ComponentDescription": "My first AWS IoT Greengrass component.",
    "ComponentPublisher": "Amazon",
    "ComponentConfiguration": {
        "DefaultConfiguration": {
            "Message": "world"
        }
    },
    "Manifests": [
        {
            "Platform": {
                "os": "linux"
            },
            "Lifecycle": {
                "Run": "echo 'Hello {configuration:/Message}'"
            }
        }
    ]
}

Output:

{
    "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0",
    "componentName": "com.example.HelloWorld",
    "componentVersion": "1.0.0",
    "creationTimestamp": "2021-01-07T16:24:33.650000-08:00",
    "status": {
        "componentState": "REQUESTED",
        "message": "NONE",
        "errors": {}
    }
}

Per ulteriori informazioni, consulta Creare componenti personalizzati e Caricare componenti da distribuire nella Guida per sviluppatori AWS IoT Greengrass V2.

Esempio 2: creare una versione di un componente da una funzione AWS Lambda

L'create-component-versionesempio seguente crea una versione di un componente Hello World da una funzione AWS Lambda.

aws greengrassv2 create-component-version \
    --cli-input-json file://lambda-function-component.json

Contenuto di lambda-function-component.json.

{
    "lambdaFunction": {
        "lambdaArn": "arn:aws:lambda:us-west-2:123456789012:function:HelloWorldPythonLambda:1",
        "componentName": "com.example.HelloWorld",
        "componentVersion": "1.0.0",
        "componentLambdaParameters": {
            "eventSources": [
                {
                    "topic": "hello/world/+",
                    "type": "IOT_CORE"
                }
            ]
        }
    }
}

Output:

{
    "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0",
    "componentName": "com.example.HelloWorld",
    "componentVersion": "1.0.0",
    "creationTimestamp": "2021-01-07T17:05:27.347000-08:00",
    "status": {
        "componentState": "REQUESTED",
        "message": "NONE",
        "errors": {}
    }
}

Per ulteriori informazioni, consulta Run AWS Lambda functions nella IoT AWS Greengrass V2 Developer Guide.

Esempio 1: creare una distribuzione

L'create-deploymentesempio seguente distribuisce l'interfaccia a riga di comando AWS IoT Greengrass su un dispositivo principale.

aws greengrassv2 create-deployment \
    --cli-input-json file://cli-deployment.json

Contenuto di cli-deployment.json.

{
    "targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
    "deploymentName": "Deployment for MyGreengrassCore",
    "components": {
        "aws.greengrass.Cli": {
            "componentVersion": "2.0.3"
        }
    },
    "deploymentPolicies": {
        "failureHandlingPolicy": "DO_NOTHING",
        "componentUpdatePolicy": {
            "timeoutInSeconds": 60,
            "action": "NOTIFY_COMPONENTS"
        },
        "configurationValidationPolicy": {
            "timeoutInSeconds": 60
        }
    },
    "iotJobConfiguration": {}
}

Output:

{
    "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Per ulteriori informazioni, consulta Create deployments nella IoT AWS Greengrass V2 Developer Guide.

Esempio 2: creare una distribuzione che aggiorni le configurazioni dei componenti

L'create-deploymentesempio seguente distribuisce il componente AWS IoT Greengrass nucleus su un gruppo di dispositivi principali. Questa distribuzione applica i seguenti aggiornamenti di configurazione per il componente nucleus:

Reimposta le impostazioni proxy dei dispositivi di destinazione ai valori predefiniti senza impostazioni proxy. Reimposta le impostazioni dei dispositivi di destinazione ai valori predefiniti. Imposta MQTT le opzioni per il nucleo' .Imposta il livello di registrazione per il JVM nucleo. JVM

aws greengrassv2 create-deployment \
    --cli-input-json file://nucleus-deployment.json

Contenuto di nucleus-deployment.json.

{
    "targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup",
    "deploymentName": "Deployment for MyGreengrassCoreGroup",
    "components": {
        "aws.greengrass.Nucleus": {
            "componentVersion": "2.0.3",
            "configurationUpdate": {
                "reset": [
                    "/networkProxy",
                    "/mqtt"
                ],
                "merge": "{\"jvmOptions\":\"-Xmx64m\",\"logging\":{\"level\":\"WARN\"}}"
            }
        }
    },
    "deploymentPolicies": {
        "failureHandlingPolicy": "ROLLBACK",
        "componentUpdatePolicy": {
            "timeoutInSeconds": 60,
            "action": "NOTIFY_COMPONENTS"
        },
        "configurationValidationPolicy": {
            "timeoutInSeconds": 60
        }
    },
    "iotJobConfiguration": {}
}

Output:

{
    "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
    "iotJobArn": "arn:aws:iot:us-west-2:123456789012:job/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}

Per ulteriori informazioni, consulta Creare implementazioni e aggiornare le configurazioni dei componenti nella Guida per sviluppatori IoT AWS Greengrass V2.

Per eliminare la versione di un componente

L'delete-componentesempio seguente elimina un componente Hello World.

aws greengrassv2 delete-component \
    --arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Manage components nella AWS IoT Greengrass V2 Developer Guide.

Per eliminare un dispositivo principale

L'delete-core-deviceesempio seguente elimina un dispositivo principale AWS IoT Greengrass.

aws greengrassv2 delete-core-device \
    --core-device-thing-name MyGreengrassCore

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Disinstallare il software AWS IoT Greengrass Core nella Guida per sviluppatori IoT AWS Greengrass V2.

Per descrivere la versione di un componente

L'describe-componentesempio seguente descrive un componente Hello World.

aws greengrassv2 describe-component \
    --arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0

Output:

{
    "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0",
    "componentName": "com.example.HelloWorld",
    "componentVersion": "1.0.0",
    "creationTimestamp": "2021-01-07T17:12:11.133000-08:00",
    "publisher": "Amazon",
    "description": "My first AWS IoT Greengrass component.",
    "status": {
        "componentState": "DEPLOYABLE",
        "message": "NONE",
        "errors": {}
    },
    "platforms": [
        {
            "attributes": {
                "os": "linux"
            }
        }
    ]
}

Per ulteriori informazioni, consulta Manage components nella AWS IoT Greengrass V2 Developer Guide.

Per dissociare il ruolo di servizio Greengrass dal tuo account AWS

L'disassociate-service-role-from-accountesempio seguente dissocia il ruolo del servizio Greengrass da IoT Greengrass per il AWS tuo account. AWS

aws greengrassv2 disassociate-service-role-from-account

Output:

{
    "disassociatedAt": "2022-01-19T19:26:09Z"
}

Per ulteriori informazioni, consulta il ruolo del servizio Greengrass nella Guida per sviluppatori IoT AWS Greengrass V2.

Per URL scaricare un elemento componente

L'get-component-version-artifactesempio seguente consente di URL scaricare il file del componente della console di debug locale. JAR

aws greengrassv2 get-component-version-artifact \
    --arn arn:aws:greengrass:us-west-2:aws:components:aws.greengrass.LocalDebugConsole:versions:2.0.3 \
    --artifact-name "Uvt6ZEzQ9TKiAuLbfXBX_APdY0TWks3uc46tHFHTzBM=/aws.greengrass.LocalDebugConsole.jar"

Output:

{
    "preSignedUrl": "https://evergreencomponentmanageme-artifactbucket7410c9ef-g18n1iya8kwr.s3.us-west-2.amazonaws.com/public/aws.greengrass.LocalDebugConsole/2.0.3/s3/ggv2-component-releases-prod-pdx/EvergreenHttpDebugView/2ffc496ba41b39568968b22c582b4714a937193ee7687a45527238e696672521/aws.greengrass.LocalDebugConsole/aws.greengrass.LocalDebugConsole.jar?X-Amz-Security-Token=KwfLKSdEXAMPLE..."
}

Per ulteriori informazioni, consulta Manage components nella AWS IoT Greengrass V2 Developer Guide.

Esempio 1: scaricare la ricetta di un componente in YAML formato (Linux, macOS o Unix)

L'get-componentesempio seguente scarica la ricetta di un componente Hello World in un file in YAML formato. Questo comando funziona nel modo seguente:

Utilizza i --query parametri --output and per controllare l'output del comando. Questi parametri estraggono il blob della ricetta dall'output del comando. Per ulteriori informazioni sul controllo dell'output, vedere Controlling Command Output nella AWS Command Line Interface User Guide .Utilizza l'base64utilità. Questa utilità decodifica il blob estratto nel testo originale. Il blob restituito da un get-component comando riuscito è testo con codifica base64. È necessario decodificare questo blob per ottenere il testo originale. Salva il testo decodificato in un file. La sezione finale del comando (> com.example.HelloWorld-1.0.0.json) salva il testo decodificato in un file.

aws greengrassv2 get-component \
    --arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0 \
    --recipe-output-format YAML \
    --query recipe \
    --output text | base64 --decode > com.example.HelloWorld-1.0.0.json

Per ulteriori informazioni, consulta Manage components nella AWS IoT Greengrass V2 Developer Guide.

Esempio 2: Per scaricare la ricetta di un componente in YAML formato (Windows) CMD

L'get-componentesempio seguente scarica la ricetta di un componente Hello World in un file in YAML formato. Questo comando utilizza l'certutilutilità.

aws greengrassv2 get-component ^
    --arn arn:aws:greengrass:us-west-2:675946970638:components:com.example.HelloWorld:versions:1.0.0 ^
    --recipe-output-format YAML ^
    --query recipe ^
    --output text > com.example.HelloWorld-1.0.0.yaml.b64

certutil -decode com.example.HelloWorld-1.0.0.yaml.b64 com.example.HelloWorld-1.0.0.yaml

Per ulteriori informazioni, consulta Manage components nella AWS IoT Greengrass V2 Developer Guide.

Esempio 3: Per scaricare la ricetta di un componente in YAML formato (Windows) PowerShell

L'get-componentesempio seguente scarica la ricetta di un componente Hello World in un file in YAML formato. Questo comando utilizza l'certutilutilità.

aws greengrassv2 get-component `
    --arn arn:aws:greengrass:us-west-2:675946970638:components:com.example.HelloWorld:versions:1.0.0 `
    --recipe-output-format YAML `
    --query recipe `
    --output text > com.example.HelloWorld-1.0.0.yaml.b64

certutil -decode com.example.HelloWorld-1.0.0.yaml.b64 com.example.HelloWorld-1.0.0.yaml

Per ulteriori informazioni, consulta Manage components nella AWS IoT Greengrass V2 Developer Guide.

Per ottenere le informazioni sulla connettività per un dispositivo Greengrass core

L'get-connectivity-infoesempio seguente ottiene le informazioni di connettività per un dispositivo core Greengrass. I dispositivi client utilizzano queste informazioni per connettersi al MQTT broker che funziona su questo dispositivo principale.

aws greengrassv2 get-connectivity-info \
    --thing-name MyGreengrassCore

Output:

{
    "connectivityInfo": [
        {
            "id": "localIP_192.0.2.0",
            "hostAddress": "192.0.2.0",
            "portNumber": 8883
        }
    ]
}

Per ulteriori informazioni, consulta Manage core device endpoint nella AWS IoT Greengrass V2 Developer Guide.

Per ottenere un dispositivo principale

L'get-core-deviceesempio seguente ottiene informazioni su un dispositivo principale AWS IoT Greengrass.

aws greengrassv2 get-core-device \
    --core-device-thing-name MyGreengrassCore

Output:

{
    "coreDeviceThingName": "MyGreengrassCore",
    "coreVersion": "2.0.3",
    "platform": "linux",
    "architecture": "amd64",
    "status": "HEALTHY",
    "lastStatusUpdateTimestamp": "2021-01-08T04:57:58.838000-08:00",
    "tags": {}
}

Per ulteriori informazioni, consulta Verifica dello stato del dispositivo principale nella Guida per AWS sviluppatori IoT Greengrass V2.

Per ottenere una distribuzione

L'get-deploymentesempio seguente ottiene informazioni sull'implementazione del componente AWS IoT Greengrass nucleus su un gruppo di dispositivi principali.

aws greengrassv2 get-deployment \
    --deployment-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Output:

{
    "targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup",
    "revisionId": "14",
    "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "deploymentName": "Deployment for MyGreengrassCoreGroup",
    "deploymentStatus": "ACTIVE",
    "iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
    "iotJobArn": "arn:aws:iot:us-west-2:123456789012:job/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
    "components": {
        "aws.greengrass.Nucleus": {
            "componentVersion": "2.0.3",
            "configurationUpdate": {
                "merge": "{\"jvmOptions\":\"-Xmx64m\",\"logging\":{\"level\":\"WARN\"}}",
                "reset": [
                    "/networkProxy",
                    "/mqtt"
                ]
            }
        }
    },
    "deploymentPolicies": {
        "failureHandlingPolicy": "ROLLBACK",
        "componentUpdatePolicy": {
            "timeoutInSeconds": 60,
            "action": "NOTIFY_COMPONENTS"
        },
        "configurationValidationPolicy": {
            "timeoutInSeconds": 60
        }
    },
    "iotJobConfiguration": {},
    "creationTimestamp": "2021-01-07T17:21:20.691000-08:00",
    "isLatestForTarget": false,
    "tags": {}
}

Per ulteriori informazioni, consulta Distribuire i componenti sui dispositivi nella Guida per sviluppatori AWS IoT Greengrass V2.

Per ottenere il ruolo di servizio Greengrass per il tuo account AWS

L'get-service-role-for-accountesempio seguente ottiene il ruolo di servizio associato a AWS IoT Greengrass per il tuo AWS account.

aws greengrassv2 get-service-role-for-account

Output:

{
    "associatedAt": "2022-01-19T19:21:53Z",
    "roleArn": "arn:aws:iam::123456789012:role/service-role/Greengrass_ServiceRole"
}

Per ulteriori informazioni, consulta il ruolo del servizio Greengrass nella Guida per sviluppatori IoT AWS Greengrass V2.

Per elencare i dispositivi client associati a un dispositivo principale

L'list-client-devices-associated-with-core-deviceesempio seguente elenca tutti i dispositivi client associati a un dispositivo principale.

aws greengrassv2 list-client-devices-associated-with-core-device \
  --core-device-thing-name MyTestGreengrassCore

Output:

{
    "associatedClientDevices": [
        {
            "thingName": "MyClientDevice2",
            "associationTimestamp": "2021-07-12T16:33:55.843000-07:00"
        },
        {
            "thingName": "MyClientDevice1",
            "associationTimestamp": "2021-07-12T16:33:55.843000-07:00"
        }
    ]
}

Per ulteriori informazioni, consulta Interagire con i dispositivi IoT locali nella Guida per AWS sviluppatori IoT Greengrass V2.

Per elencare le versioni di un componente

L'list-component-versionsesempio seguente elenca tutte le versioni di un componente Hello World.

aws greengrassv2 list-component-versions \
    --arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld

Output:

{
    "componentVersions": [
        {
            "componentName": "com.example.HelloWorld",
            "componentVersion": "1.0.1",
            "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.1"
        },
        {
            "componentName": "com.example.HelloWorld",
            "componentVersion": "1.0.0",
            "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0"
        }
    ]
}

Per ulteriori informazioni, consulta Manage components nella AWS IoT Greengrass V2 Developer Guide.

Per elencare i componenti

L'list-componentsesempio seguente elenca ogni componente e la sua versione più recente definita nell' AWS account nella regione corrente.

aws greengrassv2 list-components

Output:

{
    "components": [
        {
            "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld",
            "componentName": "com.example.HelloWorld",
            "latestVersion": {
                "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.1",
                "componentVersion": "1.0.1",
                "creationTimestamp": "2021-01-08T16:51:07.352000-08:00",
                "description": "My first AWS IoT Greengrass component.",
                "publisher": "Amazon",
                "platforms": [
                    {
                        "attributes": {
                            "os": "linux"
                        }
                    }
                ]
            }
        }
    ]
}

Per ulteriori informazioni, consulta Manage components nella AWS IoT Greengrass V2 Developer Guide.

Per elencare i dispositivi principali

L'list-core-devicesesempio seguente elenca i dispositivi principali AWS IoT Greengrass presenti nel tuo AWS account nella regione corrente.

aws greengrassv2 list-core-devices

Output:

{
    "coreDevices": [
        {
            "coreDeviceThingName": "MyGreengrassCore",
            "status": "HEALTHY",
            "lastStatusUpdateTimestamp": "2021-01-08T04:57:58.838000-08:00"
        }
    ]
}

Per ulteriori informazioni, consulta Verifica dello stato del dispositivo principale nella Guida per AWS sviluppatori IoT Greengrass V2.

Per elencare le distribuzioni

L'list-deploymentsesempio seguente elenca la revisione più recente di ogni distribuzione definita nel tuo AWS account nella regione corrente.

aws greengrassv2 list-deployments

Output:

{
    "deployments": [
        {
            "targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup",
            "revisionId": "14",
            "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "deploymentName": "Deployment for MyGreengrassCoreGroup",
            "creationTimestamp": "2021-01-07T17:21:20.691000-08:00",
            "deploymentStatus": "ACTIVE",
            "isLatestForTarget": false
        },
        {
            "targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
            "revisionId": "1",
            "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "deploymentName": "Deployment for MyGreengrassCore",
            "creationTimestamp": "2021-01-06T16:10:42.407000-08:00",
            "deploymentStatus": "COMPLETED",
            "isLatestForTarget": false
        }
    ]
}

Per ulteriori informazioni, consulta Distribuire i componenti sui dispositivi nella Guida per sviluppatori AWS IoT Greengrass V2.

Per elencare i lavori di distribuzione

L'list-effective-deploymentsesempio seguente elenca le implementazioni che si applicano a un dispositivo core IoT AWS Greengrass.

aws greengrassv2 list-effective-deployments \
    --core-device-thing-name MyGreengrassCore

Output:

{
    "effectiveDeployments": [
        {
            "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "deploymentName": "Deployment for MyGreengrassCore",
            "iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
            "targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
            "coreDeviceExecutionStatus": "COMPLETED",
            "reason": "SUCCESSFUL",
            "creationTimestamp": "2021-01-06T16:10:42.442000-08:00",
            "modifiedTimestamp": "2021-01-08T17:21:27.830000-08:00"
        },
        {
            "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "deploymentName": "Deployment for MyGreengrassCoreGroup",
            "iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE44444",
            "iotJobArn": "arn:aws:iot:us-west-2:123456789012:job/a1b2c3d4-5678-90ab-cdef-EXAMPLE44444",
            "targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup",
            "coreDeviceExecutionStatus": "SUCCEEDED",
            "reason": "SUCCESSFUL",
            "creationTimestamp": "2021-01-07T17:19:20.394000-08:00",
            "modifiedTimestamp": "2021-01-07T17:21:20.721000-08:00"
        }
    ]
}

Per ulteriori informazioni, consulta Verifica dello stato del dispositivo principale nella Guida per AWS sviluppatori IoT Greengrass V2.

Per elencare i componenti installati su un dispositivo principale

L'list-installed-componentsesempio seguente elenca i componenti installati su un dispositivo core AWS IoT Greengrass.

aws greengrassv2 list-installed-components \
    --core-device-thing-name MyGreengrassCore

Output:

{
    "installedComponents": [
        {
            "componentName": "aws.greengrass.Cli",
            "componentVersion": "2.0.3",
            "lifecycleState": "RUNNING",
            "isRoot": true
        },
        {
            "componentName": "aws.greengrass.Nucleus",
            "componentVersion": "2.0.3",
            "lifecycleState": "FINISHED",
            "isRoot": true
        }
    ]
}

Per ulteriori informazioni, consulta Verifica dello stato del dispositivo principale nella Guida per AWS sviluppatori IoT Greengrass V2.

Per elencare i tag di una risorsa

L'list-tags-for-resourceesempio seguente elenca tutti i tag per un dispositivo core AWS IoT Greengrass.

aws greengrassv2 list-tags-for-resource \
    --resource-arn arn:aws:greengrass:us-west-2:123456789012:coreDevices:MyGreengrassCore

Output:

{
    "tags": {
        "Owner": "richard-roe"
    }
}

Per ulteriori informazioni, consulta Tagga le tue risorse nella Guida per gli AWS sviluppatori di IoT Greengrass V2.

Per aggiungere un tag a una risorsa

L'tag-resourceesempio seguente aggiunge un tag owner a un dispositivo core AWS IoT Greengrass. È possibile utilizzare questo tag per controllare l'accesso al dispositivo principale in base al proprietario.

aws greengrassv2 tag-resource \
    --resource-arn arn:aws:greengrass:us-west-2:123456789012:coreDevices:MyGreengrassCore \
    --tags Owner=richard-roe

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Tagga le tue risorse nella Guida per gli AWS sviluppatori di IoT Greengrass V2.

Per rimuovere un tag da una risorsa

L'untag-resourceesempio seguente rimuove un tag proprietario da un dispositivo principale AWS IoT Greengrass.

aws iotsitewise untag-resource \
    --resource-arn arn:aws:greengrass:us-west-2:123456789012:coreDevices:MyGreengrassCore \
    --tag-keys Owner

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Tagga le tue risorse nella Guida per gli AWS sviluppatori di IoT Greengrass V2.

Per aggiornare le informazioni di connettività per un dispositivo Greengrass core

L'update-connectivity-infoesempio seguente ottiene le informazioni di connettività per un dispositivo core Greengrass. I dispositivi client utilizzano queste informazioni per connettersi al MQTT broker che funziona su questo dispositivo principale.

aws greengrassv2 update-connectivity-info \
    --thing-name MyGreengrassCore \
    --cli-input-json file://core-device-connectivity-info.json

Contenuto di core-device-connectivity-info.json.

{
    "connectivityInfo": [
        {
            "hostAddress": "192.0.2.0",
            "portNumber": 8883,
            "id": "localIP_192.0.2.0"
        }
    ]
}

Output:

{
    "version": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Per ulteriori informazioni, consulta Manage core device endpoint nella AWS IoT Greengrass V2 Developer Guide.