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.
# Utilisation AWS Snowball Edge Device Management pour gérer Snowball Edge
AWS Snowball Edge Device Management vous permet de gérer votre Snowball Edge et les AWS services locaux à distance. Tous les Snowball Edge prennent en charge la gestion des appareils Snowball Edge et sont installés sur les nouveaux appareils de la plupart des appareils sur lesquels Régions AWS Snowball Edge est disponible.
Avec Snowball Edge Device Management, vous pouvez effectuer les tâches suivantes :
+ Création d'une tâche
+ Vérifier l'état de la tâche
+ Vérifier les métadonnées des tâches
+ Annuler une tâche
+ Vérifiez les informations de l'appareil
+ Vérifiez l'état de l'instance EC2 compatible avec Amazon
+ Commandes de liste et syntaxe
+ Répertorier les appareils administrables à distance
+ Afficher l'état des tâches sur tous les appareils
+ Liste des ressources disponibles
+ Répertorier les tâches par statut
+ Répertorier les tags des appareils ou des tâches
+ Appliquer des balises
+ Supprimer les tags
**Topics**
+ [Choix de l'état de gestion des appareils Snowball Edge lors de la commande d'un Snowball Edge](#order-device-sdm-state)
+ [Activation de la gestion des appareils Snowball Edge sur un Snowball Edge](#enable-sdm)
+ [Ajout d'autorisations pour la gestion des appareils Snowball Edge à un rôle IAM sur un Snowball Edge](#iam-sdm)
+ [Commandes CLI de gestion des périphériques Snowball Edge](#sdm-cli-commands)
## Choix de l'état de gestion des appareils Snowball Edge lors de la commande d'un Snowball Edge
Lorsque vous créez une tâche pour commander un appareil Snow, vous pouvez choisir l'état dans lequel se trouvera Snowball Edge Device Management lorsque vous recevrez l'appareil : installé mais non activé ou installé et activé. S'il est installé mais qu'il n'est pas activé, vous devrez utiliser AWS OpsHub le client Snowball Edge pour l'activer avant de l'utiliser. S'il est installé et activé, vous pouvez utiliser Snowball Edge Device Management après avoir reçu l'appareil et l'avoir connecté à votre réseau local. Vous pouvez choisir l'état Snowball Edge Device Management lors de la création d'une tâche afin de commander un appareil par le biais du client Snowball Edge AWS Snow Family Management Console, de l'API de gestion des tâches ou de l' AWS CLI API Snow.
**Pour choisir l'état de gestion des appareils Snowball Edge dans AWS Snow Family Management Console**
1. Pour choisir d'installer et d'activer Snowball Edge Device Management, choisissez **Gérer votre appareil Snow à distance avec ou avec le client AWS OpsHub Snowball**.
1. Pour choisir d'installer Snowball Edge Device Management mais de ne pas l'activer, ne sélectionnez pas **Gérer votre appareil Snow à distance avec le client AWS OpsHub Snowball**.
Pour plus d'informations, voir [Étape 3 : Choisissez vos fonctionnalités et options](https://docs.aws.amazon.com/snowball/latest/developer-guide/import-job-details.html) dans ce guide.
**Pour choisir l'état de gestion des appareils Snowball Edge à partir du client AWS CLI Snowball Edge ou de l'API de gestion des tâches Snow, procédez comme suit :**
+ Utilisez le `remote-management` paramètre pour spécifier l'état de gestion des appareils Snowball Edge. La `INSTALLED_ONLY` valeur du paramètre signifie que Snowball Edge Device Management est installé mais n'est pas activé. La `INSTALLED_AUTOSTART` valeur du paramètre signifie que Snowball Edge Device Management est installé et activé. Si vous ne spécifiez aucune valeur pour ce paramètre, `INSTALLED_ONLY` c'est la valeur par défaut.
**Example de la syntaxe du `remote-management` paramètre de la `create-job` commande**
```
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 \
```
Pour plus d'informations, consultez la section [Référence de l'API Job Management](https://docs.aws.amazon.com/snowball/latest/api-reference/api-reference.html) dans la Référence des AWS Snowball Edge API.
## Activation de la gestion des appareils Snowball Edge sur un Snowball Edge
Suivez cette procédure pour activer la gestion des appareils Snowball Edge à l'aide du client Snowball Edge.
Avant d'utiliser cette procédure, procédez comme suit :
+ Téléchargez et installez la dernière version du client Snowball Edge. Pour plus d'informations, consultez la section [Téléchargement et installation du client Snowball](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client.html#download-client).
+ Téléchargez le fichier manifeste et obtenez le code de déverrouillage de l'appareil Snowball Edge. Pour plus d'informations, voir [Obtenir vos informations d'identification et vos outils](https://docs.aws.amazon.com/snowball/latest/developer-guide/get-credentials.html).
+ Connectez l'appareil Snowball Edge à votre réseau local. Pour plus d'informations, consultez la section [réseau local](https://docs.aws.amazon.com/snowball/latest/developer-guide/getting-started-connect.html).
+ Déverrouillez l'appareil Snowball Edge. Pour plus d'informations, voir [Déverrouillage du Snowball](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html) d'un appareil localement.
```
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
```
Le client Snowball Edge renvoie ce qui suit lorsque la commande aboutit.
```
{
"RemoteManagementState" : "INSTALLED_AUTOSTART"
}
```
## Ajout d'autorisations pour la gestion des appareils Snowball Edge à un rôle IAM sur un Snowball Edge
Sur le périphérique Compte AWS à partir duquel l'appareil a été commandé, créez un rôle Gestion des identités et des accès AWS (IAM) et ajoutez-y la politique suivante. Attribuez ensuite le rôle à l'utilisateur IAM qui se connectera pour gérer à distance votre appareil avec Snowball Edge Device Management. Pour plus d'informations, consultez les [sections Création de rôles IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) et [Création d'un utilisateur IAM dans votre](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html). Compte AWS
**Stratégie**
------
#### [ 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": "*"
}
]
}
```
------
## Commandes CLI de gestion des périphériques Snowball Edge
Cette section décrit les AWS CLI commandes que vous pouvez utiliser pour gérer votre Snowball Edge à distance avec Snowball Edge Device Management. Vous pouvez également effectuer certaines tâches de gestion à distance à l'aide de AWS OpsHub. Pour plus d'informations, voir [Gestion AWS des services sur votre appareil](https://docs.aws.amazon.com/snowball/latest/developer-guide/manage-services.html).
**Note**
Avant de gérer votre appareil, assurez-vous qu'il est allumé, connecté à votre réseau et qu'il peut se connecter à l' Région AWS endroit où il a été configuré.
**Topics**
+ [Création d'une tâche pour gérer un Snowball Edge avec Snowball Edge Device Management](#sdm-cli-create-task)
+ [Vérifier le statut d'une tâche pour gérer un Snowball Edge](#sdm-cli-describe-execution)
+ [Vérification des informations relatives à un Snowball Edge à l'aide de la gestion des appareils Snowball Edge](#sdm-cli-describe-device)
+ [Vérification de l'état des instances EC2 compatibles avec Amazon sur Snowball Edge avec Snowball Edge Device Management](#sdm-cli-describe-ec2-instances)
+ [Afficher les métadonnées des tâches sur Snowball Edge avec Snowball Edge Device Management](#sdm-cli-describe-task)
+ [Annulation d'une tâche sur un Snowball Edge grâce à la gestion des appareils Snowball Edge](#sdm-cli-cancel-task)
+ [Liste des commandes et de la syntaxe de Snowball Edge Device Management](#sdm-cli-help)
+ [Liste des Snowball Edge disponibles pour la gestion à distance](#sdm-cli-list-devices)
+ [Liste de l'état des tâches de gestion des appareils Snowball Edge sur Snowball Edge](#sdm-cli-list-executions)
+ [Répertorier les ressources disponibles sur Snowball Edge avec Snowball Edge Device Management](#sdm-cli-list-device-resources)
+ [Répertorier les tags relatifs aux tags Snowball Edge ou Snowball Edge Device Management](#sdm-cli-list-tags-for-resource)
+ [Répertorier les tâches de gestion des appareils Snowball Edge par statut](#sdm-cli-list-tasks)
+ [Appliquer des balises aux tâches de gestion des appareils Snowball Edge ou Snowball Edge](#sdm-cli-tag-resource)
+ [Supprimer les balises de gestion des appareils Snowball Edge des tâches ou de Snowball Edge](#sdm-cli-untag-resources)
### Création d'une tâche pour gérer un Snowball Edge avec Snowball Edge Device Management
Pour demander à un ou plusieurs équipements cibles d'effectuer une tâche, telle que le déverrouillage ou le redémarrage, utilisez. `create-task` Vous spécifiez les équipements cibles en fournissant une liste des appareils administrés IDs avec le `--targets` paramètre et en spécifiant les tâches à effectuer avec le `--command` paramètre. Une seule commande peut être exécutée sur un appareil à la fois.
Commandes prises en charge :
+ `unlock`(aucun argument)
+ `reboot`(aucun argument)
Pour créer une tâche à exécuter par les équipements cibles, utilisez la commande suivante. Remplacez chaque `user input placeholder` par vos propres informations.
**Commande**
```
aws snow-device-management create-task
--targets smd-fictbgr3rbcjeqa5
--command reboot={}
```
**Exceptions**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
ServiceQuotaExceededException
```
**Sortie**
```
{
"taskId": "st-ficthmqoc2pht111",
"taskArn": "arn:aws:snow-device-management:us-west-2:000000000000:task/st-cjkwhmqoc2pht111"
}
```
### Vérifier le statut d'une tâche pour gérer un Snowball Edge
Pour vérifier l'état d'une tâche distante exécutée sur une ou plusieurs machines cibles, utilisez la `describe-execution` commande.
Une tâche peut avoir l'un des états suivants :
+ `QUEUED`
+ `IN_PROGRESS`
+ `CANCELED`
+ `FAILED`
+ `COMPLETED`
+ `REJECTED`
+ `TIMED_OUT`
Pour vérifier l'état d'une tâche, utilisez la commande suivante. Remplacez chaque `user input placeholder` par vos propres informations.
**Commande**
```
aws snow-device-management describe-execution \
--taskId st-ficthmqoc2phtlef \
--managed-device-id smd-fictqic6gcldf111
```
**Sortie**
```
{
"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"
}
```
### Vérification des informations relatives à un Snowball Edge à l'aide de la gestion des appareils Snowball Edge
Pour vérifier les informations spécifiques à l'appareil, telles que le type d'appareil, la version du logiciel, les adresses IP et l'état du verrouillage, utilisez la `describe-device` commande. La sortie inclut également les éléments suivants :
+ `lastReachedOutAt`— La dernière fois que l'appareil a contacté le AWS Cloud. Indique que l'appareil est en ligne.
+ `lastUpdatedAt`— Quand les données ont été mises à jour pour la dernière fois sur l'appareil. Indique à quel moment le cache de l'appareil a été actualisé.
Pour vérifier les informations de l'appareil, utilisez la commande suivante. Remplacez chaque `user input placeholder` par vos propres informations.
**Commande**
```
aws snow-device-management describe-device \
--managed-device-id smd-fictqic6gcldf111
```
**Exceptions**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```
### Vérification de l'état des instances EC2 compatibles avec Amazon sur Snowball Edge avec Snowball Edge Device Management
Pour vérifier l'état actuel de l' EC2instance Amazon, utilisez la `describe-ec2-instances` commande. Le résultat est similaire à celui de la `describe-device` commande, mais les résultats proviennent du cache du périphérique dans le AWS Cloud et incluent un sous-ensemble des champs disponibles.
Pour vérifier l'état de l'instance EC2 compatible avec Amazon, utilisez la commande suivante. Remplacez chaque `user input placeholder` par vos propres informations.
**Commande**
```
aws snow-device-management describe-device-ec2-instances \
--managed-device-id smd-fictbgr3rbcje111 \
--instance-ids s.i-84fa8a27d3e15e111
```
**Exceptions**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Sortie**
```
{
"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"
}
]
}
```
### Afficher les métadonnées des tâches sur Snowball Edge avec Snowball Edge Device Management
Pour vérifier les métadonnées d'une tâche donnée sur un appareil, utilisez la `describe-task` commande. Les métadonnées d'une tâche incluent les éléments suivants :
+ Les appareils cibles
+ État de la tâche
+ Quand la tâche a été créée
+ Date de dernière mise à jour des données sur l'appareil
+ Quand la tâche a été terminée
+ Description (le cas échéant) fournie lors de la création de la tâche
Pour vérifier les métadonnées d'une tâche, utilisez la commande suivante. Remplacez chaque `user input placeholder` par vos propres informations.
**Commande**
```
aws snow-device-management describe-task \
--task-id st-ficthmqoc2pht111
```
**Exceptions**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Sortie**
```
{
"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"
}
```
### Annulation d'une tâche sur un Snowball Edge grâce à la gestion des appareils Snowball Edge
Pour envoyer une demande d'annulation pour une tâche spécifique, utilisez la `cancel-task` commande. Vous ne pouvez annuler que les tâches dont l'`QUEUED`état n'a pas encore été exécuté. Les tâches déjà en cours ne peuvent pas être annulées.
**Note**
Une tâche que vous tentez d'annuler peut toujours être exécutée si elle est traitée depuis la file d'attente avant que la `cancel-task` commande ne modifie l'état de la tâche.
Pour annuler une tâche, utilisez la commande suivante. Remplacez chaque `user input placeholder` par vos propres informations.
**Commande**
```
aws snow-device-management cancel-task \
--task-id st-ficthmqoc2pht111
```
**Exceptions**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Sortie**
```
{
"taskId": "st-ficthmqoc2pht111"
}
```
### Liste des commandes et de la syntaxe de Snowball Edge Device Management
Pour renvoyer une liste de toutes les commandes prises en charge pour l'API de gestion des appareils Snowball Edge, utilisez la `help` commande. Vous pouvez également utiliser la `help` commande pour renvoyer des informations détaillées et la syntaxe d'une commande donnée.
Pour répertorier toutes les commandes prises en charge, utilisez la commande suivante.
**Commande**
```
aws snow-device-management help
```
Pour renvoyer des informations détaillées et la syntaxe d'une commande, utilisez la commande suivante. `command`Remplacez-le par le nom de la commande qui vous intéresse.
**Commande**
```
aws snow-device-management command help
```
### Liste des Snowball Edge disponibles pour la gestion à distance
Pour afficher la liste de tous les appareils de votre compte sur lesquels la gestion des appareils Snowball Edge est activée sur le site Région AWS où la commande est exécutée, utilisez-la. `list-devices` `--max-results`et `--next-token` sont facultatifs. Pour plus d'informations, consultez la section [Utilisation des options de AWS CLI pagination](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) dans le « Guide de l'utilisateur de l'interface de ligne de AWS commande ».
Pour répertorier les appareils administrables à distance, utilisez la commande suivante. Remplacez chaque `user input placeholder` par vos propres informations.
**Commande**
```
aws snow-device-management list-devices \
--max-results 10
```
**Exceptions**
```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Sortie**
```
{
"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": {}
}
]
}
```
### Liste de l'état des tâches de gestion des appareils Snowball Edge sur Snowball Edge
Pour renvoyer l'état des tâches pour une ou plusieurs machines cibles, utilisez la `list-executions` commande. Pour filtrer la liste des résultats afin d'afficher les tâches qui se trouvent actuellement dans un seul état spécifique, utilisez le `--state` paramètre. `--max-results`et `--next-token` sont facultatifs. Pour plus d'informations, consultez la section [Utilisation des options de AWS CLI pagination](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) dans le « Guide de l'utilisateur de l'interface de ligne de AWS commande ».
Une tâche peut avoir l'un des états suivants :
+ `QUEUED`
+ `IN_PROGRESS`
+ `CANCELED`
+ `FAILED`
+ `COMPLETED`
+ `REJECTED`
+ `TIMED_OUT`
Pour répertorier l'état des tâches sur tous les appareils, utilisez la commande suivante. Remplacez chaque `user input placeholder` par vos propres informations.
**Commande**
```
aws snow-device-management list-executions \
--taskId st-ficthmqoc2phtlef \
--state SUCCEEDED \
--max-results 10
```
**Exceptions**
```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Sortie**
```
{
"executions": [
{
"executionId": "1",
"managedDeviceId": "smd-fictbgr3rbcje111",
"state": "SUCCEEDED",
"taskId": "st-ficthmqoc2pht111"
}
]
}
```
### Répertorier les ressources disponibles sur Snowball Edge avec Snowball Edge Device Management
Pour renvoyer la liste des AWS ressources disponibles pour un appareil, utilisez la `list-device-resources` commande. Pour filtrer la liste en fonction d'un type de ressource spécifique, utilisez le `--type` paramètre. Actuellement, les instances EC2 compatibles avec Amazon sont le seul type de ressource pris en charge. `--max-results`et `--next-token` sont facultatifs. Pour plus d'informations, consultez la section [Utilisation des options de AWS CLI pagination](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) dans le « Guide de l'utilisateur de l'interface de ligne de AWS commande ».
Pour répertorier les ressources disponibles pour un appareil, utilisez la commande suivante. Remplacez chaque `user input placeholder` par vos propres informations.
**Commande**
```
aws snow-device-management list-device-resources \
--managed-device-id smd-fictbgr3rbcje111 \
--type AWS::EC2::Instance
--next-token YAQGPwAT9l3wVKaGYjt4yS34MiQLWvzcShe9oIeDJr05AT4rXSprqcqQhhBEYRfcerAp0YYbJmRT=
--max-results 10
```
**Exceptions**
```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Sortie**
```
{
"resources": [
{
"id": "s.i-84fa8a27d3e15e111",
"resourceType": "AWS::EC2::Instance"
}
]
}
```
### Répertorier les tags relatifs aux tags Snowball Edge ou Snowball Edge Device Management
Pour renvoyer une liste de balises pour un appareil géré ou une tâche, utilisez la `list-tags-for-resource` commande.
Pour répertorier les tags d'un appareil, utilisez la commande suivante. Remplacez l'exemple Amazon Resource Name (ARN) par l'ARN de votre appareil.
**Commande**
```
aws snow-device-management list-tags-for-resource
--resource-arn arn:aws:snow-device-management:us-west-2:123456789012:managed-device/smd-fictbgr3rbcjeqa5
```
**Exceptions**
```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```
**Sortie**
```
{
"tags": {
"Project": "PrototypeA"
}
}
```
### Répertorier les tâches de gestion des appareils Snowball Edge par statut
Utilisez la `list-tasks` commande pour renvoyer une liste des tâches depuis les appareils de la AWS région où la commande est exécutée. Pour filtrer les résultats par `IN_PROGRESS``COMPLETED`, ou par `CANCELED` statut, utilisez le `--state` paramètre. `--max-results`et `--next-token` sont facultatifs. Pour plus d'informations, consultez la section [Utilisation des options de AWS CLI pagination](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) dans le « Guide de l'utilisateur de l'interface de ligne de AWS commande ».
Pour répertorier les tâches par statut, utilisez la commande suivante. Remplacez chaque `user input placeholder` par vos propres informations.
**Commande**
```
aws snow-device-management list-tasks \
--state IN_PROGRESS \
--next-token K8VAMqKiP2Cf4xGkmH8GMyZrgOF8FUb+d1OKTP9+P4pUb+8PhW+6MiXh4= \
--max-results 10
```
**Exceptions**
```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Sortie**
```
{
"tasks": [
{
"state": "IN_PROGRESS",
"tags": {},
"taskId": "st-ficthmqoc2phtlef",
"taskArn": "arn:aws:snow-device-management:us-west-2:000000000000:task/st-ficthmqoc2phtlef"
}
]
}
```
### Appliquer des balises aux tâches de gestion des appareils Snowball Edge ou Snowball Edge
Pour ajouter ou remplacer une étiquette pour un appareil ou pour une tâche sur un appareil, utilisez la `tag-resource` commande. Le `--tags` paramètre accepte une liste de paires séparées par des virgules. `Key=Value`
Pour appliquer des balises à un appareil, utilisez la commande suivante. Remplacez chaque `user input placeholder` par vos propres informations.
**Commande**
```
aws snow-device-management tag-resource \
--resource-arn arn:aws:snow-device-management:us-west-2:123456789012:managed-device/smd-fictbgr3rbcjeqa5 \
--tags Project=PrototypeA
```
**Exceptions**
```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```
### Supprimer les balises de gestion des appareils Snowball Edge des tâches ou de Snowball Edge
Pour supprimer une étiquette d'un appareil ou d'une tâche sur un appareil, utilisez la `untag-resources` commande.
Pour supprimer les tags d'un appareil, utilisez la commande suivante. Remplacez chaque `user input placeholder` par vos propres informations.
**Commande**
```
aws snow-device-management untag-resources \
--resource-arn arn:aws:snow-device-management:us-west-2:123456789012:managed-device/smd-fictbgr3rbcjeqa5 \
--tag-keys Project
```
**Exceptions**
```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```