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

Amazon S3 File Gateway のドキュメントは、「What is Amazon S3 File Gateway?」に移動しました。

Amazon FSx File Gateway のドキュメントは、「What is Amazon FSx File Gateway?」に移動しました。

ボリュームゲートウェイのドキュメントは、「What is Volume Gateway?」に移動しました。

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

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

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

注記

ゲートウェイのアクティベーションキーは、未使用の場合 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、または などVTLFILE_S3、アクティブ化するゲートウェイのタイプFILE_FSX_SMB

  • region_code - ゲートウェイをアクティブ化するリージョン。「AWS 全般のリファレンス」の「リージョンエンドポイント」を参照してください。

  • 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)] を入力します。