本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# AWS Snowball Edge Device Management 用于管理 Snowball Edge
AWS Snowball Edge Device Management 允许您远程管理 Snowball Edge 和本地 AWS 服务。所有 Snowball Edge 都支持 Snowball Edge 设备管理，并且它已安装在大多数可用 AWS 区域 Snowball Edge 的地方的新设备上。
使用 Snowball Edge 设备管理，您可以执行以下任务：
+ 创建任务。
+ 检查任务状态
+ 查看任务元数据
+ 取消任务
+ 查看设备信息
+ 检查 EC2与 Amazon 兼容的实例状态
+ 列出命令和语法
+ 列出可远程管理的设备
+ 列出各设备的任务状态
+ 列出可用资源
+ 按状态列出任务
+ 列出设备或任务标签
+ 应用标签
+ 删除标签
**Topics**
+ [订购 Snowball Edge 时选择 Snowball Edge 设备管理状态](#order-device-sdm-state)
+ [在 Snowball Edge 上激活 Snowball Edge 设备管理](#enable-sdm)
+ [向 Snowball Edge 上的 IAM 角色添加 Snowball Edge 设备管理权限](#iam-sdm)
+ [Snowball Edge 设备管理 CLI 命令](#sdm-cli-commands)
## 订购 Snowball Edge 时选择 Snowball Edge 设备管理状态
在创建订购 Snow 设备的任务时，您可以选择在收到设备时 Snowball Edge 设备管理将处于哪种状态：已安装但未激活或已安装并激活。如果已安装但未激活，则需要使用 AWS OpsHub 或 Snowball Edge 客户端将其激活，然后才能使用它。如果已安装并激活 Snowball Edge 设备管理，则可以在收到设备并将其连接到本地网络后使用 Snowball Edge 设备管理。在创建任务时，您可以选择 Snowball Edge 设备管理状态，以便通过、Snowball Edge 客户端 AWS Snow 系列管理控制台 AWS CLI、或 Snow 任务管理 API 订购设备。
**要从中选择 Snowball Edge 设备管理状态 AWS Snow 系列管理控制台**
1. 要选择安装和激活 Snowball Edge 设备管理，请选择**使用远程管理您的 Snow 设备或 AWS OpsHub Snowball 客户**端。
1. 要选择安装但不激活 Snowball Edge 设备管理，请不要选择**使用远程管理您的 Snowball 设备或 AWS OpsHub Snowball 客户**端。
有关更多信息，请参阅本指南中的[第 3 步：选择您的特征和选项](https://docs.aws.amazon.com/snowball/latest/developer-guide/import-job-details.html)。
**要从 Snowball Edge 客户端或 Snow 作业管理 API 中选择 AWS CLI Snowball Edge 设备管理状态，请执行以下操作：**
+ 使用`remote-management`参数指定 Snowball Edge 设备管理状态。该参数的`INSTALLED_ONLY`值表示 Snowball Edge 设备管理已安装但未激活。该参数的`INSTALLED_AUTOSTART`值表示 Snowball Edge 设备管理已安装并激活。如果您不为此参数指定值，则默认值为 `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 参考》中的 Job 管理](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 设备连接到您的本地网络。有关更多信息，请参阅[连接到本地网络AWS Snowball Edge](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 上的 IAM 角色添加 Snowball Edge 设备管理权限
在 AWS 账户 订购设备时创建一个 AWS Identity and Access Management (IAM) 角色，然后向该角色添加以下策略。然后，将该角色分配给将登录并通过 Snowball Edge 设备管理远程管理您的设备的 IAM 用户。有关更多信息，请参阅[创建 IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html)和[在您的 AWS 账户中创建 IAM 用户](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html)。
**Policy**
------
#### [ 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)
+ [使用 EC2 Snowball Edge 设备管理功能在 Snowball Edge 上查看与亚马逊兼容的实例的状态](#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`。您可以通过提供 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"
}
```
### 检查管理 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 Cloud的时间。表示设备处于在线状态。
+ `lastUpdatedAt`：设备上次更新数据的时间。表示设备缓存何时刷新。
要查看设备信息，请使用以下命令。将每个 `user input placeholder` 替换为您自己的信息。
**命令**
```
aws snow-device-management describe-device \
--managed-device-id smd-fictqic6gcldf111
```
**异常**
```
ValidationException
ResourceNotFoundException
InternalServerException
ThrottlingException
AccessDeniedException
```
### 使用 EC2 Snowball Edge 设备管理功能在 Snowball Edge 上查看与亚马逊兼容的实例的状态
要检查 Amazon EC2 实例的当前状态，请使用`describe-ec2-instances`命令。输出与`describe-device`命令的输出类似，但结果来自中的设备缓存， AWS Cloud 并且包括可用字段的子集。
要检查与 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"
}
]
}
```
### 使用 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 设备管理 API 支持的所有命令的列表，请使用命令。`help`您还可以使用 `help` 命令来返回给定命令的详细信息和语法。
要列出所有支持的命令，请使用以下命令。
**命令**
```
aws snow-device-management help
```
套返回命令的详细信息和语法，请使用以下命令。将 `command` 替换为您感兴趣的命令的名称。
**命令**
```
aws snow-device-management command help
```
### 列出可用于远程管理的 Snowball Edge
要返回您账户中在运行命令的 AWS 区域 位置启用了 Snowball Edge 设备管理的所有设备的列表，请使用命令。`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` 参数。目前， EC2与 Amazon 兼容的实例是唯一支持的资源类型。 `--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 资源名称（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
```