View a markdown version of this page

获取网关的激活密钥 - AWS Storage Gateway

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

获取网关的激活密钥

要接收网关的激活密钥,请向网关虚拟机 (VM) 发出 Web 请求。VM 返回包含激活密钥的重定向,激活密钥作为 ActivateGateway API 操作的参数之一传递,用于指定网关的配置。有关更多信息,请参阅ActivateGateway存储网关 API 参考》

注意

如果未使用,网关激活密钥将在 30 分钟后过期。

您向网关虚拟机发出的请求包括激活发生的 AWS 区域。响应中重定向返回的 URL 包含称为 activationkey 的查询字符串参数。此查询字符串参数是您的激活密钥。此查询字符串的格式如下所示:http://gateway_ip_address/?activationRegion=activation_region。此查询的输出会返回激活区域和密钥。

URL 还包括 vpcEndpoint,即使用 VPC 端点类型连接的网关的 VPC 端点 ID。

注意

AWS 存储网关硬件设备、虚拟机映像模板和亚马逊 EC2 亚马逊系统映像 (AMI) 预先配置了接收和响应本页所述网络请求所必需的 HTTP 服务。不要求也不建议在网关上安装任何其他服务。

Linux (curl)

以下示例向您显示如何使用 Linux (curl) 获取激活密钥。

注意

将突出显示的变量替换为您的网关的实际值。可接受的值如下所示:

  • gateway_ip_address-您的网关的 IPv4 地址,例如 172.31.29.201

  • gateway_type-您要激活的网关类型,例如STOREDCACHEDVTLFILE_S3、或FILE_FSX_SMB

  • region_code-您要激活网关的地区。请参阅《AWS 一般参考指南》中的区域端点。如果未指定此参数,或者提供的值拼写错误或与有效区域不匹配,则该命令将默认为 us-east-1 区域。

  • vpc_endpoint-例如,您的网关的 VPC 终端节点名称vpce-050f90485f28f2fd0-iep0e8vq.storagegateway.us-west-2.vpce.amazonaws.com

公有端点

要获取公有端点的激活密钥,请使用以下命令之一:

标准端点

要获取标准端点的激活密钥,请执行以下操作:

curl "http://gateway_ip_address/?activationRegion=region_code&no_redirect"
Dual-stack 端点

要获取双堆栈端点的激活密钥,请执行以下操作:

IPv4

curl "http://gateway_ip_address/?activationRegion&endpointType=DUALSTACK&ipVersion=ipv4&no_redirect"

IPv6

curl "http://gateway_ip_address/?activationRegion&endpointType=DUALSTACK&ipVersion=ipv6&no_redirect"
FIPS 端点

要获取 FIPS 端点的激活密钥,请执行以下操作:

IPv4

curl "http://gateway_ip_address/?activationRegion&endpointType=FIPS_DUALSTACK&ipVersion=ipv4&no_redirect"

IPv6

curl "http://gateway_ip_address/?activationRegion&endpointType=FIPS_DUALSTACK&ipVersion=ipv6&no_redirect"
VPC 端点

要获取 VPC 端点的激活密钥,请执行以下操作:

curl "http://gateway_ip_address/?activationRegion=region_code&vpcEndpoint=vpc_endpoint&no_redirect"

Linux (bash/zsh)

以下示例向您展示如何使用 Linux (bash/zsh) 获取 HTTP 响应、解析 HTTP 标头和获取激活密钥。

function get-activation-key() { local ip_address=$1 local activation_region=$2 if [[ -z "$ip_address" || -z "$activation_region" || -z "$gateway_type" ]]; then echo "Usage: get-activation-key ip_address activation_region gateway_type" return 1 fi if redirect_url=$(curl -f -s -S -w '%{redirect_url}' "http://$ip_address/?activationRegion=$activation_region&gatewayType=$gateway_type"); then activation_key_param=$(echo "$redirect_url" | grep -oE 'activationKey=[A-Z0-9-]+') echo "$activation_key_param" | cut -f2 -d= else return 1 fi }

微软 Windows PowerShell

以下示例向你展示如何使用微软视窗 PowerShell 获取 HTTP 响应、解析 HTTP 标头和获取激活密钥。

function Get-ActivationKey { [CmdletBinding()] Param( [parameter(Mandatory=$true)][string]$IpAddress, [parameter(Mandatory=$true)][string]$ActivationRegion, [parameter(Mandatory=$true)][string]$GatewayType ) PROCESS { $request = Invoke-WebRequest -UseBasicParsing -Uri "http://$IpAddress/?activationRegion=$ActivationRegion&gatewayType=$GatewayType" -MaximumRedirection 0 -ErrorAction SilentlyContinue if ($request) { $activationKeyParam = $request.Headers.Location | Select-String -Pattern "activationKey=([A-Z0-9-]+)" $activationKeyParam.Matches.Value.Split("=")[1] } } }

使用本地控制台

以下示例显示了如何使用本地控制台来生成和显示激活密钥。

基于 Amazon Linux 2(AL2)的网关

您可为基于 AL2 的网关选择标准端点或 FIPS 端点。

注意

并非所有 FIPS 终端都 AWS 区域可用。有关更多信息,请参阅按服务分类的 FIPS 端点

从本地控制台获取 AL2-based 网关的激活密钥
  1. 管理员身份登录到本地控制台。

  2. AWS 设备激活 - 配置主菜单中,选择 0 来选择获取激活密钥

  3. 选择 Storage Gateway 作为网关系列选项。

  4. 输入您要激活网关的 AWS 区域。

  5. 对于网络类型,如果是公有端点,则输入 1,如果是 VPC,则输入 2

  6. 对于端点类型,如果是标准端点,则输入 1,如果是美国联邦信息处理标准(FIPS)端点,则输入 2

基于 Amazon Linux 2023(AL2023)的网关

对于基于 AL2023 的网关,提供使用以下端点:

  • 标准端点(仅支持 IPv4)

  • FIPS 端点(仅支持 IPv4)

  • Dual-stack 端点(支持 IPv4 和 IPv6)

  • Dual-stack FIPS 端点(支持 IPv4 和 IPv6)

有关更多信息,请参阅 端点类型

从本地控制台获取 AL2023-based 网关的激活密钥
  1. 登录到本地控制台。如果要从 Windows 计算机连接到 Amazon EC2 实例,请以 admin 身份登录。

  2. AWS 设备激活 - 配置主菜单中,选择 0 来选择获取激活密钥

  3. 选择 Storage Gateway 作为网关系列选项。

  4. 输入您要激活网关的 AWS 区域。

  5. 对于网络类型,如果是公有端点,则输入 1,如果是 VPC 端点,则输入 2

  6. 对于选择端点类型启用 FIPS?,输入 Y 以启用 FIPS,或输入 N 以使用非 FIPS 端点。

  7. 对于端点类型,如果是标准端点,则输入 1,如果是双堆栈端点,则输入 2

    1. 对于双堆栈端点,在选择 IP 版本或退出:中,为 IPv4 输入 1,或为 IPv6 输入 2