在訂購 Snowball Edge 時選擇 Snowball Edge 裝置管理狀態在 Snowball Edge 上啟用 Snowball Edge 裝置管理將 Snowball Edge 裝置管理的許可新增至 Snowball Edge 上的 IAM 角色 Snowball Edge 裝置管理 CLI 命令

使用AWS Snowball Edge 裝置管理管理 Snowball Edge

AWS Snowball Edge 裝置管理可讓您遠端管理您的 Snowball Edge 和本機AWS服務。所有 Snowball Edge 都支援 Snowball Edge 裝置管理，並安裝在可使用 Snowball Edge 的大多數AWS 區域新裝置上。

透過 Snowball Edge Device Management，您可以執行下列任務：

建立任務
檢查任務狀態
檢查任務中繼資料
取消任務
檢查裝置資訊
檢查 Amazon EC2-compatible執行個體狀態
列出命令和語法
列出可遠端管理的裝置
列出跨裝置的任務狀態
列出可用的資源
依狀態列出任務
列出裝置或任務標籤
套用標籤
移除標籤

主題

在訂購 Snowball Edge 時選擇 Snowball Edge 裝置管理狀態
在 Snowball Edge 上啟用 Snowball Edge 裝置管理
將 Snowball Edge 裝置管理的許可新增至 Snowball Edge 上的 IAM 角色
Snowball Edge 裝置管理 CLI 命令

在訂購 Snowball Edge 時選擇 Snowball Edge 裝置管理狀態

當您建立任務來訂購 Snow 裝置時，您可以選擇在收到裝置時 Snowball Edge 裝置管理將處於哪個狀態：已安裝，但未啟用，或未安裝和啟用。如果已安裝但未啟用，您將需要使用AWS OpsHub或 Snowball Edge 用戶端來啟用它，才能使用它。如果已安裝並啟用，您可以在收到裝置並將其連線至本機網路後，使用 Snowball Edge 裝置管理。您可以在建立任務以透過AWS Snow 系列管理主控台、Snowball Edge 用戶端AWS CLI、或 Snow 任務管理 API 訂購裝置時，選擇 Snowball Edge 裝置管理狀態。

從選擇 Snowball Edge 裝置管理狀態AWS Snow 系列管理主控台

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

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

若要從、Snowball Edge 用戶端或AWS CLI Snow 任務管理 API 選擇 Snowball Edge 裝置管理狀態：

使用 remote-management 參數來指定 Snowball Edge 裝置管理狀態。參數INSTALLED_ONLY的值表示已安裝 Snowball Edge Device Management，但未啟用。參數INSTALLED_AUTOSTART的值表示已安裝並啟用 Snowball Edge 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 Edge API 參考。

在 Snowball Edge 上啟用 Snowball Edge 裝置管理

依照此程序，使用 Snowball Edge 用戶端啟用 Snowball Edge 裝置管理。

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

下載並安裝最新版本的 Snowball Edge 用戶端。如需詳細資訊，請參閱下載並安裝 Snowball 用戶端。
下載資訊清單檔案並取得 Snowball Edge 裝置的解鎖碼。如需詳細資訊，請參閱取得您的登入資料和工具。
將 Snowball Edge 裝置連接到您的本機網路。如需詳細資訊，請參閱連線至本機 NetworkDevice。
解除鎖定 Snowball Edge 裝置。如需詳細資訊，請參閱解鎖 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"
  }

將 Snowball Edge 裝置管理的許可新增至 Snowball Edge 上的 IAM 角色

在訂購裝置的AWS 帳戶上，建立AWS Identity and Access Management(IAM) 角色，並將下列政策新增至角色。然後，將角色指派給將登入以使用 Snowball Edge 裝置管理遠端管理裝置的 IAM 使用者。如需詳細資訊，請參閱在中建立 IAM 角色和建立 IAM 使用者。 AWS 帳戶

政策

Snowball Edge 裝置管理 CLI 命令

本節說明您可以使用 Snowball Edge 裝置管理遠端管理 Snowball Edge 的AWS CLI命令。您也可以使用執行一些遠端管理任務AWS OpsHub。如需詳細資訊，請參閱管理裝置上的AWS服務。

注意

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

主題

使用 Snowball Edge 裝置管理建立管理 Snowball Edge 的任務
檢查任務的狀態以管理 Snowball Edge
使用 Snowball Edge 裝置管理檢查 Snowball Edge 的相關資訊
使用 Snowball Edge 裝置管理檢查 Snowball Edge 上 EC2-compatible執行個體的狀態
使用 Snowball Edge 裝置管理在 Snowball Edge 上檢視任務中繼資料
使用 Snowball Edge 裝置管理取消 Snowball Edge 上的任務
列出 Snowball Edge 裝置管理命令和語法
列出可用於遠端管理的 Snowball Edge
列出跨 Snowball Edge 的 Snowball Edge 裝置管理任務狀態
使用 Snowball Edge 裝置管理列出 Snowball Edge 上的可用資源
列出 Snowball Edge 或 Snowball Edge 裝置管理標籤的標籤
依狀態列出 Snowball Edge 裝置管理任務
將標籤貼到 Snowball Edge 裝置管理任務或 Snowball Edge
從任務或 Snowball Edge 移除 Snowball Edge 裝置管理標籤

使用 Snowball Edge 裝置管理建立管理 Snowball Edge 的任務

若要指示一或多個目標裝置執行任務，例如解除鎖定或重新啟動，請使用 create-task。您可以使用 --targets 參數提供受管裝置 IDs 清單來指定目標裝置，並指定要使用 --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"
}

檢查任務的狀態以管理 Snowball Edge

若要檢查在一或多個目標裝置上執行之遠端任務的狀態，請使用 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"
}

使用 Snowball Edge 裝置管理檢查 Snowball Edge 的相關資訊

若要檢查裝置特定資訊，例如裝置類型、軟體版本、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

使用 Snowball Edge 裝置管理檢查 Snowball Edge 上 EC2-compatible執行個體的狀態

若要檢查 Amazon EC2 執行個體的目前狀態，請使用 describe-ec2-instances命令。輸出類似於 describe-device命令的輸出，但結果來自中的裝置快取，AWS 雲端並包含可用欄位的子集。

若要檢查 Amazon EC2-compatible執行個體的狀態，請使用下列命令。將每個 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"
        }
    ]
}

使用 Snowball Edge 裝置管理在 Snowball Edge 上檢視任務中繼資料

若要檢查裝置上指定任務的中繼資料，請使用 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"
}

使用 Snowball Edge 裝置管理取消 Snowball Edge 上的任務

若要傳送特定任務的取消請求，請使用 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"
}

列出 Snowball Edge 裝置管理命令和語法

若要傳回 Snowball Edge Device Management API 所有支援的命令清單，請使用 help命令。您也可以使用 help命令來傳回指定命令之和語法的詳細資訊。

若要列出所有支援的命令，請使用下列命令。

命令



aws snow-device-management help

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

命令



aws snow-device-management command help

列出可用於遠端管理的 Snowball Edge

若要傳回在執行AWS 區域命令的中已啟用 Snowball Edge 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": {}
        }
    ]
}

列出跨 Snowball Edge 的 Snowball Edge 裝置管理任務狀態

若要傳回一或多個目標裝置的任務狀態，請使用 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"
        }
    ]
}

使用 Snowball Edge 裝置管理列出 Snowball Edge 上的可用資源

若要傳回裝置可用的AWS資源清單，請使用 list-device-resources命令。若要依特定類型的資源篩選清單，請使用 --type 參數。目前，Amazon EC2-compatible執行個體是唯一支援的資源類型。 --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 Resource Name (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"
    }
}

依狀態列出 Snowball Edge 裝置管理任務

使用 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"
          
        }
    ]
}

將標籤貼到 Snowball Edge 裝置管理任務或 Snowball Edge

若要為裝置或裝置上的任務新增或取代標籤，請使用 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

從任務或 Snowball Edge 移除 Snowball Edge 裝置管理標籤

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

使用AWS Snowball Edge 裝置管理管理 Snowball Edge

主題

在訂購 Snowball Edge 時選擇 Snowball Edge 裝置管理狀態

從 選擇 Snowball Edge 裝置管理狀態AWS Snow 系列管理主控台

若要從、Snowball Edge 用戶端或AWS CLI Snow 任務管理 API 選擇 Snowball Edge 裝置管理狀態：

範例 create-job 命令之 remote-management 參數的語法

在 Snowball Edge 上啟用 Snowball Edge 裝置管理

將 Snowball Edge 裝置管理的許可新增至 Snowball Edge 上的 IAM 角色

Snowball Edge 裝置管理 CLI 命令

注意

主題

使用 Snowball Edge 裝置管理建立管理 Snowball Edge 的任務

檢查任務的狀態以管理 Snowball Edge

使用 Snowball Edge 裝置管理檢查 Snowball Edge 的相關資訊

使用 Snowball Edge 裝置管理檢查 Snowball Edge 上 EC2-compatible執行個體的狀態

使用 Snowball Edge 裝置管理在 Snowball Edge 上檢視任務中繼資料

使用 Snowball Edge 裝置管理取消 Snowball Edge 上的任務

注意

列出 Snowball Edge 裝置管理命令和語法

列出可用於遠端管理的 Snowball Edge

列出跨 Snowball Edge 的 Snowball Edge 裝置管理任務狀態

使用 Snowball Edge 裝置管理列出 Snowball Edge 上的可用資源

列出 Snowball Edge 或 Snowball Edge 裝置管理標籤的標籤

依狀態列出 Snowball Edge 裝置管理任務

將標籤貼到 Snowball Edge 裝置管理任務或 Snowball Edge

從任務或 Snowball Edge 移除 Snowball Edge 裝置管理標籤

從選擇 Snowball Edge 裝置管理狀態AWS Snow 系列管理主控台

範例 `create-job` 命令之 `remote-management` 參數的語法