ゲートウェイのアクティベーションキーを取得する - AWS Storage Gateway
Linux (curl)Linux (bash/zsh)Microsoft Windows PowerShellローカルコンソールを使用する

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

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

注記

ゲートウェイのアクティベーションキーは、未使用の場合 30 分で有効期限が切れます。

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

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

注記

Storage Gateway ハードウェアアプライアンス、VM イメージテンプレート、Amazon EC2 Amazon マシンイメージ (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 - ゲートウェイをアクティブ化するリージョン。「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"

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

ローカルコンソールを使用する

次の例では、ローカルコンソールを使用してアクティベーションキーを生成し、表示する方法を示しています。

ローカルコンソールからゲートウェイのアクティベーションキーを取得するには

  1. ローカルコンソールにログインします。Windows コンピュータから Amazon EC2 インスタンスに接続する場合は、admin としてログインします。

  2. ログイン後に [AWS Appliance Activation - Configuration] メインメニューが表示されたら、0 を選択して [Get activation key] を選択します。

  3. [Storage Gateway for gateway family] オプションを選択します。

  4. プロンプトが表示されたら、ゲートウェイをアクティブ化する AWS リージョンを入力します。

  5. ネットワークタイプとして 1 [Public] または 2 [VPC endpoint] を入力します。

  6. エンドポイントタイプとして 1 [Standard] または 2 [Federal Information Processing Standard (FIPS)] を入力します。