Abrufen eines Aktivierungsschlüssels für das Gateway - AWS Storage Gateway

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 ActivateGatewayin 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 Gateway-Hardware-Appliance, die VM-Image-Vorlagen und EC2 Amazon 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.

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- Zum Beispiel die IPv4 Adresse Ihres Gateways 172.31.29.201

  • gateway_type- Der Gateway-Typ, den Sie aktivieren möchten, z. B. STOREDCACHED,VTL,FILE_S3, oderFILE_FSX_SMB.

  • region_code- Die Region, in der Sie Ihr Gateway aktivieren möchten. Weitere Informationen finden Sie unter Regionale Endpunkte 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_endpoint- 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 nach Dienst.

Um einen Aktivierungsschlüssel für Ihr AL2 basiertes Gateway von Ihrer lokalen Konsole zu erhalten
  1. Melden Sie sich als Administrator bei Ihrer lokalen Konsole an.

  2. Wählen Sie im Hauptmenü AWS Geräteaktivierung — Konfiguration 0 die Option Aktivierungsschlüssel abrufen aus.

  3. Wählen Sie die Option Storage Gateway für die Gateway-Produktreihe aus.

  4. Geben Sie die AWS Region ein, in der Sie Ihr Gateway aktivieren möchten.

  5. Geben Sie als Netzwerktyp 1 für Öffentlich oder 2 für VPC ein.

  6. Geben Sie als Endpunkttyp 1 für Standard oder 2 für Federal Information Processing Standard (FIPS) ein.

Gateways auf Basis von Amazon Linux 2023 (AL2023)

Für Gateways, die auf AL2 023 basieren, sind die folgenden Endpunkte verfügbar:

  • Standard-Endpunkte (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.

Um einen Aktivierungsschlüssel für Ihr AL2 023-basiertes Gateway von Ihrer lokalen Konsole zu erhalten
  1. Melden Sie sich bei der lokalen Konsole an. Wenn Sie von einem Windows-Computer aus eine Verbindung zu Ihrer EC2 Amazon-Instance herstellen, melden Sie sich als Administrator an.

  2. Wählen Sie im Hauptmenü AWS Appliance-Aktivierung — Konfiguration 0 die Option Aktivierungsschlüssel abrufen aus.

  3. Wählen Sie die Option Storage Gateway für die Gateway-Produktreihe aus.

  4. Geben Sie die AWS Region ein, in der Sie Ihr Gateway aktivieren möchten.

  5. Geben Sie als Netzwerktyp 1 für Öffentlich oder 2 für VPC-Endpunkt ein.

  6. Geben 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.

  7. 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