訂購 Snow 系列裝置時，選擇雪裝置管理狀態在 Snow 系列裝置上啟動雪裝置管理將 Snow 裝置管理的權限新增至 Snow 系列裝置上的IAM角色雪裝置管理CLI指令

用 AWS Snow Device Management 於管理 Snow 系列裝置

AWS Snow Device Management 允許您遠程管理您的 Snow 家庭設備和本地 AWS 服務。所有 Snow 系列裝置都支援 Snow 裝置管理，而且在大多數可用 Snow 系列裝置的新裝 AWS 區域置上都安裝在新裝置上。

使用 Snow 裝置管理，您可以執行下列工作：

創建一個任務
檢查工作狀態
檢查任務元數據
取消任務
檢查裝置資訊
查看與 Amazon EC2 相容的執行個體狀態
列出命令和語法
列出可遠端管理的裝置
列出跨裝置的工作狀態
列出可用的資源
依狀態列出工作
列出裝置或工作標籤
套用標籤
移除標籤

訂購 Snow 系列裝置時，選擇雪裝置管理狀態

當您建立訂購 Snow 裝置的工作時，您可以選擇接收裝置時 Snow 裝置管理處於哪個狀態：已安裝但未啟動或已安裝和啟動。如果已安裝但尚未啟動，您必須先使用 AWS OpsHub 或 Snowball Edge 用戶端來啟用，才能使用它。如果已安裝並啟動，您可以在接收裝置並將其連接到區域網路後使用 Snow 裝置管理。您可以在建立工作時選擇「雪裝置管理」狀態 AWS Snow 系列管理主控台，以透過 Snowball Edge 用戶端 AWS CLI、或 Snow 工作管理API來訂購裝置。

若要從中選擇雪裝置管理狀態 AWS Snow 系列管理主控台

若要選擇要安裝和啟動 Snow 裝置管理，請選擇使用 AWS OpsHub 或 Snowball 用戶端遠端管理您的 Snow 裝置。
若要選擇要安裝但未啟動的 Snow 裝置管理，請勿選取「使用遠端管理 Snow 裝置」 AWS OpsHub 或「Snowball 用戶端」。

如需詳細資訊，請參閱本指南中的步驟 3：選擇功能和選。

若要從 Snowball Edge 用戶端或 Snow 工作管理中選擇「雪裝置管理API」狀態： AWS CLI

使用remote-management參數可指定「雪裝置管理」狀態。參數的INSTALLED_ONLY值表示 Snow 裝置管理已安裝但未啟動。參數的INSTALLED_AUTOSTART值表示已安裝並啟動 Snow 裝置管理。如果您未指定此參數的值，則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參考資料中的 Job 管理參 AWS Snowball API考資料。

在 Snow 系列裝置上啟動雪裝置管理

請遵循此程序，使用 Snowball Edge 用戶端啟動「雪裝置管理」。

使用此程序之前，請先執行下列動作：

下載並安裝最新版本的 Snowball Edge 用戶端。如需詳細資訊，請參閱下載和安裝 Snowball 用戶端。
下載資訊清單檔案並取得 Snow 系列裝置的解鎖碼。如需詳細資訊，請參閱取得認證和工具。
將 Snow 系列裝置 Connect 到您的區域網路。如需詳細資訊，請參閱連線至您的區域網路AWS Snowcone。
解除鎖定「雪之家」裝置。如需詳細資訊，請參閱解除鎖定 Snowball Edge 。



  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 裝置管理的權限新增至 Snow 系列裝置上的IAM角色

在訂購裝置的 AWS 帳戶來源上建立 AWS Identity and Access Management (IAM) 角色，然後將下列原則新增至角色。然後，將角色指派給要登入的IAM使用者，以透過 Snow 裝置管理從遠端管理您的裝置。如需詳細資訊，請參閱在. 中建立 IAM角色和建立IAM使用者 AWS 帳戶。

政策



{
    "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": "*" 
        }
    ]
}

雪裝置管理CLI指令

本節說明您可以使用 Snow 裝置管理從遠端管理 Snow Family 裝置的 AWS CLI 指令。您也可以使用執行一些遠端管理工作 AWS OpsHub for Snow Family。如需詳細資訊，請參閱置上的服務。

注意

在管理您的裝置之前，請確定裝置已開啟電源、連線到您的網路，並且可以連線到佈建的 AWS 區域位置。

主題

使用 Snow 裝置管理建立管理 Snow 系列裝置的工作
檢查管理 Snow 系列裝置的工作狀態
使用 Snow 裝置管理檢查 Snow 系列裝置的相關資訊
使用 Snow 裝置管理，在 Snow 系列裝置上檢查 Amazon EC2 相容執行個體的狀態
使用 Snow 裝置管理功能檢視 Snow 系列裝置上的工作中
使用 Snow 裝置管理取消 Snow 系列裝置上的工作
列出 Snow 裝置管理指令和語法
列出可用於遠端管理的 Snow 系列裝置
列出 Snow 系列裝置上 Snow 裝置管理工作的狀態
使用 Snow 裝置管理列出 Snow 系列裝置上的可用資源
列出 Snow 系列裝置或雪裝置管理標籤的標籤
依狀態列出 Snow 裝置管理工作
將標籤應用於 Snow 設備管理任務或 Snow 系列設備
從工作或 Snow 系列裝置移除 Snow 裝置管理標籤

使用 Snow 裝置管理建立管理 Snow 系列裝置的工作

若要指示一個或多個目標裝置執行工作，例如解除鎖定或重新開機，請使用create-task。您可以透過提供IDs具有--targets參數的受管理設備清單來指定目標裝置，並指定要使用--command參數執行的工作。一次只能在設備上運行一個命令。

支援的命令：

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 系列裝置的工作狀態

若要檢查在一個或多個目標裝置上執行的遠端工作的狀態，請使用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 裝置管理檢查 Snow 系列裝置的相關資訊

若要檢查裝置特定資訊，例如裝置類型、軟體版本、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 裝置管理，在 Snow 系列裝置上檢查 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 裝置管理功能檢視 Snow 系列裝置上的工作中

若要檢查裝置上指定工作的中繼資料，請使用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 裝置管理取消 Snow 系列裝置上的工作

若要傳送特定工作的取消要求，請使用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 裝置管理指令和語法

若要傳回 Snow 裝置管理所有支援指令的清單API，請使用指help令。您也可以使用該help命令返回有關給定命令的詳細信息和語法。

要列出所有支持的命令，請使用以下命令。

命令



aws snow-device-management help

若要傳回命令的詳細資訊和語法，請使用下列命令。command替換為您感興趣的命令的名稱。

命令



aws snow-device-management command help

列出可用於遠端管理的 Snow 系列裝置

若要傳回在執行命令的 AWS 區域位置中啟用 Snow 裝置管理的帳戶上所有裝置的清單，請使用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 系列裝置上 Snow 裝置管理工作的狀態

若要傳回一或多個目標裝置的工作狀態，請使用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 裝置管理列出 Snow 系列裝置上的可用資源

若要傳回裝置可用 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"
        }
    ]
}

若要傳回受管理設備或工作的標籤清單，請使用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 裝置管理工作

使用此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 設備管理任務或 Snow 系列設備

若要新增或取代裝置的標籤，或為裝置上的工作新增或取代標籤，請使用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 系列裝置移除 Snow 裝置管理標籤

若要從裝置移除標籤，或從裝置上的工作移除標籤，請使用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

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

服務的連接埠需 AWS 求

更新 Snowball 邊緣裝置