本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

取得閘道的啟用金鑰

若要接收閘道的啟用金鑰，請向閘道虛擬機器 (VM) 發出網頁請求。虛擬機器會傳回包含啟用金鑰的重新導向，該重新導向會當做 ActivateGateway API 動作的其中一個參數傳遞，以指定閘道的組態。如需詳細資訊，請參閱 Storage Gateway API 參考資料中的 ActivateGateway。

您對閘道 VM 提出的請求包含進行啟用 AWS 的區域。重新導向在回應中傳回的 URL 會包含稱為 activationkey 的查詢字串參數。此查詢字串參數便是您的啟用金鑰。查詢字串的格式如下：http://gateway_ip_address/?activationRegion=activation_region。此查詢的輸出傳回啟用區域和金鑰。

此 URL 也包含 vpcEndpoint 使用 VPC 端點類型連線之閘道的 VPC 端點識別碼。

Linux (curl)

以下範例顯示如何使用 Linux (curl) 取得啟用金鑰。

公有端點

若要取得公有端點的啟用金鑰，請使用下列其中一個命令：

標準端點

若要取得標準端點的啟用金鑰：

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
}

Microsoft 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]
    }
  }
}

使用本機主控台

下列範例示範如何使用本機主控台來產生和顯示啟用金鑰。

Amazon Linux 2 (AL2) 型閘道

您可以根據 AL2 為閘道選取標準或 FIPS 端點。

Amazon Linux 2023 (AL2023) 型閘道

對於以 AL2023 為基礎的閘道，可使用下列端點：

如需詳細資訊，請參閱端點類型。