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

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

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

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

L’exemple suivant vous montre comment utiliser votre console locale pour générer et afficher une clé d’activation.