Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Utilización AWS Snowball Edge Device Management para gestionar Snowball Edge
AWS Snowball Edge Device Management le permite gestionar sus Snowball Edge y los AWS servicios locales de forma remota. Todos los Snowball Edge son compatibles con la administración de dispositivos de Snowball Edge y viene instalado en los dispositivos nuevos en la mayoría de los dispositivos en los que Regiones de AWS Snowball Edge está disponible.
Con la administración de dispositivos de Snowball Edge, puede realizar las siguientes tareas:
+ Creación de una tarea
+ Comprobación del estado de la tarea
+ Comprobación de los metadatos de una tarea
+ Cancelación de una tarea
+ Comprobación de la información del dispositivo
+ Comprueba el estado EC2 de la instancia compatible con Amazon
+ Obtención de una lista de comandos y sintaxis
+ Obtención de una lista de los dispositivos que se pueden administrar de forma remota
+ Obtención de una lista del estado de las tareas en distintos dispositivos
+ Obtención de una lista de los recursos disponibles
+ Obtención de una lista de tareas por estado
+ Obtención de una lista de las etiquetas de un dispositivo o de una tarea
+ Aplicación de etiquetas
+ Eliminación de etiquetas
**Topics**
+ [Elegir el estado de administración del dispositivo Snowball Edge al pedir un Snowball Edge](#order-device-sdm-state)
+ [Activación de la administración de dispositivos Snowball Edge en un Snowball Edge](#enable-sdm)
+ [Añadir permisos para la administración de dispositivos Snowball Edge a un rol de IAM en un Snowball Edge](#iam-sdm)
+ [Comandos CLI de administración de dispositivos de Snowball Edge](#sdm-cli-commands)
## Elegir el estado de administración del dispositivo Snowball Edge al pedir un Snowball Edge
Al crear un trabajo para solicitar un dispositivo Snow, puede elegir el estado en el que estará la Administración de dispositivos Snowball Edge cuando reciba el dispositivo: instalado pero no activado o instalado y activado. Si está instalado pero no activado, necesitará usar AWS OpsHub o el cliente Snowball Edge para activarlo antes de usarlo. Si está instalado y activado, podrá utilizar la administración de dispositivos Snowball Edge después de recibir el dispositivo y conectarlo a la red local. Puede elegir el estado de administración de dispositivos de Snowball Edge al crear un trabajo para solicitar un dispositivo mediante el Consola de administración de la familia de productos Snow de AWS cliente de Snowball Edge o la AWS CLI API de administración de trabajos de Snow.
**Para elegir el estado de administración de dispositivos de Snowball Edge en Consola de administración de la familia de productos Snow de AWS**
1. Para elegir que se instale y active la administración de dispositivos Snowball Edge, elija **Administrar el dispositivo Snow de forma remota con o el cliente AWS OpsHub Snowball**.
1. Para elegir que la administración de dispositivos Snowball Edge se instale pero no se active, no seleccione **Administrar el dispositivo Snow de forma remota con el cliente AWS OpsHub Snowball**.
Para obtener más información, consulte [Paso 3: Elegir las características y opciones](https://docs.aws.amazon.com/snowball/latest/developer-guide/import-job-details.html) en esta guía.
**Para elegir el estado de administración de dispositivos de Snowball Edge en el cliente AWS CLI Snowball Edge o en la API de administración de trabajos de Snow:**
+ Utilice el `remote-management` parámetro para especificar el estado de administración de dispositivos de Snowball Edge. El `INSTALLED_ONLY` valor del parámetro significa que Snowball Edge Device Management está instalado pero no activado. El `INSTALLED_AUTOSTART` valor del parámetro significa que Snowball Edge Device Management está instalado y activado. Si no especifica un valor para este parámetro, el valor predeterminado es `INSTALLED_ONLY`.
**Example de la sintaxis del parámetro `remote-management` del comando `create-job`**
```
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 \
```
Para obtener más información, consulta la [referencia de la API de administración de trabajos](https://docs.aws.amazon.com/snowball/latest/api-reference/api-reference.html) en la referencia de la AWS Snowball Edge API.
## Activación de la administración de dispositivos Snowball Edge en un Snowball Edge
Siga este procedimiento para activar la administración de dispositivos de Snowball Edge mediante el cliente Snowball Edge.
Antes de utilizar este procedimiento, haga lo siguiente:
+ Descargue e instale la última versión del cliente de Snowball Edge. Para obtener más información, consulte [Descarga e instalación del cliente de Snowball](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client.html#download-client).
+ Descargue el archivo de manifiesto y obtenga el código de desbloqueo del dispositivo Snowball Edge. Para obtener más información, consulte [Obtención de las credenciales y las herramientas](https://docs.aws.amazon.com/snowball/latest/developer-guide/get-credentials.html).
+ Conecte el dispositivo Snowball Edge a la red local. Para obtener más información, consulte las de [conexión a la red local](https://docs.aws.amazon.com/snowball/latest/developer-guide/getting-started-connect.html).
+ Desbloquea el dispositivo Snowball Edge. Para obtener más información, consulte [Desbloqueo del dispositivo Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html).
```
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
```
El cliente de Snowball Edge devuelve lo siguiente cuando el comando se ejecuta correctamente.
```
{
"RemoteManagementState" : "INSTALLED_AUTOSTART"
}
```
## Añadir permisos para la administración de dispositivos Snowball Edge a un rol de IAM en un Snowball Edge
En el lugar Cuenta de AWS desde el que se realizó el pedido del dispositivo, cree un rol AWS Identity and Access Management (de IAM) y añada la siguiente política al rol. A continuación, asigne la función al usuario de IAM que iniciará sesión para gestionar su dispositivo de forma remota con Snowball Edge Device Management. Para obtener más información, consulte [Creación de roles de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) y [Creación de un usuario de IAM en su Cuenta de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html).
**Política**
------
#### [ 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": "*"
}
]
}
```
------
## Comandos CLI de administración de dispositivos de Snowball Edge
En esta sección se describen los AWS CLI comandos que puede utilizar para gestionar su Snowball Edge de forma remota con Snowball Edge Device Management. También puede realizar algunas tareas de administración remota mediante. AWS OpsHub Para obtener más información, consulte [Administrar AWS los servicios del dispositivo](https://docs.aws.amazon.com/snowball/latest/developer-guide/manage-services.html).
**nota**
Antes de administrar el dispositivo, asegúrate de que esté encendido, conectado a la red y de que pueda conectarse al Región de AWS lugar donde se aprovisionó.
**Topics**
+ [Creación de una tarea para gestionar un Snowball Edge con Snowball Edge Device Management](#sdm-cli-create-task)
+ [Comprobar el estado de una tarea para gestionar un Snowball Edge](#sdm-cli-describe-execution)
+ [Comprobación de información sobre un Snowball Edge mediante la administración de dispositivos de Snowball Edge](#sdm-cli-describe-device)
+ [Comprobación del estado de las instancias EC2 compatibles con Amazon en Snowball Edge con Snowball Edge Device Management](#sdm-cli-describe-ec2-instances)
+ [Visualización de metadatos de tareas en Snowball Edge con Snowball Edge Device Management](#sdm-cli-describe-task)
+ [Cancelación de una tarea en un Snowball Edge con Snowball Edge Device Management](#sdm-cli-cancel-task)
+ [Listado de comandos y sintaxis de Snowball Edge Device Management](#sdm-cli-help)
+ [Listado de Snowball Edge disponible para administración remota](#sdm-cli-list-devices)
+ [Listado del estado de las tareas de administración de dispositivos de Snowball Edge en Snowball Edge](#sdm-cli-list-executions)
+ [Listado de los recursos disponibles en Snowball Edge con la administración de dispositivos Snowball Edge](#sdm-cli-list-device-resources)
+ [Etiquetas de anuncios para las etiquetas de administración de dispositivos de Snowball Edge o Snowball Edge](#sdm-cli-list-tags-for-resource)
+ [Listado de tareas de administración de dispositivos de Snowball Edge por estado](#sdm-cli-list-tasks)
+ [Aplicación de etiquetas a las tareas de administración de dispositivos de Snowball Edge o Snowball Edge](#sdm-cli-tag-resource)
+ [Eliminar las etiquetas de administración de dispositivos de Snowball Edge de las tareas o de Snowball Edge](#sdm-cli-untag-resources)
### Creación de una tarea para gestionar un Snowball Edge con Snowball Edge Device Management
Para indicar a uno o más dispositivos de destino que realicen una tarea, como desbloquearse o reiniciarse, utilice `create-task`. Los dispositivos de destino se especifican proporcionando una lista de los dispositivos gestionados IDs con el `--targets` parámetro y especificando las tareas que se van a realizar con el `--command` parámetro. Solo se puede ejecutar un comando en un dispositivo cada vez.
Comandos admitidos:
+ `unlock` (sin argumentos)
+ `reboot` (sin argumentos)
Para crear una tarea para que la ejecuten los dispositivos de destino, utilice el siguiente comando. Reemplace cada `user input placeholder` por su propia información.
**Comando**
```
aws snow-device-management create-task
--targets smd-fictbgr3rbcjeqa5
--command reboot={}
```
**Excepciones**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
ServiceQuotaExceededException
```
**Salida**
```
{
"taskId": "st-ficthmqoc2pht111",
"taskArn": "arn:aws:snow-device-management:us-west-2:000000000000:task/st-cjkwhmqoc2pht111"
}
```
### Comprobar el estado de una tarea para gestionar un Snowball Edge
Para comprobar el estado de una tarea remota que se ejecuta en uno o más dispositivos de destino, utilice el comando `describe-execution`.
Una tarea puede tener uno de los siguientes estados:
+ `QUEUED`
+ `IN_PROGRESS`
+ `CANCELED`
+ `FAILED`
+ `COMPLETED`
+ `REJECTED`
+ `TIMED_OUT`
Para comprobar el estado de una tarea, utilice el siguiente comando. Reemplace cada `user input placeholder` por su propia información.
**Comando**
```
aws snow-device-management describe-execution \
--taskId st-ficthmqoc2phtlef \
--managed-device-id smd-fictqic6gcldf111
```
**Salida**
```
{
"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"
}
```
### Comprobación de información sobre un Snowball Edge mediante la administración de dispositivos de Snowball Edge
Para comprobar la información específica del dispositivo, como el tipo de dispositivo, la versión del software, las direcciones IP y el estado de bloqueo, utilice el comando `describe-device`. La salida incluye también lo siguiente:
+ `lastReachedOutAt`: la última vez que el dispositivo contactó con la Nube de AWS. Indica que el dispositivo está en línea.
+ `lastUpdatedAt`: cuándo se actualizaron los datos por última vez en el dispositivo. Indica cuándo se actualizó la memoria caché del dispositivo.
Para comprobar la información del dispositivo, utilice el siguiente comando. Reemplace cada `user input placeholder` por su propia información.
**Comando**
```
aws snow-device-management describe-device \
--managed-device-id smd-fictqic6gcldf111
```
**Excepciones**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```
### Comprobación del estado de las instancias EC2 compatibles con Amazon en Snowball Edge con Snowball Edge Device Management
Para comprobar el estado actual de la EC2 instancia de Amazon, usa el `describe-ec2-instances` comando. El resultado es similar al del `describe-device` comando, pero los resultados provienen de la memoria caché del dispositivo Nube de AWS e incluyen un subconjunto de los campos disponibles.
Para comprobar el estado de la instancia EC2 compatible con Amazon, usa el siguiente comando. Reemplace cada `user input placeholder` por su propia información.
**Comando**
```
aws snow-device-management describe-device-ec2-instances \
--managed-device-id smd-fictbgr3rbcje111 \
--instance-ids s.i-84fa8a27d3e15e111
```
**Excepciones**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Salida**
```
{
"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"
}
]
}
```
### Visualización de metadatos de tareas en Snowball Edge con Snowball Edge Device Management
Para comprobar los metadatos de una tarea determinada en un dispositivo, utilice el comando `describe-task`. Los metadatos de una tarea incluyen los siguientes elementos:
+ Los dispositivos de destino
+ El estado de la tarea
+ Cuándo se creó la tarea
+ Cuándo se actualizaron los datos por última vez en el dispositivo
+ Cuándo se completó la tarea
+ La descripción (si la hay) que se proporcionó cuando se creó la tarea
Para comprobar los metadatos de una tarea, utilice el siguiente comando. Reemplace cada `user input placeholder` por su propia información.
**Comando**
```
aws snow-device-management describe-task \
--task-id st-ficthmqoc2pht111
```
**Excepciones**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Salida**
```
{
"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"
}
```
### Cancelación de una tarea en un Snowball Edge con Snowball Edge Device Management
Para enviar una solicitud de cancelación para una tarea específica, utilice el comando `cancel-task`. Solo puede cancelar las tareas que se encuentren en el estado `QUEUED` y que aún no se hayan ejecutado. Las tareas que ya se están ejecutando no se pueden cancelar.
**nota**
Es posible que una tarea que está intentando cancelar siga ejecutándose si se procesa desde la cola antes de que el comando `cancel-task` cambie el estado de la tarea.
Para cancelar una tarea, utilice el siguiente comando. Reemplace cada `user input placeholder` por su propia información.
**Comando**
```
aws snow-device-management cancel-task \
--task-id st-ficthmqoc2pht111
```
**Excepciones**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Salida**
```
{
"taskId": "st-ficthmqoc2pht111"
}
```
### Listado de comandos y sintaxis de Snowball Edge Device Management
Para obtener una lista de todos los comandos compatibles con la API de administración de dispositivos de Snowball Edge, utilice el `help` comando. También puede usar el comando `help` para devolver información detallada sobre un comando determinado y su sintaxis.
Para obtener una lista de todos los comandos admitidos, utilice el siguiente comando.
**Comando**
```
aws snow-device-management help
```
Para devolver información detallada y la sintaxis de un comando, utilice el siguiente comando. Sustituya `command` por el nombre del comando que le interesa.
**Comando**
```
aws snow-device-management command help
```
### Listado de Snowball Edge disponible para administración remota
Para obtener una lista de todos los dispositivos de su cuenta que tienen habilitada la administración de dispositivos de Snowball Edge en el Región de AWS lugar donde se ejecuta el comando, utilice el `list-devices` comando. `--max-results`y `--next-token` son opcionales. Para obtener más información, consulte [Uso de las opciones de AWS CLI paginación](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) en la «Guía del usuario de la interfaz de línea de AWS comandos».
Para obtener una lista de los dispositivos que se pueden administrar de forma remota, utilice el siguiente comando. Reemplace cada `user input placeholder` por su propia información.
**Comando**
```
aws snow-device-management list-devices \
--max-results 10
```
**Excepciones**
```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Salida**
```
{
"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": {}
}
]
}
```
### Listado del estado de las tareas de administración de dispositivos de Snowball Edge en Snowball Edge
Para devolver el estado de las tareas de uno o más dispositivos de destino, utilice el comando `list-executions`. Para filtrar la lista devuelta y mostrar las tareas que se encuentran actualmente en un único estado específico, utilice el parámetro `--state`. `--max-results` y `--next-token` son opcionales. Para obtener más información, consulte [Uso de las opciones de AWS CLI paginación](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) en la «Guía del usuario de la interfaz de línea de AWS comandos».
Una tarea puede tener uno de los siguientes estados:
+ `QUEUED`
+ `IN_PROGRESS`
+ `CANCELED`
+ `FAILED`
+ `COMPLETED`
+ `REJECTED`
+ `TIMED_OUT`
Para obtener una lista del estado de las tareas en distintos dispositivos, utilice el siguiente comando. Reemplace cada `user input placeholder` por su propia información.
**Comando**
```
aws snow-device-management list-executions \
--taskId st-ficthmqoc2phtlef \
--state SUCCEEDED \
--max-results 10
```
**Excepciones**
```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Salida**
```
{
"executions": [
{
"executionId": "1",
"managedDeviceId": "smd-fictbgr3rbcje111",
"state": "SUCCEEDED",
"taskId": "st-ficthmqoc2pht111"
}
]
}
```
### Listado de los recursos disponibles en Snowball Edge con la administración de dispositivos Snowball Edge
Para obtener una lista de los AWS recursos disponibles para un dispositivo, utilice el `list-device-resources` comando. Para filtrar la lista por un tipo de recurso específico, utilice el parámetro `--type`. Actualmente, las instancias EC2 compatibles con Amazon son el único tipo de recurso admitido. `--max-results`y `--next-token` son opcionales. Para obtener más información, consulte [Uso de las opciones de AWS CLI paginación](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) en la «Guía del usuario de la interfaz de línea de AWS comandos».
Para obtener una lista de los recursos disponibles para un dispositivo, utilice el siguiente comando. Reemplace cada `user input placeholder` por su propia información.
**Comando**
```
aws snow-device-management list-device-resources \
--managed-device-id smd-fictbgr3rbcje111 \
--type AWS::EC2::Instance
--next-token YAQGPwAT9l3wVKaGYjt4yS34MiQLWvzcShe9oIeDJr05AT4rXSprqcqQhhBEYRfcerAp0YYbJmRT=
--max-results 10
```
**Excepciones**
```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Salida**
```
{
"resources": [
{
"id": "s.i-84fa8a27d3e15e111",
"resourceType": "AWS::EC2::Instance"
}
]
}
```
### Etiquetas de anuncios para las etiquetas de administración de dispositivos de Snowball Edge o Snowball Edge
Para devolver una lista de etiquetas de una tarea o un dispositivo administrado, utilice el comando `list-tags-for-resource`.
Para obtener una lista de las etiquetas de un dispositivo, utilice el siguiente comando. Sustituya el nombre de recurso de Amazon (ARN) de ejemplo por el ARN de su dispositivo.
**Comando**
```
aws snow-device-management list-tags-for-resource
--resource-arn arn:aws:snow-device-management:us-west-2:123456789012:managed-device/smd-fictbgr3rbcjeqa5
```
**Excepciones**
```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```
**Salida**
```
{
"tags": {
"Project": "PrototypeA"
}
}
```
### Listado de tareas de administración de dispositivos de Snowball Edge por estado
Utilice el `list-tasks` comando para obtener una lista de tareas de los dispositivos de la AWS región en la que se ejecuta el comando. Para filtrar los resultados por el estado `IN_PROGRESS`, `COMPLETED` o `CANCELED`, utilice el parámetro `--state`. `--max-results` y `--next-token` son opcionales. Para obtener más información, consulte [Uso de las opciones de AWS CLI paginación](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) en la «Guía del usuario de la interfaz de línea de AWS comandos».
Para obtener una lista de tareas por estado, utilice el siguiente comando. Reemplace cada `user input placeholder` por su propia información.
**Comando**
```
aws snow-device-management list-tasks \
--state IN_PROGRESS \
--next-token K8VAMqKiP2Cf4xGkmH8GMyZrgOF8FUb+d1OKTP9+P4pUb+8PhW+6MiXh4= \
--max-results 10
```
**Excepciones**
```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Salida**
```
{
"tasks": [
{
"state": "IN_PROGRESS",
"tags": {},
"taskId": "st-ficthmqoc2phtlef",
"taskArn": "arn:aws:snow-device-management:us-west-2:000000000000:task/st-ficthmqoc2phtlef"
}
]
}
```
### Aplicación de etiquetas a las tareas de administración de dispositivos de Snowball Edge o Snowball Edge
Para agregar o reemplazar una etiqueta para un dispositivo o para una tarea de un dispositivo, utilice el comando `tag-resource`. El parámetro `--tags` acepta una lista separada por comas de pares `Key=Value`.
Para aplicar etiquetas a un dispositivo, utilice el siguiente comando. Reemplace cada `user input placeholder` por su propia información.
**Comando**
```
aws snow-device-management tag-resource \
--resource-arn arn:aws:snow-device-management:us-west-2:123456789012:managed-device/smd-fictbgr3rbcjeqa5 \
--tags Project=PrototypeA
```
**Excepciones**
```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```
### Eliminar las etiquetas de administración de dispositivos de Snowball Edge de las tareas o de Snowball Edge
Para eliminar una etiqueta de un dispositivo o de una tarea de un dispositivo, utilice el comando `untag-resources`.
Para eliminar etiquetas de un dispositivo, utilice el siguiente comando. Reemplace cada `user input placeholder` por su propia información.
**Comando**
```
aws snow-device-management untag-resources \
--resource-arn arn:aws:snow-device-management:us-west-2:123456789012:managed-device/smd-fictbgr3rbcjeqa5 \
--tag-keys Project
```
**Excepciones**
```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```