翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS Snow Device Management を使用して Snow Family デバイスを管理する
AWS Snow Device Management では、Snow Family デバイスとローカル AWS サービスをリモートで管理できます。すべての Snow Family デバイスは Snow Device Management をサポートしており、Snow Family デバイスが利用可能なほとんどの AWS リージョン の新しいデバイスにインストールされています。
Snow Device Management では、次のタスクを実行できます。
タスクを作成する
タスクのステータスを確認する
タスクのメタデータを確認する
タスクをキャンセルする
デバイス情報を確認する
Amazon EC2互換インスタンスの状態を確認する
コマンドと構文を一覧表示する
リモート管理可能なデバイスを一覧表示する
デバイスを横断してタスクのステータスを一覧表示する
利用可能なリソースを一覧表示する
タスクをステータス別に一覧表示する
デバイスタグまたはタスクタグを一覧表示する
タグを適用する
タグを削除する
トピック
Snow Family デバイスの注文時の Snow Device Management 状態の選択
Snow デバイスを注文するジョブを作成するときに、デバイスを受け取ったときに Snow Device Management がどの状態になるかを選択できます。インストール済みでも、アクティブ化またはアクティブ化されていない状態でも選択できます。インストールされているがアクティブ化されていない場合は、 AWS OpsHub または Snowball Edge クライアントを使用してアクティブ化する必要があります。インストールされ、アクティブ化されている場合は、デバイスを受信してローカルネットワークに接続した後に Snow Device Management を使用できます。Snow Device Management 状態は、、Snowball Edge クライアント AWS Snow ファミリーマネジメントコンソール、、 AWS CLIまたは Snow ジョブ管理 を通じてデバイスを注文するジョブを作成するときに選択できますAPI。
から Snow Device Management の状態を選択するには AWS Snow ファミリーマネジメントコンソール
Snow Device Management をインストールしてアクティブ化するには、 AWS OpsHub または Snowball クライアント を使用して Snow デバイスをリモートで管理を選択します。
Snow Device Management をインストールしてもアクティブ化しない場合は、 AWS OpsHub または Snowball クライアント を使用して Snow デバイスをリモートで管理 を選択しないでください。
詳細については、このガイドの「ステップ 3: 機能とオプションを選択する」を参照してください。
、Snowball Edge クライアント AWS CLI、または Snow ジョブ管理 から Snow Device Management の状態を選択するにはAPI:
Snow Device Management の状態を指定するには、
remote-management
パラメータを使用します。パラメータのINSTALLED_ONLY
値は、Snow Device Management がインストールされているがアクティブ化されていないことを意味します。パラメータのINSTALLED_AUTOSTART
値は、Snow Device Management がインストールされ、アクティブ化されていることを意味します。このパラメータの値を指定しない場合、INSTALLED_ONLY
がデフォルト値です。
例 create-job
コマンドの remote-management
パラメータの構文の
aws snowball create-job \ --job-type
IMPORT
\ --remote-managementINSTALLED_AUTOSTART
--device-configuration'{"SnowconeDeviceConfiguration": {"WirelessConnection": {"IsWifiEnabled": false} } }'
\ --resources'{"S3Resources":[{"BucketArn":"arn:aws:s3:::bucket-name"}]}'
\ --description"Description here"
\ --address-idADID00000000-0000-0000-0000-000000000000
\ --kms-key-arnarn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
\ --role-arnarn:aws:iam::000000000000:role/SnowconeImportGamma
\ --snowball-capacity-preferenceT8
\ --shipping-optionNEXT_DAY
\ --snowball-typeSNC1_HDD
\ --regionus-west-2
\
詳細については、「 APIリファレンス」の「ジョブ管理リファレンス AWS Snowball API」を参照してください。
Snow Family デバイスで Snow Device Management を有効にする
Snowball Edge クライアントを使用して Snow Device Management をアクティブ化するには、次の手順に従います。
この手順を使用する前に、次の操作を行います。
Snowball Edge クライアントの最新バージョンをダウンロードしてインストールします。詳細については、Downloading and Installing the Snowball Client を参照してください。
マニフェストファイルをダウンロードし、Snow Family デバイスのロック解除コードを取得します。詳細については、「 認証情報とツールの取得」を参照してください。
Snow Family デバイスをローカルネットワークに接続します。詳細については、「ローカルネットワークへの接続」を参照してください。
Snow Family デバイスのロックを解除します。詳細については、「デバイスをローカルでロック解除する」を参照してください。
snowballEdge set-features / --remote-management-state INSTALLED_AUTOSTART / --manifest-file
JID1717d8cc-2dc9-4e68-aa46-63a3ad7927d2_manifest.bin
/ --unlock-code7c0e1-bab84-f7675-0a2b6-f8k33
/ --endpoint https://192.0.2.0
:9091
コマンドが成功すると、Snowball Edge クライアントは以下を返します。
{ "RemoteManagementState" : "INSTALLED_AUTOSTART" }
Snow Family デバイスの IAMロールに Snow Device Management のアクセス許可を追加する
デバイスの注文 AWS アカウント 元の で、 (IAM) AWS Identity and Access Management ロールを作成し、次のポリシーをロールに追加します。次に、Snow Device Management を使用してデバイスをリモートで管理するためにログインするIAMユーザーにロールを割り当てます。詳細については、「 でのIAMロールの作成」およびIAM「 ユーザーの作成 AWS アカウント」を参照してください。
Policy
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "snow-device-management:ListDevices", "snow-device-management:DescribeDevice", "snow-device-management:DescribeDeviceEc2Instances", "snow-device-management:ListDeviceResources", "snow-device-management:CreateTask", "snow-device-management:ListTasks", "snow-device-management:DescribeTask", "snow-device-management:CancelTask", "snow-device-management:DescribeExecution", "snow-device-management:ListExecutions", "snow-device-management:ListTagsForResource", "snow-device-management:TagResource", "snow-device-management:UntagResource" ], "Resource": "*" } ] }
Snow Device Management CLI コマンド
このセクションでは、Snow Device Management を使用して Snow Family デバイスをリモートで管理するために使用できる AWS CLI コマンドについて説明します。を使用してリモート管理タスクを実行することもできます AWS OpsHub for Snow Family。詳細については、「デバイス 」「デバイス での AWS サービスの管理」を参照してください。
注記
デバイスを管理する前に、電源がオンになっており、ネットワークに接続されており、プロビジョニングされた AWS リージョン に接続できることを確認してください。
トピック
- Snow Device Management で Snow Family デバイスを管理するタスクの作成
- Snow Family デバイスを管理するタスクのステータスの確認
- Snow Device Management を使用した Snow Family デバイスに関する情報の確認
- Snow Device Management を使用した Snow Family デバイスの Amazon EC2互換インスタンスの状態の確認
- Snow Device Management を使用した Snow Family デバイスのタスクメタデータの表示
- Snow Device Management を使用した Snow Family デバイスのタスクのキャンセル
- Snow Device Management コマンドと構文の一覧表示
- リモート管理に使用できる Snow Family デバイスの一覧表示
- Snow Family デバイス全体の Snow Device Management タスクのステータスの一覧表示
- Snow Device Management を使用した Snow Family デバイスの利用可能なリソースの一覧表示
- Snow Family デバイスのタグまたは Snow Device Management タグの一覧表示
- Snow Device Management タスクのステータス別の一覧表示
- Snow Device Management タスクまたは Snow Family デバイスへのタグの適用
- タスクまたは Snow Family デバイスからの Snow Device Management タグの削除
Snow Device Management で Snow Family デバイスを管理するタスクの作成
1 台以上のターゲットデバイスに、ロック解除や再起動などのタスクを実行するよう指示を出すときは、create-task
を使用します。ターゲットデバイスを指定するには、 --targets
パラメータIDsでマネージドデバイスのリストを指定し、 --command
パラメータで実行するタスクを指定します。1 台のデバイスで実行できるコマンドは、1 回に 1 つのみです。
サポートされているコマンド
unlock
(引数なし)reboot
(引数なし)
ターゲットデバイスごとに実行するタスクを作成するには、次のコマンドを使用します。
を、ユーザー自身の情報に置き換えます。user input placeholder
コマンド
aws snow-device-management create-task --targets
smd-fictbgr3rbcjeqa5
--commandreboot
={}
例外
ValidationException ResourceNotFoundException InternalServerException ThrottlingException AccessDeniedException ServiceQuotaExceededException
出力
{ "taskId": "st-ficthmqoc2pht111", "taskArn": "arn:aws:snow-device-management:us-west-2:000000000000:task/st-cjkwhmqoc2pht111" }
Snow Family デバイスを管理するタスクのステータスの確認
1 台以上のターゲットデバイスで実行されている、リモートタスクのステータスを確認するには、describe-execution
コマンドを使用します。
タスクは、次のいずれかのステータスになります。
QUEUED
IN_PROGRESS
CANCELED
FAILED
COMPLETED
REJECTED
TIMED_OUT
タスクのステータスを確認するには、次のコマンドを使用します。
を、ユーザー自身の情報に置き換えます。user input placeholder
コマンド
aws snow-device-management describe-execution \ --taskId
st-ficthmqoc2phtlef
\ --managed-device-idsmd-fictqic6gcldf111
出力
{ "executionId": "1", "lastUpdatedAt": "2021-07-22T15:29:44.110000+00:00", "managedDeviceId": "smd-fictqic6gcldf111", "startedAt": "2021-07-22T15:28:53.947000+00:00", "state": "SUCCEEDED", "taskId": "st-ficthmqoc2pht111" }
Snow Device Management を使用した Snow Family デバイスに関する情報の確認
デバイスに固有の情報 (デバイスタイプ、ソフトウェアバージョン、IP アドレス、ロック状態など) を確認するには、describe-device
コマンドを使用します。出力には、以下も含まれています。
lastReachedOutAt
- デバイスが最後に AWS クラウドに連絡した日時。デバイスがオンラインであることを示します。lastUpdatedAt
— デバイスでデータが最後に更新された日時。デバイスキャッシュがいつ更新されたかを示します。
デバイス情報を確認するには、次のコマンドを使用します。
を、ユーザー自身の情報に置き換えます。user input placeholder
コマンド
aws snow-device-management describe-device \ --managed-device-id
smd-fictqic6gcldf111
例外
ValidationException ResourceNotFoundException InternalServerException ThrottlingException AccessDeniedException
出力
{ "associatedWithJob": "JID2bf11d5a-ea1e-414a-b5b1-3bf7e6a6e111", "deviceCapacities": [ { "available": 158892032000, "name": "HDD Storage", "total": 158892032000, "unit": "Byte", "used": 0 }, { "available": 0, "name": "SSD Storage", "total": 0, "unit": "Byte", "used": 0 }, { "available": 3, "name": "vCPU", "total": 3, "unit": "Number", "used": 0 }, { "available": 5368709120, "name": "Memory", "total": 5368709120, "unit": "Byte", "used": 0 }, { "available": 0, "name": "GPU", "total": 0, "unit": "Number", "used": 0 } ], "deviceState": "UNLOCKED", "deviceType": "SNC1_HDD", "lastReachedOutAt": "2021-07-23T21:21:56.120000+00:00", "lastUpdatedAt": "2021-07-23T21:21:56.120000+00:00", "managedDeviceId": "smd-fictqic6gcldf111", "managedDeviceArn": "arn:aws:snow-device-management:us-west-2:000000000000:managed-device/smd-fictqic6gcldf111" "physicalNetworkInterfaces": [ { "defaultGateway": "10.0.0.1", "ipAddress": "10.0.0.2", "ipAddressAssignment": "DHCP", "macAddress": "ab:cd:ef:12:34:56", "netmask": "255.255.252.0", "physicalConnectorType": "RJ45", "physicalNetworkInterfaceId": "s.ni-530f866d526d4b111" }, { "defaultGateway": "10.0.0.1", "ipAddress": "0.0.0.0", "ipAddressAssignment": "STATIC", "macAddress": "ab:cd:ef:12:34:57", "netmask": "0.0.0.0", "physicalConnectorType": "RJ45", "physicalNetworkInterfaceId": "s.ni-8abc787f0a6750111" } ], "software": { "installState": "NA", "installedVersion": "122", "installingVersion": "NA" }, "tags": { "Project": "PrototypeA" } }
Snow Device Management を使用した Snow Family デバイスの Amazon EC2互換インスタンスの状態の確認
Amazon EC2インスタンスの現在の状態を確認するには、 describe-ec2-instances
コマンドを使用します。出力は describe-device
コマンドの出力と似ていますが、結果は のデバイスキャッシュから取得 AWS クラウド され、使用可能なフィールドのサブセットが含まれます。
Amazon EC2互換インスタンスの状態を確認するには、次のコマンドを使用します。
を、ユーザー自身の情報に置き換えます。user input placeholder
コマンド
aws snow-device-management describe-device-ec2-instances \ --managed-device-id
smd-fictbgr3rbcje111
\ --instance-idss.i-84fa8a27d3e15e111
例外
ValidationException ResourceNotFoundException InternalServerException ThrottlingException AccessDeniedException
出力
{ "instances": [ { "instance": { "amiLaunchIndex": 0, "blockDeviceMappings": [ { "deviceName": "/dev/sda", "ebs": { "attachTime": "2021-07-23T15:25:38.719000-07:00", "deleteOnTermination": true, "status": "ATTACHED", "volumeId": "s.vol-84fa8a27d3e15e111" } } ], "cpuOptions": { "coreCount": 1, "threadsPerCore": 1 }, "createdAt": "2021-07-23T15:23:22.858000-07:00", "imageId": "s.ami-03f976c3cadaa6111", "instanceId": "s.i-84fa8a27d3e15e111", "state": { "name": "RUNNING" }, "instanceType": "snc1.micro", "privateIpAddress": "34.223.14.193", "publicIpAddress": "10.111.60.160", "rootDeviceName": "/dev/sda", "securityGroups": [ { "groupId": "s.sg-890b6b4008bdb3111", "groupName": "default" } ], "updatedAt": "2021-07-23T15:29:42.163000-07:00" }, "lastUpdatedAt": "2021-07-23T15:29:58. 071000-07:00" } ] }
Snow Device Management を使用した Snow Family デバイスのタスクメタデータの表示
デバイスの任意のタスクのメタデータを確認するには、describe-task
コマンドを使用します。タスクのメタデータには、次の項目が含まれています。
-
ターゲットデバイス
-
タスクのステータス
-
タスクが作成された日時
-
デバイスでデータが最後に更新された日時
-
タスクが完了した日時
-
タスクの作成時に記入された説明 (もしある場合)
タスクのメタデータを確認するには、次のコマンドを使用します。
を、ユーザー自身の情報に置き換えます。user input placeholder
コマンド
aws snow-device-management describe-task \ --task-id
st-ficthmqoc2pht111
例外
ValidationException ResourceNotFoundException InternalServerException ThrottlingException AccessDeniedException
出力
{ "completedAt": "2021-07-22T15:29:46.758000+00:00", "createdAt": "2021-07-22T15:28:42.613000+00:00", "lastUpdatedAt": "2021-07-22T15:29:46.758000+00:00", "state": "COMPLETED", "tags": {}, "targets": [ "smd-fictbgr3rbcje111" ], "taskId": "st-ficthmqoc2pht111", "taskArn": "arn:aws:snow-device-management:us-west-2:000000000000:task/st-ficthmqoc2pht111" }
Snow Device Management を使用した Snow Family デバイスのタスクのキャンセル
特定のタスクのキャンセルリクエストを送信するには、cancel-task
コマンドを使用します。キャンセルできるのは、ステータスが QUEUED
である、まだ実行されていないタスクのみです。既に実行されたタスクはキャンセルできません。
注記
キャンセルしようとしたタスクが、cancel-task
コマンドでステータスを変更する前にキューから処理されると、その実行が継続される可能性があります。
タスクをキャンセルするには、次のコマンドを使用します。
を、ユーザー自身の情報に置き換えます。user input placeholder
コマンド
aws snow-device-management cancel-task \ --task-id
st-ficthmqoc2pht111
例外
ValidationException ResourceNotFoundException InternalServerException ThrottlingException AccessDeniedException
出力
{ "taskId": "st-ficthmqoc2pht111" }
Snow Device Management コマンドと構文の一覧表示
Snow Device Management でサポートされているすべてのコマンドのリストを返すにはAPI、 help
コマンドを使用します。任意のコマンドの詳細情報および構文を返すときは、help
コマンドも使用できます。
サポートされているすべてのコマンドを一覧表示するには、次のコマンドを使用します。
コマンド
aws snow-device-management help
コマンドの詳細情報および構文を返すときは、次のコマンドを使用します。
を、ユーザーが希望するコマンドの名前に置き換えます。command
コマンド
aws snow-device-management
command
help
リモート管理に使用できる Snow Family デバイスの一覧表示
コマンドを実行している AWS リージョン で Snow Device Management を有効にしている、自身のアカウント上のすべてのデバイスの一覧を返すには、list-devices
コマンドを使用します。--max-results
と --next-token
はオプションです。詳細については、AWS CLI 「コマンドラインインターフェイスユーザーガイド」の「ページ分割オプションの使用」を参照してください。AWS
リモート管理可能なデバイスを一覧表示するには、次のコマンドを使用します。
を、ユーザー自身の情報に置き換えます。user input placeholder
コマンド
aws snow-device-management list-devices \ --max-results
10
例外
ValidationException InternalServerException ThrottlingException AccessDeniedException
出力
{ "devices": [ { "associatedWithJob": "ID2bf11d5a-ea1e-414a-b5b1-3bf7e6a6e111", "managedDeviceId": "smd-fictbgr3rbcjeqa5", "managedDeviceArn": "arn:aws:snow-device-management:us-west-2:000000000000:managed-device/smd-fictbgr3rbcje111" "tags": {} } ] }
Snow Family デバイス全体の Snow Device Management タスクのステータスの一覧表示
1 台以上のターゲットデバイスの、タスクのステータスを返すには、list-executions
コマンドを使用します。返されたリストをフィルタリングして、現在、特定の状態にあるタスクを表示するには、--state
パラメータ使用します。--max-results
と --next-token
はオプションです。詳細については、AWS CLI 「コマンドラインインターフェイスユーザーガイド」の「ページ分割オプションの使用」を参照してください。AWS
タスクは、次のいずれかのステータスになります。
-
QUEUED
-
IN_PROGRESS
-
CANCELED
-
FAILED
-
COMPLETED
-
REJECTED
-
TIMED_OUT
デバイスを横断してタスクのステータスを一覧表示するには、次のコマンドを使用します。
を、ユーザー自身の情報に置き換えます。user input placeholder
コマンド
aws snow-device-management list-executions \ --taskId
st-ficthmqoc2phtlef
\ --stateSUCCEEDED
\ --max-results10
例外
ValidationException InternalServerException ThrottlingException AccessDeniedException
出力
{ "executions": [ { "executionId": "1", "managedDeviceId": "smd-fictbgr3rbcje111", "state": "SUCCEEDED", "taskId": "st-ficthmqoc2pht111" } ] }
Snow Device Management を使用した Snow Family デバイスの利用可能なリソースの一覧表示
デバイスで使用できる AWS リソースのリストを返すには、 list-device-resources
コマンドを使用します。特定のタイプのリソースでリストをフィルタリングするには、--type
パラメータを使用します。現在、サポートされているリソースタイプは Amazon EC2互換インスタンスのみです。 --max-results
と --next-token
はオプションです。詳細については、AWS CLI 「コマンドラインインターフェイスユーザーガイド」の「ページ分割オプションの使用」を参照してください。AWS
デバイスで利用可能なリソースを一覧表示するには、次のコマンドを使用します。
を、ユーザー自身の情報に置き換えます。user input placeholder
コマンド
aws snow-device-management list-device-resources \ --managed-device-id
smd-fictbgr3rbcje111
\ --typeAWS::EC2::Instance
--next-tokenYAQGPwAT9l3wVKaGYjt4yS34MiQLWvzcShe9oIeDJr05AT4rXSprqcqQhhBEYRfcerAp0YYbJmRT=
--max-results10
例外
ValidationException InternalServerException ThrottlingException AccessDeniedException
出力
{ "resources": [ { "id": "s.i-84fa8a27d3e15e111", "resourceType": "AWS::EC2::Instance" } ] }
Snow Family デバイスのタグまたは Snow Device Management タグの一覧表示
管理対象デバイスまたはタスクの、タグの一覧を返すには、list-tags-for-resource
コマンドを使用します。
デバイスのタグを一覧表示するには、次のコマンドを使用します。サンプルの Amazon リソースネーム (ARN) をデバイスの ARN に置き換えます。
コマンド
aws snow-device-management list-tags-for-resource --resource-arn
arn:aws:snow-device-management:us-west-2:123456789012:managed-device/smd-fictbgr3rbcjeqa5
例外
AccessDeniedException InternalServerException ResourceNotFoundException ThrottlingException
出力
{ "tags": { "Project": "PrototypeA" } }
Snow Device Management タスクのステータス別の一覧表示
list-tasks
コマンドを使用して、コマンドが実行されている AWS リージョンのデバイスからタスクのリストを返します。IN_PROGRESS
、COMPLETED
、または CANCELED
のステータス別に結果をフィルタリングするには、--state
パラメータを使用します。--max-results
と --next-token
はオプションです。詳細については、AWS CLI 「コマンドラインインターフェイスユーザーガイド」の「ページ分割オプションの使用」を参照してください。AWS
タスクをステータス別に一覧表示するには、次のコマンドを使用します。
を、ユーザー自身の情報に置き換えます。user input placeholder
コマンド
aws snow-device-management list-tasks \ --state
IN_PROGRESS
\ --next-tokenK8VAMqKiP2Cf4xGkmH8GMyZrgOF8FUb+d1OKTP9+P4pUb+8PhW+6MiXh4=
\ --max-results10
例外
ValidationException InternalServerException ThrottlingException AccessDeniedException
出力
{ "tasks": [ { "state": "IN_PROGRESS", "tags": {}, "taskId": "st-ficthmqoc2phtlef", "taskArn": "arn:aws:snow-device-management:us-west-2:000000000000:task/st-ficthmqoc2phtlef" } ] }
Snow Device Management タスクまたは Snow Family デバイスへのタグの適用
デバイスのタグ、またはデバイス上のタスクのタグを、追加または置換するには、tag-resource
コマンドを使用します。--tags
パラメータは、Key=Value
ペアの、コンマ区切りのリストを受け入れます。
デバイスのタグを適用するには、次のコマンドを使用します。
を、ユーザー自身の情報に置き換えます。user input placeholder
コマンド
aws snow-device-management tag-resource \ --resource-arn
arn:aws:snow-device-management:us-west-2:123456789012:managed-device/smd-fictbgr3rbcjeqa5
\ --tagsProject=PrototypeA
例外
AccessDeniedException InternalServerException ResourceNotFoundException ThrottlingException
タスクまたは Snow Family デバイスからの Snow Device Management タグの削除
デバイスのタグ、またはデバイス上のタスクのタグを削除するには、untag-resources
コマンドを使用します。
デバイスのタグを削除するには、次のコマンドを使用します。
を、ユーザー自身の情報に置き換えます。user input placeholder
コマンド
aws snow-device-management untag-resources \ --resource-arn
arn:aws:snow-device-management:us-west-2:123456789012:managed-device/smd-fictbgr3rbcjeqa5
\ --tag-keysProject
例外
AccessDeniedException InternalServerException ResourceNotFoundException ThrottlingException