翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ゲートウェイのアクティベーションキーを取得する
ゲートウェイのアクティベーションキーを受け取るには、ゲートウェイ仮想マシン (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 も含まれています。
**注記**
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\_ip\_address}} - ゲートウェイの IPv4 アドレス。例: `172.31.29.201`
{{gateway\_type}} - `STORED`、`CACHED`、`VTL`、`FILE_S3`、または `FILE_FSX_SMB` など、アクティブ化するゲートウェイのタイプ。
{{region\_code}} - ゲートウェイをアクティブ化するリージョン。「AWS 全般のリファレンス**」の「[リージョンエンドポイント](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints)」を参照してください。このパラメータが指定されていない場合、または指定された値がスペルミスであるか、有効なリージョンと一致しない場合、コマンドはデフォルトで `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"
```
**デュアルスタックのエンドポイント**
デュアルスタックエンドポイントのアクティベーションキーを取得するには：
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-basedゲートウェイのアクティベーションキーを取得するには**
1. *管理者*としてローカルコンソールにログインします。
1. **AWS アプライアンスのアクティベーション - 設定**のメインメニューから、**アクティベーションキーの取得**`0`を選択します。
1. **[Storage Gateway for gateway family]** オプションを選択します。
1. ゲートウェイをアクティブ化する AWS リージョンを入力します。
1. ネットワークタイプの場合は、「パブリック`1`」または「VPC`2`」と入力します。
1. エンドポイントタイプの場合は、`1`「Standard」または「Federal Information Processing Standard (FIPS)`2`」と入力します。
**Amazon Linux 2023 (AL2023) ベースのゲートウェイ**
AL2023 に基づくゲートウェイでは、次のエンドポイントを使用できます。
+ 標準エンドポイント (IPv4 のみをサポート）
+ FIPS エンドポイント (IPv4 のみをサポート）
+ デュアルスタックエンドポイント (IPv4 および IPv6 をサポート）
+ デュアルスタック FIPS エンドポイント (IPv4 および IPv6 をサポート）
詳細については、「[エンドポイントタイプ](Requirements.md#endpoint-types)」を参照してください。
**ローカルコンソールから AL2023-basedゲートウェイのアクティベーションキーを取得するには**
1. ローカルコンソールにログインします。Windows コンピュータから Amazon EC2 インスタンスに接続する場合は、*admin* としてログインします。
1. **AWS アプライアンスのアクティベーション - 設定**のメインメニューから、**アクティベーションキーの取得**`0`を選択します。
1. **[Storage Gateway for gateway family]** オプションを選択します。
1. ゲートウェイをアクティブ化する AWS リージョンを入力します。
1. ネットワークタイプの場合は、パブリック`1`の場合は 、VPC エンドポイント`2`の場合は と入力します。
1. Select **endpoint type**, **Enable FIPS?** で、 と入力`Y`して FIPS を有効にするか、非 FIPS エンドポイント`N`を使用します。
1. エンドポイントタイプの場合は、標準エンドポイント`1`の場合は 、デュアルスタックエンドポイント`2`の場合は を入力します。
1. デュアルスタックエンドポイントの場合、**IP バージョンの選択または終了：** に、IPv4 `1` の場合は 、IPv6 `2`の場合は と入力します。