Ottenimento di una chiave di attivazione per il gateway

Per ricevere una chiave di attivazione per il gateway, effettua una richiesta Web alla macchina virtuale (VM) del gateway. La macchina virtuale restituisce un reindirizzamento che contiene la chiave di attivazione, che viene passata come uno dei parametri dell'opzione ActivateGateway API per specificare la configurazione del gateway. Per ulteriori informazioni, vedere ActivateGatewaylo Storage Gateway API Reference.

Nota

Le chiavi di attivazione del gateway scadono dopo 30 minuti se non vengono utilizzate.

La richiesta effettuata alla macchina virtuale gateway include la AWS regione in cui avviene l'attivazione. L'URL restituito dal reindirizzamento nella risposta contiene un parametro della stringa di query denominato activationkey. Questo parametro della stringa di query è la chiave di attivazione. Il formato della stringa di query ha un aspetto simile a questo: http://gateway_ip_address/?activationRegion=activation_region. L'output di questa query restituisce sia la regione che la chiave di attivazione.

L'URL include anche vpcEndpoint, l'ID dell'endpoint VPC per i gateway che si connettono utilizzando il tipo di endpoint VPC.

Nota

L'appliance hardware Storage Gateway, i modelli di immagini VM e le Amazon Machine Images (AMI) di Amazon EC2 sono preconfigurati con i servizi HTTP necessari per ricevere e rispondere alle richieste Web descritte in questa pagina. Non è richiesta né consigliata l'installazione di servizi aggiuntivi sul gateway.

Linux (curl)

Gli esempi seguenti mostrano come recuperare una chiave di attivazione utilizzando Linux (curl).

Nota

Sostituisci le variabili evidenziate con i valori effettivi per il gateway. I valori accettabili sono i seguenti:

• gateway_ip_address - L'indirizzo IPv4 del gateway, ad esempio 172.31.29.201

• gateway_type: il tipo di gateway che desideri attivare, ad esempio, STOREDCACHED, VTL o. FILE_S3 FILE_FSX_SMB

• region_code - La regione in cui desideri attivare il gateway. Consulta Endpoint regionali nella Guida di riferimento generale.AWS Se questo parametro non è specificato o se il valore fornito è digitato in modo errato o non corrisponde a una regione valida, il comando utilizzerà per impostazione predefinita la regione. us-east-1

• vpc_endpoint - Il nome dell'endpoint VPC per il gateway, ad esempio. vpce-050f90485f28f2fd0-iep0e8vq.storagegateway.us-west-2.vpce.amazonaws.com

Per ottenere la chiave di attivazione per un endpoint pubblico:

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

Per ottenere la chiave di attivazione per un endpoint VPC:

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

Linux (bash/zsh)

L'esempio seguente mostra come usare Linux (bash/zsh) per recuperare la risposta HTTP, analizzare le intestazioni HTTP e ottenere la chiave di attivazione.

  
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

L'esempio seguente mostra come utilizzare Microsoft Windows PowerShell per recuperare la risposta HTTP, analizzare le intestazioni HTTP e ottenere la chiave di attivazione.

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

Utilizzo della console locale

Nell'esempio seguente viene illustrato come utilizzare la console locale per generare e visualizzare una chiave di attivazione.

Come ottenere una chiave di attivazione per il gateway dalla console locale

1. Accedere alla tua console locale. Se ci si connette all'istanza Amazon EC2 da un computer Windows, accedere come amministratore.

2. Dopo aver effettuato l'accesso e aver visualizzato il menu principale Attivazione dell'AWS appliance: configurazione, seleziona 0 per scegliere Ottieni chiave di attivazione.

3. Seleziona Storage Gateway come opzione di famiglia di gateway.

4. Quando richiesto, inserisci la AWS regione in cui desideri attivare il gateway.

5. Immettere 1 per pubblico oppure 2 per endpoint VPC come tipo di rete.

6. Inserire 1 per Standard o 2 per Federal Information Processing Standard (FIPS) come tipo di endpoint.