View a markdown version of this page

Obtención de una clave de activación para la puerta de enlace - AWS Storage Gateway

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 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 la 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 dispositivo de hardware AWS Storage Gateway, las plantillas de imágenes de máquina virtual y las Amazon Machine Images (AMI) de Amazon EC2 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.

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 dirección IPv4 de su puerta de enlace, por ejemplo 172.31.29.201

  • gateway_type- El tipo de puerta de enlace que desea activar, comoSTORED,CACHED, VTLFILE_S3, oFILE_FSX_SMB.

  • region_code- La región en la que quieres activar tu puerta de enlace. Consulte Puntos de conexión regionales 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 enlace de la VPC de su puerta de enlace, por ejemplovpce-050f90485f28f2fd0-iep0e8vq.storagegateway.us-west-2.vpce.amazonaws.com.

Punto de conexión público

Para obtener una clave de activación para un punto de conexión público, utilice uno de los siguientes comandos:

Puntos de conexión estándar

Para obtener la clave de activación de un punto de conexión estándar:

curl "http://gateway_ip_address/?activationRegion=region_code&no_redirect"
Dual-stack puntos finales

Para obtener la clave de activación de un punto de conexión 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 de conexión 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

El siguiente ejemplo muestra cómo usar Linux (bash/zsh) para obtener 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 usar 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 siguientes ejemplos se muestra cómo utilizar la consola local para generar y mostrar una clave de activación.

Puertas de enlace basadas en Amazon Linux 2 (AL2)

Puede seleccionar puntos de conexión estándar o puntos de conexión FIPS para las puertas de enlace basadas en AL2.

nota

Los puntos finales FIPS no están disponibles en todos los casos. Regiones de AWS Para obtener más información, consulte Puntos de conexión FIPS por servicio.

Para obtener una clave de activación para su AL2-based puerta de enlace desde su consola local
  1. Inicie sesión en la consola local como administrador.

  2. En el menú principal Activación del dispositivo de AWS - Configuración, seleccione 0 para elegir Obtener clave de activación.

  3. Seleccione Storage Gateway como opción de familia de puertas de enlace.

  4. Introduzca la AWS región en la que desea activar su puerta de enlace.

  5. Para el tipo de red, introduzca 1 para pública o 2 para VPC.

  6. Para el tipo de punto de conexión, introduzca 1 para estándar o 2 para Estándar Federal de Procesamiento de Información (FIPS).

Puertas de enlace basadas en Amazon Linux 2023 (AL2023)

Para las puertas de enlace basadas en AL2023, están disponibles los siguientes puntos de conexión:

  • Puntos de conexión estándar (solo compatibles con IPv4)

  • Puntos de conexión FIPS (solo compatibles con IPv4)

  • Dual-stack terminales (compatibles con IPv4 e IPv6)

  • Dual-stack Terminales FIPS (compatibles con IPv4 e IPv6)

Para obtener más información, consulte Tipo de punto de conexión.

Para obtener una clave de activación para su AL2023-based puerta de enlace desde su consola local
  1. Inicie sesión en la consola local. Si se conecta a la instancia de Amazon EC2 desde un equipo Windows, inicie sesión como admin.

  2. En el menú principal Activación del dispositivo de AWS - Configuración, seleccione 0 para elegir Obtener clave de activación.

  3. Seleccione Storage Gateway como opción de familia de puertas de enlace.

  4. Introduzca la AWS región en la que desea activar su puerta de enlace.

  5. Para el tipo de red, introduzca 1 para pública o 2 para punto de conexión de VPC.

  6. En Seleccionar tipo de punto de conexión, ¿Habilitar FIPS?, introduzca Y para habilitar FIPS o N puara usar un punto de conexión no FIPS.

  7. Para el tipo de punto de conexión, introduzca 1 para punto de conexión estándar o 2 para punto de conexión de doble pila.

    1. Para un punto de conexión de doble pila, en Seleccionar versión IP o salir:, introduzca 1 para IPv4 o 2 para IPv6.