本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
获取网关的激活密钥
要接收网关的激活密钥,请向网关虚拟机 (VM) 发出 Web 请求。VM 返回包含激活密钥的重定向,激活密钥作为 ActivateGateway
API 操作的参数之一传递,用于指定网关的配置。有关更多信息,请参阅 Storage Gateway API 参考ActivateGateway中的。
注意
如果未使用,网关激活密钥将在 30 分钟后过期。
您向网关 VM 发出的请求包括激活发生的 Amazon 区域。响应中重定向返回的 URL 包含称为 activationkey
的查询字符串参数。此查询字符串参数是您的激活密钥。此查询字符串的格式如下所示:http://
。此查询的输出会返回激活区域和密钥。gateway_ip_address
/?activationRegion=activation_region
URL 还包括 vpcEndpoint
,即使用 VPC 端点类型连接的网关的 VPC 端点 ID。
注意
Storage Gateway 硬件设备、虚拟机映像模板和 EC2 亚马逊系统映像 (AMI) 已预先配置了接收和响应本页所述网络请求所需的 HTTP 服务。不要求也不建议在网关上安装任何其他服务。
Linux (curl)
以下示例向您显示如何使用 Linux (curl) 获取激活密钥。
注意
将突出显示的变量替换为您的网关的实际值。可接受的值如下所示:
-
gateway_ip_address
-您的网关 IPv4 地址,例如172.31.29.201
-
gateway_type
-您要激活的网关类型,例如STORED
CACHED
、VTL
、FILE_S3
、或FILE_FSX_SMB
。 -
region_code
-您要激活网关的区域。请参阅《Amazon 一般参考指南》中的区域端点。如果未指定此参数,或者提供的值拼写错误或与有效区域不匹配,则该命令将默认为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"
双堆栈端点
要获取双栈端点的激活密钥,请执行以下操作:
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
以下示例向您展示了如何使用 Microsoft Windows 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] } } }
使用本地控制台
以下示例说明如何使用本地控制台生成和显示激活密钥。
基于亚马逊 Linux 2 (AL2) 的网关
您可以根据为网关选择标准端点或 FIPS 端点。 AL2
注意
FIPS 端点并非全部 Amazon Web Services 区域可用。有关更多信息,请参阅按服务划分的 FIPS 终端节点
从本地控制台获取 AL2基于您的网关的激活密钥
-
以管理员身份登录您的本地控制台。
-
从 “Amazon 设备激活-配置” 主菜单中
0
,选择获取激活密钥。 -
选择 Storage Gateway 作为网关系列选项。
-
输入您要激活网关的 Amazon 区域。
-
对于网络类型,请输入 “
1
公共” 或 “V2
PC”。 -
对于端点类型,请输入 “
1
标准” 或2
“联邦信息处理标准 (FIPS)”。
基于亚马逊 Linux 2023 (AL2023) 的网关
对于基于 AL2 023 的网关,以下终端节点可用:
-
标准端点( IPv4 仅支持)
-
FIPS 端点( IPv4 仅支持)
-
双栈端点(支持 IPv4 和 IPv6)
-
双栈 FIPS 端点(支持 IPv4 和) IPv6
有关更多信息,请参阅 端点类型。
从本地控制台获取 AL2基于 023 的网关的激活密钥
-
登录到本地控制台。如果您是从 Windows 计算机连接到您的亚马逊 EC2 实例,请以管理员身份登录。
-
从 “Amazon 设备激活-配置” 主菜单中
0
,选择获取激活密钥。 -
选择 Storage Gateway 作为网关系列选项。
-
输入您要激活网关的 Amazon 区域。
-
对于网络类型,输入 “
1
公共” 或2
“VPC 终端节点”。 -
对于选择端点类型,启用 FIPS? ,输入
Y
以启用 FIPS 或N
使用非 FIPS 端点。 -
对于端点类型,请
1
为标准端点或2
双堆栈端点输入。-
对于双栈端点,在选择 IP 版本或退出:中,输入 for IPv4 或
1
f2
or。 IPv6
-