新規のお客様へのAmazon FSx ファイルゲートウェイの提供は終了しました。FSx ファイルゲートウェイの既存のお客様は、引き続き通常どおりサービスを使用できます。FSx ファイルゲートウェイに似た機能については、[このブログ記事](https://aws.amazon.com/blogs/storage/switch-your-file-share-access-from-amazon-fsx-file-gateway-to-amazon-fsx-for-windows-file-server/)を参照してください。

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

# ゲートウェイのアクティベーションキーを取得する
<a name="get-activation-key"></a>

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

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

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

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

**注記**  
 AWS Storage Gatewayハードウェアアプライアンス、VM イメージテンプレート、Amazon EC2 Amazon マシンイメージ (AMI) には、このページで説明されているウェブリクエストを受信して応答するために必要な HTTP サービスが事前設定されています。ゲートウェイに追加のサービスをインストールすることは必須ではなく、推奨もされていません。

**Topics**
+ [Linux (curl)](#get-activation-key-linux-curl)
+ [Linux (bash/zsh)](#get-activation-key-linux)
+ [Microsoft Windows PowerShell](#get-activation-key-powershell)
+ [ローカルコンソールを使用する](#using-local-console)

## Linux (curl)
<a name="get-activation-key-linux-curl"></a>

次の例では、Linux (curl) を使用してアクティベーションキーを取得する方法を示しています。

**注記**  
強調表示された変数を、ゲートウェイの実際の値に置き換えてください。指定できる値は次のとおりです。  
*gateway\$1ip\$1address* - ゲートウェイの IPv4 アドレス。例: `172.31.29.201`
*gateway\$1type* - `STORED`、`CACHED`、`VTL`、`FILE_S3`、または `FILE_FSX_SMB` など、アクティブ化するゲートウェイのタイプ。
*region\$1code* - ゲートウェイをアクティブ化するリージョン。「AWS 全般のリファレンス**」の「[リージョンエンドポイント](https://docs.aws.amazon.com/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"
```

**VPC エンドポイントのアクティベーションキーを取得するには:**

```
curl "http://gateway_ip_address/?activationRegion=region_code&vpcEndpoint=vpc_endpoint&no_redirect"
```

## Linux (bash/zsh)
<a name="get-activation-key-linux"></a>

次の例では、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
<a name="get-activation-key-powershell"></a>

次の例では、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]
    }
  }
}
```

## ローカルコンソールを使用する
<a name="using-local-console"></a>

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

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

1. ローカルコンソールに *admin* ユーザーとしてログインします。

1. ログイン後に **[AWS アプライアンスのアクティベーション - 設定]** メインメニューが表示されたら、`0` を選択して **[アクティベーションキーを取得]** を選択します。

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

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

1. ネットワークタイプとして `1` [Public] または `2` [VPC エンドポイント] を入力します。

1. エンドポイントタイプとして「Standard」の場合は「`1`」、Federal Information Processing Standard (FIPS) の場合は「`2`」と入力します。