Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Obtention d’une clé d’activation pour votre passerelle

Pour recevoir une clé d’activation pour votre passerelle, envoyez une demande Web à la machine virtuelle (VM) de passerelle. La machine virtuelle renvoie une redirection contenant la clé d’activation, qui est transmise comme l’un des paramètres de l’action d’API ActivateGateway afin de spécifier la configuration de votre passerelle. Pour plus d'informations, consultez ActivateGatewayle manuel Storage Gateway API Reference.

La demande que vous envoyez à la machine virtuelle de passerelle inclut la AWS région dans laquelle l'activation a lieu. L’URL renvoyée par la redirection dans la réponse contient un paramètre de chaîne de requête appelé activationkey. Ce paramètre de chaîne de requête est votre clé d’activation. Le format de la chaîne de requête ressemble à ceci : http://gateway_ip_address/?activationRegion=activation_region. Le résultat de cette requête renvoie à la fois la région d’activation et la clé.

L’URL inclut également vpcEndpoint, l’ID de point de terminaison de VPC pour les passerelles qui se connectent à l’aide du type de point de terminaison de VPC.

Linux (curl)

Les exemples suivants vous montrent comment obtenir une clé d’activation à l’aide de Linux (curl).

Point de terminaison public

Pour obtenir une clé d'activation pour un point de terminaison public, utilisez l'une des commandes suivantes :

Points de terminaison standard

Pour obtenir la clé d'activation d'un point de terminaison standard :

curl "http://gateway_ip_address/?activationRegion=region_code&no_redirect"

Points de terminaison Dual-Stack

Pour obtenir la clé d'activation d'un point de terminaison à double pile :

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"

Points de terminaison FIPS

Pour obtenir la clé d'activation d'un point de terminaison 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"

Points de terminaison d'un VPC

Pour obtenir la clé d’activation d’un point de terminaison de VPC :

curl "http://gateway_ip_address/?activationRegion=region_code&vpcEndpoint=vpc_endpoint&no_redirect"

Linux (bash/zsh)

L’exemple suivant vous montre comment utiliser Linux (bash/zsh) pour extraire la réponse HTTP, analyser les en-têtes HTTP et obtenir la clé d’activation.

  
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

L'exemple suivant montre comment utiliser Microsoft Windows PowerShell pour récupérer la réponse HTTP, analyser les en-têtes HTTP et obtenir la clé d'activation.

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]
    }
  }
}

Utilisation de votre console locale

Passerelles basées sur Amazon Linux (2AL2)

Vous pouvez sélectionner des points de terminaison standard ou FIPS pour les passerelles en fonction de. AL2

Passerelles basées sur Amazon Linux 2023 (AL2023)

Pour les passerelles basées sur AL2 023, les points de terminaison suivants sont disponibles :

Pour de plus amples informations, veuillez consulter Types de point de terminaison.