AWS Snow Device Management を使用して Snow Family デバイスを管理する - AWS Snowball Edge デベロッパーガイド
Snow Family デバイスの注文時に Snow Device Management 状態を選択するSnow Family デバイスで Snow Device Management を有効にするSnow Family デバイスのIAMロールへの Snow Device Management のアクセス許可の追加Snow Device Management CLI コマンド

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

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：

  • remote-management パラメータを使用して、Snow Device 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 アカウント デバイスが注文された で AWS Identity and Access Management 、 (IAM) ロールを作成し、次のポリシーをロールに追加します。次に、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 「コマンドラインインターフェイスユーザーガイド」のAWS CLI 「ページ分割オプションの使用」を参照してください。

リモート管理可能なデバイスを一覧表示するには、次のコマンドを使用します。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 「コマンドラインインターフェイスユーザーガイド」のAWS CLI 「ページ分割オプションの使用」を参照してください。

タスクは、次のいずれかのステータスになります。

  • 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 「コマンドラインインターフェイスユーザーガイド」のAWS CLI 「ページ分割オプションの使用」を参照してください。

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

タスクをステータス別に一覧表示するには、次のコマンドを使用します。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