Utilizzo dell'endpoint compatibile con Amazon EC2 - AWS Snowball Edge Guida per gli sviluppatori
Specificazione dell'endpoint compatibile con Amazon EC2 come endpoint AWS CLIAWS CLIComandi compatibili con Amazon EC2 supportati su Snowball EdgeOperazioni API compatibili con Amazon EC2 supportate

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo dell'endpoint compatibile con Amazon EC2

Di seguito, puoi trovare una panoramica dell'endpoint compatibile con Amazon EC2. Utilizzando questo endpoint, puoi gestire le tue Amazon Machine Images (AMI) e calcolare le istanze in modo programmatico utilizzando operazioni API compatibili con Amazon EC2.

Specificazione dell'endpoint compatibile con Amazon EC2 come endpoint AWS CLI

Quando usi per inviare un comando AWS CLI al AWS Snowball Edge dispositivo, puoi specificare che l'endpoint è un endpoint compatibile con Amazon EC2. Puoi scegliere di utilizzare l'endpoint HTTPS o un endpoint HTTP non protetto, come mostrato di seguito.

Endpoint protetto HTTPS

aws ec2 describe-instances --endpoint https://192.0.2.0:8243 --ca-bundle path/to/certificate

Endpoint non protetto HTTP

aws ec2 describe-instances --endpoint http://192.0.2.0:8008

Se utilizzi l'endpoint HTTPS 8243, i dati in transito sono crittografati. Questa crittografia è garantita da un certificato generato da Snowball Edge quando viene sbloccato. Dopo aver ottenuto il certificato, puoi salvarlo in un file ca-bundle.pem locale. Puoi, quindi, configurare il profilo AWS CLI per includere il percorso al certificato, come descritto di seguito.

Per associare il certificato all'endpoint compatibile con Amazon EC2

  1. Connect Snowball Edge all'alimentazione e alla rete e accendilo.

  2. Al termine della procedura di sblocco, prendere nota del relativo indirizzo IP sulla rete locale.

  3. Da un terminale della rete, assicurati di poter eseguire il ping di Snowball Edge.

  4. Eseguire il comando snowballEdge get-certificate nel terminale. Per ulteriori informazioni su questo comando, consulta Gestione dei certificati a chiave pubblica.

  5. Salvare l'output del comando snowballEdge get-certificate in un file, ad esempio ca-bundle.pem.

  6. Eseguire il seguente comando dal terminale.

    aws configure set profile.snowballEdge.ca_bundle /path/to/ca-bundle.pem

Al termine della procedura, puoi eseguire comandi CLI con queste credenziali locali, il certificato e l'endpoint specificato.

AWS CLIComandi compatibili con Amazon EC2 supportati su Snowball Edge

Puoi gestire le tue istanze di calcolo su un dispositivo Snow Family tramite un endpoint compatibile con Amazon EC2. Questo tipo di endpoint supporta molti dei comandi e delle azioni CLI di Amazon EC2 degli SDK. AWS Per informazioni sull'installazione e la configurazione diAWS CLI, inclusa l'indicazione del destinatario delle AWS CLI chiamate, consulta la Guida per l'Regioni AWSutente. AWS Command Line Interface

Elenco di AWS CLI comandi compatibili con Amazon EC2 supportati su Snowball Edge

Di seguito è riportata una descrizione del sottoinsieme di AWS CLI comandi e opzioni per Amazon EC2 supportati sui dispositivi Snowball Edge. Un comando o un'opzione non incluso nell'elenco seguente non è supportato. Insieme al comando, puoi dichiarare alcune opzioni non supportate. Tuttavia, queste vengono ignorate.

  • associate-address: associa un indirizzo IP virtuale a un'istanza per l'uso in una delle tre interfacce di rete fisiche nel dispositivo:

    • --instance-id: ID di una singola istanza sbe.

    • --public-ip: indirizzo IP virtuale da utilizzare per accedere all'istanza.

  • attach-volume: collega un volume Amazon EBS a un'istanza interrotta o in esecuzione sul dispositivo e lo espone all'istanza con il nome del dispositivo specificato.

    • --device — value Il nome del dispositivo.

    • --instance-id — L'ID di un'istanza di destinazione compatibile con Amazon EC2.

    • --volume-id — L'ID del volume value EBS.

  • authorize-security-group-egress— Aggiunge una o più regole di uscita a un gruppo di sicurezza da utilizzare con un dispositivo Snowball Edge. Nello specifico, questa azione consente di inviare il traffico verso le istanze di uno o più intervalli di indirizzi CIDR IPv4 di destinazione. Per ulteriori informazioni, consulta Gruppi di sicurezza nei dispositivi Snowball Edge.

    • --group-id value — L'ID del gruppo di sicurezza

    • [--ip-permissionsvalue] — Uno o più set di autorizzazioni IP.

  • authorize-security-group-ingress— Aggiunge una o più regole di ingresso a un gruppo di sicurezza. Quando chiami authorize-security-group-ingress, devi specificare un valore per group-name o group-id.

    • [--group-namevalue] — Il nome del gruppo di sicurezza.

    • [--group-idvalue] — L'ID del gruppo di sicurezza

    • [--ip-permissionsvalue] — Uno o più set di autorizzazioni IP.

    • [--protocol value] Il protocollo IP. I valori possibili sono tcp, udp e icmp. L'argomento --port è obbligatorio, a meno che non sia stato specificato il valore "all protocols" (-1).

    • [--portvalue] — Per TCP o UDP, l'intervallo di porte da consentire. Questo valore può essere un numero intero singolo o un intervallo (minimo-massimo).

      Per ICMP, un numero intero o un intervallo (type-code) in cui type rappresenta il numero del tipo ICMP e code rappresenta il numero del codice ICMP. Il valore -1 indica tutti i codici ICMP per tutti i tipi di ICMP. Il valore -1 solo per type indica tutti i codici ICMP per il tipo di ICMP specificato.

    • [--cidrvalue] — L'intervallo IP CIDR.

  • create-launch-template— Crea un modello di lancio. Un modello di lancio contiene i parametri per avviare un'istanza. Quando avvii un'istanza utilizzando RunInstances, puoi specificare un modello di lancio invece di fornire i parametri di lancio nella richiesta. È possibile creare fino a 100 modelli per dispositivo.

    • -- launch-template-name string — Un nome per il modello di lancio.

    • -- launch-template-data structure — Le informazioni per il modello di lancio. Sono supportati gli attributi seguenti:

      • ImageId

      • InstanceType

      • SecurityGroupIds

      • TagSpecifications

      • UserData

      Sintassi JSON:

      {
    "ImageId":"string",
    "InstanceType":"sbe-c.large",
    "SecurityGroupIds":["string", ...],
    "TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"Name","Value":"Test"},
    {"Key":"Stack","Value":"Gamma"}]}],
    "UserData":"this is my user data"
}

    • [--version-descriptionstring] — Una descrizione per la prima versione del modello di lancio.

    • --endpoint snowballEndpoint — Un valore che consente di gestire le istanze di calcolo in modo programmatico utilizzando operazioni API compatibili con Amazon EC2. Per ulteriori informazioni, consulta Specificazione dell'endpoint compatibile con Amazon EC2 come endpoint AWS CLI.

  • create-launch-template-version— Crea una nuova versione per un modello di lancio. È possibile specificare una versione esistente di un modello di lancio su cui basare la nuova versione. Le versioni del modello di avvio sono numerate nell'ordine in cui sono state create. Non è possibile specificare, modificare o sostituire la numerazione delle versioni del modello di lancio. È possibile creare fino a 100 versioni di ogni modello di lancio.

    Specificare l'ID o il nome del modello di lancio nella richiesta.

    • -- launch-template-id string — L'ID del modello di lancio.

    • -- launch-template-name string — Un nome per il modello di lancio.

    • -- launch-template-data structure — Le informazioni per il modello di lancio. Sono supportati gli attributi seguenti:

      • ImageId

      • InstanceType

      • SecurityGroupIds

      • TagSpecifications

      • UserData

      Sintassi JSON:

      {
    "ImageId":"string",
    "InstanceType":"sbe-c.large",
    "SecurityGroupIds":["string", ...],
    "TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"Name","Value":"Test"},
     {"Key":"Stack","Value":"Gamma"}]}],
    "UserData":"this is my user data"
}

    • [--source-versionstring] — Il numero di versione del modello di lancio su cui basare la nuova versione. La nuova versione eredita gli stessi parametri di lancio della versione di origine, ad eccezione dei parametri specificati in launch-template-data.

    • [--version-descriptionstring] — Una descrizione per la prima versione del modello di lancio.

    • --endpoint snowballEndpoint — Un valore che consente di gestire le istanze di calcolo in modo programmatico utilizzando operazioni API compatibili con Amazon EC2. Per ulteriori informazioni, consulta Specificazione dell'endpoint compatibile con Amazon EC2 come endpoint AWS CLI.

  • create-tags — Aggiunge o sovrascrive uno o più tag per la risorsa specificata. Ogni risorsa può avere un massimo di 50 tag. Ciascun tag è formato da una chiave e da un valore opzionale. Le chiavi del tag devono essere univoche per una risorsa. Sono supportate le seguenti risorse :

    • AMI

    • Istanza

    • Modello di avvio

    • Gruppo di sicurezza

    • Coppia di chiavi

  • create-security-group— Crea un gruppo di sicurezza su Snowball Edge. Puoi creare fino a 50 gruppi di sicurezza. Quando crei un gruppo di sicurezza, devi specificare un nome di tua scelta:

    • --group-name value — Il nome del gruppo di sicurezza.

    • --description value — Una descrizione del gruppo di sicurezza. Questo messaggio è solo informativo. Questo valore deve contenere al massimo 255 caratteri.

  • create-volume: crea un volume Amazon EBS che può essere collegato a un'istanza sul tuo dispositivo.

    • [--sizevalue] — La dimensione del volume in GiBs, che può essere compresa tra 1 GiB e 1 TB ( GiBs1000).

    • [--snapshot-idvalue] — L'istantanea da cui creare il volume.

    • [--volume-type] — value Il tipo di volume. Se nessun valore è specificato, il valore predefinito è sbg1. I valori possibili sono:

      • sbg1 per volumi magnetici

      • sbp1 per volumi SSD

    • [--tag-specificationsvalue] — Un elenco di tag da applicare al volume durante la creazione.

  • delete-launch-template— Elimina un modello di avvio. L'eliminazione di un modello di avvio ne elimina tutte le versioni.

    Specificare l'ID o il nome del modello di lancio nella richiesta.

    • -- launch-template-id string — L'ID del modello di lancio.

    • -- launch-template-name string — Un nome per il modello di lancio.

    • --endpoint snowballEndpoint — Un valore che consente di gestire le istanze di calcolo in modo programmatico utilizzando operazioni API compatibili con Amazon EC2. Per ulteriori informazioni, consulta Specificazione dell'endpoint compatibile con Amazon EC2 come endpoint AWS CLI.

  • delete-launch-template-version— Elimina una o più versioni di un modello di lancio. Non è possibile eliminare la versione predefinita di un modello di lancio; è necessario prima assegnare una versione diversa come predefinita. Se la versione predefinita è l'unica versione del modello di lancio, eliminare l'intero modello di lancio usando il comando delete-launch-template.

    Specificare l'ID o il nome del modello di lancio nella richiesta.

    • -- launch-template-id string — L'ID del modello di lancio.

    • -- launch-template-name string — Un nome per il modello di lancio.

    • --versions (list) "string" "string" — I numeri di versione di una o più versioni del template di avvio da eliminare.

    • --endpoint snowballEndpoint — Un valore che consente di gestire le istanze di calcolo in modo programmatico utilizzando operazioni API compatibili con Amazon EC2. Per ulteriori informazioni, consulta Specificazione dell'endpoint compatibile con Amazon EC2 come endpoint AWS CLI.

  • delete-security-group— Elimina un gruppo di sicurezza.

    Se tenti di eliminare un gruppo di sicurezza associato a un'istanza o a cui fa riferimento un altro gruppo di sicurezza, l'operazione ha esito negativo con DependencyViolation.

    • --group-name value — Il nome del gruppo di sicurezza.

    • --description value — Una descrizione del gruppo di sicurezza. Questo messaggio è solo informativo. Questo valore deve contenere al massimo 255 caratteri.

  • delete-tags — Elimina il set di tag specificato dalla risorsa specificata (AMI, istanza di calcolo, modello di avvio o gruppo di sicurezza).

  • delete-volume — Elimina il volume Amazon EBS specificato. Il volume deve essere nello stato available (non collegato a un'istanza).

    • value--volume-id — L'ID del volume.

  • describe-addresses: descrive uno o più indirizzi IP virtuali associati allo stesso numero di istanze sul dispositivo. sbe

    • --public-ips: uno o più degli indirizzi IP virtuali associati alle proprie istanze in uso.

  • describe-images: descrive una o più immagini (AMI) a tua disposizione. Le immagini a tua disposizione vengono aggiunte al dispositivo Snowball Edge durante la creazione del lavoro.

    • --image-id — L'ID Snowball AMI dell'AMI.

  • describe-instance-attribute— Descrive l'attributo specificato dell'istanza specificata. Puoi specificare solo un attributo per volta. Sono supportati gli attributi seguenti:

    • instanceInitiatedShutdownBehavior

    • instanceType

    • userData

  • describe-instances: descrive una o più delle istanze. La risposta indica tutti i gruppi di sicurezza assegnati per le istanze.

    • --instance-ids: ID di una o più istanze sbe arrestate nel dispositivo.

    • --page-size — La dimensione di ogni pagina da inserire nella chiamata. Questo valore non influisce sul numero di elementi restituiti nell'output del comando. Impostando dimensioni minori per la pagina, vengono effettuate più chiamate al dispositivo e recuperati meno elementi in ogni chiamata. Questo contribuisce a prevenire il timeout delle chiamate.

    • --max-items — Il numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili supera il valore specificato, viene fornito un NextToken nell'output del comando. Per riprendere la paginazione, specifica il valore NextToken nell'argomento starting-token di un comando successivo.

    • --starting-token — Un token per specificare dove iniziare l'impaginazione. Questo token è il valore NextToken proveniente da una risposta troncata in precedenza.

  • describe-instance-status— Descrive lo stato delle istanze specificate o di tutte le istanze. Per impostazione predefinita, vengono descritte solo le istanze in esecuzione, a meno che non si indichi specificamente di restituire lo stato di tutte le istanze. Lo stato dell'istanza include i seguenti componenti:

    • Controlli dello stato: il dispositivo Snow esegue controlli di stato su istanze compatibili con Amazon EC2 in esecuzione per identificare problemi hardware e software.

    • Stato dell'istanza: puoi gestire le istanze dal momento in cui le avvii fino alla loro chiusura.

    Con questo comando sono supportati i seguenti filtri.

    • [--filters](elenco)

      I filtri.

      • instance-state-code— Il codice per lo stato dell'istanza, come numero intero senza segno a 16 bit. Il byte high viene utilizzato per scopi di reporting interno dei servizi e deve essere ignorato. Il byte basso viene impostato in base allo stato rappresentato. I valori validi sono 0 (in sospeso), 16 (in esecuzione), 32 (arresto), 48 (terminato), 64 (arresto) e 80 (interrotto).

      • instance-state-name— Lo stato dell'istanza (pending| | | | |running). shutting-down terminated stopping stopped

      • instance-status.reachability— Filtra in base allo stato dell'istanza in cui il nome è reachability (passed| failed | initializing | |insufficient-data).

      • instance-status.status— Lo stato dell'istanza (ok| impaired | initializing | insufficient-data |not-applicable).

      • system-status.reachability— Filtri sullo stato del sistema in cui il nome è raggiungibilità (passed| | failed | initializing |insufficient-data).

      • system-status.status— Lo stato del sistema dell'istanza (ok| impaired | | initializing insufficient-data |not-applicable).

    • Sintassi JSON:

      [
  {
    "Name": "string",
    "Values": ["string", ...]
  }
  ...
]

    • [--instance-ids](elenco)

      Gli ID delle istanze.

      Predefinito: descrive tutte le istanze.

    • [--dry-run|--no-dry-run](booleano)

      Verifica se si dispone delle autorizzazioni necessarie per l'azione, senza effettuare effettivamente la richiesta, e fornisce una risposta di errore. Se si dispone delle autorizzazioni richieste, la risposta di errore è. DryRunOperation

      In caso contrario è UnauthorizedOperation.

    • [--include-all-instances | --no-include-all-instances](booleano)

      Quandotrue, include lo stato di salute per tutte le istanze. Quandofalse, include lo stato di integrità solo per le istanze in esecuzione.

      Impostazione predefinita: false

    • [--page-size](numero intero): la dimensione di ogni pagina da inserire nella chiamata. Questo valore non influisce sul numero di elementi restituiti nell'output del comando. Impostando dimensioni minori per la pagina, vengono effettuate più chiamate al dispositivo e recuperati meno elementi in ogni chiamata. Questo contribuisce a prevenire il timeout delle chiamate.

    • [--max-items](intero) — Il numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili supera il valore specificato, viene fornito un NextToken nell'output del comando. Per riprendere la paginazione, specifica il valore NextToken nell'argomento starting-token di un comando successivo.

    • [--starting-token](stringa) — Un token per specificare dove iniziare l'impaginazione. Questo token è il valore NextToken proveniente da una risposta troncata in precedenza.

  • describe-launch-templates— Descrive uno o più modelli di avvio. Il comando describe-launch-templates è un'operazione paginata. Puoi effettuare più chiamate per recuperare l'intero set di dati dei risultati.

    Specificare gli ID o i nomi dei modelli di lancio nella richiesta.

    • -- launch-template-ids (elenco) "string" "string" — Un elenco di ID dei modelli di lancio.

    • -- launch-template-names (elenco) "string" "string" — Un elenco di nomi per i modelli di lancio.

    • --page-size — La dimensione di ogni pagina da inserire nella chiamata. Questo valore non influisce sul numero di elementi restituiti nell'output del comando. Impostando dimensioni minori per la pagina, vengono effettuate più chiamate al dispositivo e recuperati meno elementi in ogni chiamata. Questo contribuisce a prevenire il timeout delle chiamate.

    • --max-items — Il numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili supera il valore specificato, viene fornito un NextToken nell'output del comando. Per riprendere la paginazione, specifica il valore NextToken nell'argomento starting-token di un comando successivo.

    • --starting-token — Un token per specificare dove iniziare l'impaginazione. Questo token è il valore NextToken proveniente da una risposta troncata in precedenza.

    • --endpoint snowballEndpoint — Un valore che consente di gestire le istanze di calcolo in modo programmatico utilizzando operazioni API compatibili con Amazon EC2. Per ulteriori informazioni, consulta Specificazione dell'endpoint compatibile con Amazon EC2 come endpoint AWS CLI.

  • describe-launch-template-versions— Descrive una o più versioni di un modello di lancio specificato. È possibile descrivere tutte le versioni, versioni singole o un intervallo di versioni. Il comando describe-launch-template-versions è un'operazione paginata. Puoi effettuare più chiamate per recuperare l'intero set di dati dei risultati.

    Specificare gli ID o i nomi dei modelli di lancio nella richiesta.

    • -- launch-template-id string — L'ID del modello di lancio.

    • -- launch-template-name string — Un nome per il modello di lancio.

    • [--versions (list)"string" "string"] — I numeri di versione di una o più versioni del template di lancio da eliminare.

    • [--min-versionstring] — Il numero di versione dopo il quale descrivere le versioni del modello di lancio.

    • [--max-versionstring] — Il numero di versione fino al quale descrivere le versioni dei modelli di lancio.

    • --page-size — La dimensione di ogni pagina da inserire nella chiamata. Questo valore non influisce sul numero di elementi restituiti nell'output del comando. Impostando dimensioni minori per la pagina, vengono effettuate più chiamate al dispositivo e recuperati meno elementi in ogni chiamata. Questo contribuisce a prevenire il timeout delle chiamate.

    • --max-items — Il numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili supera il valore specificato, viene fornito un NextToken nell'output del comando. Per riprendere la paginazione, specifica il valore NextToken nell'argomento starting-token di un comando successivo.

    • --starting-token — Un token per specificare dove iniziare l'impaginazione. Questo token è il valore NextToken proveniente da una risposta troncata in precedenza.

    • --endpoint snowballEndpoint — Un valore che consente di gestire le istanze di calcolo in modo programmatico utilizzando operazioni API compatibili con Amazon EC2. Per ulteriori informazioni, consulta Specificazione dell'endpoint compatibile con Amazon EC2 come endpoint AWS CLI.

  • describe-security-groups— Descrive uno o più dei tuoi gruppi di sicurezza.

    Il comando describe-security-groups è un'operazione paginata. È possibile effettuare più chiamate API per recuperare l'intero set di dati dei risultati.

    • [--group-namevalue] — Il nome del gruppo di sicurezza.

    • [--group-idvalue] — L'ID del gruppo di sicurezza.

    • [--page-sizevalue] — La dimensione di ogni pagina da inserire nella chiamata di servizio. AWS Questa dimensione non influisce sul numero di elementi restituiti nell'output del comando. L'impostazione di una dimensione di pagina più piccola comporta un maggior numero di chiamate al AWS servizio e il recupero di un minor numero di elementi in ogni chiamata. Questo approccio può aiutare a evitare il timeout delle chiamate di AWS servizio. Per esempi di utilizzo, consulta Pagination nella Guida per l'AWS Command Line Interfaceutente.

    • [--max-itemsvalue] — Il numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili supera il valore specificato, viene fornito un NextToken nell'output del comando. Per riprendere la paginazione, specifica il valore NextToken nell'argomento starting-token di un comando successivo. Non utilizzare l'elemento di NextToken risposta direttamente all'esterno di. AWS CLI Per esempi di utilizzo, consulta Pagination nella Guida per l'AWS Command Line Interfaceutente.

    • [--starting-tokenvalue] — Un token per specificare dove iniziare l'impaginazione. Questo token è il valore NextToken proveniente da una risposta troncata in precedenza. Per esempi di utilizzo, consulta Pagination nella Guida per l'utente. AWS Command Line Interface

  • describe-tags: descrive uno o più tag per la risorsa (imageo il gruppo di sicurezza) specificato. instance Con questo comando, i seguenti filtri sono supportati:

    • launch-template

    • resource-id

    • resource-type – image o instance

    • Chiave

    • value

  • describe-volumes: descrive i volumi Amazon EBS specificati.

    • [--max-itemsvalue] — Il numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili supera il valore specificato, viene fornito un NextToken nell'output del comando. Per riprendere la paginazione, specifica il valore NextToken nell'argomento starting-token di un comando successivo.

    • [--starting-tokenvalue] — Un token per specificare dove iniziare l'impaginazione. Questo token è il valore NextToken proveniente da una risposta troncata in precedenza.

    • [value--volume-ids] — Uno o più ID di volume.

  • detach-volume: scollega un volume Amazon EBS da un'istanza interrotta o in esecuzione.

    • [--devicevalue] — Il nome del dispositivo.

    • [--instance-id] — L'ID di un'istanza Amazon EC2 di destinazione.

    • --volume-id — L'ID del volumevalue.

  • disassociate-address: annulla l'associazione di un indirizzo IP virtuale all'istanza a cui è associato.

    • --public-ip — L'indirizzo IP virtuale che desideri dissociare dall'istanza.

  • get-launch-template-data— Recupera i dati di configurazione dell'istanza specificata. È possibile utilizzare questi dati per creare un modello di lancio.

  • modify-launch-template— Modifica un modello di lancio. È possibile specificare quale versione del modello di lancio impostare come versione predefinita. Quando si avvia un'istanza senza specificare una versione del modello di lancio, si applica la versione predefinita.

    Specificare l'ID o il nome del modello di lancio nella richiesta.

    • -- launch-template-id string — L'ID del modello di lancio.

    • -- launch-template-name string — Un nome per il modello di lancio.

    • --default-version string — Il numero di versione del modello di avvio da impostare come versione predefinita.

    • --endpoint snowballEndpoint — Un valore che consente di gestire le istanze di calcolo in modo programmatico utilizzando operazioni API compatibili con Amazon EC2. Per ulteriori informazioni, consulta Specificazione dell'endpoint compatibile con Amazon EC2 come endpoint AWS CLI.

  • modify-instance-attribute— Modifica un attributo dell'istanza specificata. Sono supportati gli attributi seguenti:

    • instanceInitiatedShutdownBehavior

    • userData

  • revoke-security-group-egress— Rimuove una o più regole di uscita da un gruppo di sicurezza:

    • [--group-idvalue] — L'ID del gruppo di sicurezza

    • [--ip-permissionsvalue] — Uno o più set di autorizzazioni IP.

  • revoke-security-group-ingress— Revoca una o più regole di ingresso a un gruppo di sicurezza. Quando chiami revoke-security-group-ingress, devi specificare un valore per group-name o group-id.

    • [--group-namevalue] — Il nome del gruppo di sicurezza.

    • [--group-idvalue] — L'ID del gruppo di sicurezza.

    • [--ip-permissionsvalue] — Uno o più set di autorizzazioni IP.

    • [--protocol value] Il protocollo IP. I valori possibili sono tcp, udp e icmp. L'argomento --port è obbligatorio, a meno che non sia stato specificato il valore "all protocols" (-1).

    • [--portvalue] — Per TCP o UDP, l'intervallo di porte da consentire. Un singolo numero intero o un intervallo (minimo-massimo).

      Per ICMP, un numero intero o un intervallo (type-code) in cui type rappresenta il numero del tipo ICMP e code rappresenta il numero del codice ICMP. Il valore -1 indica tutti i codici ICMP per tutti i tipi di ICMP. Il valore -1 solo per type indica tutti i codici ICMP per il tipo di ICMP specificato.

    • [--cidrvalue] — L'intervallo IP CIDR.

  • run-instances: avvia una serie di istanze di calcolo utilizzando un ID AMI Snowball per un'AMI.

    Nota

    L'avvio di un'istanza di calcolo su Snowball Edge può richiedere fino a un'ora e mezza, a seconda delle dimensioni e del tipo di istanza.

    • [-- block-device-mappings (list)] — Le voci di mappatura del dispositivo a blocchi. I parametri DeleteOnTermination, VolumeSize e VolumeType sono supportati. I volumi di avvio devono essere di tipo sbg1.

      La sintassi JSON per questo comando è la seguente.

      {
   "DeviceName": "/dev/sdh",
   "Ebs": 
   {
      "DeleteOnTermination": true|false,
      "VolumeSize": 100,
      "VolumeType": "sbp1"|"sbg1"
   }
}

    • --count — Numero di istanze da avviare. Specificando un numero singolo, questo viene considerato il numero minimo di istanze da avviare (il valore predefinito è 1). Specificando un intervallo nel formato min:max, il primo numero viene interpretato come il numero minimo e il secondo viene interpretato come il numero massimo di istanze da avviare.

    • --image-id — L'ID Snowball AMI dell'AMI, che puoi ottenere chiamando. describe-images Per avviare un'istanza è necessaria un'AMI.

    • -- InstanceInitiatedShutdownBehavior — Per impostazione predefinita, quando si avvia uno spegnimento dall'istanza (utilizzando un comando come shutdown o poweroff), l'istanza si arresta. Puoi modificare questo comportamento in modo che l'istanza venga terminata anziché arrestata. I parametri stop e terminate sono supportati. Il valore predefinito è stop. Per ulteriori informazioni, consulta Modifica del comportamento di arresto avviato dall'istanza nella Guida per l'utente di Amazon EC2 per le istanze Linux.

    • --instance-type: tipo di istanza sbe.

    • --launch-template structure — Il modello di avvio da utilizzare per avviare le istanze. I parametri specificati nel comando run-instances sostituiscono gli stessi parametri nel modello di lancio. È possibile specificare il nome o l'ID di un modello di lancio, ma non entrambi.

      {
   "LaunchTemplateId": "string",
   "LaunchTemplateName": "string",
   "Version": "string"
}

    • -- security-group-ids — Uno o più ID del gruppo di sicurezza. È possibile creare un gruppo di sicurezza utilizzando CreateSecurityGroup. Se non viene specificato alcun valore, viene assegnato l'ID per il gruppo di sicurezza di default per creare istanze.

    • --tag-specifications — I tag da applicare alle risorse durante il lancio. Puoi assegnare un tag alle istanze al lancio. I tag specificati vengono applicati a tutti i volumi o le istanze creati durante il lancio. Per applicare tag a una risorsa dopo che è stata creata, utilizza create-tags.

    • --user-data — I dati utente da rendere disponibili all'istanza. Se si sta utilizzando la AWS CLI, la codifica base64 viene eseguita per te e tu puoi caricare il testo da un file. In caso contrario, è necessario fornire testo con codifica base64.

    • --key-name (string) — Il nome della coppia di chiavi. È possibile creare una key pair utilizzando CreateKeyPair oImportKeyPair.

      avvertimento

      Se non specifichi una coppia di key pair, non puoi connetterti all'istanza a meno che non scegli un AMI configurato per consentire agli utenti un altro modo di accedere.

  • start-instances: avvia un'sbeistanza che hai interrotto in precedenza. Tutte le risorse collegate all'istanza persistono attraverso avvii e arresti, ma vengono cancellate se l'istanza viene terminata.

    • --instance-ids: ID di una o più istanze sbe arrestate nel dispositivo.

  • stop-instances: arresta un'istanza in esecuzione. sbe Tutte le risorse collegate all'istanza persistono attraverso avvii e arresti, ma vengono cancellate se l'istanza viene terminata.

    • --instance-ids – L'ID di una o più istanze sbe da arrestare sul dispositivo.

  • terminate-instances: chiude una o più istanze. Questa operazione è idempotente: terminando un'istanza più di una volta, ogni chiamata va a buon fine. Tutte le risorse collegate all'istanza persistono attraverso avvii e arresti, ma i dati vengono cancellati se l'istanza viene terminata.

    Nota

    Per impostazione predefinita, quando si utilizza un comando simile a shutdown o poweroff per avviare un arresto dall'istanza, l'istanza si arresta. Tuttavia, puoi utilizzare l'InstanceInitiatedShutdownBehaviorattributo per modificare questo comportamento in modo che questi comandi interrompano l'istanza. Per ulteriori informazioni, consulta Modifica del comportamento di arresto avviato dall'istanza nella Guida per l'utente di Amazon EC2 per le istanze Linux.

    • --instance-ids — Gli ID di una o più istanze da terminare sul dispositivo. sbe Tutti i dati collegati, archiviati per tali istanze, andranno persi.

  • create-key-pair— Crea una coppia di chiavi RSA a 2048 bit con il nome specificato. Amazon EC2 archivia la chiave pubblica e visualizza la chiave privata per consentirti di salvarla in un file. La chiave privata viene restituita come chiave privata PKCS #1 non crittografata con codifica PEM. Se esiste già una chiave con il nome specificato, Amazon EC2 restituisce un errore.

    • --key-name (string) — Un nome univoco per la coppia di chiavi.

      Vincoli: fino a 255 caratteri ASCII.

    • [--tag-specifications] (list) — I tag da applicare alla nuova key pair.

    {
    "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group",
    "Tags": [
      {
        "Key": "string",
        "Value": "string"
      }
      ...
    ]
  }
  ...

  • import-key-pair –

    • --key-name (string) — Un nome univoco per la coppia di chiavi.

      Vincoli: fino a 255 caratteri ASCII.

    • -- public-key-material (blob) — La chiave pubblica. Per le chiamate API, il testo deve essere codificato in base 64. Per gli strumenti da riga di comando, la codifica base64 viene eseguita automaticamente.

    • [--tag-specifications] (list) — I tag da applicare alla nuova key pair.

    {
    "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group",
    "Tags": [
      {
        "Key": "string",
        "Value": "string"
      }
      ...
    ]
  }

  • describe-key-pairs –

    [--filters] (list) — I filtri.

    • key-pair-id — L'ID della key pair.

    • key-name — Il nome della coppia di chiavi.

    • tag-key — La chiave di un tag assegnato alla risorsa. Usa questo filtro per trovare tutte le risorse a cui è stato assegnato un tag con una chiave specifica, indipendentemente dal valore del tag.

    • [--tag-specifications] (list) — I tag da applicare alla nuova key pair.

    • tag:key — La combinazione chiave/valore di un tag assegnato alla risorsa. Usa la chiave del tag nel nome del filtro e il valore del tag come valore del filtro. Ad esempio, per trovare tutte le risorse che hanno un tag con la chiave Owner e il valore Team A, specifica tag:Owner per il nome del filtro e Team A per il valore del filtro.

    {
    "Name": "string",
    "Values": ["string", ...]
  }
  ...

  • [--key-names] (list) — I nomi delle coppie di chiavi.

    Predefinito: descrive tutte le coppie di chiavi.

  • [--key-pair-ids] (elenco) — Gli ID delle coppie di chiavi.

  • delete-key-pair –

    • [--key-name] (string) — Il nome della coppia di chiavi.

    • [--key-pair-id] (string) — L'ID della coppia di key pair.

Operazioni API compatibili con Amazon EC2 supportate

Di seguito, puoi trovare le operazioni API compatibili con Amazon EC2 che puoi utilizzare con Snowball Edge, con collegamenti alle relative descrizioni nel riferimento alle API di Amazon EC2.Le chiamate API compatibili con Amazon EC2 richiedono la firma Signature Version 4 (SigV4). Se utilizzi AWS CLI o un AWS SDK per effettuare queste chiamate API, la firma SigV4 viene gestita automaticamente. In caso contrario, devi implementare la tua soluzione di firma SigV4. Per ulteriori informazioni, consulta Acquisizione e utilizzo delle credenziali locali di Amazon S3.