As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Usando AWS Snowball Edge Device Management para gerenciar o Snowball Edge
AWS Snowball Edge Device Management permite que você gerencie o Snowball Edge e os AWS serviços locais remotamente. Todo o Snowball Edge oferece suporte ao gerenciamento de dispositivos do Snowball Edge e vem instalado em novos dispositivos na maioria dos lugares em que o Regiões da AWS Snowball Edge está disponível.
Com o Gerenciamento de dispositivos do Snowball Edge, você pode realizar as seguintes tarefas:
+ Criar uma tarefa
+ Verificar o status da tarefa
+ Verificar metadados de tarefas
+ Cancelar uma tarefa
+ Verifique as informações do dispositivo
+ Verifique o estado da instância EC2 compatível com a Amazon
+ Listar comandos e sintaxe
+ Listar dispositivos gerenciáveis remotamente
+ Listar o status da tarefa em todos os dispositivos
+ Listar atributos disponíveis
+ Listar tarefas por status
+ Listar tags de dispositivo ou tarefa
+ Aplicar etiquetas
+ Remover marcações
**Topics**
+ [Escolhendo o estado de gerenciamento de dispositivos do Snowball Edge ao fazer o pedido de um Snowball Edge](#order-device-sdm-state)
+ [Ativando o gerenciamento de dispositivos do Snowball Edge em um Snowball Edge](#enable-sdm)
+ [Adicionar permissões para o gerenciamento de dispositivos do Snowball Edge a uma função do IAM em um Snowball Edge](#iam-sdm)
+ [Comandos da CLI de gerenciamento de dispositivos do Snowball Edge](#sdm-cli-commands)
## Escolhendo o estado de gerenciamento de dispositivos do Snowball Edge ao fazer o pedido de um Snowball Edge
Ao criar uma tarefa para solicitar um dispositivo Snow, você pode escolher em qual estado o Gerenciamento de dispositivos do Snowball Edge estará quando receber o dispositivo: instalado, mas não ativado, ou instalado e ativado. Se ele estiver instalado, mas não ativado, você precisará usar AWS OpsHub ou o cliente Snowball Edge para ativá-lo antes de usá-lo. Se ele estiver instalado e ativado, você poderá usar o Gerenciamento de dispositivos do Snowball Edge depois de receber o dispositivo e conectá-lo à sua rede local. Você pode escolher o estado de gerenciamento de dispositivos do Snowball Edge ao criar um trabalho para solicitar um dispositivo por meio do Console de Gerenciamento da família AWS Snow, do cliente Snowball Edge, do ou da AWS CLI API de gerenciamento de tarefas do Snow.
**Para escolher o estado de gerenciamento de dispositivos do Snowball Edge na Console de Gerenciamento da família AWS Snow**
1. Para escolher se o Snowball Edge Device Management será instalado e ativado, escolha **Gerenciar seu dispositivo Snow remotamente com nosso cliente AWS OpsHub Snowball**.
1. Para escolher que o Snowball Edge Device Management seja instalado, mas não ativado, não selecione **Gerenciar seu dispositivo Snow remotamente com um cliente AWS OpsHub Snowball**.
Para ter mais informações, consulte [Etapa 3: escolher os recursos e as opções](https://docs.aws.amazon.com/snowball/latest/developer-guide/import-job-details.html) neste guia.
**Para escolher o estado de gerenciamento de dispositivos do Snowball Edge a partir do cliente AWS CLI Snowball Edge ou da API de gerenciamento de tarefas do Snow:**
+ Use o `remote-management` parâmetro para especificar o estado de gerenciamento de dispositivos do Snowball Edge. O `INSTALLED_ONLY` valor do parâmetro significa que o Snowball Edge Device Management está instalado, mas não ativado. O `INSTALLED_AUTOSTART` valor do parâmetro significa que o Snowball Edge Device Management está instalado e ativado. Se você não especificar um valor para esse parâmetro, `INSTALLED_ONLY` será o valor padrão.
**Example da sintaxe do parâmetro `remote-management` do 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 obter mais informações, consulte [Job Management API Reference](https://docs.aws.amazon.com/snowball/latest/api-reference/api-reference.html) na AWS Snowball Edge API Reference.
## Ativando o gerenciamento de dispositivos do Snowball Edge em um Snowball Edge
Siga este procedimento para ativar o Gerenciamento de dispositivos do Snowball Edge usando o cliente Snowball Edge.
Antes de usar este procedimento, faça o seguinte:
+ Baixe e instale a versão mais recente do Snowball Edge Client. Para obter mais informações, consulte [Baixar e instalar o Snowball Client](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client.html#download-client).
+ Baixe o arquivo de manifesto e obtenha o código de desbloqueio do dispositivo Snowball Edge. Para ter mais informações, consulte [Getting Your Credentials and Tools](https://docs.aws.amazon.com/snowball/latest/developer-guide/get-credentials.html).
+ Conecte o dispositivo Snowball Edge à sua rede local. Para obter mais informações, consulte [Conectando-se às de rede local](https://docs.aws.amazon.com/snowball/latest/developer-guide/getting-started-connect.html).
+ Desbloqueie o dispositivo Snowball Edge. Para ter mais informações, consulte [Unlocking the 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
```
O Snowball Edge Client exibe o seguinte quando o comando é bem-sucedido.
```
{
"RemoteManagementState" : "INSTALLED_AUTOSTART"
}
```
## Adicionar permissões para o gerenciamento de dispositivos do Snowball Edge a uma função do IAM em um Snowball Edge
No local Conta da AWS do qual o dispositivo foi pedido, crie uma função AWS Identity and Access Management (IAM) e adicione a política a seguir à função. Em seguida, atribua a função ao usuário do IAM que fará login para gerenciar remotamente seu dispositivo com o Snowball Edge Device Management. Para obter mais informações, consulte [Criação de perfis do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) e [Criação de um usuário do IAM na sua Conta da 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 da CLI de gerenciamento de dispositivos do Snowball Edge
Esta seção descreve os AWS CLI comandos que você pode usar para gerenciar seu Snowball Edge remotamente com o Gerenciamento de dispositivos do Snowball Edge. Você também pode realizar algumas tarefas de gerenciamento remoto usando AWS OpsHub o. Para obter mais informações, consulte [Gerenciando AWS serviços em seu dispositivo](https://docs.aws.amazon.com/snowball/latest/developer-guide/manage-services.html).
**nota**
Antes de gerenciar seu dispositivo, verifique se ele está ligado, conectado à sua rede e pode se conectar ao Região da AWS local onde foi provisionado.
**Topics**
+ [Criação de uma tarefa para gerenciar um Snowball Edge com o Snowball Edge Device Management](#sdm-cli-create-task)
+ [Verificando o status de uma tarefa para gerenciar um Snowball Edge](#sdm-cli-describe-execution)
+ [Verificando informações sobre um Snowball Edge usando o gerenciamento de dispositivos do Snowball Edge](#sdm-cli-describe-device)
+ [Verificando estados de instâncias EC2 compatíveis com a Amazon no Snowball Edge com o Snowball Edge Device Management](#sdm-cli-describe-ec2-instances)
+ [Visualização de metadados de tarefas no Snowball Edge com o gerenciamento de dispositivos do Snowball Edge](#sdm-cli-describe-task)
+ [Cancelamento de uma tarefa em um Snowball Edge com o gerenciamento de dispositivos do Snowball Edge](#sdm-cli-cancel-task)
+ [Listando os comandos e a sintaxe do Snowball Edge Device Management](#sdm-cli-help)
+ [Listando o Snowball Edge disponível para gerenciamento remoto](#sdm-cli-list-devices)
+ [Listando o status das tarefas de gerenciamento de dispositivos do Snowball Edge no Snowball Edge](#sdm-cli-list-executions)
+ [Listando os recursos disponíveis no Snowball Edge com o Snowball Edge Device Management](#sdm-cli-list-device-resources)
+ [Listando tags para as tags de gerenciamento de dispositivos do Snowball Edge ou do Snowball Edge](#sdm-cli-list-tags-for-resource)
+ [Listando as tarefas de gerenciamento de dispositivos do Snowball Edge por status](#sdm-cli-list-tasks)
+ [Aplicação de tags às tarefas de gerenciamento de dispositivos do Snowball Edge ou ao Snowball Edge](#sdm-cli-tag-resource)
+ [Removendo as tags de gerenciamento de dispositivos do Snowball Edge das tarefas ou do Snowball Edge](#sdm-cli-untag-resources)
### Criação de uma tarefa para gerenciar um Snowball Edge com o Snowball Edge Device Management
Para instruir um ou mais dispositivos de destino a realizar uma tarefa, como desbloquear ou reinicializar, use `create-task`. Você especifica os dispositivos de destino fornecendo uma lista de dispositivos gerenciados IDs com o `--targets` parâmetro e especifica as tarefas a serem executadas com o `--command` parâmetro. Somente um único comando pode ser executado em um dispositivo por vez.
Comandos compatíveis:
+ `unlock` (sem argumentos)
+ `reboot` (sem argumentos)
Para criar uma tarefa a ser executada pelos dispositivos de destino, use o comando a seguir. Substitua cada `user input placeholder` por suas próprias informações.
**Comando**
```
aws snow-device-management create-task
--targets smd-fictbgr3rbcjeqa5
--command reboot={}
```
**Exceções**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
ServiceQuotaExceededException
```
**Saída**
```
{
"taskId": "st-ficthmqoc2pht111",
"taskArn": "arn:aws:snow-device-management:us-west-2:000000000000:task/st-cjkwhmqoc2pht111"
}
```
### Verificando o status de uma tarefa para gerenciar um Snowball Edge
Para verificar o status de uma tarefa remota em execução em um ou mais dispositivos de destino, use o comando `describe-execution`.
Uma tarefa pode ter um dos seguintes estados:
+ `QUEUED`
+ `IN_PROGRESS`
+ `CANCELED`
+ `FAILED`
+ `COMPLETED`
+ `REJECTED`
+ `TIMED_OUT`
Para verificar o status de uma tarefa, use o comando a seguir. Substitua cada `user input placeholder` por suas próprias informações.
**Comando**
```
aws snow-device-management describe-execution \
--taskId st-ficthmqoc2phtlef \
--managed-device-id smd-fictqic6gcldf111
```
**Saída**
```
{
"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"
}
```
### Verificando informações sobre um Snowball Edge usando o gerenciamento de dispositivos do Snowball Edge
Para verificar informações específicas do dispositivo, como tipo de dispositivo, versão do software, endereços IP e status do bloqueio, use o comando `describe-device`. A saída inclui o seguinte:
+ `lastReachedOutAt`: quando o dispositivo entrou em contato pela última vez com a Nuvem AWS. Indica que o dispositivo está on-line.
+ `lastUpdatedAt`: quando os dados foram atualizados pela última vez no dispositivo. Indica quando o cache do dispositivo foi atualizado.
Para verificar as informações do dispositivo, use o comando a seguir. Substitua cada `user input placeholder` por suas próprias informações.
**Comando**
```
aws snow-device-management describe-device \
--managed-device-id smd-fictqic6gcldf111
```
**Exceções**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```
### Verificando estados de instâncias EC2 compatíveis com a Amazon no Snowball Edge com o Snowball Edge Device Management
Para verificar o estado atual da EC2 instância da Amazon, use o `describe-ec2-instances` comando. A saída é semelhante à do `describe-device` comando, mas os resultados são provenientes do cache do dispositivo Nuvem AWS e incluem um subconjunto dos campos disponíveis.
Para verificar o estado da instância EC2 compatível com a Amazon, use o comando a seguir. Substitua cada `user input placeholder` por suas próprias informações.
**Comando**
```
aws snow-device-management describe-device-ec2-instances \
--managed-device-id smd-fictbgr3rbcje111 \
--instance-ids s.i-84fa8a27d3e15e111
```
**Exceções**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Saída**
```
{
"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"
}
]
}
```
### Visualização de metadados de tarefas no Snowball Edge com o gerenciamento de dispositivos do Snowball Edge
Para verificar os metadados de uma determinada tarefa em um dispositivo, use o comando `describe-task`. Os metadados de uma tarefa incluem os seguintes itens:
+ Os dispositivos de destino
+ O status da tarefa
+ Quando a tarefa foi criada
+ Quando os dados foram atualizados pela última vez no dispositivo
+ Quando a tarefa foi concluída
+ A descrição (se houver) fornecida quando a tarefa foi criada
Para verificar os metadados de uma tarefa, use o comando a seguir. Substitua cada `user input placeholder` por suas próprias informações.
**Comando**
```
aws snow-device-management describe-task \
--task-id st-ficthmqoc2pht111
```
**Exceções**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Saída**
```
{
"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"
}
```
### Cancelamento de uma tarefa em um Snowball Edge com o gerenciamento de dispositivos do Snowball Edge
Para enviar uma solicitação de cancelamento para uma tarefa específica, use o comando `cancel-task`. Você pode cancelar somente tarefas no estado `QUEUED` que ainda não foram executadas. As tarefas que já estão em execução não podem ser canceladas.
**nota**
Uma tarefa que você está tentando cancelar ainda pode ser executada se for processada na fila antes que o comando `cancel-task` altere o estado da tarefa.
Para cancelar uma tarefa, use o seguinte comando. Substitua cada `user input placeholder` por suas próprias informações.
**Comando**
```
aws snow-device-management cancel-task \
--task-id st-ficthmqoc2pht111
```
**Exceções**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Saída**
```
{
"taskId": "st-ficthmqoc2pht111"
}
```
### Listando os comandos e a sintaxe do Snowball Edge Device Management
Para retornar uma lista de todos os comandos compatíveis com a API de gerenciamento de dispositivos do Snowball Edge, use o `help` comando. Você também pode usar o comando `help` para retornar informações detalhadas e a sintaxe de um determinado comando.
Para listar todos os comandos suportados, use o comando a seguir.
**Comando**
```
aws snow-device-management help
```
Para retornar informações e sintaxe detalhadas de um comando, use o comando a seguir. Substitua `command` pelo nome do comando no qual você está interessado.
**Comando**
```
aws snow-device-management command help
```
### Listando o Snowball Edge disponível para gerenciamento remoto
Para retornar uma lista de todos os dispositivos da sua conta que têm o Gerenciamento de dispositivos do Snowball Edge ativado no local em Região da AWS que o comando é executado, use o `list-devices` comando. `--max-results`e `--next-token` são opcionais. Para obter mais informações, consulte [Usando as opções de AWS CLI paginação](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) no "Guia do usuário da interface de linha de AWS comando”.
Para listar dispositivos gerenciáveis remotamente, use o comando a seguir. Substitua cada `user input placeholder` por suas próprias informações.
**Comando**
```
aws snow-device-management list-devices \
--max-results 10
```
**Exceções**
```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Saída**
```
{
"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": {}
}
]
}
```
### Listando o status das tarefas de gerenciamento de dispositivos do Snowball Edge no Snowball Edge
Para retornar o status das tarefas de um ou mais dispositivos de destino, use o comando `list-executions`. Para filtrar a lista de retorno para mostrar as tarefas que estão atualmente em um único estado específico, use o parâmetro `--state`. `--max-results` e `--next-token` são opcionais. Para obter mais informações, consulte [Usando as opções de AWS CLI paginação](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) no "Guia do usuário da interface de linha de AWS comando”.
Uma tarefa pode ter um dos seguintes estados:
+ `QUEUED`
+ `IN_PROGRESS`
+ `CANCELED`
+ `FAILED`
+ `COMPLETED`
+ `REJECTED`
+ `TIMED_OUT`
Para listar o status da tarefa nos dispositivos, use o comando a seguir. Substitua cada `user input placeholder` por suas próprias informações.
**Comando**
```
aws snow-device-management list-executions \
--taskId st-ficthmqoc2phtlef \
--state SUCCEEDED \
--max-results 10
```
**Exceções**
```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Saída**
```
{
"executions": [
{
"executionId": "1",
"managedDeviceId": "smd-fictbgr3rbcje111",
"state": "SUCCEEDED",
"taskId": "st-ficthmqoc2pht111"
}
]
}
```
### Listando os recursos disponíveis no Snowball Edge com o Snowball Edge Device Management
Para retornar uma lista dos AWS recursos disponíveis para um dispositivo, use o `list-device-resources` comando. Para filtrar a lista por um tipo específico de recurso, use o parâmetro `--type`. Atualmente, as instâncias EC2 compatíveis com a Amazon são o único tipo de recurso compatível. `--max-results`e `--next-token` são opcionais. Para obter mais informações, consulte [Usando as opções de AWS CLI paginação](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) no "Guia do usuário da interface de linha de AWS comando”.
Para listar os atributos disponíveis para um dispositivo, use o comando a seguir. Substitua cada `user input placeholder` por suas próprias informações.
**Comando**
```
aws snow-device-management list-device-resources \
--managed-device-id smd-fictbgr3rbcje111 \
--type AWS::EC2::Instance
--next-token YAQGPwAT9l3wVKaGYjt4yS34MiQLWvzcShe9oIeDJr05AT4rXSprqcqQhhBEYRfcerAp0YYbJmRT=
--max-results 10
```
**Exceções**
```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Saída**
```
{
"resources": [
{
"id": "s.i-84fa8a27d3e15e111",
"resourceType": "AWS::EC2::Instance"
}
]
}
```
### Listando tags para as tags de gerenciamento de dispositivos do Snowball Edge ou do Snowball Edge
Para retornar uma lista de etiquetas de um dispositivo ou tarefa gerenciada, use o comando `list-tags-for-resource`.
Para listar as tags para um dispositivo, use o comando a seguir. Substitua o nome do recurso da Amazon (ARN) de exemplo pelo ARN de seu 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
```
**Exceções**
```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```
**Saída**
```
{
"tags": {
"Project": "PrototypeA"
}
}
```
### Listando as tarefas de gerenciamento de dispositivos do Snowball Edge por status
Use o `list-tasks` comando para retornar uma lista de tarefas dos dispositivos na AWS região em que o comando é executado. Para filtrar os resultados pelos status `IN_PROGRESS`, `COMPLETED` ou `CANCELED`, use o parâmetro `--state`. `--max-results` e `--next-token` são opcionais. Para obter mais informações, consulte [Usando as opções de AWS CLI paginação](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) no "Guia do usuário da interface de linha de AWS comando”.
Para listar as tarefas por status, use o comando a seguir. Substitua cada `user input placeholder` por suas próprias informações.
**Comando**
```
aws snow-device-management list-tasks \
--state IN_PROGRESS \
--next-token K8VAMqKiP2Cf4xGkmH8GMyZrgOF8FUb+d1OKTP9+P4pUb+8PhW+6MiXh4= \
--max-results 10
```
**Exceções**
```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```
**Saída**
```
{
"tasks": [
{
"state": "IN_PROGRESS",
"tags": {},
"taskId": "st-ficthmqoc2phtlef",
"taskArn": "arn:aws:snow-device-management:us-west-2:000000000000:task/st-ficthmqoc2phtlef"
}
]
}
```
### Aplicação de tags às tarefas de gerenciamento de dispositivos do Snowball Edge ou ao Snowball Edge
Para adicionar ou substituir uma tag em um dispositivo ou em uma tarefa em um dispositivo, use o comando `tag-resource`. O parâmetro `--tags` aceita uma lista de separados por vírgula `Key=Value`.
Para aplicar etiquetas a um dispositivo, use o comando a seguir. Substitua cada `user input placeholder` por suas próprias informações.
**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
```
**Exceções**
```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```
### Removendo as tags de gerenciamento de dispositivos do Snowball Edge das tarefas ou do Snowball Edge
Para remover uma tag de um dispositivo ou de uma tarefa em um dispositivo, use o comando `untag-resources`.
Execute o comando a seguir para remover tags de um dispositivo. Substitua cada `user input placeholder` por suas próprias informações.
**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
```
**Exceções**
```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```