Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Device Advisor-Beispiele mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Device Advisor Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `create-suite-definition`
Das folgende Codebeispiel zeigt die Verwendung von`create-suite-definition`.
**AWS CLI**
**Beispiel 1: So erstellen Sie eine Testsuite für IoT Device Advisor**
Im folgenden `create-suite-definition` Beispiel wird eine Device Advisor-Testsuite im AWS IoT mit der angegebenen Suite-Definitionskonfiguration erstellt.
```
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"}'
```
Ausgabe:
```
{
"suiteDefinitionId": "0jtsgio7yenu",
"suiteDefinitionArn": "arn:aws:iotdeviceadvisor:us-east-1:123456789012:suitedefinition/0jtsgio7yenu",
"suiteDefinitionName": "TestSuiteName",
"createdAt": "2022-12-02T11:38:13.263000-05:00"
}
```
Weitere Informationen finden Sie unter [Erstellen einer Testsuite-Definition](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-create-suite-definition) im *Entwicklerhandbuch für AWS IoT Core*.
**Beispiel 2: So erstellen Sie eine Qualifizierungs-Testsuite für IoT Device Advisor**
Im folgenden `create-suite-definition` Beispiel wird eine Device Advisor-Qualifizierungstestsuite mit der neuesten Version im AWS IoT mit der angegebenen Suite-Definitionskonfiguration erstellt.
```
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"}'
```
Ausgabe:
```
{
"suiteDefinitionId": "txgsuolk2myj",
"suiteDefinitionArn": "arn:aws:iotdeviceadvisor:us-east-1:123456789012:suitedefinition/txgsuolk2myj",
"suiteDefinitionName": "TestSuiteName",
"createdAt": "2022-12-02T11:38:13.263000-05:00"
}
```
Weitere Informationen finden Sie unter [Erstellen einer Testsuite-Definition](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-create-suite-definition) im *Entwicklerhandbuch für AWS IoT Core*.
+ Einzelheiten zur API finden Sie [CreateSuiteDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/create-suite-definition.html)in der *AWS CLI Befehlsreferenz*.
### `delete-suite-definition`
Das folgende Codebeispiel zeigt die Verwendung`delete-suite-definition`.
**AWS CLI**
**So löschen Sie die Testsuite von IoT Device Advisor**
Im folgenden Beispiel für `delete-suite-definition` wird die Testsuite von Device Advisor mit der angegebenen Suite-Definitions-ID gelöscht.
```
aws iotdeviceadvisor delete-suite-definition \
--suite-definition-id 0jtsgio7yenu
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie [DeleteSuiteDefinition](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_DeleteSuiteDefinition.html)in der *AWS IoT-API-Referenz*.
+ Einzelheiten zur API finden Sie [DeleteSuiteDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/delete-suite-definition.html)in der *AWS CLI Befehlsreferenz*.
### `get-endpoint`
Das folgende Codebeispiel zeigt die Verwendung`get-endpoint`.
**AWS CLI**
**Beispiel 1: So rufen Sie die Informationen über einen Endpunkt auf Kontoebene von IoT Device Advisor ab**
Im folgenden Beispiel für `get-endpoint` werden die Informationen über einen Test-Endpunkt auf Kontoebene von Device Advisor abgerufen.
```
aws iotdeviceadvisor get-endpoint
```
Ausgabe:
```
{
"endpoint": "t6y4c143x9sfo.deviceadvisor.iot.us-east-1.amazonaws.com"
}
```
**Beispiel 2: So rufen Sie die Informationen über einen Endpunkt auf Geräteebene von IoT Device Advisor ab**
Im folgenden Beispiel für `get-endpoint` werden die Informationen über einen Test-Endpunkt auf Geräteebene von Device Advisor mit dem angegebenen Objekt-ARN oder Zertifikat-ARN abgerufen.
```
aws iotdeviceadvisor get-endpoint \
--thing-arn arn:aws:iot:us-east-1:123456789012:thing/MyIotThing
```
Ausgabe:
```
{
"endpoint": "tdb7719be5t6y4c143x9sfo.deviceadvisor.iot.us-east-1.amazonaws.com"
}
```
Weitere Informationen finden Sie unter [Abrufen eines Testendpunkts](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-get-test-endpoint) im *Entwicklerhandbuch für AWS IoT Core*.
+ Einzelheiten zur API finden Sie [GetEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/get-endpoint.html)in der *AWS CLI Befehlsreferenz*.
### `get-suite-definition`
Das folgende Codebeispiel zeigt die Verwendung`get-suite-definition`.
**AWS CLI**
**So rufen Sie Informationen über eine Testsuite von IoT Device Advisor ab**
Im folgenden Beispiel für `get-suite-definition` werden die Informationen über eine Testsuite von Device Advisor mit der angegebenen Suite-Definitions-ID abgerufen.
```
aws iotdeviceadvisor get-suite-definition \
--suite-definition-id qqcsmtyyjabl
```
Ausgabe:
```
{
"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": {}
}
```
Weitere Informationen finden Sie unter [Abrufen einer Testsuite-Definition](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-create-suite-definition) im *Entwicklerhandbuch für AWS IoT Core*.
+ Einzelheiten zur API finden Sie [GetSuiteDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/get-suite-definition.html)in der *AWS CLI Befehlsreferenz*.
### `get-suite-run-report`
Das folgende Codebeispiel zeigt die Verwendung`get-suite-run-report`.
**AWS CLI**
**So rufen Sie Informationen über den Bericht zur Ausführung einer Qualifizierungs-Testsuite von IoT Device Advisor ab**
Im folgenden Beispiel für `get-suite-run-report` wird der Link zum Herunterladen des Berichts für eine erfolgreiche Ausführung einer Qualifizierungs-Testsuite von Device Advisor mit der angegebenen Suite-Definitions-ID und Suite-Ausführungs-ID abgerufen.
```
aws iotdeviceadvisor get-suite-run-report \
--suite-definition-id ztvb5aek4w4x \
--suite-run-id p6awv83nre6v
```
Ausgabe:
```
{
"qualificationReportDownloadUrl": "https://senate-apn-reports-us-east-1-prod.s3.amazonaws.com/report.downloadlink"
}
```
Weitere Informationen finden Sie unter [Abrufen eines Qualifizierungsberichts für eine erfolgreiche Ausführung der Qualifizierungstestsuite](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-qualification-report) im *Entwicklerhandbuch für AWS IoT Core*.
+ Einzelheiten zur API finden Sie [GetSuiteRunReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/get-suite-run-report.html)in der *AWS CLI Befehlsreferenz*.
### `get-suite-run`
Das folgende Codebeispiel zeigt die Verwendung`get-suite-run`.
**AWS CLI**
**So rufen Sie Informationen über den Ausführungsstatus einer Testsuite von IoT Device Advisor ab**
Im folgenden Beispiel für `get-suite-run` werden die Informationen über den Ausführungsstatus einer Testsuite von Device Advisor mit der angegebenen Suite-Definitions-ID und Suite-Ausführungs-ID abgerufen.
```
aws iotdeviceadvisor get-suite-run \
--suite-definition-id qqcsmtyyjabl \
--suite-run-id nzlfyhaa18oa
```
Ausgabe:
```
{
"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": {}
}
```
Weitere Informationen finden Sie unter [Abrufen einer Testsuite-Ausführung](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-describe-suite) im *Entwicklerhandbuch für AWS IoT Core*.
+ Einzelheiten zur API finden Sie [GetSuiteRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/get-suite-run.html)in der *AWS CLI Befehlsreferenz*.
### `list-suite-definitions`
Das folgende Codebeispiel zeigt die Verwendung`list-suite-definitions`.
**AWS CLI**
**Beispiel 1: So listen Sie die von Ihnen erstellten Testsuites von IoT Device Advisor auf**
Das folgende `list-suite-definitions` Beispiel listet bis zu 25 Device Advisor-Testsuiten auf, die Sie in AWS IoT erstellt haben. Wenn Sie mehr als 25 Testsuiten haben, wird „nextToken“ in der Ausgabe angezeigt. Sie können „nextToken“ verwenden, um den Rest der von Ihnen erstellten Testsuites anzuzeigen.
```
aws iotdeviceadvisor list-suite-definitions
```
Ausgabe:
```
{
"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"
}
```
**Beispiel 2: So listen Sie die Testsuites von IoT Device Advisor auf, die Sie mit den angegebenen Einstellungen erstellt haben**
Das folgende `list-suite-definitions` Beispiel listet Device Advisor-Testsuiten auf, die Sie in AWS IoT mit der angegebenen maximalen Ergebniszahl erstellt haben. Wenn die Zahl Ihrer Testsuites die maximale Anzahl übersteigt, wird „nextToken“ in der Ausgabe angezeigt. Wenn Sie „nextToken“ haben, können Sie den Wert verwenden, um die von Ihnen erstellten Testsuites anzuzeigen, die zuvor nicht angezeigt wurden.
```
aws iotdeviceadvisor list-suite-definitions \
--max-result 1 \
--next-token "nextTokenValue"
```
Ausgabe:
```
{
"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"
}
```
Weitere Informationen finden Sie [ListSuiteDefinitions](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_ListSuiteDefinitions.html)in der *AWS IoT-API-Referenz*.
+ Einzelheiten zur API finden Sie [ListSuiteDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/list-suite-definitions.html)in der *AWS CLI Befehlsreferenz*.
### `list-suite-runs`
Das folgende Codebeispiel zeigt die Verwendung`list-suite-runs`.
**AWS CLI**
**Beispiel 1: So listen Sie alle Informationen über den Ausführungsstatus der angegebenen Testsuite von IoT Device Advisor auf**
Im folgenden Beispiel für `list-suite-runs` werden alle Informationen über den Ausführungsstatus einer Testsuite von Device Advisor mit der angegebenen Suite-Definitions-ID aufgelistet. Wenn Sie mehr als 25 Testsuite-Ausführungen haben, wird „nextToken“ in der Ausgabe angezeigt. Sie können „nextToken“ verwenden, um die restlichen Testsuite-Ausführungen anzuzeigen.
```
aws iotdeviceadvisor list-suite-runs \
--suite-definition-id ztvb5aew4w4x
```
Ausgabe:
```
{
"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
}
]
}
```
**Beispiel 2: So listen Sie Informationen über den Ausführungsstatus der angegebenen Testsuite von IoT Device Advisor mit den angegebenen Einstellungen auf**
Im folgenden Beispiel für `list-suite-runs` werden Informationen über den Ausführungsstatus einer Testsuite von Device Advisor mit der angegebenen Suite-Definitions-ID und der angegebenen maximalen Ergebniszahl aufgelistet. Wenn die Zahl Ihrer Testsuite-Ausführungen die maximale Anzahl übersteigt, wird „nextToken“ in der Ausgabe angezeigt. Wenn Sie „nextToken“ haben, können Sie den Wert verwenden, um die Testsuite-Ausführungen anzuzeigen, die zuvor nicht angezeigt wurden.
```
aws iotdeviceadvisor list-suite-runs \
--suite-definition-id qqcsmtyyjaml \
--max-result 1 \
--next-token "nextTokenValue"
```
Ausgabe:
```
{
"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"
}
```
Weitere Informationen finden Sie [ListSuiteRuns](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_ListSuiteRuns.html)in der *AWS IoT-API-Referenz*.
+ Einzelheiten zur API finden Sie [ListSuiteRuns](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/list-suite-runs.html)in der *AWS CLI Befehlsreferenz*.
### `list-tags-for-resource`
Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`.
**AWS CLI**
**So listen Sie die Tags auf, die an eine Ressource von IoT Device Advisor angehängt sind**
Im folgenden Beispiel für `list-tags-for-resource` werden die Tags aufgelistet, die an eine Ressource von Device Advisor angehängt sind Die Ressource von Device Advisor kann ein Suite-Definitions-ARN oder ein Suite-Ausführungs-ARN sein.
```
aws iotdeviceadvisor list-tags-for-resource \
--resource-arn arn:aws:iotdeviceadvisor:us-east-1:123456789012:suitedefinition/ba0uyjpg38ny
```
Ausgabe:
```
{
"tags": {
"TestTagKey": "TestTagValue"
}
}
```
Weitere Informationen finden Sie [ListTagsForResource](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_ListTagsForResource.html)in der *AWS IoT-API-Referenz* und unter [Ressourcentypen, die von AWS IoT Core Device Advisor definiert wurden](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotcoredeviceadvisor.html#awsiotcoredeviceadvisor-resources-for-iam-policies), in der *Service Authorization Reference*.
+ Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*.
### `start-suite-run`
Das folgende Codebeispiel zeigt die Verwendung`start-suite-run`.
**AWS CLI**
**So starten Sie die Ausführung einer Testsuite von IoT Device Advisor**
Das folgende `start-suite-run` Beispiel listet die verfügbaren Widgets in Ihrem AWS Konto auf.
```
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"}}'
```
Ausgabe:
```
{
"suiteRunId": "pwmucgw7lt9s",
"suiteRunArn": "arn:aws:iotdeviceadvisor:us-east-1:123456789012:suiterun/qqcsmtyyjabl/pwmucgw7lk9s",
"createdAt": "2022-12-02T15:43:05.581000-05:00"
}
```
Weitere Informationen finden Sie unter [Starten einer Testsuite-Ausführung](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-start-suite-run) im *Entwicklerhandbuch für AWS IoT Core*.
+ Einzelheiten zur API finden Sie [StartSuiteRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/start-suite-run.html)in der *AWS CLI Befehlsreferenz*.
### `stop-suite-run`
Das folgende Codebeispiel zeigt die Verwendung`stop-suite-run`.
**AWS CLI**
**So beenden Sie eine Testsuite von IoT Device Advisor, die gerade ausgeführt wird**
Im folgenden Beispiel für `stop-suite-run` wird eine Testsuite von Device Advisor mit der angegebenen Suite-Definitions-ID und Suite-Ausführungs-ID, die derzeit ausgeführt wird, beendet.
```
aws iotdeviceadvisor stop-suite-run \
--suite-definition-id qqcsmtyyjabl \
--suite-run-id nzlfyhaa18oa
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Beenden einer Testsuite-Ausführung](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-workflow.html#device-advisor-workflow-stop-suite-run) im *Entwicklerhandbuch für AWS IoT Core*.
+ Einzelheiten zur API finden Sie [StopSuiteRun](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/stop-suite-run.html)in der *AWS CLI Befehlsreferenz*.
### `tag-resource`
Das folgende Codebeispiel zeigt die Verwendung`tag-resource`.
**AWS CLI**
**So fügen Sie die vorhandenen Tags einer Ressource von IoT Device Advisor hinzu und ändern sie**
Im folgenden Beispiel für `tag-resource` werden die vorhandenen Tags einer Ressource von Device Advisor mit dem angegebenen Ressourcen-ARN und den angegebenen Tags hinzugefügt und geändert. Die Ressource von Device Advisor kann ein Suite-Definitions-ARN oder ein Suite-Ausführungs-ARN sein.
```
aws iotdeviceadvisor tag-resource \
--resource-arn arn:aws:iotdeviceadvisor:us-east-1:123456789012:suitedefinition/ba0uyjpg38ny \
--tags '{"TagKey": "TagValue"}'
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie [TagResource](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_TagResource.html)in der *AWS IoT-API-Referenz* und unter [Ressourcentypen, die von AWS IoT Core Device Advisor definiert wurden](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotcoredeviceadvisor.html#awsiotcoredeviceadvisor-resources-for-iam-policies), in der *Service Authorization Reference*.
+ Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/tag-resource.html)in der *AWS CLI Befehlsreferenz*.
### `untag-resource`
Das folgende Codebeispiel zeigt die Verwendung`untag-resource`.
**AWS CLI**
**So entfernen Sie die vorhandenen Tags aus einer Ressource von IoT Device Advisor**
Im folgenden Beispiel für `untag-resource` werden die vorhandenen Tags aus einer Ressource von Device Advisor mit dem angegebenen Ressourcen-ARN und den angegebenen Tags entfernt. Die Ressource von Device Advisor kann ein Suite-Definitions-ARN oder ein Suite-Ausführungs-ARN sein.
```
aws iotdeviceadvisor untag-resource \
--resource-arn arn:aws:iotdeviceadvisor:us-east-1:123456789012:suitedefinition/ba0uyjpg38ny \
--tag-keys "TagKey"
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie [UntagResource](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_UntagResource.html)in der *AWS IoT-API-Referenz* und unter [Ressourcentypen, die von AWS IoT Core Device Advisor definiert wurden](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotcoredeviceadvisor.html#awsiotcoredeviceadvisor-resources-for-iam-policies), in der *Service Authorization Reference*.
+ Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/untag-resource.html)in der *AWS CLI Befehlsreferenz*.
### `update-suite-definition`
Das folgende Codebeispiel zeigt die Verwendung`update-suite-definition`.
**AWS CLI**
**Beispiel 1: So aktualisieren Sie eine Testsuite für IoT Device Advisor**
Das folgende `update-suite-definition` Beispiel aktualisiert eine Device Advisor-Testsuite im AWS IoT mit der angegebenen Suite-Definition-ID und der Suite-Definitionskonfiguration.
```
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"}'
```
Ausgabe:
```
{
"suiteDefinitionId": "3hsn88h4p2g5",
"suiteDefinitionName": "TestSuiteName",
"suiteDefinitionVersion": "v3",
"createdAt": "2022-11-17T14:15:56.830000-05:00",
"lastUpdatedAt": "2022-12-02T16:02:45.857000-05:00"
}
```
**Beispiel 2: So aktualisieren Sie eine Qualifizierungs-Testsuite für IoT Device Advisor**
Im folgenden `update-suite-definition` Beispiel wird eine Device Advisor-Qualifizierungstestsuite im AWS IoT mit der angegebenen Suite-Definition-ID und der Suite-Definitionskonfiguration aktualisiert.
```
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"}'
```
Ausgabe:
```
{
"suiteDefinitionId": "txgsuolk2myj",
"suiteDefinitionName": "TestSuiteName",
"suiteDefinitionVersion": "v3",
"createdAt": "2022-11-17T14:15:56.830000-05:00",
"lastUpdatedAt": "2022-12-02T16:02:45.857000-05:00"
}
```
Weitere Informationen finden Sie [UpdateSuiteDefinition](https://docs.aws.amazon.com/iot/latest/apireference/API_iotdeviceadvisor_UpdateSuiteDefinition.html)in der *AWS IoT-API-Referenz*.
+ Einzelheiten zur API finden Sie [UpdateSuiteDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotdeviceadvisor/update-suite-definition.html)in der *AWS CLI Befehlsreferenz*.