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á.
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://
. A saída dessa consulta retorna a região de ativação e a chave.gateway_ip_address
/?activationRegion=activation_region
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 Storage Gateway Hardware Appliance, os modelos de imagem de VM e as EC2 Amazon Amazon Machine Images (AMI) 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 IPv4 endereço do seu gateway, por exemplo172.31.29.201
-
gateway_type
- O tipo de gateway que você deseja ativar, comoSTORED
CACHED
,VTL
,FILE_S3
, ouFILE_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ãous-east-1
como padrão. -
vpc_endpoint
- O nome do VPC endpoint do 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
-
Faça login no console local. Se você estiver se conectando à sua EC2 instância da Amazon a partir de um computador Windows, faça login como administrador.
-
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. -
Selecione Storage Gateway para a opção da família de gateways.
-
Quando solicitado, insira a AWS região em que você deseja ativar seu gateway.
-
Insira
1
para pública ou2
para um endpoint da VPC como o tipo de rede. -
Insira
1
para padrão ou2
para FIPS (Padrões Federais de Processamento de Informações) como o tipo de endpoint.