Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Abrufen eines Aktivierungsschlüssels für das Gateway
Um einen Aktivierungsschlüssel für Ihr Gateway zu erhalten, stellen Sie eine Webanforderung an die virtuelle Gateway-Maschine (VM). Die VM gibt eine Umleitung zurück, die den Aktivierungsschlüssel enthält, der als einer der Parameter für die `ActivateGateway`-API-Aktion zur Angabe der Konfiguration Ihres Gateways übergeben wird. Weitere Informationen finden Sie [ActivateGateway](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_ActivateGateway.html)in der *Storage Gateway API-Referenz*.
**Anmerkung**
Gateway-Aktivierungsschlüssel laufen nach 30 Minuten ab, wenn sie nicht verwendet werden.
Die Anfrage, die Sie an die Gateway-VM stellen, umfasst die AWS Region, in der die Aktivierung erfolgt. Die URL, die von der Umleitung in der Antwort zurückgegeben wird, enthält einen Abfragezeichenfolgenparameter namens `activationkey`. Dieser Abfragezeichenfolge-Parameter ist Ihr Aktivierungsschlüssel. Das Format der Abfragezeichenfolge: `http://gateway_ip_address/?activationRegion=activation_region`. Mit der Ausgabe dieser Abfrage werden sowohl die Aktivierungsregion als auch der Aktivierungsschlüssel zurückgegeben.
Die URL enthält auch `vpcEndpoint`, die VPC-Endpunkt-ID für Gateways, die über den VPC-Endpunkttyp eine Verbindung herstellen.
**Anmerkung**
Die AWS Storage Gateway Hardware-Appliance, VM-Image-Vorlagen und Amazon EC2 Amazon Machine Images (AMI) sind mit den HTTP-Diensten vorkonfiguriert, die für den Empfang und die Beantwortung der auf dieser Seite beschriebenen Webanfragen erforderlich sind. Es ist nicht erforderlich oder empfehlenswert, zusätzliche Dienste auf Ihrem Gateway zu installieren.
**Topics**
+ [Linux (curl)](#get-activation-key-linux-curl)
+ [Linux (bash/zsh)](#get-activation-key-linux)
+ [Microsoft Windows PowerShell](#get-activation-key-powershell)
+ [Verwenden der lokalen Konsole](#using-local-console)
## Linux (curl)
In den folgenden Beispielen wird gezeigt, wie Sie mithilfe von Linux (curl) einen Aktivierungsschlüssel abrufen.
**Anmerkung**
Ersetzen Sie die hervorgehobenen Variablen durch tatsächliche Werte für Ihr Gateway. Zulässige Werte sind:
*gateway\$1ip\$1address*- Zum Beispiel die IPv4 Adresse Ihres Gateways `172.31.29.201`
*gateway\$1type*- Der Gateway-Typ, den Sie aktivieren möchten, z. B. `STORED``CACHED`,`VTL`,`FILE_S3`, oder`FILE_FSX_SMB`.
*region\$1code*- Die Region, in der Sie Ihr Gateway aktivieren möchten. Weitere Informationen finden Sie unter [Regionale Endpunkte](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints) im *Allgemeinen Referenzhandbuch zu AWS *. Wenn dieser Parameter nicht angegeben ist oder wenn der angegebene Wert falsch geschrieben ist oder nicht mit einer gültigen Region übereinstimmt, verwendet der Befehl standardmäßig die `us-east-1` Region.
*vpc\$1endpoint*- Zum Beispiel `vpce-050f90485f28f2fd0-iep0e8vq.storagegateway.us-west-2.vpce.amazonaws.com` der VPC-Endpunktname für Ihr Gateway.
**Öffentlicher Endpunkt**
Verwenden Sie einen der folgenden Befehle, um einen Aktivierungsschlüssel für einen öffentlichen Endpunkt zu erhalten:
**Standard-Endpunkte**
Um den Aktivierungsschlüssel für einen Standardendpunkt zu erhalten:
```
curl "http://gateway_ip_address/?activationRegion=region_code&no_redirect"
```
**Dual-Stack-Endpunkte**
Um den Aktivierungsschlüssel für einen Dual-Stack-Endpunkt zu erhalten:
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-Endpunkte**
Um den Aktivierungsschlüssel für einen FIPS-Endpunkt zu erhalten:
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-Endpunkte**
So rufen Sie den Aktivierungsschlüssel für einen VPC-Endpunkt ab:
```
curl "http://gateway_ip_address/?activationRegion=region_code&vpcEndpoint=vpc_endpoint&no_redirect"
```
## Linux (bash/zsh)
Das folgende Beispiel zeigt, wie Sie mit Linux (bash/zsh) die HTTP-Antwort abfangen, HTTP-Header analysieren und den Aktivierungsschlüssel abrufen.
```
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
Das folgende Beispiel zeigt Ihnen, wie Sie Microsoft Windows verwenden, PowerShell um die HTTP-Antwort abzurufen, HTTP-Header zu analysieren und den Aktivierungsschlüssel abzurufen.
```
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]
}
}
}
```
## Verwenden der lokalen Konsole
Die folgenden Ihnen, wie Sie Ihre lokale Konsole verwenden, um einen Aktivierungsschlüssel zu generieren und anzuzeigen.
**Auf Amazon Linux 2 (AL2) basierende Gateways**
Sie können entweder Standard- oder FIPS-Endpunkte für Gateways auswählen, die auf basieren. AL2
**Anmerkung**
FIPS-Endpunkte sind nicht in allen verfügbar. AWS-Regionen Weitere Informationen finden Sie unter [FIPS-Endpunkte](https://aws.amazon.com/compliance/fips/) nach Dienst.
**Um einen Aktivierungsschlüssel für Ihr AL2 basiertes Gateway von Ihrer lokalen Konsole zu erhalten**
1. Melden Sie sich bei Ihrer lokalen Konsole als *Administrator* an.
1. Wählen Sie im Hauptmenü **AWS Appliance-Aktivierung — Konfiguration** `0` die Option **Aktivierungsschlüssel abrufen** aus.
1. Wählen Sie die Option **Storage Gateway** für die Gateway-Produktreihe aus.
1. Geben Sie die AWS Region ein, in der Sie Ihr Gateway aktivieren möchten.
1. Geben Sie als Netzwerktyp `1` für Öffentlich oder `2` für VPC ein.
1. Geben Sie als Endpunkttyp `1` für Standard oder `2` für Federal Information Processing Standard (FIPS) ein.
**Auf Amazon Linux 2023 (AL2023) basierende Gateways**
Für Gateways, die auf basieren AL2023, sind die folgenden Endpunkte verfügbar:
+ Standardendpunkte (nur Support) IPv4
+ FIPS-Endpunkte (nur Support) IPv4
+ Dual-Stack-Endpunkte (Unterstützung und) IPv4 IPv6
+ Dual-Stack-FIPS-Endpunkte (Unterstützung und) IPv4 IPv6
Weitere Informationen finden Sie unter [Endpunkttypen](Requirements.md#endpoint-types-fgw).
**Um einen Aktivierungsschlüssel für Ihr AL2023 basiertes Gateway von Ihrer lokalen Konsole zu erhalten**
1. Melden Sie sich bei der lokalen Konsole an. Wenn Sie auf einem Windows-Computer eine Verbindung mit Ihrer Amazon-EC2-Instance herstellen, melden Sie sich als *admin* an.
1. Wählen Sie im Hauptmenü **AWS Appliance-Aktivierung — Konfiguration** `0` die Option **Aktivierungsschlüssel abrufen** aus.
1. Wählen Sie die Option **Storage Gateway** für die Gateway-Produktreihe aus.
1. Geben Sie die AWS Region ein, in der Sie Ihr Gateway aktivieren möchten.
1. Geben Sie als Netzwerktyp `1` für Öffentlich oder `2` für VPC-Endpunkt ein.
1. **Wählen Sie für Endpunkttyp** die Option **FIPS aktivieren?** , geben Sie ein, `Y` um FIPS zu aktivieren oder einen `N` Nicht-FIPS-Endpunkt zu verwenden.
1. Geben Sie als Endpunkttyp den Wert `1` für Standardendpunkt oder `2` für Dual-Stack-Endpunkt ein.
1. Geben Sie für einen Dual-Stack-Endpunkt für **Select IP version or exit:** `1` for IPv4 oder `2` for ein. IPv6