신규 고객은 더 이상 Amazon FSx File Gateway를 사용할 수 없습니다. 기존 FSx File Gateway 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. FSx File Gateway와 유사한 기능에 대해서는 [이 블로그 게시물](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 작업의 파라미터 중 하나로 전달되어 게이트웨이 구성을 지정합니다. 자세한 내용은 *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에는 VPC 엔드포인트 유형을 사용하여 연결하는 게이트웨이의 VPC 엔드포인트 ID인 `vpcEndpoint`도 포함되어 있습니다.

**참고**  
The AWS Storage Gateway 하드웨어 어플라이언스, VM 이미지 템플릿 및 Amazon EC2 Amazon Machine Image(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**를 선택합니다.

1. 메시지가 표시되면 게이트웨이를 활성화할 AWS 리전 를 입력합니다.

1. 네트워크 유형으로 퍼블릭의 경우 `1`을, VPC 엔드포인트의 경우 `2`를 입력합니다.

1. 엔드포인트 유형으로 표준의 경우 `1`을, FIPS(Federal Information Processing Standard)의 경우 `2`를 입력합니다.