Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Obtención de una clave de activación para la puerta de enlace
Para recibir una clave de activación para la puerta de enlace, realice una solicitud web a la máquina virtual (VM) de la puerta de enlace. La máquina virtual devuelve un redireccionamiento que contiene la clave de activación, la cual se transfiere como uno de los parámetros de la acción de la API de `ActivateGateway` para especificar la configuración de la puerta de enlace. Para obtener más información, consulte la *referencia [ActivateGateway](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_ActivateGateway.html)de la API de Storage Gateway*.
**nota**
Las claves de activación de la puerta de enlace caducan en 30 minutos si no se utilizan.
La solicitud que realiza a la máquina virtual de puerta de enlace incluye la AWS región en la que se produce la activación. La URL que devuelve el redireccionamiento en la respuesta contiene un parámetro de cadena de consulta llamado `activationkey`. Este parámetro de cadena de consulta es su clave de activación. El formato de la cadena de consulta tiene el aspecto siguiente: `http://{{gateway_ip_address}}/?activationRegion={{activation_region}}`. El resultado de esta consulta devuelve la región y la clave de activación.
La URL también incluye `vpcEndpoint`, el ID del punto de conexión de VPC para las puertas de enlace que se conectan mediante el tipo de punto de conexión de VPC.
**nota**
El Storage Gateway Hardware Appliance, las plantillas de imágenes de máquinas virtuales y EC2 Amazon Machine Images (AMI) vienen preconfigurados con los servicios HTTP necesarios para recibir y responder a las solicitudes web que se describen en esta página. No es obligatorio ni recomendable instalar ningún servicio adicional en la puerta de enlace.
**Topics**
+ [Linux (curl)](#get-activation-key-linux-curl)
+ [Linux (bash/zsh)](#get-activation-key-linux)
+ [Microsoft Windows PowerShell](#get-activation-key-powershell)
+ [Mediante la consola local](#using-local-console)
## Linux (curl)
En los siguientes ejemplos se muestra cómo obtener una clave de activación con Linux (curl).
**nota**
Sustituya las variables resaltadas por valores reales de la puerta de enlace. Los valores aceptables son los siguientes:
{{gateway\_ip\_address}}- La IPv4 dirección de su puerta de enlace, por ejemplo `172.31.29.201`
{{gateway\_type}}- El tipo de puerta de enlace que desea activar`STORED`, como`CACHED`,`VTL`,`FILE_S3`, o`FILE_FSX_SMB`.
{{region\_code}}- La región en la que quieres activar tu puerta de enlace. Consulte [Puntos de conexión regionales](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints) en la *Guía de referencia general de AWS *. Si no se especifica este parámetro o si el valor proporcionado está mal escrito o no coincide con una región válida, el comando utilizará la región `us-east-1` de forma predeterminada.
{{vpc\_endpoint}}- El nombre del punto de conexión de VPC de su puerta de enlace, por ejemplo. `vpce-050f90485f28f2fd0-iep0e8vq.storagegateway.us-west-2.vpce.amazonaws.com`
**Puntos finales estándar**
Para obtener la clave de activación de un punto final estándar:
```
curl "http://{{gateway_ip_address}}/?activationRegion={{region_code}}&no_redirect"
```
**Puntos de enlace de doble pila**
Para obtener la clave de activación de un dispositivo de punto final de doble pila:
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"
```
**Puntos de conexión de FIPS**
Para obtener la clave de activación de un punto final 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"
```
**Puntos de conexión de VPC**
Para obtener la clave de activación de un punto de conexión de VPC:
```
curl "http://{{gateway_ip_address}}/?activationRegion={{region_code}}&vpcEndpoint={{vpc_endpoint}}&no_redirect"
```
## Linux (bash/zsh)
En el siguiente ejemplo se muestra cómo utilizar Linux (bash/zsh) para recuperar la respuesta HTTP, analizar los encabezados HTTP y obtener la clave de activación.
```
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
El siguiente ejemplo muestra cómo utilizar Microsoft Windows PowerShell para obtener la respuesta HTTP, analizar los encabezados HTTP y obtener la clave de activación.
```
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]
}
}
}
```
## Mediante la consola local
En los ejemplos siguientes se muestra cómo utilizar la consola local para generar y mostrar una clave de activación.
**Puertas de enlace basadas en Amazon Linux (2AL2)**
Puede seleccionar puntos de enlace estándar o FIPS para las puertas de enlace en función de. AL2
**nota**
Los puntos finales de FIPS no están disponibles en todos. Regiones de AWS Para obtener más información, consulte Puntos de [enlace FIPS](https://aws.amazon.com/compliance/fips/) por servicio.
**Para obtener una clave de activación para su puerta de enlace AL2 basada en su consola local**
1. Inicia sesión en tu consola local como *administrador*.
1. En el menú principal **Activación y configuración del AWS dispositivo**, seleccione `0` **Obtener la clave de activación**.
1. Seleccione **Storage Gateway** como opción de familia de puertas de enlace.
1. Introduzca la AWS región en la que desea activar la puerta de enlace.
1. Para el tipo de red, introduzca `1` Public o `2` VPC.
1. Para el tipo de punto final, introduzca `1` Estándar o Estándar Federal `2` de Procesamiento de Información (FIPS).
**Puertas de enlace basadas en Amazon Linux 2023 (AL2023)**
Para las puertas de enlace basadas en el AL2 023, están disponibles los siguientes puntos de enlace:
+ Terminales estándar (solo compatibles) IPv4
+ Terminales FIPS (solo compatibles) IPv4
+ Terminales de doble pila (soporte y) IPv4 IPv6
+ Terminales FIPS de doble pila (soporte y) IPv4 IPv6
Para obtener más información, consulte [Tipo de punto de conexión](Requirements.md#endpoint-types).
**Para obtener una clave de activación para su puerta de enlace AL2 basada en 023 desde su consola local**
1. Inicie sesión en la consola local. Si te conectas a tu EC2 instancia de Amazon desde un ordenador Windows, inicia sesión como *administrador*.
1. En el menú principal **Activación y configuración del AWS dispositivo**, seleccione `0` **Obtener la clave de activación**.
1. Seleccione **Storage Gateway** como opción de familia de puertas de enlace.
1. Introduzca la AWS región en la que desea activar la puerta de enlace.
1. Para el tipo de red, introduzca `1` para punto final público o `2` VPC.
1. En **Seleccione el tipo de punto final**, ¿**Habilitar FIPS?** , introduzca `Y` para habilitar el FIPS o para utilizar un punto final `N` que no sea FIPS.
1. Para el tipo de punto final, introduzca el `1` punto final estándar o `2` el punto final de doble pila.
1. Para un punto final de doble pila, en **Seleccione la versión IP o salga:**, introduzca `1` for IPv4 o `2` for. IPv6