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\_ip\_address}}- Die IPv4-Adresse Ihres Gateways, zum Beispiel `172.31.29.201` {{gateway\_type}}- Der Gateway-Typ, den Sie aktivieren möchten, z. B.`STORED`,`CACHED`, `VTL``FILE_S3`, oder`FILE_FSX_SMB`. {{region\_code}}- 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 keiner gültigen Region entspricht, verwendet der Befehl standardmäßig die `us-east-1` Region. {{vpc\_endpoint}}— Zum Beispiel der VPC-Endpunktname für Ihr Gateway. `vpce-050f90485f28f2fd0-iep0e8vq.storagegateway.us-west-2.vpce.amazonaws.com` **Öffentlicher Endpunkt** Verwenden Sie einen der folgenden Befehle, um einen Aktivierungsschlüssel für einen öffentlichen Endpunkt zu erhalten: **Standard-Endpunkte** So rufen Sie den Aktivierungsschlüssel für einen Standard-Endpunkt ab: ``` 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** So erhalten Sie den Aktivierungsschlüssel für einen FIPS-Endpunkt: 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 Ihnen, wie Sie Linux (bash/zsh) verwenden, um die HTTP-Antwort abzurufen, HTTP-Header zu analysieren und den Aktivierungsschlüssel abzurufen. ``` 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, 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 Das folgende 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 AL2 basieren. **Anmerkung** FIPS-Endpunkte sind nicht in allen verfügbar. AWS-Regionen Weitere Informationen finden Sie unter [ FIPS-Endpunkte nach Service. ](https://aws.amazon.com/compliance/fips/) **So erhalten Sie von Ihrer lokalen Konsole aus einen Aktivierungsschlüssel für Ihr AL2-based Gateway** 1. Melden Sie sich als * Administrator an Ihrer lokalen Konsole 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 `1` als Netzwerktyp Public oder `2` VPC ein. 1. Geben Sie `1` als Endpunkttyp Standard oder `2` Federal Information Processing Standard (FIPS) ein. **Gateways, die auf Amazon Linux 2023 (AL2023) basieren ** Für Gateways, die auf AL2023 basieren, sind die folgenden Endpunkte verfügbar: + Standard-Endpunkte (unterstützen nur IPv4) + FIPS-Endpunkte (unterstützen nur IPv4) + Dual-stack Endpunkte (unterstützen IPv4 und IPv6) + Dual-stack FIPS-Endpunkte (unterstützen IPv4 und IPv6) Weitere Informationen finden Sie unter [Endpunkttypen](Requirements.md#endpoint-types-fgw). **Um einen Aktivierungsschlüssel für Ihr AL2023-based 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 Geräteaktivierung — 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 `1` als Netzwerktyp „Öffentlich“ oder `2` „VPC-Endpunkt“ ein. 1. **Wählen Sie für Endpunkttyp ** auswählen 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 einen Standard-Endpunkt oder `1` `2` einen Dual-Stack-Endpunkt ein. 1. Geben `1` Sie für einen Dual-Stack-Endpunkt für ** Select IP version or exit: den ** Wert IPv4 oder `2` IPv6 ein.