AWS IoT Greengrass exemples utilisant AWS CLI - AWS Command Line Interface

Cette documentation concerne AWS CLI uniquement la version 1. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

AWS IoT Greengrass exemples utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with AWS IoT Greengrass.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous montrent comment appeler des fonctions de service individuelles, vous pouvez les visualiser dans leur contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utiliserassociate-role-to-group.

AWS CLI

Pour associer un rôle à un groupe Greengrass

L'associate-role-to-groupexemple suivant associe le IAM rôle spécifié à un groupe Greengrass. Le rôle de groupe est utilisé par les fonctions et connecteurs Lambda locaux pour accéder AWS aux services. Par exemple, votre rôle de groupe peut accorder les autorisations requises pour l'intégration CloudWatch des journaux.

aws greengrass associate-role-to-group \ --group-id 2494ee3f-7f8a-4e92-a78b-d205f808b84b \ --role-arn arn:aws:iam::123456789012:role/GG-Group-Role

Sortie :

{ "AssociatedAt": "2019-09-10T20:03:30Z" }

Pour plus d'informations, consultez la section Configurer le rôle de groupe dans le guide du développeur AWS IoT Greengrass.

L'exemple de code suivant montre comment utiliserassociate-service-role-to-account.

AWS CLI

Pour associer un rôle de service à votre AWS compte

L'associate-service-role-to-accountexemple suivant associe un rôle IAM de service, spécifié par son nomARN, à AWS IoT Greengrass dans votre AWS compte. Vous devez avoir préalablement créé le rôle de service dansIAM, et vous devez y associer un document de politique permettant à AWS IoT Greengrass d'assumer ce rôle.

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

Sortie :

{ "AssociatedAt": "2019-06-25T18:12:45Z" }

Pour plus d'informations, consultez Greengrass Service Role dans le guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utilisercreate-connector-definition-version.

AWS CLI

Pour créer une version de définition de connecteur

L'create-connector-definition-versionexemple suivant crée une version de définition de connecteur et l'associe à la définition de connecteur spécifiée. Tous les connecteurs d'une version définissent des valeurs pour leurs paramètres.

aws greengrass create-connector-definition-version \ --connector-definition-id "55d0052b-0d7d-44d6-b56f-21867215e118" \ --connectors "[{\"Id\": \"MyTwilioNotificationsConnector\", \"ConnectorArn\": \"arn:aws:greengrass:us-west-2::/connectors/TwilioNotifications/versions/2\", \"Parameters\": {\"TWILIO_ACCOUNT_SID\": \"AC1a8d4204890840d7fc482aab38090d57\", \"TwilioAuthTokenSecretArn\": \"arn:aws:secretsmanager:us-west-2:123456789012:secret:greengrass-TwilioAuthToken-ntSlp6\", \"TwilioAuthTokenSecretArn-ResourceId\": \"TwilioAuthToken\", \"DefaultFromPhoneNumber\": \"4254492999\"}}]"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/55d0052b-0d7d-44d6-b56f-21867215e118/versions/33f709a0-c825-49cb-9eea-dc8964fbd635", "CreationTimestamp": "2019-06-24T20:46:30.134Z", "Id": "55d0052b-0d7d-44d6-b56f-21867215e118", "Version": "33f709a0-c825-49cb-9eea-dc8964fbd635" }

L'exemple de code suivant montre comment utilisercreate-connector-definition.

AWS CLI

Pour créer une définition de connecteur

L'create-connector-definitionexemple suivant crée une définition de connecteur et une version de définition de connecteur initiale. La version initiale contient un connecteur. Tous les connecteurs d'une version définissent des valeurs pour leurs paramètres.

aws greengrass create-connector-definition \ --name MySNSConnector \ --initial-version "{\"Connectors\": [{\"Id\":\"MySNSConnector\",\"ConnectorArn\":\"arn:aws:greengrass:us-west-2::/connectors/SNS/versions/1\",\"Parameters\": {\"DefaultSNSArn\":\"arn:aws:sns:us-west-2:123456789012:GGConnectorTopic\"}}]}"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8", "CreationTimestamp": "2019-06-19T19:30:01.300Z", "Id": "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8", "LastUpdatedTimestamp": "2019-06-19T19:30:01.300Z", "LatestVersion": "63c57963-c7c2-4a26-a7e2-7bf478ea2623", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8/versions/63c57963-c7c2-4a26-a7e2-7bf478ea2623", "Name": "MySNSConnector" }

Pour plus d'informations, consultez Getting Started with Greengrass Connectors (CLI) dans le guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utilisercreate-core-definition-version.

AWS CLI

Pour créer une version de définition de base

L'create-core-definition-versionexemple suivant crée une version de définition de base et l'associe à la définition de base spécifiée. La version ne peut contenir qu'un seul noyau. Avant de créer un noyau, vous devez d'abord créer et approvisionner l'objet AWS IoT correspondant. Ce processus inclut les iot commandes suivantes, qui renvoient le ThingArn et CertificateArn requis pour la create-core-definition-version commande.

Créez l'objet AWS IoT correspondant à l'appareil principal :

aws iot create-thing \ --thing-name "MyCoreDevice"

Sortie :

{ "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyCoreDevice", "thingName": "MyCoreDevice", "thingId": "cb419a19-9099-4515-9cec-e9b0e760608a" }

Créez des clés publiques et privées ainsi que le certificat de périphérique principal pour l'objet. Cet exemple utilise la create-keys-and-certificate commande et nécessite des autorisations d'écriture sur le répertoire actuel. Vous pouvez également utiliser la create-certificate-from-csr commande.

aws iot create-keys-and-certificate \ --set-as-active \ --certificate-pem-outfile "myCore.cert.pem" \ --public-key-outfile "myCore.public.key" \ --private-key-outfile "myCore.private.key"

Sortie :

{ "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz", "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDWTCAkGgAwIBATgIUCgq6EGqou6zFqWgIZRndgQEFW+gwDQYJKoZIhvc...KdGewQS\n-----END CERTIFICATE-----\n", "keyPair": { "PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBzrqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqKpRgnn6yq26U3y...wIDAQAB\n-----END PUBLIC KEY-----\n", "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIABAKCAQEAqKpRgnn6yq26U3yt5YFZquyukfRjbMXDcNOK4rMCxDR...fvY4+te\n-----END RSA PRIVATE KEY-----\n" }, "certificateId": "123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz" }

Créez une politique AWS IoT qui autorise iot et prend greengrass des mesures. Pour des raisons de simplicité, la politique suivante autorise les actions sur toutes les ressources, mais votre politique doit être plus restrictive.

aws iot create-policy \ --policy-name "Core_Devices" \ --policy-document "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}"

Sortie :

{ "policyName": "Core_Devices", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/Core_Devices", "policyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}", "policyVersionId": "1" }

Joignez la politique au certificat :

aws iot attach-policy \ --policy-name "Core_Devices" \ --target "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz"

Cette commande ne produit aucun résultat.

Joignez l'objet au certificat :

aws iot attach-thing-principal \ --thing-name "MyCoreDevice" \ --principal "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz"

Cette commande ne produit aucun résultat.

Créez la version de définition de base :

aws greengrass create-core-definition-version \ --core-definition-id "582efe12-b05a-409e-9a24-a2ba1bcc4a12" \ --cores "[{\"Id\":\"MyCoreDevice\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/MyCoreDevice\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz\",\"SyncShadow\":true}]"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/582efe12-b05a-409e-9a24-a2ba1bcc4a12/versions/3fdc1190-2ce5-44de-b98b-eec8f9571014", "Version": "3fdc1190-2ce5-44de-b98b-eec8f9571014", "CreationTimestamp": "2019-09-18T00:15:09.838Z", "Id": "582efe12-b05a-409e-9a24-a2ba1bcc4a12" }

Pour plus d'informations, consultez la section Configurer le cœur AWS IoT Greengrass dans le Guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utilisercreate-core-definition.

AWS CLI

Exemple 1 : pour créer une définition de base vide

L'create-core-definitionexemple suivant crée une définition de base Greengrass vide (aucune version initiale). Avant que le noyau ne soit utilisable, vous devez utiliser la create-core-definition-version commande pour fournir les autres paramètres du noyau.

aws greengrass create-core-definition \ --name cliGroup_Core

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/b5c08008-54cb-44bd-9eec-c121b04283b5", "CreationTimestamp": "2019-06-25T18:23:22.106Z", "Id": "b5c08008-54cb-44bd-9eec-c121b04283b5", "LastUpdatedTimestamp": "2019-06-25T18:23:22.106Z", "Name": "cliGroup_Core" }

Exemple 2 : pour créer une définition de base avec une version initiale

L'create-core-definitionexemple suivant crée une définition de base qui contient une version de définition de base initiale. La version ne peut contenir qu'un seul noyau. Avant de créer un noyau, vous devez d'abord créer et approvisionner l'objet AWS IoT correspondant. Ce processus inclut les iot commandes suivantes, qui renvoient le ThingArn et CertificateArn requis pour la create-core-definition commande.

Créez l'objet AWS IoT correspondant à l'appareil principal :

aws iot create-thing \ --thing-name "MyCoreDevice"

Sortie :

{ "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyCoreDevice", "thingName": "MyCoreDevice", "thingId": "cb419a19-9099-4515-9cec-e9b0e760608a" }

Créez des clés publiques et privées ainsi que le certificat de périphérique principal pour l'objet. Cet exemple utilise la create-keys-and-certificate commande et nécessite des autorisations d'écriture sur le répertoire actuel. Vous pouvez également utiliser la create-certificate-from-csr commande.

aws iot create-keys-and-certificate \ --set-as-active \ --certificate-pem-outfile "myCore.cert.pem" \ --public-key-outfile "myCore.public.key" \ --private-key-outfile "myCore.private.key"

Sortie :

{ "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz", "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDWTCAkGgAwIBATgIUCgq6EGqou6zFqWgIZRndgQEFW+gwDQYJKoZIhvc...KdGewQS\n-----END CERTIFICATE-----\n", "keyPair": { "PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBzrqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqKpRgnn6yq26U3y...wIDAQAB\n-----END PUBLIC KEY-----\n", "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIABAKCAQEAqKpRgnn6yq26U3yt5YFZquyukfRjbMXDcNOK4rMCxDR...fvY4+te\n-----END RSA PRIVATE KEY-----\n" }, "certificateId": "123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz" }

Créez une politique AWS IoT qui autorise iot et prend greengrass des mesures. Pour des raisons de simplicité, la politique suivante autorise les actions sur toutes les ressources, mais votre politique doit être plus restrictive.

aws iot create-policy \ --policy-name "Core_Devices" \ --policy-document "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}"

Sortie :

{ "policyName": "Core_Devices", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/Core_Devices", "policyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}", "policyVersionId": "1" }

Joignez la politique au certificat :

aws iot attach-policy \ --policy-name "Core_Devices" \ --target "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz"

Cette commande ne produit aucun résultat.

Joignez l'objet au certificat :

aws iot attach-thing-principal \ --thing-name "MyCoreDevice" \ --principal "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz"

Cette commande ne produit aucun résultat.

Créez la définition de base :

aws greengrass create-core-definition \ --name "MyCores" \ --initial-version "{\"Cores\":[{\"Id\":\"MyCoreDevice\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/MyCoreDevice\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz\",\"SyncShadow\":true}]}"

Sortie :

{ "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/582efe12-b05a-409e-9a24-a2ba1bcc4a12/versions/cc87b5b3-8f4b-465d-944c-1d6de5dbfcdb", "Name": "MyCores", "LastUpdatedTimestamp": "2019-09-18T00:11:06.197Z", "LatestVersion": "cc87b5b3-8f4b-465d-944c-1d6de5dbfcdb", "CreationTimestamp": "2019-09-18T00:11:06.197Z", "Id": "582efe12-b05a-409e-9a24-a2ba1bcc4a12", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/582efe12-b05a-409e-9a24-a2ba1bcc4a12" }

Pour plus d'informations, consultez la section Configurer le cœur AWS IoT Greengrass dans le Guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utilisercreate-deployment.

AWS CLI

Pour créer un déploiement pour une version d'un groupe Greengrass

L'create-deploymentexemple suivant déploie la version spécifiée d'un groupe Greengrass.

aws greengrass create-deployment \ --deployment-type NewDeployment \ --group-id "ce2e7d01-3240-4c24-b8e6-f6f6e7a9eeca" \ --group-version-id "dc40c1e9-e8c8-4d28-a84d-a9cad5f599c9"

Sortie :

{ "DeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/ce2e7d01-3240-4c24-b8e6-f6f6e7a9eeca/deployments/bfceb608-4e97-45bc-af5c-460144270308", "DeploymentId": "bfceb608-4e97-45bc-af5c-460144270308" }

Pour plus d'informations, consultez Getting Started with Connectors (CLI) dans le guide du développeur AWS IoT Greengrass.

  • Pour API plus de détails, voir CreateDeploymentla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-device-definition-version.

AWS CLI

Pour créer une version de définition d'appareil

L'create-device-definition-versionexemple suivant crée une version de définition de périphérique et l'associe à la définition de périphérique spécifiée. La version définit deux appareils. Avant de créer un appareil Greengrass, vous devez d'abord créer et approvisionner l'objet AWS IoT correspondant. Ce processus inclut les iot commandes suivantes que vous devez exécuter pour obtenir les informations requises pour la commande Greengrass :

Créez l'objet AWS IoT correspondant à l'appareil :

aws iot create-thing \ --thing-name "InteriorTherm"

Sortie :

{ "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/InteriorTherm", "thingName": "InteriorTherm", "thingId": "01d4763c-78a6-46c6-92be-7add080394bf" }

Créez des clés publiques et privées ainsi que le certificat de périphérique correspondant à l'objet. Cet exemple utilise la create-keys-and-certificate commande et nécessite des autorisations d'écriture sur le répertoire actuel. Vous pouvez également utiliser la create-certificate-from-csr commande suivante :

aws iot create-keys-and-certificate \ --set-as-active \ --certificate-pem-outfile "myDevice.cert.pem" \ --public-key-outfile "myDevice.public.key" \ --private-key-outfile "myDevice.private.key"

Sortie :

{ "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92", "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDWTCAkGgAwIBATgIUCgq6EGqou6zFqWgIZRndgQEFW+gwDQYJKoZIhvc...KdGewQS\n-----END CERTIFICATE-----\n", "keyPair": { "PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBzrqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqKpRgnn6yq26U3y...wIDAQAB\n-----END PUBLIC KEY-----\n", "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIABAKCAQEAqKpRgnn6yq26U3yt5YFZquyukfRjbMXDcNOK4rMCxDR...fvY4+te\n-----END RSA PRIVATE KEY-----\n" }, "certificateId": "66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92" }

Créez une politique AWS IoT qui autorise iot et prend greengrass des mesures. Pour des raisons de simplicité, la politique suivante autorise des actions sur toutes les ressources, mais votre politique peut être plus restrictive :

aws iot create-policy \ --policy-name "GG_Devices" \ --policy-document "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}"

Sortie :

{ "policyName": "GG_Devices", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/GG_Devices", "policyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}", "policyVersionId": "1" }

Joignez la politique au certificat :

aws iot attach-policy \ --policy-name "GG_Devices" \ --target "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92"

Attachez l'objet au certificat

aws iot attach-thing-principal \ --thing-name "InteriorTherm" \ --principal "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92"

Après avoir créé et configuré l'objet IoT comme indiqué ci-dessus, utilisez ThingArn les deux premières commandes CertificateArn de l'exemple suivant.

aws greengrass create-device-definition-version \ --device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd" \ --devices "[{\"Id\":\"InteriorTherm\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/InteriorTherm\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92\",\"SyncShadow\":true},{\"Id\":\"ExteriorTherm\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/ExteriorTherm\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/6c52ce1b47bde88a637e9ccdd45fe4e4c2c0a75a6866f8f63d980ee22fa51e02\",\"SyncShadow\":true}]"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/83c13984-6fed-447e-84d5-5b8aa45d5f71", "Version": "83c13984-6fed-447e-84d5-5b8aa45d5f71", "CreationTimestamp": "2019-09-11T00:15:09.838Z", "Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd" }

L'exemple de code suivant montre comment utilisercreate-device-definition.

AWS CLI

Pour créer une définition d'appareil

L'create-device-definitionexemple suivant crée une définition de périphérique qui contient une version de définition de périphérique initiale. La version initiale définit deux appareils. Avant de créer un appareil Greengrass, vous devez d'abord créer et approvisionner l'objet AWS IoT correspondant. Ce processus inclut les iot commandes suivantes que vous devez exécuter pour obtenir les informations requises pour la commande Greengrass :

Créez l'objet AWS IoT correspondant à l'appareil :

aws iot create-thing \ --thing-name "InteriorTherm"

Sortie :

{ "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/InteriorTherm", "thingName": "InteriorTherm", "thingId": "01d4763c-78a6-46c6-92be-7add080394bf" }

Créez des clés publiques et privées ainsi que le certificat de périphérique correspondant à l'objet. Cet exemple utilise la create-keys-and-certificate commande et nécessite des autorisations d'écriture sur le répertoire actuel. Vous pouvez également utiliser la create-certificate-from-csr commande suivante :

aws iot create-keys-and-certificate \ --set-as-active \ --certificate-pem-outfile "myDevice.cert.pem" \ --public-key-outfile "myDevice.public.key" \ --private-key-outfile "myDevice.private.key"

Sortie :

{ "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92", "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDWTCAkGgAwIBATgIUCgq6EGqou6zFqWgIZRndgQEFW+gwDQYJKoZIhvc...KdGewQS\n-----END CERTIFICATE-----\n", "keyPair": { "PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBzrqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqKpRgnn6yq26U3y...wIDAQAB\n-----END PUBLIC KEY-----\n", "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIABAKCAQEAqKpRgnn6yq26U3yt5YFZquyukfRjbMXDcNOK4rMCxDR...fvY4+te\n-----END RSA PRIVATE KEY-----\n" }, "certificateId": "66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92" }

Créez une politique AWS IoT qui autorise iot et prend greengrass des mesures. Pour des raisons de simplicité, la politique suivante autorise des actions sur toutes les ressources, mais votre politique peut être plus restrictive :

aws iot create-policy \ --policy-name "GG_Devices" \ --policy-document "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}"

Sortie :

{ "policyName": "GG_Devices", "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/GG_Devices", "policyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}", "policyVersionId": "1" }

Joignez la politique au certificat :

aws iot attach-policy \ --policy-name "GG_Devices" \ --target "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92"

Attachez l'objet au certificat

aws iot attach-thing-principal \ --thing-name "InteriorTherm" \ --principal "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92"

Après avoir créé et configuré l'objet IoT comme indiqué ci-dessus, utilisez ThingArn les deux premières commandes CertificateArn de l'exemple suivant.

aws greengrass create-device-definition \ --name "Sensors" \ --initial-version "{\"Devices\":[{\"Id\":\"InteriorTherm\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/InteriorTherm\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92\",\"SyncShadow\":true},{\"Id\":\"ExteriorTherm\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/ExteriorTherm\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/6c52ce1b47bde88a637e9ccdd45fe4e4c2c0a75a6866f8f63d980ee22fa51e02\",\"SyncShadow\":true}]}"

Sortie :

{ "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/3b5cc510-58c1-44b5-9d98-4ad858ffa795", "Name": "Sensors", "LastUpdatedTimestamp": "2019-09-11T00:11:06.197Z", "LatestVersion": "3b5cc510-58c1-44b5-9d98-4ad858ffa795", "CreationTimestamp": "2019-09-11T00:11:06.197Z", "Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd" }

L'exemple de code suivant montre comment utilisercreate-function-definition-version.

AWS CLI

Pour créer une version de la définition de fonction

L'create-function-definition-versionexemple suivant crée une nouvelle version de la définition de fonction spécifiée. Cette version spécifie une fonction unique dont l'identifiant estHello-World-function, autorise l'accès au système de fichiers et spécifie une taille de mémoire maximale et un délai d'expiration.

aws greengrass create-function-definition-version \ --cli-input-json "{\"FunctionDefinitionId\": \"e626e8c9-3b8f-4bf3-9cdc-d26ecdeb9fa3\",\"Functions\": [{\"Id\": \"Hello-World-function\", \"FunctionArn\": \""arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld_Counter:gghw-alias"\",\"FunctionConfiguration\": {\"Environment\": {\"AccessSysfs\": true},\"Executable\": \"greengrassHelloWorldCounter.function_handler\",\"MemorySize\": 16000,\"Pinned\": false,\"Timeout\": 25}}]}"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/e626e8c9-3b8f-4bf3-9cdc-d26ecdeb9fa3/versions/74abd1cc-637e-4abe-8684-9a67890f4043", "CreationTimestamp": "2019-06-25T22:03:43.376Z", "Id": "e626e8c9-3b8f-4bf3-9cdc-d26ecdeb9fa3", "Version": "74abd1cc-637e-4abe-8684-9a67890f4043" }

L'exemple de code suivant montre comment utilisercreate-function-definition.

AWS CLI

Pour créer une définition de fonction Lambda

L'create-function-definitionexemple suivant crée une définition de fonction Lambda et une version initiale en fournissant une liste de fonctions Lambda (dans ce cas, une liste d'une seule fonction nomméeTempMonitorFunction) et leurs configurations. Avant de créer la définition de fonction, vous avez besoin de la fonction Lambda. ARN Pour créer la fonction et son alias, utilisez les publish-version commandes Lambda create-function et. La create-function commande Lambda nécessite le rôle ARN d'exécution, même si AWS IoT Greengrass n'utilise pas ce rôle car les autorisations sont spécifiées dans le rôle de groupe Greengrass. Vous pouvez utiliser la IAM create-role commande pour créer un rôle vide ARN à utiliser avec celui de Lambda create-function ou vous pouvez utiliser un rôle d'exécution existant.

aws greengrass create-function-definition \ --name MyGreengrassFunctions \ --initial-version "{\"Functions\": [{\"Id\": \"TempMonitorFunction\", \"FunctionArn\": \"arn:aws:lambda:us-west-2:123456789012:function:TempMonitor:GG_TempMonitor\", \"FunctionConfiguration\": {\"Executable\": \"temp_monitor.function_handler\", \"MemorySize\": 16000,\"Timeout\": 5}}]}"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/3b0d0080-87e7-48c6-b182-503ec743a08b", "CreationTimestamp": "2019-06-19T22:24:44.585Z", "Id": "3b0d0080-87e7-48c6-b182-503ec743a08b", "LastUpdatedTimestamp": "2019-06-19T22:24:44.585Z", "LatestVersion": "67f918b9-efb4-40b0-b87c-de8c9faf085b", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/3b0d0080-87e7-48c6-b182-503ec743a08b/versions/67f918b9-efb4-40b0-b87c-de8c9faf085b", "Name": "MyGreengrassFunctions" }

Pour plus d'informations, consultez Comment configurer l'accès aux ressources locales à l'aide de l'interface de ligne de AWS commande dans le guide du développeur AWS IoT Greengrass.

L'exemple de code suivant montre comment utilisercreate-group-certificate-authority.

AWS CLI

Pour créer une autorité de certification (CA) pour un groupe

L'create-group-certificate-authorityexemple suivant crée ou fait pivoter une autorité de certification pour le groupe spécifié.

aws greengrass create-group-certificate-authority \ --group-id "8eaadd72-ce4b-4f15-892a-0cc4f3a343f1"

Sortie :

{ "GroupCertificateAuthorityArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/8eaadd72-ce4b-4f15-892a-0cc4f3a343f1/certificateauthorities/d31630d674c4437f6c5dbc0dca56312a902171ce2d086c38e509c8EXAMPLEcc5" }

Pour plus d'informations, consultez AWS IoT Greengrass Security dans le guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utilisercreate-group-version.

AWS CLI

Pour créer une version d'un groupe Greengrass

L'create-group-versionexemple suivant crée une version de groupe et l'associe au groupe spécifié. La version fait référence aux versions de base, de ressource, de connecteur, de fonction et d'abonnement qui contiennent les entités à inclure dans cette version de groupe. Vous devez créer ces entités avant de créer la version du groupe.

Pour créer une définition de ressource avec une version initiale, utilisez la create-resource-definition commande.Pour créer une définition de connecteur avec une version initiale, utilisez la create-connector-definition commande.Pour créer une définition de fonction avec une version initiale, utilisez la create-function-definition commande.Pour créer une définition d'abonnement avec une version initiale, utilisez la create-subscription-definition commande.Pour récupérer la dernière version de définition ARN de base, utilisez la get-group-version commande et spécifiez l'ID de la dernière version du groupe.

aws greengrass create-group-version \ --group-id "ce2e7d01-3240-4c24-b8e6-f6f6e7a9eeca" \ --core-definition-version-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/6a630442-8708-4838-ad36-eb98849d975e/versions/6c87151b-1fb4-4cb2-8b31-6ee715d8f8ba" \ --resource-definition-version-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38/versions/a5f94d0b-f6bc-40f4-bb78-7a1c5fe13ba1" \ --connector-definition-version-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/55d0052b-0d7d-44d6-b56f-21867215e118/versions/78a3331b-895d-489b-8823-17b4f9f418a0" \ --function-definition-version-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/3b0d0080-87e7-48c6-b182-503ec743a08b/versions/67f918b9-efb4-40b0-b87c-de8c9faf085b" \ --subscription-definition-version-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/9d611d57-5d5d-44bd-a3b4-feccbdd69112/versions/aa645c47-ac90-420d-9091-8c7ffa4f103f"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/ce2e7d01-3240-4c24-b8e6-f6f6e7a9eeca/versions/e10b0459-4345-4a09-88a4-1af1f5d34638", "CreationTimestamp": "2019-06-20T18:42:47.020Z", "Id": "ce2e7d01-3240-4c24-b8e6-f6f6e7a9eeca", "Version": "e10b0459-4345-4a09-88a4-1af1f5d34638" }

Pour plus d'informations, consultez la section Présentation du modèle d'objet du groupe AWS IoT Greengrass dans le guide du développeur IoT AWS Greengrass.

  • Pour API plus de détails, voir CreateGroupVersionla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-group.

AWS CLI

Pour créer un groupe Greeengrass

L'create-groupexemple suivant crée un groupe nommécli-created-group.

aws greengrass create-group \ --name cli-created-group

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/4e22bd92-898c-436b-ade5-434d883ff749", "CreationTimestamp": "2019-06-25T18:07:17.688Z", "Id": "4e22bd92-898c-436b-ade5-434d883ff749", "LastUpdatedTimestamp": "2019-06-25T18:07:17.688Z", "Name": "cli-created-group" }

Pour plus d'informations, consultez la section Présentation du modèle d'objet du groupe AWS IoT Greengrass dans le guide du développeur IoT AWS Greengrass.

  • Pour API plus de détails, voir CreateGroupla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-logger-definition-version.

AWS CLI

Pour créer une version de définition de l'enregistreur

L'create-logger-definition-versionexemple suivant crée une version de définition d'enregistreur et l'associe à une définition d'enregistreur. La version définit quatre configurations de journalisation : 1) les journaux des composants système sur le système de fichiers du périphérique principal, 2) les journaux des fonctions Lambda définis par l'utilisateur sur le système de fichiers du périphérique principal, 3) les journaux des composants du système dans CloudWatch Amazon Logs et 4) les journaux des fonctions Lambda définis par l'utilisateur dans Amazon Logs. CloudWatch Remarque : pour l'intégration CloudWatch des journaux, votre rôle de groupe doit accorder les autorisations appropriées.

aws greengrass create-logger-definition-version \ --logger-definition-id "a454b62a-5d56-4ca9-bdc4-8254e1662cb0" \ --loggers "[{\"Id\":\"1\",\"Component\":\"GreengrassSystem\",\"Level\":\"ERROR\",\"Space\":10240,\"Type\":\"FileSystem\"},{\"Id\":\"2\",\"Component\":\"Lambda\",\"Level\":\"INFO\",\"Space\":10240,\"Type\":\"FileSystem\"},{\"Id\":\"3\",\"Component\":\"GreengrassSystem\",\"Level\":\"WARN\",\"Type\":\"AWSCloudWatch\"},{\"Id\":\"4\",\"Component\":\"Lambda\",\"Level\":\"INFO\",\"Type\":\"AWSCloudWatch\"}]"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/a454b62a-5d56-4ca9-bdc4-8254e1662cb0/versions/49aedb1e-01a3-4d39-9871-3a052573f1ea", "Version": "49aedb1e-01a3-4d39-9871-3a052573f1ea", "CreationTimestamp": "2019-07-24T00:04:48.523Z", "Id": "a454b62a-5d56-4ca9-bdc4-8254e1662cb0" }

Pour plus d'informations, consultez la section Surveillance à AWS l'aide des journaux IoT Greengrass dans le guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utilisercreate-logger-definition.

AWS CLI

Pour créer une définition d'enregistreur

L'create-logger-definitionexemple suivant crée une définition d'enregistreur qui contient une version de définition d'enregistreur initiale. La version initiale définit trois configurations de journalisation : 1) les journaux des composants du système sur le système de fichiers du périphérique principal, 2) les journaux des fonctions Lambda définis par l'utilisateur sur le système de fichiers du périphérique principal et 3) les journaux des fonctions Lambda définis par l'utilisateur dans Amazon Logs. CloudWatch Remarque : pour l'intégration CloudWatch des journaux, votre rôle de groupe doit accorder les autorisations appropriées.

aws greengrass create-logger-definition \ --name "LoggingConfigs" \ --initial-version "{\"Loggers\":[{\"Id\":\"1\",\"Component\":\"GreengrassSystem\",\"Level\":\"ERROR\",\"Space\":10240,\"Type\":\"FileSystem\"},{\"Id\":\"2\",\"Component\":\"Lambda\",\"Level\":\"INFO\",\"Space\":10240,\"Type\":\"FileSystem\"},{\"Id\":\"3\",\"Component\":\"Lambda\",\"Level\":\"INFO\",\"Type\":\"AWSCloudWatch\"}]}"

Sortie :

{ "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/a454b62a-5d56-4ca9-bdc4-8254e1662cb0/versions/de1d9854-1588-4525-b25e-b378f60f2322", "Name": "LoggingConfigs", "LastUpdatedTimestamp": "2019-07-23T23:52:17.165Z", "LatestVersion": "de1d9854-1588-4525-b25e-b378f60f2322", "CreationTimestamp": "2019-07-23T23:52:17.165Z", "Id": "a454b62a-5d56-4ca9-bdc4-8254e1662cb0", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/a454b62a-5d56-4ca9-bdc4-8254e1662cb0" }

Pour plus d'informations, consultez la section Surveillance à AWS l'aide des journaux IoT Greengrass dans le guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utilisercreate-resource-definition-version.

AWS CLI

Pour créer une version d'une définition de ressource

L'create-resource-definition-versionexemple suivant crée une nouvelle version d'un TwilioAuthToken.

aws greengrass create-resource-definition-version \ --resource-definition-id "c8bb9ebc-c3fd-40a4-9c6a-568d75569d38" \ --resources "[{\"Id\": \"TwilioAuthToken\",\"Name\": \"MyTwilioAuthToken\",\"ResourceDataContainer\": {\"SecretsManagerSecretResourceData\": {\"ARN\": \"arn:aws:secretsmanager:us-west-2:123456789012:secret:greengrass-TwilioAuthToken-ntSlp6\"}}}]"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38/versions/b3bcada0-5fb6-42df-bf0b-1ee4f15e769e", "CreationTimestamp": "2019-06-24T21:17:25.623Z", "Id": "c8bb9ebc-c3fd-40a4-9c6a-568d75569d38", "Version": "b3bcada0-5fb6-42df-bf0b-1ee4f15e769e" }

L'exemple de code suivant montre comment utilisercreate-resource-definition.

AWS CLI

Pour créer une définition de ressource

L'create-resource-definitionexemple suivant crée une définition de ressource qui contient une liste de ressources à utiliser dans un groupe Greengrass. Dans cet exemple, une version initiale de la définition de ressource est incluse en fournissant une liste de ressources. La liste inclut une ressource pour un jeton d'autorisation Twilio et une ressource ARN pour un secret stocké dans AWS Secrets Manager. Vous devez créer le secret avant de pouvoir créer la définition de ressource.

aws greengrass create-resource-definition \ --name MyGreengrassResources \ --initial-version "{\"Resources\": [{\"Id\": \"TwilioAuthToken\",\"Name\": \"MyTwilioAuthToken\",\"ResourceDataContainer\": {\"SecretsManagerSecretResourceData\": {\"ARN\": \"arn:aws:secretsmanager:us-west-2:123456789012:secret:greengrass-TwilioAuthToken-ntSlp6\"}}}]}"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38", "CreationTimestamp": "2019-06-19T21:51:28.212Z", "Id": "c8bb9ebc-c3fd-40a4-9c6a-568d75569d38", "LastUpdatedTimestamp": "2019-06-19T21:51:28.212Z", "LatestVersion": "a5f94d0b-f6bc-40f4-bb78-7a1c5fe13ba1", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38/versions/a5f94d0b-f6bc-40f4-bb78-7a1c5fe13ba1", "Name": "MyGreengrassResources" }

Pour plus d'informations, consultez Comment configurer l'accès aux ressources locales à l'aide de l'interface de ligne de AWS commande dans le guide du développeur AWS IoT Greengrass.

L'exemple de code suivant montre comment utilisercreate-software-update-job.

AWS CLI

Pour créer une tâche de mise à jour logicielle pour un noyau

L'create-software-update-jobexemple suivant crée une tâche de mise à jour over-the-air (OTA) pour mettre à jour le logiciel AWS IoT Greengrass Core sur le noyau dont le nom est. MyFirstGroup_Core Cette commande nécessite un IAM rôle qui autorise l'accès aux packages de mises à jour logicielles dans Amazon S3 et qui est inclus en iot.amazonaws.com tant qu'entité de confiance.

aws greengrass create-software-update-job \ --update-targets-architecture armv7l \ --update-targets [\"arn:aws:iot:us-west-2:123456789012:thing/MyFirstGroup_Core\"] \ --update-targets-operating-system raspbian \ --software-to-update core \ --s3-url-signer-role arn:aws:iam::123456789012:role/OTA_signer_role \ --update-agent-log-level WARN

Sortie :

{ "IotJobId": "GreengrassUpdateJob_30b353e3-3af7-4786-be25-4c446663c09e", "IotJobArn": "arn:aws:iot:us-west-2:123456789012:job/GreengrassUpdateJob_30b353e3-3af7-4786-be25-4c446663c09e", "PlatformSoftwareVersion": "1.9.3" }

Pour plus d'informations, consultez la section OTAMises à jour du logiciel AWS IoT Greengrass Core dans le guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utilisercreate-subscription-definition-version.

AWS CLI

Pour créer une nouvelle version d'une définition d'abonnement

L'create-subscription-definition-versionexemple suivant crée une nouvelle version d'une définition d'abonnement contenant trois abonnements : une notification de déclenchement, une entrée de température et un état de sortie.

aws greengrass create-subscription-definition-version \ --subscription-definition-id "9d611d57-5d5d-44bd-a3b4-feccbdd69112" \ --subscriptions "[{\"Id\": \"TriggerNotification\", \"Source\": \"arn:aws:lambda:us-west-2:123456789012:function:TempMonitor:GG_TempMonitor\", \"Subject\": \"twilio/txt\", \"Target\": \"arn:aws:greengrass:us-west-2::/connectors/TwilioNotifications/versions/1\"},{\"Id\": \"TemperatureInput\", \"Source\": \"cloud\", \"Subject\": \"temperature/input\", \"Target\": \"arn:aws:lambda:us-west-2:123456789012:function:TempMonitor:GG_TempMonitor\"},{\"Id\": \"OutputStatus\", \"Source\": \"arn:aws:greengrass:us-west-2::/connectors/TwilioNotifications/versions/1\", \"Subject\": \"twilio/message/status\", \"Target\": \"cloud\"}]"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/9d611d57-5d5d-44bd-a3b4-feccbdd69112/versions/7b65dfae-50b6-4d0f-b3e0-27728bfb0620", "CreationTimestamp": "2019-06-24T21:21:33.837Z", "Id": "9d611d57-5d5d-44bd-a3b4-feccbdd69112", "Version": "7b65dfae-50b6-4d0f-b3e0-27728bfb0620" }

L'exemple de code suivant montre comment utilisercreate-subscription-definition.

AWS CLI

Pour créer une définition d'abonnement

L'create-subscription-definitionexemple suivant crée une définition d'abonnement et spécifie sa version initiale. La version initiale contient trois abonnements : un pour le MQTT sujet auquel le connecteur est abonné, un pour autoriser une fonction à recevoir des relevés de température provenant de l' AWS IoT et un pour permettre à l' AWS IoT de recevoir des informations d'état du connecteur. L'exemple fournit l'alias de fonction ARN for Lambda créé précédemment à l'aide de la commande Lambda. create-alias

aws greengrass create-subscription-definition \ --initial-version "{\"Subscriptions\": [{\"Id\": \"TriggerNotification\", \"Source\": \"arn:aws:lambda:us-west-2:123456789012:function:TempMonitor:GG_TempMonitor\", \"Subject\": \"twilio/txt\", \"Target\": \"arn:aws:greengrass:us-west-2::/connectors/TwilioNotifications/versions/1\"},{\"Id\": \"TemperatureInput\", \"Source\": \"cloud\", \"Subject\": \"temperature/input\", \"Target\": \"arn:aws:lambda:us-west-2:123456789012:function:TempMonitor:GG_TempMonitor\"},{\"Id\": \"OutputStatus\", \"Source\": \"arn:aws:greengrass:us-west-2::/connectors/TwilioNotifications/versions/1\", \"Subject\": \"twilio/message/status\", \"Target\": \"cloud\"}]}"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/9d611d57-5d5d-44bd-a3b4-feccbdd69112", "CreationTimestamp": "2019-06-19T22:34:26.677Z", "Id": "9d611d57-5d5d-44bd-a3b4-feccbdd69112", "LastUpdatedTimestamp": "2019-06-19T22:34:26.677Z", "LatestVersion": "aa645c47-ac90-420d-9091-8c7ffa4f103f", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/9d611d57-5d5d-44bd-a3b4-feccbdd69112/versions/aa645c47-ac90-420d-9091-8c7ffa4f103f" }

Pour plus d'informations, consultez Getting Started with Connectors (CLI) dans le guide du développeur AWS IoT Greengrass.

L'exemple de code suivant montre comment utiliserdelete-connector-definition.

AWS CLI

Pour supprimer une définition de connecteur

L'delete-connector-definitionexemple suivant supprime la définition du connecteur Greengrass spécifiée. Si vous supprimez une définition de connecteur utilisée par un groupe, ce groupe ne peut pas être déployé correctement.

aws greengrass delete-connector-definition \ --connector-definition-id "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8"

Cette commande ne produit aucun résultat.

L'exemple de code suivant montre comment utiliserdelete-core-definition.

AWS CLI

Pour supprimer une définition de base

L'delete-core-definitionexemple suivant supprime la définition de base de Greengrass spécifiée, y compris toutes les versions. Si vous supprimez un noyau associé à un groupe Greengrass, ce groupe ne pourra pas être déployé correctement.

aws greengrass delete-core-definition \ --core-definition-id "ff36cc5f-9f98-4994-b468-9d9b6dc52abd"

Cette commande ne produit aucun résultat.

L'exemple de code suivant montre comment utiliserdelete-device-definition.

AWS CLI

Pour supprimer une définition d'appareil

L'delete-device-definitionexemple suivant supprime la définition de périphérique spécifiée, y compris toutes ses versions. Si vous supprimez une version de définition d'appareil utilisée par une version de groupe, la version de groupe ne peut pas être déployée correctement.

aws greengrass delete-device-definition \ --device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd"

Cette commande ne produit aucun résultat.

L'exemple de code suivant montre comment utiliserdelete-function-definition.

AWS CLI

Pour supprimer une définition de fonction

L'delete-function-definitionexemple suivant supprime la définition de fonction Greengrass spécifiée. Si vous supprimez une définition de fonction utilisée par un groupe, ce groupe ne peut pas être déployé correctement.

aws greengrass delete-function-definition \ --function-definition-id "fd4b906a-dff3-4c1b-96eb-52ebfcfac06a"

Cette commande ne produit aucun résultat.

L'exemple de code suivant montre comment utiliserdelete-group.

AWS CLI

Pour supprimer un groupe

L'delete-groupexemple suivant supprime le groupe Greengrass spécifié.

aws greengrass delete-group \ --group-id "4e22bd92-898c-436b-ade5-434d883ff749"

Cette commande ne produit aucun résultat.

  • Pour API plus de détails, voir DeleteGroupla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-logger-definition.

AWS CLI

Pour supprimer une définition d'enregistreur

L'delete-logger-definitionexemple suivant supprime la définition d'enregistreur spécifiée, y compris toutes les versions de définition d'enregistreur. Si vous supprimez une version de définition d'enregistreur utilisée par une version de groupe, la version de groupe ne peut pas être déployée correctement.

aws greengrass delete-logger-definition \ --logger-definition-id "a454b62a-5d56-4ca9-bdc4-8254e1662cb0"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Surveillance à AWS l'aide des journaux IoT Greengrass dans le guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utiliserdelete-resource-definition.

AWS CLI

Pour supprimer une définition de ressource

L'delete-resource-definitionexemple suivant supprime la définition de ressource spécifiée, y compris toutes les versions de ressources. Si vous supprimez une définition de ressource utilisée par un groupe, celui-ci ne peut pas être déployé correctement.

aws greengrass delete-resource-definition \ --resource-definition-id "ad8c101d-8109-4b0e-b97d-9cc5802ab658"

Cette commande ne produit aucun résultat.

L'exemple de code suivant montre comment utiliserdelete-subscription-definition.

AWS CLI

Pour supprimer une définition d'abonnement

L'delete-subscription-definitionexemple suivant supprime la définition d'abonnement Greengrass spécifiée. Si vous supprimez un abonnement utilisé par un groupe, celui-ci ne peut pas être déployé correctement.

aws greengrass delete-subscription-definition \ --subscription-definition-id "cd6f1c37-d9a4-4e90-be94-01a7404f5967"

Cette commande ne produit aucun résultat.

L'exemple de code suivant montre comment utiliserdisassociate-role-from-group.

AWS CLI

Pour dissocier le rôle d'un groupe Greengrass

L'disassociate-role-from-groupexemple suivant dissocie le IAM rôle du groupe Greengrass spécifié.

aws greengrass disassociate-role-from-group \ --group-id 2494ee3f-7f8a-4e92-a78b-d205f808b84b

Sortie :

{ "DisassociatedAt": "2019-09-10T20:05:49Z" }

Pour plus d'informations, consultez la section Configurer le rôle de groupe dans le guide du développeur AWS IoT Greengrass.

L'exemple de code suivant montre comment utiliserdisassociate-service-role-from-account.

AWS CLI

Pour dissocier un rôle de service de votre compte AWS

L'disassociate-service-role-from-accountexemple suivant supprime le rôle de service associé à votre AWS compte. Si vous n'utilisez le rôle de service dans aucune AWS région, utilisez la delete-role-policy commande pour détacher la politique AWSGreengrassResourceAccessRolePolicy gérée du rôle, puis utilisez la delete-role commande pour supprimer le rôle.

aws greengrass disassociate-service-role-from-account

Sortie :

{ "DisassociatedAt": "2019-06-25T22:12:55Z" }

Pour plus d'informations, consultez Greengrass Service Role dans le guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utiliserget-associated-role.

AWS CLI

Pour obtenir le rôle associé à un groupe Greengrass

L'get-associated-roleexemple suivant obtient le IAM rôle associé au groupe Greengrass spécifié. Le rôle de groupe est utilisé par les fonctions et connecteurs Lambda locaux pour accéder AWS aux services.

aws greengrass get-associated-role \ --group-id 2494ee3f-7f8a-4e92-a78b-d205f808b84b

Sortie :

{ "RoleArn": "arn:aws:iam::123456789012:role/GG-Group-Role", "AssociatedAt": "2019-09-10T20:03:30Z" }

Pour plus d'informations, consultez la section Configurer le rôle de groupe dans le guide du développeur AWS IoT Greengrass.

  • Pour API plus de détails, voir GetAssociatedRolela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-bulk-deployment-status.

AWS CLI

Pour vérifier l'état de votre déploiement en masse

L'get-bulk-deployment-statusexemple suivant récupère les informations d'état pour l'opération de déploiement en bloc spécifiée. Dans cet exemple, le fichier qui a spécifié les groupes à déployer possède un enregistrement d'entrée non valide.

aws greengrass get-bulk-deployment-status \ --bulk-deployment-id "870fb41b-6288-4e0c-bc76-a7ba4b4d3267"

Sortie :

{ "BulkDeploymentMetrics": { "InvalidInputRecords": 1, "RecordsProcessed": 1, "RetryAttempts": 0 }, "BulkDeploymentStatus": "Completed", "CreatedAt": "2019-06-25T16:11:33.265Z", "tags": {} }

Pour plus d'informations, consultez la section Créer des déploiements groupés pour les groupes dans le Guide du AWS développeur IoT Greengrass.

L'exemple de code suivant montre comment utiliserget-connectivity-info.

AWS CLI

Pour obtenir les informations de connectivité d'un noyau Greengrass

L'get-connectivity-infoexemple suivant montre les points de terminaison que les appareils peuvent utiliser pour se connecter au cœur Greengrass spécifié. Les informations de connectivité sont une liste d'adresses IP ou de noms de domaine, avec les numéros de port correspondants et les métadonnées facultatives définies par le client.

aws greengrass get-connectivity-info \ --thing-name "MyGroup_Core"

Sortie :

{ "ConnectivityInfo": [ { "Metadata": "", "PortNumber": 8883, "HostAddress": "127.0.0.1", "Id": "AUTOIP_127.0.0.1_0" }, { "Metadata": "", "PortNumber": 8883, "HostAddress": "192.168.1.3", "Id": "AUTOIP_192.168.1.3_1" }, { "Metadata": "", "PortNumber": 8883, "HostAddress": "::1", "Id": "AUTOIP_::1_2" }, { "Metadata": "", "PortNumber": 8883, "HostAddress": "fe80::1e69:ed93:f5b:f6d", "Id": "AUTOIP_fe80::1e69:ed93:f5b:f6d_3" } ] }
  • Pour API plus de détails, voir GetConnectivityInfola section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-connector-definition-version.

AWS CLI

Pour récupérer des informations sur une version spécifique d'une définition de connecteur

L'get-connector-definition-versionexemple suivant extrait des informations sur la version spécifiée de la définition de connecteur spécifiée. Pour récupérer toutes les versions de la définition du connecteur, utilisez la list-connector-definition-versions commande. IDs Pour récupérer l'ID de la dernière version ajoutée à la définition du connecteur, utilisez la get-connector-definition commande et vérifiez la LatestVersion propriété.

aws greengrass get-connector-definition-version \ --connector-definition-id "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8" \ --connector-definition-version-id "63c57963-c7c2-4a26-a7e2-7bf478ea2623"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8/versions/63c57963-c7c2-4a26-a7e2-7bf478ea2623", "CreationTimestamp": "2019-06-19T19:30:01.300Z", "Definition": { "Connectors": [ { "ConnectorArn": "arn:aws:greengrass:us-west-2::/connectors/SNS/versions/1", "Id": "MySNSConnector", "Parameters": { "DefaultSNSArn": "arn:aws:sns:us-west-2:123456789012:GGConnectorTopic" } } ] }, "Id": "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8", "Version": "63c57963-c7c2-4a26-a7e2-7bf478ea2623" }

Pour plus d'informations, consultez la section Intégrer aux services et aux protocoles à l'aide des connecteurs Greengrass dans le guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utiliserget-connector-definition.

AWS CLI

Pour récupérer des informations sur la définition d'un connecteur

L'get-connector-definitionexemple suivant extrait des informations sur la définition de connecteur spécifiée. Pour récupérer les définitions IDs de vos connecteurs, utilisez la list-connector-definitions commande.

aws greengrass get-connector-definition \ --connector-definition-id "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8", "CreationTimestamp": "2019-06-19T19:30:01.300Z", "Id": "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8", "LastUpdatedTimestamp": "2019-06-19T19:30:01.300Z", "LatestVersion": "63c57963-c7c2-4a26-a7e2-7bf478ea2623", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8/versions/63c57963-c7c2-4a26-a7e2-7bf478ea2623", "Name": "MySNSConnector", "tags": {} }

Pour plus d'informations, consultez la section Intégrer aux services et aux protocoles à l'aide des connecteurs Greengrass dans le guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utiliserget-core-definition-version.

AWS CLI

Pour récupérer des informations sur une version spécifique de la définition de base de Greengrass

L'get-core-definition-versionexemple suivant extrait des informations sur la version spécifiée de la définition de base spécifiée. Pour récupérer toutes les versions de la définition de base, utilisez la list-core-definition-versions commande. IDs Pour récupérer l'ID de la dernière version ajoutée à la définition de base, utilisez la get-core-definition commande et vérifiez la LatestVersion propriété.

aws greengrass get-core-definition-version \ --core-definition-id "c906ed39-a1e3-4822-a981-7b9bd57b4b46" \ --core-definition-version-id "42aeeac3-fd9d-4312-a8fd-ffa9404a20e0"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/c906ed39-a1e3-4822-a981-7b9bd57b4b46/versions/42aeeac3-fd9d-4312-a8fd-ffa9404a20e0", "CreationTimestamp": "2019-06-18T16:21:21.351Z", "Definition": { "Cores": [ { "CertificateArn": "arn:aws:iot:us-west-2:123456789012:cert/928dea7b82331b47c3ff77b0e763fc5e64e2f7c884e6ef391baed9b6b8e21b45", "Id": "1a39aac7-0885-4417-91f6-23e4cea6c511", "SyncShadow": false, "ThingArn": "arn:aws:iot:us-west-2:123456789012:thing/GGGroup4Pi3_Core" } ] }, "Id": "c906ed39-a1e3-4822-a981-7b9bd57b4b46", "Version": "42aeeac3-fd9d-4312-a8fd-ffa9404a20e0" }

L'exemple de code suivant montre comment utiliserget-core-definition.

AWS CLI

Pour récupérer les détails d'une définition de base de Greengrass

L'get-core-definitionexemple suivant extrait des informations sur la définition de base spécifiée. Pour récupérer les définitions IDs de base, utilisez la list-core-definitions commande.

aws greengrass get-core-definition \ --core-definition-id "c906ed39-a1e3-4822-a981-7b9bd57b4b46"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/237d6916-27cf-457f-ba0c-e86cfb5d25cd", "CreationTimestamp": "2018-10-18T04:47:06.721Z", "Id": "237d6916-27cf-457f-ba0c-e86cfb5d25cd", "LastUpdatedTimestamp": "2018-10-18T04:47:06.721Z", "LatestVersion": "bd2cd6d4-2bc5-468a-8962-39e071e34b68", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/237d6916-27cf-457f-ba0c-e86cfb5d25cd/versions/bd2cd6d4-2bc5-468a-8962-39e071e34b68", "tags": {} }
  • Pour API plus de détails, voir GetCoreDefinitionla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-deployment-status.

AWS CLI

Pour récupérer le statut d'un déploiement

L'get-deployment-statusexemple suivant récupère le statut du déploiement spécifié du groupe Greengrass spécifié. Pour obtenir l'ID de déploiement, utilisez la list-deployments commande et spécifiez l'ID de groupe.

aws greengrass get-deployment-status \ --group-id "1013db12-8b58-45ff-acc7-704248f66731" \ --deployment-id "1065b8a0-812b-4f21-9d5d-e89b232a530f"

Sortie :

{ "DeploymentStatus": "Success", "DeploymentType": "NewDeployment", "UpdatedAt": "2019-06-18T17:04:44.761Z" }
  • Pour API plus de détails, voir GetDeploymentStatusla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-device-definition-version.

AWS CLI

Pour obtenir une version de définition de l'appareil

L'get-device-definition-versionexemple suivant extrait des informations sur la version spécifiée de la définition de périphérique spécifiée. Pour récupérer toutes les versions de la définition du périphérique, utilisez la list-device-definition-versions commande. IDs Pour récupérer l'ID de la dernière version ajoutée à la définition de l'appareil, utilisez la get-device-definition commande et vérifiez la LatestVersion propriété.

aws greengrass get-device-definition-version \ --device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd" \ --device-definition-version-id "83c13984-6fed-447e-84d5-5b8aa45d5f71"

Sortie :

{ "Definition": { "Devices": [ { "CertificateArn": "arn:aws:iot:us-west-2:123456789012:cert/6c52ce1b47bde88a637e9ccdd45fe4e4c2c0a75a6866f8f63d980ee22fa51e02", "ThingArn": "arn:aws:iot:us-west-2:123456789012:thing/ExteriorTherm", "SyncShadow": true, "Id": "ExteriorTherm" }, { "CertificateArn": "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92", "ThingArn": "arn:aws:iot:us-west-2:123456789012:thing/InteriorTherm", "SyncShadow": true, "Id": "InteriorTherm" } ] }, "Version": "83c13984-6fed-447e-84d5-5b8aa45d5f71", "CreationTimestamp": "2019-09-11T00:15:09.838Z", "Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/83c13984-6fed-447e-84d5-5b8aa45d5f71" }

L'exemple de code suivant montre comment utiliserget-device-definition.

AWS CLI

Pour obtenir une définition d'appareil

L'get-device-definitionexemple suivant permet de récupérer des informations sur la définition de périphérique spécifiée. Pour récupérer les définitions IDs de votre appareil, utilisez la list-device-definitions commande.

aws greengrass get-device-definition \ --device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd"

Sortie :

{ "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/83c13984-6fed-447e-84d5-5b8aa45d5f71", "Name": "TemperatureSensors", "tags": {}, "LastUpdatedTimestamp": "2019-09-11T00:19:03.698Z", "LatestVersion": "83c13984-6fed-447e-84d5-5b8aa45d5f71", "CreationTimestamp": "2019-09-11T00:11:06.197Z", "Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd" }
  • Pour API plus de détails, voir GetDeviceDefinitionla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-function-definition-version.

AWS CLI

Pour récupérer des informations sur une version spécifique d'une fonction Lambda

Ce qui suit get-function-definition-version permet de récupérer des informations sur la version spécifiée de la définition de fonction spécifiée. Pour récupérer toutes les versions de la définition de fonction, utilisez la list-function-definition-versions commande. IDs Pour récupérer l'ID de la dernière version ajoutée à la définition de la fonction, utilisez la get-function-definition commande et vérifiez la LatestVersion propriété.

aws greengrass get-function-definition-version \ --function-definition-id "063f5d1a-1dd1-40b4-9b51-56f8993d0f85" \ --function-definition-version-id "9748fda7-1589-4fcc-ac94-f5559e88678b"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9748fda7-1589-4fcc-ac94-f5559e88678b", "CreationTimestamp": "2019-06-18T17:04:30.776Z", "Definition": { "Functions": [ { "FunctionArn": "arn:aws:lambda:::function:GGIPDetector:1", "FunctionConfiguration": { "Environment": {}, "MemorySize": 32768, "Pinned": true, "Timeout": 3 }, "Id": "26b69bdb-e547-46bc-9812-84ec04b6cc8c" }, { "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:GG_HelloWorld", "FunctionConfiguration": { "EncodingType": "json", "Environment": { "Variables": {} }, "MemorySize": 16384, "Pinned": true, "Timeout": 25 }, "Id": "384465a8-eedf-48c6-b793-4c35f7bfae9b" } ] }, "Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "Version": "9748fda7-1589-4fcc-ac94-f5559e88678b" }

L'exemple de code suivant montre comment utiliserget-function-definition.

AWS CLI

Pour récupérer une définition de fonction

L'get-function-definitionexemple suivant affiche les détails de la définition de fonction spécifiée. Pour récupérer les définitions IDs de vos fonctions, utilisez la list-function-definitions commande.

aws greengrass get-function-definition \ --function-definition-id "063f5d1a-1dd1-40b4-9b51-56f8993d0f85"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "CreationTimestamp": "2019-06-18T16:21:21.431Z", "Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "LastUpdatedTimestamp": "2019-06-18T16:21:21.431Z", "LatestVersion": "9748fda7-1589-4fcc-ac94-f5559e88678b", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9748fda7-1589-4fcc-ac94-f5559e88678b", "tags": {} }

L'exemple de code suivant montre comment utiliserget-group-certificate-authority.

AWS CLI

Pour récupérer l'autorité de certification associée à un groupe Greengrass

L'get-group-certificate-authorityexemple suivant récupère l'autorité de certification (CA) associée au groupe Greengrass spécifié. Pour obtenir l'ID de l'autorité de certification, utilisez la list-group-certificate-authorities commande et spécifiez l'ID du groupe.

aws greengrass get-group-certificate-authority \ --group-id "1013db12-8b58-45ff-acc7-704248f66731" \ --certificate-authority-id "f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6"

Sortie :

{ "GroupCertificateAuthorityArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/certificateauthorities/f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6", "GroupCertificateAuthorityId": "f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6", "PemEncodedCertificate": "-----BEGIN CERTIFICATE----- MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBWEXAMPLEGA1UEBhMC VVMxCzAJBgNVBAgTAldBMRAwDEXAMPLEEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6 b24xFDASBgNVBAEXAMPLESBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jEXAMPLENMTEwNDI1MjA0NTIxWhcN MTIwNDI0MjA0EXAMPLEBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWEXAMPLEDASBgNVBAsTC0lBTSBDb25z b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWEXAMPLEgkqhkiG9w0BCQEWEG5vb25lQGFt YXpvbi5EXAMPLE8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ 21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CEXAMPLE93vUEIO3IyNoH/f0wYK8m9T rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswYEXAMPLEgpE Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKEXAMPLEAQEFBQADgYEAtCu4 nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE= -----END CERTIFICATE-----\n" }

L'exemple de code suivant montre comment utiliserget-group-certificate-configuration.

AWS CLI

Pour récupérer la configuration de l'autorité de certification utilisée par le groupe Greengrass

L'get-group-certificate-configurationexemple suivant récupère la configuration de l'autorité de certification (CA) utilisée par le groupe Greengrass spécifié.

aws greengrass get-group-certificate-configuration \ --group-id "1013db12-8b58-45ff-acc7-704248f66731"

Sortie :

{ "CertificateAuthorityExpiryInMilliseconds": 2524607999000, "CertificateExpiryInMilliseconds": 604800000, "GroupId": "1013db12-8b58-45ff-acc7-704248f66731" }

L'exemple de code suivant montre comment utiliserget-group-version.

AWS CLI

Pour récupérer des informations sur une version d'un groupe Greengrass

L'get-group-versionexemple suivant extrait des informations sur la version spécifiée du groupe spécifié. Pour récupérer toutes les versions du groupe, utilisez la list-group-versions commande. IDs Pour récupérer l'ID de la dernière version ajoutée au groupe, utilisez la get-group commande et vérifiez la LatestVersion propriété.

aws greengrass get-group-version \ --group-id "1013db12-8b58-45ff-acc7-704248f66731" \ --group-version-id "115136b3-cfd7-4462-b77f-8741a4b00e5e"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/115136b3-cfd7-4462-b77f-8741a4b00e5e", "CreationTimestamp": "2019-06-18T17:04:30.915Z", "Definition": { "CoreDefinitionVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/c906ed39-a1e3-4822-a981-7b9bd57b4b46/versions/42aeeac3-fd9d-4312-a8fd-ffa9404a20e0", "FunctionDefinitionVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9748fda7-1589-4fcc-ac94-f5559e88678b", "SubscriptionDefinitionVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/88ae8699-12ac-4663-ba3f-4d7f0519140b" }, "Id": "1013db12-8b58-45ff-acc7-704248f66731", "Version": "115136b3-cfd7-4462-b77f-8741a4b00e5e" }
  • Pour API plus de détails, voir GetGroupVersionla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-group.

AWS CLI

Pour récupérer des informations sur un groupe Greengrass

L'get-groupexemple suivant permet de récupérer des informations sur le groupe Greengrass spécifié. Pour récupérer vos groupes, utilisez la list-groups commande. IDs

aws greengrass get-group \ --group-id "1013db12-8b58-45ff-acc7-704248f66731"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731", "CreationTimestamp": "2019-06-18T16:21:21.457Z", "Id": "1013db12-8b58-45ff-acc7-704248f66731", "LastUpdatedTimestamp": "2019-06-18T16:21:21.457Z", "LatestVersion": "115136b3-cfd7-4462-b77f-8741a4b00e5e", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/115136b3-cfd7-4462-b77f-8741a4b00e5e", "Name": "GGGroup4Pi3", "tags": {} }
  • Pour API plus de détails, voir GetGroupla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-logger-definition-version.

AWS CLI

Pour récupérer des informations sur une version d'une définition d'enregistreur

L'get-logger-definition-versionexemple suivant récupère des informations sur la version spécifiée de la définition d'enregistreur spécifiée. Pour récupérer toutes les versions IDs de la définition de l'enregistreur, utilisez la list-logger-definition-versions commande. Pour récupérer l'ID de la dernière version ajoutée à la définition de l'enregistreur, utilisez la get-logger-definition commande et vérifiez la LatestVersion propriété.

aws greengrass get-logger-definition-version \ --logger-definition-id "49eeeb66-f1d3-4e34-86e3-3617262abf23" \ --logger-definition-version-id "5e3f6f64-a565-491e-8de0-3c0d8e0f2073"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23/versions/5e3f6f64-a565-491e-8de0-3c0d8e0f2073", "CreationTimestamp": "2019-05-08T16:10:13.866Z", "Definition": { "Loggers": [] }, "Id": "49eeeb66-f1d3-4e34-86e3-3617262abf23", "Version": "5e3f6f64-a565-491e-8de0-3c0d8e0f2073" }

L'exemple de code suivant montre comment utiliserget-logger-definition.

AWS CLI

Pour récupérer des informations sur la définition d'un enregistreur

L'get-logger-definitionexemple suivant récupère des informations sur la définition de l'enregistreur spécifiée. Pour récupérer les définitions IDs de votre enregistreur, utilisez la list-logger-definitions commande.

aws greengrass get-logger-definition \ --logger-definition-id "49eeeb66-f1d3-4e34-86e3-3617262abf23"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23", "CreationTimestamp": "2019-05-08T16:10:13.809Z", "Id": "49eeeb66-f1d3-4e34-86e3-3617262abf23", "LastUpdatedTimestamp": "2019-05-08T16:10:13.809Z", "LatestVersion": "5e3f6f64-a565-491e-8de0-3c0d8e0f2073", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23/versions/5e3f6f64-a565-491e-8de0-3c0d8e0f2073", "tags": {} }
  • Pour API plus de détails, voir GetLoggerDefinitionla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-resource-definition-version.

AWS CLI

Pour récupérer des informations sur une version spécifique d'une définition de ressource

L'get-resource-definition-versionexemple suivant extrait des informations sur la version spécifiée de la définition de ressource spécifiée. Pour récupérer toutes les versions de la définition de ressource, utilisez la list-resource-definition-versions commande. IDs Pour récupérer l'ID de la dernière version ajoutée à la définition de ressource, utilisez la get-resource-definition commande et vérifiez la LatestVersion propriété.

aws greengrass get-resource-definition-version \ --resource-definition-id "ad8c101d-8109-4b0e-b97d-9cc5802ab658" \ --resource-definition-version-id "26e8829a-491a-464d-9c87-664bf6f6f2be"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658/versions/26e8829a-491a-464d-9c87-664bf6f6f2be", "CreationTimestamp": "2019-06-19T16:40:59.392Z", "Definition": { "Resources": [ { "Id": "26ff3f7b-839a-4217-9fdc-a218308b3963", "Name": "usb-port", "ResourceDataContainer": { "LocalDeviceResourceData": { "GroupOwnerSetting": { "AutoAddGroupOwner": false }, "SourcePath": "/dev/bus/usb" } } } ] }, "Id": "ad8c101d-8109-4b0e-b97d-9cc5802ab658", "Version": "26e8829a-491a-464d-9c87-664bf6f6f2be" }

L'exemple de code suivant montre comment utiliserget-resource-definition.

AWS CLI

Pour récupérer des informations sur une définition de ressource

L'get-resource-definitionexemple suivant extrait des informations sur la définition de ressource spécifiée. Pour récupérer les définitions IDs de vos ressources, utilisez la list-resource-definitions commande.

aws greengrass get-resource-definition \ --resource-definition-id "ad8c101d-8109-4b0e-b97d-9cc5802ab658"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658", "CreationTimestamp": "2019-06-19T16:40:59.261Z", "Id": "ad8c101d-8109-4b0e-b97d-9cc5802ab658", "LastUpdatedTimestamp": "2019-06-19T16:40:59.261Z", "LatestVersion": "26e8829a-491a-464d-9c87-664bf6f6f2be", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658/versions/26e8829a-491a-464d-9c87-664bf6f6f2be", "tags": {} }

L'exemple de code suivant montre comment utiliserget-service-role-for-account.

AWS CLI

Pour récupérer les détails du rôle de service associé à votre compte

L'get-service-role-for-accountexemple suivant permet de récupérer des informations sur le rôle de service associé à votre AWS compte.

aws greengrass get-service-role-for-account

Sortie :

{ "AssociatedAt": "2018-10-18T15:59:20Z", "RoleArn": "arn:aws:iam::123456789012:role/service-role/Greengrass_ServiceRole" }

Pour plus d'informations, consultez Greengrass Service Role dans le guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utiliserget-subscription-definition-version.

AWS CLI

Pour récupérer des informations sur une version spécifique d'une définition d'abonnement

L'get-subscription-definition-versionexemple suivant récupère des informations sur la version spécifiée de la définition d'abonnement spécifiée. Pour récupérer toutes les versions de la définition d'abonnement, utilisez la list-subscription-definition-versions commande. IDs Pour récupérer l'ID de la dernière version ajoutée à la définition de l'abonnement, utilisez la get-subscription-definition commande et vérifiez la LatestVersion propriété.

aws greengrass get-subscription-definition-version \ --subscription-definition-id "70e49321-83d5-45d2-bc09-81f4917ae152" \ --subscription-definition-version-id "88ae8699-12ac-4663-ba3f-4d7f0519140b"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/88ae8699-12ac-4663-ba3f-4d7f0519140b", "CreationTimestamp": "2019-06-18T17:03:52.499Z", "Definition": { "Subscriptions": [ { "Id": "692c4484-d89f-4f64-8edd-1a041a65e5b6", "Source": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:GG_HelloWorld", "Subject": "hello/world", "Target": "cloud" } ] }, "Id": "70e49321-83d5-45d2-bc09-81f4917ae152", "Version": "88ae8699-12ac-4663-ba3f-4d7f0519140b" }

L'exemple de code suivant montre comment utiliserget-subscription-definition.

AWS CLI

Pour récupérer des informations sur la définition d'un abonnement

L'get-subscription-definitionexemple suivant permet de récupérer des informations sur la définition d'abonnement spécifiée. Pour récupérer les définitions IDs de votre abonnement, utilisez la list-subscription-definitions commande.

aws greengrass get-subscription-definition \ --subscription-definition-id "70e49321-83d5-45d2-bc09-81f4917ae152"

Sortie :

{ "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152", "CreationTimestamp": "2019-06-18T17:03:52.392Z", "Id": "70e49321-83d5-45d2-bc09-81f4917ae152", "LastUpdatedTimestamp": "2019-06-18T17:03:52.392Z", "LatestVersion": "88ae8699-12ac-4663-ba3f-4d7f0519140b", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/88ae8699-12ac-4663-ba3f-4d7f0519140b", "tags": {} }

L'exemple de code suivant montre comment utiliserget-thing-runtime-configuration.

AWS CLI

Pour récupérer la configuration d'exécution d'un noyau Greengrass

L'get-thing-runtime-configurationexemple suivant récupère la configuration d'exécution d'un noyau Greengrass. Avant de pouvoir récupérer la configuration d'exécution, vous devez utiliser la update-thing-runtime-configuration commande pour créer une configuration d'exécution pour le noyau.

aws greengrass get-thing-runtime-configuration \ --thing-name SampleGreengrassCore

Sortie :

{ "RuntimeConfiguration": { "TelemetryConfiguration": { "ConfigurationSyncStatus": "OutOfSync", "Telemetry": "On" } } }

Pour plus d'informations, consultez la section Configuration des paramètres de télémétrie dans le manuel IoT AWS Greengrass Developer Guide.

L'exemple de code suivant montre comment utiliserlist-bulk-deployment-detailed-reports.

AWS CLI

Pour répertorier les informations relatives aux déploiements individuels dans le cadre d'un déploiement en masse

L'list-bulk-deployment-detailed-reportsexemple suivant affiche des informations sur les déploiements individuels dans le cadre d'une opération de déploiement en masse, y compris le statut.

aws greengrass list-bulk-deployment-detailed-reports \ --bulk-deployment-id 42ce9c42-489b-4ed4-b905-8996aa50ef9d

Sortie :

{ "Deployments": [ { "DeploymentType": "NewDeployment", "DeploymentStatus": "Success", "DeploymentId": "123456789012:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "DeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-EXAMPLE33333/deployments/123456789012:123456789012:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "GroupArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-EXAMPLE33333/versions/123456789012:a1b2c3d4-5678-90ab-cdef-EXAMPLE44444", "CreatedAt": "2020-01-21T21:34:16.501Z" }, { "DeploymentType": "NewDeployment", "DeploymentStatus": "InProgress", "DeploymentId": "123456789012:a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "DeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-EXAMPLE55555/deployments/123456789012:123456789012:a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "GroupArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-EXAMPLE55555/versions/a1b2c3d4-5678-90ab-cdef-EXAMPLE66666", "CreatedAt": "2020-01-21T21:34:16.486Z" }, ... ] }

Pour plus d'informations, consultez la section Créer des déploiements groupés pour les groupes dans le Guide du AWS développeur IoT Greengrass.

L'exemple de code suivant montre comment utiliserlist-bulk-deployments.

AWS CLI

Pour répertorier les déploiements groupés

L'list-bulk-deploymentsexemple suivant répertorie tous les déploiements en masse.

aws greengrass list-bulk-deployments

Sortie :

{ "BulkDeployments": [ { "BulkDeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/bulk/deployments/870fb41b-6288-4e0c-bc76-a7ba4b4d3267", "BulkDeploymentId": "870fb41b-6288-4e0c-bc76-a7ba4b4d3267", "CreatedAt": "2019-06-25T16:11:33.265Z" } ] }

Pour plus d'informations, consultez la section Créer des déploiements groupés pour les groupes dans le Guide du AWS développeur IoT Greengrass.

  • Pour API plus de détails, voir ListBulkDeploymentsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-connector-definition-versions.

AWS CLI

Pour répertorier les versions disponibles pour une définition de connecteur

L'list-connector-definition-versionsexemple suivant répertorie les versions disponibles pour la définition de connecteur spécifiée. Utilisez la list-connector-definitions commande pour obtenir l'ID de définition du connecteur.

aws greengrass list-connector-definition-versions \ --connector-definition-id "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8"

Sortie :

{ "Versions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8/versions/63c57963-c7c2-4a26-a7e2-7bf478ea2623", "CreationTimestamp": "2019-06-19T19:30:01.300Z", "Id": "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8", "Version": "63c57963-c7c2-4a26-a7e2-7bf478ea2623" } ] }

Pour plus d'informations, consultez la section Intégrer aux services et aux protocoles à l'aide des connecteurs Greengrass dans le guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utiliserlist-connector-definitions.

AWS CLI

Pour répertorier les connecteurs Greengrass définis

L'list-connector-definitionsexemple suivant répertorie tous les connecteurs Greengrass définis pour votre AWS compte.

aws greengrass list-connector-definitions

Sortie :

{ "Definitions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8", "CreationTimestamp": "2019-06-19T19:30:01.300Z", "Id": "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8", "LastUpdatedTimestamp": "2019-06-19T19:30:01.300Z", "LatestVersion": "63c57963-c7c2-4a26-a7e2-7bf478ea2623", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8/versions/63c57963-c7c2-4a26-a7e2-7bf478ea2623", "Name": "MySNSConnector" } ] }

Pour plus d'informations, consultez la section Intégrer aux services et aux protocoles à l'aide des connecteurs Greengrass dans le guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utiliserlist-core-definition-versions.

AWS CLI

Pour répertorier les versions d'une définition de base de Greengrass

L'list-core-definitionsexemple suivant répertorie toutes les versions de la définition de base Greengrass spécifiée. Vous pouvez utiliser la list-core-definitions commande pour obtenir l'ID de version.

aws greengrass list-core-definition-versions \ --core-definition-id "eaf280cb-138c-4d15-af36-6f681a1348f7"

Sortie :

{ "Versions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/eaf280cb-138c-4d15-af36-6f681a1348f7/versions/467c36e4-c5da-440c-a97b-084e62593b4c", "CreationTimestamp": "2019-06-18T16:14:17.709Z", "Id": "eaf280cb-138c-4d15-af36-6f681a1348f7", "Version": "467c36e4-c5da-440c-a97b-084e62593b4c" } ] }

L'exemple de code suivant montre comment utiliserlist-core-definitions.

AWS CLI

Pour répertorier les définitions de base de Greengrass

L'list-core-definitionsexemple suivant répertorie toutes les définitions de base de Greengrass pour votre AWS compte.

aws greengrass list-core-definitions

Sortie :

{ "Definitions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/0507843c-c1ef-4f06-b051-817030df7e7d", "CreationTimestamp": "2018-10-17T04:30:32.786Z", "Id": "0507843c-c1ef-4f06-b051-817030df7e7d", "LastUpdatedTimestamp": "2018-10-17T04:30:32.786Z", "LatestVersion": "bcdf9e86-3793-491e-93af-3cdfbf4e22b7", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/0507843c-c1ef-4f06-b051-817030df7e7d/versions/bcdf9e86-3793-491e-93af-3cdfbf4e22b7" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/31c22500-3509-4271-bafd-cf0655cda438", "CreationTimestamp": "2019-06-18T16:24:16.064Z", "Id": "31c22500-3509-4271-bafd-cf0655cda438", "LastUpdatedTimestamp": "2019-06-18T16:24:16.064Z", "LatestVersion": "2f350395-6d09-4c8a-8336-9ae5b57ace84", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/31c22500-3509-4271-bafd-cf0655cda438/versions/2f350395-6d09-4c8a-8336-9ae5b57ace84" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/c906ed39-a1e3-4822-a981-7b9bd57b4b46", "CreationTimestamp": "2019-06-18T16:21:21.351Z", "Id": "c906ed39-a1e3-4822-a981-7b9bd57b4b46", "LastUpdatedTimestamp": "2019-06-18T16:21:21.351Z", "LatestVersion": "42aeeac3-fd9d-4312-a8fd-ffa9404a20e0", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/c906ed39-a1e3-4822-a981-7b9bd57b4b46/versions/42aeeac3-fd9d-4312-a8fd-ffa9404a20e0" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/eaf280cb-138c-4d15-af36-6f681a1348f7", "CreationTimestamp": "2019-06-18T16:14:17.709Z", "Id": "eaf280cb-138c-4d15-af36-6f681a1348f7", "LastUpdatedTimestamp": "2019-06-18T16:14:17.709Z", "LatestVersion": "467c36e4-c5da-440c-a97b-084e62593b4c", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/eaf280cb-138c-4d15-af36-6f681a1348f7/versions/467c36e4-c5da-440c-a97b-084e62593b4c" } ] }
  • Pour API plus de détails, voir ListCoreDefinitionsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-deployments.

AWS CLI

Pour répertorier les déploiements d'un groupe Greengrass

L'list-deploymentsexemple suivant répertorie les déploiements pour le groupe Greengrass spécifié. Vous pouvez utiliser la list-groups commande pour rechercher votre identifiant de groupe.

aws greengrass list-deployments \ --group-id "1013db12-8b58-45ff-acc7-704248f66731"

Sortie :

{ "Deployments": [ { "CreatedAt": "2019-06-18T17:04:32.702Z", "DeploymentId": "1065b8a0-812b-4f21-9d5d-e89b232a530f", "DeploymentType": "NewDeployment", "GroupArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/115136b3-cfd7-4462-b77f-8741a4b00e5e" } ] }
  • Pour API plus de détails, voir ListDeploymentsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-device-definition-versions.

AWS CLI

Pour répertorier les versions d'une définition d'appareil

L'list-device-definition-versionsexemple suivant affiche les versions de définition de périphérique associées à la définition de périphérique spécifiée.

aws greengrass list-device-definition-versions \ --device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd"

Sortie :

{ "Versions": [ { "Version": "83c13984-6fed-447e-84d5-5b8aa45d5f71", "CreationTimestamp": "2019-09-11T00:15:09.838Z", "Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/83c13984-6fed-447e-84d5-5b8aa45d5f71" }, { "Version": "3b5cc510-58c1-44b5-9d98-4ad858ffa795", "CreationTimestamp": "2019-09-11T00:11:06.197Z", "Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/3b5cc510-58c1-44b5-9d98-4ad858ffa795" } ] }

L'exemple de code suivant montre comment utiliserlist-device-definitions.

AWS CLI

Pour répertorier les définitions de vos appareils

L'list-device-definitionsexemple suivant affiche des détails sur les définitions d'appareils de votre AWS compte dans la AWS région spécifiée.

aws greengrass list-device-definitions \ --region us-west-2

Sortie :

{ "Definitions": [ { "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/50f3274c-3f0a-4f57-b114-6f46085281ab/versions/c777b0f5-1059-449b-beaa-f003ebc56c34", "LastUpdatedTimestamp": "2019-06-14T15:42:09.059Z", "LatestVersion": "c777b0f5-1059-449b-beaa-f003ebc56c34", "CreationTimestamp": "2019-06-14T15:42:09.059Z", "Id": "50f3274c-3f0a-4f57-b114-6f46085281ab", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/50f3274c-3f0a-4f57-b114-6f46085281ab" }, { "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/e01951c9-6134-479a-969a-1a15cac11c40/versions/514d57aa-4ee6-401c-9fac-938a9f7a51e5", "Name": "TestDeviceDefinition", "LastUpdatedTimestamp": "2019-04-16T23:17:43.245Z", "LatestVersion": "514d57aa-4ee6-401c-9fac-938a9f7a51e5", "CreationTimestamp": "2019-04-16T23:17:43.245Z", "Id": "e01951c9-6134-479a-969a-1a15cac11c40", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/e01951c9-6134-479a-969a-1a15cac11c40" }, { "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/83c13984-6fed-447e-84d5-5b8aa45d5f71", "Name": "TemperatureSensors", "LastUpdatedTimestamp": "2019-09-10T00:19:03.698Z", "LatestVersion": "83c13984-6fed-447e-84d5-5b8aa45d5f71", "CreationTimestamp": "2019-09-11T00:11:06.197Z", "Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd", "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd" } ] }

L'exemple de code suivant montre comment utiliserlist-function-definition-versions.

AWS CLI

Pour répertorier les versions d'une fonction Lambda

L'list-function-definition-versionsexemple suivant répertorie toutes les versions de la fonction Lambda spécifiée. Vous pouvez utiliser la list-function-definitions commande pour obtenir l'identifiant.

aws greengrass list-function-definition-versions \ --function-definition-id "063f5d1a-1dd1-40b4-9b51-56f8993d0f85"

Sortie :

{ "Versions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9748fda7-1589-4fcc-ac94-f5559e88678b", "CreationTimestamp": "2019-06-18T17:04:30.776Z", "Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "Version": "9748fda7-1589-4fcc-ac94-f5559e88678b" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9b08df77-26f2-4c29-93d2-769715edcfec", "CreationTimestamp": "2019-06-18T17:02:44.087Z", "Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "Version": "9b08df77-26f2-4c29-93d2-769715edcfec" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/4236239f-94f7-4b90-a2f8-2a24c829d21e", "CreationTimestamp": "2019-06-18T17:01:42.284Z", "Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "Version": "4236239f-94f7-4b90-a2f8-2a24c829d21e" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/343408bb-549a-4fbe-b043-853643179a39", "CreationTimestamp": "2019-06-18T16:21:21.431Z", "Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "Version": "343408bb-549a-4fbe-b043-853643179a39" } ] }

L'exemple de code suivant montre comment utiliserlist-function-definitions.

AWS CLI

Pour répertorier les fonctions Lambda

L'list-function-definitionsexemple suivant répertorie toutes les fonctions Lambda définies pour votre AWS compte.

aws greengrass list-function-definitions

Sortie :

{ "Definitions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/017970a5-8952-46dd-b1c1-020b3ae8e960", "CreationTimestamp": "2018-10-17T04:30:32.884Z", "Id": "017970a5-8952-46dd-b1c1-020b3ae8e960", "LastUpdatedTimestamp": "2018-10-17T04:30:32.884Z", "LatestVersion": "4380b302-790d-4ed8-92bf-02e88afecb15", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/017970a5-8952-46dd-b1c1-020b3ae8e960/versions/4380b302-790d-4ed8-92bf-02e88afecb15" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "CreationTimestamp": "2019-06-18T16:21:21.431Z", "Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85", "LastUpdatedTimestamp": "2019-06-18T16:21:21.431Z", "LatestVersion": "9748fda7-1589-4fcc-ac94-f5559e88678b", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9748fda7-1589-4fcc-ac94-f5559e88678b" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/6598e653-a262-440c-9967-e2697f64da7b", "CreationTimestamp": "2019-06-18T16:24:16.123Z", "Id": "6598e653-a262-440c-9967-e2697f64da7b", "LastUpdatedTimestamp": "2019-06-18T16:24:16.123Z", "LatestVersion": "38bc6ccd-98a2-4ce7-997e-16c84748fae4", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/6598e653-a262-440c-9967-e2697f64da7b/versions/38bc6ccd-98a2-4ce7-997e-16c84748fae4" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/c668df84-fad2-491b-95f4-655d2cad7885", "CreationTimestamp": "2019-06-18T16:14:17.784Z", "Id": "c668df84-fad2-491b-95f4-655d2cad7885", "LastUpdatedTimestamp": "2019-06-18T16:14:17.784Z", "LatestVersion": "37dd68c4-a64f-40ba-aa13-71fecc3ebded", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/c668df84-fad2-491b-95f4-655d2cad7885/versions/37dd68c4-a64f-40ba-aa13-71fecc3ebded" } ] }

L'exemple de code suivant montre comment utiliserlist-group-certificate-authorities.

AWS CLI

Pour répertorier le courant CAs d'un groupe

L'list-group-certificate-authoritiesexemple suivant répertorie les autorités de certification actuelles (CAs) pour le groupe Greengrass spécifié.

aws greengrass list-group-certificate-authorities \ --group-id "1013db12-8b58-45ff-acc7-704248f66731"

Sortie :

{ "GroupCertificateAuthorities": [ { "GroupCertificateAuthorityArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/certificateauthorities/f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6", "GroupCertificateAuthorityId": "f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6" } ] }

L'exemple de code suivant montre comment utiliserlist-group-versions.

AWS CLI

Pour répertorier les versions d'un groupe Greengrass

L'list-group-versionsexemple suivant répertorie les versions du groupe Greengrass spécifié.

aws greengrass list-group-versions \ --group-id "1013db12-8b58-45ff-acc7-704248f66731"

Sortie :

{ "Versions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/115136b3-cfd7-4462-b77f-8741a4b00e5e", "CreationTimestamp": "2019-06-18T17:04:30.915Z", "Id": "1013db12-8b58-45ff-acc7-704248f66731", "Version": "115136b3-cfd7-4462-b77f-8741a4b00e5e" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/4340669d-d14d-44e3-920c-46c928750750", "CreationTimestamp": "2019-06-18T17:03:52.663Z", "Id": "1013db12-8b58-45ff-acc7-704248f66731", "Version": "4340669d-d14d-44e3-920c-46c928750750" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/1b06e099-2d5b-4f10-91b9-78c4e060f5da", "CreationTimestamp": "2019-06-18T17:02:44.189Z", "Id": "1013db12-8b58-45ff-acc7-704248f66731", "Version": "1b06e099-2d5b-4f10-91b9-78c4e060f5da" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/2d3f27f1-3b43-4554-ab7a-73ec30477efe", "CreationTimestamp": "2019-06-18T17:01:42.401Z", "Id": "1013db12-8b58-45ff-acc7-704248f66731", "Version": "2d3f27f1-3b43-4554-ab7a-73ec30477efe" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/d20f7ae9-3444-4c1c-b025-e2ede23cdd31", "CreationTimestamp": "2019-06-18T16:21:21.457Z", "Id": "1013db12-8b58-45ff-acc7-704248f66731", "Version": "d20f7ae9-3444-4c1c-b025-e2ede23cdd31" } ] }
  • Pour API plus de détails, voir ListGroupVersionsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-groups.

AWS CLI

Pour répertorier les groupes Greengrass

L'list-groupsexemple suivant répertorie tous les groupes Greengrass définis dans votre AWS compte.

aws greengrass list-groups

Sortie :

{ "Groups": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731", "CreationTimestamp": "2019-06-18T16:21:21.457Z", "Id": "1013db12-8b58-45ff-acc7-704248f66731", "LastUpdatedTimestamp": "2019-06-18T16:21:21.457Z", "LatestVersion": "115136b3-cfd7-4462-b77f-8741a4b00e5e", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/115136b3-cfd7-4462-b77f-8741a4b00e5e", "Name": "GGGroup4Pi3" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1402daf9-71cf-4cfe-8be0-d5e80526d0d8", "CreationTimestamp": "2018-10-31T21:52:46.603Z", "Id": "1402daf9-71cf-4cfe-8be0-d5e80526d0d8", "LastUpdatedTimestamp": "2018-10-31T21:52:46.603Z", "LatestVersion": "749af901-60ab-456f-a096-91b12d983c29", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1402daf9-71cf-4cfe-8be0-d5e80526d0d8/versions/749af901-60ab-456f-a096-91b12d983c29", "Name": "MyTestGroup" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/504b5c8d-bbed-4635-aff1-48ec5b586db5", "CreationTimestamp": "2018-12-31T21:39:36.771Z", "Id": "504b5c8d-bbed-4635-aff1-48ec5b586db5", "LastUpdatedTimestamp": "2018-12-31T21:39:36.771Z", "LatestVersion": "46911e8e-f9bc-4898-8b63-59c7653636ec", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/504b5c8d-bbed-4635-aff1-48ec5b586db5/versions/46911e8e-f9bc-4898-8b63-59c7653636ec", "Name": "smp-ggrass-group" } ] }
  • Pour API plus de détails, voir ListGroupsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-logger-definition-versions.

AWS CLI

Pour obtenir la liste des versions d'une définition d'enregistreur

L'list-logger-definition-versionsexemple suivant permet d'obtenir une liste de toutes les versions de la définition d'enregistreur spécifiée.

aws greengrass list-logger-definition-versions \ --logger-definition-id "49eeeb66-f1d3-4e34-86e3-3617262abf23"

Sortie :

{ "Versions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23/versions/5e3f6f64-a565-491e-8de0-3c0d8e0f2073", "CreationTimestamp": "2019-05-08T16:10:13.866Z", "Id": "49eeeb66-f1d3-4e34-86e3-3617262abf23", "Version": "5e3f6f64-a565-491e-8de0-3c0d8e0f2073" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23/versions/3ec6d3af-eb85-48f9-a16d-1c795fe696d7", "CreationTimestamp": "2019-05-08T16:10:13.809Z", "Id": "49eeeb66-f1d3-4e34-86e3-3617262abf23", "Version": "3ec6d3af-eb85-48f9-a16d-1c795fe696d7" } ] }

L'exemple de code suivant montre comment utiliserlist-logger-definitions.

AWS CLI

Pour obtenir une liste des définitions des enregistreurs

L'list-logger-definitionsexemple suivant répertorie toutes les définitions d'enregistreurs pour votre AWS compte.

aws greengrass list-logger-definitions

Sortie :

{ "Definitions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23", "CreationTimestamp": "2019-05-08T16:10:13.809Z", "Id": "49eeeb66-f1d3-4e34-86e3-3617262abf23", "LastUpdatedTimestamp": "2019-05-08T16:10:13.809Z", "LatestVersion": "5e3f6f64-a565-491e-8de0-3c0d8e0f2073", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23/versions/5e3f6f64-a565-491e-8de0-3c0d8e0f2073" } ] }

L'exemple de code suivant montre comment utiliserlist-resource-definition-versions.

AWS CLI

Pour répertorier les versions d'une définition de ressource

L'list-resource-definition-versionsexemple suivant répertorie les versions de la ressource Greengrass spécifiée.

aws greengrass list-resource-definition-versions \ --resource-definition-id "ad8c101d-8109-4b0e-b97d-9cc5802ab658"

Sortie :

{ "Versions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658/versions/26e8829a-491a-464d-9c87-664bf6f6f2be", "CreationTimestamp": "2019-06-19T16:40:59.392Z", "Id": "ad8c101d-8109-4b0e-b97d-9cc5802ab658", "Version": "26e8829a-491a-464d-9c87-664bf6f6f2be" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658/versions/432d92f6-12de-4ec9-a704-619a942a62aa", "CreationTimestamp": "2019-06-19T16:40:59.261Z", "Id": "ad8c101d-8109-4b0e-b97d-9cc5802ab658", "Version": "432d92f6-12de-4ec9-a704-619a942a62aa" } ] }

L'exemple de code suivant montre comment utiliserlist-resource-definitions.

AWS CLI

Pour répertorier les ressources définies

L'list-resource-definitionsexemple suivant répertorie les ressources définies pour AWS IoT Greengrass à utiliser.

aws greengrass list-resource-definitions

Sortie :

{ "Definitions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658", "CreationTimestamp": "2019-06-19T16:40:59.261Z", "Id": "ad8c101d-8109-4b0e-b97d-9cc5802ab658", "LastUpdatedTimestamp": "2019-06-19T16:40:59.261Z", "LatestVersion": "26e8829a-491a-464d-9c87-664bf6f6f2be", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658/versions/26e8829a-491a-464d-9c87-664bf6f6f2be" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38", "CreationTimestamp": "2019-06-19T21:51:28.212Z", "Id": "c8bb9ebc-c3fd-40a4-9c6a-568d75569d38", "LastUpdatedTimestamp": "2019-06-19T21:51:28.212Z", "LatestVersion": "a5f94d0b-f6bc-40f4-bb78-7a1c5fe13ba1", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38/versions/a5f94d0b-f6bc-40f4-bb78-7a1c5fe13ba1", "Name": "MyGreengrassResources" } ] }

L'exemple de code suivant montre comment utiliserlist-subscription-definition-versions.

AWS CLI

Pour répertorier les versions d'une définition d'abonnement

L'list-subscription-definition-versionsexemple suivant répertorie toutes les versions de l'abonnement spécifié. Vous pouvez utiliser la list-subscription-definitions commande pour rechercher l'identifiant de l'abonnement.

aws greengrass list-subscription-definition-versions \ --subscription-definition-id "70e49321-83d5-45d2-bc09-81f4917ae152"

Sortie :

{ "Versions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/88ae8699-12ac-4663-ba3f-4d7f0519140b", "CreationTimestamp": "2019-06-18T17:03:52.499Z", "Id": "70e49321-83d5-45d2-bc09-81f4917ae152", "Version": "88ae8699-12ac-4663-ba3f-4d7f0519140b" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/7e320ba3-c369-4069-a2f0-90acb7f219d6", "CreationTimestamp": "2019-06-18T17:03:52.392Z", "Id": "70e49321-83d5-45d2-bc09-81f4917ae152", "Version": "7e320ba3-c369-4069-a2f0-90acb7f219d6" } ] }

L'exemple de code suivant montre comment utiliserlist-subscription-definitions.

AWS CLI

Pour obtenir les définitions des abonnements à une liste

L'list-subscription-definitionsexemple suivant répertorie tous les abonnements AWS IoT Greengrass définis dans votre AWS compte.

aws greengrass list-subscription-definitions

Sortie :

{ "Definitions": [ { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152", "CreationTimestamp": "2019-06-18T17:03:52.392Z", "Id": "70e49321-83d5-45d2-bc09-81f4917ae152", "LastUpdatedTimestamp": "2019-06-18T17:03:52.392Z", "LatestVersion": "88ae8699-12ac-4663-ba3f-4d7f0519140b", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/88ae8699-12ac-4663-ba3f-4d7f0519140b" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/cd6f1c37-d9a4-4e90-be94-01a7404f5967", "CreationTimestamp": "2018-10-18T15:45:34.024Z", "Id": "cd6f1c37-d9a4-4e90-be94-01a7404f5967", "LastUpdatedTimestamp": "2018-10-18T15:45:34.024Z", "LatestVersion": "d1cf8fac-284f-4f6a-98fe-a2d36d089373", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/cd6f1c37-d9a4-4e90-be94-01a7404f5967/versions/d1cf8fac-284f-4f6a-98fe-a2d36d089373" }, { "Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/fa81bc84-3f59-4377-a84b-5d0134da359b", "CreationTimestamp": "2018-10-22T17:09:31.429Z", "Id": "fa81bc84-3f59-4377-a84b-5d0134da359b", "LastUpdatedTimestamp": "2018-10-22T17:09:31.429Z", "LatestVersion": "086d1b08-b25a-477c-a16f-6f9b3a9c295a", "LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/fa81bc84-3f59-4377-a84b-5d0134da359b/versions/086d1b08-b25a-477c-a16f-6f9b3a9c295a" } ] }

L'exemple de code suivant montre comment utiliserlist-tags-for-resource.

AWS CLI

Pour répertorier les balises associées à une ressource

L'list-tags-for-resourceexemple suivant répertorie les balises et leurs valeurs associées à la ressource spécifiée.

aws greengrass list-tags-for-resource \ --resource-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658"

Sortie :

{ "tags": { "ResourceSubType": "USB", "ResourceType": "Device" } }

Pour plus d'informations, consultez la section Marquage de vos ressources Greengrass dans le guide du développeur AWS IoT Greengrass.

  • Pour API plus de détails, voir ListTagsForResourcela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserreset-deployments.

AWS CLI

Pour nettoyer les informations de déploiement d'un groupe Greengrass

L'reset-deploymentsexemple suivant nettoie les informations de déploiement pour le groupe Greengrass spécifié. Lorsque vous ajoutez le--force option, les informations de déploiement sont réinitialisées sans attendre que le périphérique principal réponde.

aws greengrass reset-deployments \ --group-id "1402daf9-71cf-4cfe-8be0-d5e80526d0d8" \ --force

Sortie :

{ "DeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1402daf9-71cf-4cfe-8be0-d5e80526d0d8/deployments/7dd4e356-9882-46a3-9e28-6d21900c011a", "DeploymentId": "7dd4e356-9882-46a3-9e28-6d21900c011a" }

Pour plus d'informations, consultez la section Réinitialiser les déploiements dans le guide du AWS développeur IoT Greengrass.

  • Pour API plus de détails, voir ResetDeploymentsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserstart-bulk-deployment.

AWS CLI

Pour démarrer une opération de déploiement en masse

L'start-bulk-deploymentexemple suivant lance une opération de déploiement en masse, en utilisant un fichier stocké dans un compartiment S3 pour spécifier les groupes à déployer.

aws greengrass start-bulk-deployment \ --cli-input-json "{\"InputFileUri\":\"https://gg-group-deployment1.s3-us-west-2.amazonaws.com/MyBulkDeploymentInputFile.txt\", \"ExecutionRoleArn\":\"arn:aws:iam::123456789012:role/ggCreateDeploymentRole\",\"AmznClientToken\":\"yourAmazonClientToken\"}"

Sortie :

{ "BulkDeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/bulk/deployments/870fb41b-6288-4e0c-bc76-a7ba4b4d3267", "BulkDeploymentId": "870fb41b-6288-4e0c-bc76-a7ba4b4d3267" }

Pour plus d'informations, consultez la section Créer des déploiements groupés pour les groupes dans le Guide du AWS développeur IoT Greengrass.

  • Pour API plus de détails, voir StartBulkDeploymentla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserstop-bulk-deployment.

AWS CLI

Pour arrêter un déploiement en masse

L'stop-bulk-deploymentexemple suivant arrête le déploiement en bloc spécifié. Si vous essayez d'arrêter un déploiement groupé qui est terminé, vous recevez un message d'erreur : InvalidInputException: Cannot change state of finished execution.

aws greengrass stop-bulk-deployment \ --bulk-deployment-id "870fb41b-6288-4e0c-bc76-a7ba4b4d3267"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Créer des déploiements groupés pour les groupes dans le Guide du AWS développeur IoT Greengrass.

  • Pour API plus de détails, voir StopBulkDeploymentla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisertag-resource.

AWS CLI

Pour appliquer des balises à une ressource

L'tag-resourceexemple suivant applique deux balises, ResourceType etResourceSubType, à la ressource Greengrass spécifiée. Cette opération peut à la fois ajouter de nouvelles balises et valeurs ou mettre à jour la valeur des balises existantes. Utilisez la untag-resource commande pour supprimer un tag.

aws greengrass tag-resource \ --resource-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658" \ --tags "ResourceType=Device,ResourceSubType=USB"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Marquage de vos ressources Greengrass dans le guide du développeur AWS IoT Greengrass.

  • Pour API plus de détails, voir TagResourcela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliseruntag-resource.

AWS CLI

Pour supprimer une balise et sa valeur d'une ressource

L'untag-resourceexemple suivant supprime la balise dont la clé Category appartient au groupe Greengrass spécifié. Si la clé Category n'existe pas pour la ressource spécifiée, aucune erreur n'est renvoyée.

aws greengrass untag-resource \ --resource-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731" \ --tag-keys "Category"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Marquage de vos ressources Greengrass dans le guide du développeur AWS IoT Greengrass.

  • Pour API plus de détails, voir UntagResourcela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-connectivity-info.

AWS CLI

Pour mettre à jour les informations de connectivité d'un noyau Greengrass

L'update-connectivity-infoexemple suivant modifie les points de terminaison que les appareils peuvent utiliser pour se connecter au cœur Greengrass spécifié. Les informations de connectivité sont une liste d'adresses IP ou de noms de domaine, avec les numéros de port correspondants et les métadonnées facultatives définies par le client. Il se peut que vous deviez mettre à jour les informations de connectivité lorsque le réseau local change.

aws greengrass update-connectivity-info \ --thing-name "MyGroup_Core" \ --connectivity-info "[{\"Metadata\":\"\",\"PortNumber\":8883,\"HostAddress\":\"127.0.0.1\",\"Id\":\"localhost_127.0.0.1_0\"},{\"Metadata\":\"\",\"PortNumber\":8883,\"HostAddress\":\"192.168.1.3\",\"Id\":\"localIP_192.168.1.3\"}]"

Sortie :

{ "Version": "312de337-59af-4cf9-a278-2a23bd39c300" }

L'exemple de code suivant montre comment utiliserupdate-connector-definition.

AWS CLI

Pour mettre à jour le nom d'une définition de connecteur

L'update-connector-definitionexemple suivant met à jour le nom de la définition de connecteur spécifiée. Si vous souhaitez mettre à jour les détails du connecteur, utilisez la create-connector-definition-version commande pour créer une nouvelle version.

aws greengrass update-connector-definition \ --connector-definition-id "55d0052b-0d7d-44d6-b56f-21867215e118" \ --name "GreengrassConnectors2019"

Pour plus d'informations, consultez la section Intégrer aux services et aux protocoles à l'aide de connecteurs dans le AWS guide du développeur IoT Greengrass.

L'exemple de code suivant montre comment utiliserupdate-core-definition.

AWS CLI

Pour mettre à jour une définition de base

L'update-core-definitionexemple suivant modifie le nom de la définition de base spécifiée. Vous ne pouvez mettre à jour que la name propriété d'une définition de base.

aws greengrass update-core-definition \ --core-definition-id "582efe12-b05a-409e-9a24-a2ba1bcc4a12" \ --name "MyCoreDevices"

Cette commande ne produit aucun résultat.

Pour plus d'informations, voir Configurer le cœur AWS IoT Greengrass dans le Guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utiliserupdate-device-definition.

AWS CLI

Pour mettre à jour la définition d'un appareil

L'update-device-definitionexemple suivant modifie le nom de la définition de périphérique spécifiée. Vous pouvez uniquement mettre à jour la name propriété d'une définition d'appareil.

aws greengrass update-device-definition \ --device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd" \ --name "TemperatureSensors"

Cette commande ne produit aucun résultat.

L'exemple de code suivant montre comment utiliserupdate-function-definition.

AWS CLI

Pour mettre à jour le nom d'une définition de fonction

L'update-function-definitionexemple suivant met à jour le nom de la définition de fonction spécifiée. Si vous souhaitez mettre à jour les détails de la fonction, utilisez la create-function-definition-version commande pour créer une nouvelle version.

aws greengrass update-function-definition \ --function-definition-id "e47952bd-dea9-4e2c-a7e1-37bbe8807f46" \ --name ObsoleteFunction

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Exécuter des fonctions Lambda locales dans le guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utiliserupdate-group-certificate-configuration.

AWS CLI

Pour mettre à jour l'expiration des certificats d'un groupe

L'update-group-certificate-configurationexemple suivant définit une expiration de 10 jours pour les certificats générés pour le groupe spécifié.

aws greengrass update-group-certificate-configuration \ --group-id "8eaadd72-ce4b-4f15-892a-0cc4f3a343f1" \ --certificate-expiry-in-milliseconds 864000000

Sortie :

{ "CertificateExpiryInMilliseconds": 864000000, "CertificateAuthorityExpiryInMilliseconds": 2524607999000, "GroupId": "8eaadd72-ce4b-4f15-892a-0cc4f3a343f1" }

Pour plus d'informations, consultez AWS IoT Greengrass Security dans le guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utiliserupdate-group.

AWS CLI

Pour mettre à jour le nom du groupe

L'update-groupexemple suivant met à jour le nom du groupe Greengrass spécifié. Si vous souhaitez mettre à jour les informations du groupe, utilisez la create-group-version commande pour créer une nouvelle version.

aws greengrass update-group \ --group-id "1402daf9-71cf-4cfe-8be0-d5e80526d0d8" \ --name TestGroup4of6

Pour plus d'informations, voir Configurer AWS IoT Greengrass on IoT dans le Guide du développeur AWS IoT AWS Greengrass.

  • Pour API plus de détails, voir UpdateGroupla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-logger-definition.

AWS CLI

Pour mettre à jour la définition d'un enregistreur

L'update-logger-definitionexemple suivant modifie le nom de la définition d'enregistreur spécifiée. Vous pouvez uniquement mettre à jour la name propriété d'une définition d'enregistreur.

aws greengrass update-logger-definition \ --logger-definition-id "a454b62a-5d56-4ca9-bdc4-8254e1662cb0" \ --name "LoggingConfigsForSensors"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Surveillance à AWS l'aide des journaux IoT Greengrass dans le guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utiliserupdate-resource-definition.

AWS CLI

Pour mettre à jour le nom d'une définition de ressource

L'update-resource-definitionexemple suivant met à jour le nom de la définition de ressource spécifiée. Si vous souhaitez modifier les détails de la ressource, utilisez la create-resource-definition-version commande pour créer une nouvelle version.

aws greengrass update-resource-definition \ --resource-definition-id "c8bb9ebc-c3fd-40a4-9c6a-568d75569d38" \ --name GreengrassConnectorResources

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Accès aux ressources locales à l'aide de fonctions et de connecteurs Lambda dans le guide du développeur IoT AWS Greengrass.

L'exemple de code suivant montre comment utiliserupdate-subscription-definition.

AWS CLI

Pour mettre à jour le nom d'une définition d'abonnement

L'update-subscription-definitionexemple suivant met à jour le nom de la définition d'abonnement spécifiée. Si vous souhaitez modifier les détails de l'abonnement, utilisez la create-subscription-definition-version commande pour créer une nouvelle version.

aws greengrass update-subscription-definition \ --subscription-definition-id "fa81bc84-3f59-4377-a84b-5d0134da359b" \ --name "ObsoleteSubscription"

Cette commande ne produit aucun résultat.

Pour plus d'informations, voir le titre dans le guide.

L'exemple de code suivant montre comment utiliserupdate-thing-runtime-configuration.

AWS CLI

Pour activer la télémétrie dans la configuration d'exécution d'un noyau Greengrass

L'update-thing-runtime-configurationexemple suivant met à jour la configuration d'exécution d'un noyau Greengrass pour activer la télémétrie.

aws greengrass update-thing-runtime-configuration \ --thing-name SampleGreengrassCore \ --telemetry-configuration {\"Telemetry\":\"On\"}

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Configuration des paramètres de télémétrie dans le manuel IoT AWS Greengrass Developer Guide.