Utilizzo dell'endpoint EC2 compatibile con Amazon su un dispositivo Snow Family - AWS Snowball Edge Guida per gli sviluppatori
Specificare l'endpoint compatibile come endpoint EC2 AWS CLI Comandi compatibili EC2 supportati AWS CLI Operazioni EC2 compatibili con API Amazon 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 EC2 compatibile con Amazon su un dispositivo Snow Family

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

Specificazione dell'endpoint EC2 compatibile come endpoint su un dispositivo Snow Family AWS CLI

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

HTTPSendpoint protetto

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

HTTPendpoint non protetto

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

Se si utilizza l'HTTPSendpoint di8243, i dati in transito vengono 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 EC2 compatibile con Amazon

  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 sui dispositivi Snow Family.

  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

Dopo aver completato la procedura, puoi eseguire CLI i comandi con queste credenziali locali, il tuo certificato e l'endpoint specificato.

AWS CLI Comandi EC2 compatibili con Amazon supportati su un dispositivo Snow Family

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

Elenco dei AWS CLI comandi EC2 compatibili supportati su un dispositivo Snow Family

Di seguito, puoi trovare 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 EBS volume Amazon a un'istanza interrotta o in esecuzione sul dispositivo e lo espone all'istanza con il nome del dispositivo specificato.

    • --device — Il nome del dispositivo. value

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

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

  • authorize-security-group-egress— Aggiunge una o più regole di uscita a un gruppo di sicurezza da utilizzare con un dispositivo Snowball Edge. In particolare, questa azione consente alle istanze di inviare traffico a uno o più intervalli di indirizzi di destinazione. IPv4 CIDR Per ulteriori informazioni, consulta Controllo del traffico di rete con gruppi di sicurezza sui dispositivi Snow Family.

    • --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 oUDP, l'intervallo di porte da consentire. Questo valore può essere un singolo numero intero o un intervallo (minimo-massimo).

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

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

  • 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

      JSONsintassi:

      {
    "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 compatibili con Amazon. EC2 API Per ulteriori informazioni, consulta Specificazione dell'endpoint EC2 compatibile come endpoint su un dispositivo Snow Family 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

      JSONsintassi:

      {
    "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 compatibili con Amazon. EC2 API Per ulteriori informazioni, consulta Specificazione dell'endpoint EC2 compatibile come endpoint su un dispositivo Snow Family 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 EBS volume Amazon 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

      • sbp1per SSD volumi

    • [--tag-specificvalue] — 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.

  • 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 compatibili con Amazon. EC2 API Per ulteriori informazioni, consulta Specificazione dell'endpoint EC2 compatibile come endpoint su un dispositivo Snow Family 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 (istanza di calcoloAMI, modello di avvio o gruppo di sicurezza).

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

    • --volume-id — L'ID del value 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 () disponibili. AMIs Le immagini a tua disposizione vengono aggiunte al dispositivo Snowball Edge durante la creazione del lavoro.

    • --image-id — L'ID AMI Snowball di. 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 — L'elenco IDs di una o più sbe istanze che sono state interrotte sul 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 EC2 compatibili con Amazon 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).

    • JSONSintassi:

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

    • [--instance-ids](elenco)

      L'istanzaIDs.

      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.

    Specificate il modello di lancio IDs o i nomi dei modelli di lancio nella richiesta.

    • -- launch-template-ids (elenco) "string" "string" — Un elenco IDs 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 compatibili con Amazon. EC2 API Per ulteriori informazioni, consulta Specificazione dell'endpoint EC2 compatibile come endpoint su un dispositivo Snow Family 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.

    Specificate il modello di lancio IDs 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 compatibili con Amazon. EC2 API Per ulteriori informazioni, consulta Specificazione dell'endpoint EC2 compatibile come endpoint su un dispositivo Snow Family 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ù API chiamate 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 Interface utente.

    • [--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 Interface utente.

    • [--starting-tokenvalue] — Un token per specificare da 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 specificati. EBS

    • [--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.

    • [--volume-ids] — Uno o più volumivalue. IDs

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

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

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

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

  • 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 avvio. È 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 compatibili con Amazon. EC2 API Per ulteriori informazioni, consulta Specificazione dell'endpoint EC2 compatibile come endpoint su un dispositivo Snow Family 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 oUDP, l'intervallo di porte da consentire. Un singolo numero intero o un intervallo (minimo-massimo).

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

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

  • run-instances: avvia una serie di istanze di calcolo utilizzando uno Snowball ID per un. AMI 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 JSON sintassi di 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 diAMI, che puoi ottenere chiamando. describe-images Un AMI è necessario per avviare un'istanza.

    • -- 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 Amazon EC2 User Guide for Linux Instances.

    • --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ù gruppi di sicurezza. IDs È 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 utilizza la AWS CLI codifica base64 viene eseguita automaticamente ed è possibile 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 AMI che non ne scelga una configurata 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 — L'elenco IDs di una o più sbe istanze che sono state interrotte sul 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'elenco IDs di una o più sbe istanze 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 Amazon EC2 User Guide for Linux Instances.

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

  • create-key-pair— Crea una coppia di RSA chiavi 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 PEM crittografata con codifica. 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 API le chiamate, 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) — Le coppie IDs 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.

APIOperazioni EC2 compatibili con Amazon supportate su un dispositivo Snow Family

Di seguito, puoi trovare API le operazioni EC2 compatibili con Amazon che puoi utilizzare con Snowball Edge, con collegamenti alle relative descrizioni in Amazon EC2 API Reference.APILe chiamate EC2 compatibili con Amazon richiedono la firma Signature Version 4 (SigV4). Se utilizzi AWS CLI o an AWS SDK per effettuare queste API chiamate, 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 sui dispositivi Snow Family.