翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Snowball Edge クライアントのコマンド
以下で、使用例と出力サンプルを含む、Snowball Edge クライアントのコマンドを説明します。
トピック
- Snowball Edge クライアント用プロファイルの設定
- NFC 検証の QR コードの取得
- Snowball Edge クライアントバージョン
- Snowball Edge デバイスのロック解除
- Snowball Edge の更新
- 認証情報の取得
- Snowball Edge でのサービスの開始
- Snowball Edge でのサービスの停止
- NFS の開始とアクセスの制限
- NFS 実行中に NFS 共有へのアクセスを制限する
- AWS 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-filePath/to/manifest/file
--unlock-code01234-abcde-ABCDE-01234
例 1 つのデバイスをロック解除する入力
snowballEdge unlock-device --endpoint
https://192.0.2.0
--manifest-file/usr/home/manifest.bin
--unlock-code01234-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-frequencyautoCheckFreq
] --auto-downloadautoDownload
[--auto-download-frequencyautoDownloadFreq
] --auto-installautoInstall
[--auto-install-frequencyautoInstallFreq
] --auto-rebootautoReboot
[--endpointendpoint
]
例 出力
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-idinstanceId
] [--macmacAddress
] [--manifest-filemanifestFile
] [--physical-network-interface-idphysicalNetworkInterfaceId
] [--profileprofile
] [--unlock-codeunlockCode
] [--vlanvlanId
]
ダイレクトネットワークインターフェイスに関する情報の取得
describe-direct-network-interface
– デバイス上のダイレクトネットワークインターフェイスを取得します。ダイレクトネットワークインターフェイスを使用して、デバイス上の Amazon EC2 互換コンピューティングインスタンスおよびサービスのネットワークを設定できます。create-direct-network-interface
コマンドを使用して、新しいダイレクトネットワークインターフェイスを作成できます。
使用法 (Snowball Edge クライアント設定済み)
snowballEdge describe-direct-network-interfaces [--endpoint
endpoint
] [--manifest-filemanifestFile
] [--profileprofile
] [--unlock-codeunlockCode
]
ダイレクトネットワークインターフェイスの更新
update-direct-network-interface
– ダイレクトネットワークインターフェイスを更新します。このコマンドを使用して、デバイス上の Amazon EC2 互換コンピューティングインスタンスで使用するダイレクトネットワークインターフェイスを更新します。describe-direct-network
-interfaces コマンドを使用して、デバイスで使用可能なダイレクトネットワークインターフェイスを確認できます。Amazon EC2 互換インスタンスにアタッチされているネットワークインターフェイスを変更する場合、そのインターフェイスは最初にデタッチされます。
使用法 (Snowball Edge クライアント設定済み)
snowballEdge update-direct-network-interface [--direct-network-interface-arn
directNetworkInterfaceArn
] [--endpointendpoint
] [--macmacAddress
] [--manifest-filemanifestFile
] [--profileprofile
] [--unlock-codeunlockCode
] [--vlanvlanId
] [--attach-instance-idinstanceId
| --detach]
ダイレクトネットワークインターフェイスの削除
delete-direct-network-interface
– 使用されなくなったダイレクトネットワークインターフェイスを削除します。Amazon EC2 互換コンピューティングインスタンスに関連付けられているダイレクトネットワークインターフェイスを削除するには、まずインスタンスからダイレクトネットワークインターフェイスの関連付けを解除する必要があります。
使用法 (Snowball Edge クライアント設定済み)
snowballEdge delete-direct-network-interface [--direct-network-interface-arn
directNetworkInterfaceArn
] [--endpointendpoint
] [--manifest-filemanifestFile
] [--profileprofile
] [--unlock-codeunlockCode
]
機能ステータスのチェック
デバイスで使用可能な機能のステータスを一覧表示するには、 describe-features
コマンドを使用します。
RemoteManagementState
は、Snow Device Management のステータスを表示し、次のいずれかの状態を返します。
INSTALLED_ONLY
– 機能はインストールされていますが、有効になっていません。INSTALLED_AUTOSTART
– この機能が有効で、電源がオン AWS リージョン になると、デバイスはその への接続を試みます。NOT_INSTALLED
– デバイスはこの機能をサポートしないか、起動前に既にフィールドに入っていました。
使用法 (Snowball Edge クライアント設定済み)
snowballEdge describe-features \ --manifest-file
manifest.bin path
\ --unlock-codeunlock-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
コマンドは、タイムソースの状態のリストを返します。ソース状態は、毎回、Address
、State
、Type
、Stratum
フィールドを含みます。これらのフィールドの意味は以下のとおりです。
-
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 であるため、サーバーが現在のタイムソースとして選択されます。