

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilizzo AWS Snowball Edge Device Management per gestire Snowball Edge
<a name="aws-sdm"></a>

AWS Snowball Edge Device Management consente di gestire da remoto Snowball Edge e AWS i servizi locali. Tutti gli Snowball Edge supportano Snowball Edge Device Management e vengono installati su nuovi dispositivi nella maggior parte dei paesi in cui è disponibile Regioni AWS Snowball Edge.

Con Snowball Edge Device Management, puoi eseguire le seguenti attività:
+ Creare un'attività
+ Controlla lo stato dell'attività
+ Controlla i metadati delle attività
+ Annullare un'attività
+ Controlla le informazioni sul dispositivo
+ Verifica lo stato dell'istanza EC2 compatibile con Amazon
+ Elenca i comandi e la sintassi
+ Elenca i dispositivi gestibili in remoto
+ Elenca lo stato delle attività su tutti i dispositivi
+ Elenca le risorse disponibili
+ Elenca le attività per stato
+ Elenca i tag dei dispositivi o delle attività
+ Applica tag
+ Rimuovere i tag

**Topics**
+ [Scelta dello stato di gestione dei dispositivi Snowball Edge quando si ordina uno Snowball Edge](#order-device-sdm-state)
+ [Attivazione della gestione dei dispositivi Snowball Edge su Snowball Edge](#enable-sdm)
+ [Aggiungere le autorizzazioni per Snowball Edge Device Management a un ruolo IAM su Snowball Edge](#iam-sdm)
+ [Comandi CLI di Snowball Edge Device Management](#sdm-cli-commands)

## Scelta dello stato di gestione dei dispositivi Snowball Edge quando si ordina uno Snowball Edge
<a name="order-device-sdm-state"></a>

Quando si crea un lavoro per ordinare un dispositivo Snow, è possibile scegliere lo stato in cui si troverà Snowball Edge Device Management quando si riceve il dispositivo: installato ma non attivato oppure installato e attivato. Se è installato ma non attivato, dovrai utilizzare AWS OpsHub o il client Snowball Edge per attivarlo prima di utilizzarlo. Se è installato e attivato, puoi utilizzare Snowball Edge Device Management dopo aver ricevuto il dispositivo e averlo connesso alla rete locale. Puoi scegliere lo stato di gestione dei dispositivi Snowball Edge quando crei un lavoro per ordinare un dispositivo tramite il Console di gestione della famiglia di servizi AWS Snow client Snowball Edge o l' AWS CLI API di gestione dei lavori Snow.

**Per scegliere lo stato di gestione dei dispositivi Snowball Edge tra i Console di gestione della famiglia di servizi AWS Snow**

1. Per scegliere di installare e attivare Snowball Edge Device Management, scegli **Gestisci il tuo dispositivo Snow da remoto con il nostro client AWS OpsHub Snowball**.

1. Per scegliere che Snowball Edge Device Management sia installato ma non attivato, non selezionare **Gestisci il tuo dispositivo Snow da remoto con un client AWS OpsHub Snowball**.

Per ulteriori informazioni, consulta [Passaggio 3: scelta delle funzionalità e delle opzioni](https://docs.aws.amazon.com/snowball/latest/developer-guide/import-job-details.html) in questa guida.

**Per scegliere lo stato di gestione dei dispositivi Snowball Edge dal client AWS CLI Snowball Edge o dall'API Snow job management:**
+ Utilizzate il `remote-management` parametro per specificare lo stato di gestione dei dispositivi Snowball Edge. Il `INSTALLED_ONLY` valore del parametro indica che Snowball Edge Device Management è installato ma non attivato. Il `INSTALLED_AUTOSTART` valore del parametro indica che Snowball Edge Device Management è installato e attivato. Se non si specifica un valore per questo parametro, `INSTALLED_ONLY` è il valore predefinito.

**Example della sintassi del `remote-management` parametro 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 \
```
Per ulteriori informazioni, consulta [Job Management API Reference](https://docs.aws.amazon.com/snowball/latest/api-reference/api-reference.html) nel AWS Snowball Edge API Reference.

## Attivazione della gestione dei dispositivi Snowball Edge su Snowball Edge
<a name="enable-sdm"></a>

Segui questa procedura per attivare Snowball Edge Device Management utilizzando il client Snowball Edge.

Prima di utilizzare questa procedura, effettuate le seguenti operazioni:
+ Scarica e installa la versione più recente del client Snowball Edge. Per ulteriori informazioni, consulta [Scaricamento e installazione del client Snowball](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client.html#download-client).
+ Scarica il file manifest e ottieni il codice di sblocco per il dispositivo Snowball Edge. Per ulteriori informazioni, consulta [Ottenere le credenziali e gli strumenti](https://docs.aws.amazon.com/snowball/latest/developer-guide/get-credentials.html).
+ Connect il dispositivo Snowball Edge alla rete locale. Per ulteriori informazioni, consulta [Connessione alle di rete locale](https://docs.aws.amazon.com/snowball/latest/developer-guide/getting-started-connect.html).
+ Sblocca il dispositivo Snowball Edge. Per ulteriori informazioni, consulta [Sblocco di Snowball Edge Sblocco](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html) di un dispositivo .

```
  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
```

Il client Snowball Edge restituisce quanto segue quando il comando ha esito positivo.

```
  {
    "RemoteManagementState" : "INSTALLED_AUTOSTART"
  }
```

## Aggiungere le autorizzazioni per Snowball Edge Device Management a un ruolo IAM su Snowball Edge
<a name="iam-sdm"></a>

Sul dispositivo Account AWS da cui è stato ordinato il dispositivo, crea un ruolo AWS Identity and Access Management (IAM) e aggiungi la seguente policy al ruolo. Quindi, assegna il ruolo all'utente IAM che effettuerà l'accesso per gestire in remoto il tuo dispositivo con Snowball Edge Device Management. Per ulteriori informazioni, consulta [Creazione di ruoli IAM e Creazione](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) [di un utente IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html) nel tuo. Account AWS

**Policy**

------
#### [ 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": "*" 
        }
    ]
}
```

------

## Comandi CLI di Snowball Edge Device Management
<a name="sdm-cli-commands"></a>

Questa sezione descrive i AWS CLI comandi che è possibile utilizzare per gestire Snowball Edge in remoto con Snowball Edge Device Management. È inoltre possibile eseguire alcune attività di gestione remota utilizzando. AWS OpsHub Per ulteriori informazioni, consulta [Gestione AWS dei servizi sul dispositivo](https://docs.aws.amazon.com/snowball/latest/developer-guide/manage-services.html).

**Nota**  
 Prima di gestire il dispositivo, assicurati che sia acceso, connesso alla rete e che possa connettersi al Regione AWS punto in cui è stato fornito. 

**Topics**
+ [Creazione di un'attività per gestire uno Snowball Edge con Snowball Edge Device Management](#sdm-cli-create-task)
+ [Verifica dello stato di un'attività per gestire uno Snowball Edge](#sdm-cli-describe-execution)
+ [Verifica delle informazioni su Snowball Edge utilizzando Snowball Edge Device Management](#sdm-cli-describe-device)
+ [Verifica dello stato delle istanze EC2 compatibili con Amazon su Snowball Edge con Snowball Edge Device Management](#sdm-cli-describe-ec2-instances)
+ [Visualizzazione dei metadati delle attività su Snowball Edge con Snowball Edge Device Management](#sdm-cli-describe-task)
+ [Annullamento di un'attività su Snowball Edge con Snowball Edge Device Management](#sdm-cli-cancel-task)
+ [Elenco dei comandi e della sintassi di Snowball Edge Device Management](#sdm-cli-help)
+ [Elenco Snowball Edge disponibile per la gestione remota](#sdm-cli-list-devices)
+ [Elenco dello stato delle attività di gestione dei dispositivi Snowball Edge su Snowball Edge](#sdm-cli-list-executions)
+ [Elenco delle risorse disponibili su Snowball Edge con Snowball Edge Device Management](#sdm-cli-list-device-resources)
+ [Elenco dei tag per i tag Snowball Edge o Snowball Edge Device Management](#sdm-cli-list-tags-for-resource)
+ [Elenco delle attività di Snowball Edge Device Management per stato](#sdm-cli-list-tasks)
+ [Applicazione di tag alle attività di gestione dei dispositivi di Snowball Edge o Snowball Edge](#sdm-cli-tag-resource)
+ [Rimuovere i tag di Snowball Edge Device Management dalle attività o da Snowball Edge](#sdm-cli-untag-resources)

### Creazione di un'attività per gestire uno Snowball Edge con Snowball Edge Device Management
<a name="sdm-cli-create-task"></a>

Per indicare a uno o più dispositivi di destinazione di eseguire un'operazione, come lo sblocco o il riavvio, usa. `create-task` È possibile specificare i dispositivi di destinazione fornendo un elenco di dispositivi gestiti IDs con il `--targets` parametro e specificando le attività da eseguire con il parametro. `--command` È possibile eseguire un solo comando alla volta su un dispositivo.

Comandi supportati:
+ `unlock`(senza argomenti)
+ `reboot`(nessun argomento)

Per creare un'attività che deve essere eseguita dai dispositivi di destinazione, utilizzare il seguente comando. Sostituisci ogni `user input placeholder` con le tue informazioni.

**Comando**

```
aws snow-device-management create-task 
--targets smd-fictbgr3rbcjeqa5
--command reboot={}
```

**Eccezioni**

```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
ServiceQuotaExceededException
```

**Output**

```
{
    "taskId": "st-ficthmqoc2pht111",
    "taskArn": "arn:aws:snow-device-management:us-west-2:000000000000:task/st-cjkwhmqoc2pht111"
}
```

### Verifica dello stato di un'attività per gestire uno Snowball Edge
<a name="sdm-cli-describe-execution"></a>

Per verificare lo stato di un'operazione remota in esecuzione su uno o più dispositivi di destinazione, usa il `describe-execution` comando.

Un'attività può avere uno dei seguenti stati:
+ `QUEUED`
+ `IN_PROGRESS`
+ `CANCELED`
+ `FAILED`
+ `COMPLETED`
+ `REJECTED`
+ `TIMED_OUT`

Per verificare lo stato di un'attività, utilizzare il comando seguente. Sostituisci ogni `user input placeholder` con le tue informazioni.

**Comando**

```
aws snow-device-management describe-execution \
--taskId st-ficthmqoc2phtlef \
--managed-device-id smd-fictqic6gcldf111
```

**Output**

```
{
    "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"
}
```

### Verifica delle informazioni su Snowball Edge utilizzando Snowball Edge Device Management
<a name="sdm-cli-describe-device"></a>

Per controllare le informazioni specifiche del dispositivo, come il tipo di dispositivo, la versione del software, gli indirizzi IP e lo stato del blocco, usa il comando. `describe-device` L'output include anche quanto segue:
+ `lastReachedOutAt`— L'ultima volta che il dispositivo ha contattato il Cloud AWS. Indica che il dispositivo è online.
+ `lastUpdatedAt`— Quando i dati sono stati aggiornati l'ultima volta sul dispositivo. Indica quando la cache del dispositivo è stata aggiornata.

Per controllare le informazioni sul dispositivo, usa il seguente comando. Sostituisci ogni `user input placeholder` con le tue informazioni.

**Comando**

```
aws snow-device-management describe-device \
--managed-device-id smd-fictqic6gcldf111
```

**Eccezioni**

```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```

### Verifica dello stato delle istanze EC2 compatibili con Amazon su Snowball Edge con Snowball Edge Device Management
<a name="sdm-cli-describe-ec2-instances"></a>

Per verificare lo stato corrente dell' EC2istanza Amazon, usa il `describe-ec2-instances` comando. L'output è simile a quello del `describe-device` comando, ma i risultati provengono dalla cache del dispositivo Cloud AWS e includono un sottoinsieme dei campi disponibili.

Per verificare lo stato dell'istanza EC2 compatibile con Amazon, usa il seguente comando. Sostituisci ogni `user input placeholder` con le tue informazioni.

**Comando**

```
aws snow-device-management describe-device-ec2-instances \
--managed-device-id smd-fictbgr3rbcje111 \
--instance-ids s.i-84fa8a27d3e15e111
```

**Eccezioni**

```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```

**Output**

```
{
    "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"
        }
    ]
}
```

### Visualizzazione dei metadati delle attività su Snowball Edge con Snowball Edge Device Management
<a name="sdm-cli-describe-task"></a>

Per controllare i metadati di una determinata attività su un dispositivo, usa il comando. `describe-task` I metadati di un'attività includono i seguenti elementi: 
+ I dispositivi di destinazione
+ Lo stato dell'attività
+ Quando è stata creata l'attività
+ Quando i dati sono stati aggiornati l'ultima volta sul dispositivo
+ Quando l'attività è stata completata
+ L'eventuale descrizione fornita al momento della creazione dell'attività

Per controllare i metadati di un'attività, usa il comando seguente. Sostituisci ogni `user input placeholder` con le tue informazioni.

**Comando**

```
aws snow-device-management describe-task \
--task-id st-ficthmqoc2pht111
```

**Eccezioni**

```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```

**Output**

```
{
    "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"
}
```

### Annullamento di un'attività su Snowball Edge con Snowball Edge Device Management
<a name="sdm-cli-cancel-task"></a>

Per inviare una richiesta di annullamento per un'attività specifica, usa il `cancel-task` comando. È possibile annullare solo le attività nello `QUEUED` stato che non sono ancora state eseguite. Le attività già in esecuzione non possono essere annullate. 

**Nota**  
Un'attività che si sta tentando di annullare potrebbe continuare a essere eseguita se viene elaborata dalla coda prima che il `cancel-task` comando modifichi lo stato dell'attività.

Per annullare un'operazione, utilizzare il comando seguente. Sostituisci ogni `user input placeholder` con le tue informazioni.

**Comando**

```
aws snow-device-management cancel-task \
--task-id st-ficthmqoc2pht111
```

**Eccezioni**

```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```

**Output**

```
{
    "taskId": "st-ficthmqoc2pht111"
}
```

### Elenco dei comandi e della sintassi di Snowball Edge Device Management
<a name="sdm-cli-help"></a>

Per restituire un elenco di tutti i comandi supportati per l'API Snowball Edge Device Management, usa il `help` comando. È inoltre possibile utilizzare il `help` comando per restituire informazioni dettagliate e sulla sintassi di un determinato comando.

Per elencare tutti i comandi supportati, utilizzare il comando seguente.

**Comando**

```
aws snow-device-management help
```

Per restituire informazioni dettagliate e sintassi per un comando, utilizzare il comando seguente. Sostituiscilo `command` con il nome del comando che ti interessa.

**Comando**

```
aws snow-device-management command help
```

### Elenco Snowball Edge disponibile per la gestione remota
<a name="sdm-cli-list-devices"></a>

Per restituire un elenco di tutti i dispositivi del tuo account su cui è abilitato Snowball Edge Device Management nel punto in Regione AWS cui viene eseguito il comando, usa il `list-devices` comando. `--max-results`e `--next-token` sono opzionali. Per ulteriori informazioni, vedere [Uso delle opzioni di AWS CLI impaginazione](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) nella "Guida per l'utente dell'interfaccia a riga di AWS comando».

Per elencare i dispositivi gestibili in remoto, utilizzare il comando seguente. Sostituisci ogni `user input placeholder` con le tue informazioni.

**Comando**

```
aws snow-device-management list-devices \
--max-results 10
```

**Eccezioni**

```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```

**Output**

```
{
    "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": {}
        }
    ]
}
```

### Elenco dello stato delle attività di gestione dei dispositivi Snowball Edge su Snowball Edge
<a name="sdm-cli-list-executions"></a>

Per restituire lo stato delle attività per uno o più dispositivi di destinazione, usa il `list-executions` comando. Per filtrare l'elenco restituito in modo da mostrare le attività che si trovano attualmente in un unico stato specifico, utilizzate il `--state` parametro. `--max-results`e `--next-token` sono opzionali. Per ulteriori informazioni, vedere [Uso delle opzioni di AWS CLI impaginazione](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) nella "Guida per l'utente dell'interfaccia a riga di AWS comando».

Un'attività può avere uno dei seguenti stati:
+ `QUEUED`
+ `IN_PROGRESS`
+ `CANCELED`
+ `FAILED`
+ `COMPLETED`
+ `REJECTED`
+ `TIMED_OUT`

Per elencare lo stato delle attività su tutti i dispositivi, utilizzare il comando seguente. Sostituisci ogni `user input placeholder` con le tue informazioni.

**Comando**

```
aws snow-device-management list-executions \
--taskId st-ficthmqoc2phtlef \
--state SUCCEEDED \
--max-results 10
```

**Eccezioni**

```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```

**Output**

```
{
    "executions": [
        {
            "executionId": "1",
            "managedDeviceId": "smd-fictbgr3rbcje111",
            "state": "SUCCEEDED",
            "taskId": "st-ficthmqoc2pht111"
        }
    ]
}
```

### Elenco delle risorse disponibili su Snowball Edge con Snowball Edge Device Management
<a name="sdm-cli-list-device-resources"></a>

Per restituire un elenco delle AWS risorse disponibili per un dispositivo, usa il `list-device-resources` comando. Per filtrare l'elenco in base a un tipo specifico di risorsa, utilizzate il `--type` parametro. Attualmente, le istanze EC2 compatibili con Amazon sono l'unico tipo di risorsa supportato. `--max-results`e `--next-token` sono opzionali. Per ulteriori informazioni, vedere [Uso delle opzioni di AWS CLI impaginazione](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) nella "Guida per l'utente dell'interfaccia a riga di AWS comando».

Per elencare le risorse disponibili per un dispositivo, utilizzare il comando seguente. Sostituisci ogni `user input placeholder` con le tue informazioni.

**Comando**

```
aws snow-device-management list-device-resources \
--managed-device-id smd-fictbgr3rbcje111 \
--type AWS::EC2::Instance
--next-token YAQGPwAT9l3wVKaGYjt4yS34MiQLWvzcShe9oIeDJr05AT4rXSprqcqQhhBEYRfcerAp0YYbJmRT=
--max-results 10
```

**Eccezioni**

```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```

**Output**

```
{
    "resources": [
        {
            "id": "s.i-84fa8a27d3e15e111",
            "resourceType": "AWS::EC2::Instance"
        }
    ]
}
```

### Elenco dei tag per i tag Snowball Edge o Snowball Edge Device Management
<a name="sdm-cli-list-tags-for-resource"></a>

Per restituire un elenco di tag per un dispositivo o un'attività gestita, usa il `list-tags-for-resource` comando.

Per elencare i tag di un dispositivo, usa il comando seguente. Sostituisci l'esempio Amazon Resource Name (ARN) con l'ARN del tuo 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
```

**Eccezioni**

```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```

**Output**

```
{
    "tags": {
        "Project": "PrototypeA"
    }
}
```

### Elenco delle attività di Snowball Edge Device Management per stato
<a name="sdm-cli-list-tasks"></a>

Usa il `list-tasks` comando per restituire un elenco di attività dai dispositivi nella AWS regione in cui viene eseguito il comando. Per filtrare i risultati in base `IN_PROGRESS` `CANCELED` allo stato, utilizzate il `--state` parametro. `COMPLETED` `--max-results`e `--next-token` sono opzionali. Per ulteriori informazioni, vedere [Uso delle opzioni di AWS CLI impaginazione](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html) nella "Guida per l'utente dell'interfaccia a riga di AWS comando».

Per elencare le attività in base allo stato, utilizzare il comando seguente. Sostituisci ogni `user input placeholder` con le tue informazioni.

**Comando**

```
aws snow-device-management list-tasks \
--state IN_PROGRESS \
--next-token K8VAMqKiP2Cf4xGkmH8GMyZrgOF8FUb+d1OKTP9+P4pUb+8PhW+6MiXh4= \
--max-results 10
```

**Eccezioni**

```
ValidationException
InternalServerException
ThrottlingException
AccessDeniedException
```

**Output**

```
{
    "tasks": [
        {
            "state": "IN_PROGRESS",
            "tags": {},
            "taskId": "st-ficthmqoc2phtlef",
            "taskArn": "arn:aws:snow-device-management:us-west-2:000000000000:task/st-ficthmqoc2phtlef"
          
        }
    ]
}
```

### Applicazione di tag alle attività di gestione dei dispositivi di Snowball Edge o Snowball Edge
<a name="sdm-cli-tag-resource"></a>

Per aggiungere o sostituire un tag per un dispositivo o per un'attività su un dispositivo, usa il `tag-resource` comando. Il `--tags` parametro accetta un elenco di coppie separate da virgole. `Key=Value`

Per applicare i tag a un dispositivo, utilizzate il seguente comando. Sostituisci ogni `user input placeholder` con le tue informazioni. 

**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
```

**Eccezioni**

```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```

### Rimuovere i tag di Snowball Edge Device Management dalle attività o da Snowball Edge
<a name="sdm-cli-untag-resources"></a>

Per rimuovere un tag da un dispositivo o da un'attività su un dispositivo, usa il `untag-resources` comando.

Per rimuovere i tag da un dispositivo, usa il seguente comando. Sostituisci ogni `user input placeholder` con le tue informazioni. 

**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
```

**Eccezioni**

```
AccessDeniedException
InternalServerException
ResourceNotFoundException
ThrottlingException
```