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.
# AWS Snowball Edge Device Management Zur Verwaltung von Snowball Edge verwenden
AWS Snowball Edge Device Management ermöglicht es Ihnen, Ihren Snowball Edge und lokale AWS Dienste remote zu verwalten. Alle Snowball Edge-Geräte unterstützen die Snowball Edge-Geräteverwaltung und sie wird auf neuen Geräten in den meisten Ländern installiert, in AWS-Regionen denen Snowball Edge verfügbar ist.
Mit Snowball Edge Device Management können Sie die folgenden Aufgaben ausführen:
+ Erstellen Sie eine Aufgabe
+ Überprüfen Sie den Status der Aufgabe
+ Überprüfen Sie die Metadaten der Aufgabe
+ Stornieren Sie eine Aufgabe
+ Überprüfen Sie die Geräteinformationen
+ Überprüfen Sie den EC2 Amazon-kompatiblen Instanzstatus
+ Befehle und Syntax auflisten
+ Listet Geräte auf, die per Fernzugriff verwaltet werden können
+ Listet den Aufgabenstatus geräteübergreifend auf
+ Verfügbare Ressourcen auflisten
+ Aufgaben nach Status auflisten
+ Geräte- oder Aufgaben-Tags auflisten
+ Stichwörter anwenden
+ Tags entfernen
**Topics**
+ [Auswahl des Snowball Edge-Geräteverwaltungsstatus bei der Bestellung eines Snowball Edge](#order-device-sdm-state)
+ [Aktivieren der Snowball Edge-Geräteverwaltung auf einem Snowball Edge](#enable-sdm)
+ [Hinzufügen von Berechtigungen für Snowball Edge Device Management zu einer IAM-Rolle auf einem Snowball Edge](#iam-sdm)
+ [CLI-Befehle für die Snowball Edge-Geräteverwaltung](#sdm-cli-commands)
## Auswahl des Snowball Edge-Geräteverwaltungsstatus bei der Bestellung eines Snowball Edge
Wenn Sie einen Auftrag zur Bestellung eines Snow-Geräts erstellen, können Sie wählen, in welchem Status sich Snowball Edge Device Management bei Erhalt des Geräts befinden soll: installiert, aber nicht aktiviert oder installiert und aktiviert. Wenn es installiert, aber nicht aktiviert ist, müssen Sie den Snowball Edge-Client verwenden AWS OpsHub , um es zu aktivieren, bevor Sie es verwenden können. Wenn es installiert und aktiviert ist, können Sie Snowball Edge Device Management verwenden, nachdem Sie das Gerät erhalten und es mit Ihrem lokalen Netzwerk verbunden haben. Sie können den Snowball Edge-Geräteverwaltungsstatus wählen, wenn Sie einen Auftrag erstellen Managementkonsole für die AWS Snow-Familie, um ein Gerät über den Snowball Edge-Client AWS CLI, die oder die Snow Job Management API zu bestellen.
**Um den Snowball Edge-Geräteverwaltungsstatus aus dem Managementkonsole für die AWS Snow-Familie**
1. Um zu entscheiden, ob Snowball Edge-Geräteverwaltung installiert und aktiviert werden soll, wählen Sie **Ihr Snow-Gerät remote mit AWS OpsHub oder Snowball-Client verwalten**.
1. Wenn Sie festlegen möchten, dass Snowball Edge-Geräteverwaltung installiert, aber nicht aktiviert wird, wählen Sie **Ihr Snow-Gerät nicht remote mit AWS OpsHub oder dem Snowball-Client verwalten** aus.
Weitere Informationen finden Sie unter [Schritt 3: Wählen Sie Ihre Funktionen und Optionen](https://docs.aws.amazon.com/snowball/latest/developer-guide/import-job-details.html) in diesem Handbuch.
**So wählen Sie den Snowball Edge-Geräteverwaltungsstatus aus der AWS CLI Snowball Edge-Client- oder Snow-Job-Management-API aus:**
+ Verwenden Sie den `remote-management` Parameter, um den Snowball Edge-Geräteverwaltungsstatus anzugeben. Der `INSTALLED_ONLY` Wert des Parameters bedeutet, dass Snowball Edge Device Management installiert, aber nicht aktiviert ist. Der `INSTALLED_AUTOSTART` Wert des Parameters bedeutet, dass Snowball Edge Device Management installiert und aktiviert ist. Wenn Sie keinen Wert für diesen Parameter angeben, `INSTALLED_ONLY` ist dies der Standardwert.
**Example der Syntax des `remote-management` Parameters des `create-job` Befehls**
```
aws snowball create-job \
--job-type IMPORT \
--remote-management INSTALLED_AUTOSTART
--device-configuration '{"SnowconeDeviceConfiguration": {"WirelessConnection": {"IsWifiEnabled": false} } }' \
--resources '{"S3Resources":[{"BucketArn":"arn:aws:s3:::bucket-name"}]}' \
--description "Description here" \
--address-id ADID00000000-0000-0000-0000-000000000000 \
--kms-key-arn arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab \
--role-arn arn:aws:iam::000000000000:role/SnowconeImportGamma \
--snowball-capacity-preference T8 \
--shipping-option NEXT_DAY \
--snowball-type SNC1_HDD \
--region us-west-2 \
```
Weitere Informationen finden Sie unter [Job Management API Reference](https://docs.aws.amazon.com/snowball/latest/api-reference/api-reference.html) in der AWS Snowball Edge API-Referenz.
## Aktivieren der Snowball Edge-Geräteverwaltung auf einem Snowball Edge
Gehen Sie wie folgt vor, um die Snowball Edge-Geräteverwaltung mit dem Snowball Edge-Client zu aktivieren.
Bevor Sie dieses Verfahren verwenden, gehen Sie wie folgt vor:
+ Laden Sie die neueste Version des Snowball Edge-Clients herunter und installieren Sie sie. Weitere Informationen finden Sie unter [Snowball-Client herunterladen und installieren](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client.html#download-client).
+ Laden Sie die Manifestdatei herunter und rufen Sie den Entsperrcode für das Snowball Edge-Gerät ab. Weitere Informationen finden Sie unter [Abrufen Ihrer Anmeldeinformationen und Tools](https://docs.aws.amazon.com/snowball/latest/developer-guide/get-credentials.html).
+ Connect das Snowball Edge-Gerät mit Ihrem lokalen Netzwerk. Weitere Informationen finden Sie unter für [die Verbindung mit Ihrem lokalen Netzwerk](https://docs.aws.amazon.com/snowball/latest/developer-guide/getting-started-connect.html).
+ Entsperren Sie das Snowball Edge-Gerät. Weitere Informationen finden Sie unter [Snowball Edge entsperren](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html) Lokales .
```
snowballEdge set-features /
--remote-management-state INSTALLED_AUTOSTART /
--manifest-file JID1717d8cc-2dc9-4e68-aa46-63a3ad7927d2_manifest.bin /
--unlock-code 7c0e1-bab84-f7675-0a2b6-f8k33 /
--endpoint https://192.0.2.0:9091
```
Der Snowball Edge-Client gibt Folgendes zurück, wenn der Befehl erfolgreich ist.
```
{
"RemoteManagementState" : "INSTALLED_AUTOSTART"
}
```
## Hinzufügen von Berechtigungen für Snowball Edge Device Management zu einer IAM-Rolle auf einem Snowball Edge
Erstellen Sie auf dem Gerät, von dem AWS-Konto aus das Gerät bestellt wurde, eine AWS Identity and Access Management (IAM-) Rolle und fügen Sie der Rolle die folgende Richtlinie hinzu. Weisen Sie die Rolle dann dem IAM-Benutzer zu, der sich anmeldet, um Ihr Gerät mit Snowball Edge Device Management remote zu verwalten. Weitere Informationen finden Sie unter [Erstellen von IAM-Rollen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) und [Erstellen eines IAM-Benutzers](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html) in Ihrem. AWS-Konto
**Richtlinie**
------
#### [ JSON ]
****
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"snow-device-management:ListDevices",
"snow-device-management:DescribeDevice",
"snow-device-management:DescribeDeviceEc2Instances",
"snow-device-management:ListDeviceResources",
"snow-device-management:CreateTask",
"snow-device-management:ListTasks",
"snow-device-management:DescribeTask",
"snow-device-management:CancelTask",
"snow-device-management:DescribeExecution",
"snow-device-management:ListExecutions",
"snow-device-management:ListTagsForResource",
"snow-device-management:TagResource",
"snow-device-management:UntagResource"
],
"Resource": "*"
}
]
}
```
------
## CLI-Befehle für die Snowball Edge-Geräteverwaltung
In diesem Abschnitt AWS CLI werden die Befehle beschrieben, mit denen Sie Ihren Snowball Edge mit Snowball Edge Device Management remote verwalten können. Sie können einige Fernverwaltungsaufgaben auch mithilfe von ausführen. AWS OpsHub Weitere Informationen finden Sie unter [verwalten AWS Dienste auf Ihrem Gerät](https://docs.aws.amazon.com/snowball/latest/developer-guide/manage-services.html) verwalten.
**Anmerkung**
Stellen Sie vor der Verwaltung Ihres Geräts sicher, dass es eingeschaltet und mit Ihrem Netzwerk verbunden ist und eine Verbindung zu dem Gerät herstellen kann, auf AWS-Region dem es bereitgestellt wurde.
**Topics**
+ [Eine Aufgabe zur Verwaltung eines Snowball Edge mit Snowball Edge Device Management erstellen](#sdm-cli-create-task)
+ [Überprüfen des Status einer Aufgabe zur Verwaltung eines Snowball Edge](#sdm-cli-describe-execution)
+ [Informationen zu einem Snowball Edge mithilfe von Snowball Edge Device Management überprüfen](#sdm-cli-describe-device)
+ [Status von EC2 Amazon-kompatiblen Instances auf Snowball Edge mit Snowball Edge Device Management überprüfen](#sdm-cli-describe-ec2-instances)
+ [Aufgabenmetadaten auf Snowball Edge mit Snowball Edge Device Management anzeigen](#sdm-cli-describe-task)
+ [Abbrechen einer Aufgabe auf einem Snowball Edge mit Snowball Edge Device Management](#sdm-cli-cancel-task)
+ [Befehle und Syntax der Snowball Edge-Geräteverwaltung auflisten](#sdm-cli-help)
+ [Snowball Edge auflisten, die für die Fernverwaltung verfügbar sind](#sdm-cli-list-devices)
+ [Status von Snowball Edge-Geräteverwaltungsaufgaben in Snowball Edge auflisten](#sdm-cli-list-executions)
+ [Auflisten verfügbarer Ressourcen auf Snowball Edge mit Snowball Edge Device Management](#sdm-cli-list-device-resources)
+ [Tags für Snowball Edge- oder Snowball Edge-Gerätemanagement-Tags auflisten](#sdm-cli-list-tags-for-resource)
+ [Snowball Edge-Geräteverwaltungsaufgaben nach Status auflisten](#sdm-cli-list-tasks)
+ [Anwenden von Tags auf Snowball Edge-Geräteverwaltungsaufgaben oder Snowball Edge](#sdm-cli-tag-resource)
+ [Snowball Edge-Gerätemanagement-Tags aus Aufgaben oder Snowball Edge entfernen](#sdm-cli-untag-resources)
### Eine Aufgabe zur Verwaltung eines Snowball Edge mit Snowball Edge Device Management erstellen
Um ein oder mehrere Zielgeräte anzuweisen, eine Aufgabe auszuführen, wie z. B. das Entsperren oder Neustarten, verwenden Sie. `create-task` Sie geben Zielgeräte an, indem Sie eine Liste der verwalteten Geräte IDs mit dem `--targets` Parameter angeben und die Aufgaben angeben, die mit dem Parameter ausgeführt werden sollen. `--command` Auf einem Gerät kann jeweils nur ein einziger Befehl ausgeführt werden.
Unterstützte Befehle:
+ `unlock`(keine Argumente)
+ `reboot`(keine Argumente)
Verwenden Sie den folgenden Befehl, um eine Aufgabe zu erstellen, die von den Zielgeräten ausgeführt werden soll. Ersetzen Sie jeden `user input placeholder` durch Ihre Informationen.
**Befehl**
```
aws snow-device-management create-task
--targets smd-fictbgr3rbcjeqa5
--command reboot={}
```
**Ausnahmen**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
ServiceQuotaExceededException
```
**Ausgabe**
```
{
"taskId": "st-ficthmqoc2pht111",
"taskArn": "arn:aws:snow-device-management:us-west-2:000000000000:task/st-cjkwhmqoc2pht111"
}
```
### Überprüfen des Status einer Aufgabe zur Verwaltung eines Snowball Edge
Verwenden Sie den `describe-execution` Befehl, um den Status einer Remote-Aufgabe zu überprüfen, die auf einem oder mehreren Zielgeräten ausgeführt wird.
Eine Aufgabe kann einen der folgenden Status haben:
+ `QUEUED`
+ `IN_PROGRESS`
+ `CANCELED`
+ `FAILED`
+ `COMPLETED`
+ `REJECTED`
+ `TIMED_OUT`
Verwenden Sie den folgenden Befehl, um den Status einer Aufgabe zu überprüfen. Ersetzen Sie jeden `user input placeholder` durch Ihre Informationen.
**Befehl**
```
aws snow-device-management describe-execution \
--taskId st-ficthmqoc2phtlef \
--managed-device-id smd-fictqic6gcldf111
```
**Ausgabe**
```
{
"executionId": "1",
"lastUpdatedAt": "2021-07-22T15:29:44.110000+00:00",
"managedDeviceId": "smd-fictqic6gcldf111",
"startedAt": "2021-07-22T15:28:53.947000+00:00",
"state": "SUCCEEDED",
"taskId": "st-ficthmqoc2pht111"
}
```
### Informationen zu einem Snowball Edge mithilfe von Snowball Edge Device Management überprüfen
Verwenden Sie den Befehl, um gerätespezifische Informationen wie Gerätetyp, Softwareversion, IP-Adressen und Sperrstatus zu überprüfen. `describe-device` Die Ausgabe umfasst außerdem Folgendes:
+ `lastReachedOutAt`— Wann das Gerät das letzte Mal Kontakt mit dem aufgenommen hat AWS Cloud. Zeigt an, dass das Gerät online ist.
+ `lastUpdatedAt`— Wann die Daten auf dem Gerät zuletzt aktualisiert wurden. Zeigt an, wann der Geräte-Cache aktualisiert wurde.
Verwenden Sie den folgenden Befehl, um die Geräteinformationen zu überprüfen. Ersetzen Sie jeden `user input placeholder` durch Ihre Informationen.
**Befehl**
```
aws snow-device-management describe-device \
--managed-device-id smd-fictqic6gcldf111
```
**Ausnahmen**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```
### Status von EC2 Amazon-kompatiblen Instances auf Snowball Edge mit Snowball Edge Device Management überprüfen
Verwenden Sie den `describe-ec2-instances` Befehl, um den aktuellen Status der EC2 Amazon-Instance zu überprüfen. Die Ausgabe ähnelt der des `describe-device` Befehls, die Ergebnisse stammen jedoch aus dem Geräte-Cache im AWS Cloud und enthalten eine Teilmenge der verfügbaren Felder.
Verwenden Sie den folgenden Befehl, um den Status der Amazon EC2 -kompatiblen Instance zu überprüfen. Ersetzen Sie jeden `user input placeholder` durch Ihre Informationen.
**Befehl**
```
aws snow-device-management describe-device-ec2-instances \
--managed-device-id smd-fictbgr3rbcje111 \
--instance-ids s.i-84fa8a27d3e15e111
```
**Ausnahmen**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Ausgabe**
```
{
"instances": [
{
"instance": {
"amiLaunchIndex": 0,
"blockDeviceMappings": [
{
"deviceName": "/dev/sda",
"ebs": {
"attachTime": "2021-07-23T15:25:38.719000-07:00",
"deleteOnTermination": true,
"status": "ATTACHED",
"volumeId": "s.vol-84fa8a27d3e15e111"
}
}
],
"cpuOptions": {
"coreCount": 1,
"threadsPerCore": 1
},
"createdAt": "2021-07-23T15:23:22.858000-07:00",
"imageId": "s.ami-03f976c3cadaa6111",
"instanceId": "s.i-84fa8a27d3e15e111",
"state": {
"name": "RUNNING"
},
"instanceType": "snc1.micro",
"privateIpAddress": "34.223.14.193",
"publicIpAddress": "10.111.60.160",
"rootDeviceName": "/dev/sda",
"securityGroups": [
{
"groupId": "s.sg-890b6b4008bdb3111",
"groupName": "default"
}
],
"updatedAt": "2021-07-23T15:29:42.163000-07:00"
},
"lastUpdatedAt": "2021-07-23T15:29:58.
071000-07:00"
}
]
}
```
### Aufgabenmetadaten auf Snowball Edge mit Snowball Edge Device Management anzeigen
Verwenden Sie den `describe-task` Befehl, um die Metadaten für eine bestimmte Aufgabe auf einem Gerät zu überprüfen. Die Metadaten für eine Aufgabe umfassen die folgenden Elemente:
+ Die Zielgeräte
+ Der Status der Aufgabe
+ Wann die Aufgabe erstellt wurde
+ Wann wurden die Daten auf dem Gerät zuletzt aktualisiert
+ Wann wurde die Aufgabe abgeschlossen
+ Die Beschreibung (falls vorhanden), die bei der Erstellung der Aufgabe angegeben wurde
Verwenden Sie den folgenden Befehl, um die Metadaten einer Aufgabe zu überprüfen. Ersetzen Sie jeden `user input placeholder` durch Ihre Informationen.
**Befehl**
```
aws snow-device-management describe-task \
--task-id st-ficthmqoc2pht111
```
**Ausnahmen**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Ausgabe**
```
{
"completedAt": "2021-07-22T15:29:46.758000+00:00",
"createdAt": "2021-07-22T15:28:42.613000+00:00",
"lastUpdatedAt": "2021-07-22T15:29:46.758000+00:00",
"state": "COMPLETED",
"tags": {},
"targets": [
"smd-fictbgr3rbcje111"
],
"taskId": "st-ficthmqoc2pht111",
"taskArn": "arn:aws:snow-device-management:us-west-2:000000000000:task/st-ficthmqoc2pht111"
}
```
### Abbrechen einer Aufgabe auf einem Snowball Edge mit Snowball Edge Device Management
Verwenden Sie den Befehl, um eine Stornierungsanfrage für eine bestimmte Aufgabe zu senden. `cancel-task` Sie können nur Aufgaben in dem `QUEUED` Status stornieren, die noch nicht ausgeführt wurden. Aufgaben, die bereits ausgeführt werden, können nicht storniert werden.
**Anmerkung**
Eine Aufgabe, die Sie abbrechen möchten, wird möglicherweise trotzdem ausgeführt, wenn sie aus der Warteschlange bearbeitet wird, bevor der `cancel-task` Befehl den Status der Aufgabe ändert.
Verwenden Sie den folgenden Befehl, um eine Aufgabe abzubrechen. Ersetzen Sie jeden `user input placeholder` durch Ihre Informationen.
**Befehl**
```
aws snow-device-management cancel-task \
--task-id st-ficthmqoc2pht111
```
**Ausnahmen**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Ausgabe**
```
{
"taskId": "st-ficthmqoc2pht111"
}
```
### Befehle und Syntax der Snowball Edge-Geräteverwaltung auflisten
Verwenden Sie den `help` Befehl, um eine Liste aller unterstützten Befehle für die Snowball Edge-Geräteverwaltungs-API zurückzugeben. Sie können den `help` Befehl auch verwenden, um detaillierte Informationen zu und die Syntax für einen bestimmten Befehl zurückzugeben.
Verwenden Sie den folgenden Befehl, um alle unterstützten Befehle aufzulisten.
**Befehl**
```
aws snow-device-management help
```
Verwenden Sie den folgenden Befehl, um detaillierte Informationen und die Syntax für einen Befehl zurückzugeben. `command`Ersetzen Sie ihn durch den Namen des Befehls, an dem Sie interessiert sind.
**Befehl**
```
aws snow-device-management command help
```
### Snowball Edge auflisten, die für die Fernverwaltung verfügbar sind
Verwenden Sie den Befehl, um eine Liste aller Geräte in Ihrem Konto zurückzugeben, auf denen Snowball Edge-Geräteverwaltung aktiviert ist, AWS-Region wo der `list-devices` Befehl ausgeführt wird. `--max-results`und `--next-token` sind optional. Weitere Informationen finden Sie unter [Verwenden von AWS CLI Paginierungsoptionen](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) im "Benutzerhandbuch für die AWS Befehlszeilenschnittstelle“.
Verwenden Sie den folgenden Befehl, um Geräte aufzulisten, die per Fernzugriff verwaltet werden können. Ersetzen Sie jeden `user input placeholder` durch Ihre Informationen.
**Befehl**
```
aws snow-device-management list-devices \
--max-results 10
```
**Ausnahmen**
```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Ausgabe**
```
{
"devices": [
{
"associatedWithJob": "ID2bf11d5a-ea1e-414a-b5b1-3bf7e6a6e111",
"managedDeviceId": "smd-fictbgr3rbcjeqa5",
"managedDeviceArn": "arn:aws:snow-device-management:us-west-2:000000000000:managed-device/smd-fictbgr3rbcje111"
"tags": {}
}
]
}
```
### Status von Snowball Edge-Geräteverwaltungsaufgaben in Snowball Edge auflisten
Verwenden Sie den `list-executions` Befehl, um den Status von Aufgaben für ein oder mehrere Zielgeräte zurückzugeben. Verwenden Sie den `--state` Parameter, um die Rückgabeliste so zu filtern, dass Aufgaben angezeigt werden, die sich derzeit in einem bestimmten Status befinden. `--max-results`und `--next-token` sind optional. Weitere Informationen finden Sie unter [Verwenden von AWS CLI Paginierungsoptionen](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) im "Benutzerhandbuch für die AWS Befehlszeilenschnittstelle“.
Eine Aufgabe kann einen der folgenden Status haben:
+ `QUEUED`
+ `IN_PROGRESS`
+ `CANCELED`
+ `FAILED`
+ `COMPLETED`
+ `REJECTED`
+ `TIMED_OUT`
Verwenden Sie den folgenden Befehl, um den Aufgabenstatus geräteübergreifend aufzulisten. Ersetzen Sie jeden `user input placeholder` durch Ihre Informationen.
**Befehl**
```
aws snow-device-management list-executions \
--taskId st-ficthmqoc2phtlef \
--state SUCCEEDED \
--max-results 10
```
**Ausnahmen**
```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Ausgabe**
```
{
"executions": [
{
"executionId": "1",
"managedDeviceId": "smd-fictbgr3rbcje111",
"state": "SUCCEEDED",
"taskId": "st-ficthmqoc2pht111"
}
]
}
```
### Auflisten verfügbarer Ressourcen auf Snowball Edge mit Snowball Edge Device Management
Verwenden Sie den `list-device-resources` Befehl, um eine Liste der für ein Gerät verfügbaren AWS Ressourcen zurückzugeben. Verwenden Sie den `--type` Parameter, um die Liste nach einem bestimmten Ressourcentyp zu filtern. Derzeit sind EC2 Amazon-kompatible Instances der einzige unterstützte Ressourcentyp. `--max-results`und `--next-token` sind optional. Weitere Informationen finden Sie unter [Verwenden von AWS CLI Paginierungsoptionen](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) im "Benutzerhandbuch für die AWS Befehlszeilenschnittstelle“.
Verwenden Sie den folgenden Befehl, um die verfügbaren Ressourcen für ein Gerät aufzulisten. Ersetzen Sie jeden `user input placeholder` durch Ihre Informationen.
**Befehl**
```
aws snow-device-management list-device-resources \
--managed-device-id smd-fictbgr3rbcje111 \
--type AWS::EC2::Instance
--next-token YAQGPwAT9l3wVKaGYjt4yS34MiQLWvzcShe9oIeDJr05AT4rXSprqcqQhhBEYRfcerAp0YYbJmRT=
--max-results 10
```
**Ausnahmen**
```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Ausgabe**
```
{
"resources": [
{
"id": "s.i-84fa8a27d3e15e111",
"resourceType": "AWS::EC2::Instance"
}
]
}
```
### Tags für Snowball Edge- oder Snowball Edge-Gerätemanagement-Tags auflisten
Verwenden Sie den `list-tags-for-resource` Befehl, um eine Liste von Tags für ein verwaltetes Gerät oder eine verwaltete Aufgabe zurückzugeben.
Verwenden Sie den folgenden Befehl, um die Tags für ein Gerät aufzulisten. Ersetzen Sie das Beispiel Amazon Resource Name (ARN) durch den ARN für Ihr Gerät.
**Befehl**
```
aws snow-device-management list-tags-for-resource
--resource-arn arn:aws:snow-device-management:us-west-2:123456789012:managed-device/smd-fictbgr3rbcjeqa5
```
**Ausnahmen**
```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```
**Ausgabe**
```
{
"tags": {
"Project": "PrototypeA"
}
}
```
### Snowball Edge-Geräteverwaltungsaufgaben nach Status auflisten
Verwenden Sie den `list-tasks` Befehl, um eine Liste der Aufgaben von den Geräten in der AWS Region zurückzugeben, in der der Befehl ausgeführt wird. Verwenden Sie den `--state` Parameter`IN_PROGRESS`, um die Ergebnisse nach`COMPLETED`, oder `CANCELED` Status zu filtern. `--max-results`und `--next-token` sind optional. Weitere Informationen finden Sie unter [Verwenden von AWS CLI Paginierungsoptionen](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) im "Benutzerhandbuch für die AWS Befehlszeilenschnittstelle“.
Verwenden Sie den folgenden Befehl, um Aufgaben nach Status aufzulisten. Ersetzen Sie jeden `user input placeholder` durch Ihre Informationen.
**Befehl**
```
aws snow-device-management list-tasks \
--state IN_PROGRESS \
--next-token K8VAMqKiP2Cf4xGkmH8GMyZrgOF8FUb+d1OKTP9+P4pUb+8PhW+6MiXh4= \
--max-results 10
```
**Ausnahmen**
```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Ausgabe**
```
{
"tasks": [
{
"state": "IN_PROGRESS",
"tags": {},
"taskId": "st-ficthmqoc2phtlef",
"taskArn": "arn:aws:snow-device-management:us-west-2:000000000000:task/st-ficthmqoc2phtlef"
}
]
}
```
### Anwenden von Tags auf Snowball Edge-Geräteverwaltungsaufgaben oder Snowball Edge
Verwenden Sie den `tag-resource` Befehl, um ein Tag für ein Gerät oder für eine Aufgabe auf einem Gerät hinzuzufügen oder zu ersetzen. Der `--tags` Parameter akzeptiert eine durch Kommas getrennte Liste von `Key=Value` Paaren.
Verwenden Sie den folgenden Befehl, um Tags auf ein Gerät anzuwenden. Ersetzen Sie jeden `user input placeholder` durch Ihre Informationen.
**Befehl**
```
aws snow-device-management tag-resource \
--resource-arn arn:aws:snow-device-management:us-west-2:123456789012:managed-device/smd-fictbgr3rbcjeqa5 \
--tags Project=PrototypeA
```
**Ausnahmen**
```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```
### Snowball Edge-Gerätemanagement-Tags aus Aufgaben oder Snowball Edge entfernen
Verwenden Sie den `untag-resources` Befehl, um ein Tag von einem Gerät oder von einer Aufgabe auf einem Gerät zu entfernen.
Verwenden Sie den folgenden Befehl, um Tags von einem Gerät zu entfernen. Ersetzen Sie jeden `user input placeholder` durch Ihre Informationen.
**Befehl**
```
aws snow-device-management untag-resources \
--resource-arn arn:aws:snow-device-management:us-west-2:123456789012:managed-device/smd-fictbgr3rbcjeqa5 \
--tag-keys Project
```
**Ausnahmen**
```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```