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`
**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
**Note**
Les points de terminaison FIPS ne sont pas tous disponibles. Régions AWS Pour plus d'informations, consultez la section [Points de terminaison FIPS par service](https://aws.amazon.com/compliance/fips/).
**Pour obtenir une clé d'activation pour votre passerelle AL2 basée sur votre console locale**
1. Connectez-vous à votre console locale en tant qu'*administrateur*.
1. Dans le menu principal **Activation de l'AWS appliance - Configuration**, sélectionnez `0` **Obtenir la clé d'activation**.
1. Sélectionnez **Storage Gateway** pour l’option de la famille de passerelle.
1. Entrez la AWS région dans laquelle vous souhaitez activer votre passerelle.
1. Pour le type de réseau, saisissez `1` Public ou `2` VPC.
1. Pour le type de point de terminaison, saisissez `1` Standard ou `2` Federal Information Processing Standard (FIPS).
**Passerelles basées sur Amazon Linux 2023 (AL2023)**
Pour les passerelles basées sur AL2023, les points de terminaison suivants sont disponibles :
+ Points de terminaison standard (support IPv4 uniquement)
+ Points de terminaison FIPS (support IPv4 uniquement)
+ Points de terminaison à double pile (support IPv4 et) IPv6
+ Points de terminaison FIPS à double pile (support et) IPv4 IPv6
Pour de plus amples informations, veuillez consulter [Types de point de terminaison](Requirements.md#endpoint-types-fgw).
**Pour obtenir une clé d'activation pour votre passerelle AL2023 basée sur votre console locale**
1. Connectez-vous à votre console locale. Si vous vous connectez à votre instance Amazon EC2 à partir d’un ordinateur Windows, connectez-vous en tant qu’*admin*.
1. Dans le menu principal **Activation de l'AWS appliance - Configuration**, sélectionnez `0` **Obtenir la clé d'activation**.
1. Sélectionnez **Storage Gateway** pour l’option de la famille de passerelle.
1. Entrez la AWS région dans laquelle vous souhaitez activer votre passerelle.
1. Pour le type de réseau, entrez Public ou `1` `2` pour point de terminaison VPC.
1. Pour **Sélectionner le type de point de terminaison**, **Activer FIPS ?** , entrez `Y` pour activer FIPS ou pour utiliser un point `N` de terminaison non FIPS.
1. Pour le type de point de terminaison, entrez `1` pour le point de terminaison standard ou `2` pour le point de terminaison à double pile.
1. Pour un point de terminaison à double pile, dans **Select IP version or exit :**, entrez `1` pour IPv4 ou `2` pour IPv6.