本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 AWS Snowball Edge 裝置管理 管理 Snowball Edge
AWS Snowball Edge 裝置管理 可讓您從遠端管理您的 Snowball Edge 和本機 AWS 服務。所有 Snowball Edge 都支援 Snowball Edge 裝置管理，並安裝在可使用 Snowball Edge 的大多數 AWS 區域 新裝置上。
使用 Snowball Edge 裝置管理，您可以執行下列任務：
+ 建立任務
+ 檢查任務狀態
+ 檢查任務中繼資料
+ 取消任務
+ 檢查裝置資訊
+ 檢查 Amazon EC2-compatible執行個體狀態
+ 列出命令和語法
+ 列出可遠端管理的裝置
+ 列出跨裝置的任務狀態
+ 列出可用的資源
+ 依狀態列出任務
+ 列出裝置或任務標籤
+ 套用標籤
+ 移除標籤
**Topics**
+ [訂購 Snowball Edge 時選擇 Snowball Edge 裝置管理狀態](#order-device-sdm-state)
+ [在 Snowball Edge 上啟用 Snowball Edge 裝置管理](#enable-sdm)
+ [將 Snowball Edge 裝置管理的許可新增至 Snowball Edge 上的 IAM 角色](#iam-sdm)
+ [Snowball Edge 裝置管理 CLI 命令](#sdm-cli-commands)
## 訂購 Snowball Edge 時選擇 Snowball Edge 裝置管理狀態
當您建立任務來訂購 Snow 裝置時，您可以選擇收到裝置時 Snowball Edge 裝置管理將處於哪個狀態：已安裝，但未啟用，或未安裝和啟用。如果已安裝但未啟用，您將需要使用 AWS OpsHub 或 Snowball Edge 用戶端來啟用它，才能使用它。如果已安裝並啟用，您可以在收到裝置並將其連線至本機網路後，使用 Snowball Edge 裝置管理。您可以在建立透過 AWS Snow 系列管理主控台、Snowball Edge 用戶端 AWS CLI、 或 Snowball 任務管理 API 訂購裝置的任務時，選擇 Snowball Edge 裝置管理狀態。
**從 選擇 Snowball Edge 裝置管理狀態 AWS Snow 系列管理主控台**
1. 若要選擇要安裝和啟用的 Snowball Edge 裝置管理，請選擇**使用 AWS OpsHub 或 Snowball 用戶端遠端管理您的 Snow** 裝置。
1. 若要選擇讓 Snowball Edge 裝置管理安裝但未啟用，請勿選取**使用 AWS OpsHub 或 Snowball 用戶端遠端管理您的 Snow** 裝置。
如需詳細資訊，請參閱本指南中的[步驟 3：選擇您的功能和選項](https://docs.aws.amazon.com/snowball/latest/developer-guide/import-job-details.html)。
**若要從 AWS CLI、Snowball Edge 用戶端或 Snow 任務管理 API 選擇 Snowball Edge 裝置管理狀態：**
+ 使用 `remote-management` 參數來指定 Snowball Edge 裝置管理狀態。參數`INSTALLED_ONLY`的值表示已安裝 Snowball Edge Device Management，但未啟用。參數`INSTALLED_AUTOSTART`的值表示已安裝並啟用 Snowball Edge Device Management。如果您未指定此參數的值，則 `INSTALLED_ONLY` 為預設值。
**Example `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 參考》中的任務管理](https://docs.aws.amazon.com/snowball/latest/api-reference/api-reference.html) AWS Snowball Edge API 參考。
## 在 Snowball Edge 上啟用 Snowball Edge 裝置管理
依照此程序，使用 Snowball Edge 用戶端啟用 Snowball Edge 裝置管理。
使用此程序之前，請執行下列動作：
+ 下載並安裝最新版本的 Snowball Edge 用戶端。如需詳細資訊，請參閱[下載並安裝 Snowball 用戶端](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client.html#download-client)。
+ 下載資訊清單檔案並取得 Snowball Edge 裝置的解鎖碼。如需詳細資訊，請參閱[取得您的登入資料和工具](https://docs.aws.amazon.com/snowball/latest/developer-guide/get-credentials.html)。
+ 將 Snowball Edge 裝置連接到您的本機網路。如需詳細資訊，請參閱[連線至本機 NetworkDevice](https://docs.aws.amazon.com/snowball/latest/developer-guide/getting-started-connect.html)。
+ 解除鎖定 Snowball Edge 裝置。如需詳細資訊，請參閱[解鎖 Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html)在。
```
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 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html)和建立 IAM 使用者。 [AWS 帳戶](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html)
**政策**
------
#### [ JSON ]
****
```
{
"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": "*"
}
]
}
```
------
## Snowball Edge 裝置管理 CLI 命令
本節說明您可以使用 Snowball Edge 裝置管理遠端管理 Snowball Edge 的 AWS CLI 命令。您也可以使用 執行一些遠端管理任務 AWS OpsHub。如需詳細資訊，請參閱[管理裝置上的 AWS 服務](https://docs.aws.amazon.com/snowball/latest/developer-guide/manage-services.html)。
**注意**
管理裝置之前，請確定裝置已開啟電源、連線至您的網路，並且可以連線至佈建 AWS 區域 裝置的 。
**Topics**
+ [使用 Snowball Edge 裝置管理建立管理 Snowball Edge 的任務](#sdm-cli-create-task)
+ [檢查任務的狀態以管理 Snowball Edge](#sdm-cli-describe-execution)
+ [使用 Snowball Edge 裝置管理檢查 Snowball Edge 的相關資訊](#sdm-cli-describe-device)
+ [使用 Snowball Edge 裝置管理檢查 Snowball Edge 上 EC2-compatible執行個體的狀態](#sdm-cli-describe-ec2-instances)
+ [使用 Snowball Edge 裝置管理檢視 Snowball Edge 上的任務中繼資料](#sdm-cli-describe-task)
+ [使用 Snowball Edge 裝置管理取消 Snowball Edge 上的任務](#sdm-cli-cancel-task)
+ [列出 Snowball Edge 裝置管理命令和語法](#sdm-cli-help)
+ [列出可用於遠端管理的 Snowball Edge](#sdm-cli-list-devices)
+ [列出跨 Snowball Edge 的 Snowball Edge 裝置管理任務狀態](#sdm-cli-list-executions)
+ [使用 Snowball Edge 裝置管理列出 Snowball Edge 上的可用資源](#sdm-cli-list-device-resources)
+ [列出 Snowball Edge 或 Snowball Edge 裝置管理標籤的標籤](#sdm-cli-list-tags-for-resource)
+ [依狀態列出 Snowball Edge 裝置管理任務](#sdm-cli-list-tasks)
+ [將標籤貼到 Snowball Edge 裝置管理任務或 Snowball Edge](#sdm-cli-tag-resource)
+ [從任務或 Snowball Edge 移除 Snowball Edge 裝置管理標籤](#sdm-cli-untag-resources)
### 使用 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 分頁選項](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html)。
若要列出可遠端管理的裝置，請使用下列命令。將每個 `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 分頁選項](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html)。
任務可以有下列其中一種狀態：
+ `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 分頁選項](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html)。
若要列出裝置的可用資源，請使用下列命令。將每個 `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"
}
]
}
```
### 列出 Snowball Edge 或 Snowball Edge 裝置管理標籤的標籤
若要傳回受管裝置或任務的標籤清單，請使用 `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 分頁選項](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html)。
若要依狀態列出任務，請使用下列命令。將每個 `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
```