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 ActivateGateway a Referência da API 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"

Dual-stack pontos finais

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 2 (AL2)

Você pode selecionar endpoints padrão ou FIPS para gateways baseados no AL2.

Gateways baseados no Amazon Linux 2023 (AL2023)

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

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