翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ゲートウェイのアクティベーションキーを取得する
ゲートウェイのアクティベーションキーを受け取るには、ゲートウェイ仮想マシン (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)
次の例では、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"
```
**デュアルスタックのエンドポイント**
デュアルスタックエンドポイントのアクティベーションキーを取得するには：
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 エンドポイントを選択できます。
**注記**
FIPS エンドポイントは、すべての で利用できるわけではありません AWS リージョン。詳細については、「[サービス別の FIPS エンドポイント](https://aws.amazon.com/compliance/fips/)」を参照してください。
**ローカルコンソールからAL2ベースのゲートウェイのアクティベーションキーを取得するには**
1. ローカルコンソールに *admin* ユーザーとしてログインします。
1. **[AWS アプライアンスのアクティベーション - 設定]** メインメニューから、`0` を選択して **[アクティベーションキーを取得]** を選択します。
1. **[Storage Gateway for gateway family]** オプションを選択します。
1. ゲートウェイをアクティブ化する AWS リージョンを入力します。
1. ネットワークタイプとして、パブリックの場合は「`1`」、VPC の場合は「`2`」と入力します。
1. エンドポイントタイプとして、「Standard」には `1`、または「Federal Information Processing Standard (FIPS)」には `2` を入力します。
**Amazon Linux 2023 (AL2023) ベースのゲートウェイ**
AL2023 に基づくゲートウェイでは、次のエンドポイントを使用できます。
+ 標準エンドポイント (IPv4 のみをサポート)
+ FIPS エンドポイント (IPv4 のみをサポート)
+ デュアルスタックエンドポイント (IPv4 と IPv6 の両方をサポート)
+ IPv4 と IPv6 の両方をサポートするデュアルスタックの FIPS エンドポイント
詳細については、「[エンドポイントタイプ](Requirements.md#endpoint-types-fgw)」を参照してください。
**ローカルコンソールから AL2023 ベースのゲートウェイのアクティベーションキーを取得するには**
1. ローカルコンソールにログインします。Windows コンピュータから Amazon EC2 インスタンスに接続する場合は、*admin* としてログインします。
1. **[AWS アプライアンスのアクティベーション - 設定]** メインメニューから、`0` を選択して **[アクティベーションキーを取得]** を選択します。
1. **[Storage Gateway for gateway family]** オプションを選択します。
1. ゲートウェイをアクティブ化する AWS リージョンを入力します。
1. ネットワークタイプとして、パブリックの場合は「`1`」、VPC エンドポイントの場合は「`2`」と入力します。
1. **[エンドポイントタイプの選択]** の **[FIPS を有効化しますか?]** では、FIPS を有効にするには `Y`を、非 FIPS エンドポイントを使用するには `N` を入力します。
1. エンドポイントタイプの場合は、標準エンドポイントの場合は `1`、デュアルスタックエンドポイントの場合は `2` と入力します。
1. デュアルスタックエンドポイントの場合は、**[IP バージョンを選択または終了:]** のプロンプトで、IPv4 の場合は `1` を、IPv6 の場合は `2` を入力します。