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à.
AWS CLI scheletri e file di input nel AWS CLI
La maggior parte dei AWS CLI comandi accetta l'importazione di input di parametri da un file. Questi modelli possono essere generati utilizzando l’opzione generate-cli-skeleton e quindi importati utilizzando i parametri --cli-input-json e --cli-input-yaml.
Argomenti
Informazioni sugli AWS CLI scheletri e sui file di input
La maggior parte dei comandi AWS Command Line Interface (AWS CLI) supporta la possibilità di accettare input di parametri da un file utilizzando il --cli-input-yaml parametro --cli-input-json and s.
Questi stessi comandi utilizzano il parametro --generate-cli-skeleton per generare un file in formato JSON o YAML con tutti i parametri che può essere modificato e compilato. Quindi puoi eseguire il comando con il parametro --cli-input-json o --cli-input-yaml e scegliere il file compilato.
Importante
AWS CLI I comandi personalizzati, ad esempio i command, non supportano né i --cli-input-yaml parametri --generate-cli-skeleton or --cli-input-json né quelli descritti in questo argomento. Per verificare se un comando specifico supporta questi parametri, esegui il helpcomando relativo al comando che desideri utilizzare o consulta la guida di riferimento per la per la AWS CLI versione 2.
Il comando --generate-cli-skeleton genera e visualizza un modello di parametri che è possibile personalizzare e utilizzare come input per un comando. Il modello generato include tutti i parametri supportati dal comando.
Il parametro --generate-cli-skeleton accetta uno dei seguenti valori:
-
input- Il modello generato include tutti i parametri di input formattati come JSON. Si tratta del valore di default. -
yaml-input- Il modello generato include tutti i parametri di input formattati come YAML. -
output- Il modello generato include tutti i parametri di output formattati come JSON. Al momento non è possibile richiedere i parametri di output come YAML.
Poiché AWS CLI è essenzialmente un «wrapper» attorno all'API del servizio, il file skeleton si aspetta che tu faccia riferimento a tutti i parametri tramite i nomi dei parametri API sottostanti. Probabilmente è diverso dal nome del parametro. AWS CLI Ad esempio, un AWS CLI parametro denominato user-name potrebbe essere mappato al parametro API del AWS servizio denominato UserName (notate le maiuscole alterate e il trattino mancante). Ti consigliamo di utilizzare l'opzione --generate-cli-skeleton per generare il modello con i nomi di parametro "corretti" per evitare errori. Puoi fare riferimento alla Guida di riferimento delle API per il servizio per visualizzare i nomi dei parametri previsti. Puoi eliminare dal modello tutti i parametri che non sono obbligatori e per i quali non desideri fornire un valore.
Ad esempio, se esegui questo comando, viene generato il modello di parametri per il comando run-instances di Amazon Elastic Compute Cloud (Amazon EC2).
Generazione e importazione di uno skeleton di comandi
Per generare e utilizzare un file scheletro dei parametri
-
Eseguire il comando con il parametro
--generate-cli-skeletonper produrre JSON o YAML e indirizzare l’output a un file per salvarlo. -
Apri il file scheletro dei parametri nell'editor di testo e rimuovi qualsiasi parametro non necessario. Ad esempio, è possibile eliminare il modello fino al seguente. Conferma che il file sia ancora nel formato JSON o YAML valido dopo aver rimosso gli elementi non necessari.
In questo esempio, il parametro
DryRunviene lasciato impostato sutrueper utilizzare la funzionalità di test EC2. Questa funzione consente di testare in modo sicuro il comando senza creare o modificare effettivamente alcuna risorsa. -
Compila i valori rimanenti con valori appropriati per il tuo scenario. In questo esempio, forniamo il tipo di istanza, il nome della chiave, il gruppo di sicurezza e l'identificatore dell'Amazon Machine Image (AMI) da utilizzare. Questo esempio presuppone l'impostazione predefinita. Regione AWS L’AMI
ami-dfc39aefè un’immagine a 64 bit Amazon Linux ospitata nella Regioneus-west-2. Se utilizzi un'altra regione, devi trovare l'ID AMI corretto da utilizzare. -
Eseguire il comando con i parametri completati passando il file modello completato al parametro
--cli-input-jsono --cli-input-yamlutilizzando il prefissofile://. AWS CLI Interpreta il percorso in modo che sia relativo alla directory di lavoro corrente. L'esempio seguente AWS CLI cerca il file nella directory di lavoro corrente.L’errore in fase di test indica che la formattazione del JSON o YAML è corretta e i valori dei parametri sono validi. Se nell'output vengono segnalati altri problemi, correggerli e ripetere la fase precedente fino a quando non viene visualizzato il messaggio"
Request would have succeeded". -
Ora puoi impostare il parametro
DryRunsufalseper disabilitare il test. -
Eseguire il comando, e
run-instancesavvia effettivamente un’istanza Amazon EC2 e visualizza tutte le informazioni generate dal lancio corretto. Il formato dell'output è controllato dal parametro--output, separatamente dal formato del modello di parametro di input.
Combinazione di file di input e parametri della riga di comando
Un file di input può essere utilizzato per tutti i parametri o può essere combinato con i parametri specificati in AWS CLI. È possibile utilizzare questa funzionalità per le impostazioni che si riutilizzano frequentemente in un file di input, mantenendo le impostazioni individuali nel comando stesso.
Negli esempi seguenti aws ec2 run-instances combinano l’uso di un file di input e di parametri. Forniamo il tipo di istanza, il nome della chiave, il gruppo di sicurezza, l'identificatore dell'Amazon Machine Image (AMI) da utilizzare e assumiamo quello predefinito Regione AWS. L’AMI ami-dfc39aef è un’immagine a 64 bit Amazon Linux ospitata nella Regione us-west-2. Se utilizzi un'altra regione, devi trovare l'ID AMI corretto da utilizzare
L’esempio seguente utilizza il file di input in combinazione con il parametro --dry-run per eseguire una prova del comando per confermare se si dispone delle autorizzazioni richieste e se il file è stato compilato con valori validi.
L’esempio seguente utilizza quindi lo stesso file di input, ma con il parametro --no-dry-run per eseguire il comando per intero.