AWS Snowball
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本指南适用于 Snowball Edge。如果您正在查找 Snowball 的相关文档,请参阅 AWS Snowball 用户指南

适用于计算实例的 Snowball 客户端命令

Snowball 客户端是一个您可以在本地服务器上运行的独立终端应用程序。它使您能够在 Snowball Edge 设备或设备集群上执行某些管理任务。有关如何使用 Snowball 客户端(包括如何启动和停止服务)的更多信息,请参阅使用 Snowball 客户端

在下文中,您可找到有关特定于计算实例的 Snowball 客户端 命令的信息,包括使用示例。

有关您可以在 AWS Snowball Edge 设备 上使用的 Amazon EC2 命令的列表,请参阅 Snowball Edge 上支持用于 Amazon EC2 的 AWS CLI 命令

创建启动配置以自动启动 Amazon EC2 实例

要在 Amazon EC2 计算实例解锁后自动在 AWS Snowball Edge 设备 上启动它,您可以创建启动配置。要执行此操作,请使用 snowballEdge create-autostart-configuration 命令,其用法如下所示。

用法

snowballEdge create-autostart-configuration --physical-connector-type [SFP_PLUS or RJ45 or QSFP] --ip-address-assignment [DHCP or STATIC] [--static-ip-address-configuration IpAddress=[IP address],NetMask=[Netmask]] --launch-template-id [--launch-template-version]

更新要自动启动 EC2 实例的启动配置

要在您的 Snowball Edge 上更新现有的启动配置,请使用 snowballEdge update-autostart-configuration 命令。您可以在下面找到其用法。要启用或禁用启动配置,请指定 --enabled 参数。

用法

snowballEdge update-autostart-configuration --autostart-configuration-arn [--physical-connector-type [SFP_PLUS or RJ45 or QSFP]] [--ip-address-assignment [DHCP or STATIC]] [--static-ip-address-configuration IpAddress=[IP address],NetMask=[Netmask]] [--launch-template-id] [--launch-template-version] [--enabled]

删除要自动启动 EC2 实例的启动配置

要删除不再使用的启动配置,请使用 snowballEdge delete-autostart-configuration 命令。您可以在下面找到其用法。

用法

snowballEdge delete-autostart-configuration --autostart-configuration-arn

列出要自动启动 EC2 实例的启动配置

要列出已在您的 Snowball Edge 上创建的启动配置,请使用 describe-autostart-configurations 命令。您可以在下面找到其用法。

用法

snowballEdge describe-autostart-configurations

创建虚拟网络接口

要在 Snowball Edge 上运行计算实例或启动文件接口,请先在 Snowball Edge 上创建虚拟网络接口 (VNIC)。每个 Snowball Edge 具有三个网络接口 (NIC),即设备的物理网络接口控制器。这些接口就是设备背面的 RJ45、SFP 和 QSFP 端口。

每个 VNIC 基于物理接口,您可以有任意数量的 VNIC 与每个 NIC 关联。要创建虚拟网络接口,请使用 snowballEdge create-virtual-network-interface 命令。

注意

只有当将 STATIC 选项用于 --ip-address-assignment 参数时,--static-ip-address-configuration 参数才有效。

用法

您可以以两种方法使用此命令:在配置了 Snowball 客户端 的情况下或在未配置 Snowball 客户端 的情况下。以下用法示例显示了在配置了 Snowball 客户端 的情况下的方法。

snowballEdge create-virtual-network-interface --ip-address-assignment [DHCP or STATIC] --physical-network-interface-id [physical network interface id] --static-ip-address-configuration IpAddress=[IP address],NetMask=[Netmask]

以下用法示例显示了在未配置 Snowball 客户端 的情况下的方法。

snowballEdge create-virtual-network-interface --endpoint https://[ip address] --manifest-file /path/to/manifest --unlock-code [unlock code] --ip-address-assignment [DHCP or STATIC] --physical-network-interface-id [physical network interface id] --static-ip-address-configuration IpAddress=[IP address],NetMask=[Netmask]

例 示例:创建 VNIC(使用 DHCP)

./snowballEdge create-virtual-network-interface --ip-address-assignment dhcp --physical-network-interface-id s.ni-8EXAMPLEaEXAMPLEd { "VirtualNetworkInterface" : { "VirtualNetworkInterfaceArn" : "arn:aws:snowball-device:::interface/s.ni-8EXAMPLE8EXAMPLEf", "PhysicalNetworkInterfaceId" : "s.ni-8EXAMPLEaEXAMPLEd", "IpAddressAssignment" : "DHCP", "IpAddress" : "192.0.2.0", "Netmask" : "255.255.255.0", "DefaultGateway" : "192.0.2.1", "MacAddress" : "EX:AM:PL:E1:23:45" } }

描述您的虚拟网络接口

要描述您在设备上先前创建的 VNIC,请使用 snowballEdge describe-virtual-network-interfaces 命令。您可以在下面找到其用法。

用法

您可以以两种方法使用此命令:在配置了 Snowball 客户端 的情况下或在未配置 Snowball 客户端 的情况下。以下用法示例显示了在配置了 Snowball 客户端 的情况下的方法。

snowballEdge describe-virtual-network-interfaces

以下用法示例显示了在未配置 Snowball 客户端 的情况下的方法。

snowballEdge describe-virtual-network-interfaces --endpoint https://[ip address] --manifest-file /path/to/manifest --unlock-code [unlock code]

例 示例:描述 VNIC

./snowballEdge describe-virtual-network-interfaces [ { "VirtualNetworkInterfaceArn" : "arn:aws:snowball-device:::interface/s.ni-8EXAMPLE8EXAMPLE8", "PhysicalNetworkInterfaceId" : "s.ni-8EXAMPLEaEXAMPLEd", "IpAddressAssignment" : "DHCP", "IpAddress" : "192.0.2.0", "Netmask" : "255.255.255.0", "DefaultGateway" : "192.0.2.1", "MacAddress" : "EX:AM:PL:E1:23:45" },{ "VirtualNetworkInterfaceArn" : "arn:aws:snowball-device:::interface/s.ni-1EXAMPLE1EXAMPLE1", "PhysicalNetworkInterfaceId" : "s.ni-8EXAMPLEaEXAMPLEd", "IpAddressAssignment" : "DHCP", "IpAddress" : "192.0.2.2", "Netmask" : "255.255.255.0", "DefaultGateway" : "192.0.2.1", "MacAddress" : "12:34:5E:XA:MP:LE" } ]

更新虚拟网络接口

在创建虚拟网络接口 (VNIC) 后,您可以使用 snowballEdge update-virtual-network-interface 命令更新其配置。在为特定 VNIC 提供 Amazon 资源名称 (ARN) 后,您仅需为您要更新的任何元素提供值。

用法

您可以以两种方法使用此命令:在配置了 Snowball 客户端 的情况下或在未配置 Snowball 客户端 的情况下。以下用法示例显示了在配置了 Snowball 客户端 的情况下的方法。

snowballEdge update-virtual-network-interface --virtual-network-interface-arn [virtual network-interface-arn] --ip-address-assignment [DHCP or STATIC] --physical-network-interface-id [physical network interface id] --static-ip-address-configuration IpAddress=[IP address],NetMask=[Netmask]

以下用法示例显示了在未配置 Snowball 客户端 的情况下的方法。

snowballEdge update-virtual-network-interface --endpoint https://[ip address] --manifest-file /path/to/manifest --unlock-code [unlock code] --virtual-network-interface-arn [virtual network-interface-arn] --ip-address-assignment [DHCP or STATIC] --physical-network-interface-id [physical network interface id] --static-ip-address-configuration IpAddress=[IP address],NetMask=[Netmask]

例 示例:更新 VNIC(使用 DHCP)

./snowballEdge update-virtual-network-interface --virtual-network-interface-arn arn:aws:snowball-device:::interface/s.ni-8EXAMPLEbEXAMPLEd --ip-address-assignment dhcp

删除虚拟网络接口

要删除虚拟网络接口,您可以使用 snowballEdge delete-virtual-network-interface 命令。

用法

您可以以两种方法使用此命令:在配置了 Snowball 客户端 的情况下或在未配置 Snowball 客户端 的情况下。以下用法示例显示了在配置了 Snowball 客户端 的情况下的方法。

snowballEdge delete-virtual-network-interface --virtual-network-interface-arn [virtual network-interface-arn]

以下用法示例显示了在未配置 Snowball 客户端 的情况下的方法。

snowballEdge delete-virtual-network-interface --endpoint https://[ip address] --manifest-file /path/to/manifest --unlock-code [unlock code] --virtual-network-interface-arn [virtual network-interface-arn]

例 示例:删除 VNIC

./snowballEdge delete-virtual-network-interface --virtual-network-interface-arn arn:aws:snowball-device:::interface/s.ni-8EXAMPLEbEXAMPLEd