As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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.

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.

Linux (curl)

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

Endpoint público

Para obter uma chave de ativação para um endpoint público, use um dos seguintes comandos:

Endpoints padrão

Para obter a chave de ativação para um endpoint padrão:

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

Endpoints de pilha dupla

Para obter a chave de ativação para um endpoint de pilha dupla:

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"

Endpoints do FIPS

Para obter a chave de ativação para um endpoint 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"

Endpoints da VPC

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.

Gateways baseados no Amazon Linux (2AL2)

Você pode selecionar endpoints padrão ou FIPS para gateways com base em. AL2

Gateways baseados no Amazon Linux 2023 (AL2023)

Para gateways baseados em AL2023, os seguintes endpoints estão disponíveis:

Para obter mais informações, consulte Tipos de endpoint.