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á.

# Baixar atualizações em dispositivos Snowball Edge
<a name="download-updates"></a>

Há duas maneiras de baixar uma atualização para o Snowball Edge:
+ É possível acionar atualizações manuais a qualquer momento usando comandos específicos do Snowball Edge Client.
+ Você pode determinar uma hora de forma programática para atualizar o dispositivo automaticamente.

O procedimento a seguir descreve o processo de download manual das atualizações. Para ter informações sobre como atualizar automaticamente o dispositivo Snowball Edge, consulte `configure-auto-update-strategy` em [Updating a Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#update-client-commands).

**nota**  
Se seu dispositivo não tiver acesso à Internet, você poderá baixar um arquivo de atualização usando a [GetSoftwareUpdates](https://docs.aws.amazon.com/snowball/latest/api-reference/API_GetSoftwareUpdates.html)API. Depois, aponte para a localização do arquivo local quando chamar `download-updates` usando o parâmetro `uri`, como no exemplo a seguir.  

```
snowballEdge download-updates --uri {{file:///tmp/local-update}}
```
Em relação a sistemas operacionais Windows, formate o valor do parâmetro `uri` da seguinte forma:  

```
snowballEdge download-updates --uri file:/{{C:/path/to/local-update}}
```

**Como conferir e baixar atualizações de software do Snowball Edge para dispositivos autônomos**

1. Abra uma janela de terminal e verifique se o dispositivo do Snowball Edge está desbloqueado com o comando `describe-device`. Se o dispositivo estiver bloqueado, use o comando `unlock-device` para desbloqueá-lo. Para ter mais informações, consulte [Unlocking the Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html).

1. Quando o dispositivo estiver desbloqueado, execute o comando `snowballEdge check-for-updates`. Esse comando retorna a versão mais recente disponível do software Snowball Edge, além da versão atual instalada no dispositivo.

1. Se o software do dispositivo estiver desatualizado, execute o comando `snowballEdge download-updates`.
**nota**  
Se seu dispositivo não estiver conectado à Internet, primeiro baixe um arquivo de atualização usando a [GetSoftwareUpdates](https://docs.aws.amazon.com/snowball/latest/api-reference/API_GetSoftwareUpdates.html)API. Depois, execute o comando `snowballEdge download-updates` usando o parâmetro `uri` com um caminho local para o arquivo baixado, como no exemplo a seguir.  

   ```
   snowballEdge download-updates --uri {{file:///tmp/local-update}}
   ```
Em relação a sistemas operacionais Windows, formate o valor do parâmetro `uri` da seguinte forma:  

   ```
   snowballEdge download-updates --uri file:/{{C:/path/to/local-update}}
   ```

1. Você pode verificar o status desse download com o comando `snowballEdge describe-device-software`. Enquanto o download de uma atualização estiver sendo feito, o status será exibido com esse comando.   
**Example saída do comando `describe-device-software`**  

   ```
   Install State: Downloading
   ```

**Como conferir e baixar atualizações de software do Snowball Edge para clusters de dispositivos**

1. Abra uma janela de terminal e verifique se os dispositivos Snowball Edge no cluster estão desbloqueados com o comando `snowballEdge describe-device`. Se os dispositivos estiverem bloqueados, use o comando `snowballEdge unlock-cluster` para desbloqueá-los. Para ter mais informações, consulte [Unlocking the Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html).

1. Quando todos os dispositivos no cluster estiverem desbloqueados execute o comando `check-for-updates` para cada dispositivo no cluster. Esse comando retorna a versão mais recente disponível do software Snowball Edge, além da versão atual instalada no dispositivo.

   ```
   snowballEdge check-for-updates --unlock-code {{29-character-unlock-code}} --manifest-file {{path/to/manifest/file.bin}} --endpoint https://{{ip-address-of-snow-device}}                    
   ```
**nota**  
O código de desbloqueio e o arquivo de manifesto são os mesmos para todos os dispositivos no cluster.  
**Example do comando `check-for-updates`**  

   ```
   {
   "InstalledVersion" : "118",
   "LatestVersion" : "119"
   }
   ```

   Se o valor do nome `LatestVersion` for maior do que o valor do nome `InstalledVersion`, uma atualização estará disponível.

1. Em relação a cada dispositivo no cluster, use o comando `download-updates` para baixar a atualização.

   ```
   snowballEdge download-updates --uri {{file:///tmp/local-update}}
   ```
**nota**  
Em relação a sistemas operacionais Windows, formate o valor do parâmetro `uri` da seguinte forma:  

   ```
   snowballEdge download-updates --uri file:/{{C:/path/to/local-update}}
   ```

1. Para conferir o status desse download para cada dispositivo no cluster, use o comando `describe-device-software`.

   ```
   snowballEdge describe-device-software --unlock-code {{29-character-unlock-code}} --manifest-file {{path/to/manifest/file.bin}} --endpoint https://{{ip-address-of-snow-device}}    
   ```  
**Example da saída do comando `describe-device-software`**  

   ```
   {
   "InstalledVersion" : "118",
   "InstallingVersion" : "119",
   "InstallState" : "DOWNLOADED",
   "CertificateExpiry" : "Sat Mar 30 16:47:51 UTC 2024"
   }
   ```

   Se o valor do nome `InstallState` for `DOWNLOADED`, o download da atualização será feito e estará disponível para instalação.