翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ゲートウェイのアクティベーションキーを取得する

ゲートウェイのアクティベーションキーを受け取るには、ゲートウェイ仮想マシン (VM) にウェブリクエストを行います。VM はアクティベーションキーを含むリダイレクトを返します。アクティベーションキーは、ゲートウェイの設定を指定するための ActivateGateway API アクションのパラメータの 1 つとして渡されます。詳細については、「Storage Gateway API リファレンス」の「ActivateGateway」を参照してください。

ゲートウェイ VM に対して行うリクエストには、アクティベーションが発生する AWS リージョンが含まれます。応答のリダイレクトで返される URL には、activationkey と呼ばれるクエリ文字列パラメータが含まれています。このクエリ文字列パラメータが、アクティベーションキーです。クエリ文字列の形式は次のようになります。http://gateway_ip_address/?activationRegion=activation_regionこのクエリの出力で、アクティベーションリージョンとキーの両方が返されます。

URL には、vpcEndpoint、VPC エンドポイントタイプを使用して接続するゲートウェイの VPC エンドポイント ID も含まれています。

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 に基づくゲートウェイでは、次のエンドポイントを使用できます。

詳細については、「エンドポイントタイプ」を参照してください。