Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mendapatkan kunci aktivasi untuk gateway Anda
Untuk menerima kunci aktivasi untuk gateway Anda, buat permintaan web ke mesin virtual gateway (VM). VM mengembalikan pengalihan yang berisi kunci aktivasi, yang diteruskan sebagai salah satu parameter untuk tindakan `ActivateGateway` API untuk menentukan konfigurasi gateway Anda. Untuk informasi selengkapnya, lihat [ ActivateGateway ](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_ActivateGateway.html) Referensi API * Storage Gateway*.
**catatan**
Kunci aktivasi gateway kedaluwarsa dalam 30 menit jika tidak digunakan.
Permintaan yang Anda buat ke VM gateway mencakup Wil AWS ayah tempat aktivasi terjadi. URL yang dikembalikan oleh pengalihan dalam respons berisi parameter string kueri yang disebut`activationkey`. Parameter string kueri ini adalah kunci aktivasi Anda. Format string kueri terlihat seperti berikut:`http://{{gateway_ip_address}}/?activationRegion={{activation_region}}`. Output dari kueri ini mengembalikan wilayah aktivasi dan kunci.
URL juga mencakup`vpcEndpoint`, VPC Endpoint ID untuk gateway yang terhubung menggunakan tipe titik akhir VPC.
**catatan**
Perangkat AWS Keras Storage Gateway, template gambar VM, dan Amazon EC2 Amazon Machine Images (AMI) telah dikonfigurasi sebelumnya dengan layanan HTTP yang diperlukan untuk menerima dan menanggapi permintaan web yang dijelaskan di halaman ini. Tidak diperlukan atau disarankan untuk menginstal layanan tambahan apa pun di gateway Anda.
**Topics**
+ [Linux (keriting)](#get-activation-key-linux-curl)
+ [Linux (bash/zsh)](#get-activation-key-linux)
+ [Microsoft Windows PowerShell](#get-activation-key-powershell)
+ [Menggunakan konsol lokal](#using-local-console)
## Linux (keriting)
Contoh berikut menunjukkan cara mendapatkan kunci aktivasi menggunakan Linux (curl).
**catatan**
Ganti variabel yang disorot dengan nilai aktual untuk gateway Anda. Nilai yang dapat diterima adalah sebagai berikut:
{{gateway\_ip\_address}}- Alamat IPv4 gateway Anda, misalnya `172.31.29.201`
{{gateway\_type}}- Jenis gateway yang ingin Anda aktifkan, seperti`STORED`,, `CACHED``VTL`,`FILE_S3`, atau`FILE_FSX_SMB`.
{{region\_code}}- Wilayah tempat Anda ingin mengaktifkan gateway Anda. Lihat titik akhir [ regional ](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints) di Panduan * Refer *AWS ensi Umum. Jika parameter ini tidak ditentukan, atau jika nilai yang diberikan salah eja atau tidak cocok dengan wilayah yang valid, perintah akan default ke `us-east-1` wilayah tersebut.
{{vpc\_endpoint}}- Nama titik akhir VPC untuk gateway Anda, misalnya`vpce-050f90485f28f2fd0-iep0e8vq.storagegateway.us-west-2.vpce.amazonaws.com`.
**Titik akhir publik**
Untuk mendapatkan kunci aktivasi untuk titik akhir publik, gunakan salah satu perintah berikut:
**Titik akhir standar**
Untuk mendapatkan kunci aktivasi untuk titik akhir standar:
```
curl "http://{{gateway_ip_address}}/?activationRegion={{region_code}}&no_redirect"
```
**Dual-stack titik akhir**
Untuk mendapatkan kunci aktivasi untuk titik akhir tumpukan ganda:
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"
```
**Titik akhir FIPS**
Untuk mendapatkan kunci aktivasi untuk titik akhir 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"
```
**Titik akhir VPC**
Untuk mendapatkan kunci aktivasi untuk titik akhir VPC:
```
curl "http://{{gateway_ip_address}}/?activationRegion={{region_code}}&vpcEndpoint={{vpc_endpoint}}&no_redirect"
```
## Linux (bash/zsh)
Contoh berikut menunjukkan cara menggunakan Linux (bash/zsh) untuk mengambil respons HTTP, mengurai header HTTP, dan mendapatkan kunci aktivasi.
```
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
Contoh berikut menunjukkan cara menggunakan Microsoft Windows PowerShell untuk mengambil respons HTTP, mengurai header HTTP, dan mendapatkan kunci aktivasi.
```
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]
}
}
}
```
## Menggunakan konsol lokal
Contoh berikut menunjukkan contoh cara menggunakan konsol lokal untuk menghasilkan dan menampilkan kunci aktivasi.
**Gateway berbasis Amazon Linux 2 (AL2) **
Anda dapat memilih titik akhir standar atau FIPS untuk gateway berdasarkan AL2.
**catatan**
Titik akhir FIPS tidak tersedia di semua. Wilayah AWS Untuk informasi selengkapnya, lihat T [ itik Akhir FIPS berdasarkan Layanan. ](https://aws.amazon.com/compliance/fips/)
**Untuk mendapatkan kunci aktivasi AL2-based gateway dari konsol lokal**
1. Masuk ke konsol lokal Anda sebagai * admin*.
1. Dari menu **AWS ** utama Aktivasi Peralatan - Konfigurasi, pilih `0` untuk memilih ** Dapatkan kunci aktivasi**.
1. Pilih opsi ** Storage Gateway ** untuk keluarga gateway.
1. Masukkan Wil AWS ayah tempat Anda ingin mengaktifkan gateway Anda.
1. Untuk jenis jaringan, masukkan `1` untuk Publik atau `2` untuk VPC.
1. Untuk tipe titik akhir, masukkan `1` untuk Standar atau `2` untuk Federal Information Processing Standard (FIPS).
**Gateway berbasis Amazon Linux 2023 (AL2023) **
Untuk gateway berdasarkan AL2023, titik akhir berikut tersedia:
+ Titik akhir standar (hanya mendukung IPv4)
+ Titik akhir FIPS (hanya mendukung IPv4)
+ Dual-stack titik akhir (mendukung IPv4 dan IPv6)
+ Dual-stack Titik akhir FIPS (mendukung IPv4 dan IPv6)
Untuk informasi selengkapnya, lihat [Jenis titik akhir](Requirements.md#endpoint-types-fgw).
**Untuk mendapatkan kunci aktivasi AL2023-based gateway dari konsol lokal**
1. Masuk ke konsol lokal Anda. Jika Anda terhubung ke instans Amazon EC2 dari komputer Windows, masuk sebagai * admin*.
1. Dari menu **AWS ** utama Aktivasi Peralatan - Konfigurasi, pilih `0` untuk memilih ** Dapatkan kunci aktivasi**.
1. Pilih opsi ** Storage Gateway ** untuk keluarga gateway.
1. Masukkan Wil AWS ayah tempat Anda ingin mengaktifkan gateway Anda.
1. Untuk jenis jaringan, masukkan `1` untuk Publik atau `2` untuk titik akhir VPC.
1. Untuk ** Pilih tipe titik akhir**, ** Aktifkan FIPS? **, masukkan `Y` untuk mengaktifkan FIPS atau `N` untuk menggunakan titik akhir non-FIPS.
1. Untuk tipe titik akhir, masukkan `1` untuk titik akhir standar atau `2` untuk titik akhir tumpukan ganda.
1. Untuk titik akhir tumpukan ganda, untuk ** Pilih versi IP atau keluar:**, masukkan `1` untuk IPv4 atau `2` untuk IPv6.