AWS IoT exemples utilisant AWS CLI

Pour accepter un certificat d'appareil transféré depuis un autre AWS compte

L'accept-certificate-transferexemple suivant accepte un certificat d'appareil transféré depuis un autre AWS compte. Le certificat est identifié par son identifiant.

aws iot accept-certificate-transfer \
    --certificate-id 488b6a7f2acdeb00a77384e63c4e40b18bEXAMPLEe57b7272ba44c45e3448142

Cette commande ne génère pas de sortie.

Pour plus d'informations, consultez la section Transférer un certificat vers un autre compte dans le guide du développeur AWS IoT Core.

Exemple 1 : pour ajouter un objet par son nom à un groupe de facturation

L'add-thing-to-billing-groupexemple suivant ajoute l'objet nommé MyLightBulb au groupe de facturation nomméGroupOne.

aws iot add-thing-to-billing-group \
    --billing-group-name GroupOne \
    --thing-name MyLightBulb

Cette commande ne produit aucun résultat.

Exemple 2 : pour ajouter un objet par ARN à un groupe de facturation

L'add-thing-to-billing-groupexemple suivant ajoute un objet avec un ARN spécifié à un groupe de facturation avec l'ARN spécifié. La spécification d'un ARN est utile si vous travaillez avec plusieurs AWS régions ou comptes. Cela peut vous aider à vous assurer que vous ajoutez à la bonne région et au bon compte.

aws iot add-thing-to-thing-group \
    --billing-group-arn "arn:aws:iot:us-west-2:123456789012:billinggroup/GroupOne" \
    --thing-arn "arn:aws:iot:us-west-2:123456789012:thing/MyOtherLightBulb"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Groupes de facturation dans le Guide du développeur AWS IoT.

Pour ajouter un objet à un groupe

L'add-thing-to-thing-groupexemple suivant ajoute l'objet spécifié au groupe d'objets spécifié.

aws iot add-thing-to-thing-group \
    --thing-name MyLightBulb \
    --thing-group-name LightBulbs

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Thing Groups dans le guide du développeur AWS IoT.

Pour associer un groupe d'objets à une tâche continue

L'associate-targets-with-jobexemple suivant associe le groupe d'objets spécifié à la tâche continue spécifiée.

aws iot associate-targets-with-job \
    --targets "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs" \
    --job-id "example-job-04"

Sortie :

{
    "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-04",
    "jobId": "example-job-04",
    "description": "example continuous job"
}

Pour plus d'informations, consultez Creating and Managing Jobs (CLI) dans le Guide du développeur de l'AWS IoT.

Exemple 1 : pour associer une politique à un groupe d'objets

L'attach-policyexemple suivant attache la politique spécifiée à un groupe d'objets identifié par son ARN.

aws iot attach-policy \
    --target "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs" \
    --policy-name "UpdateDeviceCertPolicy"

Cette commande ne génère pas de sortie.

Pour plus d'informations, consultez la section Thing Groups dans le guide du développeur AWS IoT.

Exemple 2 : pour associer une politique à un certificat

L'attach-policyexemple suivant attache la politique UpdateDeviceCertPolicy au principal spécifié par un certificat.

aws iot attach-policy \
    --policy-name UpdateDeviceCertPolicy \
    --target "arn:aws:iot:us-west-2:123456789012:cert/4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e"

Cette commande ne génère pas de sortie.

Pour plus d'informations, voir Attacher une politique AWS IoT à un certificat d'appareil dans le Guide du développeur AWS IoT.

Pour associer un profil de sécurité à tous les appareils non enregistrés

L'attach-security-profileexemple suivant associe le profil de sécurité AWS IoT Device Defender nommé Testprofile à tous les appareils non enregistrés de la us-west-2 région pour ce AWS compte.

aws iot attach-security-profile \
    --security-profile-name Testprofile \
    --security-profile-target-arn "arn:aws:iot:us-west-2:123456789012:all/unregistered-things"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Détecter les commandes dans le guide du développeur de l'AWS IoT.

Pour joindre un certificat à votre objet

L'attach-thing-principalexemple suivant attache un certificat à l' MyTemperatureSensor objet. Le certificat est identifié par un ARN. Vous trouverez l'ARN d'un certificat dans la console AWS IoT.

aws iot attach-thing-principal \
    --thing-name MyTemperatureSensor \
    --principal arn:aws:iot:us-west-2:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Comment gérer les objets avec le registre dans le Guide du développeur de l'AWS IoT.

Pour annuler une tâche d'audit relative aux mesures d'atténuation

L'cancel-audit-mitigations-action-taskexemple suivant annule l'application des mesures d'atténuation pour la tâche spécifiée. Vous ne pouvez pas annuler des tâches déjà terminées.

aws iot cancel-audit-mitigation-actions-task
    --task-id "myActionsTaskId"

Cette commande ne produit aucun résultat.

Pour plus d'informations, voir CancelAuditMitigationActionsTask (Mitigation Action Commands) dans le Guide du développeur de l'AWS IoT.

Pour annuler une tâche d'audit

L'cancel-audit-taskexemple suivant annule une tâche d'audit avec l'ID de tâche spécifié. Vous ne pouvez pas annuler une tâche terminée.

aws iot cancel-audit-task \
    --task-id a3aea009955e501a31b764abe1bebd3d

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Commandes d'audit du guide du développeur de l'AWS IoT.

Pour annuler le transfert d'un certificat vers un autre AWS compte

L'cancel-certificate-transferexemple suivant annule le transfert du certificat spécifié. Le certificat est identifié par un ID de certificat. Vous pouvez trouver l'identifiant d'un certificat dans la console AWS IoT.

aws iot cancel-certificate-transfer \
    --certificate-id f0f33678c7c9a046e5cc87b2b1a58dfa0beec26db78addd5e605d630e05c7fc8

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Transférer un certificat vers un autre compte dans le guide du développeur AWS IoT Core.

Pour annuler l'exécution d'une tâche sur un appareil

L'cancel-job-executionexemple suivant annule l'exécution de la tâche spécifiée sur un appareil. Si la tâche n'est pas dans QUEUED cet état, vous devez ajouter le --force paramètre.

aws iot cancel-job-execution \
    --job-id "example-job-03" \
    --thing-name "MyRPi"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez Creating and Managing Jobs (CLI) dans le Guide du développeur de l'AWS IoT.

Pour annuler une offre d'emploi

L'cancel-jobexemple suivant annule la tâche spécifiée.

aws iot cancel-job \
    --job-job "example-job-03"

Sortie :

{
    "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-03",
    "jobId": "example-job-03",
    "description": "example job test"
}

Pour plus d'informations, consultez Creating and Managing Jobs (CLI) dans le Guide du développeur de l'AWS IoT.

Pour effacer l'autorisateur par défaut

L'clear-default-authorizerexemple suivant efface l'autorisateur personnalisé par défaut actuellement configuré. Après avoir exécuté cette commande, il n'existe aucun autorisateur par défaut. Lorsque vous utilisez un autorisateur personnalisé, vous devez le spécifier par son nom dans les en-têtes de requête HTTP.

aws iot clear-default-authorizer

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez ClearDefaultAuthorizerle manuel de référence des API AWS IoT.

Pour confirmer la destination d'une règle de sujet

L'confirm-topic-rule-destinationexemple suivant confirme la destination d'une règle de sujet à l'aide d'un jeton de confirmation reçu sur un point de terminaison HTTP.

aws iot confirm-topic-rule-destination \
    --confirmation-token "AYADeIcmtq-ZkxfpiWIQqHWM5ucAXwABABVhd3MtY3J5cHRvLXB1YmxpYy1rZXkAREFxY1E0UmlGeDg0V21BZWZ1VjZtZWFRVUJJUktUYXJaN09OZlJOczJhRENSZmZYL3JHZC9PR3NNcis5T3ZlSitnQT09AAEAB2F3cy1rbXMAS2Fybjphd3M6a21zOnVzLWVhc3QtMTo5ODc5NTE4NTI0OTk6a2V5L2U4YmU3ODViLTU5NWMtNDcxYi1iOWJmLWQ2Y2I4ZjQxODlmNwC4AQIBAHhwz48UWTGWE1ua0P8U1hj27nsFzEaAdf6Hs2K_7wBheAF62zwMuk_A4dPiC6eyPGuMAAAAfjB8BgkqhkiG9w0BBwagbzBtAgEAMGgGCSqGSIb3DQEHATAeBglghkgBZQMEAS4wEQQM9vtRMpf9D3CiZ8sMAgEQgDuFd0Txy-aywpPqg8YEsa1lD4B40aJ2s1wEHKMybiF1RoOZzYisI0IvslzQY5UmCkqq3tV-3f7-nKfosgIAAAAADAAAEAAAAAAAAAAAAAAAAAAi9RMgy-V19V9m6Iw2xfbw_____wAAAAEAAAAAAAAAAAAAAAEAAAB1hw4SokgUcxiJ3gTO6n50NLJVpzyQR1UmPIj5sShqXEQGcOsWmXzpYOOx_PWyPVNsIFHApyK7Cc3g4bW8VaLVwOLkC83g6YaZAh7dFEl2-iufgrzTePl8RZYOWr0O6Aj9DiVzJZx-1iD6Pu-G6PUw1kaO7Knzs2B4AD0qfrHUF4pYRTvyUgBnMGUCMQC8ZRmhKqntd_c6Kgrow3bMUDBvNqo2qZr8Z8Jm2rzgseROlAnLgFLGpGShr99oSZkCMEd1v62NBRKX9HQXnybyF3fkg__-PIetJ803Z4IlIlF8xXlcdPGP-PV1dOXFemyL8g"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Confirmation de la destination d'une règle de sujet dans le Guide du développeur de l'AWS IoT.

Pour créer une suppression des résultats d'audit

L'create-audit-suppressionexemple suivant crée une suppression des résultats d'audit pour une politique nommée « virtualMachinePolicy » qui a été signalée comme étant trop permissive.

aws iot create-audit-suppression \
    --check-name IOT_POLICY_OVERLY_PERMISSIVE_CHECK \
    --resource-identifier policyVersionIdentifier={"policyName"="virtualMachinePolicy","policyVersionId"="1"} \
    --no-suppress-indefinitely \
    --expiration-date 2020-10-20

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Audit sur les suppressions dans le Guide du développeur de l'AWS IoT.

Pour créer un autorisateur personnalisé

L'create-authorizerexemple suivant crée un système d'autorisation personnalisé qui utilise la fonction Lambda spécifiée dans le cadre d'un service d'authentification personnalisé.

   aws iot create-authorizer \
       --authorizer-name "CustomAuthorizer" \
       --authorizer-function-arn "arn:aws:lambda:us-west-2:123456789012:function:CustomAuthorizerFunction" \
       --token-key-name "MyAuthToken" \
       --status ACTIVE \
       --token-signing-public-keys FIRST_KEY="-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA1uJOB4lQPgG/lM6ZfIwo
Z+7ENxAio9q6QD4FFqjGZsvjtYwjoe1RKK0U8Eq9xb5O3kRSmyIwTzwzm/f4Gf0Y
ZUloJ+t3PUUwHrmbYTAgTrCUgRFygjfgVwGCPs5ZAX4Eyqt5cr+AIHIiUDbxSa7p
zwOBKPeic0asNJpqT8PkBbRaKyleJh5oo81NDHHmVtbBm5A5YiJjqYXLaVAowKzZ
+GqsNvAQ9Jy1wI2VrEa1OfL8flDB/BJLm7zjpfPOHDJQgID0XnZwAlNnZcOhCwIx
50g2LW2Oy9R/dmqtDmJiVP97Z4GykxPvwlYHrUXY0iW1R3AR/Ac1NhCTGZMwVDB1
lQIDAQAB
-----END PUBLIC KEY-----"

Sortie :

{
    "authorizerName": "CustomAuthorizer",
    "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer2"
}

Pour plus d'informations, consultez CreateAuthorizerle manuel de référence des API AWS IoT.

Pour créer un groupe de facturation

L'create-billing-groupexemple suivant crée un groupe de facturation simple nomméGroupOne.

aws iot create-billing-group \
    --billing-group-name GroupOne

Sortie :

{
    "billingGroupName": "GroupOne",
    "billingGroupArn": "arn:aws:iot:us-west-2:123456789012:billinggroup/GroupOne",
    "billingGroupId": "103de383-114b-4f51-8266-18f209ef5562"
}

Pour plus d'informations, consultez la section Groupes de facturation dans le Guide du développeur AWS IoT.

Pour créer un certificat d'appareil à partir d'une demande de signature de certificat (CSR)

L'create-certificate-from-csrexemple suivant crée un certificat d'appareil à partir d'un CSR. Vous pouvez utiliser la openssl commande pour créer un CSR.

aws iot create-certificate-from-csr \
    --certificate-signing-request=file://certificate.csr

Sortie :

{
    "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/c0c57bbc8baaf4631a9a0345c957657f5e710473e3ddbee1428d216d54d53ac9",
        "certificateId": "c0c57bbc8baaf4631a9a0345c957657f5e710473e3ddbee1428d216d54d53ac9",
        "certificatePem": "<certificate-text>"
}

Pour plus d'informations, consultez la section CreateCertificateFromCSR dans le manuel de référence des API AWS IoT.

Pour créer une métrique personnalisée publiée par vos appareils sur Device Defender

L'create-custom-metricexemple suivant crée une métrique personnalisée qui mesure le pourcentage de batterie.

aws iot create-custom-metric \
    --metric-name "batteryPercentage" \
    --metric-type "number" \
    --display-name "Remaining battery percentage." \
    --region us-east-1 \
    --client-request-token "02ccb92b-33e8-4dfa-a0c1-35b181ed26b0"

Sortie :

{
    "metricName": "batteryPercentage",
    "metricArn": "arn:aws:iot:us-east-1:1234564789012:custommetric/batteryPercentage"
}

Pour plus d'informations, consultez la section Mesures personnalisées dans le Guide du développeur AWS IoT Core.

Pour créer une dimension

Ce qui suit create-dimension crée une dimension avec un filtre de rubrique unique appeléTopicFilterForAuthMessages.

aws iot create-dimension \
    --name TopicFilterForAuthMessages \
    --type TOPIC_FILTER \
    --string-values device/+/auth

Sortie :

{
    "name": "TopicFilterForAuthMessages",
    "arn": "arn:aws:iot:eu-west-2:123456789012:dimension/TopicFilterForAuthMessages"
}

Pour plus d'informations, consultez la section Détecter les commandes dans le guide du développeur de l'AWS IoT.

Pour créer une configuration de domaine

L'create-domain-configurationexemple suivant crée une configuration de domaine AWS géré avec un type de service deDATA.

aws iot create-domain-configuration \
    --domain-configuration-name "additionalDataDomain" \
    --service-type "DATA"

Sortie :

{
    "domainConfigurationName": "additionalDataDomain",
    "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/additionalDataDomain/dikMh"
}

Pour plus d'informations, consultez la section Points de terminaison configurables dans le Guide du développeur de l'AWS IoT.

Pour créer un groupe d'objets dynamique

L'create-dynamic-thing-groupexemple suivant crée un groupe d'objets dynamique qui contient tout objet dont l'attribut de température est supérieur à 60 degrés. Vous devez activer AWS l'indexation des flottes IoT avant de pouvoir utiliser des groupes d'objets dynamiques.

aws iot create-dynamic-thing-group \
    --thing-group-name "RoomTooWarm" \
    --query-string "attributes.temperature>60"

Sortie :

{
    "thingGroupName": "RoomTooWarm",
    "thingGroupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/RoomTooWarm",
    "thingGroupId": "9d52492a-fc87-43f4-b6e2-e571d2ffcad1",
    "indexName": "AWS_Things",
    "queryString": "attributes.temperature>60",
    "queryVersion": "2017-09-30"
}

Pour plus d'informations, consultez Dynamic Thing Groups dans le Guide du développeur AWS IoT.

Exemple 1 : pour créer une tâche

L'create-jobexemple suivant crée une tâche AWS IoT simple qui envoie un document JSON à l'MyRaspberryPiappareil.

aws iot create-job \
    --job-id "example-job-01" \
    --targets "arn:aws:iot:us-west-2:123456789012:thing/MyRaspberryPi" \
    --document file://example-job.json \
    --description "example job test" \
    --target-selection SNAPSHOT

Sortie :

{
    "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-01",
    "jobId": "example-job-01",
    "description": "example job test"
}

Exemple 2 : pour créer une tâche continue

L'create-jobexemple suivant crée une tâche qui continue de s'exécuter une fois que les éléments spécifiés comme cibles ont terminé la tâche. Dans cet exemple, la cible est un groupe d'objets. Ainsi, lorsque de nouveaux appareils sont ajoutés au groupe, le travail continu s'exécute sur ces nouveaux objets.

aws iot create-job --job-id « example-job-04" --targets « arn:aws:iot:us-west- 2:123456789012 : -job.json --description « exemple de tâche continue » --target-selection CONTINUOUS thinggroup/DeadBulbs" --document file://example

Sortie :

{
    "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-04",
    "jobId": "example-job-04",
    "description": "example continuous job"
}

Pour plus d'informations, consultez Creating and Managing Jobs (CLI) dans le Guide du développeur de l'AWS IoT.

Pour créer une paire de clés RSA et émettre un certificat X.509

Ce qui suit create-keys-and-certificate crée une paire de clés RSA 2048 bits et émet un certificat X.509 à l'aide de la clé publique émise. Comme c'est la seule fois où l' AWS IoT fournit la clé privée pour ce certificat, veillez à le conserver dans un endroit sécurisé.

aws iot create-keys-and-certificate \
    --certificate-pem-outfile "myTest.cert.pem" \
    --public-key-outfile "myTest.public.key" \
    --private-key-outfile "myTest.private.key"

Sortie :

{
    "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/9894ba17925e663f1d29c23af4582b8e3b7619c31f3fbd93adcb51ae54b83dc2",
    "certificateId": "9894ba17925e663f1d29c23af4582b8e3b7619c31f3fbd93adcb51ae54b83dc2",
    "certificatePem": "
-----BEGIN CERTIFICATE-----
MIICiTCCEXAMPLE6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC
VVMxCzAJBgNVBAgEXAMPLEAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
b24xFDASBgNVBAsTC0lBTSEXAMPLE2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
BgkqhkiG9w0BCQEWEG5vb25lQGFtYEXAMPLEb20wHhcNMTEwNDI1MjA0NTIxWhcN
MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCEXAMPLEJBgNVBAgTAldBMRAwDgYD
VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDAEXAMPLEsTC0lBTSBDb25z
b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEXAMPLE25lQGFt
YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+aEXAMPLE
EXAMPLEfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T
rDHudUZEXAMPLELG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE
Ibb3OhjZnzcvQAEXAMPLEWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4
nUhVVxYUntneD9+h8Mg9qEXAMPLEyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
FFBjvSfpJIlJ00zbhNYS5f6GuoEDEXAMPLEBHjJnyp378OD8uTs7fLvjx79LjSTb
NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=
-----END CERTIFICATE-----\n",
    "keyPair": {
        "PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkEXAMPLEQEFAAOCAQ8AMIIBCgKCAQEAEXAMPLE1nnyJwKSMHw4h\nMMEXAMPLEuuN/dMAS3fyce8DW/4+EXAMPLEyjmoF/YVF/gHr99VEEXAMPLE5VF13\n59VK7cEXAMPLE67GK+y+jikqXOgHh/xJTwo+sGpWEXAMPLEDz18xOd2ka4tCzuWEXAMPLEahJbYkCPUBSU8opVkR7qkEXAMPLE1DR6sx2HocliOOLtu6Fkw91swQWEXAMPLE\GB3ZPrNh0PzQYvjUStZeccyNCx2EXAMPLEvp9mQOUXP6plfgxwKRX2fEXAMPLEDa\nhJLXkX3rHU2xbxJSq7D+XEXAMPLEcw+LyFhI5mgFRl88eGdsAEXAMPLElnI9EesG\nFQIDAQAB\n-----END PUBLIC KEY-----\n",
        "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nkey omittted for security reasons\n-----END RSA PRIVATE KEY-----\n"
    }
}

Pour plus d'informations, consultez la section Création et enregistrement d'un certificat d'appareil AWS IoT dans le guide du développeur AWS IoT.

Pour créer une action d'atténuation

L'create-mitigation-actionexemple suivant définit une action d'atténuation nommée AddThingsToQuarantineGroup1Action qui, lorsqu'elle est appliquée, déplace les objets dans le groupe d'objets nomméQuarantineGroup1. Cette action remplace les groupes d'objets dynamiques.

aws iot create-mitigation-action --cli-input-json file::params.json

Contenu de params.json :

{
    "actionName": "AddThingsToQuarantineGroup1Action",
    "actionParams": {
        "addThingsToThingGroupParams": {
            "thingGroupNames": [
                "QuarantineGroup1"
            ],
            "overrideDynamicGroups": true
        }
    },
    "roleArn": "arn:aws:iam::123456789012:role/service-role/MoveThingsToQuarantineGroupRole"
}

Sortie :

{
    "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/AddThingsToQuarantineGroup1Action",
    "actionId": "992e9a63-a899-439a-aa50-4e20c52367e1"
}

Pour plus d'informations, voir CreateMitigationAction (Mitigation Action Commands) dans le Guide du développeur de l'AWS IoT.

Pour créer une mise à jour OTA à utiliser avec Amazon FreeRTOS

L'create-ota-updateexemple suivant crée un AWS IoT OTAUpdate sur un groupe cible d'objets ou de groupes. Cela fait partie d'une mise à jour d'Amazon over-the-air FreeRTOS qui vous permet de déployer de nouvelles images de microprogramme sur un seul appareil ou un groupe d'appareils.

aws iot create-ota-update \
    --cli-input-json file://create-ota-update.json

Contenu de create-ota-update.json :

{
    "otaUpdateId": "ota12345",
    "description": "A critical update needed right away.",
    "targets": [
        "device1",
        "device2",
        "device3",
        "device4"
    ],
    "targetSelection": "SNAPSHOT",
    "awsJobExecutionsRolloutConfig": {
        "maximumPerMinute": 10
    },
    "files": [
        {
          "fileName": "firmware.bin",
          "fileLocation": {
            "stream": {
              "streamId": "004",
              "fileId":123
            }
          },
          "codeSigning": {
            "awsSignerJobId": "48c67f3c-63bb-4f92-a98a-4ee0fbc2bef6"
          }
        }
    ]
    "roleArn": "arn:aws:iam:123456789012:role/service-role/my_ota_role"
}

Sortie :

{
     "otaUpdateId": "ota12345",
     "awsIotJobId": "job54321",
     "otaUpdateArn": "arn:aws:iot:us-west-2:123456789012:otaupdate/itsaupdate",
     "awsIotJobArn": "arn:aws:iot:us-west-2:123456789012:job/itsajob",
     "otaUpdateStatus": "CREATE_IN_PROGRESS"
}

Pour plus d'informations, consultez la section Créer OTAUpdate dans le guide de référence des API AWS IoT.

Pour mettre à jour une politique avec une nouvelle version

L'create-policy-versionexemple suivant met à jour une définition de stratégie en créant une nouvelle version de stratégie. Cet exemple fait également de la nouvelle version la version par défaut.

aws iot create-policy-version \
    --policy-name UpdateDeviceCertPolicy \
    --policy-document file://policy.json \
    --set-as-default

Contenu de policy.json :

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action":  "iot:UpdateCertificate",
            "Resource": "*"
        }
    ]
}

Sortie :

{
    "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/UpdateDeviceCertPolicy",
    "policyDocument": "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Effect\": \"Allow\", \"Action\":  \"iot:UpdateCertificate\", \"Resource\": \"*\" } ] }",
    "policyVersionId": "2",
    "isDefaultVersion": true
}

Pour plus d'informations, consultez la section Politiques relatives à l'AWS IoT dans le Guide du développeur de l'AWS IoT.

Pour créer une politique AWS IoT

L'create-policyexemple suivant crée une politique AWS IoT nommée TemperatureSensorPolicy. Le policy.json fichier contient des déclarations qui autorisent les actions politiques AWS relatives à l'IoT.

aws iot create-policy \
    --policy-name TemperatureSensorPolicy \
    --policy-document file://policy.json

Contenu de policy.json :

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iot:Publish",
                "iot:Receive"
            ],
            "Resource": [
                "arn:aws:iot:us-west-2:123456789012:topic/topic_1",
                "arn:aws:iot:us-west-2:123456789012:topic/topic_2"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:Subscribe"
            ],
            "Resource": [
                "arn:aws:iot:us-west-2:123456789012:topicfilter/topic_1",
                "arn:aws:iot:us-west-2:123456789012:topicfilter/topic_2"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:Connect"
            ],
            "Resource": [
                "arn:aws:iot:us-west-2:123456789012:client/basicPubSub"
            ]
        }
    ]
}

Sortie :

{
    "policyName": "TemperatureSensorPolicy",
    "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TemperatureSensorPolicy",
    "policyDocument": "{
        \"Version\": \"2012-10-17\",
        \"Statement\": [
            {
                \"Effect\": \"Allow\",
                \"Action\": [
                    \"iot:Publish\",
                    \"iot:Receive\"
                ],
                \"Resource\": [
                    \"arn:aws:iot:us-west-2:123456789012:topic/topic_1\",
                    \"arn:aws:iot:us-west-2:123456789012:topic/topic_2\"
                ]
            },
            {
                \"Effect\": \"Allow\",
                \"Action\": [
                    \"iot:Subscribe\"
                ],
                \"Resource\": [
                    \"arn:aws:iot:us-west-2:123456789012:topicfilter/topic_1\",
                    \"arn:aws:iot:us-west-2:123456789012:topicfilter/topic_2\"
                ]
            },
            {
                \"Effect\": \"Allow\",
                \"Action\": [
                    \"iot:Connect\"
                ],
                \"Resource\": [
                    \"arn:aws:iot:us-west-2:123456789012:client/basicPubSub\"
                ]
            }
        ]
    }",
    "policyVersionId": "1"
}

Pour plus d'informations, consultez la section Politiques relatives à l'AWS IoT dans le Guide du développeur de l'AWS IoT.

Pour créer une demande de provisionnement

L'create-provisioning-claimexemple suivant crée une demande d'approvisionnement à partir d'un modèle de provisionnement.

aws iot create-provisioning-claim \
    --template-name MyTestProvisioningTemplate

Sortie :

{
    "certificateId": "78de02184b2ce80cf8fb709bda59e62b19fb83513590483eb0434589476ab09f",
    "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDdzCCAl+gAwIBAgIUXSZhEBLztMLZ2fHG
14gV0NymYY0wDQYJKoZIhvcNAQEL\nBQAwfjELMAkGA1UEBhMCVVMxEzARBgNVBAgMCldhc2hpbmd0b24xEDAOBg
VBAcM\nB1NlYXR0bGUxGDAWBgNVBAoMD0FtYXpvbi5jb20gSW5jLjEgMB4GA1UECwwXQW1h\nem9uIElvVCBQcm9
2aXNpb25pbmcxDDAKBgNVBAUTAzEuMDAeFw0yMDA3MjgxNjQ0\nMDZaFw0yMDA3MjgxNjUxMDZaMEsxSTBHBgNVB
AMMQDFhNDEyM2VkNmIxYjU3MzE3\nZTgzMTJmY2MzN2FiNTdhY2MzYTZkZGVjOGQ5OGY3NzUwMWRlMjc0YjhmYTQ
xN2Iw\nggEiMA0GCSqGSIb3EXAMPLEAA4IBDwAwggEKAoIBAQDBhKI94ktKLqTwnj+ayOq1\nTAJt/N6s6IJDZvl
rYjkC0E7wzaeY3TprWk03S29vUzVuEOXHXQXZbihgpg2m6fza\nkWm9/wpjzE9ny5+xkPGVH4Wnwz7yK5m8S0agL
T96cRBSWnWmonOWdY0GKVzni0CA\n+iyGudgrFKm7Eae/v18oXrf82KtOAGO4xG0KE2WKYHsT1fx3c9xZhlXP/eX
Lhv00\n+lGp0WVw9PbhKfrxliKJ5q6sL5nVUaUHq6hlQPYwsATeOvAp3u0ak5zgTyL0fg7Y\nPyKk6VYwLW62r+V
YBSForEMOAhkq3LsP/rjxpEKmi2W4lPVS6oFZRKcD+H1Kyil5\nAgMBAAGjIDAeMAwGA1UdEwEB/wQCMAAwDgYDV
R0PAQH/BAQDAgeAMA0GCSqGSIb3\nDQEBCwUAA4IBAQAGgix2k6nVqbZFKq97/fZBzLGS0dyz5rT/E41cDIRX+1j
EPW41\nw0D+2sXheCZLZZnSkvIiP74IToNeXDrjdcaodeGFVHIElRjhMIq+4ZebPbRLtidF\nRc2hfcTAlqq9Z6v
5Vk6BeM1tu0RqH1wPoVUccLPya8EjNCbnJZUmGdOfrN/Y9pho\n5ikV+HPeZhG/k6dhE2GsQJyKFVHL/uBgKSily
1bRyWU1r6qcpWBNBHjUoD7HgOwD\nnzMh4XRb2FQDsqFalkCSYmeL8IVC49sgPD9Otyp5uteGMTy62usAAUQdq/f
ZvrWg\nOkFpwMVnGKVKT7Kg0kKOLzKWOBB2Jm4/gmrJ\n-----END CERTIFICATE-----\n",
    "keyPair": {
        "PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCg
KCAQEAwYSiPeJLSi6k8J4/msjq\ntUwCbfzerOiCQ2b5a2I5AtBO8M2nmN06a1pNN0tvb1M1bhDlx10F2W4oYKYN
pun8\n2pFpvf8KY8xPZ8ufsZDxlR+Fp8M+8iuZvEtGoC0/enEQUlp1pqJzlnWNBilc54tA\ngPoshrnYKxSpuxGn
v79fKF63/NirTgBjuMRtChNlimEXAMPLE3PcWYZVz/3ly4b9\nNPpRqdFlcPT24Sn68ZYiieaurC+Z1VGlB6uoZU
D2MLAE3jrwKd7tGpOc4E8i9H4O\n2D8ipOlWMC1utq/lWAUhaKxDDgIZKty7D/648aRCpotluJT1UuqBWUSnA/h9
Ssop\neQIDAQAB\n-----END PUBLIC KEY-----\n",
        "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIBAAKCAQEAwYSiPeJLSi6k8J4/
msjqtUwCbfzerOiCQ2b5a2I5AtBO8M2n\nmN06a1pNN0tvb1M1bhDlx10F2W4oYKYNpun82pFpvf8KY8xPZ8ufsZ
DxlR+Fp8M+\n8iuZvEtGoC0/enEQUlp1pqJzlnWNBilc54tAgPoshrnYKxSpuxGnv79fKF63/Nir\nTgBjuMRtCh
NlimB7E9X8d3PcWYZVz/3ly4b9NPpRqdFlcPT24Sn68ZYiieaurC+Z\n1VGlB6uoZUD2MLAE3jrwKd7tGpOc4E8i
9H4O2D8ipOlWMC1utq/lWAUhaKxDDgIZ\nKty7D/648aRCpotluJT1UuqBWUSnA/h9SsopeQIDAQABAoIBAEAybN
QUtx9T2/nK\ntZT2pA4iugecxI4dz+DmT0XVXs5VJmrx/nBSq6ejXExEpSIMO4RY7LE3ZdJcnd56\nF7tQkkY7yR
VzfxHeXFU1krOIPuxWebNOrRoPZr+1RSer+wv2aBC525+88pVuR6tM\nm3pgkrR2ycCj9FdOUoQxdjHBHaM5PDmJ
9aSxCKdg3nReepeGwsR2TQA+m2vVxWk7\nou0+91eTOP+/QfP7P8ZjOIkO2XivlRcVDyN/E4QXPKuIkM/8vS8VK+
E9pATQ0MtB\n2lw8R/YU5AJd6jlEXAMPLEGU2UzRzInNWiLtkPPPqgqXXhxOf+mxByjcMalVJk0L\nhOG2ROUCgY
EA+ROcHNHy/XbsP7FihOhEh+6Q2QxQ2ncBUPYbBazrR8Hn+7SCICQK\nVyYfd8Ajfq3e7RsKVL5SlMBp7Slidxak
bIn28fKfPn62DaemGCIoyDgLpF+eUxBx\ngzbCiBZga8brfurza43UZjKZLpg3hq721+FeAiXi1Nma4Yr9YWEHEN
8CgYEAxuWt\npzdWWmsiFzfsAw0sy9ySDA/xr5WRWzJyAqUsjsks6rxNzWebpufnYHcmtW7pLdqM\nkboHwN2pXa
kmZvrk2nKkEMq5brBYGDXuxDe+V369Bianx8aZFyIsckA7OwXW1w1h\ngRC5rQ4XOgp3+Jmw7eAO8LRYDjaN846+
QbtO2KcCgYAWS0UL51bijQR0ZwI0dz27\nFQVuCAYsp748aurcRTACCj8jbnK/QbqTNlxWsaH7ssBjZKo2D5sAqY
BRtASWODab\naHXsDhVm2Jye+ESLoHMaCLoyCkT3ll8yqXIcEDStMO7fO1Ryag164EiJvSIrMfny\nNL/fXVjCSH
/udCxdzPt+7QKBgQC+LAD7rxdr4J9538hTqpc4XK9vxRbrMXEH55XH\nHbMa2xONZXpmeTgEQBukyohCVceyRhK9
i0e6irZTjVXghOeoTpC8VXkzcnzouTiQ\neFQQSGfnp7Ioe6UIz23715pKduzSNkMSKrG924ktv7CyDBF1gBQI5g
aDoHnddJBJ\nPRTIZQKBgA8MASXtTxQntRwXXzR92U0vAighiuRkB/mx9jQpUcK1qiqHbkAMqgNF\nPFCBYIUbFT
iYKKKeJNbyJQvjfsJCkAnaFJ+RnTxk0Q6Wjm20peJ/ii4QiDdnigoE\nvdlc5cFQewWb4/zqAtPdinkPlN94ileI
79XQdc7RlJ0jpgTimL+V\n-----END RSA PRIVATE KEY-----\n"
    },
    "expiration": 1595955066.0
}

Pour plus d'informations, consultez la section Provisionnement par un utilisateur de confiance dans le Guide du développeur AWS IoT Core.

Pour créer une version du modèle de provisionnement

L'exemple suivant crée une version pour le modèle de provisionnement spécifié. Le corps de la nouvelle version est fourni dans le fichiertemplate.json.

aws iot create-provisioning-template-version \
    --template-name widget-template \
    --template-body file://template.json

Contenu de template.json :

{
    "Parameters" : {
        "DeviceLocation": {
            "Type": "String"
        }
    },
    "Mappings": {
        "LocationTable": {
            "Seattle": {
                "LocationUrl": "https://example.aws"
            }
        }
    },
    "Resources" : {
        "thing" : {
            "Type" : "AWS::IoT::Thing",
            "Properties" : {
                "AttributePayload" : {
                    "version" : "v1",
                    "serialNumber" : "serialNumber"
                },
                "ThingName" : {"Fn::Join":["",["ThingPrefix_",{"Ref":"SerialNumber"}]]},
                "ThingTypeName" : {"Fn::Join":["",["ThingTypePrefix_",{"Ref":"SerialNumber"}]]},
                "ThingGroups" : ["widgets", "WA"],
                "BillingGroup": "BillingGroup"
            },
            "OverrideSettings" : {
                "AttributePayload" : "MERGE",
                "ThingTypeName" : "REPLACE",
                "ThingGroups" : "DO_NOTHING"
            }
        },
        "certificate" : {
            "Type" : "AWS::IoT::Certificate",
            "Properties" : {
                "CertificateId": {"Ref": "AWS::IoT::Certificate::Id"},
                "Status" : "Active"
            }
        },
        "policy" : {
            "Type" : "AWS::IoT::Policy",
            "Properties" : {
                "PolicyDocument" : {
                    "Version": "2012-10-17",
                    "Statement": [{
                        "Effect": "Allow",
                        "Action":["iot:Publish"],
                        "Resource": ["arn:aws:iot:us-east-1:123456789012:topic/foo/bar"]
                    }]
                }
            }
        }
    },
    "DeviceConfiguration": {
        "FallbackUrl": "https://www.example.com/test-site",
        "LocationUrl": {
            "Fn::FindInMap": ["LocationTable",{"Ref": "DeviceLocation"}, "LocationUrl"]}
        }
    }
}

Sortie :

{
    "templateArn": "arn:aws:iot:us-east-1:123456789012:provisioningtemplate/widget-template",
    "templateName": "widget-template",
    "versionId": 2,
    "isDefaultVersion": false
}

Pour plus d'informations, consultez la section AWS IoT Secure Tunneling dans le guide du développeur AWS IoT Core.

Pour créer un modèle de provisionnement

L'create-provisioning-templateexemple suivant crée un modèle de provisionnement tel que défini par le fichiertemplate.json.

aws iot create-provisioning-template \
    --template-name widget-template \
    --description "A provisioning template for widgets" \
    --provisioning-role-arn arn:aws:iam::123456789012:role/Provision_role \
    --template-body file://template.json

Contenu de template.json :

{
    "Parameters" : {
        "DeviceLocation": {
            "Type": "String"
        }
    },
    "Mappings": {
        "LocationTable": {
            "Seattle": {
                "LocationUrl": "https://example.aws"
            }
        }
    },
    "Resources" : {
        "thing" : {
            "Type" : "AWS::IoT::Thing",
            "Properties" : {
                "AttributePayload" : {
                    "version" : "v1",
                    "serialNumber" : "serialNumber"
                },
                "ThingName" : {"Fn::Join":["",["ThingPrefix_",{"Ref":"SerialNumber"}]]},
                "ThingTypeName" : {"Fn::Join":["",["ThingTypePrefix_",{"Ref":"SerialNumber"}]]},
                "ThingGroups" : ["widgets", "WA"],
                "BillingGroup": "BillingGroup"
            },
            "OverrideSettings" : {
                "AttributePayload" : "MERGE",
                "ThingTypeName" : "REPLACE",
                "ThingGroups" : "DO_NOTHING"
            }
        },
        "certificate" : {
            "Type" : "AWS::IoT::Certificate",
            "Properties" : {
                "CertificateId": {"Ref": "AWS::IoT::Certificate::Id"},
                "Status" : "Active"
            }
        },
        "policy" : {
            "Type" : "AWS::IoT::Policy",
            "Properties" : {
                "PolicyDocument" : {
                    "Version": "2012-10-17",
                    "Statement": [{
                        "Effect": "Allow",
                        "Action":["iot:Publish"],
                        "Resource": ["arn:aws:iot:us-east-1:504350838278:topic/foo/bar"]
                    }]
                }
            }
        }
    },
    "DeviceConfiguration": {
        "FallbackUrl": "https://www.example.com/test-site",
        "LocationUrl": {
            "Fn::FindInMap": ["LocationTable",{"Ref": "DeviceLocation"}, "LocationUrl"]}
        }
    }
}

Sortie :

{
    "templateArn": "arn:aws:iot:us-east-1:123456789012:provisioningtemplate/widget-template",
    "templateName": "widget-template",
    "defaultVersionId": 1
}

Pour plus d'informations, consultez la section AWS IoT Secure Tunneling dans le guide du développeur AWS IoT Core.

Pour créer un alias de rôle

L'create-role-aliasexemple suivant crée un alias de rôle appelé LightBulbRole pour le rôle spécifié.

aws iot create-role-alias \
    --role-alias LightBulbRole \
    --role-arn arn:aws:iam::123456789012:role/lightbulbrole-001

Sortie :

{
    "roleAlias": "LightBulbRole",
    "roleAliasArn": "arn:aws:iot:us-west-2:123456789012:rolealias/LightBulbRole"
}

Pour plus d'informations, consultez CreateRoleAliasle manuel de référence des API AWS IoT.

Pour créer un audit planifié

L'create-scheduled-auditexemple suivant crée un audit planifié qui s'exécute chaque semaine, le mercredi, pour vérifier si les certificats CA ou les certificats d'appareil expirent.

aws iot create-scheduled-audit \
    --scheduled-audit-name WednesdayCertCheck \
    --frequency WEEKLY \
    --day-of-week WED \
    --target-check-names CA_CERTIFICATE_EXPIRING_CHECK DEVICE_CERTIFICATE_EXPIRING_CHECK

Sortie :

{
    "scheduledAuditArn": "arn:aws:iot:us-west-2:123456789012:scheduledaudit/WednesdayCertCheck"
}

Pour plus d'informations, consultez la section Commandes d'audit du guide du développeur de l'AWS IoT.

Pour créer un profil de sécurité

L'create-security-profileexemple suivant crée un profil de sécurité qui vérifie si la bande passante cellulaire dépasse un seuil ou si plus de 10 échecs d'autorisation se produisent sur une période de cinq minutes.

aws iot create-security-profile \
    --security-profile-name PossibleIssue \
    --security-profile-description "Check to see if authorization fails 10 times in 5 minutes or if cellular bandwidth exceeds 128"  \
    --behaviors "[{\"name\":\"CellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}},{\"name\":\"Authorization\",\"metric\":\"aws:num-authorization-failures\",\"criteria\":{\"comparisonOperator\":\"less-than\",\"value\":{\"count\":10},\"durationSeconds\":300,\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}}]"

Sortie :

{
    "securityProfileName": "PossibleIssue",
    "securityProfileArn": "arn:aws:iot:us-west-2:123456789012:securityprofile/PossibleIssue"
}

Pour plus d'informations, consultez la section Détecter les commandes dans le guide du développeur de l'AWS IoT.

Pour créer un flux permettant de distribuer un ou plusieurs fichiers volumineux en morceaux via MQTT

L'create-streamexemple suivant crée un flux pour distribuer un ou plusieurs fichiers volumineux par blocs via MQTT. Un flux transfère des octets de données dans des fragments ou blocs packagés sous forme de messages MQTT à partir d'une source telle que S3. Un ou plusieurs fichiers peuvent être associés à un flux.

aws iot create-stream \
    --cli-input-json file://create-stream.json

Contenu de create-stream.json :

{
    "streamId": "stream12345",
    "description": "This stream is used for Amazon FreeRTOS OTA Update 12345.",
    "files": [
        {
            "fileId": 123,
            "s3Location": {
                "bucket":"codesign-ota-bucket",
                "key":"48c67f3c-63bb-4f92-a98a-4ee0fbc2bef6"
            }
        }
    ],
    "roleArn": "arn:aws:iam:123456789012:role/service-role/my_ota_stream_role"
}

Sortie :

{
     "streamId": "stream12345",
     "streamArn": "arn:aws:iot:us-west-2:123456789012:stream/stream12345",
     "description": "This stream is used for Amazon FreeRTOS OTA Update 12345.",
     "streamVersion": "1"
}

Pour plus d'informations, consultez CreateStreamle manuel de référence des API AWS IoT.

Exemple 1 : pour créer un groupe d'objets

L'create-thing-groupexemple suivant crée un groupe d'objets nommé LightBulbs avec une description et deux attributs.

aws iot create-thing-group \
    --thing-group-name LightBulbs \
    --thing-group-properties "thingGroupDescription=\"Generic bulb group\", attributePayload={attributes={Manufacturer=AnyCompany,wattage=60}}"

Sortie :

{
    "thingGroupName": "LightBulbs",
    "thingGroupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs",
    "thingGroupId": "9198bf9f-1e76-4a88-8e8c-e7140142c331"
}

Exemple 2 : pour créer un groupe d'objets faisant partie d'un groupe parent

Ce qui suit create-thing-group crée un groupe d'objets nommé HalogenBulbs dont le groupe d'objets parent est nomméLightBulbs.

aws iot create-thing-group \
    --thing-group-name HalogenBulbs \
    --parent-group-name LightBulbs

Sortie :

{
    "thingGroupName": "HalogenBulbs",
    "thingGroupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/HalogenBulbs",
    "thingGroupId": "f4ec6b84-b42b-499d-9ce1-4dbd4d4f6f6e"
}

Pour plus d'informations, consultez la section Thing Groups dans le guide du développeur AWS IoT.

Pour définir un type d'objet

L'create-thing-typeexemple suivant définit un type d'objet et les attributs associés.

aws iot create-thing-type \
    --thing-type-name "LightBulb" \
    --thing-type-properties "thingTypeDescription=light bulb type, searchableAttributes=wattage,model"

Sortie :

{
    "thingTypeName": "LightBulb",
    "thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb",
    "thingTypeId": "ce3573b0-0a3c-45a7-ac93-4e0ce14cd190"
}

Pour plus d'informations, consultez la section Types d'objets dans le Guide du développeur de l'AWS IoT.

Exemple 1 : pour créer un enregistrement d'objet dans le registre

L'create-thingexemple suivant crée une entrée pour un appareil dans le registre AWS des objets IoT.

aws iot create-thing \
    --thing-name SampleIoTThing

Sortie :

{
    "thingName": "SampleIoTThing",
    "thingArn": "arn:aws:iot:us-west-2: 123456789012:thing/SampleIoTThing",
    "thingId": " EXAMPLE1-90ab-cdef-fedc-ba987EXAMPLE "
}

Exemple 2 : pour définir un objet associé à un type d'objet

L'create-thingexemple suivant crée un objet doté du type d'objet spécifié et de ses attributs.

aws iot create-thing \
    --thing-name "MyLightBulb" \
    --thing-type-name "LightBulb" \
    --attribute-payload "{"attributes": {"wattage":"75", "model":"123"}}"

Sortie :

{
    "thingName": "MyLightBulb",
    "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb",
    "thingId": "40da2e73-c6af-406e-b415-15acae538797"
}

Pour plus d'informations, consultez la section Comment gérer les objets avec le registre et les types d'objets dans le Guide du développeur de l'AWS IoT.

Pour créer une destination de règle de sujet

L'create-topic-rule-destinationexemple suivant crée une destination de règle de sujet pour un point de terminaison HTTP.

aws iot create-topic-rule-destination \
    --destination-configuration httpUrlConfiguration={confirmationUrl=https://example.com}

Sortie :

{
    "topicRuleDestination": {
        "arn": "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
        "status": "IN_PROGRESS",
        "statusReason": "Awaiting confirmation. Confirmation message sent on 2020-07-09T22:47:54.154Z; no response received from the endpoint.",
        "httpUrlProperties": {
            "confirmationUrl": "https://example.com"
        }
    }
}

Pour plus d'informations, consultez la section Création d'une destination de règle de sujet dans le Guide du développeur de l'AWS IoT.

Pour créer une règle qui envoie une alerte Amazon SNS

L'create-topic-ruleexemple suivant crée une règle qui envoie un message Amazon SNS lorsque les relevés du niveau d'humidité du sol, tels qu'ils apparaissent dans l'ombre d'un appareil, sont faibles.

aws iot create-topic-rule \
    --rule-name "LowMoistureRule" \
    --topic-rule-payload file://plant-rule.json

L'exemple nécessite que le code JSON suivant soit enregistré dans un fichier nommé plant-rule.json :

{
    "sql": "SELECT * FROM '$aws/things/MyRPi/shadow/update/accepted' WHERE state.reported.moisture = 'low'\n",
    "description": "Sends an alert whenever soil moisture level readings are too low.",
    "ruleDisabled": false,
    "awsIotSqlVersion": "2016-03-23",
    "actions": [{
            "sns": {
                "targetArn": "arn:aws:sns:us-west-2:123456789012:MyRPiLowMoistureTopic",
                "roleArn": "arn:aws:iam::123456789012:role/service-role/MyRPiLowMoistureTopicRole",
                "messageFormat": "RAW"
            }
    }]
}

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Création d'une règle AWS IoT dans le Guide du développeur AWS IoT.

Pour désactiver toutes les vérifications d'audit de votre AWS compte

L'delete-account-audit-configurationexemple suivant restaure les paramètres par défaut d' AWS IoT Device Defender pour ce compte, en désactivant tous les contrôles d'audit et en effaçant les données de configuration. Il supprime également tous les audits planifiés pour ce compte. Utilisez cette commande avec prudence.

aws iot delete-account-audit-configuration \
    --delete-scheduled-audits

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Commandes d'audit du guide du développeur de l'AWS IoT.

Pour supprimer une suppression des résultats d'audit

L'delete-audit-suppressionexemple suivant supprime une suppression des résultats d'audit pour DEVICE_CERTIFICATE_EXPIRING_CHECK.

aws iot delete-audit-suppression \
    --check-name DEVICE_CERTIFICATE_EXPIRING_CHECK \
    --resource-identifier deviceCertificateId="c7691e<shortened>"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Audit sur les suppressions dans le Guide du développeur de l'AWS IoT.

Pour supprimer un autorisateur personnalisé

L'delete-authorizerexemple suivant supprime l'autorisateur nommé. CustomAuthorizer Un autorisateur personnalisé doit être dans INACTIVE cet état pour que vous puissiez le supprimer.

aws iot delete-authorizer \
    --authorizer-name CustomAuthorizer

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez DeleteAuthorizerle Guide du développeur de AWS l'IoT.

Pour supprimer un groupe de facturation

L'delete-billing-groupexemple suivant supprime le groupe de facturation spécifié. Vous pouvez supprimer un groupe de facturation même s'il contient un ou plusieurs éléments.

aws iot delete-billing-group \
    --billing-group-name BillingGroupTwo

Cette commande ne génère pas de sortie.

Pour plus d'informations, consultez la section Groupes de facturation dans le Guide du développeur AWS IoT.

Pour supprimer un certificat CA

L'delete-ca-certificateexemple suivant supprime le certificat CA avec l'ID de certificat spécifié.

aws iot delete-ca-certificate \
    --certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467

Cette commande ne produit aucun résultat.

Pour plus d'informations, voir Supprimer CACertificate dans le manuel de référence des API AWS IoT.

Pour supprimer un certificat d'appareil

L'delete-certificateexemple suivant supprime le certificat de l'appareil avec l'ID spécifié.

aws iot delete-certificate \
    --certificate-id c0c57bbc8baaf4631a9a0345c957657f5e710473e3ddbee1428d216d54d53ac9

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez DeleteCertificatele manuel de référence des API AWS IoT.

Pour supprimer une métrique personnalisée

L'delete-custom-metricexemple suivant supprime une métrique personnalisée.

aws iot delete-custom-metric \
    --metric-name batteryPercentage \
    --region us-east-1

Sortie :

HTTP 200

Pour plus d'informations, consultez la section Mesures personnalisées dans le Guide du développeur AWS IoT Core.

Pour supprimer une dimension

L'delete-dimensionexemple suivant supprime une dimension appeléeTopicFilterForAuthMessages.

aws iot delete-dimension \
    --name TopicFilterForAuthMessages

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Détecter les commandes dans le guide du développeur de l'AWS IoT.

Pour supprimer une configuration de domaine

L'delete-domain-configurationexemple suivant supprime une configuration de domaine nommée additionalDataDomain depuis votre AWS compte.

aws iot delete-domain-configuration \
    --domain-configuration-name "additionalDataDomain" \
    --domain-configuration-status "OK"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Points de terminaison configurables dans le Guide du développeur de l'AWS IoT.

Pour supprimer un groupe d'objets dynamique

L'delete-dynamic-thing-groupexemple suivant supprime le groupe d'objets dynamiques spécifié.

aws iot delete-dynamic-thing-group \
    --thing-group-name "RoomTooWarm"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez Dynamic Thing Groups dans le Guide du développeur AWS IoT.

Pour supprimer l'exécution d'une tâche

L'delete-job-executionexemple suivant supprime l'exécution de la tâche spécifiée sur un appareil. describe-job-executionÀ utiliser pour obtenir le numéro d'exécution.

aws iot delete-job-execution
    --job-id "example-job-02"
    --thing-name "MyRaspberryPi"
    --execution-number 1

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez Creating and Managing Jobs (CLI) dans le Guide du développeur de l'AWS IoT.

Pour supprimer une tâche

L'delete-jobexemple suivant supprime la tâche spécifiée. En spécifiant --force cette option, la tâche est supprimée même si son statut estIN_PROGRESS.

aws iot delete-job \
    --job-id "example-job-04" \
    --force

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez Creating and Managing Jobs (CLI) dans le Guide du développeur de l'AWS IoT.

Pour supprimer une action d'atténuation

L'delete-mitigation-actionexemple suivant supprime l'action d'atténuation spécifiée.

aws iot delete-mitigation-action \
    --action-name AddThingsToQuarantineGroup1Action

Cette commande ne produit aucun résultat.

Pour plus d'informations, voir DeleteMitigationAction (Mitigation Action Commands) dans le Guide du développeur de l'AWS IoT.

Pour supprimer une mise à jour OTA

L'delete-ota-updateexemple suivant supprime la mise à jour OTA spécifiée.

aws iot delete-ota-update \
    --ota-update-id ota12345 \
    --delete-stream \
    --force-delete-aws-job

Cette commande ne produit aucun résultat.

Pour plus d'informations, voir Supprimer OTAUpdate dans le manuel de référence des API AWS IoT.

Pour supprimer une version de la politique

L'delete-policy-versionexemple suivant supprime la version 2 de la politique spécifiée de votre AWS compte.

aws iot delete-policy-version \
    --policy-name UpdateDeviceCertPolicy \
    --policy-version-id 2

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Politiques relatives à l'AWS IoT dans le guide du développeur de l'AWS IoT.

Pour supprimer une politique

L'delete-policyexemple suivant supprime la politique spécifiée de votre AWS compte.

aws iot delete-policy --policy-name UpdateDeviceCertPolicy

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Politiques relatives à l'AWS IoT dans le Guide du développeur de l'AWS IoT.

Pour supprimer une version d'un modèle de provisionnement

L'delete-provisioning-template-versionexemple suivant supprime la version 2 du modèle de provisioning spécifié.

aws iot delete-provisioning-template-version \
    --version-id 2 \
    --template-name "widget-template"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section AWS IoT Secure Tunneling dans le guide du développeur AWS IoT Core.

Pour supprimer un modèle de provisionnement

L'delete-provisioning-templateexemple suivant supprime le modèle de provisioning spécifié.

aws iot delete-provisioning-template \
    --template-name widget-template

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section AWS IoT Secure Tunneling dans le guide du développeur AWS IoT Core.

Pour supprimer votre code d'enregistrement

L'delete-registration-codeexemple suivant supprime un code d'enregistrement spécifique à un compte AWS IoT.

aws iot delete-registration-code

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Utiliser votre propre certificat dans le guide du développeur de l'AWS IoT.

Pour supprimer un alias de rôle AWS IoT

L'delete-role-aliasexemple suivant supprime un alias de rôle AWS IoT nomméLightBulbRole.

aws iot delete-role-alias \
    --role-alias LightBulbRole

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Autorisation des appels directs vers AWS des services dans le Guide du développeur de l'AWS IoT.

Pour supprimer un audit planifié

L'delete-scheduled-auditexemple suivant supprime l'audit planifié AWS IoT Device Defender nomméAWSIoTDeviceDefenderDailyAudit.

aws iot delete-scheduled-audit \
    --scheduled-audit-name AWSIoTDeviceDefenderDailyAudit

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Commandes d'audit du guide du développeur de l'AWS IoT.

Pour supprimer un profil de sécurité

L'delete-security-profileexemple suivant supprime un profil de sécurité nomméPossibleIssue.

aws iot delete-security-profile \
    --security-profile-name PossibleIssue

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Détecter les commandes dans le guide du développeur de l'AWS IoT.

Pour supprimer un flux

L'delete-streamexemple suivant supprime le flux spécifié.

aws iot delete-stream \
    --stream-id stream12345

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez DeleteStreamle manuel de référence des API AWS IoT.

Pour supprimer un groupe d'objets

L'delete-thing-groupexemple suivant supprime le groupe d'objets spécifié. Vous ne pouvez pas supprimer un groupe d'objets s'il contient des groupes d'objets enfants.

aws iot delete-thing-group \
    --thing-group-name DefectiveBulbs

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Thing Groups dans le guide du développeur AWS IoT.

Exemple 1 : pour supprimer un type d'objet

L'delete-thing-typeexemple suivant supprime un type d'objet obsolète.

aws iot delete-thing-type \
    --thing-type-name "obsoleteThingType"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Types d'objets dans le Guide du développeur de l'AWS IoT.

Pour afficher des informations détaillées sur un objet

L'delete-thingexemple suivant supprime un objet du registre AWS IoT de votre AWS compte.

aidez-moi à supprime-thing --thing-name « » FourthBulb

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Comment gérer les objets avec le registre dans le Guide du développeur de l'AWS IoT.

Pour supprimer une destination de règle de sujet

L'delete-topic-rule-destinationexemple suivant supprime la destination de la règle de rubrique spécifiée.

aws iot delete-topic-rule-destination \
    --arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Suppression d'une destination de règle de sujet dans le Guide du développeur de l'AWS IoT.

Pour supprimer une règle

L'delete-topic-ruleexemple suivant supprime la règle spécifiée.

aws iot delete-topic-rule \
    --rule-name "LowMoistureRule"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Supprimer une règle dans le Guide du développeur de l'AWS IoT.

Pour supprimer le niveau de journalisation d'un groupe d'objets

L'delete-v2-logging-levelexemple suivant supprime le niveau de journalisation pour le groupe d'objets spécifié.

aws iot delete-v2-logging-level \
    --target-type THING_GROUP \
    --target-name LightBulbs

Cette commande ne produit aucun résultat.

Exemple 1 : Pour déprécier un type d'objet

L'deprecate-thing-typeexemple suivant déconseille un type d'objet afin que les utilisateurs ne puissent pas y associer de nouveaux éléments.

aws iot deprecate-thing-type \
    --thing-type-name "obsoleteThingType"

Cette commande ne produit aucun résultat.

Exemple 2 : pour annuler la dépréciation d'un type d'objet

L'deprecate-thing-typeexemple suivant inverse la dépréciation d'un type d'objet, ce qui permet aux utilisateurs d'y associer à nouveau de nouveaux éléments.

aws iot deprecate-thing-type \
    --thing-type-name "obsoleteThingType" \
    --undo-deprecate

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Types d'objets dans le Guide du développeur de l'AWS IoT.

Pour consulter les paramètres de configuration d'audit actuels

L'describe-account-audit-configurationexemple suivant répertorie les paramètres actuels de votre configuration d'audit AWS IoT Device Defender.

aws iot describe-account-audit-configuration

Sortie :

{
    "roleArn": "arn:aws:iam::123456789012:role/service-role/AWSIoTDeviceDefenderAudit_1551201085996",
    "auditNotificationTargetConfigurations": {
        "SNS": {
            "targetArn": "arn:aws:sns:us-west-2:123456789012:ddaudits",
            "roleArn": "arn:aws:iam::123456789012:role/service-role/AWSIoTDeviceDefenderAudit",
            "enabled": true
        }
    },
    "auditCheckConfigurations": {
        "AUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK": {
            "enabled": true
        },
        "CA_CERTIFICATE_EXPIRING_CHECK": {
            "enabled": true
        },
        "CONFLICTING_CLIENT_IDS_CHECK": {
            "enabled": true
        },
        "DEVICE_CERTIFICATE_EXPIRING_CHECK": {
            "enabled": true
        },
        "DEVICE_CERTIFICATE_SHARED_CHECK": {
            "enabled": true
        },
        "IOT_POLICY_OVERLY_PERMISSIVE_CHECK": {
            "enabled": true
        },
        "LOGGING_DISABLED_CHECK": {
            "enabled": true
        },
        "REVOKED_CA_CERTIFICATE_STILL_ACTIVE_CHECK": {
            "enabled": true
        },
        "REVOKED_DEVICE_CERTIFICATE_STILL_ACTIVE_CHECK": {
            "enabled": true
        },
        "UNAUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK": {
            "enabled": true
        }
    }
}

Pour plus d'informations, consultez la section Commandes d'audit du guide du développeur de l'AWS IoT.

Pour répertorier les détails d'un résultat d'audit

L'describe-audit-findingexemple suivant répertorie les détails du résultat d'audit AWS IoT Device Defender spécifié. Un audit peut donner lieu à de multiples constatations. Utilisez la list-audit-findings commande pour obtenir la liste des résultats d'un audit afin d'obtenir lefindingId.

aws iot describe-audit-finding \
    --finding-id "ef4826b8-e55a-44b9-b460-5c485355371b"

Sortie :

{
    "finding": {
        "findingId": "ef4826b8-e55a-44b9-b460-5c485355371b",
        "taskId": "873ed69c74a9ec8fa9b8e88e9abc4661",
        "checkName": "IOT_POLICY_OVERLY_PERMISSIVE_CHECK",
        "taskStartTime": 1576012045.745,
        "findingTime": 1576012046.168,
        "severity": "CRITICAL",
        "nonCompliantResource": {
            "resourceType": "IOT_POLICY",
            "resourceIdentifier": {
                "policyVersionIdentifier": {
                    "policyName": "smp-ggrass-group_Core-policy",
                    "policyVersionId": "1"
                }
            }
         },
        "reasonForNonCompliance": "Policy allows broad access to IoT data plane actions: [iot:Subscribe, iot:Connect, iot:GetThingShadow, iot:DeleteThingShadow, iot:UpdateThingShadow, iot:Publish].",
        "reasonForNonComplianceCode": "ALLOWS_BROAD_ACCESS_TO_IOT_DATA_PLANE_ACTIONS"
    }
}

Pour plus d'informations, consultez la section Vérifier les résultats d'audit (commandes d'audit) dans le guide du développeur de l'AWS IoT.

Pour afficher les détails d'une tâche d'audit relative aux mesures d'atténuation

L'describe-audit-mitigation-actions-taskexemple suivant montre les détails de la tâche spécifiée, à laquelle le ResetPolicyVersionAction a été appliqué à un résultat. Les résultats incluent les dates de début et de fin de la tâche, le nombre de résultats ciblés (et le résultat) et la définition de l'action appliquée dans le cadre de cette tâche.

aws iot describe-audit-mitigation-actions-task \
    --task-id ResetPolicyTask01

Sortie :

{
    "taskStatus": "COMPLETED",
    "startTime": "2019-12-10T15:13:19.457000-08:00",
    "endTime": "2019-12-10T15:13:19.947000-08:00",
    "taskStatistics": {
        "IOT_POLICY_OVERLY_PERMISSIVE_CHECK": {
            "totalFindingsCount": 1,
            "failedFindingsCount": 0,
            "succeededFindingsCount": 1,
            "skippedFindingsCount": 0,
            "canceledFindingsCount": 0
        }
    },
    "target": {
        "findingIds": [
            "ef4826b8-e55a-44b9-b460-5c485355371b"
        ]
    },
    "auditCheckToActionsMapping": {
        "IOT_POLICY_OVERLY_PERMISSIVE_CHECK": [
            "ResetPolicyVersionAction"
        ]
    },
    "actionsDefinition": [
        {
            "name": "ResetPolicyVersionAction",
            "id": "1ea0b415-bef1-4a01-bd13-72fb63c59afb",
            "roleArn": "arn:aws:iam::123456789012:role/service-role/ReplacePolicyVersionRole",
            "actionParams": {
                "replaceDefaultPolicyVersionParams": {
                    "templateName": "BLANK_POLICY"
                }
            }
        }
    ]
}

Pour plus d'informations, voir DescribeAuditMitigationActionsTask (Mitigation Action Commands) dans le Guide du développeur de l'AWS IoT.

Pour obtenir des informations sur la suppression d'un résultat d'audit

L'describe-audit-suppressionexemple suivant répertorie les détails relatifs à la suppression d'un résultat d'audit.

aws iot describe-audit-task \
    --task-id "787ed873b69cb4d6cdbae6ddd06996c5"

Sortie :

{
    "taskStatus": "COMPLETED",
    "taskType": "SCHEDULED_AUDIT_TASK",
    "taskStartTime": 1596168096.157,
    "taskStatistics": {
        "totalChecks": 1,
        "inProgressChecks": 0,
        "waitingForDataCollectionChecks": 0,
        "compliantChecks": 0,
        "nonCompliantChecks": 1,
        "failedChecks": 0,
        "canceledChecks": 0
    },
    "scheduledAuditName": "AWSIoTDeviceDefenderDailyAudit",
    "auditDetails": {
        "DEVICE_CERTIFICATE_EXPIRING_CHECK": {
            "checkRunStatus": "COMPLETED_NON_COMPLIANT",
            "checkCompliant": false,
            "totalResourcesCount": 195,
            "nonCompliantResourcesCount": 2
        }
    }
}

Pour plus d'informations, consultez la section Audit sur les suppressions dans le Guide du développeur de l'AWS IoT.

Pour obtenir des informations sur une instance d'audit

L'describe-audit-taskexemple suivant permet d'obtenir des informations sur une instance d'un audit AWS IoT Device Defender. Si l'audit est terminé, les statistiques récapitulatives de l'exécution sont incluses dans les résultats.

aws iot describe-audit-task \
    --task-id a3aea009955e501a31b764abe1bebd3d

Sortie :

 {
    "taskStatus": "COMPLETED",
    "taskType": "ON_DEMAND_AUDIT_TASK",
    "taskStartTime": 1560356923.434,
    "taskStatistics": {
        "totalChecks": 3,
        "inProgressChecks": 0,
        "waitingForDataCollectionChecks": 0,
        "compliantChecks": 3,
        "nonCompliantChecks": 0,
        "failedChecks": 0,
        "canceledChecks": 0
    },
    "auditDetails": {
        "CA_CERTIFICATE_EXPIRING_CHECK": {
            "checkRunStatus": "COMPLETED_COMPLIANT",
            "checkCompliant": true,
            "totalResourcesCount": 0,
            "nonCompliantResourcesCount": 0
        },
        "DEVICE_CERTIFICATE_EXPIRING_CHECK": {
            "checkRunStatus": "COMPLETED_COMPLIANT",
            "checkCompliant": true,
            "totalResourcesCount": 6,
            "nonCompliantResourcesCount": 0
        },
        "REVOKED_CA_CERTIFICATE_STILL_ACTIVE_CHECK": {
            "checkRunStatus": "COMPLETED_COMPLIANT",
            "checkCompliant": true,
            "totalResourcesCount": 0,
            "nonCompliantResourcesCount": 0
        }
    }
}

Pour plus d'informations, consultez la section Commandes d'audit du guide du développeur de l'AWS IoT.

Pour obtenir des informations sur un autorisateur personnalisé

L'describe-authorizerexemple suivant affiche les détails de l'autorisateur personnalisé spécifié.

aws iot describe-authorizer \
    --authorizer-name CustomAuthorizer

Sortie :

{
    "authorizerDescription": {
        "authorizerName": "CustomAuthorizer",
        "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer",
        "authorizerFunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:CustomAuthorizerFunction",
        "tokenKeyName": "MyAuthToken",
        "tokenSigningPublicKeys": {
            "FIRST_KEY": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA1uJOB4lQPgG/lM6ZfIwo\nZ+7ENxAio9q6QD4FFqjGZsvjtYwjoe1RKK0U8Eq9xb5O3kRSmyIwTzwzm/f4Gf0Y\nZUloJ+t3PUUwHrmbYTAgTrCUgRFygjfgVwGCPs5ZAX4Eyqt5cr+AIHIiUDbxSa7p\nzwOBKPeic0asNJpqT8PkBbRaKyleJh5oo81NDHHmVtbBm5A5YiJjqYXLaVAowKzZ\n+GqsNvAQ9Jy1wI2VrEa1OfL8flDB/BJLm7zjpfPOHDJQgID0XnZwAlNnZcOhCwIx\n50g2LW2Oy9R/dmqtDmJiVP97Z4GykxPvwlYHrUXY0iW1R3AR/Ac1NhCTGZMwVDB1\nlQIDAQAB\n-----END PUBLIC KEY-----"
        },
        "status": "ACTIVE",
        "creationDate": 1571245658.069,
        "lastModifiedDate": 1571245658.069
    }
}

Pour plus d'informations, consultez DescribeAuthorizerle manuel de référence des API AWS IoT.

Pour obtenir des informations sur un groupe de facturation

L'describe-billing-groupexemple suivant permet d'obtenir des informations pour le groupe de facturation spécifié.

aws iot describe-billing-group --billing-group-name GroupOne

Sortie :

{
    "billingGroupName": "GroupOne",
    "billingGroupId": "103de383-114b-4f51-8266-18f209ef5562",
    "billingGroupArn": "arn:aws:iot:us-west-2:123456789012:billinggroup/GroupOne",
    "version": 1,
    "billingGroupProperties": {},
    "billingGroupMetadata": {
        "creationDate": 1560199355.378
    }
}

Pour plus d'informations, consultez la section Groupes de facturation dans le Guide du développeur AWS IoT.

Pour obtenir des informations sur un certificat CA

L'describe-ca-certificateexemple suivant affiche les détails du certificat CA spécifié.

aws iot describe-ca-certificate \
    --certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467

Sortie :

{
    "certificateDescription": {
        "certificateArn": "arn:aws:iot:us-west-2:123456789012:cacert/f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467",
        "certificateId": "f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467",
        "status": "INACTIVE",
        "certificatePem": "-----BEGIN CERTIFICATE-----\nMIICzzCCAbegEXAMPLEJANVEPWXl8taPMA0GCSqGSIb3DQEBBQUAMB4xCzAJBgNV\nBAYTAlVTMQ8wDQYDVQQKDAZBbWF6b24wHhcNMTkwOTI0MjEzMTE1WhcNMjkwOTIx\nMjEzMTE1WjAeMQswCQYDVQQGEwJVUzEPMA0GA1UECgwGQW1hem9uMIIBIjANBgkq\nhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAzd3R3ioalCS0MhFWfBrVGR036EK07UAf\nVdz9EXAMPLE1VczICbADnATK522kEIB51/18VzlFtAhQL5V5eybXKnB7QebNer5m\n4Yibx7shR5oqNzFsrXWxuugN5+w5gEfqNMawOjhF4LsculKG49yuqjcDU19/13ua\n3B2gxs1Pe7TiWWvUskzxnbO1F2WCshbEJvqY8fIWtGYCjTeJAgQ9hvZx/69XhKen\nwV9LJwOQxrsUS0Ty8IHwbB8fRy72VM3u7fJoaU+nO4jD5cqaoEPtzoeFUEXAMPLE\nyVAJpqHwgbYbcUfn7V+AB6yh1+0Fa1rEQGuZDPGyJslxwr5vh8nRewIDAQABoxAw\nDjAMBgNVHRMEBTADAQH/MA0GCSqGSIb3DQEBBQUAA4IBAQA+3a5CV3IJgOnd0AgI\nBgVMtmYzTvqAngx26aG9/spvCjXckh2SBF+EcBlCFwH1yakwjJL1dR4yarnrfxgI\nEqP4AOYVimAVoQ5FBwnloHe16+3qtDiblU9DeXBUCtS55EcfrEXAMPLEYtXdqU5C\nU9ia4KAjV0dxW1+EFYMwX5eGeb0gDTNHBylV6B/fOSZiQAwDYp4x3B+gAP+a/bWB\nu1umOqtBdWe6L6/83L+JhaTByqV25iVJ4c/UZUnG8926wUlDM9zQvEXuEVvzZ7+m\n4PSNqst/nVOvnLpoG4e0WgcJgANuB33CSWtjWSuYsbhmqQRknGhREXAMPLEZT4fm\nfo0e\n-----END CERTIFICATE-----\n",
        "ownedBy": "123456789012",
        "creationDate": 1569365372.053,
        "autoRegistrationStatus": "DISABLE",
        "lastModifiedDate": 1569365372.053,
        "customerVersion": 1,
        "generationId": "c5c2eb95-140b-4f49-9393-6aaac85b2a90",
        "validity": {
            "notBefore": 1569360675.0,
            "notAfter": 1884720675.0
        }
    }
}

Pour plus d'informations, consultez la section Décrire CACertificate dans le manuel de référence des API AWS IoT.

Pour obtenir des informations sur un certificat

L'describe-certificateexemple suivant affiche les détails du certificat spécifié.

aws iot describe-certificate \
    --certificate-id "4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e"

Sortie :

{
    "certificateDescription": {
        "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e",
        "certificateId": "4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e",
        "status": "ACTIVE",
        "certificatePem": "-----BEGIN CERTIFICATE-----
MIICiTEXAMPLEQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC
VVMxCzAJBgNVBEXAMPLEMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
b24xFDASBgNVBAsTC0lBTSBDEXAMPLElMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5EXAMPLEcNMTEwNDI1MjA0NTIxWhcN
MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNEXAMPLEdBMRAwDgYD
VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBEXAMPLEz
b2xEXAMPLEYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt
YXpvbi5jb20wgZ8EXAMPLEZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ
21uUSfwfEvySWtC2XADZ4nB+BLYEXAMPLEpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T
rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7EXAMPLEGBzZswY6786m86gpE
Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFEXAMPLEAtCu4
nUhVVxYUnEXAMPLE8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
FFBjvSfpJIlJ00zbhNYS5f6GEXAMPLEl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb
NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=
-----END CERTIFICATE-----",
        "ownedBy": "123456789012",
        "creationDate": 1541022751.983,
        "lastModifiedDate": 1541022751.983,
        "customerVersion": 1,
        "transferData": {},
        "generationId": "6974fbed-2e61-4114-bc5e-4204cc79b045",
        "validity": {
            "notBefore": 1541022631.0,
            "notAfter": 2524607999.0
        }
    }
}

Pour plus d'informations, consultez DescribeCertificatele manuel de référence des API AWS IoT.

Pour obtenir des informations sur une métrique personnalisée de Device Defender

L'describe-custom-metricexemple suivant permet d'obtenir des informations sur une métrique personnalisée nomméemyCustomMetric.

aws iot describe-custom-metric \
    --metric-name myCustomMetric

Sortie :

{
    "metricName": "myCustomMetric",
    "metricArn": "arn:aws:iot:us-east-1:1234564789012:custommetric/myCustomMetric",
    "metricType": "number",
    "displayName": "My custom metric",
    "creationDate": 2020-11-17T23:02:12.879000-09:00,
    "lastModifiedDate": 2020-11-17T23:02:12.879000-09:00
}

Pour plus d'informations, consultez la section Mesures personnalisées dans le Guide du développeur AWS IoT Core.

Pour obtenir des informations sur l'autorisateur personnalisé par défaut

L'describe-default-authorizerexemple suivant affiche les détails de l'autorisateur personnalisé par défaut.

aws iot describe-default-authorizer

Sortie :

{
    "authorizerName": "CustomAuthorizer",
    "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer"
}

Pour plus d'informations, consultez DescribeDefaultAuthorizerle manuel de référence des API AWS IoT.

Pour obtenir des informations sur une dimension

L'describe-dimensionexemple suivant permet d'obtenir des informations sur une dimension nomméeTopicFilterForAuthMessages.

aws iot describe-dimension \
    --name TopicFilterForAuthMessages

Sortie :

{
    "name": "TopicFilterForAuthMessages",
    "arn": "arn:aws:iot:eu-west-2:123456789012:dimension/TopicFilterForAuthMessages",
    "type": "TOPIC_FILTER",
    "stringValues": [
        "device/+/auth"
    ],
    "creationDate": 1578620223.255,
    "lastModifiedDate": 1578620223.255
}

Pour plus d'informations, consultez la section Détecter les commandes dans le guide du développeur de l'AWS IoT.

Pour décrire la configuration d'un domaine

L'describe-domain-configurationexemple suivant affiche les détails de la configuration du domaine spécifié.

aws iot describe-domain-configuration \
    --domain-configuration-name "additionalDataDomain"

Sortie :

{
    "domainConfigurationName": "additionalDataDomain",
    "domainConfigurationArn": "arn:aws:iot:us-east-1:758EXAMPLE143:domainconfiguration/additionalDataDomain/norpw",
    "domainName": "d055exampleed74y71zfd-ats.beta.us-east-1.iot.amazonaws.com",
    "serverCertificates": [],
    "domainConfigurationStatus": "ENABLED",
    "serviceType": "DATA",
    "domainType": "AWS_MANAGED",
    "lastStatusChangeDate": 1601923783.774
}

Pour plus d'informations, consultez la section Points de terminaison configurables dans le Guide du développeur de l'AWS IoT.

Exemple 1 : pour obtenir votre point de AWS terminaison actuel

L'describe-endpointexemple suivant récupère le point de AWS terminaison par défaut auquel toutes les commandes sont appliquées.

aws iot describe-endpoint

Sortie :

{
    "endpointAddress": "abc123defghijk.iot.us-west-2.amazonaws.com"
}

Pour plus d'informations, consultez DescribeEndpointle Guide du développeur de AWS l'IoT.

Exemple 2 : pour obtenir votre point de terminaison ATS

L'describe-endpointexemple suivant récupère le point de terminaison Amazon Trust Services (ATS).

aws iot describe-endpoint \
    --endpoint-type iot:Data-ATS

Sortie :

{
    "endpointAddress": "abc123defghijk-ats.iot.us-west-2.amazonaws.com"
}

Pour plus d'informations, consultez la section Certificats X.509 et AWS IoT dans le Guide du développeur de l'AWS IoT.

Pour afficher les types d'événements publiés

L'describe-event-configurationsexemple suivant répertorie la configuration qui contrôle les événements générés lors de l'ajout, de la mise à jour ou de la suppression d'un élément.

aws iot describe-event-configurations

Sortie :

{
    "eventConfigurations": {
        "CA_CERTIFICATE": {
            "Enabled": false
        },
        "CERTIFICATE": {
            "Enabled": false
        },
        "JOB": {
            "Enabled": false
        },
        "JOB_EXECUTION": {
            "Enabled": false
        },
        "POLICY": {
            "Enabled": false
        },
        "THING": {
            "Enabled": false
        },
        "THING_GROUP": {
            "Enabled": false
        },
        "THING_GROUP_HIERARCHY": {
            "Enabled": false
        },
        "THING_GROUP_MEMBERSHIP": {
            "Enabled": false
        },
        "THING_TYPE": {
            "Enabled": false
        },
        "THING_TYPE_ASSOCIATION": {
            "Enabled": false
        }
    }
}

Pour plus d'informations, consultez la section Messages d'événements dans le guide du développeur de l'AWS IoT.

Pour récupérer l'état actuel de l'index des objets

L'describe-indexexemple suivant récupère le statut actuel de l'index des objets.

aws iot describe-index \
    --index-name "AWS_Things"

Sortie :

{
    "indexName": "AWS_Things",
    "indexStatus": "ACTIVE",
    "schema": "REGISTRY_AND_SHADOW_AND_CONNECTIVITY_STATUS"
}

Pour plus d'informations, consultez la section Managing Thing Indexing dans le Guide du développeur de l'AWS IoT.

Pour obtenir les détails d'exécution d'une tâche sur un appareil

L'describe-job-executionexemple suivant permet d'obtenir les détails d'exécution de la tâche spécifiée.

aws iot describe-job-execution \
    --job-id "example-job-01" \
    --thing-name "MyRaspberryPi"

Sortie :

{
    "execution": {
        "jobId": "example-job-01",
        "status": "QUEUED",
        "statusDetails": {},
        "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyRaspberryPi",
        "queuedAt": 1560787023.636,
        "lastUpdatedAt": 1560787023.636,
        "executionNumber": 1,
        "versionNumber": 1
    }
}

Pour plus d'informations, consultez Creating and Managing Jobs (CLI) dans le Guide du développeur de l'AWS IoT.

Pour obtenir le statut détaillé d'une tâche

L'describe-jobexemple suivant permet d'obtenir le statut détaillé de la tâche dont l'ID estexample-job-01.

aws iot describe-job \
    --job-id "example-job-01"

Sortie :

{
    "job": {
        "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-01",
        "jobId": "example-job-01",
        "targetSelection": "SNAPSHOT",
        "status": "IN_PROGRESS",
        "targets": [
            "arn:aws:iot:us-west-2:123456789012:thing/MyRaspberryPi"
        ],
        "description": "example job test",
        "presignedUrlConfig": {},
        "jobExecutionsRolloutConfig": {},
        "createdAt": 1560787022.733,
        "lastUpdatedAt": 1560787026.294,
        "jobProcessDetails": {
            "numberOfCanceledThings": 0,
            "numberOfSucceededThings": 0,
            "numberOfFailedThings": 0,
            "numberOfRejectedThings": 0,
            "numberOfQueuedThings": 1,
            "numberOfInProgressThings": 0,
            "numberOfRemovedThings": 0,
            "numberOfTimedOutThings": 0
        },
        "timeoutConfig": {}
    }
}

Pour plus d'informations, consultez Creating and Managing Jobs (CLI) dans le Guide du développeur de l'AWS IoT.

Pour consulter les détails d'une action d'atténuation définie

L'describe-mitigation-actionexemple suivant affiche les détails de l'action d'atténuation spécifiée.

aws iot describe-mitigation-action \
    --action-name AddThingsToQuarantineGroupAction

Sortie :

{
    "actionName": "AddThingsToQuarantineGroupAction",
    "actionType": "ADD_THINGS_TO_THING_GROUP",
    "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/AddThingsToQuarantineGroupAction",
    "actionId": "2fd2726d-98e1-4abf-b10f-09465ccd6bfa",
    "roleArn": "arn:aws:iam::123456789012:role/service-role/MoveThingsToQuarantineGroupRole",
    "actionParams": {
        "addThingsToThingGroupParams": {
            "thingGroupNames": [
                "QuarantineGroup1"
            ],
            "overrideDynamicGroups": true
        }
    },
    "creationDate": "2019-12-10T11:09:35.999000-08:00",
    "lastModifiedDate": "2019-12-10T11:09:35.999000-08:00"
}

Pour plus d'informations, voir DescribeMitigationAction (Mitigation Action Commands) dans le Guide du développeur de l'AWS IoT.

Pour décrire la version d'un modèle de provisionnement

L'describe-provisioning-template-versionexemple suivant décrit une version de modèle de provisionnement.

aws iot describe-provisioning-template-version \
    --template-name MyTestProvisioningTemplate \
    --version-id 1

Sortie :

{
    "versionId": 1,
    "creationDate": 1589308310.574,
    "templateBody": "{
        \"Parameters\":{
            \"SerialNumber\":{
                \"Type\":\"String\"
            },
            \"AWS::IoT::Certificate::Id\":{
                \"Type\":\"String\"
            }
        },
        \"Resources\":{
            \"certificate\":{
                \"Properties\":{
                    \"CertificateId\":{
                        \"Ref\":\"AWS::IoT::Certificate::Id\"
                    },
                    \"Status\":\"Active\"
                },
                \"Type\":\"AWS::IoT::Certificate\"
            },
            \"policy\":{
                \"Properties\":{
                    \"PolicyName\":\"MyIotPolicy\"
                },
                \"Type\":\"AWS::IoT::Policy\"
            },
            \"thing\":{
                \"OverrideSettings\":{
                    \"AttributePayload\":\"MERGE\",
                    \"ThingGroups\":\"DO_NOTHING\",
                    \"ThingTypeName\":\"REPLACE\"
                },
                \"Properties\":{
                    \"AttributePayload\":{},
                    \"ThingGroups\":[],
                    \"ThingName\":{
                        \"Fn::Join\":[
                            \"\",
                            [
                                \"DemoGroup_\",
                                {\"Ref\":\"SerialNumber\"}
                            ]
                        ]
                    },
                    \"ThingTypeName\":\"VirtualThings\"
                },
                \"Type\":\"AWS::IoT::Thing\"
            }
        }
    }",
    "isDefaultVersion": true
}

Pour plus d'informations, consultez la section Provisionnement d'appareils ne disposant pas de certificats d'appareils à l'aide du provisionnement de flotte dans le Guide du développeur AWS IoT Core.

Pour décrire un modèle de provisionnement

L'describe-provisioning-templateexemple suivant décrit un modèle de provisionnement.

aws iot describe-provisioning-template \
    --template-name MyTestProvisioningTemplate

Sortie :

{
    "templateArn": "arn:aws:iot:us-west-2:57EXAMPLE833:provisioningtemplate/MyTestProvisioningTemplate",
    "templateName": "MyTestProvisioningTemplate",
    "creationDate": 1589308310.574,
    "lastModifiedDate": 1589308345.539,
    "defaultVersionId": 1,
    "templateBody": "{
        \"Parameters\":{
            \"SerialNumber\":{
                \"Type\":\"String\"
            },
            \"AWS::IoT::Certificate::Id\":{
                \"Type\":\"String\"
            }
        },
        \"Resources\":{
            \"certificate\":{
                \"Properties\":{
                    \"CertificateId\":{
                        \"Ref\":\"AWS::IoT::Certificate::Id\"
                    },
                    \"Status\":\"Active\"
                },
                \"Type\":\"AWS::IoT::Certificate\"
            },
            \"policy\":{
                \"Properties\":{
                    \"PolicyName\":\"MyIotPolicy\"
                },
                \"Type\":\"AWS::IoT::Policy\"
            },
            \"thing\":{
                \"OverrideSettings\":{
                    \"AttributePayload\":\"MERGE\",
                    \"ThingGroups\":\"DO_NOTHING\",
                    \"ThingTypeName\":\"REPLACE\"
                },
                \"Properties\":{
                    \"AttributePayload\":{},
                    \"ThingGroups\":[],
                    \"ThingName\":{
                        \"Fn::Join\":[
                            \"\",
                            [
                                \"DemoGroup_\",
                                {\"Ref\":\"SerialNumber\"}
                            ]
                        ]
                    },
                    \"ThingTypeName\":\"VirtualThings\"
                },
                \"Type\":\"AWS::IoT::Thing\"
            }
        }
    }",
    "enabled": true,
    "provisioningRoleArn": "arn:aws:iam::571032923833:role/service-role/IoT_access"
}

Pour plus d'informations, consultez la section Provisionnement d'appareils ne disposant pas de certificats d'appareils à l'aide du provisionnement de flotte dans le Guide du développeur AWS IoT Core.

Pour obtenir des informations sur un alias de rôle AWS IoT

L'describe-role-aliasexemple suivant affiche les détails de l'alias de rôle spécifié.

aws iot describe-role-alias \
    --role-alias LightBulbRole

Sortie :

{
    "roleAliasDescription": {
        "roleAlias": "LightBulbRole",
        "roleAliasArn": "arn:aws:iot:us-west-2:123456789012:rolealias/LightBulbRole",
        "roleArn": "arn:aws:iam::123456789012:role/light_bulb_role_001",
        "owner": "123456789012",
        "credentialDurationSeconds": 3600,
        "creationDate": 1570558643.221,
        "lastModifiedDate": 1570558643.221
    }
}

Pour plus d'informations, consultez DescribeRoleAliasle manuel de référence des API AWS IoT.

Pour obtenir des informations sur un audit planifié

L'describe-scheduled-auditexemple suivant permet d'obtenir des informations détaillées sur un audit planifié d' AWS IOT Device Defender nomméAWSIoTDeviceDefenderDailyAudit.

aws iot describe-scheduled-audit \
    --scheduled-audit-name AWSIoTDeviceDefenderDailyAudit

Sortie :

{
    "frequency": "DAILY",
    "targetCheckNames": [
        "AUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK",
        "CONFLICTING_CLIENT_IDS_CHECK",
        "DEVICE_CERTIFICATE_SHARED_CHECK",
        "IOT_POLICY_OVERLY_PERMISSIVE_CHECK",
        "REVOKED_CA_CERTIFICATE_STILL_ACTIVE_CHECK",
        "UNAUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK"
    ],
    "scheduledAuditName": "AWSIoTDeviceDefenderDailyAudit",
    "scheduledAuditArn": "arn:aws:iot:us-west-2:123456789012:scheduledaudit/AWSIoTDeviceDefenderDailyAudit"
}

Pour plus d'informations, consultez la section Commandes d'audit du guide du développeur de l'AWS IoT.

Pour obtenir des informations sur un profil de sécurité

L'describe-security-profileexemple suivant permet d'obtenir des informations sur le profil de sécurité AWS IoT Device Defender nommé PossibleIssue.

aws iot describe-security-profile \
    --security-profile-name PossibleIssue

Sortie :

{
    "securityProfileName": "PossibleIssue",
    "securityProfileArn": "arn:aws:iot:us-west-2:123456789012:securityprofile/PossibleIssue",
    "securityProfileDescription": "check to see if authorization fails 10 times in 5 minutes or if cellular bandwidth exceeds 128",
    "behaviors": [
        {
            "name": "CellularBandwidth",
            "metric": "aws:message-byte-size",
            "criteria": {
                "comparisonOperator": "greater-than",
                "value": {
                    "count": 128
                },
                "consecutiveDatapointsToAlarm": 1,
                "consecutiveDatapointsToClear": 1
            }
        },
        {
            "name": "Authorization",
            "metric": "aws:num-authorization-failures",
            "criteria": {
                "comparisonOperator": "greater-than",
                "value": {
                    "count": 10
                },
                "durationSeconds": 300,
                "consecutiveDatapointsToAlarm": 1,
                "consecutiveDatapointsToClear": 1
            }
        }
    ],
    "version": 1,
    "creationDate": 1560278102.528,
    "lastModifiedDate": 1560278102.528
}

Pour plus d'informations, consultez la section Détecter les commandes dans le guide du développeur de l'AWS IoT.

Pour obtenir des informations sur un stream

L'describe-streamexemple suivant affiche les détails relatifs au flux spécifié.

aws iot describe-stream \
    --stream-id stream12345

Sortie :

{
    "streamInfo": {
        "streamId": "stream12345",
        "streamArn": "arn:aws:iot:us-west-2:123456789012:stream/stream12345",
        "streamVersion": 1,
        "description": "This stream is used for Amazon FreeRTOS OTA Update 12345.",
        "files": [
            {
                "fileId": "123",
                "s3Location": {
                    "bucket":"codesign-ota-bucket",
                    "key":"48c67f3c-63bb-4f92-a98a-4ee0fbc2bef6"
                }
            }
        ],
        "createdAt": 1557863215.995,
        "lastUpdatedAt": 1557863215.995,
        "roleArn": "arn:aws:iam:123456789012:role/service-role/my_ota_stream_role"
    }
}

Pour plus d'informations, consultez DescribeStreamle manuel de référence des API AWS IoT.

Pour obtenir des informations sur un groupe d'objets

L'describe-thing-groupexemple suivant permet d'obtenir des informations sur le groupe d'objets nomméHalogenBulbs.

aws iot describe-thing-group \
    --thing-group-name HalogenBulbs

Sortie :

{
    "thingGroupName": "HalogenBulbs",
    "thingGroupId": "f4ec6b84-b42b-499d-9ce1-4dbd4d4f6f6e",
    "thingGroupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/HalogenBulbs",
    "version": 1,
    "thingGroupProperties": {},
    "thingGroupMetadata": {
        "parentGroupName": "LightBulbs",
        "rootToParentThingGroups": [
            {
                "groupName": "LightBulbs",
                "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs"
            }
        ],
        "creationDate": 1559927609.897
    }
}

Pour plus d'informations, consultez la section Thing Groups dans le guide du développeur AWS IoT.

Pour obtenir des informations sur un type d'objet

L'describe-thing-typeexemple suivant affiche des informations sur le type d'objet spécifié défini dans votre AWS compte.

aws iot describe-thing-type \
    --thing-type-name "LightBulb"

Sortie :

{
    "thingTypeName": "LightBulb",
    "thingTypeId": "ce3573b0-0a3c-45a7-ac93-4e0ce14cd190",
    "thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb",
    "thingTypeProperties": {
        "thingTypeDescription": "light bulb type",
        "searchableAttributes": [
            "model",
            "wattage"
        ]
    },
    "thingTypeMetadata": {
        "deprecated": false,
        "creationDate": 1559772562.498
    }
}

Pour plus d'informations, consultez la section Types d'objets dans le Guide du développeur de l'AWS IoT.

Pour afficher des informations détaillées sur un objet

L'describe-thingexemple suivant affiche des informations sur un objet (appareil) défini dans le registre AWS IoT de votre AWS compte.

est-ce que je ne décrivais pas --thing-name « » MyLightBulb

Sortie :

{
    "defaultClientId": "MyLightBulb",
    "thingName": "MyLightBulb",
    "thingId": "40da2e73-c6af-406e-b415-15acae538797",
    "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb",
    "thingTypeName": "LightBulb",
    "attributes": {
        "model": "123",
        "wattage": "75"
    },
    "version": 1
}

Pour plus d'informations, consultez la section Comment gérer les objets avec le registre dans le Guide du développeur de l'AWS IoT.

Exemple 1 : pour détacher une politique AWS IoT d'un groupe d'objets

L'detach-policyexemple suivant détache la politique spécifiée d'un groupe d'objets et, par extension, de tous les éléments de ce groupe et de tous les groupes enfants du groupe.

aws iot detach-policy \
    --target "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs" \
    --policy-name "MyFirstGroup_Core-policy"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Thing Groups dans le guide du développeur AWS IoT.

Exemple 2 : pour détacher une politique AWS IoT d'un certificat d'appareil

L'detach-policyexemple suivant détache la TemperatureSensorPolicy politique d'un certificat d'appareil identifié par l'ARN.

aws iot detach-policy \
    --policy-name TemperatureSensorPolicy \
    --target arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142

Cette commande ne produit aucun résultat.

Pour dissocier un profil de sécurité d'une cible

L'detach-security-profileexemple suivant supprime l'association entre le profil de sécurité AWS IoT Device Defender nommé Testprofile et la cible de tous les objets enregistrés.

aws iot detach-security-profile \
    --security-profile-name Testprofile \
    --security-profile-target-arn "arn:aws:iot:us-west-2:123456789012:all/registered-things"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Détecter les commandes dans le guide du développeur de l'AWS IoT.

Pour détacher une chose certificate/principal d'une chose

L'detach-thing-principalexemple suivant supprime un certificat représentant un mandant de l'objet spécifié.

aws iot detach-thing-principal \
    --thing-name "MyLightBulb" \
    --principal "arn:aws:iot:us-west-2:123456789012:cert/604c48437a57b7d5fc5d137c5be75011c6ee67c9a6943683a1acb4b1626bac36"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Comment gérer les objets avec le registre dans le Guide du développeur de l'AWS IoT.

Pour désactiver une règle de sujet

L'disable-topic-ruleexemple suivant désactive la règle de rubrique spécifiée.

aws iot disable-topic-rule \
    --rule-name "MyPlantPiMoistureAlertRule"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Visualisation de vos règles dans le guide du développeur de l'AWS IoT.

Pour activer une règle de sujet

L'enable-topic-ruleexemple suivant active (ou réactive) la règle de rubrique spécifiée.

aws iot enable-topic-rule \
    --rule-name "MyPlantPiMoistureAlertRule"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Visualisation de vos règles dans le guide du développeur de l'AWS IoT.

Pour répertorier l'état du modèle de formation ML Detect Security Profile d'un Device Defender

L'get-behavior-model-training-summariesexemple suivant répertorie l'état d'entraînement du modèle pour les comportements configurés dans le profil de sécurité choisi. Pour chaque comportement, le nom, le statut du modèle et le pourcentage de points de données collectés sont répertoriés.

aws iot get-behavior-model-training-summaries \
    --security-profile-name MySecuirtyProfileName

Sortie :

{
    "summaries": [
        {
            "securityProfileName": "MySecuirtyProfileName",
            "behaviorName": "Messages_sent_ML_behavior",
            "modelStatus": "PENDING_BUILD",
            "datapointsCollectionPercentage": 0.0
        },
        {
            "securityProfileName": "MySecuirtyProfileName",
            "behaviorName": "Messages_received_ML_behavior",
            "modelStatus": "PENDING_BUILD",
            "datapointsCollectionPercentage": 0.0
        },
        {
            "securityProfileName": "MySecuirtyProfileName",
            "behaviorName": "Authorization_failures_ML_behavior",
            "modelStatus": "PENDING_BUILD",
            "datapointsCollectionPercentage": 0.0
        },
        {
            "securityProfileName": "MySecuirtyProfileName",
            "behaviorName": "Message_size_ML_behavior",
            "modelStatus": "PENDING_BUILD",
            "datapointsCollectionPercentage": 0.0
        },
        {
            "securityProfileName": "MySecuirtyProfileName",
            "behaviorName": "Connection_attempts_ML_behavior",
            "modelStatus": "PENDING_BUILD",
            "datapointsCollectionPercentage": 0.0
        },
        {
            "securityProfileName": "MySPNoALerts",
            "behaviorName": "Disconnects_ML_behavior",
            "modelStatus": "PENDING_BUILD",
            "datapointsCollectionPercentage": 0.0
        }
    ]
}

Pour plus d'informations, voir GetBehaviorModelTrainingSummaries (Detect Commands) dans le Guide du développeur de l'AWS IoT.

Pour renvoyer le nombre approximatif de valeurs uniques correspondant à la requête

Vous pouvez utiliser le script de configuration suivant pour créer 10 éléments représentant 10 capteurs de température. Chaque nouvel objet possède 3 attributs.

# Bash script. If in other shells, type `bash` before running
Temperatures=(70 71 72 73 74 75 47 97 98 99)
Racks=(Rack1 Rack1 Rack2 Rack2 Rack3 Rack4 Rack5 Rack6 Rack6 Rack6)
IsNormal=(true true true true true true false false false false)
for ((i=0; i<10 ; i++))
do
  thing=$(aws iot create-thing --thing-name "TempSensor$i" --attribute-payload attributes="{temperature=${Temperatures[i]},rackId=${Racks[i]},stateNormal=${IsNormal[i]}}")
  aws iot describe-thing --thing-name "TempSensor$i"
done

Exemple de sortie du script de configuration :

{
    "version": 1,
    "thingName": "TempSensor0",
    "defaultClientId": "TempSensor0",
    "attributes": {
        "rackId": "Rack1",
        "stateNormal": "true",
        "temperature": "70"
    },
    "thingArn": "arn:aws:iot:us-east-1:123456789012:thing/TempSensor0",
    "thingId": "example1-90ab-cdef-fedc-ba987example"
}

L'get-cardinalityexemple suivant interroge les 10 capteurs créés par le script de configuration et renvoie le nombre de racks équipés de capteurs de température signalant des valeurs de température anormales. Si la valeur de température est inférieure à 60 ou supérieure à 80, le capteur de température est dans un état anormal.

aws iot get-cardinality \
    --aggregation-field "attributes.rackId" \
    --query-string "thingName:TempSensor* AND attributes.stateNormal:false"

Sortie :

{
    "cardinality": 2
}

Pour plus d'informations, consultez la section Requête de données agrégées < https://docs.aws.amazon.com/iot/ latest/developerguide/index -aggregate.html> dans le guide du développeur de l'IoT.AWS

Pour répertorier les politiques qui affectent un objet

L'get-effective-policiesexemple suivant répertorie les politiques qui affectent l'objet spécifié, y compris les politiques associées aux groupes auxquels il appartient.

aws iot get-effective-policies \
    --thing-name TemperatureSensor-001 \
    --principal arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142

Sortie :

{
    "effectivePolicies": [
        {
            "policyName": "TemperatureSensorPolicy",
            "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TemperatureSensorPolicy",
            "policyDocument": "{
                \"Version\": \"2012-10-17\",
                \"Statement\": [
                    {
                        \"Effect\": \"Allow\",
                        \"Action\": [
                            \"iot:Publish\",
                            \"iot:Receive\"
                        ],
                        \"Resource\": [
                            \"arn:aws:iot:us-west-2:123456789012:topic/topic_1\",
                            \"arn:aws:iot:us-west-2:123456789012:topic/topic_2\"
                        ]
                    },
                    {
                        \"Effect\": \"Allow\",
                        \"Action\": [
                            \"iot:Subscribe\"
                        ],
                        \"Resource\": [
                            \"arn:aws:iot:us-west-2:123456789012:topicfilter/topic_1\",
                            \"arn:aws:iot:us-west-2:123456789012:topicfilter/topic_2\"
                        ]
                    },
                    {
                        \"Effect\": \"Allow\",
                        \"Action\": [
                            \"iot:Connect\"
                        ],
                        \"Resource\": [
                            \"arn:aws:iot:us-west-2:123456789012:client/basicPubSub\"
                        ]
                    }
                ]
            }"
        }
    ]
}

Pour plus d'informations, consultez la section Get Effective Policies for a Thing du Guide du développeur de l'AWS IoT.

Pour obtenir la configuration d'indexation de l'objet

L'get-indexing-configurationexemple suivant permet d'obtenir les données de configuration actuelles pour AWS l'indexation des flottes IoT.

aws iot get-indexing-configuration

Sortie :

{
    "thingIndexingConfiguration": {
        "thingIndexingMode": "OFF",
        "thingConnectivityIndexingMode": "OFF"
    },
    "thingGroupIndexingConfiguration": {
        "thingGroupIndexingMode": "OFF"
    }
}

Pour plus d'informations, consultez la section Managing Thing Indexing dans le Guide du développeur AWS IoT.

Pour récupérer le document correspondant à une tâche

L'get-job-documentexemple suivant affiche les détails du document correspondant à la tâche dont l'ID estexample-job-01.

aws iot get-job-document \
    --job-id "example-job-01"

Sortie :

{
    "document": "\n{\n    \"operation\":\"customJob\",\n    \"otherInfo\":\"someValue\"\n}\n"
}

Pour plus d'informations, consultez Creating and Managing Jobs (CLI) dans le Guide du développeur de l'AWS IoT.

Pour obtenir les options de journalisation

L'get-logging-optionsexemple suivant montre les options de journalisation actuelles de votre AWS compte.

aws iot get-logging-options

Sortie :

{
    "roleArn": "arn:aws:iam::123456789012:role/service-role/iotLoggingRole",
    "logLevel": "ERROR"
}

Pour plus d'informations, voir le titre dans le guide du développeur de l'AWS IoT.

Pour récupérer des informations sur une mise à jour OTA

L'get-ota-updateexemple suivant affiche les détails de la mise à jour OTA spécifiée.

aws iot get-ota-update \
    --ota-update-id ota12345

Sortie :

{
    "otaUpdateInfo": {
        "otaUpdateId": "ota12345",
        "otaUpdateArn": "arn:aws:iot:us-west-2:123456789012:otaupdate/itsaupdate",
        "creationDate": 1557863215.995,
        "lastModifiedDate": 1557863215.995,
        "description": "A critical update needed right away.",
        "targets": [
           "device1",
           "device2",
           "device3",
           "device4"
        ],
        "targetSelection": "SNAPSHOT",
        "protocols": ["HTTP"],
        "awsJobExecutionsRolloutConfig": {
           "maximumPerMinute": 10
        },
        "otaUpdateFiles": [
            {
                "fileName": "firmware.bin",
                "fileLocation": {
                    "stream": {
                        "streamId": "004",
                        "fileId":123
                    }
                },
                "codeSigning": {
                    "awsSignerJobId": "48c67f3c-63bb-4f92-a98a-4ee0fbc2bef6"
                }
            }
        ],
        "roleArn": "arn:aws:iam:123456789012:role/service-role/my_ota_role"
        "otaUpdateStatus": "CREATE_COMPLETE",
        "awsIotJobId": "job54321",
        "awsIotJobArn": "arn:aws:iot:us-west-2:123456789012:job/job54321",
        "errorInfo": {
        }
    }
}

Pour plus d'informations, consultez la section Guide de référence des API Get OTAUpdate in the AWS IoT.

Pour regrouper les valeurs agrégées correspondant à la requête en groupes percentiles

Vous pouvez utiliser le script de configuration suivant pour créer 10 éléments représentant 10 capteurs de température. Chaque nouvel objet possède un attribut.

# Bash script. If in other shells, type `bash` before running
Temperatures=(70 71 72 73 74 75 47 97 98 99)
for ((i=0; i<10 ; i++))
do
    thing=$(aws iot create-thing --thing-name "TempSensor$i" --attribute-payload attributes="{temperature=${Temperatures[i]}}")
    aws iot describe-thing --thing-name "TempSensor$i"
done

Exemple de sortie du script de configuration :

{
    "version": 1,
    "thingName": "TempSensor0",
    "defaultClientId": "TempSensor0",
    "attributes": {
        "temperature": "70"
    },
    "thingArn": "arn:aws:iot:us-east-1:123456789012:thing/TempSensor0",
    "thingId": "example1-90ab-cdef-fedc-ba987example"
}

L'get-percentilesexemple suivant interroge les 10 capteurs créés par le script de configuration et renvoie une valeur pour chaque groupe de percentiles spécifié. Le groupe de percentiles « 10 » contient la valeur de champ agrégée qui apparaît dans environ 10 % des valeurs correspondant à la requête. Dans le résultat suivant, {"pourcentage » : 10,0, « valeur » : 67,7} signifie qu'environ 10,0 % des valeurs de température sont inférieures à 67,7.

aws iot get-percentiles \
    --aggregation-field "attributes.temperature" \
    --query-string "thingName:TempSensor*" \
    --percents 10 25 50 75 90

Sortie :

{
    "percentiles": [
        {
            "percent": 10.0,
            "value": 67.7
        },
        {
            "percent": 25.0,
            "value": 71.25
        },
        {
            "percent": 50.0,
            "value": 73.5
        },
        {
            "percent": 75.0,
            "value": 91.5
        },
        {
            "percent": 90.0,
            "value": 98.1
        }
    ]
}

Pour plus d'informations, consultez la section Requête de données agrégées dans le Guide du développeur de l'AWS IoT.

Pour obtenir des informations sur une version spécifique d'une politique

L'get-policy-versionexemple suivant permet d'obtenir des informations sur la première version de la politique spécifiée.

aws iot get-policy \
    --policy-name UpdateDeviceCertPolicy
    --policy-version-id "1"

Sortie :

{
    "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/UpdateDeviceCertPolicy",
    "policyName": "UpdateDeviceCertPolicy",
    "policyDocument": "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Effect\": \"Allow\", \"Action\":  \"iot:UpdateCertificate\", \"Resource\": \"*\" } ] }",
    "policyVersionId": "1",
    "isDefaultVersion": false,
    "creationDate": 1559925941.924,
    "lastModifiedDate": 1559926175.458,
    "generationId": "5066f1b6712ce9d2a1e56399771649a272d6a921762fead080e24fe52f24e042"
}

Pour plus d'informations, consultez la section Politiques relatives à l'AWS IoT dans le Guide du développeur de l'AWS IoT.

Pour obtenir des informations sur la version par défaut d'une politique

L'get-policyexemple suivant extrait des informations sur la version par défaut de la politique spécifiée.

aws iot get-policy \
    --policy-name UpdateDeviceCertPolicy

Sortie :

{
    "policyName": "UpdateDeviceCertPolicy",
    "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/UpdateDeviceCertPolicy",
    "policyDocument": "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Effect\": \"Allow\", \"Action\":  \"iot:UpdateCertificate\", \"Resource\": \"*\" } ] }",
    "defaultVersionId": "2",
    "creationDate": 1559925941.924,
    "lastModifiedDate": 1559925941.924,
    "generationId": "5066f1b6712ce9d2a1e56399771649a272d6a921762fead080e24fe52f24e042"
}

Pour plus d'informations, consultez la section Politiques relatives à l'AWS IoT dans le Guide du développeur de l'AWS IoT.

Pour obtenir le code d'enregistrement AWS spécifique à votre compte

L'get-registration-codeexemple suivant permet de récupérer le code d'enregistrement AWS spécifique à votre compte.

aws iot get-registration-code

Sortie :

{
    "registrationCode": "15c51ae5e36ba59ba77042df1115862076bea4bd15841c838fcb68d5010a614c"
}

Pour plus d'informations, consultez la section Utiliser votre propre certificat dans le guide du développeur de l'AWS IoT.

Pour rechercher des données agrégées dans l'index des appareils

L'get-statisticsexemple suivant renvoie le nombre d'objets dotés d'une propriété appelée connectivity.connected set to false (c'est-à-dire le nombre d'appareils non connectés) dans leur espace virtuel.

aws iot get-statistics \
    --index-name AWS_Things \
    --query-string "connectivity.connected:false"

Sortie :

{
    "statistics": {
        "count": 6
    }
}

Pour plus d'informations, consultez la section Obtenir des statistiques sur votre parc d'appareils dans le Guide du développeur de l'AWS IoT.

Pour obtenir une destination de règle de sujet

L'get-topic-rule-destinationexemple suivant permet d'obtenir des informations sur la destination d'une règle de sujet.

aws iot get-topic-rule-destination \
    --arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"

Sortie :

{
    "topicRuleDestination": {
        "arn": "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
        "status": "DISABLED",
        "httpUrlProperties": {
            "confirmationUrl": "https://example.com"
        }
    }
}

Pour plus d'informations, consultez la section Travailler avec des destinations de règles thématiques dans le Guide du développeur de l'AWS IoT.

Pour obtenir des informations sur une règle

L'get-topic-ruleexemple suivant permet d'obtenir des informations sur la règle spécifiée.

aws iot get-topic-rule \
    --rule-name MyRPiLowMoistureAlertRule

Sortie :

{
    "ruleArn": "arn:aws:iot:us-west-2:123456789012:rule/MyRPiLowMoistureAlertRule",
    "rule": {
        "ruleName": "MyRPiLowMoistureAlertRule",
        "sql": "SELECT * FROM '$aws/things/MyRPi/shadow/update/accepted' WHERE state.reported.moisture = 'low'\n                    ",
        "description": "Sends an alert whenever soil moisture level readings are too low.",
        "createdAt": 1558624363.0,
        "actions": [
            {
                "sns": {
                    "targetArn": "arn:aws:sns:us-west-2:123456789012:MyRPiLowMoistureTopic",
                    "roleArn": "arn:aws:iam::123456789012:role/service-role/MyRPiLowMoistureTopicRole",
                    "messageFormat": "RAW"
                }
            }
        ],
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23"
    }
}

Pour plus d'informations, consultez la section Visualisation de vos règles dans le Guide du développeur de l'AWS IoT.

Pour répertorier les options de journalisation actuelles

L'get-v2-logging-optionsexemple suivant répertorie les options de journalisation actuelles pour AWS l'IoT.

aws iot get-v2-logging-options

Sortie :

{
    "roleArn": "arn:aws:iam::094249569039:role/service-role/iotLoggingRole",
    "defaultLogLevel": "WARN",
    "disableAllLogs": false
}

Pour plus d'informations, voir le titre dans le guide du développeur de l'AWS IoT.

Pour répertorier les violations actives

L'list-active-violationsexemple suivant répertorie toutes les violations pour le profil de sécurité spécifié.

aws iot list-active-violations \
    --security-profile-name Testprofile

Sortie :

{
    "activeViolations": [
        {
            "violationId": "174db59167fa474c80a652ad1583fd44",
            "thingName": "iotconsole-1560269126751-1",
            "securityProfileName": "Testprofile",
            "behavior": {
                "name": "Authorization",
                "metric": "aws:num-authorization-failures",
                "criteria": {
                    "comparisonOperator": "greater-than",
                    "value": {
                        "count": 10
                    },
                    "durationSeconds": 300,
                    "consecutiveDatapointsToAlarm": 1,
                    "consecutiveDatapointsToClear": 1
                }
            },
            "lastViolationValue": {
                "count": 0
            },
            "lastViolationTime": 1560293700.0,
            "violationStartTime": 1560279000.0
        },
        {
            "violationId": "c8a9466a093d3b7b35cd44ca58bdbeab",
            "thingName": "TvnQoEoU",
            "securityProfileName": "Testprofile",
            "behavior": {
                "name": "CellularBandwidth",
                "metric": "aws:message-byte-size",
                "criteria": {
                    "comparisonOperator": "greater-than",
                    "value": {
                        "count": 128
                    },
                    "consecutiveDatapointsToAlarm": 1,
                    "consecutiveDatapointsToClear": 1
                }
            },
            "lastViolationValue": {
                "count": 110
            },
            "lastViolationTime": 1560369000.0,
            "violationStartTime": 1560276600.0
        },
        {
            "violationId": "74aa393adea02e6648f3ac362beed55e",
            "thingName": "iotconsole-1560269232412-2",
            "securityProfileName": "Testprofile",
            "behavior": {
                "name": "Authorization",
                "metric": "aws:num-authorization-failures",
                "criteria": {
                    "comparisonOperator": "greater-than",
                    "value": {
                        "count": 10
                    },
                    "durationSeconds": 300,
                    "consecutiveDatapointsToAlarm": 1,
                    "consecutiveDatapointsToClear": 1
                }
            },
            "lastViolationValue": {
                "count": 0
            },
            "lastViolationTime": 1560276600.0,
            "violationStartTime": 1560276600.0
        },
        {
            "violationId": "1e6ab5f7cf39a1466fcd154e1377e406",
            "thingName": "TvnQoEoU",
            "securityProfileName": "Testprofile",
            "behavior": {
                "name": "Authorization",
                "metric": "aws:num-authorization-failures",
                "criteria": {
                    "comparisonOperator": "greater-than",
                    "value": {
                        "count": 10
                    },
                    "durationSeconds": 300,
                    "consecutiveDatapointsToAlarm": 1,
                    "consecutiveDatapointsToClear": 1
                }
            },
            "lastViolationValue": {
                "count": 0
            },
            "lastViolationTime": 1560369000.0,
            "violationStartTime": 1560276600.0
        }
    ]
}

Exemple 1 : pour répertorier les politiques associées à un groupe

L'list-attached-policiesexemple suivant répertorie les politiques associées au groupe spécifié.

aws iot list-attached-policies \
    --target "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs"

Sortie :

{
    "policies": [
        {
            "policyName": "UpdateDeviceCertPolicy",
            "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/UpdateDeviceCertPolicy"
        }
    ]
}

Pour plus d'informations, consultez la section Thing Groups dans le guide du développeur AWS IoT.

Exemple 2 : pour répertorier les politiques associées à un certificat d'appareil

L'list-attached-policiesexemple suivant répertorie les politiques AWS IoT associées au certificat de l'appareil. Le certificat est identifié par son ARN.

aws iot list-attached-policies \
    --target arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142

Sortie :

{
    "policies": [
        {
            "policyName": "TemperatureSensorPolicy",
            "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TemperatureSensorPolicy"
        }
    ]
}

Pour plus d'informations, consultez la section Thing Groups dans le guide du développeur AWS IoT.

Exemple 1 : Pour répertorier tous les résultats d'un audit

L'list-audit-findingsexemple suivant répertorie tous les résultats d'un audit AWS IoT Device Defender avec un ID de tâche spécifié.

aws iot list-audit-findings \
    --task-id a3aea009955e501a31b764abe1bebd3d

Sortie :

{
    "findings": []
}

Exemple 2 : Pour répertorier les résultats d'un type de contrôle d'audit

L'list-audit-findingsexemple suivant montre les résultats des audits AWS IoT Device Defender réalisés entre le 5 juin 2019 et le 19 juin 2019 dans lesquels des appareils partagent un certificat d'appareil. Lorsque vous spécifiez un nom de chèque, vous devez indiquer une heure de début et de fin.

aws iot list-audit-findings \
    --check-name DEVICE_CERTIFICATE_SHARED_CHECK \
    --start-time 1559747125 \
    --end-time 1560962028

Sortie :

{
    "findings": [
        {
            "taskId": "eeef61068b0eb03c456d746c5a26ee04",
            "checkName": "DEVICE_CERTIFICATE_SHARED_CHECK",
            "taskStartTime": 1560161017.172,
            "findingTime": 1560161017.592,
            "severity": "CRITICAL",
            "nonCompliantResource": {
                "resourceType": "DEVICE_CERTIFICATE",
                "resourceIdentifier": {
                    "deviceCertificateId": "b193ab7162c0fadca83246d24fa090300a1236fe58137e121b011804d8ac1d6b"
                }
            },
            "relatedResources": [
                {
                    "resourceType": "CLIENT_ID",
                    "resourceIdentifier": {
                        "clientId": "ZipxgAIl"
                    },
                    "additionalInfo": {
                        "CONNECTION_TIME": "1560086374068"
                    }
                },
                {
                    "resourceType": "CLIENT_ID",
                    "resourceIdentifier": {
                        "clientId": "ZipxgAIl"
                    },
                    "additionalInfo": {
                        "CONNECTION_TIME": "1560081552187",
                        "DISCONNECTION_TIME": "1560086371552"
                    }
                },
                {
                    "resourceType": "CLIENT_ID",
                    "resourceIdentifier": {
                        "clientId": "ZipxgAIl"
                    },
                    "additionalInfo": {
                        "CONNECTION_TIME": "1559289863631",
                        "DISCONNECTION_TIME": "1560081532716"
                    }
                }
            ],
            "reasonForNonCompliance": "Certificate shared by one or more devices.",
            "reasonForNonComplianceCode": "CERTIFICATE_SHARED_BY_MULTIPLE_DEVICES"
        },
        {
            "taskId": "bade6b5efd2e1b1569822f6021b39cf5",
            "checkName": "DEVICE_CERTIFICATE_SHARED_CHECK",
            "taskStartTime": 1559988217.27,
            "findingTime": 1559988217.655,
            "severity": "CRITICAL",
            "nonCompliantResource": {
                "resourceType": "DEVICE_CERTIFICATE",
                "resourceIdentifier": {
                    "deviceCertificateId": "b193ab7162c0fadca83246d24fa090300a1236fe58137e121b011804d8ac1d6b"
                }
            },
            "relatedResources": [
                {
                    "resourceType": "CLIENT_ID",
                    "resourceIdentifier": {
                        "clientId": "xShGENLW"
                    },
                    "additionalInfo": {
                        "CONNECTION_TIME": "1559972350825"
                    }
                },
                {
                    "resourceType": "CLIENT_ID",
                    "resourceIdentifier": {
                        "clientId": "xShGENLW"
                    },
                    "additionalInfo": {
                        "CONNECTION_TIME": "1559255062002",
                        "DISCONNECTION_TIME": "1559972350616"
                    }
                }
            ],
            "reasonForNonCompliance": "Certificate shared by one or more devices.",
            "reasonForNonComplianceCode": "CERTIFICATE_SHARED_BY_MULTIPLE_DEVICES"
        },
        {
            "taskId": "c23f6233ba2d35879c4bb2810fb5ffd6",
            "checkName": "DEVICE_CERTIFICATE_SHARED_CHECK",
            "taskStartTime": 1559901817.31,
            "findingTime": 1559901817.767,
            "severity": "CRITICAL",
            "nonCompliantResource": {
                "resourceType": "DEVICE_CERTIFICATE",
                "resourceIdentifier": {
                    "deviceCertificateId": "b193ab7162c0fadca83246d24fa090300a1236fe58137e121b011804d8ac1d6b"
                }
            },
            "relatedResources": [
                {
                    "resourceType": "CLIENT_ID",
                    "resourceIdentifier": {
                        "clientId": "TvnQoEoU"
                    },
                    "additionalInfo": {
                        "CONNECTION_TIME": "1559826729768"
                    }
                },
                {
                    "resourceType": "CLIENT_ID",
                    "resourceIdentifier": {
                        "clientId": "TvnQoEoU"
                    },
                    "additionalInfo": {
                        "CONNECTION_TIME": "1559345920964",
                        "DISCONNECTION_TIME": "1559826728402"
                    }
                }
            ],
            "reasonForNonCompliance": "Certificate shared by one or more devices.",
            "reasonForNonComplianceCode": "CERTIFICATE_SHARED_BY_MULTIPLE_DEVICES"
        }
    ]
}

Pour plus d'informations, consultez la section Commandes d'audit du guide du développeur de l'AWS IoT.

Pour répertorier les détails de l'exécution d'une action d'atténuation d'un audit

Une tâche d'action d'atténuation d'audit applique une action d'atténuation à un ou plusieurs résultats d'un audit AWS IoT Device Defender. L'list-audit-mitigation-actions-executionsexemple suivant répertorie les détails de la tâche d'action d'atténuation avec le résultat spécifié taskId et pour le résultat spécifié.

aws iot list-audit-mitigation-actions-executions \
    --task-id myActionsTaskId \
    --finding-id 0edbaaec-2fe1-4cf5-abc9-d4c3e51f7464

Sortie :

{
    "actionsExecutions": [
        {
            "taskId": "myActionsTaskId",
            "findingId": "0edbaaec-2fe1-4cf5-abc9-d4c3e51f7464",
            "actionName": "ResetPolicyVersionAction",
            "actionId": "1ea0b415-bef1-4a01-bd13-72fb63c59afb",
            "status": "COMPLETED",
            "startTime": "2019-12-10T15:19:13.279000-08:00",
            "endTime": "2019-12-10T15:19:13.337000-08:00"
        }
    ]
}

Pour plus d'informations, voir ListAuditMitigationActionsExecutions (Mitigation Action Commands) dans le Guide du développeur de l'AWS IoT.

Pour répertorier les tâches d'audit relatives aux mesures d'atténuation

L'list-audit-mitigation-actions-tasksexemple suivant répertorie les mesures d'atténuation qui ont été appliquées aux résultats au cours de la période spécifiée.

aws iot list-audit-mitigation-actions-tasks \
    --start-time 1594157400 \
    --end-time 1594157430

Sortie :

{
    "tasks": [
        {
                "taskId": "0062f2d6-3999-488f-88c7-bef005414103",
                "startTime": "2020-07-07T14:30:15.172000-07:00",
            "taskStatus": "COMPLETED"
        }
    ]
}

Pour plus d'informations, voir ListAuditMitigationActionsTasks (Mitigation Action Commands) dans le Guide du développeur de l'AWS IoT.

Pour répertorier toutes les suppressions des résultats d'audit

L'list-audit-suppressionsexemple suivant répertorie toutes les suppressions de résultats d'audit actives.

aws iot list-audit-suppressions

Sortie :

{
    "suppressions": [
        {
        "checkName": "DEVICE_CERTIFICATE_EXPIRING_CHECK",
            "resourceIdentifier": {
                "deviceCertificateId": "c7691e<shortened>"
            },
        "expirationDate": 1597881600.0,
        "suppressIndefinitely": false
        }
    ]
}

Pour plus d'informations, consultez la section Audit sur les suppressions dans le Guide du développeur de l'AWS IoT.

Pour répertorier tous les résultats d'un audit

L'list-audit-tasksexemple suivant répertorie les tâches d'audit exécutées entre le 5 juin 2019 et le 12 juin 2019.

aws iot list-audit-tasks \
    --start-time 1559747125 \
    --end-time 1560357228

Sortie :

{
    "tasks": [
        {
            "taskId": "a3aea009955e501a31b764abe1bebd3d",
            "taskStatus": "COMPLETED",
            "taskType": "ON_DEMAND_AUDIT_TASK"
        },
        {
            "taskId": "f76b4b5102b632cd9ae38a279c266da1",
            "taskStatus": "COMPLETED",
            "taskType": "SCHEDULED_AUDIT_TASK"
        },
        {
            "taskId": "51d9967d9f9ff4d26529505f6d2c444a",
            "taskStatus": "COMPLETED",
            "taskType": "SCHEDULED_AUDIT_TASK"
        },
        {
            "taskId": "eeef61068b0eb03c456d746c5a26ee04",
            "taskStatus": "COMPLETED",
            "taskType": "SCHEDULED_AUDIT_TASK"
        },
        {
            "taskId": "041c49557b7c7b04c079a49514b55589",
            "taskStatus": "COMPLETED",
            "taskType": "SCHEDULED_AUDIT_TASK"
        },
        {
            "taskId": "82c7f2afac1562d18a4560be73998acc",
            "taskStatus": "COMPLETED",
            "taskType": "SCHEDULED_AUDIT_TASK"
        },
        {
            "taskId": "bade6b5efd2e1b1569822f6021b39cf5",
            "taskStatus": "COMPLETED",
            "taskType": "SCHEDULED_AUDIT_TASK"
        },
        {
            "taskId": "c23f6233ba2d35879c4bb2810fb5ffd6",
            "taskStatus": "COMPLETED",
            "taskType": "SCHEDULED_AUDIT_TASK"
        },
        {
            "taskId": "ac9086b7222a2f5e2e17bb6fd30b3aeb",
            "taskStatus": "COMPLETED",
            "taskType": "SCHEDULED_AUDIT_TASK"
        }
    ]
}

Pour plus d'informations, consultez la section Commandes d'audit du guide du développeur de l'AWS IoT.

Pour répertorier votre autorisateur personnalisé

L'list-authorizersexemple suivant répertorie les autorisateurs personnalisés de votre AWS compte.

aws iot list-authorizers

Sortie :

{
    "authorizers": [
        {
            "authorizerName": "CustomAuthorizer",
            "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer"
        },
        {
            "authorizerName": "CustomAuthorizer2",
            "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer2"
        },
        {
            "authorizerName": "CustomAuthorizer3",
            "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer3"
        }
    ]
}

Pour plus d'informations, consultez ListAuthorizersle manuel de référence des API AWS IoT.

Pour répertorier les groupes de facturation pour votre AWS compte et votre région

L'list-billing-groupsexemple suivant répertorie tous les groupes de facturation définis pour votre AWS compte et votre AWS région.

aws iot list-billing-groups

Sortie :

{
    "billingGroups": [
        {
            "groupName": "GroupOne",
            "groupArn": "arn:aws:iot:us-west-2:123456789012:billinggroup/GroupOne"
        }
    ]
}

Pour plus d'informations, consultez la section Groupes de facturation dans le Guide du développeur AWS IoT.

Pour répertorier les certificats CA enregistrés dans votre AWS compte

L'list-ca-certificatesexemple suivant répertorie les certificats CA enregistrés dans votre AWS compte.

aws iot list-ca-certificates

Sortie :

{
    "certificates": [
        {
            "certificateArn": "arn:aws:iot:us-west-2:123456789012:cacert/f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467",
            "certificateId": "f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467",
            "status": "INACTIVE",
            "creationDate": 1569365372.053
        }
    ]
}

Pour plus d'informations, consultez la section Utiliser votre propre certificat dans le guide du développeur de l'AWS IoT.

Pour répertorier tous les certificats d'appareils signés avec un certificat CA

L'list-certificates-by-caexemple suivant répertorie tous les certificats d'appareils de votre AWS compte qui sont signés avec le certificat CA spécifié.

aws iot list-certificates-by-ca \
    --ca-certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467

Sortie :

{
    "certificates": [
        {
            "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
            "certificateId": "488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
            "status": "ACTIVE",
            "creationDate": 1569363250.557
        }
    ]
}

Pour plus d'informations, consultez ListCertificatesByCA dans le manuel de référence des API AWS IoT.

Exemple 1 : Pour répertorier les certificats enregistrés dans votre AWS compte

L'list-certificatesexemple suivant répertorie tous les certificats enregistrés dans votre compte. Si vous avez dépassé la limite de pagination par défaut de 25, vous pouvez utiliser la valeur de nextMarker réponse de cette commande et la fournir à la commande suivante pour obtenir le prochain lot de résultats. Répétez jusqu'à ce qu'il nextMarker revienne sans valeur.

aws iot list-certificates

Sortie :

{
    "certificates": [
        {
            "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/604c48437a57b7d5fc5d137c5be75011c6ee67c9a6943683a1acb4b1626bac36",
            "certificateId": "604c48437a57b7d5fc5d137c5be75011c6ee67c9a6943683a1acb4b1626bac36",
            "status": "ACTIVE",
            "creationDate": 1556810537.617
        },
        {
            "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/262a1ac8a7d8aa72f6e96e365480f7313aa9db74b8339ec65d34dc3074e1c31e",
            "certificateId": "262a1ac8a7d8aa72f6e96e365480f7313aa9db74b8339ec65d34dc3074e1c31e",
            "status": "ACTIVE",
            "creationDate": 1546447050.885
        },
        {
            "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/b193ab7162c0fadca83246d24fa090300a1236fe58137e121b011804d8ac1d6b",
            "certificateId": "b193ab7162c0fadca83246d24fa090300a1236fe58137e121b011804d8ac1d6b",
            "status": "ACTIVE",
            "creationDate": 1546292258.322
        },
        {
            "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/7aebeea3845d14a44ec80b06b8b78a89f3f8a706974b8b34d18f5adf0741db42",
            "certificateId": "7aebeea3845d14a44ec80b06b8b78a89f3f8a706974b8b34d18f5adf0741db42",
            "status": "ACTIVE",
            "creationDate": 1541457693.453
        },
        {
            "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/54458aa39ebb3eb39c91ffbbdcc3a6ca1c7c094d1644b889f735a6fc2cd9a7e3",
            "certificateId": "54458aa39ebb3eb39c91ffbbdcc3a6ca1c7c094d1644b889f735a6fc2cd9a7e3",
            "status": "ACTIVE",
            "creationDate": 1541113568.611
        },
        {
            "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e",
            "certificateId": "4f0ba725787aa94d67d2fca420eca022242532e8b3c58e7465c7778b443fd65e",
            "status": "ACTIVE",
            "creationDate": 1541022751.983
        }
    ]
}

Pour répertorier vos statistiques personnalisées

L'list-custom-metricsexemple suivant répertorie toutes vos mesures personnalisées.

aws iot list-custom-metrics \
    --region us-east-1

Sortie :

{
    "metricNames": [
        "batteryPercentage"
    ]
}

Pour plus d'informations, consultez la section Mesures personnalisées dans le Guide du développeur AWS IoT Core.

Pour répertorier les dimensions de votre AWS compte

L'list-dimensionsexemple suivant répertorie toutes les dimensions d' AWS IoT Device Defender définies dans votre AWS compte.

aws iot list-dimensions

Sortie :

{
    "dimensionNames": [
        "TopicFilterForAuthMessages",
        "TopicFilterForActivityMessages"
    ]
}

Pour plus d'informations, consultez la section Détecter les commandes dans le guide du développeur de l'AWS IoT.

Pour répertorier les configurations de domaine

L'list-domain-configurationsexemple suivant répertorie les configurations de domaine de votre AWS compte qui ont le type de service spécifié.

aws iot list-domain-configurations \
    --service-type "DATA"

Sortie :

{
    "domainConfigurations":
    [
        {
            "domainConfigurationName": "additionalDataDomain",
            "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/additionalDataDomain/dikMh",
            "serviceType": "DATA"
        },

        {
            "domainConfigurationName": "iot:Jobs",
            "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/iot:Jobs",
            "serviceType": "JOBS"
        },
        {
            "domainConfigurationName": "iot:Data-ATS",
            "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/iot:Data-ATS",
            "serviceType": "DATA"
        },
        {
            "domainConfigurationName": "iot:CredentialProvider",
            "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/iot:CredentialProvider",
            "serviceType": "CREDENTIAL_PROVIDER"
        }
    ]
}

Pour plus d'informations, consultez la section Points de terminaison configurables dans le Guide du développeur de l'AWS IoT.

Pour répertorier les indices de recherche configurés

L'list-indicesexemple suivant répertorie tous les index de recherche configurés dans votre AWS compte. Si vous n'avez pas activé l'indexation des objets, il se peut que vous n'ayez aucun index.

aws iot list-indices

Sortie :

{
    "indexNames": [
        "AWS_Things"
    ]
}

Pour plus d'informations, consultez la section Managing Thing Indexing dans le Guide du développeur de l'AWS IoT.

Pour répertorier les offres d'emploi de votre AWS compte

L'list-job-executions-for-jobexemple suivant répertorie toutes les exécutions de tâches pour une tâche de votre AWS compte, spécifiée par le JobID.

aws iot list-job-executions-for-job \
    --job-id my-ota-job

Sortie :

{
     "executionSummaries": [
         {
             "thingArn": "arn:aws:iot:us-east-1:123456789012:thing/my_thing",
             "jobExecutionSummary": {
                 "status": "QUEUED",
                 "queuedAt": "2022-03-07T15:58:42.195000-08:00",
                 "lastUpdatedAt": "2022-03-07T15:58:42.195000-08:00",
                 "executionNumber": 1,
                 "retryAttempt": 0
             }
         }
     ]
 }

Pour plus d'informations, consultez Creating and Managing Jobs (CLI) dans le Guide du développeur de l'AWS IoT.

Pour répertorier les tâches exécutées pour un objet

L'list-job-executions-for-thingexemple suivant répertorie toutes les tâches exécutées pour l'objet nomméMyRaspberryPi.

aws iot list-job-executions-for-thing \
    --thing-name "MyRaspberryPi"

Sortie :

{
    "executionSummaries": [
        {
            "jobId": "example-job-01",
            "jobExecutionSummary": {
                "status": "QUEUED",
                "queuedAt": 1560787023.636,
                "lastUpdatedAt": 1560787023.636,
                "executionNumber": 1
            }
        }
    ]
}

Pour plus d'informations, consultez Creating and Managing Jobs (CLI) dans le Guide du développeur de l'AWS IoT.

Pour répertorier les offres d'emploi de votre AWS compte

L'list-jobsexemple suivant répertorie toutes les tâches de votre AWS compte, triées en fonction de leur statut.

aws iot list-jobs

Sortie :

{
    "jobs": [
        {
            "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-01",
            "jobId": "example-job-01",
            "targetSelection": "SNAPSHOT",
            "status": "IN_PROGRESS",
            "createdAt": 1560787022.733,
            "lastUpdatedAt": 1560787026.294
        }
    ]
}

Pour plus d'informations, consultez Creating and Managing Jobs (CLI) dans le Guide du développeur de l'AWS IoT.

Pour répertorier toutes les mesures d'atténuation définies

L'list-mitigation-actionsexemple suivant répertorie toutes les mesures d'atténuation définies pour votre AWS compte et votre région. Pour chaque action, le nom, l'ARN et la date de création sont répertoriés.

aws iot list-mitigation-actions

Sortie :

{
    "actionIdentifiers": [
        {
            "actionName": "DeactivateCACertAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/DeactivateCACertAction",
            "creationDate": "2019-12-10T11:12:47.574000-08:00"
        },
        {
            "actionName": "ResetPolicyVersionAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/ResetPolicyVersionAction",
            "creationDate": "2019-12-10T11:11:48.920000-08:00"
        },
        {
            "actionName": "PublishFindingToSNSAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/PublishFindingToSNSAction",
            "creationDate": "2019-12-10T11:10:49.546000-08:00"
        },
        {
            "actionName": "AddThingsToQuarantineGroupAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/AddThingsToQuarantineGroupAction",
            "creationDate": "2019-12-10T11:09:35.999000-08:00"
        },
        {
            "actionName": "UpdateDeviceCertAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/UpdateDeviceCertAction",
            "creationDate": "2019-12-10T11:08:44.263000-08:00"
        },
        {
            "actionName": "SampleMitigationAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/SampleMitigationAction",
            "creationDate": "2019-12-10T11:03:41.840000-08:00"
        }
    ]
}

Pour plus d'informations, voir ListMitigationActions (Mitigation Action Commands) dans le Guide du développeur de l'AWS IoT.

Pour répertorier toutes les mesures d'atténuation définies

L'list-mitigations-actionsexemple suivant répertorie toutes les mesures d'atténuation définies pour votre AWS compte et votre région. Pour chaque action, le nom, l'ARN et la date de création sont répertoriés.

aws iot list-mitigation-actions

Sortie :

{
    "actionIdentifiers": [
        {
            "actionName": "DeactivateCACertAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/DeactivateCACertAction",
            "creationDate": "2019-12-10T11:12:47.574000-08:00"
        },
        {
            "actionName": "ResetPolicyVersionAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/ResetPolicyVersionAction",
            "creationDate": "2019-12-10T11:11:48.920000-08:00"
        },
        {
            "actionName": "PublishFindingToSNSAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/PublishFindingToSNSAction",
            "creationDate": "2019-12-10T11:10:49.546000-08:00"
        },
        {
            "actionName": "AddThingsToQuarantineGroupAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/AddThingsToQuarantineGroupAction",
            "creationDate": "2019-12-10T11:09:35.999000-08:00"
        },
        {
            "actionName": "UpdateDeviceCertAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/UpdateDeviceCertAction",
            "creationDate": "2019-12-10T11:08:44.263000-08:00"
        },
        {
            "actionName": "SampleMitigationAction",
            "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/SampleMitigationAction",
            "creationDate": "2019-12-10T11:03:41.840000-08:00"
        }
    ]
}

Pour plus d'informations, voir ListMitigationActions (Mitigation Action Commands) dans le Guide du développeur de l'AWS IoT.

Pour répertorier les mises à jour OTA pour le compte

L'list-ota-updatesexemple suivant répertorie les mises à jour OTA disponibles.

aws iot list-ota-updates

Sortie :

{
    "otaUpdates": [
        {
            "otaUpdateId": "itsaupdate",
            "otaUpdateArn": "arn:aws:iot:us-west-2:123456789012:otaupdate/itsaupdate",
            "creationDate": 1557863215.995
        }
    ]
}

Pour plus d'informations, consultez la section Liste OTAUpdates dans le guide de référence des API AWS IoT.

Pour répertorier les certificats transférés vers un autre AWS compte

L'list-outgoing-certificatesexemple suivant répertorie tous les certificats de périphérique en cours de transfert vers un autre AWS compte à l'aide de la transfer-certificate commande.

aws iot list-outgoing-certificates

Sortie :

{
    "outgoingCertificates": [
        {
            "certificateArn": "arn:aws:iot:us-west-2:030714055129:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
            "certificateId": "488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
            "transferredTo": "030714055129",
            "transferDate": 1569427780.441,
            "creationDate": 1569363250.557
        }
    ]
}

Pour plus d'informations, consultez ListOutgoingCertificatesle manuel de référence des API AWS IoT.

Pour répertorier les politiques définies dans votre AWS compte

L'list-policiesexemple suivant répertorie toutes les politiques définies dans votre AWS compte.

aws iot list-policies

Sortie :

{
    "policies": [
        {
            "policyName": "UpdateDeviceCertPolicy",
            "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/UpdateDeviceCertPolicy"
        },
        {
            "policyName": "PlantIoTPolicy",
            "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/PlantIoTPolicy"
        },
        {
            "policyName": "MyPiGroup_Core-policy",
            "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/MyPiGroup_Core-policy"
        }
    ]
}

Pour plus d'informations, consultez la section Politiques relatives à l'AWS IoT dans le Guide du développeur de l'AWS IoT.

Exemple 1 : pour voir toutes les versions d'une politique

L'list-policy-versionsexemple suivant répertorie toutes les versions de la politique spécifiée et leurs dates de création.

aws iot list-policy-versions \
    --policy-name LightBulbPolicy

Sortie :

{
    "policyVersions": [
        {
            "versionId": "2",
            "isDefaultVersion": true,
            "createDate": 1559925941.924
        },
        {
            "versionId": "1",
            "isDefaultVersion": false,
            "createDate": 1559925941.924
        }
    ]
}

Pour plus d'informations, consultez la section Politiques relatives à l'AWS IoT dans le Guide du développeur de l'AWS IoT.

Pour répertorier les objets attachés à un principal

L'list-principal-thingsexemple suivant répertorie les éléments attachés au principal spécifié par un ARN.

aws iot list-principal-things \
    --principal arn:aws:iot:us-west-2:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8

Sortie :

{
    "things": [
        "DeskLamp",
        "TableLamp"
    ]
}

Pour plus d'informations, consultez ListPrincipalThingsle manuel de référence des API AWS IoT.

Pour répertorier les versions des modèles de provisionnement

L'list-provisioning-template-versionsexemple suivant répertorie les versions disponibles du modèle de provisionnement spécifié.

aws iot list-provisioning-template-versions \
    --template-name "widget-template"

Sortie :

{
    "versions": [
        {
            "versionId": 1,
            "creationDate": 1574800471.339,
            "isDefaultVersion": true
        },
        {
            "versionId": 2,
            "creationDate": 1574801192.317,
            "isDefaultVersion": false
        }
    ]
}

Pour plus d'informations, consultez la section AWS IoT Secure Tunneling dans le guide du développeur AWS IoT Core.

Pour répertorier les modèles de provisionnement

L'list-provisioning-templatesexemple suivant répertorie tous les modèles de provisionnement de votre AWS compte.

aws iot list-provisioning-templates

Sortie :

{
    "templates": [
        {
            "templateArn": "arn:aws:iot:us-east-1:123456789012:provisioningtemplate/widget-template",
            "templateName": "widget-template",
            "description": "A provisioning template for widgets",
            "creationDate": 1574800471.367,
            "lastModifiedDate": 1574801192.324,
            "enabled": false
        }
    ]
}

Pour plus d'informations, consultez la section AWS IoT Secure Tunneling dans le guide du développeur AWS IoT Core.

Pour répertorier les alias de rôle AWS IoT de votre compte AWS

L'list-role-aliasesexemple suivant répertorie les alias de rôle AWS IoT de votre AWS compte.

aws iot list-role-aliases

Sortie :

{
    "roleAliases": [
        "ResidentAlias",
        "ElectricianAlias"
    ]
}

Pour plus d'informations, consultez ListRoleAliasesle manuel de référence des API AWS IoT.

Pour répertorier les audits planifiés pour votre AWS compte

L'list-scheduled-auditsexemple suivant répertorie tous les audits planifiés pour votre AWS compte.

aws iot list-scheduled-audits

Sortie :

{
    "scheduledAudits": [
        {
            "scheduledAuditName": "AWSIoTDeviceDefenderDailyAudit",
            "scheduledAuditArn": "arn:aws:iot:us-west-2:123456789012:scheduledaudit/AWSIoTDeviceDefenderDailyAudit",
            "frequency": "DAILY"
        },
        {
            "scheduledAuditName": "AWSDeviceDefenderWeeklyAudit",
            "scheduledAuditArn": "arn:aws:iot:us-west-2:123456789012:scheduledaudit/AWSDeviceDefenderWeeklyAudit",
            "frequency": "WEEKLY",
            "dayOfWeek": "SUN"
        }
    ]
}

Pour plus d'informations, consultez la section Commandes d'audit du guide du développeur de l'AWS IoT.

Pour répertorier les profils de sécurité associés à une cible

L'list-security-profiles-for-targetexemple suivant répertorie les profils de sécurité AWS IoT Device Defender associés à des appareils non enregistrés.

aws iot list-security-profiles-for-target  \
    --security-profile-target-arn "arn:aws:iot:us-west-2:123456789012:all/unregistered-things"

Sortie :

{
    "securityProfileTargetMappings": [
        {
            "securityProfileIdentifier": {
                "name": "Testprofile",
                "arn": "arn:aws:iot:us-west-2:123456789012:securityprofile/Testprofile"
            },
            "target": {
                "arn": "arn:aws:iot:us-west-2:123456789012:all/unregistered-things"
            }
        }
    ]
}

Pour plus d'informations, consultez la section Détecter les commandes dans le guide du développeur de l'AWS IoT.

Pour répertorier les profils de sécurité de votre AWS compte

L'list-security-profilesexemple suivant répertorie tous les profils de sécurité AWS IoT Device Defender définis dans votre AWS compte.

aws iot list-security-profiles

Sortie :

{
    "securityProfileIdentifiers": [
        {
            "name": "Testprofile",
            "arn": "arn:aws:iot:us-west-2:123456789012:securityprofile/Testprofile"
        }
    ]
}

Pour plus d'informations, consultez la section Détecter les commandes dans le guide du développeur de l'AWS IoT.

Pour répertorier les streams du compte

L'list-streamsexemple suivant répertorie tous les streams de votre AWS compte.

aws iot list-streams

Sortie :

{
    "streams": [
        {
            "streamId": "stream12345",
            "streamArn": "arn:aws:iot:us-west-2:123456789012:stream/stream12345",
            "streamVersion": 1,
            "description": "This stream is used for Amazon FreeRTOS OTA Update 12345."
        },
        {
            "streamId": "stream54321",
            "streamArn": "arn:aws:iot:us-west-2:123456789012:stream/stream54321",
            "streamVersion": 1,
            "description": "This stream is used for Amazon FreeRTOS OTA Update 54321."
        }
    ]
}

Pour plus d'informations, consultez ListStreamsle manuel de référence des API AWS IoT.

Pour afficher les balises et leurs valeurs associées à une ressource

L'list-tags-for-resourceexemple suivant affiche les balises et les valeurs associées au groupe d'objetsLightBulbs.

aws iot list-tags-for-resource \
    --resource-arn "arn:aws:iot:us-west-2:094249569039:thinggroup/LightBulbs"

Sortie :

{
    "tags": [
        {
            "Key": "Assembly",
            "Value": "Fact1NW"
        },
        {
            "Key": "MyTag",
            "Value": "777"
        }
    ]
}

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

Pour répertorier les principes associés à une politique AWS IoT

L'list-targets-for-policyexemple suivant répertorie les certificats de périphérique auxquels la politique spécifiée est attachée.

aws iot list-targets-for-policy \
    --policy-name UpdateDeviceCertPolicy

Sortie :

{
    "targets": [
        "arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
        "arn:aws:iot:us-west-2:123456789012:cert/d1eb269fb55a628552143c8f96eb3c258fcd5331ea113e766ba0c82bf225f0be"
    ]
}

Pour plus d'informations, consultez la section Thing Groups dans le guide du développeur AWS IoT.

Pour répertorier les cibles auxquelles un profil de sécurité est appliqué

L'list-targets-for-security-profileexemple suivant répertorie les cibles auxquelles le profil de sécurité AWS IoT Device Defender nommé PossibleIssue est appliqué.

aws iot list-targets-for-security-profile \
    --security-profile-name Testprofile

Sortie :

{
    "securityProfileTargets": [
        {
            "arn": "arn:aws:iot:us-west-2:123456789012:all/unregistered-things"
        },
        {
            "arn": "arn:aws:iot:us-west-2:123456789012:all/registered-things"
        }
    ]
}

Pour plus d'informations, consultez la section Détecter les commandes dans le guide du développeur de l'AWS IoT.

Pour répertorier les groupes auxquels appartient un objet

L'list-thing-groups-for-thingexemple suivant répertorie les groupes auxquels appartient l'objet spécifié.

aws iot list-thing-groups-for-thing \
    --thing-name MyLightBulb

Sortie :

{
    "thingGroups": [
        {
            "groupName": "DeadBulbs",
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/DeadBulbs"
        },
        {
            "groupName": "LightBulbs",
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs"
        }
    ]
}

Pour plus d'informations, consultez la section Thing Groups dans le guide du développeur AWS IoT.

Pour répertorier les groupes d'objets définis dans votre AWS compte

L'describe-thing-groupexemple suivant répertorie tous les groupes d'objets définis dans votre AWS compte.

aws iot list-thing-groups

Sortie :

{
    "thingGroups": [
        {
            "groupName": "HalogenBulbs",
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/HalogenBulbs"
        },
        {
            "groupName": "LightBulbs",
            "groupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/LightBulbs"
        }
    ]
}

Pour plus d'informations, consultez la section Thing Groups dans le guide du développeur AWS IoT.

Pour répertorier les principes associés à un objet

L'list-thing-principalsexemple suivant répertorie les principaux (certificats X.509, utilisateurs IAM, groupes, rôles, identités Amazon Cognito ou identités fédérées) associés à l'objet spécifié.

aws iot list-thing-principals \
    --thing-name MyRaspberryPi

Sortie :

{
    "principals": [
        "arn:aws:iot:us-west-2:123456789012:cert/33475ac865079a5ffd5ecd44240640349293facc760642d7d8d5dbb6b4c86893"
    ]
}

Pour plus d'informations, consultez ListThingPrincipalsle manuel de référence des API AWS IoT.

Pour répertorier les types d'objets définis

L'list-thing-typesexemple suivant affiche une liste des types d'objets définis dans votre AWS compte.

aws iot list-thing-types

Sortie :

{
    "thingTypes": [
        {
            "thingTypeName": "LightBulb",
            "thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb",
            "thingTypeProperties": {
                "thingTypeDescription": "light bulb type",
                "searchableAttributes": [
                    "model",
                    "wattage"
                ]
            },
            "thingTypeMetadata": {
            "deprecated": false,
            "creationDate": 1559772562.498
            }
        }
    ]
}

Pour plus d'informations, consultez la section Types d'objets dans le Guide du développeur de l'AWS IoT.

Pour répertorier les éléments d'un groupe de facturation

L'list-things-in-billing-groupexemple suivant répertorie les éléments qui se trouvent dans le groupe de facturation spécifié.

aws iot list-things-in-billing-group \
    --billing-group-name GroupOne

Sortie :

{
    "things": [
        "MyOtherLightBulb",
        "MyLightBulb"
    ]
}

Pour plus d'informations, consultez la section Groupes de facturation dans le Guide du développeur AWS IoT.

Pour répertorier les éléments appartenant à un groupe

L'list-things-in-thing-groupexemple suivant répertorie les objets appartenant au groupe d'objets spécifié.

aws iot list-things-in-thing-group \
    --thing-group-name LightBulbs

Sortie :

{
    "things": [
        "MyLightBulb"
    ]
}

Pour plus d'informations, consultez la section Thing Groups dans le guide du développeur AWS IoT.

Exemple 1 : pour répertorier tous les éléments du registre

L'list-thingsexemple suivant répertorie les objets (appareils) définis dans le registre AWS IoT de votre AWS compte.

aws iot list-things

Sortie :

{
    "things": [
        {
            "thingName": "ThirdBulb",
            "thingTypeName": "LightBulb",
            "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/ThirdBulb",
            "attributes": {
                "model": "123",
                "wattage": "75"
            },
            "version": 2
        },
        {
            "thingName": "MyOtherLightBulb",
            "thingTypeName": "LightBulb",
            "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyOtherLightBulb",
            "attributes": {
                "model": "123",
                "wattage": "75"
            },
            "version": 3
        },
        {
            "thingName": "MyLightBulb",
            "thingTypeName": "LightBulb",
            "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb",
            "attributes": {
                "model": "123",
                "wattage": "75"
            },
            "version": 1
        },
        {
        "thingName": "SampleIoTThing",
        "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/SampleIoTThing",
        "attributes": {},
        "version": 1
        }
    ]
}

Exemple 2 : pour répertorier les éléments définis dotés d'un attribut spécifique

L'list-thingsexemple suivant affiche une liste d'objets dotés d'un attribut nomméwattage.

aws iot list-things \
    --attribute-name wattage

Sortie :

{
    "things": [
        {
            "thingName": "MyLightBulb",
            "thingTypeName": "LightBulb",
            "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyLightBulb",
            "attributes": {
                "model": "123",
                "wattage": "75"
            },
            "version": 1
        },
        {
            "thingName": "MyOtherLightBulb",
            "thingTypeName": "LightBulb",
            "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyOtherLightBulb",
            "attributes": {
                "model": "123",
                "wattage": "75"
            },
            "version": 3
        }
    ]
}

Pour plus d'informations, consultez la section Comment gérer les objets avec le registre dans le Guide du développeur de l'AWS IoT.

Pour répertorier votre sujet, réglez les destinations

L'list-topic-rule-destinationsexemple suivant répertorie toutes les destinations des règles de rubrique que vous avez définies dans la AWS région actuelle.

aws iot list-topic-rule-destinations

Sortie :

{
    "destinationSummaries": [
        {
            "arn": "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
            "status": "ENABLED",
            "httpUrlSummary": {
                "confirmationUrl": "https://example.com"
            }
        }
    ]
}

Pour plus d'informations, consultez la section Travailler avec des destinations de règles thématiques dans le Guide du développeur de l'AWS IoT.

Pour répertorier vos règles

L'list-topic-rulesexemple suivant répertorie toutes les règles que vous avez définies.

aws iot list-topic-rules

Sortie :

{
    "rules": [
        {
            "ruleArn": "arn:aws:iot:us-west-2:123456789012:rule/MyRPiLowMoistureAlertRule",
            "ruleName": "MyRPiLowMoistureAlertRule",
            "topicPattern": "$aws/things/MyRPi/shadow/update/accepted",
            "createdAt": 1558624363.0,
            "ruleDisabled": false
        },
        {
            "ruleArn": "arn:aws:iot:us-west-2:123456789012:rule/MyPlantPiMoistureAlertRule",
            "ruleName": "MyPlantPiMoistureAlertRule",
            "topicPattern": "$aws/things/MyPlantPi/shadow/update/accepted",
            "createdAt": 1541458459.0,
            "ruleDisabled": false
        }
    ]
}

Pour plus d'informations, consultez la section Visualisation de vos règles dans le Guide du développeur de l'AWS IoT.

Pour répertorier les niveaux de journalisation

L'list-v2-logging-levelsexemple suivant répertorie les niveaux de journalisation configurés. Si les niveaux de journalisation n'ont pas été définis, un NotConfiguredException se produit lorsque vous exécutez cette commande.

aws iot list-v2-logging-levels

Sortie :

{
    "logTargetConfigurations": [
        {
            "logTarget": {
                "targetType": "DEFAULT"
            },
            "logLevel": "ERROR"
        }
    ]
}

Pour répertorier les violations du profil de sécurité au cours d'une période donnée

L'list-violation-eventsexemple suivant répertorie les violations survenues entre le 5 juin 2019 et le 12 juin 2019 pour tous les profils de sécurité AWS IoT Device Defender du AWS compte courant et de AWS la région.

aws iot list-violation-events \
    --start-time 1559747125 \
    --end-time 1560351925

Sortie :

{
    "violationEvents": [
        {
            "violationId": "174db59167fa474c80a652ad1583fd44",
            "thingName": "iotconsole-1560269126751-1",
            "securityProfileName": "Testprofile",
            "behavior": {
                "name": "Authorization",
                "metric": "aws:num-authorization-failures",
                "criteria": {
                    "comparisonOperator": "greater-than",
                    "value": {
                        "count": 10
                    },
                    "durationSeconds": 300,
                    "consecutiveDatapointsToAlarm": 1,
                    "consecutiveDatapointsToClear": 1
                }
            },
            "metricValue": {
                "count": 0
            },
            "violationEventType": "in-alarm",
            "violationEventTime": 1560279000.0
        },
        {
            "violationId": "c8a9466a093d3b7b35cd44ca58bdbeab",
            "thingName": "TvnQoEoU",
            "securityProfileName": "Testprofile",
            "behavior": {
                "name": "CellularBandwidth",
                "metric": "aws:message-byte-size",
                "criteria": {
                    "comparisonOperator": "greater-than",
                    "value": {
                        "count": 128
                    },
                    "consecutiveDatapointsToAlarm": 1,
                    "consecutiveDatapointsToClear": 1
                }
            },
            "metricValue": {
                "count": 110
            },
            "violationEventType": "in-alarm",
            "violationEventTime": 1560276600.0
        },
        {
            "violationId": "74aa393adea02e6648f3ac362beed55e",
            "thingName": "iotconsole-1560269232412-2",
            "securityProfileName": "Testprofile",
            "behavior": {
                "name": "Authorization",
                "metric": "aws:num-authorization-failures",
                "criteria": {
                    "comparisonOperator": "greater-than",
                    "value": {
                        "count": 10
                    },
                    "durationSeconds": 300,
                    "consecutiveDatapointsToAlarm": 1,
                    "consecutiveDatapointsToClear": 1
                }
            },
            "metricValue": {
                "count": 0
            },
            "violationEventType": "in-alarm",
            "violationEventTime": 1560276600.0
        },
        {
            "violationId": "1e6ab5f7cf39a1466fcd154e1377e406",
            "thingName": "TvnQoEoU",
            "securityProfileName": "Testprofile",
            "behavior": {
                "name": "Authorization",
                "metric": "aws:num-authorization-failures",
                "criteria": {
                    "comparisonOperator": "greater-than",
                    "value": {
                        "count": 10
                    },
                    "durationSeconds": 300,
                    "consecutiveDatapointsToAlarm": 1,
                    "consecutiveDatapointsToClear": 1
                }
            },
            "metricValue": {
                "count": 0
            },
            "violationEventType": "in-alarm",
            "violationEventTime": 1560276600.0
        }
    ]
}

Pour plus d'informations, consultez la section Détecter les commandes dans le guide du développeur de l'AWS IoT.

Pour enregistrer un certificat d'autorité de certification (CA)

L'register-ca-certificateexemple suivant enregistre un certificat CA. La commande fournit le certificat CA et un certificat de vérification de clé qui prouve que vous possédez la clé privée associée au certificat CA.

aws iot register-ca-certificate \
    --ca-certificate file://rootCA.pem \
    --verification-cert file://verificationCert.pem

Sortie :

{
    "certificateArn": "arn:aws:iot:us-west-2:123456789012:cacert/f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467",
    "certificateId": "f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467"
 }

Pour plus d'informations, consultez la section S'inscrire CACertificate dans le guide de référence des API AWS IoT.

Pour enregistrer un certificat d'appareil auto-signé

L'register-certificateexemple suivant enregistre le certificat de deviceCert.pem périphérique signé par le certificat rootCA.pem CA. Le certificat CA doit être enregistré avant que vous ne l'utilisiez pour enregistrer un certificat d'appareil auto-signé. Le certificat auto-signé doit être signé par le même certificat CA que celui que vous avez transmis à cette commande.

aws iot register-certificate \
    --certificate-pem file://deviceCert.pem \
    --ca-certificate-pem file://rootCA.pem

Sortie :

{
    "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142",
    "certificateId": "488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142"
 }

Pour plus d'informations, consultez RegisterCertificatele manuel de référence des API AWS IoT.

Pour enregistrer un objet

L'register-thingexemple suivant enregistre un objet à l'aide d'un modèle de provisioning.

aws iot register-thing \
    --template-body '{"Parameters":{"ThingName":{"Type":"String"},"AWS::IoT::Certificate::Id":{"Type":"String"}},"Resources": {"certificate":{"Properties":{"CertificateId":{"Ref":"AWS::IoT::Certificate::Id"},"Status":"Active"},"Type":"AWS::IoT::Certificate"},"policy":{"Properties":{"PolicyName":"MyIotPolicy"},"Type":"AWS::IoT::Policy"},"thing":{"OverrideSettings":{"AttributePayload":"MERGE","ThingGroups":"DO_NOTHING","ThingTypeName":"REPLACE"},"Properties":{"AttributePayload":{},"ThingGroups":[],"ThingName":{"Ref":"ThingName"},"ThingTypeName":"VirtualThings"},"Type":"AWS::IoT::Thing"}}}' \
    --parameters '{"ThingName":"Register-thing-trial-1","AWS::IoT::Certificate::Id":"799a9ea048a1e6aea42b55EXAMPLEf8697b4bafcd77a318a3068e30404b9233c"}'

Sortie :

{
    "certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDWTCCAkGgAwIBAgIUYLk81I35cIppobpw
HiOJ2jNjboIwDQYJKoZIhvcNAQEL\nBQAwTTFLMEkGA1UECwxCQW1hem9uIFdlYiBTZXJ2aWNlcyBPPUFtYXpvbi
5jb20g\nSW5jLiBMPVNlYXR0bGUgU1Q9V2FzaGluZ3RvbiBDPVVTMB4XDTIwMDcyMzE2NDUw\nOVoXDTQ5MTIzMT
IzNTk1OVowHjEcMBoGA1UEAwwTQVdTIElvVCBDZXJ0aWZpY2F0\nZTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCC
AQoCggEBAO71uADhdBajqTmgrMV5\nmCFfBZQRMo1MdtVoZr2X+M4MzL+RARrtUzH9a2SMAckeX8KeblIOTKzORI
RDXnyE\n6lVOwjgAsd0ku22rFxex4eG2ikha7pYYkvuToqA7L3TxItRvfKrxRI4ZfJoFPip4\nKqiuBJVNOGKTcQ
Hd1RNOrddwwu6kFJLeKDmEXAMPLEdUF0N+qfR9yKnZQkm+g6Q2\nGXu7u0W3hn6nlRN8qVoka0uW12p53xM7oHVz
Gf+cxKBxlbOhGkp6yCfTSkUBm3Sp\n9zLw35kiHXVm4EVpwgNlnk6XcIGIkw8a/iy4pzmvuGAANY1/uU/zgCjymw
ZT5S30\nBV0CAwEAAaNgMF4wHwYDVR0jBBgwFoAUGx0tCcU3q2n1WXAuUCv6hugXjKswHQYD\nVR0OBBYEFOVtvZ
9Aj2RYFnkX7Iu01XTRUdxgMAwGA1UdEwEB/wQCMAAwDgYDVR0P\nAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4IB
AQCXCQcpOtubS5ftOsDMTcpP/jNX\nDHyArxmjpSc2aCdmm7WX59lTKWyAdxGAvqaDVWqTo0oXI7tZ8w7aINlGi5
pXnifx\n3SBebMUoBbTktrC97yUaeL025mCFv8emDnTR/fE7PTsBKjW0g/rrfpwBxZLXDFwN\nnqkQjy3EDfifj2
6j0xYIqqWMPogyn4srOCKynS5wMJuQZlHQOnabVwnwK4Y0Mflp\np9+4susFUR9aT3BT1AcIwqSpzhlKhh4Iz7ND
kRn4amsUT210jg/zOO1Ow+BTHcVQ\nJly8XDu0CWSu04q6SnaBzHmlySIajxuRTP/AdfRouP1OXe+qlbPOBcvVvF
8o\n-----END CERTIFICATE-----\n",
    "resourceArns": {
        "certificate": "arn:aws:iot:us-west-2:571032923833:cert/799a9ea048a1e6aea42b55EXAMPLEf8697b4bafcd77a318a3068e30404b9233c",
        "thing": "arn:aws:iot:us-west-2:571032923833:thing/Register-thing-trial-1"
    }
}

Pour plus d'informations, consultez la section Provisionnement par un utilisateur de confiance dans le Guide du développeur AWS IoT Core.

Pour refuser un transfert de certificat

L'reject-certificate-transferexemple suivant rejette le transfert du certificat d'appareil spécifié depuis un autre AWS compte.

aws iot reject-certificate-transfer \
    --certificate-id f0f33678c7c9a046e5cc87b2b1a58dfa0beec26db78addd5e605d630e05c7fc8

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Transférer un certificat vers un autre compte dans le guide du développeur AWS IoT Core.

Pour supprimer un élément d'un groupe de facturation

L'remove-thing-from-billing-groupexemple suivant supprime l'élément spécifié d'un groupe de facturation.

aws iot remove-thing-from-billing-group \
    --billing-group-name GroupOne \
    --thing-name MyOtherLightBulb

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Groupes de facturation dans le Guide du développeur AWS IoT.

Pour supprimer un objet d'un groupe d'objets

L'remove-thing-from-thing-groupexemple suivant supprime l'objet spécifié d'un groupe d'objets.

aws iot remove-thing-from-thing-group \
    --thing-name bulb7 \
    --thing-group-name DeadBulbs

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Thing Groups < https://docs.aws.amazon.com/iot/ latest/developerguide/thing -groups.html > dans le Guide du développeur de l'AWS IoT.

Pour mettre à jour la définition de règle d'une rubrique

L'replace-topic-ruleexemple suivant met à jour la règle spécifiée pour envoyer une alerte SNS lorsque les relevés du niveau d'humidité du sol sont trop faibles.

aws iot replace-topic-rule \
    --rule-name MyRPiLowMoistureAlertRule \
    --topic-rule-payload "{\"sql\": \"SELECT * FROM '$aws/things/MyRPi/shadow/update/accepted' WHERE state.reported.moisture = 'low'\", \"description\": \"Sends an alert when soil moisture level readings are too low.\",\"actions\": [{\"sns\":{\"targetArn\":\"arn:aws:sns:us-west-2:123456789012:MyRPiLowMoistureTopic\",\"roleArn\":\"arn:aws:iam::123456789012:role/service-role/MyRPiLowMoistureTopicRole\",\"messageFormat\": \"RAW\"}}],\"ruleDisabled\": false,\"awsIotSqlVersion\":\"2016-03-23\"}"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Création d'une règle AWS IoT dans le Guide du développeur de l'AWS IoT.

Pour interroger l'index des objets

L'search-indexexemple suivant interroge l'AWS_Thingsindex pour les objets de typeLightBulb.

aws iot search-index \
    --index-name "AWS_Things" \
    --query-string "thingTypeName:LightBulb"

Sortie :

{
    "things": [
        {
            "thingName": "MyLightBulb",
            "thingId": "40da2e73-c6af-406e-b415-15acae538797",
            "thingTypeName": "LightBulb",
            "thingGroupNames": [
                "LightBulbs",
                "DeadBulbs"
            ],
            "attributes": {
                "model": "123",
                "wattage": "75"
            },
            "connectivity": {
                "connected": false
            }
        },
        {
            "thingName": "ThirdBulb",
            "thingId": "615c8455-33d5-40e8-95fd-3ee8b24490af",
            "thingTypeName": "LightBulb",
            "attributes": {
                "model": "123",
                "wattage": "75"
            },
            "connectivity": {
                "connected": false
            }
        },
        {
            "thingName": "MyOtherLightBulb",
            "thingId": "6dae0d3f-40c1-476a-80c4-1ed24ba6aa11",
            "thingTypeName": "LightBulb",
            "attributes": {
                "model": "123",
                "wattage": "75"
            },
            "connectivity": {
                "connected": false
            }
        }
    ]
}

Pour plus d'informations, consultez la section Managing Thing Indexing dans le Guide du développeur de l'AWS IoT.

Pour définir un autorisateur par défaut

L'set-default-authorizerexemple suivant définit l'autorisateur personnalisé CustomAuthorizer comme étant l'autorisateur par défaut.

aws iot set-default-authorizer \
    --authorizer-name CustomAuthorizer

Sortie :

{
    "authorizerName": "CustomAuthorizer",
    "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer"
}

Pour plus d'informations, consultez CreateDefaultAuthorizerle manuel de référence des API AWS IoT.

Pour définir la version par défaut d'une politique

L'set-default-policy-versionexemple suivant définit la version par défaut sur 2 pour la politique nomméeUpdateDeviceCertPolicy.

aws iot set-default-policy-version \
    --policy-name UpdateDeviceCertPolicy \
    --policy-version-id 2

Cette commande ne produit aucun résultat.

Pour définir le niveau de journalisation d'un groupe d'objets

L'set-v2-logging-levelexemple suivant définit le niveau de journalisation pour consigner les avertissements pour le groupe d'objets spécifié.

aws iot set-v2-logging-level \
    --log-target "{\"targetType\":\"THING_GROUP\",\"targetName\":\"LightBulbs\"}" \
    --log-level WARN

Cette commande ne produit aucun résultat.

Pour définir les options de journalisation

L'set-v2-logging-optionsexemple suivant définit le niveau de verbosité de journalisation par défaut sur ERROR et indique l'ARN à utiliser pour la journalisation.

aws iot set-v2-logging-options \
    --default-log-level ERROR \
    --role-arn "arn:aws:iam::094249569039:role/service-role/iotLoggingRole"

Cette commande ne produit aucun résultat.

Appliquer une mesure d'atténuation aux résultats d'un audit

L'start-audit-mitigation-actions-taskexemple suivant applique l'ResetPolicyVersionActionaction (qui efface la politique) au résultat unique spécifié.

aws iot start-audit-mitigation-actions-task \
    --task-id "myActionsTaskId" \
    --target "findingIds=[\"0edbaaec-2fe1-4cf5-abc9-d4c3e51f7464\"]" \
    --audit-check-to-actions-mapping "IOT_POLICY_OVERLY_PERMISSIVE_CHECK=[\"ResetPolicyVersionAction\"]" \
    --client-request-token "adhadhahda"

Sortie :

{
    "taskId": "myActionsTaskId"
}

Pour plus d'informations, voir StartAuditMitigationActionsTask (Mitigation Action Commands) dans le Guide du développeur de l'AWS IoT.

Pour démarrer un audit immédiatement

L'start-on-demand-audit-taskexemple suivant lance un audit AWS IoT Device Defender et effectue trois vérifications de certificats.

aws iot start-on-demand-audit-task \
    --target-check-names CA_CERTIFICATE_EXPIRING_CHECK DEVICE_CERTIFICATE_EXPIRING_CHECK REVOKED_CA_CERTIFICATE_STILL_ACTIVE_CHECK

Sortie :

{
    "taskId": "a3aea009955e501a31b764abe1bebd3d"
}

Pour plus d'informations, consultez la section Commandes d'audit du guide du développeur de l'AWS IoT.

Pour spécifier une balise, une clé et une valeur pour une ressource

L'tag-resourceexemple suivant applique la balise avec une clé Assembly et la valeur Fact1NW au groupe d'objetsLightBulbs.

aws iot tag-resource \
    --tags Key=Assembly,Value="Fact1NW" \
    --resource-arn "arn:aws:iot:us-west-2:094249569039:thinggroup/LightBulbs"

Cette commande ne produit aucun résultat.

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

Pour tester vos politiques en matière d' AWS IoT

L'test-authorizationexemple suivant teste les politiques AWS IoT associées au principal spécifié.

aws iot test-authorization \
    --auth-infos actionType=CONNECT,resources=arn:aws:iot:us-east-1:123456789012:client/client1 \
    --principal arn:aws:iot:us-west-2:123456789012:cert/aab1068f7f43ac3e3cae4b3a8aa3f308d2a750e6350507962e32c1eb465d9775

Sortie :

{
    "authResults": [
        {
            "authInfo": {
                "actionType": "CONNECT",
                "resources": [
                    "arn:aws:iot:us-east-1:123456789012:client/client1"
                ]
            },
            "allowed": {
                "policies": [
                    {
                        "policyName": "TestPolicyAllowed",
                        "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TestPolicyAllowed"
                    }
                ]
            },
            "denied": {
                "implicitDeny": {
                    "policies": [
                        {
                            "policyName": "TestPolicyDenied",
                            "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TestPolicyDenied"
                        }
                    ]
                },
                "explicitDeny": {
                    "policies": [
                        {
                            "policyName": "TestPolicyExplicitDenied",
                            "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/TestPolicyExplicitDenied"
                        }
                    ]
                }
            },
            "authDecision": "IMPLICIT_DENY",
            "missingContextValues": []
        }
    ]
}

Pour plus d'informations, consultez TestAuthorizationle manuel de référence des API AWS IoT.

Pour tester votre autorisateur personnalisé

L'test-invoke-authorizerexemple suivant teste votre autorisateur personnalisé.

aws iot test-invoke-authorizer \
    --authorizer-name IoTAuthorizer \
    --token allow \
    --token-signature "mE0GvaHqy9nER/FdgtJX5lXYEJ3b3vE7t1gEszc0TKGgLKWXTnPkb2AbKnOAZ8lGyoN5dVtWDWVmr25m7++zjbYIMk2TBvyGXhOmvKFBPkdgyA43KL6SiZy0cTqlPMcQDsP7VX2rXr7CTowCxSNKphGXdQe0/I5dQ+JO6KUaHwCmupt0/MejKtaNwiia064j6wprOAUwG5S1IYFuRd0X+wfo8pb0DubAIX1Ua705kuhRUcTx4SxUShEYKmN4IDEvLB6FsIr0B2wvB7y4iPmcajxzGl02ExvyCUNctCV9dYlRRGJj0nsGzBIXOI4sGytPfqlA7obdgmN22pkDzYvwjQ=="

Sortie :

{
    "isAuthenticated": true,
    "principalId": "principalId",
    "policyDocuments": [
        "{"Version":"2012-10-17","Statement":[{"Action":"iot:Publish","Effect":"Allow","Resource":"arn:aws:iot:us-west-2:123456789012:topic/customauthtesting"}]}"
    ],
    "refreshAfterInSeconds": 600,
    "disconnectAfterInSeconds": 3600
}

Pour plus d'informations, consultez TestInvokeAuthorizerle manuel de référence des API AWS IoT.

Pour transférer un certificat d'appareil vers un autre AWS compte

L'transfer-certificateexemple suivant transfère un certificat d'appareil vers un autre AWS compte. Le certificat et le AWS compte sont identifiés par un identifiant.

aws iot transfer-certificate \
    --certificate-id 488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142 \
    --target-aws-account 030714055129

Sortie :

{
    "transferredCertificateArn": "arn:aws:iot:us-west-2:030714055129:cert/488b6a7f2acdeb00a77384e63c4e40b18b1b3caaae57b7272ba44c45e3448142"
}

Pour plus d'informations, consultez la section Transférer un certificat vers un autre compte dans le guide du développeur AWS IoT Core.

Pour supprimer une clé de balise d'une ressource

L'untag-resourceexemple suivant supprime la balise MyTag et sa valeur du groupe d'objetsLightBulbs.

command

Cette commande ne produit aucun résultat.

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

Exemple 1 : pour activer les notifications Amazon SNS pour les notifications d'audit

L'update-account-audit-configurationexemple suivant active les notifications Amazon SNS pour les notifications d'audit AWS IoT Device Defender, en spécifiant une cible et le rôle utilisé pour écrire sur cette cible.

aws iot update-account-audit-configuration \
    --audit-notification-target-configurations "SNS={targetArn=\"arn:aws:sns:us-west-2:123456789012:ddaudits\",roleArn=\"arn:aws:iam::123456789012:role/service-role/AWSIoTDeviceDefenderAudit\",enabled=true}"

Cette commande ne produit aucun résultat.

Exemple 2 : pour activer un contrôle d'audit

L'update-account-audit-configurationexemple suivant active le contrôle d'audit AWS IoT Device Defender nomméAUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK. Vous ne pouvez pas désactiver un contrôle d'audit s'il fait partie d'un ou de plusieurs audits planifiés pour le AWS compte. targetCheckNames

aws iot update-account-audit-configuration \
    --audit-check-configurations "{\"AUTHENTICATED_COGNITO_ROLE_OVERLY_PERMISSIVE_CHECK\":{\"enabled\":true}}"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Commandes d'audit du guide du développeur de l'AWS IoT.

Pour mettre à jour la suppression d'un résultat d'audit

L'update-audit-suppressionexemple suivant met à jour la date d'expiration de la suppression d'un résultat d'audit au 21/09/2020.

aws iot update-audit-suppression \
    --check-name DEVICE_CERTIFICATE_EXPIRING_CHECK \
    --resource-identifier deviceCertificateId=c7691e<shortened> \
    --no-suppress-indefinitely \
    --expiration-date 2020-09-21

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Audit sur les suppressions dans le Guide du développeur de l'AWS IoT.

Pour mettre à jour un autorisateur personnalisé

L'update-authorizerexemple suivant montre l'état CustomAuthorizer2 de deuxINACTIVE.

aws iot update-authorizer \
    --authorizer-name CustomAuthorizer2 \
    --status INACTIVE

Sortie :

{
    "authorizerName": "CustomAuthorizer2",
    "authorizerArn": "arn:aws:iot:us-west-2:123456789012:authorizer/CustomAuthorizer2"
}

Pour plus d'informations, consultez UpdateAuthorizerle manuel de référence des API AWS IoT.

Pour mettre à jour les informations relatives à un groupe de facturation

L'update-billing-groupexemple suivant met à jour la description du groupe de facturation spécifié.

aws iot update-billing-group \
    --billing-group-name GroupOne \
    --billing-group-properties "billingGroupDescription=\"Primary bulb billing group\""

Sortie :

{
    "version": 2
}

Pour plus d'informations, consultez la section Groupes de facturation dans le Guide du développeur AWS IoT.

Pour mettre à jour un certificat d'autorité de certification (CA)

L'update-ca-certificateexemple suivant attribue au certificat CA spécifié le statut ACTIF.

aws iot update-ca-certificate \
    --certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467 \
    --new-status ACTIVE

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Mise CACertificate à jour de la référence des API AWS IoT.

Pour mettre à jour le certificat d'un appareil

L'update-certificateexemple suivant définit le certificat d'appareil spécifié sur le statut INACTIF.

aws iot update-certificate \
    --certificate-id d1eb269fb55a628552143c8f96eb3c258fcd5331ea113e766ba0c82bf225f0be \
    --new-status INACTIVE

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez UpdateCertificatele manuel de référence des API AWS IoT.

Pour mettre à jour une métrique personnalisée

L'update-custom-metricexemple suivant met à jour une métrique personnalisée pour en ajouter une nouvelledisplay-name.

aws iot update-custom-metric \
    --metric-name batteryPercentage \
    --display-name 'remaining battery percentage on device' \
    --region us-east-1

Sortie :

{
    "metricName": "batteryPercentage",
    "metricArn": "arn:aws:iot:us-east-1:1234564789012:custommetric/batteryPercentage",
    "metricType": "number",
    "displayName": "remaining battery percentage on device",
    "creationDate": "2020-11-17T23:01:35.110000-08:00",
    "lastModifiedDate": "2020-11-17T23:02:12.879000-08:00"
}

Pour plus d'informations, consultez la section Mesures personnalisées dans le Guide du développeur AWS IoT Core.

Pour mettre à jour une dimension

L'update-dimensionexemple suivant met à jour une dimension.

aws iot update-dimension \
    --name TopicFilterForAuthMessages \
    --string-values device/${iot:ClientId}/auth

Sortie :

{
    "name": "TopicFilterForAuthMessages",
    "lastModifiedDate": 1585866222.317,
    "stringValues": [
        "device/${iot:ClientId}/auth"
    ],
    "creationDate": 1585854500.474,
    "type": "TOPIC_FILTER",
    "arn": "arn:aws:iot:us-west-2:1234564789012:dimension/TopicFilterForAuthMessages"
}

Pour plus d'informations, consultez la section Délimitation des métriques dans les profils de sécurité à l'aide de dimensions dans le guide du développeur AWS IoT Core.

Pour mettre à jour la configuration d'un domaine

L'update-domain-configurationexemple suivant désactive la configuration de domaine spécifiée.

aws iot update-domain-configuration \
    --domain-configuration-name "additionalDataDomain" \
    --domain-configuration-status "DISABLED"

Sortie :

{
    "domainConfigurationName": "additionalDataDomain",
    "domainConfigurationArn": "arn:aws:iot:us-west-2:123456789012:domainconfiguration/additionalDataDomain/dikMh"
}

Pour plus d'informations, consultez la section Points de terminaison configurables dans le Guide du développeur de l'AWS IoT.

Pour mettre à jour un groupe d'objets dynamique

L'update-dynamic-thing-groupexemple suivant met à jour le groupe d'objets dynamiques spécifié. Il fournit une description et met à jour la chaîne de requête pour modifier les critères d'appartenance au groupe.

aws iot update-dynamic-thing-group \
    --thing-group-name "RoomTooWarm"
    --thing-group-properties "thingGroupDescription=\"This thing group contains rooms warmer than 65F.\"" \
    --query-string "attributes.temperature>65"

Sortie :

{
    "version": 2
}

Pour plus d'informations, consultez Dynamic Thing Groups dans le Guide du développeur AWS IoT.

Pour afficher les types d'événements publiés

L'update-event-configurationsexemple suivant met à jour la configuration pour activer les messages lorsque le certificat CA est ajouté, mis à jour ou supprimé.

aws iot update-event-configurations \
    --event-configurations "{\"CA_CERTIFICATE\":{\"Enabled\":true}}"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Messages d'événements dans le guide du développeur de l'AWS IoT.

Pour activer l'indexation des objets

L'update-indexing-configurationexemple suivant active l'indexation des objets pour prendre en charge la recherche dans les données de registre, les données fictives et l'état de connectivité des objets à l'aide de l'index AWS_Things.

aws iot update-indexing-configuration
    --thing-indexing-configuration thingIndexingMode=REGISTRY_AND_SHADOW,thingConnectivityIndexingMode=STATUS

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Managing Thing Indexing dans le Guide du développeur AWS IoT.

Pour obtenir le statut détaillé d'une tâche

L'update-jobexemple suivant permet d'obtenir le statut détaillé de la tâche dont l'ID estexample-job-01.

aws iot describe-job \
    --job-id "example-job-01"

Sortie :

{
    "job": {
        "jobArn": "arn:aws:iot:us-west-2:123456789012:job/example-job-01",
        "jobId": "example-job-01",
        "targetSelection": "SNAPSHOT",
        "status": "IN_PROGRESS",
        "targets": [
            "arn:aws:iot:us-west-2:123456789012:thing/MyRaspberryPi"
        ],
        "description": "example job test",
        "presignedUrlConfig": {},
        "jobExecutionsRolloutConfig": {},
        "createdAt": 1560787022.733,
        "lastUpdatedAt": 1560787026.294,
        "jobProcessDetails": {
            "numberOfCanceledThings": 0,
            "numberOfSucceededThings": 0,
            "numberOfFailedThings": 0,
            "numberOfRejectedThings": 0,
            "numberOfQueuedThings": 1,
            "numberOfInProgressThings": 0,
            "numberOfRemovedThings": 0,
            "numberOfTimedOutThings": 0
        },
        "timeoutConfig": {}
    }
}

Pour plus d'informations, consultez Creating and Managing Jobs (CLI) dans le Guide du développeur de l'AWS IoT.

Pour mettre à jour une mesure d'atténuation

L'update-mitigation-actionexemple suivant met à jour l'action d'atténuation spécifiée nomméeAddThingsToQuarantineGroupAction, modifie le nom du groupe d'objets et la définit overrideDynamicGroups surfalse. Vous pouvez vérifier vos modifications à l'aide de la describe-mitigation-action commande.

aws iot update-mitigation-action \
    --cli-input-json "{ \"actionName\": \"AddThingsToQuarantineGroupAction\", \"actionParams\": { \"addThingsToThingGroupParams\": {\"thingGroupNames\":[\"QuarantineGroup2\"],\"overrideDynamicGroups\": false}}}"

Sortie :

{
    "actionArn": "arn:aws:iot:us-west-2:123456789012:mitigationaction/AddThingsToQuarantineGroupAction",
    "actionId": "2fd2726d-98e1-4abf-b10f-09465ccd6bfa"
}

Pour plus d'informations, voir UpdateMitigationAction (Mitigation Action Commands) dans le Guide du développeur de l'AWS IoT.

Pour mettre à jour un modèle de provisionnement

L'update-provisioning-templateexemple suivant modifie la description et le rôle arn du modèle de provisionnement spécifié et active le modèle.

aws iot update-provisioning-template \
    --template-name widget-template \
    --enabled \
    --description "An updated provisioning template for widgets" \
    --provisioning-role-arn arn:aws:iam::504350838278:role/Provision_role

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section AWS IoT Secure Tunneling dans le guide du développeur AWS IoT Core.

Pour mettre à jour un alias de rôle

L'update-role-aliasexemple suivant met à jour l'alias du LightBulbRole rôle.

aws iot update-role-alias \
    --role-alias LightBulbRole \
    --role-arn arn:aws:iam::123456789012:role/lightbulbrole-001

Sortie :

{
    "roleAlias": "LightBulbRole",
    "roleAliasArn": "arn:aws:iot:us-west-2:123456789012:rolealias/LightBulbRole"
}

Pour plus d'informations, consultez UpdateRoleAliasle manuel de référence des API AWS IoT.

Pour mettre à jour une définition d'audit planifié

L'update-scheduled-auditexemple suivant modifie les noms des contrôles cibles pour un audit planifié AWS IoT Device Defender.

aws iot update-scheduled-audit \
    --scheduled-audit-name WednesdayCertCheck \
    --target-check-names CA_CERTIFICATE_EXPIRING_CHECK DEVICE_CERTIFICATE_EXPIRING_CHECK REVOKED_CA_CERTIFICATE_STILL_ACTIVE_CHECK

Sortie :

{
    "scheduledAuditArn": "arn:aws:iot:us-west-2:123456789012:scheduledaudit/WednesdayCertCheck"
}

Pour plus d'informations, consultez la section Commandes d'audit du guide du développeur de l'AWS IoT.

Pour modifier un profil de sécurité

L'update-security-profileexemple suivant met à jour à la fois la description et les comportements d'un profil de sécurité AWS IoT Device Defender.

aws iot update-security-profile \
    --security-profile-name PossibleIssue \
    --security-profile-description "Check to see if authorization fails 12 times in 5 minutes or if cellular bandwidth exceeds 128"  \
    --behaviors "[{\"name\":\"CellularBandwidth\",\"metric\":\"aws:message-byte-size\",\"criteria\":{\"comparisonOperator\":\"greater-than\",\"value\":{\"count\":128},\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}},{\"name\":\"Authorization\",\"metric\":\"aws:num-authorization-failures\",\"criteria\":{\"comparisonOperator\":\"less-than\",\"value\":{\"count\":12},\"durationSeconds\":300,\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}}]"

Sortie :

{
    "securityProfileName": "PossibleIssue",
    "securityProfileArn": "arn:aws:iot:us-west-2:123456789012:securityprofile/PossibleIssue",
    "securityProfileDescription": "check to see if authorization fails 12 times in 5 minutes or if cellular bandwidth exceeds 128",
    "behaviors": [
        {
            "name": "CellularBandwidth",
            "metric": "aws:message-byte-size",
            "criteria": {
                "comparisonOperator": "greater-than",
                "value": {
                    "count": 128
                },
                "consecutiveDatapointsToAlarm": 1,
                "consecutiveDatapointsToClear": 1
            }
        },
        {
            "name": "Authorization",
            "metric": "aws:num-authorization-failures",
            "criteria": {
                "comparisonOperator": "less-than",
                "value": {
                    "count": 12
                },
                "durationSeconds": 300,
                "consecutiveDatapointsToAlarm": 1,
                "consecutiveDatapointsToClear": 1
            }
        }
    ],
    "version": 2,
    "creationDate": 1560278102.528,
    "lastModifiedDate": 1560352711.207
}

Pour plus d'informations, consultez la section Détecter les commandes dans le guide du développeur de l'AWS IoT.

Pour mettre à jour un stream

L'update-streamexemple suivant met à jour un flux existant. La version du stream est incrémentée d'une unité.

aws iot update-stream \
    --cli-input-json file://update-stream.json

Contenu de update-stream.json :

{
    "streamId": "stream12345",
    "description": "This stream is used for Amazon FreeRTOS OTA Update 12345.",
    "files": [
        {
            "fileId": 123,
            "s3Location": {
                "bucket":"codesign-ota-bucket",
                "key":"48c67f3c-63bb-4f92-a98a-4ee0fbc2bef6"
            }
        }
    ]
    "roleArn": "arn:aws:iam:us-west-2:123456789012:role/service-role/my_ota_stream_role"
}

Sortie :

{
    "streamId": "stream12345",
    "streamArn": "arn:aws:iot:us-west-2:123456789012:stream/stream12345",
    "description": "This stream is used for Amazon FreeRTOS OTA Update 12345.",
    "streamVersion": 2
}

Pour plus d'informations, consultez UpdateStreamle manuel de référence des API AWS IoT.

Pour mettre à jour la définition d'un groupe d'objets

L'update-thing-groupexemple suivant met à jour la définition du groupe d'objets spécifié, en modifiant la description et deux attributs.

aws iot update-thing-group \
    --thing-group-name HalogenBulbs \
    --thing-group-properties "thingGroupDescription=\"Halogen bulb group\", attributePayload={attributes={Manufacturer=AnyCompany,wattage=60}}"

Sortie :

{
    "version": 2
}

Pour plus d'informations, consultez la section Thing Groups dans le guide du développeur AWS IoT.

Pour modifier les groupes auxquels appartient un objet

L'update-thing-groups-for-thingexemple suivant supprime l'objet nommé MyLightBulb du groupe nommé DeadBulbs et l'ajoute replaceableItems au groupe nommé en même temps.

aws iot update-thing-groups-for-thing \
    --thing-name MyLightBulb \
    --thing-groups-to-add "replaceableItems" \
    --thing-groups-to-remove "DeadBulbs"

Cette commande ne produit aucun résultat.

Pour plus d'informations, consultez la section Groupes d'objets dans le Guide du développeur de l'AWS IoT.