AWS Snow Device Management を使用して Snow Family デバイスを管理する - AWS Snowball Edge デベロッパーガイド

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

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 ファミリーマネジメントコンソール
  1. Snow Device Management をインストールしてアクティブ化するには、 AWS OpsHub または Snowball クライアント を使用して Snow デバイスをリモートで管理を選択します。

  2. 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-management INSTALLED_AUTOSTART --device-configuration '{"SnowconeDeviceConfiguration": {"WirelessConnection": {"IsWifiEnabled": false} } }' \ --resources '{"S3Resources":[{"BucketArn":"arn:aws:s3:::bucket-name"}]}' \ --description "Description here" \ --address-id ADID00000000-0000-0000-0000-000000000000 \ --kms-key-arn arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab \ --role-arn arn:aws:iam::000000000000:role/SnowconeImportGamma \ --snowball-capacity-preference T8 \ --shipping-option NEXT_DAY \ --snowball-type SNC1_HDD \ --region us-west-2 \

詳細については、「 APIリファレンス」の「ジョブ管理リファレンス AWS Snowball API」を参照してください。

Snow Family デバイスで Snow Device Management を有効にする

Snowball Edge クライアントを使用して Snow Device Management をアクティブ化するには、次の手順に従います。

この手順を使用する前に、次の操作を行います。

snowballEdge set-features / --remote-management-state INSTALLED_AUTOSTART / --manifest-file JID1717d8cc-2dc9-4e68-aa46-63a3ad7927d2_manifest.bin / --unlock-code 7c0e1-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 デバイスを管理するタスクの作成

1 台以上のターゲットデバイスに、ロック解除や再起動などのタスクを実行するよう指示を出すときは、create-task を使用します。ターゲットデバイスを指定するには、 --targetsパラメータIDsでマネージドデバイスのリストを指定し、 --commandパラメータで実行するタスクを指定します。1 台のデバイスで実行できるコマンドは、1 回に 1 つのみです。

サポートされているコマンド

  • unlock (引数なし)

  • reboot (引数なし)

ターゲットデバイスごとに実行するタスクを作成するには、次のコマンドを使用します。user input placeholder を、ユーザー自身の情報に置き換えます。

コマンド

aws snow-device-management create-task --targets smd-fictbgr3rbcjeqa5 --command reboot={}

例外

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-id smd-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-ids s.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 \ --state SUCCEEDED \ --max-results 10

例外

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 \ --type AWS::EC2::Instance --next-token YAQGPwAT9l3wVKaGYjt4yS34MiQLWvzcShe9oIeDJr05AT4rXSprqcqQhhBEYRfcerAp0YYbJmRT= --max-results 10

例外

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_PROGRESSCOMPLETED、または CANCELED のステータス別に結果をフィルタリングするには、--state パラメータを使用します。--max-results--next-token はオプションです。詳細については、AWS CLI 「コマンドラインインターフェイスユーザーガイド」の「ページ分割オプションの使用」を参照してください。AWS

タスクをステータス別に一覧表示するには、次のコマンドを使用します。user input placeholder を、ユーザー自身の情報に置き換えます。

コマンド

aws snow-device-management list-tasks \ --state IN_PROGRESS \ --next-token K8VAMqKiP2Cf4xGkmH8GMyZrgOF8FUb+d1OKTP9+P4pUb+8PhW+6MiXh4= \ --max-results 10

例外

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 \ --tags Project=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-keys Project

例外

AccessDeniedException InternalServerException ResourceNotFoundException ThrottlingException