Amazon FSx File Gateway n'est plus disponible pour les nouveaux clients. Les clients existants de FSx File Gateway peuvent continuer à utiliser le service normalement. Pour des fonctionnalités similaires à FSx File Gateway, consultez [ce billet de blog](https://aws.amazon.com/blogs/storage/switch-your-file-share-access-from-amazon-fsx-file-gateway-to-amazon-fsx-for-windows-file-server/).
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 [ActivateGateway](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_ActivateGateway.html)le manuel *Storage Gateway API Reference*.
**Note**
Les clés d’activation de passerelle expirent au bout de 30 minutes si elles ne sont pas utilisées.
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.
**Note**
L'appliance matérielle AWS Storage Gateway, les modèles d'image de machine virtuelle et les Amazon Machine Images (AMI) Amazon EC2 sont préconfigurés avec les services HTTP nécessaires pour recevoir et répondre aux requêtes Web décrites sur cette page. Il n’est ni obligatoire ni recommandé d’installer des services supplémentaires sur votre passerelle.
**Topics**
+ [Linux (curl)](#get-activation-key-linux-curl)
+ [Linux (bash/zsh)](#get-activation-key-linux)
+ [Microsoft Windows PowerShell](#get-activation-key-powershell)
+ [Utilisation de votre console locale](#using-local-console)
## Linux (curl)
Les exemples suivants vous montrent comment obtenir une clé d’activation à l’aide de Linux (curl).
**Note**
Remplacez les variables mis en évidence par des valeurs réelles pour votre passerelle. Les valeurs possibles sont les suivantes :
*gateway\$1ip\$1address*- L' IPv4 adresse de votre passerelle, par exemple `172.31.29.201`
*gateway\$1type*- Le type de passerelle que vous souhaitez activer, tel que `STORED``CACHED`,`VTL`,`FILE_S3`, ou`FILE_FSX_SMB`.
*region\$1code*- La région dans laquelle vous souhaitez activer votre passerelle. Voir les [Points de terminaison régionaux](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints) dans le *Guide de référence général AWS *. Si ce paramètre n'est pas spécifié, ou si la valeur fournie est mal orthographiée ou ne correspond pas à une région valide, la commande utilisera par défaut la `us-east-1` région.
*vpc\$1endpoint*- Le nom du point de terminaison VPC de votre passerelle, par exemple. `vpce-050f90485f28f2fd0-iep0e8vq.storagegateway.us-west-2.vpce.amazonaws.com`
**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
Les comment utiliser votre console locale pour générer et afficher une clé d'activation.
**Pour obtenir une clé d’activation pour votre passerelle à l’aide de votre console locale**
1. Connectez-vous à votre console locale en tant qu'*administrateur*.
1. Après vous être connecté et avoir vu le menu principal **Activation de l’appliance AWS - Configuration**, sélectionnez `0` pour choisir **Obtenir la clé d’activation**.
1. Sélectionnez **Storage Gateway** pour l’option de la famille de passerelle.
1. Lorsque vous y êtes invité, entrez l' Région AWS endroit où vous souhaitez activer votre passerelle.
1. Saisissez `1` pour Public ou `2` pour Point de terminaison VPC en tant que type de réseau.
1. Saisissez `1` Standard ou `2` FIPS (Federal Information Processing Standard) en tant que type de point de terminaison.