Snowball Edge クライアントのコマンド - AWS Snowball Edge デベロッパーガイド

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

Snowball Edge クライアントのコマンド

以下で、使用例と出力サンプルを含む、Snowball Edge クライアントのコマンドを説明します。

Snowball Edge クライアント用プロファイルの設定

Snowball Edge クライアントのコマンドを実行するたびに、マニフェストファイル、解除コード、IP アドレスを指定します。これらのうち最初の 2 つは、 AWS Snow ファミリーマネジメントコンソール またはジョブ管理 API から取得できます。マニフェストとロック解除コードの取得の詳細については、「Snow Family デバイスにアクセスするための認証情報の取得」を参照してください。

snowballEdge configure コマンドを使用して、マニフェストへのパス、29 文字のロック解除コード、およびエンドポイントをプロファイルとして保存するオプションがあります。設定すると、特定のジョブ用にこれらの値を手動で入力することなく、他の Snowball Edge クライアントのコマンドを使用できます。Snowball Edge クライアントの設定後、その情報はプレーンテキストの JSON 形式で home directory/.aws/snowball/config/snowball-edge.config に保存されます。

エンドポイントは IP アドレスで、https:// が追加されます。 AWS Snowball Edge デバイス LCD ディスプレイで AWS Snowball Edge デバイスの IP アドレスを見つけることができます。 AWS Snowball Edge デバイスが初めてネットワークに接続されると、DHCP サーバーが使用可能な場合、DHCP IP アドレスが自動的に取得されます。別の IP アドレスを使用する場合は、LCD ディスプレイから変更できます。詳細については、「AWS Snowball Edge デバイスの使用」を参照してください。

重要

設定ファイルにアクセスできるユーザーは誰でも、Snowball Edge デバイスまたはクラスター上のデータにアクセスできます。このファイルのローカルアクセスコントロールを管理することは、管理者の責任の 1 つです。

使用方法

このコマンドは 2 つの方法で (インライン、または求められたとき) 使用できます。この使用例は、求められたときの方法を示しています。

snowballEdge configure
例 出力
Configuration will stored at home directory\.aws\snowball\config\snowball-edge.config Snowball Edge Manifest Path: /Path/to/manifest/file Unlock Code: 29 character unlock code Default Endpoint: https://192.0.2.0

同時に複数のジョブがある場合や、別のエンドポイントからクラスターを管理するオプションが必要な場合は、複数のプロファイルを持つことができます。複数の AWS CLI プロファイルの詳細については、「 AWS Command Line Interface ユーザーガイド」の「名前付きプロファイル」を参照してください。

NFC 検証の QR コードの取得

このコマンドを使用して、 AWS Snowball Edge Verification App で使用するデバイス固有の QR コードを生成できます。NFC 検証の詳細は、NFC タグの検証 を参照してください。

使用方法

snowballEdge get-app-qr-code --output-file ~/downloads/snowball-qr-code.png
例 出力
QR code is saved to ~/downloads/snowball-qr-code.png

Snowball Edge クライアントバージョン

version コマンドを使用して、Snowball Edge コマンドラインインターフェイス (CLI) クライアントのバージョンを確認します。

使用方法

snowballEdge version

出力例

Snowball Edge client version: 1.2.0 Build 661

Snowball Edge デバイスのロック解除

スタンドアロン AWS Snowball Edge デバイスのロックを解除するには、 snowballEdge unlock-device コマンドを実行します。クラスターをロック解除するには、snowballEdge unlock-cluster コマンドを使用します。このコマンドにより、 AWS Snowball Edge デバイスへのアクセスを認証します。

注記

ジョブに関連付けられたデバイスのロックを解除するには、デバイスがオンサイトにあり、電源とネットワークに接続され、電源が入っている必要があります。さらに、 AWS Snowball Edge デバイスの前面の LCD ディスプレイに、デバイスが使用できる状態であることを示す必要があります。

使用方法

snowballEdge unlock-device --endpoint https://192.0.2.0 --manifest-file Path/to/manifest/file --unlock-code 01234-abcde-ABCDE-01234
例 1 つのデバイスをロック解除する入力
snowballEdge unlock-device --endpoint https://192.0.2.0 --manifest-file /usr/home/manifest.bin --unlock-code 01234-abcde-ABCDE-01234
例 1 つのデバイスをロック解除する出力
Your Snowball Edge device is unlocking. You may determine the unlock state of your device using the describe-device command. Your Snowball Edge device will be available for use when it is in the UNLOCKED state.

クラスターの使用

クラスターのロックを解除するときは、いずれかのノードのエンドポイントと、クラスター内の他のデバイスのすべての IP アドレスを指定します。

snowballEdge unlock-cluster --endpoint https://192.0.2.0 --manifest-file Path/to/manifest/file --unlock-code 01234-abcde-ABCDE-01234 --device-ip-addresses 192.0.2.0 192.0.2.1 192.0.2.2 192.0.2.3 192.0.2.4
例 クラスターのロックを解除する出力
Your Snowball Edge Cluster is unlocking. You may determine the unlock state of your cluster using the describe-device command. Your Snowball Edge Cluster will be available for use when your Snowball Edge devices are in the UNLOCKED state.

Snowball Edge の更新

次のコマンドを使用して、Snowball Edge デバイスの更新をダウンロードしてインストールできます。これらのコマンドを使用する手順については、「Snowball Edge デバイスのソフトウェア更新」を参照してください。

snowballEdge check-for-updates – クラウド上で利用可能な Snowball Edge ソフトウェアに関するバージョン情報、およびデバイスにインストールされている現在のバージョンを返します。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge check-for-updates
例 出力
Latest version: 102 Installed version: 101

snowballEdge describe-device-software – デバイスの SSL 証明書の現在のソフトウェアバージョンと有効期限を返します。また、ソフトウェア更新をダウンロード中またはインストール中の場合、状態も表示されます。可能性のある出力のリストは、次のとおりです。

  • NA – 現在進行中のソフトウェアの更新はありません。

  • Downloading – 新しいソフトウェアをダウンロードしています。

  • Installing – 新しいソフトウェアをインストールしています。

  • Requires Reboot – 新しいソフトウェアがインストールされ、デバイスを再起動する必要があります。

    警告

    デバイスを再起動する前に、デバイスでのすべてのアクティビティを停止することが強く推奨されます。デバイスを再起動すると、実行中のインスタンスが停止し、デバイス上の Amazon S3 バケットへの書き込みがすべて中断されます。これらのプロセスのすべてのデータが失われる可能性があります。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge describe-device-software
例 出力
Installed version: 101 Installing version: 102 Install State: Downloading CertificateExpiry: Thur Jan 01 00:00:00 UTC 1970

snowballEdge download-updates – Snowball Edge の最新ソフトウェア更新のダウンロードを開始します。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge download-updates
例 出力
Download started. Run describe-device-software API for additional information.

snowballEdge install-updates – 既にダウンロードされた Snowball Edge の最新のソフトウェア更新のインストールを開始します。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge install-updates
例 出力
Installation started.

snowballEdge reboot-device – デバイスを再起動します。

警告

デバイスを再起動する前に、デバイスでのすべてのアクティビティを停止することが強く推奨されます。デバイスを再起動すると、実行中のインスタンスが停止し、デバイス上の Amazon S3 バケットへの書き込みがすべて中断されます。これらのプロセスのすべてのデータが失われる可能性があります。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge reboot-device
例 出力
Rebooting device now.

snowballEdge configure-auto-update-strategies – 自動更新戦略を設定します。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge configure-auto-update-strategy --auto-check autoCheck [--auto-check-frequency autoCheckFreq] --auto-download autoDownload [--auto-download-frequency autoDownloadFreq] --auto-install autoInstall [--auto-install-frequency autoInstallFreq] --auto-reboot autoReboot [--endpoint endpoint]
例 出力
Successfully configured auto update strategy. Run describe-auto-update-strategies for additional information.

snowballEdge describe-auto-update-strategies – 現在設定されているすべての自動更新戦略を返します。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge describe-auto-update-strategies
例 出力
auto-update-strategy {[ auto-check:true, auto-check-frequency: "0 0 * * FRI", // CRON Expression String, Every Friday at midnight auto-download:true, auto-download-frequency: "0 0 * * SAT", // CRON Expression String, Every Saturday at midnight auto-install:true, auto-install-frequency: "0 13 * * Sun", // CRON Expression String, Every Saturday at midnight auto-reboot: false; ]}

認証情報の取得

snowballEdge list-access-keys および snowballEdge get-secret-access-key コマンドを使用して、Snowball Edge AWS アカウント で の管理者ユーザーの認証情報を取得できます。これらの認証情報を使用して、 AWS Identity and Access Management (IAM ユーザー) とロールを作成し、 AWS CLI または AWS SDK を使用するときにリクエストを認証できます。これらの認証情報は、Snowball Edge の個々のジョブにのみ関連付けられ、デバイスまたはデバイスのクラスターでのみ使用できます。デバイスには、 AWS クラウドの IAM アクセス許可はありません。

注記

Snowball Edge AWS CLI で を使用している場合は、 CLI を設定するときにこれらの認証情報を使用する必要があります。の認証情報の設定については AWS CLI、「 ユーザーガイド」の「 の設定 AWS CLIAWS Command Line Interface 」を参照してください。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge list-access-keys
例 出力
{ "AccessKeyIds" : [ "AKIAIOSFODNN7EXAMPLE" ] }

使用法 (Snowball Edge クライアント設定済み)

snowballEdge get-secret-access-key --access-key-id Access Key
例 出力
[snowballEdge] aws_access_key_id = AKIAIOSFODNN7EXAMPLE aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

Snowball Edge でのサービスの開始

Snowball Edge デバイスは Amazon S3 に加えて、複数のサービスをサポートします。これには、コンピューティングインスタンス、ファイルインターフェイス、 が含まれます AWS IoT Greengrass。デフォルトでは、Amazon S3 と Amazon EC2 は常にオンになっており、Snowball Edge クライアントで停止または再開はできません。ただし、ファイルインターフェイス および は snowballEdge start-service コマンドで開始 AWS IoT Greengrass できます。各サービスのサービス ID を取得するには、snowballEdge list-services コマンドを使用できます。

このコマンドを実行する前に、1 つの仮想ネットワークインターフェイスを作成して、開始するサービスに結合します。詳細については、「仮想ネットワークインターフェイスの作成」を参照してください。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge start-service --service-id service_id --virtual-network-interface-arns virtual-network-interface-arn
例 出力
Starting the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.

Snowball Edge でのサービスの停止

Snowball Edge で実行中のサービスを停止するには、snowballEdge stop-service コマンドを使用します。

Amazon S3 アダプター、Amazon EC2 AWS STS、および IAM サービスを停止することはできません。

警告

バッファされた残りのデータがデバイスに書き込まれる前にファイルインターフェイスが停止すると、データ損失が発生する可能性があります。ファイルインターフェイスの詳細については、「NFS インターフェイスの管理」を参照してください。

注記

Snow Family デバイスの Amazon S3 互換ストレージサービスを停止すると、デバイスまたはクラスターの S3 バケットに保存されているデータにアクセスできなくなります。Snow Family デバイスの Amazon S3 互換ストレージを再起動すると、アクセスが回復します。Snow Family デバイスの Amazon S3 互換ストレージが有効になっているデバイスでは、Snowball Edge デバイスの電源を入れた後にサービスを開始することをお勧めします。本ガイドの「Snowball Edge のセットアップ」を参照してください。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge stop-service --service-id service_id
例 出力
Stopping the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.

NFS の開始とアクセスの制限

重要

Amazon Elastic Block Store (Amazon EBS) を使用する場合は、NFS サービスを開始しないでください。NFS を初めて起動すると、すべてのストレージが NFS に割り当てられます。NFS サービスが停止している場合でも、NFS ストレージを Amazon EBS に再割り当てすることはできません。

注記

デバイスによって公開されている NFS 共有のマウントを許可される IP 範囲に CIDR ブロックを提供できます。例えば、10.0.0.0/16。許可された CIDR ブロックを指定しない場合、すべてのマウントリクエストが拒否されます。

NFS 経由で転送されるデータは、転送中に暗号化されないことに注意してください。

CIDR ブロックによって許可されるホストを除き、Snowcone は NFS 共有の認証や認可のメカニズムを提供しません。

snowballEdge start-service コマンドで NFS を起動します。NFS サービスのサービス ID を取得するには、snowballEdge list-services コマンドを使用します。

このコマンドを実行する前に、1 つの仮想ネットワークインターフェイスを作成して、開始するサービスに結合します。詳細については、仮想ネットワークインターフェイスの作成を参照してください。Amazon S3 バケット内のファイル共有とデータへのアクセスを制限し、現在実施されている制限を確認できます。これを行うには、NFS サービスの開始時に、ファイル共有および S3 バケットにアクセスできる許可されたホストに、CIDR ブロックを割り当てます。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge start-service --service-id nfs --virtual-network-interface-arns arn:aws:snowball-device:::interface/s.ni-12345fgh45678j --service-configuration AllowedHosts=ip address-1/32,ip address-2/24
例 出力例
Starting the service on your Snowball Edge. You can determine the status of the service using the describe-service command.

NFS 実行中に NFS 共有へのアクセスを制限する

NFS 起動後に、Amazon S3 バケット内のファイル共有とデータへのアクセスを制限できます。現在実施されている制限を確認し、バケットごとに異なるアクセス制限をかけることができます。これを行うには、NFS サービスの開始時に、ファイル共有および S3 バケットにアクセスできるホストに、CIDR ブロックを割り当てます。以下にサンプルコマンドを示します。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge start-service \ --service-id nfs \ --virtual-network-interface-arns virtual-network-interface-arn --service-configuration AllowedHosts=ip-address-1/32,ip-address-1/24

現在の制限を確認するには、describe-service コマンドを使用します。

snowballEdge describe-service --service-id nfs

AWS Snowball Edge ログ

オンプレミスのデータセンターと Snowball Edge 間でデータを転送すると、自動的にログが生成されます。デバイスへのデータ転送中に予期しないエラーが発生した場合は、次のコマンドを使用してログのコピーをローカルサーバーに保存できます。

ログに関連するコマンドは、以下の 3 つです。

  • list-logs – JSON 形式でログのリストを返します。このリストには、ログのサイズ (バイト単位)、ログの ARN、ログのサービス ID、およびログのタイプが報告されます。

    使用法 (Snowball Edge クライアント設定済み)

    snowballEdge list-logs
    例 出力
    { "Logs" : [ { "LogArn" : "arn:aws:snowball-device:::log/s3-storage-JIEXAMPLE2f-1234-4953-a7c4-dfEXAMPLE709", "LogType" : "SUPPORT", "ServiceId" : "s3", "EstimatedSizeBytes" : 53132614 }, { "LogArn" : "arn:aws:snowball-device:::log/fileinterface-JIDEXAMPLEf-1234-4953-a7c4-dfEXAMPLE709", "LogType" : "CUSTOMER", "ServiceId" : "fileinterface", "EstimatedSizeBytes" : 4446 }] }
  • get-log – Snowball Edge から特定のログのコピーを、指定されたパスのサーバーにダウンロードします。 CUSTOMERログは .zip形式で保存され、このタイプのログを抽出してその内容を表示できます。 SUPPORTログは暗号化され、 AWS Support エンジニアだけが読み取ることができます。ログの名前とパスを指定するオプションがあります。

    使用法 (Snowball Edge クライアント設定済み)

    snowballEdge get-log --log-arn arn:aws:snowball-device:::log/fileinterface-JIDEXAMPLEf-1234-4953-a7c4-dfEXAMPLE709
    例 出力
    Logs are being saved to download/path/snowball-edge-logs-1515EXAMPLE88.bin
  • get-support-logs – Snowball Edge から、SUPPORT タイプのすべてのログのコピーを指定したパスのサービスにダウンロードします。

    使用法 (Snowball Edge クライアント設定済み)

    Snowball Edge クライアント

    snowballEdge get-support-logs
    例 出力
    Logs are being saved to download/path/snowball-edge-logs-1515716135711.bin
重要

CUSTOMER タイプには、お客様独自のデータに関する機密情報が含まれている可能性があります。個の機密情報を保持するために、これらのログが不要になったら削除することを強くお勧めします。

デバイスステータスの取得

以下の Snowball Edge クライアントコマンドを使用して、Snowball Edge デバイスのステータスと全般的なヘルスを判断できます。

  • describe-device

    使用法 (Snowball Edge クライアント設定済み)

    snowballEdge describe-device
    例 出力
    { "DeviceId" : "JID-EXAMPLE12345-123-456-7-890", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.0" }, "PhysicalNetworkInterfaces" : [ { "PhysicalNetworkInterfaceId" : "s.ni-EXAMPLEd9ecbf03e3", "PhysicalConnectorType" : "RJ45", "IpAddressAssignment" : "STATIC", "IpAddress" : "0.0.0.0", "Netmask" : "0.0.0.0", "DefaultGateway" : "192.0.2.1", "MacAddress" : "EX:AM:PL:E0:12:34" }, { "PhysicalNetworkInterfaceId" : "s.ni-EXAMPLE4c3840068f", "PhysicalConnectorType" : "QSFP", "IpAddressAssignment" : "STATIC", "IpAddress" : "0.0.0.0", "Netmask" : "0.0.0.0", "DefaultGateway" : "192.0.2.2", "MacAddress" : "EX:AM:PL:E0:56:78" }, { "PhysicalNetworkInterfaceId" : "s.ni-EXAMPLE0a3a6499fd", "PhysicalConnectorType" : "SFP_PLUS", "IpAddressAssignment" : "DHCP", "IpAddress" : "192.168.1.231", "Netmask" : "255.255.255.0", "DefaultGateway" : "192.0.2.3", "MacAddress" : "EX:AM:PL:E0:90:12" } ] }
  • describe-cluster

    使用法 (Snowball Edge クライアント設定済み)

    snowballEdge describe-cluster
    例 出力
    { "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5", "Devices" : [ { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.0" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } }, { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.1" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } }, { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.2" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } }, { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.3" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } }, { "DeviceId" : "JIDEXAMPLE2-bc53-4618-a538-917EXAMPLE94", "UnlockStatus" : { "State" : "UNLOCKED" }, "ActiveNetworkInterface" : { "IpAddress" : "192.0.2.4" }, "ClusterAssociation" : { "State" : "ASSOCIATED", "ClusterId" : "CIDEXAMPLE7-5402-4c19-9feb-7c9EXAMPLEd5" }, "NetworkReachability" : { "State" : "REACHABLE" } } ] }

サービスステータスの取得

describe-serviceコマンドを使用して、Snowball Edge デバイスで実行中のサービスのステータスと全般的なヘルスを判断できます。最初に list-services コマンドを実行して、実行中のサービスを確認します。

  • list-services

    使用法 (Snowball Edge クライアント設定済み)

    snowballEdge list-services
    例 出力
    { "ServiceIds" : [ "greengrass", "fileinterface", "s3", "ec2", "s3-snow" ] }
  • describe-service

    このコマンドは、サービスのステータス値が返されます。また、サービスで発生した問題を解決するのに役立つ状態情報も含まれています。これらの状態は次のとおりです。

    • ACTIVE – このサービスは実行されており、使用できます。

    • ACTIVATING – このサービスは起動しますが、まだ使用することはできません。

    • DEACTIVATING – このサービスはシャットダウン処理の途中です。

    • DEGRADED – Snow Family デバイスの Amazon S3 互換ストレージの場合、このステータスはクラスター内の 1 つ以上のディスクまたはデバイスがダウンしていることを示します。Snow Family デバイスの Amazon S3 互換ストレージサービスは中断されずに稼働していますが、データ損失のリスクを最小限に抑えるため、クラスターのクォーラムが失われる前に影響を受けるデバイスを回復または交換する必要があります。本ガイドの「クラスタリングの概要」を参照してください。

    • INACTIVE – このサービスは実行されておらず、使用することはできません。

    使用法 (Snowball Edge クライアント設定済み)

    snowballEdge describe-service --service-id service-id
    例 出力
    { "ServiceId" : "s3", "Status" : { "State" : "ACTIVE" }, "Storage" : { "TotalSpaceBytes" : 99608745492480, "FreeSpaceBytes" : 99608744468480 }, "Endpoints" : [ { "Protocol" : "http", "Port" : 8080, "Host" : "192.0.2.0" }, { "Protocol" : "https", "Port" : 8443, "Host" : "192.0.2.0", "CertificateAssociation" : { "CertificateArn" : "arn:aws:snowball-device:::certificate/6d955EXAMPLEdb71798146EXAMPLE3f0" } } ] }
    例 Snow Family デバイスの Amazon S3 互換ストレージのサービス出力

    describe-service コマンドは、service-id パラメータの s3-snow 値に対して次の出力を提供します。

    { "ServiceId" : "s3-snow", "Autostart" : false, "Status" : { "State" : "ACTIVE" }, "ServiceCapacities" : [ { "Name" : "S3 Storage", "Unit" : "Byte", "Used" : 640303104, "Available" : 219571981512 } ], "Endpoints" : [ { "Protocol" : "https", "Port" : 443, "Host" : "10.0.2.123", "CertificateAssociation" : { "CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456" }, "Description" : "s3-snow bucket API endpoint", "DeviceId" : "JID6ebd4c50-c3a1-4b16-b32c-b254f9b7f2dc", "Status" : { "State" : "ACTIVE" } }, { "Protocol" : "https", "Port" : 443, "Host" : "10.0.3.202", "CertificateAssociation" : { "CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456" }, "Description" : "s3-snow object API endpoint", "DeviceId" : "JID6ebd4c50-c3a1-4b16-b32c-b254f9b7f2dc", "Status" : { "State" : "ACTIVE" } }, { "Protocol" : "https", "Port" : 443, "Host" : "10.0.3.63", "CertificateAssociation" : { "CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456" }, "Description" : "s3-snow bucket API endpoint", "DeviceId" : "JID2a1e0deb-38b1-41f8-b904-a396c62da70d", "Status" : { "State" : "ACTIVE" } }, { "Protocol" : "https", "Port" : 443, "Host" : "10.0.2.243", "CertificateAssociation" : { "CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456" }, "Description" : "s3-snow object API endpoint", "DeviceId" : "JID2a1e0deb-38b1-41f8-b904-a396c62da70d", "Status" : { "State" : "ACTIVE" } }, { "Protocol" : "https", "Port" : 443, "Host" : "10.0.2.220", "CertificateAssociation" : { "CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456" }, "Description" : "s3-snow bucket API endpoint", "DeviceId" : "JIDcc45fa8f-b994-4ada-a821-581bc35d8645", "Status" : { "State" : "ACTIVE" } }, { "Protocol" : "https", "Port" : 443, "Host" : "10.0.2.55", "CertificateAssociation" : { "CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456" }, "Description" : "s3-snow object API endpoint", "DeviceId" : "JIDcc45fa8f-b994-4ada-a821-581bc35d8645", "Status" : { "State" : "ACTIVE" } }, { "Protocol" : "https", "Port" : 443, "Host" : "10.0.3.213", "CertificateAssociation" : { "CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456" }, "Description" : "s3-snow bucket API endpoint", "DeviceId" : "JID4ec68543-d974-465f-b81d-89832dd502db", "Status" : { "State" : "ACTIVE" } }, { "Protocol" : "https", "Port" : 443, "Host" : "10.0.3.144", "CertificateAssociation" : { "CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456" }, "Description" : "s3-snow object API endpoint", "DeviceId" : "JID4ec68543-d974-465f-b81d-89832dd502db", "Status" : { "State" : "ACTIVE" } }, { "Protocol" : "https", "Port" : 443, "Host" : "10.0.2.143", "CertificateAssociation" : { "CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456" }, "Description" : "s3-snow bucket API endpoint", "DeviceId" : "JID6331b8b5-6c63-4e01-b3ca-eab48b5628d2", "Status" : { "State" : "ACTIVE" } }, { "Protocol" : "https", "Port" : 443, "Host" : "10.0.3.224", "CertificateAssociation" : { "CertificateArn" : "arn:aws:snowball-device:::certificate/a65ba817f2c5ac9683fc3bc1ae123456" }, "Description" : "s3-snow object API endpoint", "DeviceId" : "JID6331b8b5-6c63-4e01-b3ca-eab48b5628d2", "Status" : { "State" : "ACTIVE" } } ] }

クラスターからノードを削除する

disassociate-device コマンドは、Snowball Edge クラスターからノードを削除します。異常なノードを置き換える場合は、このコマンドを使用します。クラスターの詳細については、本ガイドの「クラスタリングの概要」を参照してください。

重要

disassociate-device コマンドは、異常なノードを削除する場合にのみ使用します。正常なノードを削除しようとすると、このコマンドは失敗し、エラーが返されます。

このコマンドを使用して、ノードの電源が誤ってオフになり、ネットワークから切断され、残りのクラスターが一時的に利用できないノードを削除しないでください。このコマンドで削除されたノードはいずれのクラスターにも追加できないため、 AWSに返す必要があります。

誤って電源を切ったノードや、ネットワークから切断したノードについては、ノードを再度、電源およびネットワークに接続し、associate-device コマンドを使用します。電源が入っていて正常である場合、disassociate-device コマンドを使用してノードを切断することはできません。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge disassociate-device --device-id Job ID for the Device
例 出力
Disassociating your Snowball Edge device from the cluster. Your Snowball Edge device will be disassociated from the cluster when it is in the "DISASSOCIATED" state. You can use the describe-cluster command to determine the state of your cluster.

クラスターへのノードの追加

associate-deviceコマンドは、Snowball Edge デバイスのクラスターにノードを追加します。ノードの電源を切ると、ロック解除からロック状態に戻ります。そのノードのロックを解除するには、このコマンドを使用できます。このコマンドを使用して、使用できないノードを、代替品として注文した新しいノードと置き換えます。クラスターの詳細については、本ガイドの「クラスタリングの概要」を参照してください。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge associate-device --device-ip-address IP Address
例 出力
Associating your Snowball Edge device with the cluster. Your Snowball Edge device will be associated with the cluster when it is in the ASSOCIATED state. You can use the describe-cluster command to determine the state of your cluster.

デバイス用のタグの作成

デバイス上の指定されたタグを追加または上書きします。最大 50 個のタグを作成できます。タグは、キーと値のペアから構成されます。値はオプションです。

注記

タグに機密データを含めないようにしてください。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge create-tags --tag Key=Name,Value=user-test --tag Key=Stage,Value=beta

詳細については、describe-tags コマンドを実行します。

例 出力
Tag(s) [Key=Name,Value=test, Key=Stage,Value=beta] created.

デバイスからのタグの削除

delete-tags コマンドは、指定したタグを Snowball Edge デバイスから削除します。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge delete-tags --tag Key=Stage,Value=beta Tag(s) [Key=Stage,Value=beta] deleted.

詳細については、describe-tags コマンドを実行します。

注記

複数のタグを同時に削除する場合、次のように複数のキーと値のペアを指定できます。

delete-tags --tag Key=Name,Value=test --tag Key=Stage,Value=Beta

タグ値を指定せずにタグキーを指定すると、その値に関係なく、このキーを持つタグはすべて削除されます。タグ値として空の文字列を持つタグキーを指定すると、値として空の文字列を持つタグのみが削除されます。

デバイスのタグの説明

describe-tags コマンドは、Snowball Edge デバイス上のタグを記述します。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge describe-tags

詳細については、describe-tags コマンドを実行します。

例 出力
{ "Tags" : [ { "Key" : "Name", "Value" : "user-test" }, { "Key" : "Stage", "Value" : "beta" } ] }

ダイレクトネットワークインターフェイスの作成

  • create-direct-network-interface – ダイレクトネットワークインターフェイス (DNI) を作成します。デバイス上の Amazon EC2 互換コンピューティングインスタンスで使用するダイレクトネットワークインターフェイスを作成します。describe-direct-network-interfaces コマンドを使用して、デバイスで使用可能なダイレクトネットワークインターフェイスを確認できます。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge create-direct-network-interface [--endpoint endpoint] [--instance-id instanceId] [--mac macAddress] [--manifest-file manifestFile] [--physical-network-interface-id physicalNetworkInterfaceId] [--profile profile] [--unlock-code unlockCode] [--vlan vlanId]

ダイレクトネットワークインターフェイスに関する情報の取得

  • describe-direct-network-interface – デバイス上のダイレクトネットワークインターフェイスを取得します。ダイレクトネットワークインターフェイスを使用して、デバイス上の Amazon EC2 互換コンピューティングインスタンスおよびサービスのネットワークを設定できます。create-direct-network-interface コマンドを使用して、新しいダイレクトネットワークインターフェイスを作成できます。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge describe-direct-network-interfaces [--endpoint endpoint] [--manifest-file manifestFile] [--profile profile] [--unlock-code unlockCode]

ダイレクトネットワークインターフェイスの更新

  • update-direct-network-interface – ダイレクトネットワークインターフェイスを更新します。このコマンドを使用して、デバイス上の Amazon EC2 互換コンピューティングインスタンスで使用するダイレクトネットワークインターフェイスを更新します。describe-direct-network-interfaces コマンドを使用して、デバイスで使用可能なダイレクトネットワークインターフェイスを確認できます。Amazon EC2 互換インスタンスにアタッチされているネットワークインターフェイスを変更する場合、そのインターフェイスは最初にデタッチされます。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge update-direct-network-interface [--direct-network-interface-arn directNetworkInterfaceArn] [--endpoint endpoint] [--mac macAddress] [--manifest-file manifestFile] [--profile profile] [--unlock-code unlockCode] [--vlan vlanId] [--attach-instance-id instanceId | --detach]

ダイレクトネットワークインターフェイスの削除

  • delete-direct-network-interface – 使用されなくなったダイレクトネットワークインターフェイスを削除します。Amazon EC2 互換コンピューティングインスタンスに関連付けられているダイレクトネットワークインターフェイスを削除するには、まずインスタンスからダイレクトネットワークインターフェイスの関連付けを解除する必要があります。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge delete-direct-network-interface [--direct-network-interface-arn directNetworkInterfaceArn] [--endpoint endpoint] [--manifest-file manifestFile] [--profile profile] [--unlock-code unlockCode]

機能ステータスのチェック

デバイスで使用可能な機能のステータスを一覧表示するには、 describe-features コマンドを使用します。

RemoteManagementState は、Snow Device Management のステータスを表示し、次のいずれかの状態を返します。

  • INSTALLED_ONLY – 機能はインストールされていますが、有効になっていません。

  • INSTALLED_AUTOSTART – この機能が有効で、電源がオン AWS リージョン になると、デバイスはその への接続を試みます。

  • NOT_INSTALLED – デバイスはこの機能をサポートしないか、起動前に既にフィールドに入っていました。

使用法 (Snowball Edge クライアント設定済み)

snowballEdge describe-features \ --manifest-file manifest.bin path \ --unlock-code unlock-code \ --endpoint https://device-local-ip:9091

出力例

{ "RemoteManagementState" : String }

タイムサーバーの設定

外部ネットワークタイムプロトコル (NTP) サーバーを設定できます。NTP CLI コマンドは、デバイスがロック状態とロック解除状態の両方の場合に使用できます。マニフェストと解除コードが必要です。これらは、snowballEdge configure コマンド、または --manifest-file および --unlock-code オプションを使用して設定できます。Edge AWS Snowcone と の両方で snowballEdge CLI を使用できることに注意してください AWS Snowcone。

セキュリティで保護された NTP タイムサーバーは、お客様が用意する必要があります。デバイスを接続する NTP タイムサーバーを設定するには、update-time-servers CLI コマンドを使用します。

注記

update-time-servers コマンドは、以前の NTP タイムサーバーの設定を上書きします。

サポートされている NTP デバイスタイプとソフトウェアバージョン

NTP は、バージョン 2 のどのストレージデバイスやコンピューティングデバイスでも使用できません。ただし、ソフトウェアバージョン 77 以降の Snowball Edge バージョン 3 ストレージおよびコンピューティングデバイスタイプは NTP をサポートします。NTP が有効になっているかどうかを確認するには、Snowball Edge CLI コマンド describe-time-sources を使用します。

使用方法

snowballEdge update-time-servers time.google.com
例 出力例
Updating time servers now.

タイムソースのチェック

デバイスが現在接続されている NTP タイムソースを確認するには、describe-time-sources Snowball Edge CLI コマンドを使用します。

使用方法

snowballEdge describe-time-sources
例 出力例
{ "Sources" : [ { "Address" : "172.31.2.71", "State" : "LOST", "Type" : "PEER", "Stratum" : 10 }, { "Address" : "172.31.3.203", "State" : "LOST", "Type" : "PEER", "Stratum" : 10 }, { "Address" : "172.31.0.178", "State" : "LOST", "Type" : "PEER", "Stratum" : 10 }, { "Address" : "172.31.3.178", "State" : "LOST", "Type" : "PEER", "Stratum" : 10 }, { "Address" : "216.239.35.12", "State" : "CURRENT", "Type" : "SERVER", "Stratum" : 1 } ] }

describe-time-sources コマンドは、タイムソースの状態のリストを返します。ソース状態は、毎回、AddressStateTypeStratum フィールドを含みます。これらのフィールドの意味は以下のとおりです。

  • Address – タイムソースの DNS 名/ IP アドレス。

  • State – デバイスとそのタイムソース間の現在の接続ステータス。5 つの状態が想定されます。

    • CURRENT – タイムソースは現在、時刻の同期に使用されている。

    • COMBINED – タイムソースは現在のソースと結合されている。

    • EXCLUDED – タイムソースが結合アルゴリズムによって除外された。

    • LOST – タイムソースとの接続が切断された。

    • UNACCEPTABLE – 結合アルゴリズムが偽ティッカーであるか、ばらつきが多すぎるとみなされた無効なタイムソース。

  • Type— NTP タイムソースは、サーバーまたはピアのいずれかになります。サーバーは、update-time-servers コマンドにより設定できます。ピアは、クラスター内の他の Snowball Edge デバイスのみになり、クラスターが関連付けられると自動的に設定されます。

  • Stratum – このフィールドには、ソースの階層が表示されます。階層 1 は、ローカルでアタッチされたリファレンスクロックを持つソースを示します。階層 1 のソースに同期されたソースは、階層 2 にあります。階層 2 のソースに同期されたソースは、階層 3 などにあります。

NTP タイムソースは、サーバーまたはピアのいずれかになります。サーバーは、update-time-servers コマンドを使用するユーザーによって設定されます。一方、ピアはクラスター内の他の Snowball Edge デバイスのみとなります。出力例では、describe-time-sources は、5 のクラスター内にある Snowball Edge で呼び出されます。出力には、4 つのピアと 1 台のサーバーが含まれます。ピアの階層は 10 で、サーバーの階層は 1 であるため、サーバーが現在のタイムソースとして選択されます。