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](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_ActivateGateway.html)na *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 AWS Storage Gateway Hardware Appliance, os modelos de imagem de VM e as Amazon Machine Images (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.
**Topics**
+ [Linux (curl)](#get-activation-key-linux-curl)
+ [Linux (bash/zsh)](#get-activation-key-linux)
+ [Microsoft Windows PowerShell](#get-activation-key-powershell)
+ [Como usar seu console local](#using-local-console)
## 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\$1ip\$1address*- O IPv4 endereço do seu gateway, por exemplo `172.31.29.201`
*gateway\$1type*- O tipo de gateway que você deseja ativar, como `STORED``CACHED`,`VTL`,`FILE_S3`, ou`FILE_FSX_SMB`.
*region\$1code*- A região em que você deseja ativar seu gateway. Consulte os [endpoints regionais](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints) 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 `us-east-1` como padrão.
*vpc\$1endpoint*- O nome do VPC endpoint do seu gateway, por exemplo. `vpce-050f90485f28f2fd0-iep0e8vq.storagegateway.us-west-2.vpce.amazonaws.com`
**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
**nota**
Os endpoints FIPS não estão disponíveis em todos. Regiões da AWS Para obter mais informações, consulte [Endpoints FIPS por serviço](https://aws.amazon.com/compliance/fips/).
**Para obter uma chave de ativação para seu gateway AL2 baseado em seu console local**
1. Faça login no console local como *admin*.
1. No menu principal **Ativação de dispositivos da AWS - Configuração**, selecione `0` para escolher **Obter chave de ativação**.
1. Selecione **Storage Gateway** para a opção da família de gateways.
1. Insira a AWS região em que você deseja ativar seu gateway.
1. Para o tipo de rede, insira `1` para pública ou `2` para VPC.
1. Para o tipo de endpoint, insira `1` para padrão ou `2` para Federal Information Processing Standards (FIPS).
**Gateways baseados no Amazon Linux 2023 (AL2023)**
Para gateways baseados em AL2023, os seguintes endpoints estão disponíveis:
+ Endpoints padrão ( IPv4 somente suporte)
+ Endpoints FIPS (somente suporte IPv4 )
+ Endpoints de pilha dupla (suporte e) IPv4 IPv6
+ Endpoints FIPS de pilha dupla (suporte e) IPv4 IPv6
Para obter mais informações, consulte [Tipos de endpoint](Requirements.md#endpoint-types-fgw).
**Para obter uma chave de ativação para seu gateway AL2023 baseado em 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*.
1. No menu principal **Ativação de dispositivos da AWS - Configuração**, selecione `0` para escolher **Obter chave de ativação**.
1. Selecione **Storage Gateway** para a opção da família de gateways.
1. Insira a AWS região em que você deseja ativar seu gateway.
1. Para o tipo de rede, insira `1` para pública ou `2` para endpoint da VPC.
1. Em **Selecionar tipo de endpoint**, **Habilitar FIPS?**, insira `Y` para habilitar FIPS ou `N` para usar um endpoint não FIPS.
1. Para o tipo de endpoint, insira `1` para endpoint padrão ou `2` para endpoint de pilha dupla.
1. Para um endpoint de pilha dupla, em **Selecionar versão IP ou sair:**, digite `1` for ou for. IPv4 `2` IPv6