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.
# Exemples d'utilisation de Device Advisor AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide de Device Advisor.
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
### `create-suite-definition`
L'exemple de code suivant montre comment utiliser`create-suite-definition`.
**AWS CLI**
**Exemple 1 : pour créer une suite de tests IoT Device Advisor**
L'`create-suite-definition`exemple suivant crée une suite de tests Device Advisor dans l' AWS IoT avec la configuration de définition de suite spécifiée.
```
aws iotdeviceadvisor create-suite-definition \
--suite-definition-configuration '{ \
"suiteDefinitionName": "TestSuiteName", \
"devices": [{"thingArn":"arn:aws:iot:us-east-1:123456789012:thing/MyIotThing"}], \
"intendedForQualification": false, \
"rootGroup": "{\"configuration\":{},\"tests\":[{\"name\":\"MQTT Connect\",\"configuration\":{\"EXECUTION_TIMEOUT\":120},\"tests\":[{\"name\":\"MQTT_Connect\",\"configuration\":{},\"test\":{\"id\":\"MQTT_Connect\",\"testCase\":null,\"version\":\"0.0.0\"}}]}]}", \
"devicePermissionRoleArn": "arn:aws:iam::123456789012:role/Myrole"}'
```
Sortie :
```
{
"suiteDefinitionId": "0jtsgio7yenu",
"suiteDefinitionArn": "arn:aws:iotdeviceadvisor:us-east-1:123456789012:suitedefinition/0jtsgio7yenu",
"suiteDefinitionName": "TestSuiteName",
"createdAt": "2022-12-02T11:38:13.263000-05:00"
}
```
Pour plus d’informations, consultez [Création d’une définition de suite de tests](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-create-suite-definition) dans le *Guide du développeur AWS IoT Core*.
**Exemple 2 : pour créer une suite de tests de qualification avec la dernière version d’IoT Device Advisor**
L'`create-suite-definition`exemple suivant crée une suite de tests de qualification Device Advisor avec la dernière version de l' AWS IoT avec la configuration de définition de suite spécifiée.
```
aws iotdeviceadvisor create-suite-definition \
--suite-definition-configuration '{ \
"suiteDefinitionName": "TestSuiteName", \
"devices": [{"thingArn":"arn:aws:iot:us-east-1:123456789012:thing/MyIotThing"}], \
"intendedForQualification": true, \
"rootGroup": "", \
"devicePermissionRoleArn": "arn:aws:iam::123456789012:role/Myrole"}'
```
Sortie :
```
{
"suiteDefinitionId": "txgsuolk2myj",
"suiteDefinitionArn": "arn:aws:iotdeviceadvisor:us-east-1:123456789012:suitedefinition/txgsuolk2myj",
"suiteDefinitionName": "TestSuiteName",
"createdAt": "2022-12-02T11:38:13.263000-05:00"
}
```
Pour plus d’informations, consultez [Création d’une définition de suite de tests](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-create-suite-definition) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [CreateSuiteDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/create-suite-definition.html)à la section *Référence des AWS CLI commandes*.
### `delete-suite-definition`
L'exemple de code suivant montre comment utiliser`delete-suite-definition`.
**AWS CLI**
**Pour supprimer la suite de tests IoT Device Advisor**
L’exemple `delete-suite-definition` suivant supprime la suite de tests Device Advisor avec l’ID de définition de suite spécifié.
```
aws iotdeviceadvisor delete-suite-definition \
--suite-definition-id 0jtsgio7yenu
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez [DeleteSuiteDefinition](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_DeleteSuiteDefinition.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteSuiteDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/delete-suite-definition.html)à la section *Référence des AWS CLI commandes*.
### `get-endpoint`
L'exemple de code suivant montre comment utiliser`get-endpoint`.
**AWS CLI**
**Exemple 1 : pour obtenir des informations sur un point de terminaison au niveau du compte IoT Device Advisor**
L’exemple `get-endpoint` suivant obtient les informations relatives à un point de terminaison de test au niveau du compte Device Advisor.
```
aws iotdeviceadvisor get-endpoint
```
Sortie :
```
{
"endpoint": "t6y4c143x9sfo.deviceadvisor.iot.us-east-1.amazonaws.com"
}
```
**Exemple 2 : pour obtenir des informations sur un point de terminaison au niveau de l’appareil IoT Device Advisor**
L’exemple `get-endpoint` suivant obtient les informations relatives à un point de terminaison de test Device Advisor au niveau de l’appareil avec la valeur thing-arn ou certificate-arn spécifiée.
```
aws iotdeviceadvisor get-endpoint \
--thing-arn arn:aws:iot:us-east-1:123456789012:thing/MyIotThing
```
Sortie :
```
{
"endpoint": "tdb7719be5t6y4c143x9sfo.deviceadvisor.iot.us-east-1.amazonaws.com"
}
```
Pour plus d’informations, consultez [Obtention d’un point de terminaison de test](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-get-test-endpoint) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [GetEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/get-endpoint.html)à la section *Référence des AWS CLI commandes*.
### `get-suite-definition`
L'exemple de code suivant montre comment utiliser`get-suite-definition`.
**AWS CLI**
**Pour obtenir les informations sur une suite de tests IoT Device Advisor**
L’exemple `get-suite-definition` suivant obtient les informations relatives à une suite de tests Device Advisor avec l’ID de définition de suite spécifié.
```
aws iotdeviceadvisor get-suite-definition \
--suite-definition-id qqcsmtyyjabl
```
Sortie :
```
{
"suiteDefinitionId": "qqcsmtyyjabl",
"suiteDefinitionArn": "arn:aws:iotdeviceadvisor:us-east-1:123456789012:suitedefinition/qqcsmtyyjabl",
"suiteDefinitionVersion": "v1",
"latestVersion": "v1",
"suiteDefinitionConfiguration": {
"suiteDefinitionName": "MQTT connection",
"devices": [],
"intendedForQualification": false,
"isLongDurationTest": false,
"rootGroup": "{\"configuration\":{},\"tests\":[{\"id\":\"uta5d9j1kvwc\",\"name\":\"Test group 1\",\"configuration\":{},\"tests\":[{\"id\":\"awr8pq5vc9yp\",\"name\":\"MQTT Connect\",\"configuration\":{},\"test\":{\"id\":\"MQTT_Connect\",\"testCase\":null,\"version\":\"0.0.0\"}}]}]}",
"devicePermissionRoleArn": "arn:aws:iam::123456789012:role/Myrole",
"protocol": "MqttV3_1_1"
},
"createdAt": "2022-11-11T22:28:52.389000-05:00",
"lastModifiedAt": "2022-11-11T22:28:52.389000-05:00",
"tags": {}
}
```
Pour plus d’informations, consultez [Obtention d’une définition de suite de tests](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-create-suite-definition) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [GetSuiteDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/get-suite-definition.html)à la section *Référence des AWS CLI commandes*.
### `get-suite-run-report`
L'exemple de code suivant montre comment utiliser`get-suite-run-report`.
**AWS CLI**
**Pour obtenir les informations sur le rapport d’exécution d’une suite de tests éligibles IoT Device Advisor**
L’exemple `get-suite-run-report` suivant obtient le lien de téléchargement du rapport pour une suite de tests éligibles Device Advisor exécutée avec succès, avec l’ID de définition et l’ID d’exécution de la suite spécifiés.
```
aws iotdeviceadvisor get-suite-run-report \
--suite-definition-id ztvb5aek4w4x \
--suite-run-id p6awv83nre6v
```
Sortie :
```
{
"qualificationReportDownloadUrl": "https://senate-apn-reports-us-east-1-prod.s3.amazonaws.com/report.downloadlink"
}
```
Pour plus d’informations, consultez [Obtention d’un rapport de qualification pour une exécution réussie de la suite de tests de qualification](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-qualification-report) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [GetSuiteRunReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/get-suite-run-report.html)à la section *Référence des AWS CLI commandes*.
### `get-suite-run`
L'exemple de code suivant montre comment utiliser`get-suite-run`.
**AWS CLI**
**Pour obtenir les informations sur le statut d’exécution d’une suite de tests IoT Device Advisor**
L’exemple `get-suite-run` suivant obtient les informations relatives au statut d’exécution d’une suite de tests Device Advisor avec l’ID de définition et l’ID d’exécution de la suite spécifiés.
```
aws iotdeviceadvisor get-suite-run \
--suite-definition-id qqcsmtyyjabl \
--suite-run-id nzlfyhaa18oa
```
Sortie :
```
{
"suiteDefinitionId": "qqcsmtyyjabl",
"suiteDefinitionVersion": "v1",
"suiteRunId": "nzlfyhaa18oa",
"suiteRunArn": "arn:aws:iotdeviceadvisor:us-east-1:123456789012:suiterun/qqcsmtyyjabl/nzlfyhaa18oa",
"suiteRunConfiguration": {
"primaryDevice": {
"thingArn": "arn:aws:iot:us-east-1:123456789012:thing/MyIotThing",
"certificateArn": "arn:aws:iot:us-east-1:123456789012:cert/certFile"
},
"parallelRun": false
},
"testResult": {
"groups": [
{
"groupId": "uta5d9j1kvwc",
"groupName": "Test group 1",
"tests": [
{
"testCaseRunId": "2ve2twrqyr0s",
"testCaseDefinitionId": "awr8pq5vc9yp",
"testCaseDefinitionName": "MQTT Connect",
"status": "PASS",
"startTime": "2022-11-12T00:01:53.693000-05:00",
"endTime": "2022-11-12T00:02:15.443000-05:00",
"logUrl": "https://console.aws.amazon.com/cloudwatch/home?region=us-east-1#logEventViewer:group=/aws/iot/deviceadvisor/qqcsmtyyjabl;stream=nzlfyhaa18oa_2ve2twrqyr0s",
"warnings": "null",
"failure": "null"
}
]
}
]
},
"startTime": "2022-11-12T00:01:52.673000-05:00",
"endTime": "2022-11-12T00:02:16.496000-05:00",
"status": "PASS",
"tags": {}
}
```
Pour plus d’informations, consultez [Exécution d’une suite de tests](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-describe-suite) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [GetSuiteRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/get-suite-run.html)à la section *Référence des AWS CLI commandes*.
### `list-suite-definitions`
L'exemple de code suivant montre comment utiliser`list-suite-definitions`.
**AWS CLI**
**Exemple 1 : pour répertorier les suites de tests IoT Device Advisor que vous avez créées**
L'`list-suite-definitions`exemple suivant répertorie jusqu'à 25 suites de tests Device Advisor que vous avez créées dans AWS l'IoT. Si vous avez plus de 25 suites de tests, « nextToken » s’affiche dans la sortie. Vous pouvez utiliser cette valeur « nextToken » pour afficher le reste des suites de tests que vous avez créées.
```
aws iotdeviceadvisor list-suite-definitions
```
Sortie :
```
{
"suiteDefinitionInformationList": [
{
"suiteDefinitionId": "3hsn88h4p2g5",
"suiteDefinitionName": "TestSuite1",
"defaultDevices": [
{
"thingArn": "arn:aws:iot:us-east-1:123456789012:thing/MyIotThing"
}
],
"intendedForQualification": false,
"isLongDurationTest": false,
"protocol": "MqttV3_1_1",
"createdAt": "2022-11-17T14:15:56.830000-05:00"
},
{
......
}
],
"nextToken": "nextTokenValue"
}
```
**Exemple 2 : pour répertorier les suites de tests IoT Device Advisor que vous avez créées avec les paramètres spécifiés**
L'`list-suite-definitions`exemple suivant répertorie les suites de tests Device Advisor que vous avez créées dans AWS l'IoT avec le nombre maximum de résultats spécifié. Si vous avez plus de suites de tests que le nombre maximal, « nextToken » s’affiche dans la sortie. Si « nextToken » apparaît, vous pouvez utiliser cette valeur pour afficher les suites de tests que vous avez créées et qui ne s’affichaient pas auparavant.
```
aws iotdeviceadvisor list-suite-definitions \
--max-result 1 \
--next-token "nextTokenValue"
```
Sortie :
```
{
"suiteDefinitionInformationList": [
{
"suiteDefinitionId": "ztvb5aew4w4x",
"suiteDefinitionName": "TestSuite2",
"defaultDevices": [],
"intendedForQualification": true,
"isLongDurationTest": false,
"protocol": "MqttV3_1_1",
"createdAt": "2022-11-17T14:15:56.830000-05:00"
}
],
"nextToken": "nextTokenValue"
}
```
Pour plus d'informations, consultez [ListSuiteDefinitions](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_ListSuiteDefinitions.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListSuiteDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/list-suite-definitions.html)à la section *Référence des AWS CLI commandes*.
### `list-suite-runs`
L'exemple de code suivant montre comment utiliser`list-suite-runs`.
**AWS CLI**
**Exemple 1 : pour répertorier toutes les informations relatives au statut d’exécution d’une suite de tests IoT Device Advisor**
L’exemple `list-suite-runs` suivant répertorie toutes les informations relatives au statut d’exécution d’une suite de tests Device Advisor avec l’ID de définition de la suite spécifié. Si vous avez plus de 25 exécutions de suite de tests, « nextToken » s’affiche dans la sortie. Vous pouvez utiliser cette valeur « nextToken » pour afficher le reste des exécutions de suite de tests.
```
aws iotdeviceadvisor list-suite-runs \
--suite-definition-id ztvb5aew4w4x
```
Sortie :
```
{
"suiteRunsList": [
{
"suiteDefinitionId": "ztvb5aew4w4x",
"suiteDefinitionVersion": "v1",
"suiteDefinitionName": "TestSuite",
"suiteRunId": "p6awv89nre6v",
"createdAt": "2022-12-01T16:33:14.212000-05:00",
"startedAt": "2022-12-01T16:33:15.710000-05:00",
"endAt": "2022-12-01T16:42:03.323000-05:00",
"status": "PASS",
"passed": 6,
"failed": 0
}
]
}
```
**Exemple 2 : pour répertorier les informations relatives au statut d’exécution d’une suite de tests IoT Device Advisor avec les paramètres spécifiés**
L’exemple `list-suite-runs` suivant répertorie les informations relatives au statut d’exécution d’une suite de tests Device Advisor avec l’ID de définition de suite et le nombre maximal de résultats spécifiés. Si vous avez plus d’exécutions de suite de tests que le nombre maximal, « nextToken » s’affiche dans la sortie. Si « nextToken » apparaît, vous pouvez utiliser cette valeur pour afficher les exécutions de suite de tests qui ne s’affichaient pas auparavant.
```
aws iotdeviceadvisor list-suite-runs \
--suite-definition-id qqcsmtyyjaml \
--max-result 1 \
--next-token "nextTokenValue"
```
Sortie :
```
{
"suiteRunsList": [
{
"suiteDefinitionId": "qqcsmtyyjaml",
"suiteDefinitionVersion": "v1",
"suiteDefinitionName": "MQTT connection",
"suiteRunId": "gz9vm2s6d2jy",
"createdAt": "2022-12-01T20:10:27.079000-05:00",
"startedAt": "2022-12-01T20:10:28.003000-05:00",
"endAt": "2022-12-01T20:10:45.084000-05:00",
"status": "STOPPED",
"passed": 0,
"failed": 0
}
],
"nextToken": "nextTokenValue"
}
```
Pour plus d'informations, consultez [ListSuiteRuns](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_ListSuiteRuns.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [ListSuiteRuns](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/list-suite-runs.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 répertorier les balises attachées à une ressource IoT Device Advisor**
L’exemple `list-tags-for-resource` suivant répertorie les balises attachées à une ressource Device Advisor. La ressource Device Advisor peut être Suitedefinition-Arn ou Suiterun-Arn.
```
aws iotdeviceadvisor list-tags-for-resource \
--resource-arn arn:aws:iotdeviceadvisor:us-east-1:123456789012:suitedefinition/ba0uyjpg38ny
```
Sortie :
```
{
"tags": {
"TestTagKey": "TestTagValue"
}
}
```
Pour plus d'informations, consultez [ListTagsForResource](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_ListTagsForResource.html)la *référence des API AWS IoT* et les [types de ressources définis par AWS IoT Core Device Advisor](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotcoredeviceadvisor.html#awsiotcoredeviceadvisor-resources-for-iam-policies) dans la *référence d'autorisation de service*.
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/list-tags-for-resource.html)à la section *Référence des AWS CLI commandes*.
### `start-suite-run`
L'exemple de code suivant montre comment utiliser`start-suite-run`.
**AWS CLI**
**Pour démarrer l’exécution d’une suite de tests IoT Device Advisor**
L'`start-suite-run`exemple suivant répertorie les widgets disponibles dans votre AWS compte.
```
aws iotdeviceadvisor start-suite-run \
--suite-definition-id qqcsmtyyjabl \
--suite-definition-version v1 \
--suite-run-configuration '{"primaryDevice":{"thingArn": "arn:aws:iot:us-east-1:123456789012:thing/MyIotThing","certificateArn":"arn:aws:iot:us-east-1:123456789012:cert/certFile"}}'
```
Sortie :
```
{
"suiteRunId": "pwmucgw7lt9s",
"suiteRunArn": "arn:aws:iotdeviceadvisor:us-east-1:123456789012:suiterun/qqcsmtyyjabl/pwmucgw7lk9s",
"createdAt": "2022-12-02T15:43:05.581000-05:00"
}
```
Pour plus d’informations, consultez [Lancement de l’exécution d’une suite de tests](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-start-suite-run) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [StartSuiteRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/start-suite-run.html)à la section *Référence des AWS CLI commandes*.
### `stop-suite-run`
L'exemple de code suivant montre comment utiliser`stop-suite-run`.
**AWS CLI**
**Pour arrêter une suite de tests IoT Device Advisor en cours d’exécution**
L’exemple `stop-suite-run` suivant permet d’arrêter une suite de tests Device Advisor en cours d’exécution avec l’ID de définition de suite et l’ID d’exécution de suite spécifiés.
```
aws iotdeviceadvisor stop-suite-run \
--suite-definition-id qqcsmtyyjabl \
--suite-run-id nzlfyhaa18oa
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Arrêt de l’exécution d’une suite de tests](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-stop-suite-run) dans le *Guide du développeur AWS IoT Core*.
+ Pour plus de détails sur l'API, reportez-vous [StopSuiteRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/stop-suite-run.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 ajouter des balises à une ressource IoT Device Advisor et modifier ses balises existantes**
L’exemple `tag-resource` suivant ajoute des balises à une ressource Device Advisor et modifie ses balises existantes avec l’ARN et les balises de ressource spécifiés. La ressource Device Advisor peut être Suitedefinition-Arn ou Suiterun-Arn.
```
aws iotdeviceadvisor tag-resource \
--resource-arn arn:aws:iotdeviceadvisor:us-east-1:123456789012:suitedefinition/ba0uyjpg38ny \
--tags '{"TagKey": "TagValue"}'
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez [TagResource](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_TagResource.html)la *référence des API AWS IoT* et les [types de ressources définis par AWS IoT Core Device Advisor](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotcoredeviceadvisor.html#awsiotcoredeviceadvisor-resources-for-iam-policies) dans la *référence d'autorisation de service*.
+ Pour plus de détails sur l'API, reportez-vous [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/tag-resource.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 les balises existantes d’une ressource IoT Device Advisor**
L’exemple `untag-resource` suivant supprime les balises existantes d’une ressource Device Advisor avec l’ARN et la clé de balise de la ressource spécifiés. La ressource Device Advisor peut être Suitedefinition-Arn ou Suiterun-Arn.
```
aws iotdeviceadvisor untag-resource \
--resource-arn arn:aws:iotdeviceadvisor:us-east-1:123456789012:suitedefinition/ba0uyjpg38ny \
--tag-keys "TagKey"
```
Cette commande ne produit aucune sortie.
Pour plus d'informations, consultez [UntagResource](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_UntagResource.html)la *référence des API AWS IoT* et les [types de ressources définis par AWS IoT Core Device Advisor](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotcoredeviceadvisor.html#awsiotcoredeviceadvisor-resources-for-iam-policies) dans la *référence d'autorisation de service*.
+ Pour plus de détails sur l'API, reportez-vous [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/untag-resource.html)à la section *Référence des AWS CLI commandes*.
### `update-suite-definition`
L'exemple de code suivant montre comment utiliser`update-suite-definition`.
**AWS CLI**
**Exemple 1 : pour mettre à jour une suite de tests IoT Device Advisor**
L'`update-suite-definition`exemple suivant met à jour une suite de tests Device Advisor dans l' AWS IoT avec l'ID de définition de suite et la configuration de définition de suite spécifiés.
```
aws iotdeviceadvisor update-suite-definition \
--suite-definition-id 3hsn88h4p2g5 \
--suite-definition-configuration '{ \
"suiteDefinitionName": "TestSuiteName", \
"devices": [{"thingArn":"arn:aws:iot:us-east-1:123456789012:thing/MyIotThing"}], \
"intendedForQualification": false, \
"rootGroup": "{\"configuration\":{},\"tests\":[{\"name\":\"MQTT Connect\",\"configuration\":{\"EXECUTION_TIMEOUT\":120},\"tests\":[{\"name\":\"MQTT_Connect\",\"configuration\":{},\"test\":{\"id\":\"MQTT_Connect\",\"testCase\":null,\"version\":\"0.0.0\"}}]}]}", \
"devicePermissionRoleArn": "arn:aws:iam::123456789012:role/Myrole"}'
```
Sortie :
```
{
"suiteDefinitionId": "3hsn88h4p2g5",
"suiteDefinitionName": "TestSuiteName",
"suiteDefinitionVersion": "v3",
"createdAt": "2022-11-17T14:15:56.830000-05:00",
"lastUpdatedAt": "2022-12-02T16:02:45.857000-05:00"
}
```
**Exemple 2 : pour mettre à jour une suite de tests de qualification IoT Device Advisor**
L'`update-suite-definition`exemple suivant met à jour une suite de tests de qualification de Device Advisor dans l' AWS IoT avec l'ID de définition de suite et la configuration de définition de suite spécifiés.
```
aws iotdeviceadvisor update-suite-definition \
--suite-definition-id txgsuolk2myj \
--suite-definition-configuration '{
"suiteDefinitionName": "TestSuiteName", \
"devices": [{"thingArn":"arn:aws:iot:us-east-1:123456789012:thing/MyIotThing"}], \
"intendedForQualification": true, \
"rootGroup": "", \
"devicePermissionRoleArn": "arn:aws:iam::123456789012:role/Myrole"}'
```
Sortie :
```
{
"suiteDefinitionId": "txgsuolk2myj",
"suiteDefinitionName": "TestSuiteName",
"suiteDefinitionVersion": "v3",
"createdAt": "2022-11-17T14:15:56.830000-05:00",
"lastUpdatedAt": "2022-12-02T16:02:45.857000-05:00"
}
```
Pour plus d'informations, consultez [UpdateSuiteDefinition](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_UpdateSuiteDefinition.html)la *référence AWS des API IoT*.
+ Pour plus de détails sur l'API, reportez-vous [UpdateSuiteDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/update-suite-definition.html)à la section *Référence des AWS CLI commandes*.