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

# 获取网关的激活密钥
获取激活密钥

要接收网关的激活密钥，请向网关虚拟机 (VM) 发出 Web 请求。VM 返回包含激活密钥的重定向，激活密钥作为 `ActivateGateway` API 操作的参数之一传递，用于指定网关的配置。有关更多信息，请参阅 *Storage Gateway API 参考[ActivateGateway](https://docs.amazonaws.cn/storagegateway/latest/APIReference/API_ActivateGateway.html)*中的。

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

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

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

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

**Topics**
+ [

## Linux (curl)
](#get-activation-key-linux-curl)
+ [

## Linux (bash/zsh)
](#get-activation-key-linux)
+ [

## 微软 Windows PowerShell
](#get-activation-key-powershell)
+ [

## 使用本地控制台
](#using-local-console)

## Linux (curl)


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

**注意**  
将突出显示的变量替换为您的网关的实际值。可接受的值如下所示：  
*gateway\$1ip\$1address*-您的网关 IPv4 地址，例如 `172.31.29.201`
*gateway\$1type*-您要激活的网关类型，例如`STORED``CACHED`、`VTL`、`FILE_S3`、或`FILE_FSX_SMB`。
*region\$1code*-您要激活网关的区域。请参阅**《Amazon 一般参考指南》中的[区域端点](https://docs.amazonaws.cn/general/latest/gr/rande.html#regional-endpoints)。如果未指定此参数，或者提供的值拼写错误或与有效区域不匹配，则该命令将默认为 `us-east-1` 区域。
*vpc\$1endpoint*-例如，网关的 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 端点](https://www.amazonaws.cn/compliance/fips/)。

**从本地控制台获取 AL2基于您的网关的激活密钥**

1. 以**管理员身份登录到本地控制台。

1. 从 **Amazon 设备激活 - 配置**主菜单中，选择 `0` 来选择**获取激活密钥**。

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

1. 输入要激活网关的 Amazon 区域。

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

1. 对于端点类型，如果是标准端点，则输入 `1`，如果是美国联邦信息处理标准（FIPS）端点，则输入 `2`。

**基于亚马逊 Linux 2023 (AL2023) 的网关**

对于基于的网关 AL2023，以下终端节点可用：
+ 标准端点（ IPv4 仅支持）
+ FIPS 端点（ IPv4 仅支持）
+ 双栈端点（支持 IPv4 和 IPv6）
+ 双栈 FIPS 端点（支持 IPv4 和） IPv6

有关更多信息，请参阅 [端点类型](Requirements.md#endpoint-types-fgw)。

**从本地控制台获取 AL2023基于您的网关的激活密钥**

1. 登录到本地控制台。如果要从 Windows 计算机连接到 Amazon EC2 实例，请以 *admin* 身份登录。

1. 从 **Amazon 设备激活 - 配置**主菜单中，选择 `0` 来选择**获取激活密钥**。

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

1. 输入要激活网关的 Amazon 区域。

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

1. 对于**选择端点类型**，**启用 FIPS？**，输入 `Y` 以启用 FIPS，或输入 `N` 以使用非 FIPS 端点。

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

   1. 对于双栈端点，在**选择 IP 版本或退出:**中，输入 for IPv4 或 `1` f `2` or。 IPv6