D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# AWS IoT exemples utilisant AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with AWS IoT.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
**Topics**
+ [Actions](#actions)
## Actions
### `accept-certificate-transfer`
L'exemple de code suivant montre comment utiliser`accept-certificate-transfer`.
**AWS CLI**
**Pour accepter un certificat d'appareil transféré depuis un autre AWS compte**
L'`accept-certificate-transfer`exemple suivant accepte un certificat d'appareil transféré depuis un autre AWS compte. Le certificat est identifié par son ID.
```
aws iot accept-certificate-transfer \
--certificate-id 488b6a7f2acdeb00a77384e63c4e40b18bEXAMPLEe57b7272ba44c45e3448142
```
Cette commande ne génère pas de sortie.
Pour plus d’informations, consultez [Transférer un certificat vers un autre compte](https://docs.aws.amazon.com/iot/latest/developerguide/transfer-cert.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [AcceptCertificateTransfer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/accept-certificate-transfer.html)à la section *Référence des AWS CLI commandes*.
### `add-thing-to-billing-group`
L'exemple de code suivant montre comment utiliser`add-thing-to-billing-group`.
**AWS CLI**
**Exemple 1 : pour ajouter un objet par son nom à un groupe de facturation**
L’exemple `add-thing-to-billing-group` 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 aucune sortie.
**Exemple 2 : pour ajouter un objet par son ARN à un groupe de facturation**
L’exemple `add-thing-to-billing-group` 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 permet de garantir que vous l’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 aucune sortie.
Pour plus d’informations, consultez [Groupes de facturation](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [AddThingToBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/add-thing-to-billing-group.html)à la section *Référence des AWS CLI commandes*.
### `add-thing-to-thing-group`
L'exemple de code suivant montre comment utiliser`add-thing-to-thing-group`.
**AWS CLI**
**Pour ajouter un objet à un groupe**
L’exemple `add-thing-to-thing-group` 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 aucune sortie.
Pour plus d’informations, consultez [Groupes d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [AddThingToThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/add-thing-to-thing-group.html)à la section *Référence des AWS CLI commandes*.
### `associate-targets-with-job`
L'exemple de code suivant montre comment utiliser`associate-targets-with-job`.
**AWS CLI**
**Pour associer un groupe d’objets à une tâche continue**
L’exemple `associate-targets-with-job` 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 [Création et gestion de tâches (interface de ligne de commande)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [AssociateTargetsWithJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/associate-targets-with-job.html)à la section *Référence des AWS CLI commandes*.
### `attach-policy`
L'exemple de code suivant montre comment utiliser`attach-policy`.
**AWS CLI**
**Exemple 1 : pour attacher une stratégie à un groupe d’objets**
L’exemple `attach-policy` suivant attache la stratégie 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 [Groupes d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) dans le *Guide du développeur AWS IoT*.
**Exemple 2 : pour attacher une stratégie à un certificat**
L’exemple `attach-policy` suivant attache la stratégie `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, consultez la section [Attacher une politique AWS IoT à un certificat d'appareil](https://docs.aws.amazon.com/iot/latest/developerguide/attach-policy-to-certificate.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [AttachPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/attach-policy.html)à la section *Référence des AWS CLI commandes*.
### `attach-security-profile`
L'exemple de code suivant montre comment utiliser`attach-security-profile`.
**AWS CLI**
**Pour associer un profil de sécurité à tous les appareils non enregistrés**
L'`attach-security-profile`exemple 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 aucune sortie.
Pour plus d’informations, consultez [Commandes Detect](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [AttachSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/attach-security-profile.html)à la section *Référence des AWS CLI commandes*.
### `attach-thing-principal`
L'exemple de code suivant montre comment utiliser`attach-thing-principal`.
**AWS CLI**
**Pour attacher un certificat à votre objet**
L'`attach-thing-principal`exemple suivant attache un certificat à l' MyTemperatureSensor objet. Le certificat est identifié par un ARN. Vous pouvez trouver 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 aucune sortie.
Pour plus d’informations, consultez [Comment gérer des objets avec le registre](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [AttachThingPrincipal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/attach-thing-principal.html)à la section *Référence des AWS CLI commandes*.
### `cancel-audit-mitigation-actions-task`
L'exemple de code suivant montre comment utiliser`cancel-audit-mitigation-actions-task`.
**AWS CLI**
**Pour annuler une tâche d’actions d’atténuation d’audit**
L’exemple `cancel-audit-mitigations-action-task` suivant annule l’application d’actions 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 aucune sortie.
Pour plus d'informations, voir [CancelAuditMitigationActionsTask (Mitigation Action Commands)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-CancelAuditMitigationActionsTask) dans le *Guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CancelAuditMitigationActionsTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/cancel-audit-mitigation-actions-task.html)à la section *Référence des AWS CLI commandes*.
### `cancel-audit-task`
L'exemple de code suivant montre comment utiliser`cancel-audit-task`.
**AWS CLI**
**Pour annuler une tâche d’audit**
L’exemple `cancel-audit-task` 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 aucune sortie.
Pour plus d’informations, consultez [Commandes d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CancelAuditTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/cancel-audit-task.html)à la section *Référence des AWS CLI commandes*.
### `cancel-certificate-transfer`
L'exemple de code suivant montre comment utiliser`cancel-certificate-transfer`.
**AWS CLI**
**Pour annuler le transfert d'un certificat vers un autre AWS compte**
L’exemple `cancel-certificate-transfer` 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 aucune sortie.
Pour plus d’informations, consultez [Transférer un certificat vers un autre compte](https://docs.aws.amazon.com/iot/latest/developerguide/transfer-cert.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [CancelCertificateTransfer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/cancel-certificate-transfer.html)à la section *Référence des AWS CLI commandes*.
### `cancel-job-execution`
L'exemple de code suivant montre comment utiliser`cancel-job-execution`.
**AWS CLI**
**Pour annuler une exécution de tâche sur un appareil**
L’exemple `cancel-job-execution` suivant annule l’exécution de la tâche spécifiée sur un appareil. Si la tâche n’est pas à l’état `QUEUED`, vous devez ajouter le paramètre `--force`.
```
aws iot cancel-job-execution \
--job-id "example-job-03" \
--thing-name "MyRPi"
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Création et gestion de tâches (interface de ligne de commande)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CancelJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/cancel-job-execution.html)à la section *Référence des AWS CLI commandes*.
### `cancel-job`
L'exemple de code suivant montre comment utiliser`cancel-job`.
**AWS CLI**
**Pour annuler une tâche**
L’exemple `cancel-job` 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 [Création et gestion de tâches (interface de ligne de commande)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CancelJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/cancel-job.html)à la section *Référence des AWS CLI commandes*.
### `clear-default-authorizer`
L'exemple de code suivant montre comment utiliser`clear-default-authorizer`.
**AWS CLI**
**Pour effacer le mécanisme d’autorisation par défaut**
L’exemple `clear-default-authorizer` suivant efface le mécanisme d’autorisation personnalisé par défaut actuellement configuré. Une fois que vous avez exécuté cette commande, il n’existe aucun mécanisme d’autorisation par défaut. Lorsque vous utilisez un mécanisme d’autorisation 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 aucune sortie.
Pour plus d'informations, consultez [ClearDefaultAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_ClearDefaultAuthorizer.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ClearDefaultAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/clear-default-authorizer.html)à la section *Référence des AWS CLI commandes*.
### `confirm-topic-rule-destination`
L'exemple de code suivant montre comment utiliser`confirm-topic-rule-destination`.
**AWS CLI**
**Pour confirmer une destination de règle de rubrique**
L’exemple `confirm-topic-rule-destination` suivant confirme une destination de règle de rubrique à l’aide d’un jeton de confirmation reçu à 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 aucune sortie.
Pour plus d’informations, consultez [Confirmation d’une destination de règle de rubrique](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#confirm-destination) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ConfirmTopicRuleDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/confirm-topic-rule-destination.html)à la section *Référence des AWS CLI commandes*.
### `create-audit-suppression`
L'exemple de code suivant montre comment utiliser`create-audit-suppression`.
**AWS CLI**
**Pour créer une suppression de résultat d’audit**
L'`create-audit-suppression`exemple 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 aucune sortie.
Pour plus d’informations, consultez [Suppressions de résultat d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/audit-finding-suppressions.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateAuditSuppression](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-audit-suppression.html)à la section *Référence des AWS CLI commandes*.
### `create-authorizer`
L'exemple de code suivant montre comment utiliser`create-authorizer`.
**AWS CLI**
**Pour créer un mécanisme d’autorisation personnalisé**
L’exemple `create-authorizer` suivant crée un mécanisme 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 [CreateAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateAuthorizer.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-authorizer.html)à la section *Référence des AWS CLI commandes*.
### `create-billing-group`
L'exemple de code suivant montre comment utiliser`create-billing-group`.
**AWS CLI**
**Pour créer un groupe de facturation**
L’exemple `create-billing-group` 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 [Groupes de facturation](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-billing-group.html)à la section *Référence des AWS CLI commandes*.
### `create-certificate-from-csr`
L'exemple de code suivant montre comment utiliser`create-certificate-from-csr`.
**AWS CLI**
**Pour créer un certificat d’appareil à partir d’une demande de signature de certificat (CSR)**
L’exemple `create-certificate-from-csr` suivant crée un certificat d’appareil à partir d’une CSR. Vous pouvez créer une demande CSR à l’aide de la commande `openssl`.
```
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": ""
}
```
Pour plus d'informations, consultez la section [CreateCertificateFromCSR](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateCertificateFromCsr.html) dans le manuel de *référence des API AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateCertificateFromCsr](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-certificate-from-csr.html)à la section *Référence des AWS CLI commandes*.
### `create-custom-metric`
L'exemple de code suivant montre comment utiliser`create-custom-metric`.
**AWS CLI**
**Pour créer une métrique personnalisée publiée par vos appareils sur Device Defender**
L’exemple `create-custom-metric` 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 [Métriques personnalisées](https://docs.aws.amazon.com/iot/latest/developerguide/dd-detect-custom-metrics.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [CreateCustomMetric](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-custom-metric.html)à la section *Référence des AWS CLI commandes*.
### `create-dimension`
L'exemple de code suivant montre comment utiliser`create-dimension`.
**AWS CLI**
**Pour créer une dimension**
L’exemple `create-dimension` suivant crée une dimension avec un filtre de rubrique unique nommé `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 [Commandes Detect](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateDimension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-dimension.html)à la section *Référence des AWS CLI commandes*.
### `create-domain-configuration`
L'exemple de code suivant montre comment utiliser`create-domain-configuration`.
**AWS CLI**
**Pour créer une configuration de domaine**
L'`create-domain-configuration`exemple suivant crée une configuration de domaine AWS géré avec un type de service de`DATA`.
```
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 [Points de terminaison configurables](https://docs.aws.amazon.com/iot/latest/developerguide/iot-custom-endpoints-configurable-aws.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [CreateDomainConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-domain-configuration.html)à la section *Référence des AWS CLI commandes*.
### `create-dynamic-thing-group`
L'exemple de code suivant montre comment utiliser`create-dynamic-thing-group`.
**AWS CLI**
**Pour créer un groupe d’objets dynamique**
L’exemple `create-dynamic-thing-group` suivant crée un groupe d’objets dynamique qui comporte les objets 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 [Groupes d’objets dynamiques](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateDynamicThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-dynamic-thing-group.html)à la section *Référence des AWS CLI commandes*.
### `create-job`
L'exemple de code suivant montre comment utiliser`create-job`.
**AWS CLI**
**Exemple 1 : pour créer une tâche**
L'`create-job`exemple suivant crée une tâche AWS IoT simple qui envoie un document JSON à l'`MyRaspberryPi`appareil.
```
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’exemple `create-job` suivant crée une tâche qui continue de s’exécuter une fois que les objets 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, la tâche continue 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 [Création et gestion de tâches (interface de ligne de commande)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-job.html)à la section *Référence des AWS CLI commandes*.
### `create-keys-and-certificate`
L'exemple de code suivant montre comment utiliser`create-keys-and-certificate`.
**AWS CLI**
**Pour créer une paire de clés RSA et émettre un certificat X.509**
L’exemple `create-keys-and-certificate` suivant crée une paire de clés RSA 2 048 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 AWSAWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/device-certs-create.html) **dans le guide du développeur IoT**.
+ Pour plus de détails sur l'API, reportez-vous [CreateKeysAndCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-keys-and-certificate.html)à la section *Référence des AWS CLI commandes*.
### `create-mitigation-action`
L'exemple de code suivant montre comment utiliser`create-mitigation-action`.
**AWS CLI**
**Pour créer une action d’atténuation**
L’exemple `create-mitigation-action` suivant définit une action d’atténuation nommée `AddThingsToQuarantineGroup1Action` qui, lorsqu’elle est appliquée, déplace des objets vers 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)](https://docs.aws.amazon.com/iot/latest/developerguide/iot/latest/developerguide/iot/latest/developerguide/mitigation-action-commands.html.html#dd-api-iot-CreateMitigationAction) dans le *Guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateMitigationAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-mitigation-action.html)à la section *Référence des AWS CLI commandes*.
### `create-ota-update`
L'exemple de code suivant montre comment utiliser`create-ota-update`.
**AWS CLI**
**Pour créer une mise à jour OTA à utiliser avec Amazon FreeRTOS**
L'`create-ota-update`exemple 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](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateOTAUpdate.html) dans le guide de *référence des API AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateOtaUpdate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-ota-update.html)à la section *Référence des AWS CLI commandes*.
### `create-policy-version`
L'exemple de code suivant montre comment utiliser`create-policy-version`.
**AWS CLI**
**Pour mettre à jour une stratégie avec une nouvelle version**
L’exemple `create-policy-version` suivant met à jour une définition de stratégie en créant une 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 [Stratégies AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreatePolicyVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-policy-version.html)à la section *Référence des AWS CLI commandes*.
### `create-policy`
L'exemple de code suivant montre comment utiliser`create-policy`.
**AWS CLI**
**Pour créer une politique AWS IoT**
L'`create-policy`exemple 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 [Stratégies AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreatePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-policy.html)à la section *Référence des AWS CLI commandes*.
### `create-provisioning-claim`
L'exemple de code suivant montre comment utiliser`create-provisioning-claim`.
**AWS CLI**
**Pour créer une demande de mise en service**
L’exemple `create-provisioning-claim` suivant crée une demande de mise en service à partir d’un modèle de mise en service.
```
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 [Allocation par utilisateur approuvé](https://docs.aws.amazon.com/iot/latest/developerguide/provision-wo-cert.html#trusted-user) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [CreateProvisioningClaim](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-provisioning-claim.html)à la section *Référence des AWS CLI commandes*.
### `create-provisioning-template-version`
L'exemple de code suivant montre comment utiliser`create-provisioning-template-version`.
**AWS CLI**
**Pour créer une version de modèle de mise en service**
L’exemple suivant crée une version du modèle de mise en service spécifié. Le corps de la nouvelle version est fourni dans le fichier `template.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 [Tunneling sécuriséAWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [CreateProvisioningTemplateVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-provisioning-template-version.html)à la section *Référence des AWS CLI commandes*.
### `create-provisioning-template`
L'exemple de code suivant montre comment utiliser`create-provisioning-template`.
**AWS CLI**
**Pour créer un modèle de mise en service**
L’exemple `create-provisioning-template` suivant crée un modèle de mise en service tel que défini par le fichier `template.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 [Tunneling sécuriséAWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [CreateProvisioningTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-provisioning-template.html)à la section *Référence des AWS CLI commandes*.
### `create-role-alias`
L'exemple de code suivant montre comment utiliser`create-role-alias`.
**AWS CLI**
**Pour créer un alias de rôle**
L’exemple `create-role-alias` suivant crée un alias de rôle nommé `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 [CreateRoleAlias](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateRoleAlias.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateRoleAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-role-alias.html)à la section *Référence des AWS CLI commandes*.
### `create-scheduled-audit`
L'exemple de code suivant montre comment utiliser`create-scheduled-audit`.
**AWS CLI**
**Pour créer un audit planifié**
L’exemple `create-scheduled-audit` 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 [Commandes d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateScheduledAudit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-scheduled-audit.html)à la section *Référence des AWS CLI commandes*.
### `create-security-profile`
L'exemple de code suivant montre comment utiliser`create-security-profile`.
**AWS CLI**
**Pour créer un profil de sécurité**
L’exemple `create-security-profile` 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 5 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 [Commandes Detect](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-security-profile.html)à la section *Référence des AWS CLI commandes*.
### `create-stream`
L'exemple de code suivant montre comment utiliser`create-stream`.
**AWS CLI**
**Pour créer un flux pour diffuser un ou plusieurs fichiers volumineux sous forme de fragments via MQTT**
L’exemple `create-stream` suivant crée un flux pour diffuser un ou plusieurs fichiers volumineux sous forme de fragments 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 [CreateStream](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateStream.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-stream.html)à la section *Référence des AWS CLI commandes*.
### `create-thing-group`
L'exemple de code suivant montre comment utiliser`create-thing-group`.
**AWS CLI**
**Exemple 1 : pour créer un groupe d’objets**
L’exemple `create-thing-group` 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**
L’exemple `create-thing-group` suivant 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 [Groupes d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-thing-group.html)à la section *Référence des AWS CLI commandes*.
### `create-thing-type`
L'exemple de code suivant montre comment utiliser`create-thing-type`.
**AWS CLI**
**Pour définir un type d’objet**
L’exemple `create-thing-type` 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 [Types d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateThingType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-thing-type.html)à la section *Référence des AWS CLI commandes*.
### `create-thing`
L'exemple de code suivant montre comment utiliser`create-thing`.
**AWS CLI**
**Exemple 1 : pour créer un enregistrement d’objet dans le registre**
L'`create-thing`exemple 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’exemple `create-thing` 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 [Comment gérer des objets avec le registre](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html) et [Types d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-thing.html)à la section *Référence des AWS CLI commandes*.
### `create-topic-rule-destination`
L'exemple de code suivant montre comment utiliser`create-topic-rule-destination`.
**AWS CLI**
**Pour créer une destination de règle de rubrique**
L’exemple `create-topic-rule-destination` suivant crée une destination de règle de rubrique 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 [Création d’une destination de règle de rubrique](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#create-destination) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateTopicRuleDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-topic-rule-destination.html)à la section *Référence des AWS CLI commandes*.
### `create-topic-rule`
L'exemple de code suivant montre comment utiliser`create-topic-rule`.
**AWS CLI**
**Pour créer une règle qui envoie une alerte Amazon SNS**
L’exemple `create-topic-rule` 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 le cliché instantané 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 aucune sortie.
Pour plus d'informations, consultez [la section Création d'une règle AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-rule.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [CreateTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/create-topic-rule.html)à la section *Référence des AWS CLI commandes*.
### `delete-account-audit-configuration`
L'exemple de code suivant montre comment utiliser`delete-account-audit-configuration`.
**AWS CLI**
**Pour désactiver toutes les vérifications d'audit de votre AWS compte**
L'`delete-account-audit-configuration`exemple 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 aucune sortie.
Pour plus d’informations, consultez [Commandes d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteAccountAuditConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-account-audit-configuration.html)à la section *Référence des AWS CLI commandes*.
### `delete-audit-suppression`
L'exemple de code suivant montre comment utiliser`delete-audit-suppression`.
**AWS CLI**
**Pour supprimer une suppression de résultat d’audit**
L’exemple `delete-audit-suppression` suivant supprime une suppression de résultat d’audit pour DEVICE\$1CERTIFICATE\$1EXPIRING\$1CHECK.
```
aws iot delete-audit-suppression \
--check-name DEVICE_CERTIFICATE_EXPIRING_CHECK \
--resource-identifier deviceCertificateId="c7691e"
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Suppressions de résultat d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/audit-finding-suppressions.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteAuditSuppression](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-audit-suppression.html)à la section *Référence des AWS CLI commandes*.
### `delete-authorizer`
L'exemple de code suivant montre comment utiliser`delete-authorizer`.
**AWS CLI**
**Pour supprimer un mécanisme d’autorisation personnalisé**
L’exemple `delete-authorizer` suivant supprime le mécanisme d’autorisation nommé `CustomAuthorizer`. Un mécanisme d’autorisation personnalisé doit être à l’état `INACTIVE` avant que vous puissiez le supprimer.
```
aws iot delete-authorizer \
--authorizer-name CustomAuthorizer
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez [DeleteAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteAuthorizer.html)le *Guide du développeur de AWS l'IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-authorizer.html)à la section *Référence des AWS CLI commandes*.
### `delete-billing-group`
L'exemple de code suivant montre comment utiliser`delete-billing-group`.
**AWS CLI**
**Pour supprimer un groupe de facturation**
L’exemple `delete-billing-group` suivant supprime le groupe de facturation spécifié. Vous pouvez supprimer un groupe de facturation même s’il comporte un ou plusieurs objets.
```
aws iot delete-billing-group \
--billing-group-name BillingGroupTwo
```
Cette commande ne génère pas de sortie.
Pour plus d’informations, consultez [Groupes de facturation](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-billing-group.html)à la section *Référence des AWS CLI commandes*.
### `delete-ca-certificate`
L'exemple de code suivant montre comment utiliser`delete-ca-certificate`.
**AWS CLI**
**Pour supprimer un certificat CA**
L’exemple `delete-ca-certificate` suivant supprime le certificat CA avec l’ID de certificat spécifié.
```
aws iot delete-ca-certificate \
--certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, voir [Supprimer CACertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteCACertificate.html) dans le manuel de *référence des API AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteCaCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-ca-certificate.html)à la section *Référence des AWS CLI commandes*.
### `delete-certificate`
L'exemple de code suivant montre comment utiliser`delete-certificate`.
**AWS CLI**
**Pour supprimer un certificat d’appareil**
L’exemple `delete-certificate` suivant supprime le certificat d’appareil avec l’ID spécifié.
```
aws iot delete-certificate \
--certificate-id c0c57bbc8baaf4631a9a0345c957657f5e710473e3ddbee1428d216d54d53ac9
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez [DeleteCertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteCertificate.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-certificate.html)à la section *Référence des AWS CLI commandes*.
### `delete-custom-metric`
L'exemple de code suivant montre comment utiliser`delete-custom-metric`.
**AWS CLI**
**Pour supprimer une métrique personnalisée**
L’exemple `delete-custom-metric` 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 [Métriques personnalisées](https://docs.aws.amazon.com/iot/latest/developerguide/dd-detect-custom-metrics.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteCustomMetric](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-custom-metric.html)à la section *Référence des AWS CLI commandes*.
### `delete-dimension`
L'exemple de code suivant montre comment utiliser`delete-dimension`.
**AWS CLI**
**Pour supprimer une dimension**
L’exemple `delete-dimension` suivant supprime une dimension nommée `TopicFilterForAuthMessages`.
```
aws iot delete-dimension \
--name TopicFilterForAuthMessages
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Commandes Detect](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteDimension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-dimension.html)à la section *Référence des AWS CLI commandes*.
### `delete-domain-configuration`
L'exemple de code suivant montre comment utiliser`delete-domain-configuration`.
**AWS CLI**
**Pour supprimer une configuration de domaine**
L'`delete-domain-configuration`exemple 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 aucune sortie.
Pour plus d’informations, consultez [Points de terminaison configurables](https://docs.aws.amazon.com/iot/latest/developerguide/iot-custom-endpoints-configurable-aws.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteDomainConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-domain-configuration.html)à la section *Référence des AWS CLI commandes*.
### `delete-dynamic-thing-group`
L'exemple de code suivant montre comment utiliser`delete-dynamic-thing-group`.
**AWS CLI**
**Pour supprimer un groupe d’objets dynamique**
L’exemple `delete-dynamic-thing-group` suivant supprime le groupe d’objets dynamique spécifié.
```
aws iot delete-dynamic-thing-group \
--thing-group-name "RoomTooWarm"
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Groupes d’objets dynamiques](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteDynamicThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-dynamic-thing-group.html)à la section *Référence des AWS CLI commandes*.
### `delete-job-execution`
L'exemple de code suivant montre comment utiliser`delete-job-execution`.
**AWS CLI**
**Pour supprimer une exécution de tâche**
L’exemple `delete-job-execution` suivant supprime l’exécution de la tâche spécifiée sur un appareil. Utilisez `describe-job-execution` 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 aucune sortie.
Pour plus d’informations, consultez [Création et gestion de tâches (interface de ligne de commande)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-job-execution.html)à la section *Référence des AWS CLI commandes*.
### `delete-job`
L'exemple de code suivant montre comment utiliser`delete-job`.
**AWS CLI**
**Pour supprimer une tâche**
L’exemple `delete-job` suivant supprime la tâche spécifiée. En spécifiant l’option `--force`, la tâche est supprimée même si son statut est `IN_PROGRESS`.
```
aws iot delete-job \
--job-id "example-job-04" \
--force
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Création et gestion de tâches (interface de ligne de commande)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-job.html)à la section *Référence des AWS CLI commandes*.
### `delete-mitigation-action`
L'exemple de code suivant montre comment utiliser`delete-mitigation-action`.
**AWS CLI**
**Pour supprimer une action d’atténuation**
L’exemple `delete-mitigation-action` suivant supprime l’action d’atténuation spécifiée.
```
aws iot delete-mitigation-action \
--action-name AddThingsToQuarantineGroup1Action
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, voir [DeleteMitigationAction (Mitigation Action Commands)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-DeleteMitigationAction) dans le *Guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteMitigationAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-mitigation-action.html)à la section *Référence des AWS CLI commandes*.
### `delete-ota-update`
L'exemple de code suivant montre comment utiliser`delete-ota-update`.
**AWS CLI**
**Pour supprimer une mise à jour OTA**
L’exemple `delete-ota-update` 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 aucune sortie.
Pour plus d'informations, voir [Supprimer OTAUpdate](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteOTAUpdate.html) dans le manuel de *référence des API AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteOtaUpdate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-ota-update.html)à la section *Référence des AWS CLI commandes*.
### `delete-policy-version`
L'exemple de code suivant montre comment utiliser`delete-policy-version`.
**AWS CLI**
**Pour supprimer une version d’une politique**
L'`delete-policy-version`exemple 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 aucune sortie.
Pour plus d’informations, consultez [Stratégies AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeletePolicyVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-policy-version.html)à la section *Référence des AWS CLI commandes*.
### `delete-policy`
L'exemple de code suivant montre comment utiliser`delete-policy`.
**AWS CLI**
**Pour supprimer une politique**
L'`delete-policy`exemple suivant supprime la politique spécifiée de votre AWS compte.
```
aws iot delete-policy --policy-name UpdateDeviceCertPolicy
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Stratégies AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeletePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-policy.html)à la section *Référence des AWS CLI commandes*.
### `delete-provisioning-template-version`
L'exemple de code suivant montre comment utiliser`delete-provisioning-template-version`.
**AWS CLI**
**Pour supprimer une version de modèle de mise en service**
L’exemple `delete-provisioning-template-version` suivant supprime la version 2 du modèle de mise en service spécifié.
```
aws iot delete-provisioning-template-version \
--version-id 2 \
--template-name "widget-template"
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Tunneling sécuriséAWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteProvisioningTemplateVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-provisioning-template-version.html)à la section *Référence des AWS CLI commandes*.
### `delete-provisioning-template`
L'exemple de code suivant montre comment utiliser`delete-provisioning-template`.
**AWS CLI**
**Pour supprimer un modèle de mise en service**
L’exemple `delete-provisioning-template` suivant supprime le modèle de mise en service spécifié.
```
aws iot delete-provisioning-template \
--template-name widget-template
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Tunneling sécuriséAWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteProvisioningTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-provisioning-template.html)à la section *Référence des AWS CLI commandes*.
### `delete-registration-code`
L'exemple de code suivant montre comment utiliser`delete-registration-code`.
**AWS CLI**
**Pour supprimer votre code d’enregistrement**
L'`delete-registration-code`exemple suivant supprime un code d'enregistrement spécifique à un compte AWS IoT.
```
aws iot delete-registration-code
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Utiliser votre propre certificat](https://docs.aws.amazon.com/iot/latest/developerguide/device-certs-your-own.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteRegistrationCode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-registration-code.html)à la section *Référence des AWS CLI commandes*.
### `delete-role-alias`
L'exemple de code suivant montre comment utiliser`delete-role-alias`.
**AWS CLI**
**Pour supprimer un alias de rôle AWS IoT**
L'`delete-role-alias`exemple suivant supprime un alias de rôle AWS IoT nommé`LightBulbRole`.
```
aws iot delete-role-alias \
--role-alias LightBulbRole
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez la section [Autorisation des appels directs vers AWS des services](https://docs.aws.amazon.com/iot/latest/developerguide/authorizing-direct-aws.html) dans le *Guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteRoleAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-role-alias.html)à la section *Référence des AWS CLI commandes*.
### `delete-scheduled-audit`
L'exemple de code suivant montre comment utiliser`delete-scheduled-audit`.
**AWS CLI**
**Pour supprimer un audit planifié**
L'`delete-scheduled-audit`exemple suivant supprime l'audit planifié AWS IoT Device Defender nommé`AWSIoTDeviceDefenderDailyAudit`.
```
aws iot delete-scheduled-audit \
--scheduled-audit-name AWSIoTDeviceDefenderDailyAudit
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Commandes d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteScheduledAudit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-scheduled-audit.html)à la section *Référence des AWS CLI commandes*.
### `delete-security-profile`
L'exemple de code suivant montre comment utiliser`delete-security-profile`.
**AWS CLI**
**Pour supprimer un profil de sécurité**
L’exemple `delete-security-profile` suivant supprime un profil de sécurité nommé `PossibleIssue`.
```
aws iot delete-security-profile \
--security-profile-name PossibleIssue
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Commandes Detect](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-security-profile.html)à la section *Référence des AWS CLI commandes*.
### `delete-stream`
L'exemple de code suivant montre comment utiliser`delete-stream`.
**AWS CLI**
**Pour supprimer un flux**
L’exemple `delete-stream` suivant supprime le flux spécifié.
```
aws iot delete-stream \
--stream-id stream12345
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez [DeleteStream](https://docs.aws.amazon.com/iot/latest/apireference/API_DeleteStream.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-stream.html)à la section *Référence des AWS CLI commandes*.
### `delete-thing-group`
L'exemple de code suivant montre comment utiliser`delete-thing-group`.
**AWS CLI**
**Pour supprimer un groupe d’objets**
L’exemple `delete-thing-group` suivant supprime le groupe d’objets spécifié. Vous ne pouvez pas supprimer un groupe d’objets s’il comporte des groupes d’objets enfants.
```
aws iot delete-thing-group \
--thing-group-name DefectiveBulbs
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Groupes d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-thing-group.html)à la section *Référence des AWS CLI commandes*.
### `delete-thing-type`
L'exemple de code suivant montre comment utiliser`delete-thing-type`.
**AWS CLI**
**Exemple 1 : pour supprimer un type d’objet**
L’exemple `delete-thing-type` suivant supprime un type d’objet obsolète.
```
aws iot delete-thing-type \
--thing-type-name "obsoleteThingType"
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Types d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteThingType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-thing-type.html)à la section *Référence des AWS CLI commandes*.
### `delete-thing`
L'exemple de code suivant montre comment utiliser`delete-thing`.
**AWS CLI**
**Pour afficher des informations détaillées sur un objet**
L'`delete-thing`exemple suivant supprime un objet du registre AWS IoT de votre AWS compte.
aidez-moi à supprime-thing --thing-name « » FourthBulb
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Comment gérer des objets avec le registre](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-thing.html)à la section *Référence des AWS CLI commandes*.
### `delete-topic-rule-destination`
L'exemple de code suivant montre comment utiliser`delete-topic-rule-destination`.
**AWS CLI**
**Pour supprimer une destination de règle de rubrique**
L’exemple `delete-topic-rule-destination` suivant supprime la destination de 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 aucune sortie.
Pour plus d’informations, consultez [Suppression d’une destination de règle de rubrique](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#delete-destination) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteTopicRuleDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-topic-rule-destination.html)à la section *Référence des AWS CLI commandes*.
### `delete-topic-rule`
L'exemple de code suivant montre comment utiliser`delete-topic-rule`.
**AWS CLI**
**Pour supprimer une règle**
L’exemple `delete-topic-rule` suivant supprime la règle spécifiée.
```
aws iot delete-topic-rule \
--rule-name "LowMoistureRule"
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Suppression d’une règle](https://docs.aws.amazon.com/iot/latest/developerguide/iot-delete-rule.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-topic-rule.html)à la section *Référence des AWS CLI commandes*.
### `delete-v2-logging-level`
L'exemple de code suivant montre comment utiliser`delete-v2-logging-level`.
**AWS CLI**
**Pour supprimer le niveau de journalisation d’un groupe d’objets**
L’exemple `delete-v2-logging-level` suivant supprime le niveau de journalisation du groupe d’objets spécifié.
```
aws iot delete-v2-logging-level \
--target-type THING_GROUP \
--target-name LightBulbs
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, voir [DeleteV2 LoggingLevel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/delete-v2-logging-level.html) dans *AWS CLI Command* Reference.
### `deprecate-thing-type`
L'exemple de code suivant montre comment utiliser`deprecate-thing-type`.
**AWS CLI**
**Exemple 1 : pour rendre obsolète un type d’objet**
L’exemple `deprecate-thing-type` suivant rend obsolète un type d’objet afin que les utilisateurs ne puissent pas y associer de nouveaux objets.
```
aws iot deprecate-thing-type \
--thing-type-name "obsoleteThingType"
```
Cette commande ne produit aucune sortie.
**Exemple 2 : pour annuler l’obsolescence d’un type d’objet**
L’exemple `deprecate-thing-type` suivant annule l’obsolescence d’un type d’objet, ce qui permet aux utilisateurs d’y associer à nouveau de nouveaux objets.
```
aws iot deprecate-thing-type \
--thing-type-name "obsoleteThingType" \
--undo-deprecate
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Types d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeprecateThingType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/deprecate-thing-type.html)à la section *Référence des AWS CLI commandes*.
### `describe-account-audit-configuration`
L'exemple de code suivant montre comment utiliser`describe-account-audit-configuration`.
**AWS CLI**
**Pour consulter les paramètres actuels de configuration d’audit**
L'`describe-account-audit-configuration`exemple 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 [Commandes d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeAccountAuditConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-account-audit-configuration.html)à la section *Référence des AWS CLI commandes*.
### `describe-audit-finding`
L'exemple de code suivant montre comment utiliser`describe-audit-finding`.
**AWS CLI**
**Pour répertorier les détails d’un résultat d’audit**
L'`describe-audit-finding`exemple suivant répertorie les détails du résultat d'audit AWS IoT Device Defender spécifié. Un audit peut donner lieu à plusieurs résultats. Obtenez la liste des résultats d’un audit à l’aide de la commande `list-audit-findings` pour obtenir l’`findingId`.
```
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 [Check Audit Results (Audit Commands)](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html#device-defender-AuditCommandsFindings) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeAuditFinding](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-audit-finding.html)à la section *Référence des AWS CLI commandes*.
### `describe-audit-mitigation-actions-task`
L'exemple de code suivant montre comment utiliser`describe-audit-mitigation-actions-task`.
**AWS CLI**
**Pour afficher les détails d’une tâche d’actions d’atténuation d’audit**
L’exemple `describe-audit-mitigation-actions-task` suivant affiche les détails de la tâche spécifiée, lors de laquelle `ResetPolicyVersionAction` a été appliquée à 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)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-DescribeAuditMitigationActionsTask) dans le *Guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeAuditMitigationActionsTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-audit-mitigation-actions-task.html)à la section *Référence des AWS CLI commandes*.
### `describe-audit-suppression`
L'exemple de code suivant montre comment utiliser`describe-audit-suppression`.
**AWS CLI**
**Pour obtenir les détails sur une suppression de résultat d’audit**
L’exemple `describe-audit-suppression` suivant répertorie les détails sur une suppression de 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 [Suppressions de résultat d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/audit-finding-suppressions.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeAuditSuppression](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-audit-suppression.html)à la section *Référence des AWS CLI commandes*.
### `describe-audit-task`
L'exemple de code suivant montre comment utiliser`describe-audit-task`.
**AWS CLI**
**Pour obtenir les informations sur une instance d’audit**
L'`describe-audit-task`exemple 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 [Commandes d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeAuditTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-audit-task.html)à la section *Référence des AWS CLI commandes*.
### `describe-authorizer`
L'exemple de code suivant montre comment utiliser`describe-authorizer`.
**AWS CLI**
**Pour obtenir les informations sur un mécanisme d’autorisation personnalisé**
L’exemple `describe-authorizer` suivant affiche les détails du mécanisme d’autorisation 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 [DescribeAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeAuthorizer.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-authorizer.html)à la section *Référence des AWS CLI commandes*.
### `describe-billing-group`
L'exemple de code suivant montre comment utiliser`describe-billing-group`.
**AWS CLI**
**Pour obtenir les informations sur un groupe de facturation**
L’exemple `describe-billing-group` suivant obtient des informations sur 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 [Groupes de facturation](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-billing-group.html)à la section *Référence des AWS CLI commandes*.
### `describe-ca-certificate`
L'exemple de code suivant montre comment utiliser`describe-ca-certificate`.
**AWS CLI**
**Pour obtenir les détails d’un certificat CA**
L’exemple `describe-ca-certificate` 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](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeCACertificate.html) dans le manuel de *référence des API AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeCaCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-ca-certificate.html)à la section *Référence des AWS CLI commandes*.
### `describe-certificate`
L'exemple de code suivant montre comment utiliser`describe-certificate`.
**AWS CLI**
**Pour obtenir les informations sur un certificat**
L’exemple `describe-certificate` 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 [DescribeCertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeCertificate.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-certificate.html)à la section *Référence des AWS CLI commandes*.
### `describe-custom-metric`
L'exemple de code suivant montre comment utiliser`describe-custom-metric`.
**AWS CLI**
**Pour obtenir les informations sur une métrique personnalisée Device Defender**
L’exemple `describe-custom-metric` suivant obtient des informations sur une métrique personnalisée nommée `myCustomMetric`.
```
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 [Métriques personnalisées](https://docs.aws.amazon.com/iot/latest/developerguide/dd-detect-custom-metrics.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeCustomMetric](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-custom-metric.html)à la section *Référence des AWS CLI commandes*.
### `describe-default-authorizer`
L'exemple de code suivant montre comment utiliser`describe-default-authorizer`.
**AWS CLI**
**Pour obtenir les informations sur le mécanisme d’autorisation personnalisé par défaut**
L’exemple `describe-default-authorizer` suivant affiche les détails du mécanisme d’autorisation 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 [DescribeDefaultAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeDefautAuthorizer.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeDefaultAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-default-authorizer.html)à la section *Référence des AWS CLI commandes*.
### `describe-dimension`
L'exemple de code suivant montre comment utiliser`describe-dimension`.
**AWS CLI**
**Pour obtenir les informations sur une dimension**
L’exemple `describe-dimension` suivant obtient des informations sur une dimension nommée `TopicFilterForAuthMessages`.
```
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 [Commandes Detect](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeDimension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-dimension.html)à la section *Référence des AWS CLI commandes*.
### `describe-domain-configuration`
L'exemple de code suivant montre comment utiliser`describe-domain-configuration`.
**AWS CLI**
**Pour décrire une configuration de domaine**
L’exemple `describe-domain-configuration` suivant affiche les détails de la configuration de domaine spécifiée.
```
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 [Points de terminaison configurables](https://docs.aws.amazon.com/iot/latest/developerguide/iot-custom-endpoints-configurable-aws.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeDomainConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-domain-configuration.html)à la section *Référence des AWS CLI commandes*.
### `describe-endpoint`
L'exemple de code suivant montre comment utiliser`describe-endpoint`.
**AWS CLI**
**Exemple 1 : pour obtenir votre point de AWS terminaison actuel**
L'`describe-endpoint`exemple 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 [DescribeEndpoint](https://docs.aws.amazon.com/iot/latest/developerguide/iot-commands.html#api-iot-DescribeEndpoint)le *Guide du développeur de AWS l'IoT*.
**Exemple 2 : pour obtenir votre point de terminaison ATS**
L’exemple `describe-endpoint`suivant extrait 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](https://docs.aws.amazon.com/iot/latest/developerguide/managing-device-certs.html) dans le *Guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-endpoint.html)à la section *Référence des AWS CLI commandes*.
### `describe-event-configurations`
L'exemple de code suivant montre comment utiliser`describe-event-configurations`.
**AWS CLI**
**Pour afficher les types d’événements publiés**
L’exemple `describe-event-configurations` 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 [Messages d’événements](https://docs.aws.amazon.com/iot/latest/developerguide/iot-events.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeEventConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-event-configurations.html)à la section *Référence des AWS CLI commandes*.
### `describe-index`
L'exemple de code suivant montre comment utiliser`describe-index`.
**AWS CLI**
**Pour extraire le statut actuel de l’index des objets**
L’exemple `describe-index` suivant extrait 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 [Gestion de l’indexation d’objet](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-index.html)à la section *Référence des AWS CLI commandes*.
### `describe-job-execution`
L'exemple de code suivant montre comment utiliser`describe-job-execution`.
**AWS CLI**
**Pour obtenir les détails d’exécution d’une tâche sur un appareil**
L’exemple `describe-job-execution` suivant obtient 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 [Création et gestion de tâches (interface de ligne de commande)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeJobExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-job-execution.html)à la section *Référence des AWS CLI commandes*.
### `describe-job`
L'exemple de code suivant montre comment utiliser`describe-job`.
**AWS CLI**
**Pour obtenir le statut détaillé d’une tâche**
L’exemple `describe-job` suivant obtient le statut détaillé de la tâche dont l’ID est `example-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 [Création et gestion de tâches (interface de ligne de commande)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-job.html)à la section *Référence des AWS CLI commandes*.
### `describe-mitigation-action`
L'exemple de code suivant montre comment utiliser`describe-mitigation-action`.
**AWS CLI**
**Pour afficher les détails d’une action d’atténuation définie**
L’exemple `describe-mitigation-action` 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)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-DescribeMitigationAction) dans le *Guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeMitigationAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-mitigation-action.html)à la section *Référence des AWS CLI commandes*.
### `describe-provisioning-template-version`
L'exemple de code suivant montre comment utiliser`describe-provisioning-template-version`.
**AWS CLI**
**Pour décrire une version de modèle de mise en service**
L’exemple `describe-provisioning-template-version` suivant décrit une version de modèle d’allocation.
```
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 [Mise en service d’appareils qui ne disposent pas de certificats d’appareils à l’aide de la mise en service de flotte](https://docs.aws.amazon.com/iot/latest/developerguide/provision-wo-cert.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeProvisioningTemplateVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-provisioning-template-version.html)à la section *Référence des AWS CLI commandes*.
### `describe-provisioning-template`
L'exemple de code suivant montre comment utiliser`describe-provisioning-template`.
**AWS CLI**
**Pour décrire un modèle de mise en service**
L’exemple `describe-provisioning-template` suivant décrit un modèle d’allocation.
```
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 [Mise en service d’appareils qui ne disposent pas de certificats d’appareils à l’aide de la mise en service de flotte](https://docs.aws.amazon.com/iot/latest/developerguide/provision-wo-cert.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeProvisioningTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-provisioning-template.html)à la section *Référence des AWS CLI commandes*.
### `describe-role-alias`
L'exemple de code suivant montre comment utiliser`describe-role-alias`.
**AWS CLI**
**Pour obtenir des informations sur un alias de rôle AWS IoT**
L’exemple `describe-role-alias` 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 [DescribeRoleAlias](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeRoleAlias.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeRoleAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-role-alias.html)à la section *Référence des AWS CLI commandes*.
### `describe-scheduled-audit`
L'exemple de code suivant montre comment utiliser`describe-scheduled-audit`.
**AWS CLI**
**Pour obtenir les informations sur un audit planifié**
L'`describe-scheduled-audit`exemple suivant fournit des informations détaillées sur un audit planifié 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 [Commandes d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeScheduledAudit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-scheduled-audit.html)à la section *Référence des AWS CLI commandes*.
### `describe-security-profile`
L'exemple de code suivant montre comment utiliser`describe-security-profile`.
**AWS CLI**
**Pour obtenir les informations sur un profil de sécurité**
L'`describe-security-profile`exemple 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 [Commandes Detect](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-security-profile.html)à la section *Référence des AWS CLI commandes*.
### `describe-stream`
L'exemple de code suivant montre comment utiliser`describe-stream`.
**AWS CLI**
**Pour obtenir les informations sur un flux**
L’exemple `describe-stream` suivant affiche les détails du 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 [DescribeStream](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeStream.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-stream.html)à la section *Référence des AWS CLI commandes*.
### `describe-thing-group`
L'exemple de code suivant montre comment utiliser`describe-thing-group`.
**AWS CLI**
**Pour obtenir des informations sur un groupe d’objets**
L’exemple `describe-thing-group` suivant obtient 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 [Groupes d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-thing-group.html)à la section *Référence des AWS CLI commandes*.
### `describe-thing-type`
L'exemple de code suivant montre comment utiliser`describe-thing-type`.
**AWS CLI**
**Pour obtenir des informations sur un type d’objet**
L'`describe-thing-type`exemple 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 [Types d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeThingType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-thing-type.html)à la section *Référence des AWS CLI commandes*.
### `describe-thing`
L'exemple de code suivant montre comment utiliser`describe-thing`.
**AWS CLI**
**Pour afficher des informations détaillées sur un objet**
L'`describe-thing`exemple 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 [Comment gérer des objets avec le registre](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-thing.html)à la section *Référence des AWS CLI commandes*.
### `detach-policy`
L'exemple de code suivant montre comment utiliser`detach-policy`.
**AWS CLI**
**Exemple 1 : pour détacher une politique AWS IoT d'un groupe d'objets**
L’exemple `detach-policy` suivant détache la stratégie spécifiée d’un groupe d’objets et, par extension, de tous les objets 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 aucune sortie.
Pour plus d’informations, consultez [Groupes d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) dans le *Guide du développeur AWS IoT*.
**Exemple 2 : pour détacher une politique AWS IoT d'un certificat d'appareil**
L'`detach-policy`exemple 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 aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [DetachPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/detach-policy.html)à la section *Référence des AWS CLI commandes*.
### `detach-security-profile`
L'exemple de code suivant montre comment utiliser`detach-security-profile`.
**AWS CLI**
**Pour dissocier un profil de sécurité d’une cible**
L'`detach-security-profile`exemple 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 aucune sortie.
Pour plus d’informations, consultez [Commandes Detect](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DetachSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/detach-security-profile.html)à la section *Référence des AWS CLI commandes*.
### `detach-thing-principal`
L'exemple de code suivant montre comment utiliser`detach-thing-principal`.
**AWS CLI**
**Pour détacher une chose certificate/principal d'une chose**
L’exemple `detach-thing-principal` suivant supprime un certificat qui représente un principal 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 aucune sortie.
Pour plus d’informations, consultez [Comment gérer des objets avec le registre](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DetachThingPrincipal](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/detach-thing-principal.html)à la section *Référence des AWS CLI commandes*.
### `disable-topic-rule`
L'exemple de code suivant montre comment utiliser`disable-topic-rule`.
**AWS CLI**
**Pour désactiver une règle de rubrique**
L’exemple `disable-topic-rule` suivant désactive la règle de rubrique spécifiée.
```
aws iot disable-topic-rule \
--rule-name "MyPlantPiMoistureAlertRule"
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Affichage des règles](https://docs.aws.amazon.com/iot/latest/developerguide/iot-view-rules.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DisableTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/disable-topic-rule.html)à la section *Référence des AWS CLI commandes*.
### `enable-topic-rule`
L'exemple de code suivant montre comment utiliser`enable-topic-rule`.
**AWS CLI**
**Pour activer une règle de rubrique**
L’exemple `enable-topic-rule` 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 aucune sortie.
Pour plus d’informations, consultez [Affichage des règles](https://docs.aws.amazon.com/iot/latest/developerguide/iot-view-rules.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [EnableTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/enable-topic-rule.html)à la section *Référence des AWS CLI commandes*.
### `get-behavior-model-training-summaries`
L'exemple de code suivant montre comment utiliser`get-behavior-model-training-summaries`.
**AWS CLI**
**Pour répertorier le statut du modèle d’entraînement d’un profil de sécurité ML Detect de Device Defender**
L’exemple `get-behavior-model-training-summaries` suivant répertorie le statut d’entraînement des modèles 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 recueillis 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)](https://docs.aws.amazon.com/iot/latest/developerguide/detect-commands.html) dans le *Guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [GetBehaviorModelTrainingSummaries](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-behavior-model-training-summaries.html)à la section *Référence des AWS CLI commandes*.
### `get-cardinality`
L'exemple de code suivant montre comment utiliser`get-cardinality`.
**AWS CLI**
**Pour renvoyer le nombre approximatif de valeurs uniques qui correspondent à la requête**
Vous pouvez créer 10 objets représentant 10 capteurs de température à l’aide du script de configuration suivant. Chaque nouvel objet possède trois 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’exemple `get-cardinality` 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 à l’é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 plus de détails sur l'API, reportez-vous [GetCardinality](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-cardinality.html)à la section *Référence des AWS CLI commandes*.
### `get-effective-policies`
L'exemple de code suivant montre comment utiliser`get-effective-policies`.
**AWS CLI**
**Pour répertorier les stratégies qui affectent un objet**
L’exemple `get-effective-policies` suivant répertorie les stratégies qui affectent l’objet spécifié, y compris les stratégies 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 [Obtention de stratégies efficaces pour un objet](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html#group-get-effective-policies) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [GetEffectivePolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-effective-policies.html)à la section *Référence des AWS CLI commandes*.
### `get-indexing-configuration`
L'exemple de code suivant montre comment utiliser`get-indexing-configuration`.
**AWS CLI**
**Pour obtenir la configuration de l’indexation des objets**
L'`get-indexing-configuration`exemple 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 [Gestion de l’indexation d’objet](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [GetIndexingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-indexing-configuration.html)à la section *Référence des AWS CLI commandes*.
### `get-job-document`
L'exemple de code suivant montre comment utiliser`get-job-document`.
**AWS CLI**
**Pour extraire le document correspondant à une tâche**
L’exemple `get-job-document` suivant affiche les détails du document correspondant à la tâche dont l’ID est `example-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 [Création et gestion de tâches (interface de ligne de commande)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [GetJobDocument](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-job-document.html)à la section *Référence des AWS CLI commandes*.
### `get-logging-options`
L'exemple de code suivant montre comment utiliser`get-logging-options`.
**AWS CLI**
**Pour obtenir les options de journalisation**
L'`get-logging-options`exemple 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, consultez le titre dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [GetLoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-logging-options.html)à la section *Référence des AWS CLI commandes*.
### `get-ota-update`
L'exemple de code suivant montre comment utiliser`get-ota-update`.
**AWS CLI**
**Pour extraire des informations sur une mise à jour OTA**
L’exemple `get-ota-update` 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](https://docs.aws.amazon.com/iot/latest/apireference/API_GetOTAUpdate.html) in the AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [GetOtaUpdate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-ota-update.html)à la section *Référence des AWS CLI commandes*.
### `get-percentiles`
L'exemple de code suivant montre comment utiliser`get-percentiles`.
**AWS CLI**
**Pour regrouper les valeurs agrégées qui correspondent à la requête en groupes de centiles**
Vous pouvez créer 10 objets représentant 10 capteurs de température à l’aide du script de configuration suivant. 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’exemple `get-percentiles` suivant interroge les 10 capteurs créés par le script de configuration et renvoie une valeur pour chaque groupe de centiles spécifié. Le groupe de centiles « 10 » comporte la valeur de champ agrégée qui se produit dans environ 10 % des valeurs qui correspondent à la requête. Dans la sortie suivante, \$1"percent": 10.0, "value": 67.7\$1 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 [Interrogation des données agrégées](https://docs.aws.amazon.com/iot/latest/developerguide/index-aggregate.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [GetPercentiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-percentiles.html)à la section *Référence des AWS CLI commandes*.
### `get-policy-version`
L'exemple de code suivant montre comment utiliser`get-policy-version`.
**AWS CLI**
**Pour obtenir des informations sur une version spécifique d’une stratégie**
L’exemple `get-policy-version` suivant permet d’obtenir des informations sur la première version de la stratégie 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 [Stratégies AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [GetPolicyVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-policy-version.html)à la section *Référence des AWS CLI commandes*.
### `get-policy`
L'exemple de code suivant montre comment utiliser`get-policy`.
**AWS CLI**
**Pour obtenir des informations sur la version par défaut d’une stratégie**
L’exemple `get-policy` suivant extrait des informations sur la version par défaut de la stratégie 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 [Stratégies AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [GetPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-policy.html)à la section *Référence des AWS CLI commandes*.
### `get-registration-code`
L'exemple de code suivant montre comment utiliser`get-registration-code`.
**AWS CLI**
**Pour obtenir le code d'enregistrement AWS spécifique à votre compte**
L'`get-registration-code`exemple 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 [Utiliser votre propre certificat](https://docs.aws.amazon.com/iot/latest/developerguide/device-certs-your-own.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [GetRegistrationCode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-registration-code.html)à la section *Référence des AWS CLI commandes*.
### `get-statistics`
L'exemple de code suivant montre comment utiliser`get-statistics`.
**AWS CLI**
**Pour rechercher des données agrégées dans l’index des appareils**
L’exemple `get-statistics` suivant renvoie le nombre d’objets dotés d’une propriété nommée `connectivity.connected` définie sur `false` (à savoir le nombre d’appareils non connectés) dans leur cliché instantané d’appareil.
```
aws iot get-statistics \
--index-name AWS_Things \
--query-string "connectivity.connected:false"
```
Sortie :
```
{
"statistics": {
"count": 6
}
}
```
Pour plus d’informations, consultez [Obtention des statistiques sur votre flotte d’appareils](https://docs.aws.amazon.com/iot/latest/developerguide/index-aggregate.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [GetStatistics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-statistics.html)à la section *Référence des AWS CLI commandes*.
### `get-topic-rule-destination`
L'exemple de code suivant montre comment utiliser`get-topic-rule-destination`.
**AWS CLI**
**Pour obtenir une destination de règle de rubrique**
L’exemple `get-topic-rule-destination` suivant obtient des informations sur une destination de règle de rubrique.
```
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 [Utilisation des destinations des règles de rubrique](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [GetTopicRuleDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-topic-rule-destination.html)à la section *Référence des AWS CLI commandes*.
### `get-topic-rule`
L'exemple de code suivant montre comment utiliser`get-topic-rule`.
**AWS CLI**
**Pour obtenir les informations sur une règle**
L’exemple `get-topic-rule` suivant affiche les 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 [Affichage des règles](https://docs.aws.amazon.com/iot/latest/developerguide/iot-managae-rule.html#iot-view-rules) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [GetTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-topic-rule.html)à la section *Référence des AWS CLI commandes*.
### `get-v2-logging-options`
L'exemple de code suivant montre comment utiliser`get-v2-logging-options`.
**AWS CLI**
**Pour répertorier les options de journalisation actuelles**
L'`get-v2-logging-options`exemple 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, consultez le titre dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, consultez [GetV2 LoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/get-v2-logging-options.html) dans *AWS CLI Command Reference*.
### `list-active-violations`
L'exemple de code suivant montre comment utiliser`list-active-violations`.
**AWS CLI**
**Pour répertorier les violations actives**
L’exemple `list-active-violations` 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
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListActiveViolations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-active-violations.html)à la section *Référence des AWS CLI commandes*.
### `list-attached-policies`
L'exemple de code suivant montre comment utiliser`list-attached-policies`.
**AWS CLI**
**Exemple 1 : pour répertorier les stratégies attachées à un groupe**
L’exemple `list-attached-policies` suivant répertorie les stratégies attaché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 [Groupes d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) dans le *Guide du développeur AWS IoT*.
**Exemple 2 : pour répertorier les stratégies attachées à un certificat d’appareil**
L'`list-attached-policies`exemple 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 [Groupes d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListAttachedPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-attached-policies.html)à la section *Référence des AWS CLI commandes*.
### `list-audit-findings`
L'exemple de code suivant montre comment utiliser`list-audit-findings`.
**AWS CLI**
**Exemple 1 : pour répertorier tous les résultats d’un audit**
L'`list-audit-findings`exemple 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 vérification d’audit**
L'`list-audit-findings`exemple 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 le nom d’une vérification, vous devez indiquer une heure de début et une heure 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 [Commandes d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListAuditFindings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-audit-findings.html)à la section *Référence des AWS CLI commandes*.
### `list-audit-mitigation-actions-executions`
L'exemple de code suivant montre comment utiliser`list-audit-mitigation-actions-executions`.
**AWS CLI**
**Pour répertorier les détails de l’exécution d’une action d’atténuation d’audit**
Une tâche d'atténuation d'audit applique une action d'atténuation à un ou plusieurs résultats d'un audit AWS IoT Device Defender. L’exemple `list-audit-mitigation-actions-executions` suivant répertorie les détails de la tâche d’action d’atténuation avec l’`taskId` spécifié 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)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-ListAuditMitigationActionsExecutions) dans le *Guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListAuditMitigationActionsExecutions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-audit-mitigation-actions-executions.html)à la section *Référence des AWS CLI commandes*.
### `list-audit-mitigation-actions-tasks`
L'exemple de code suivant montre comment utiliser`list-audit-mitigation-actions-tasks`.
**AWS CLI**
**Pour répertorier les tâches d’action d’atténuation d’audit**
L’exemple `list-audit-mitigation-actions-tasks` suivant répertorie les actions d’atténuation 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)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-ListAuditMitigationActionsTasks) dans le *Guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListAuditMitigationActionsTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-audit-mitigation-actions-tasks.html)à la section *Référence des AWS CLI commandes*.
### `list-audit-suppressions`
L'exemple de code suivant montre comment utiliser`list-audit-suppressions`.
**AWS CLI**
**Pour répertorier toutes les suppressions de résultats d’audit**
L’exemple `list-audit-suppressions` 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"
},
"expirationDate": 1597881600.0,
"suppressIndefinitely": false
}
]
}
```
Pour plus d’informations, consultez [Suppressions de résultat d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/audit-finding-suppressions.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListAuditSuppressions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-audit-suppressions.html)à la section *Référence des AWS CLI commandes*.
### `list-audit-tasks`
L'exemple de code suivant montre comment utiliser`list-audit-tasks`.
**AWS CLI**
**Pour répertorier tous les résultats d’un audit**
L’exemple `list-audit-tasks` suivant répertorie les tâches d’audit exécutées entre le 5 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 [Commandes d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListAuditTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-audit-tasks.html)à la section *Référence des AWS CLI commandes*.
### `list-authorizers`
L'exemple de code suivant montre comment utiliser`list-authorizers`.
**AWS CLI**
**Pour répertorier votre mécanisme d’autorisation personnalisé**
L'`list-authorizers`exemple 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 [ListAuthorizers](https://docs.aws.amazon.com/iot/latest/apireference/API_ListAuthorizers.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListAuthorizers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-authorizers.html)à la section *Référence des AWS CLI commandes*.
### `list-billing-groups`
L'exemple de code suivant montre comment utiliser`list-billing-groups`.
**AWS CLI**
**Pour répertorier les groupes de facturation pour votre AWS compte et votre région**
L'`list-billing-groups`exemple 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 [Groupes de facturation](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListBillingGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-billing-groups.html)à la section *Référence des AWS CLI commandes*.
### `list-ca-certificates`
L'exemple de code suivant montre comment utiliser`list-ca-certificates`.
**AWS CLI**
**Pour répertorier les certificats CA enregistrés dans votre AWS compte**
L'`list-ca-certificates`exemple 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 [Utiliser votre propre certificat](https://docs.aws.amazon.com/iot/latest/developerguide/device-certs-your-own.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListCaCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-ca-certificates.html)à la section *Référence des AWS CLI commandes*.
### `list-certificates-by-ca`
L'exemple de code suivant montre comment utiliser`list-certificates-by-ca`.
**AWS CLI**
**Pour répertorier tous les certificats d’appareil signés avec un certificat CA**
L'`list-certificates-by-ca`exemple 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](https://docs.aws.amazon.com/iot/latest/apireference/API_ListCertificatesByCA.html) dans le manuel de *référence des API AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListCertificatesByCa](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-certificates-by-ca.html)à la section *Référence des AWS CLI commandes*.
### `list-certificates`
L'exemple de code suivant montre comment utiliser`list-certificates`.
**AWS CLI**
**Exemple 1 : Pour répertorier les certificats enregistrés dans votre AWS compte**
L’exemple `list-certificates` 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 réponse `nextMarker` de cette commande et la fournir à la commande suivante pour obtenir le prochain lot de résultats. Répétez l’opération jusqu’à ce que `nextMarker` ne renvoie aucune 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 plus de détails sur l'API, reportez-vous [ListCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-certificates.html)à la section *Référence des AWS CLI commandes*.
### `list-custom-metrics`
L'exemple de code suivant montre comment utiliser`list-custom-metrics`.
**AWS CLI**
**Pour répertorier vos métriques personnalisées**
L’exemple `list-custom-metrics` suivant répertorie toutes vos métriques personnalisées.
```
aws iot list-custom-metrics \
--region us-east-1
```
Sortie :
```
{
"metricNames": [
"batteryPercentage"
]
}
```
Pour plus d’informations, consultez [Métriques personnalisées](https://docs.aws.amazon.com/iot/latest/developerguide/dd-detect-custom-metrics.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [ListCustomMetrics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-custom-metrics.html)à la section *Référence des AWS CLI commandes*.
### `list-dimensions`
L'exemple de code suivant montre comment utiliser`list-dimensions`.
**AWS CLI**
**Pour répertorier les dimensions de votre AWS compte**
L'`list-dimensions`exemple 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 [Commandes Detect](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListDimensions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-dimensions.html)à la section *Référence des AWS CLI commandes*.
### `list-domain-configurations`
L'exemple de code suivant montre comment utiliser`list-domain-configurations`.
**AWS CLI**
**Pour répertorier les configurations de domaine**
L'`list-domain-configurations`exemple 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 [Points de terminaison configurables](https://docs.aws.amazon.com/iot/latest/developerguide/iot-custom-endpoints-configurable-aws.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [ListDomainConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-domain-configurations.html)à la section *Référence des AWS CLI commandes*.
### `list-indices`
L'exemple de code suivant montre comment utiliser`list-indices`.
**AWS CLI**
**Pour répertorier les index de recherche configurés**
L'`list-indices`exemple 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 [Gestion de l’indexation d’objet](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListIndices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-indices.html)à la section *Référence des AWS CLI commandes*.
### `list-job-executions-for-job`
L'exemple de code suivant montre comment utiliser`list-job-executions-for-job`.
**AWS CLI**
**Pour répertorier les offres d'emploi de votre AWS compte**
L'`list-job-executions-for-job`exemple 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 [Création et gestion de tâches (interface de ligne de commande)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListJobExecutionsForJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-job-executions-for-job.html)à la section *Référence des AWS CLI commandes*.
### `list-job-executions-for-thing`
L'exemple de code suivant montre comment utiliser`list-job-executions-for-thing`.
**AWS CLI**
**Pour répertorier les tâches exécutées pour un objet**
L’exemple `list-job-executions-for-thing` 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 [Création et gestion de tâches (interface de ligne de commande)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListJobExecutionsForThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-job-executions-for-thing.html)à la section *Référence des AWS CLI commandes*.
### `list-jobs`
L'exemple de code suivant montre comment utiliser`list-jobs`.
**AWS CLI**
**Pour répertorier les offres d'emploi de votre AWS compte**
L'`list-jobs`exemple 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 [Création et gestion de tâches (interface de ligne de commande)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-jobs.html)à la section *Référence des AWS CLI commandes*.
### `list-mitigation-actions`
L'exemple de code suivant montre comment utiliser`list-mitigation-actions`.
**AWS CLI**
**Pour répertorier toutes les actions d’atténuation définies**
L'`list-mitigation-actions`exemple 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)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-ListMitigationActions) dans le *Guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListMitigationActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-mitigation-actions.html)à la section *Référence des AWS CLI commandes*.
### `list-mitigations-actions`
L'exemple de code suivant montre comment utiliser`list-mitigations-actions`.
**AWS CLI**
**Pour répertorier toutes les actions d’atténuation définies**
L'`list-mitigations-actions`exemple 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)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-ListMitigationActions) dans le *Guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListMitigationsActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-mitigations-actions.html)à la section *Référence des AWS CLI commandes*.
### `list-ota-updates`
L'exemple de code suivant montre comment utiliser`list-ota-updates`.
**AWS CLI**
**Pour répertorier les mises à jour OTA pour le compte**
L’exemple `list-ota-updates` 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](https://docs.aws.amazon.com/iot/latest/apireference/API_ListOTAUpdates.html) dans le guide de *référence des API AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListOtaUpdates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-ota-updates.html)à la section *Référence des AWS CLI commandes*.
### `list-outgoing-certificates`
L'exemple de code suivant montre comment utiliser`list-outgoing-certificates`.
**AWS CLI**
**Pour répertorier les certificats transférés vers un autre AWS compte**
L'`list-outgoing-certificates`exemple 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 [ListOutgoingCertificates](https://docs.aws.amazon.com/iot/latest/apireference/API_ListOutgoingCertificates.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListOutgoingCertificates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-outgoing-certificates.html)à la section *Référence des AWS CLI commandes*.
### `list-policies`
L'exemple de code suivant montre comment utiliser`list-policies`.
**AWS CLI**
**Pour répertorier les politiques définies dans votre AWS compte**
L'`list-policies`exemple 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 [Stratégies AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListPolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-policies.html)à la section *Référence des AWS CLI commandes*.
### `list-policy-versions`
L'exemple de code suivant montre comment utiliser`list-policy-versions`.
**AWS CLI**
**Exemple 1 : pour afficher toutes les versions d’une stratégie**
L’exemple `list-policy-versions` suivant répertorie toutes les versions de la stratégie spécifiée et leur date 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 [Stratégies AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListPolicyVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-policy-versions.html)à la section *Référence des AWS CLI commandes*.
### `list-principal-things`
L'exemple de code suivant montre comment utiliser`list-principal-things`.
**AWS CLI**
**Pour répertorier les objets attachés à un principal**
L’exemple `list-principal-things` suivant répertorie les objets 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 [ListPrincipalThings](https://docs.aws.amazon.com/iot/latest/apireference/API_ListPrincipleThings.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListPrincipalThings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-things.html)à la section *Référence des AWS CLI commandes*.
### `list-provisioning-template-versions`
L'exemple de code suivant montre comment utiliser`list-provisioning-template-versions`.
**AWS CLI**
**Pour répertorier les versions du modèle de mise en service**
L’exemple `list-provisioning-template-versions` suivant répertorie les versions disponibles du modèle d’allocation 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 [Tunneling sécuriséAWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [ListProvisioningTemplateVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-provisioning-template-versions.html)à la section *Référence des AWS CLI commandes*.
### `list-provisioning-templates`
L'exemple de code suivant montre comment utiliser`list-provisioning-templates`.
**AWS CLI**
**Pour répertorier les modèles de mise en service**
L'`list-provisioning-templates`exemple suivant répertorie tous les modèles d'approvisionnement 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 [Tunneling sécuriséAWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [ListProvisioningTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-provisioning-templates.html)à la section *Référence des AWS CLI commandes*.
### `list-role-aliases`
L'exemple de code suivant montre comment utiliser`list-role-aliases`.
**AWS CLI**
**Pour répertorier les alias de rôle AWS IoT de votre compte AWS **
L'`list-role-aliases`exemple 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 [ListRoleAliases](https://docs.aws.amazon.com/iot/latest/apireference/API_ListRoleAliases.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListRoleAliases](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-role-aliases.html)à la section *Référence des AWS CLI commandes*.
### `list-scheduled-audits`
L'exemple de code suivant montre comment utiliser`list-scheduled-audits`.
**AWS CLI**
**Pour répertorier les audits planifiés pour votre AWS compte**
L'`list-scheduled-audits`exemple 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 [Commandes d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListScheduledAudits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-scheduled-audits.html)à la section *Référence des AWS CLI commandes*.
### `list-security-profiles-for-target`
L'exemple de code suivant montre comment utiliser`list-security-profiles-for-target`.
**AWS CLI**
**Pour répertorier les profils de sécurité attachés à une cible**
L'`list-security-profiles-for-target`exemple 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 [Commandes Detect](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListSecurityProfilesForTarget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-security-profiles-for-target.html)à la section *Référence des AWS CLI commandes*.
### `list-security-profiles`
L'exemple de code suivant montre comment utiliser`list-security-profiles`.
**AWS CLI**
**Pour répertorier les profils de sécurité de votre AWS compte**
L'`list-security-profiles`exemple 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 [Commandes Detect](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListSecurityProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-security-profiles.html)à la section *Référence des AWS CLI commandes*.
### `list-streams`
L'exemple de code suivant montre comment utiliser`list-streams`.
**AWS CLI**
**Pour répertorier les flux du compte**
L'`list-streams`exemple 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 [ListStreams](https://docs.aws.amazon.com/iot/latest/apireference/API_ListStreams.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-streams.html)à la section *Référence des AWS CLI commandes*.
### `list-tags-for-resource`
L'exemple de code suivant montre comment utiliser`list-tags-for-resource`.
**AWS CLI**
**Pour afficher les balises et leurs valeurs associées à une ressource**
L’exemple `list-tags-for-resource` suivant affiche les balises et les valeurs associées au groupe d’objets `LightBulbs`.
```
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](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html) dans le *guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-tags-for-resource.html)à la section *Référence des AWS CLI commandes*.
### `list-targets-for-policy`
L'exemple de code suivant montre comment utiliser`list-targets-for-policy`.
**AWS CLI**
**Pour répertorier les principes associés à une politique AWS IoT**
L’exemple `list-targets-for-policy` suivant répertorie les certificats d’appareil auxquels la stratégie 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 [Groupes d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListTargetsForPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-targets-for-policy.html)à la section *Référence des AWS CLI commandes*.
### `list-targets-for-security-profile`
L'exemple de code suivant montre comment utiliser`list-targets-for-security-profile`.
**AWS CLI**
**Pour répertorier les cibles auxquelles un profil de sécurité est appliqué**
L'`list-targets-for-security-profile`exemple 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 [Commandes Detect](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListTargetsForSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-targets-for-security-profile.html)à la section *Référence des AWS CLI commandes*.
### `list-thing-groups-for-thing`
L'exemple de code suivant montre comment utiliser`list-thing-groups-for-thing`.
**AWS CLI**
**Pour répertorier les groupes auxquels un objet appartient**
L’exemple `list-thing-groups-for-thing` suivant répertorie les groupes auxquels l’objet spécifié appartient.
```
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 [Groupes d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListThingGroupsForThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-groups-for-thing.html)à la section *Référence des AWS CLI commandes*.
### `list-thing-groups`
L'exemple de code suivant montre comment utiliser`list-thing-groups`.
**AWS CLI**
**Pour répertorier les groupes d'objets définis dans votre AWS compte**
L'`describe-thing-group`exemple 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 [Groupes d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListThingGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-groups.html)à la section *Référence des AWS CLI commandes*.
### `list-thing-principals`
L'exemple de code suivant montre comment utiliser`list-thing-principals`.
**AWS CLI**
**Pour répertorier les principaux associés à un objet**
L’exemple `list-thing-principals` suivant répertorie les principaux (certificats X.509, utilisateur, groupes et rôles IAM, 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 [ListThingPrincipals](https://docs.aws.amazon.com/iot/latest/apireference/API_ListThingPrincipals.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListThingPrincipals](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principals.html)à la section *Référence des AWS CLI commandes*.
### `list-thing-types`
L'exemple de code suivant montre comment utiliser`list-thing-types`.
**AWS CLI**
**Pour répertorier les types d’objets définis**
L'`list-thing-types`exemple 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 [Types d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListThingTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-types.html)à la section *Référence des AWS CLI commandes*.
### `list-things-in-billing-group`
L'exemple de code suivant montre comment utiliser`list-things-in-billing-group`.
**AWS CLI**
**Pour répertorier les objets d’un groupe de facturation**
L’exemple `list-things-in-billing-group` suivant répertorie les objets figurant 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 [Groupes de facturation](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListThingsInBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-things-in-billing-group.html)à la section *Référence des AWS CLI commandes*.
### `list-things-in-thing-group`
L'exemple de code suivant montre comment utiliser`list-things-in-thing-group`.
**AWS CLI**
**Pour répertorier les objets appartenant à un groupe**
L’exemple `list-things-in-thing-group` suivant répertorie les objets qui appartiennent 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 [Groupes d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListThingsInThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-things-in-thing-group.html)à la section *Référence des AWS CLI commandes*.
### `list-things`
L'exemple de code suivant montre comment utiliser`list-things`.
**AWS CLI**
**Exemple 1 : pour répertorier tous les objets du registre**
L'`list-things`exemple 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 objets définis dotés d’un attribut spécifique**
L’exemple `list-things` 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 [Comment gérer des objets avec le registre](https://docs.aws.amazon.com/iot/latest/developerguide/thing-registry.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListThings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-things.html)à la section *Référence des AWS CLI commandes*.
### `list-topic-rule-destinations`
L'exemple de code suivant montre comment utiliser`list-topic-rule-destinations`.
**AWS CLI**
**Pour répertorier vos destinations de règle de rubrique**
L'`list-topic-rule-destinations`exemple 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 [Utilisation des destinations des règles de rubrique](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListTopicRuleDestinations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-topic-rule-destinations.html)à la section *Référence des AWS CLI commandes*.
### `list-topic-rules`
L'exemple de code suivant montre comment utiliser`list-topic-rules`.
**AWS CLI**
**Pour répertorier vos règles**
L’exemple `list-topic-rules` 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 [Affichage des règles](https://docs.aws.amazon.com/iot/latest/developerguide/iot-managae-rule.html#iot-view-rules) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListTopicRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-topic-rules.html)à la section *Référence des AWS CLI commandes*.
### `list-v2-logging-levels`
L'exemple de code suivant montre comment utiliser`list-v2-logging-levels`.
**AWS CLI**
**Pour répertorier les niveaux de journalisation**
L’exemple `list-v2-logging-levels` suivant répertorie les niveaux de journalisation configurés. Si aucun niveau de journalisation n’a été défini, une `NotConfiguredException` se produit lorsque vous exécutez cette commande.
```
aws iot list-v2-logging-levels
```
Sortie :
```
{
"logTargetConfigurations": [
{
"logTarget": {
"targetType": "DEFAULT"
},
"logLevel": "ERROR"
}
]
}
```
+ Pour plus de détails sur l'API, consultez [ListV2 LoggingLevels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-v2-logging-levels.html) dans *AWS CLI Command* Reference.
### `list-violation-events`
L'exemple de code suivant montre comment utiliser`list-violation-events`.
**AWS CLI**
**Pour répertorier les violations de profil de sécurité au cours d’une période donnée**
L'`list-violation-events`exemple 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 [Commandes Detect](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListViolationEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-violation-events.html)à la section *Référence des AWS CLI commandes*.
### `register-ca-certificate`
L'exemple de code suivant montre comment utiliser`register-ca-certificate`.
**AWS CLI**
**Pour enregistrer un certificat d’autorité de certification (CA)**
L’exemple `register-ca-certificate` 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](https://docs.aws.amazon.com/iot/latest/apireference/API_RegisterCACertificate.html) dans le guide de *référence des API AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [RegisterCaCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/register-ca-certificate.html)à la section *Référence des AWS CLI commandes*.
### `register-certificate`
L'exemple de code suivant montre comment utiliser`register-certificate`.
**AWS CLI**
**Pour enregistrer un certificat d’appareil autosigné**
L’exemple `register-certificate` suivant enregistre le certificat d’appareil `deviceCert.pem` signé par le certificat CA `rootCA.pem`. Le certificat CA doit être enregistré afin de vous permettre d’enregistrer un certificat d’appareil autosigné. Le certificat autosigné 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 [RegisterCertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_RegisterCertificate.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [RegisterCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/register-certificate.html)à la section *Référence des AWS CLI commandes*.
### `register-thing`
L'exemple de code suivant montre comment utiliser`register-thing`.
**AWS CLI**
**Pour enregistrer un objet**
L’exemple `register-thing` suivant enregistre un objet à l’aide d’un modèle d’allocation.
```
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 [Allocation par utilisateur approuvé](https://docs.aws.amazon.com/iot/latest/developerguide/provision-wo-cert.html#trusted-user) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [RegisterThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/register-thing.html)à la section *Référence des AWS CLI commandes*.
### `reject-certificate-transfer`
L'exemple de code suivant montre comment utiliser`reject-certificate-transfer`.
**AWS CLI**
**Pour refuser un transfert de certificat**
L'`reject-certificate-transfer`exemple 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 aucune sortie.
Pour plus d’informations, consultez [Transférer un certificat vers un autre compte](https://docs.aws.amazon.com/iot/latest/developerguide/transfer-cert.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [RejectCertificateTransfer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/reject-certificate-transfer.html)à la section *Référence des AWS CLI commandes*.
### `remove-thing-from-billing-group`
L'exemple de code suivant montre comment utiliser`remove-thing-from-billing-group`.
**AWS CLI**
**Pour supprimer un objet d’un groupe de facturation**
L’exemple `remove-thing-from-billing-group` suivant supprime l’objet 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 aucune sortie.
Pour plus d’informations, consultez [Groupes de facturation](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [RemoveThingFromBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/remove-thing-from-billing-group.html)à la section *Référence des AWS CLI commandes*.
### `remove-thing-from-thing-group`
L'exemple de code suivant montre comment utiliser`remove-thing-from-thing-group`.
**AWS CLI**
**Pour supprimer un objet d’un groupe d’objets**
L’exemple `remove-thing-from-thing-group` 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 aucune sortie.
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 plus de détails sur l'API, reportez-vous [RemoveThingFromThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/remove-thing-from-thing-group.html)à la section *Référence des AWS CLI commandes*.
### `replace-topic-rule`
L'exemple de code suivant montre comment utiliser`replace-topic-rule`.
**AWS CLI**
**Pour mettre à jour la définition d’une règle de rubrique**
L’exemple `replace-topic-rule` 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 aucune sortie.
Pour plus d'informations, consultez la section [Création d'une règle AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-create-rule.html) dans le *Guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ReplaceTopicRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/replace-topic-rule.html)à la section *Référence des AWS CLI commandes*.
### `search-index`
L'exemple de code suivant montre comment utiliser`search-index`.
**AWS CLI**
**Pour interroger l’index des objets**
L’exemple `search-index` suivant interroge l’index `AWS_Things` pour les objets de type `LightBulb`.
```
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 [Gestion de l’indexation d’objet](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [SearchIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/search-index.html)à la section *Référence des AWS CLI commandes*.
### `set-default-authorizer`
L'exemple de code suivant montre comment utiliser`set-default-authorizer`.
**AWS CLI**
**Pour définir un mécanisme d’autorisation par défaut**
L’exemple `set-default-authorizer` suivant définit le mécanisme d’autorisation personnalisé nommé `CustomAuthorizer` comme étant le mécanisme d’autorisation 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 [CreateDefaultAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateDefaultAuthorizer.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [SetDefaultAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/set-default-authorizer.html)à la section *Référence des AWS CLI commandes*.
### `set-default-policy-version`
L'exemple de code suivant montre comment utiliser`set-default-policy-version`.
**AWS CLI**
**Pour définir la version par défaut d’une stratégie**
L’exemple `set-default-policy-version` suivant définit la version par défaut sur `2` pour la stratégie nommée `UpdateDeviceCertPolicy`.
```
aws iot set-default-policy-version \
--policy-name UpdateDeviceCertPolicy \
--policy-version-id 2
```
Cette commande ne produit aucune sortie.
+ Pour plus de détails sur l'API, reportez-vous [SetDefaultPolicyVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/set-default-policy-version.html)à la section *Référence des AWS CLI commandes*.
### `set-v2-logging-level`
L'exemple de code suivant montre comment utiliser`set-v2-logging-level`.
**AWS CLI**
**Pour définir le niveau de journalisation d’un groupe d’objets**
L’exemple `set-v2-logging-level` 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 aucune sortie.
+ Pour plus de détails sur l'API, consultez [SetV2 LoggingLevel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/set-v2-logging-level.html) dans *AWS CLI Command Reference*.
### `set-v2-logging-options`
L'exemple de code suivant montre comment utiliser`set-v2-logging-options`.
**AWS CLI**
**Pour définir les options de journalisation**
L’exemple `set-v2-logging-options` 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 aucune sortie.
+ Pour plus de détails sur l'API, consultez [SetV2 LoggingOptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/set-v2-logging-options.html) dans *AWS CLI Command Reference*.
### `start-audit-mitigation-actions-task`
L'exemple de code suivant montre comment utiliser`start-audit-mitigation-actions-task`.
**AWS CLI**
**Pour appliquer une action d’atténuation aux résultats d’un audit**
L’exemple `start-audit-mitigation-actions-task` suivant applique l’action `ResetPolicyVersionAction` (qui efface la stratégie) 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)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-StartAuditMitigationActionsTask) dans le *Guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [StartAuditMitigationActionsTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/start-audit-mitigation-actions-task.html)à la section *Référence des AWS CLI commandes*.
### `start-on-demand-audit-task`
L'exemple de code suivant montre comment utiliser`start-on-demand-audit-task`.
**AWS CLI**
**Pour lancer un audit immédiatement**
L'`start-on-demand-audit-task`exemple 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 [Commandes d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [StartOnDemandAuditTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/start-on-demand-audit-task.html)à la section *Référence des AWS CLI commandes*.
### `tag-resource`
L'exemple de code suivant montre comment utiliser`tag-resource`.
**AWS CLI**
**Pour spécifier une clé de balise et une valeur pour une ressource**
L’exemple `tag-resource` suivant applique la balise avec une clé `Assembly` et la valeur `Fact1NW` au groupe d’objets `LightBulbs`.
```
aws iot tag-resource \
--tags Key=Assembly,Value="Fact1NW" \
--resource-arn "arn:aws:iot:us-west-2:094249569039:thinggroup/LightBulbs"
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez la section [Marquage de vos ressources AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html) dans le *guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/tag-resource.html)à la section *Référence des AWS CLI commandes*.
### `test-authorization`
L'exemple de code suivant montre comment utiliser`test-authorization`.
**AWS CLI**
**Pour tester vos politiques en matière d' AWS IoT**
L'`test-authorization`exemple 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 [TestAuthorization](https://docs.aws.amazon.com/iot/latest/apireference/API_TestAuthorization.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [TestAuthorization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/test-authorization.html)à la section *Référence des AWS CLI commandes*.
### `test-invoke-authorizer`
L'exemple de code suivant montre comment utiliser`test-invoke-authorizer`.
**AWS CLI**
**Pour tester votre mécanisme d’autorisation personnalisé**
L’exemple `test-invoke-authorizer` suivant teste votre mécanisme d’autorisation 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 [TestInvokeAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_TestInvokeAuthorizers.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [TestInvokeAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/test-invoke-authorizer.html)à la section *Référence des AWS CLI commandes*.
### `transfer-certificate`
L'exemple de code suivant montre comment utiliser`transfer-certificate`.
**AWS CLI**
**Pour transférer un certificat d'appareil vers un autre AWS compte**
L'`transfer-certificate`exemple 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 [Transférer un certificat vers un autre compte](https://docs.aws.amazon.com/iot/latest/developerguide/transfer-cert.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [TransferCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/transfer-certificate.html)à la section *Référence des AWS CLI commandes*.
### `untag-resource`
L'exemple de code suivant montre comment utiliser`untag-resource`.
**AWS CLI**
**Pour supprimer une clé de balise d’une ressource**
L’exemple `untag-resource` suivant supprime la balise `MyTag` et sa valeur du groupe d’objets `LightBulbs`.
```
command
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez la section [Marquage de vos ressources AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html) dans le *guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/untag-resource.html)à la section *Référence des AWS CLI commandes*.
### `update-account-audit-configuration`
L'exemple de code suivant montre comment utiliser`update-account-audit-configuration`.
**AWS CLI**
**Exemple 1 : pour activer les notifications Amazon SNS pour les notifications d’audit**
L'`update-account-audit-configuration`exemple 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 aucune sortie.
**Exemple 2 : pour activer une vérification d’audit**
L'`update-account-audit-configuration`exemple 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 aucune sortie.
Pour plus d’informations, consultez [Commandes d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateAccountAuditConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-account-audit-configuration.html)à la section *Référence des AWS CLI commandes*.
### `update-audit-suppression`
L'exemple de code suivant montre comment utiliser`update-audit-suppression`.
**AWS CLI**
**Pour mettre à jour la suppression d’un résultat d’audit**
L’exemple `update-audit-suppression` suivant redéfinit la date d’expiration de la suppression d’un résultat d’audit sur le 21/09/2020.
```
aws iot update-audit-suppression \
--check-name DEVICE_CERTIFICATE_EXPIRING_CHECK \
--resource-identifier deviceCertificateId=c7691e \
--no-suppress-indefinitely \
--expiration-date 2020-09-21
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Suppressions de résultat d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/audit-finding-suppressions.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateAuditSuppression](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-audit-suppression.html)à la section *Référence des AWS CLI commandes*.
### `update-authorizer`
L'exemple de code suivant montre comment utiliser`update-authorizer`.
**AWS CLI**
**Pour mettre à jour un mécanisme d’autorisation personnalisé**
L’exemple `update-authorizer` suivant redéfinit l’état de `CustomAuthorizer2` sur `INACTIVE`.
```
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 [UpdateAuthorizer](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateAuthorizer.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateAuthorizer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-authorizer.html)à la section *Référence des AWS CLI commandes*.
### `update-billing-group`
L'exemple de code suivant montre comment utiliser`update-billing-group`.
**AWS CLI**
**Pour mettre à jour les informations sur un groupe de facturation**
L’exemple `update-billing-group` 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 [Groupes de facturation](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot-billing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateBillingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-billing-group.html)à la section *Référence des AWS CLI commandes*.
### `update-ca-certificate`
L'exemple de code suivant montre comment utiliser`update-ca-certificate`.
**AWS CLI**
**Pour mettre à jour un certificat d’autorité de certification (CA)**
L’exemple `update-ca-certificate` suivant définit le certificat CA spécifié sur le statut ACTIF.
```
aws iot update-ca-certificate \
--certificate-id f4efed62c0142f16af278166f61962501165c4f0536295207426460058cd1467 \
--new-status ACTIVE
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez la section [Mise CACertificate à jour](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateCACertificate.html) de la *référence des API AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateCaCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-ca-certificate.html)à la section *Référence des AWS CLI commandes*.
### `update-certificate`
L'exemple de code suivant montre comment utiliser`update-certificate`.
**AWS CLI**
**Pour mettre à jour un certificat d’appareil**
L’exemple `update-certificate` 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 aucune sortie.
Pour plus d'informations, consultez [UpdateCertificate](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateCertificate.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateCertificate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-certificate.html)à la section *Référence des AWS CLI commandes*.
### `update-custom-metric`
L'exemple de code suivant montre comment utiliser`update-custom-metric`.
**AWS CLI**
**Pour mettre à jour une métrique personnalisée**
L’exemple `update-custom-metric` suivant met à jour une métrique personnalisée afin de la doter d’un nouveau `display-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 [Métriques personnalisées](https://docs.aws.amazon.com/iot/latest/developerguide/dd-detect-custom-metrics.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateCustomMetric](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-custom-metric.html)à la section *Référence des AWS CLI commandes*.
### `update-dimension`
L'exemple de code suivant montre comment utiliser`update-dimension`.
**AWS CLI**
**Pour mettre à jour une dimension**
L’exemple `update-dimension` 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 [Définition de la portée des métriques dans les profils de sécurité à l’aide de dimensions](https://docs.aws.amazon.com/iot/latest/developerguide/scoping-security-behavior.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateDimension](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-dimension.html)à la section *Référence des AWS CLI commandes*.
### `update-domain-configuration`
L'exemple de code suivant montre comment utiliser`update-domain-configuration`.
**AWS CLI**
**Pour mettre à jour une configuration de domaine**
L’exemple `update-domain-configuration` 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 [Points de terminaison configurables](https://docs.aws.amazon.com/iot/latest/developerguide/iot-custom-endpoints-configurable-aws.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateDomainConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-domain-configuration.html)à la section *Référence des AWS CLI commandes*.
### `update-dynamic-thing-group`
L'exemple de code suivant montre comment utiliser`update-dynamic-thing-group`.
**AWS CLI**
**Pour mettre à jour un groupe d’objets dynamique**
L’exemple `update-dynamic-thing-group` suivant met à jour le groupe d’objets dynamique 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 [Groupes d’objets dynamiques](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateDynamicThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-dynamic-thing-group.html)à la section *Référence des AWS CLI commandes*.
### `update-event-configurations`
L'exemple de code suivant montre comment utiliser`update-event-configurations`.
**AWS CLI**
**Pour afficher les types d’événements publiés**
L’exemple `update-event-configurations` 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 aucune sortie.
Pour plus d’informations, consultez [Messages d’événements](https://docs.aws.amazon.com/iot/latest/developerguide/iot-events.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateEventConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-event-configurations.html)à la section *Référence des AWS CLI commandes*.
### `update-indexing-configuration`
L'exemple de code suivant montre comment utiliser`update-indexing-configuration`.
**AWS CLI**
**Pour activer l’indexation des objets**
L'`update-indexing-configuration`exemple 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\$1Things.
```
aws iot update-indexing-configuration
--thing-indexing-configuration thingIndexingMode=REGISTRY_AND_SHADOW,thingConnectivityIndexingMode=STATUS
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Gestion de l’indexation d’objet](https://docs.aws.amazon.com/iot/latest/developerguide/managing-index.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateIndexingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-indexing-configuration.html)à la section *Référence des AWS CLI commandes*.
### `update-job`
L'exemple de code suivant montre comment utiliser`update-job`.
**AWS CLI**
**Pour obtenir le statut détaillé d’une tâche**
L’exemple `update-job` suivant obtient le statut détaillé de la tâche dont l’ID est `example-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 [Création et gestion de tâches (interface de ligne de commande)](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-job.html)à la section *Référence des AWS CLI commandes*.
### `update-mitigation-action`
L'exemple de code suivant montre comment utiliser`update-mitigation-action`.
**AWS CLI**
**Pour mettre à jour une action d’atténuation**
L’exemple `update-mitigation-action` suivant met à jour l’action d’atténuation spécifiée nommée `AddThingsToQuarantineGroupAction`, modifie le nom du groupe d’objets et définit `overrideDynamicGroups` sur `false`. Vous pouvez vérifier vos modifications à l’aide de la commande `describe-mitigation-action`.
```
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)](https://docs.aws.amazon.com/iot/latest/developerguide/mitigation-action-commands.html#dd-api-iot-UpdateMitigationAction) dans le *Guide du développeur de l'AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateMitigationAction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-mitigation-action.html)à la section *Référence des AWS CLI commandes*.
### `update-provisioning-template`
L'exemple de code suivant montre comment utiliser`update-provisioning-template`.
**AWS CLI**
**Pour mettre à jour un modèle de mise en service**
L’exemple `update-provisioning-template` suivant modifie la description et l’ARN de rôle du modèle d’allocation 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 aucune sortie.
Pour plus d’informations, consultez [Tunneling sécuriséAWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateProvisioningTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-provisioning-template.html)à la section *Référence des AWS CLI commandes*.
### `update-role-alias`
L'exemple de code suivant montre comment utiliser`update-role-alias`.
**AWS CLI**
**Pour mettre à jour un alias de rôle**
L’exemple `update-role-alias` suivant met à jour l’alias de rôle `LightBulbRole`.
```
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 [UpdateRoleAlias](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateRoleAlias.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateRoleAlias](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-role-alias.html)à la section *Référence des AWS CLI commandes*.
### `update-scheduled-audit`
L'exemple de code suivant montre comment utiliser`update-scheduled-audit`.
**AWS CLI**
**Pour mettre à jour une définition d’audit planifié**
L'`update-scheduled-audit`exemple suivant modifie les noms des contrôles cibles pour un audit planifié d' 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 [Commandes d’audit](https://docs.aws.amazon.com/iot/latest/developerguide/AuditCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateScheduledAudit](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-scheduled-audit.html)à la section *Référence des AWS CLI commandes*.
### `update-security-profile`
L'exemple de code suivant montre comment utiliser`update-security-profile`.
**AWS CLI**
**Pour modifier un profil de sécurité**
L'`update-security-profile`exemple 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 [Commandes Detect](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateSecurityProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-security-profile.html)à la section *Référence des AWS CLI commandes*.
### `update-stream`
L'exemple de code suivant montre comment utiliser`update-stream`.
**AWS CLI**
**Pour mettre à jour un flux**
L’exemple `update-stream` suivant met à jour un flux existant. La version du flux est incrémentée de 1.
```
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 [UpdateStream](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateStream.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-stream.html)à la section *Référence des AWS CLI commandes*.
### `update-thing-group`
L'exemple de code suivant montre comment utiliser`update-thing-group`.
**AWS CLI**
**Pour mettre à jour la définition d’un groupe d’objets**
L’exemple `update-thing-group` 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 [Groupes d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateThingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-thing-group.html)à la section *Référence des AWS CLI commandes*.
### `update-thing-groups-for-thing`
L'exemple de code suivant montre comment utiliser`update-thing-groups-for-thing`.
**AWS CLI**
**Pour modifier les groupes auxquels un objet appartient**
L’exemple `update-thing-groups-for-thing` suivant supprime l’objet nommé `MyLightBulb` du groupe nommé `DeadBulbs` et l’ajoute simultanément au groupe nommé `replaceableItems`.
```
aws iot update-thing-groups-for-thing \
--thing-name MyLightBulb \
--thing-groups-to-add "replaceableItems" \
--thing-groups-to-remove "DeadBulbs"
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Groupes d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateThingGroupsForThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-thing-groups-for-thing.html)à la section *Référence des AWS CLI commandes*.
### `update-thing`
L'exemple de code suivant montre comment utiliser`update-thing`.
**AWS CLI**
**Pour associer un objet à un type d’objet**
L'`update-thing`exemple suivant associe un objet du registre AWS IoT à un type d'objet. Lorsque vous établissez l’association, vous fournissez des valeurs pour les attributs définis par le type d’objet.
```
aws iot update-thing \
--thing-name "MyOtherLightBulb" \
--thing-type-name "LightBulb" \
--attribute-payload "{"attributes": {"wattage":"75", "model":"123"}}"
```
Cette commande ne génère pas de sortie. Affichez le résultat à l’aide de la commande `describe-thing`.
Pour plus d’informations, consultez [Types d’objets](https://docs.aws.amazon.com/iot/latest/developerguide/thing-types.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateThing](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-thing.html)à la section *Référence des AWS CLI commandes*.
### `update-topic-rule-destination`
L'exemple de code suivant montre comment utiliser`update-topic-rule-destination`.
**AWS CLI**
**Exemple 1 : pour activer une destination de règle de rubrique**
L’exemple `update-topic-rule-destination` suivant active le trafic vers une destination de règle de rubrique.
```
aws iot update-topic-rule-destination \
--arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \
--status ENABLED
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Activation d’une destination de règle de rubrique](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#enable-destination) dans le *Guide du développeur AWS IoT*.
**Exemple 2 : pour désactiver une destination de règle de rubrique**
L’exemple `update-topic-rule-destination` suivant désactive le trafic vers une destination de règle de rubrique.
```
aws iot update-topic-rule-destination \
--arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \
--status DISABLED
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Désactivation d’une destination de règle de rubrique](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#disable-destination) dans le *Guide du développeur AWS IoT*.
**Exemple 3 : pour envoyer un nouveau message de confirmation**
L’exemple `update-topic-rule-destination` suivant envoie un nouveau message de confirmation pour une destination de règle de rubrique.
```
aws iot update-topic-rule-destination \
--arn "arn:aws:iot:us-west-2:123456789012:ruledestination/http/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \
--status IN_PROGRESS
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Envoi d’un nouveau message de confirmation](https://docs.aws.amazon.com/iot/latest/developerguide/rule-destination.html#trigger-confirm) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateTopicRuleDestination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/update-topic-rule-destination.html)à la section *Référence des AWS CLI commandes*.
### `validate-security-profile-behaviors`
L'exemple de code suivant montre comment utiliser`validate-security-profile-behaviors`.
**AWS CLI**
**Exemple 1 : pour valider les paramètres comportementaux d’un profil de sécurité**
L'`validate-security-profile-behaviors`exemple suivant valide un ensemble de comportements bien formé et correct pour un profil de sécurité AWS IoT Device Defender.
```
aws iot validate-security-profile-behaviors \
--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\":12},\"durationSeconds\":300,\"consecutiveDatapointsToAlarm\":1,\"consecutiveDatapointsToClear\":1}}]"
```
Sortie :
```
{
"valid": true,
"validationErrors": []
}
```
**Exemple 2 : pour valider les paramètres comportementaux incorrects d’un profil de sécurité**
L'`validate-security-profile-behaviors`exemple suivant valide un ensemble de comportements contenant une erreur pour un profil de sécurité AWS IoT Device Defender.
```
aws iot validate-security-profile-behaviors \
--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\":12},\"durationSeconds\":300,\"consecutiveDatapointsToAlarm\":100000,\"consecutiveDatapointsToClear\":1}}]"
```
Sortie :
```
{
"valid": false,
"validationErrors": [
{
"errorMessage": "Behavior Authorization is malformed. consecutiveDatapointsToAlarm 100000 should be in range[1,10]"
}
]
}
```
Pour plus d’informations, consultez [Commandes Detect](https://docs.aws.amazon.com/iot/latest/developerguide/DetectCommands.html) dans le *Guide du développeur AWS IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ValidateSecurityProfileBehaviors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/validate-security-profile-behaviors.html)à la section *Référence des AWS CLI commandes*.