本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 下載 Snowball Edge 裝置的更新
<a name="download-updates"></a>

有兩種方式可以下載 Snowball Edge 的更新：
+ 您可以隨時使用特定的 Snowball Edge 用戶端命令來觸發手動更新。
+ 您可以透過程式設計方式判斷時間，以自動更新裝置。

下列程序概述手動下載更新的程序。如需有關自動更新 Snowball Edge 裝置的資訊，請參閱[更新 Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#update-client-commands) `configure-auto-update-strategy`中的 。

**注意**  
如果您的裝置無網際網路存取，您可以使用 [GetSoftwareUpdates](https://docs.aws.amazon.com/snowball/latest/api-reference/API_GetSoftwareUpdates.html) API 下載更新檔案。然後在`download-updates`使用 `uri` 參數呼叫 時指向本機檔案位置，如下列範例所示。  

```
snowballEdge download-updates --uri file:///tmp/local-update
```
對於 Windows 作業系統，格式化 `uri` 參數的值，如下所示：  

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

**檢查並下載獨立裝置的 Snowball Edge 軟體更新**

1. 開啟終端機視窗，並確保使用 `describe-device`命令解鎖 Snowball Edge 裝置。如果裝置已鎖定，請使用 `unlock-device` 命令來解除鎖定。如需詳細資訊，請參閱[解除鎖定 Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html)。

1. 裝置解除鎖定時，執行 `snowballEdge check-for-updates` 命令。此命令會傳回 Snowball Edge 軟體的最新可用版本，以及裝置上安裝的目前版本。

1. 如果您的裝置軟體已過時，請執行 `snowballEdge download-updates` 命令。
**注意**  
如果您的裝置未連線至網際網路，請先使用 [GetSoftwareUpdates](https://docs.aws.amazon.com/snowball/latest/api-reference/API_GetSoftwareUpdates.html) API 下載更新檔案。然後使用 `uri` 參數搭配您下載檔案的本機路徑來執行 `snowballEdge download-updates`命令，如下列範例所示。  

   ```
   snowballEdge download-updates --uri file:///tmp/local-update
   ```
對於 Windows 作業系統，格式化 `uri` 參數的值，如下所示：  

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

1. 您可以使用 `snowballEdge describe-device-software` 命令來檢查此下載的狀態。下載更新時，您會使用此命令顯示狀態。  
**Example `describe-device-software` 命令的輸出**  

   ```
   Install State: Downloading
   ```

**檢查和下載裝置叢集的 Snowball Edge 軟體更新**

1. 開啟終端機視窗，並確保叢集中的所有 Snowball Edge 裝置都使用 `snowballEdge describe-device`命令解除鎖定。如果裝置已鎖定，請使用 `snowballEdge unlock-cluster`命令將其解除鎖定。如需詳細資訊，請參閱[解除鎖定 Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html)。

1. 當叢集中的所有裝置都解除鎖定時，請針對叢集中的每個裝置執行 `check-for-updates`命令。此命令會傳回 Snowball Edge 軟體的最新可用版本，以及裝置上安裝的目前版本。

   ```
   snowballEdge check-for-updates --unlock-code 29-character-unlock-code --manifest-file path/to/manifest/file.bin --endpoint https://ip-address-of-snow-device                    
   ```
**注意**  
叢集中所有裝置的解鎖碼和資訊清單檔案都相同。  
**Example `check-for-updates` 命令的**  

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

   如果`LatestVersion`名稱的值大於`InstalledVersion`名稱的值，則會提供更新。

1. 對於叢集中的每個裝置，使用 `download-updates`命令下載更新。

   ```
   snowballEdge download-updates --uri file:///tmp/local-update
   ```
**注意**  
對於 Windows 作業系統，格式化 `uri` 參數的值，如下所示：  

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

1. 若要檢查叢集中每個裝置此下載的狀態，請使用 `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 `describe-device-software` 命令的輸出**  

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

   如果`InstallState`名稱的值為 `DOWNLOADED`，則更新會完成下載並可供安裝。