Como obter a chave de ativação para o gateway

Para receber uma chave de ativação para seu gateway, faça uma solicitação pela web para a máquina virtual (VM) do gateway. A VM retorna um redirecionamento que contém a chave de ativação, que é passada como um dos parâmetros da ação ActivateGateway da API para especificar a configuração do seu gateway. Para obter mais informações, consulte ActivateGatewayna Referência da API do Storage Gateway.

nota

Se não forem usadas, as chaves de ativação do gateway expiram em 30 minutos.

A solicitação que você faz à VM do gateway inclui a AWS região em que a ativação ocorre. O URL que é retornado pelo redirecionamento na resposta contém um parâmetro de string de consulta denominado activationkey. Esse parâmetro de string de consulta é a sua chave de ativação. O formato da string de consulta é semelhante ao seguinte: http://gateway_ip_address/?activationRegion=activation_region. A saída dessa consulta retorna a região de ativação e a chave.

O URL também inclui vpcEndpoint o ID do endpoint da VPC para gateways que se conectam usando o tipo de endpoint da VPC.

nota

O dispositivo de hardware do Storage Gateway, os modelos de imagem de VM e as imagens de máquina da Amazon (AMI) do Amazon EC2 vêm pré-configurados com os serviços HTTP necessários para receber e responder às solicitações da web descritas nesta página. Não é necessário nem recomendado instalar nenhum serviço adicional em seu gateway.

Linux (curl)

Os exemplos a seguir mostram como obter uma chave de ativação com o Linux (curl).

nota

Substitua as variáveis destacadas por valores reais para o gateway. Os valores aceitáveis são os seguintes:

• gateway_ip_address: o endereço IPv4 do seu gateway, por exemplo, 172.31.29.201

• gateway_type - O tipo de gateway que você deseja ativar, como,STORED, CACHEDVTL, FILE_S3 ou. FILE_FSX_SMB

• region_code: a região em que você deseja ativar seu gateway. Consulte os endpoints regionais no Guia de referência geral da AWS . Se esse parâmetro não for especificado ou se o valor fornecido estiver escrito incorretamente ou não corresponder a uma região válida, o comando usará a região como padrão. us-east-1

• vpc_endpoint: o nome do endpoint da VPC para seu gateway, por exemplo, vpce-050f90485f28f2fd0-iep0e8vq.storagegateway.us-west-2.vpce.amazonaws.com.

Para obter a chave de ativação de um endpoint público:

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

Para obter a chave de ativação de um endpoint da VPC:

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

Linux (bash/zsh)

O exemplo a seguir mostra como usar o Linux (bash/zsh) para buscar a resposta HTTP, analisar cabeçalhos HTTP e obter a chave de ativação.

  
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

O exemplo a seguir mostra como usar o Microsoft Windows PowerShell para buscar a resposta HTTP, analisar cabeçalhos HTTP e obter a chave de ativação.

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]
    }
  }
}

Como usar seu console local

Os exemplos a seguir mostram como usar o console local para gerar e exibir uma chave de ativação.

Para obter uma chave de ativação para o gateway do seu console local

1. Faça login no console local. Se você estiver se conectando à instância do Amazon EC2 em um computador Windows, faça login como administrador.

2. Depois de fazer login e ver o menu principal de Ativação de dispositivos da AWS : configuração, selecione 0 para escolher Obter chave de ativação.

3. Selecione Storage Gateway para a opção da família de gateways.

4. Quando solicitado, insira a AWS região em que você deseja ativar seu gateway.

5. Insira 1 para pública ou 2 para um endpoint da VPC como o tipo de rede.

6. Insira 1 para padrão ou 2 para FIPS (Padrões Federais de Processamento de Informações) como o tipo de endpoint.