翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Snowball Edge デバイスへの更新のダウンロード
<a name="download-updates"></a>

Snowball Edge の更新をダウンロードするには、次の 2 つの方法があります。
+ 特定の Snowball Edge クライアントのコマンドを使用して、随時手動で更新をトリガーできます。
+ デバイスを自動的に更新する時間をプログラムで決定できます。

以下の処理は、手動で更新をダウンロードするプロセスを説明しています。Snowball Edge デバイスの自動更新に関する詳細は、「[Updating a 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. ターミナルウィンドウを開き、Snowball Edge デバイスが `describe-device` コマンドでロック解除されていることを確認します。デバイスがロックされている場合は、`unlock-device` コマンドを使用してロック解除します。詳細については、「[Unlocking the 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. ターミナルウィンドウを開き、`snowballEdge describe-device` コマンドでクラスター内のすべての Snowball Edge デバイスがロック解除されていることを確認します。デバイスがロックされている場合は、`snowballEdge unlock-cluster` コマンドを使用してロック解除します。詳細については、「[Unlocking the 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` の場合、更新のダウンロードが完了していて、インストールできるようになっています。