**Questa documentazione è valida AWS CLI solo per la versione 1.** Abbiamo annunciato l' end-of-supportimminente rilascio della AWS CLI versione 1. Ti consigliamo di migrare alla AWS CLI versione 2. [Per date, dettagli aggiuntivi e informazioni su come effettuare la migrazione, consulta l'annuncio.](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/) Per la documentazione relativa alla versione 2 di AWS CLI, consulta la [Guida per l'utente della versione 2](https://docs.aws.amazon.com/cli/latest/userguide/). 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à. # Accesso all'aiuto e alle risorse per AWS CLI Questo argomento descrive come accedere ai contenuti di aiuto per AWS Command Line Interface (AWS CLI). **Topics** + [Il comando AWS CLI help integrato](#cli-usage-help-command) + [AWS CLI guida di riferimento](#cli-reference) + [Documentazione API](#api-reference) + [Risoluzione degli errori](#help-tshoot) + [Aiuto aggiuntivo](#help-additional) ## Il comando AWS CLI help integrato È possibile ottenere assistenza con qualsiasi comando quando si utilizza il comando AWS Command Line Interface (AWS CLI). Per farlo, basta digitare `help` al termine del nome di un comando. Ad esempio, il comando seguente mostra la guida per le AWS CLI opzioni generali e i comandi di primo livello disponibili. ``` $ aws help ``` Il comando seguente visualizza i comandi specifici di Amazon Elastic Compute Cloud (Amazon EC2) disponibili. ``` $ aws ec2 help ``` L’esempio seguente visualizza le informazioni dettagliate per l’operazione `DescribeInstances` di Amazon EC2. L'assistenza include le descrizioni dei parametri di input, i filtri disponibili e tutto ciò che è incluso nell'output. Include anche esempi che mostrano come digitare varianti comuni del comando. ``` $ aws ec2 describe-instances help ``` Il contenuto della Guida per ciascun comando è suddiviso in sei sezioni: Name Nome del comando. ``` NAME describe-instances - ``` Description Descrizione dell'operazione API richiamata dal comando. ``` DESCRIPTION Describes one or more of your instances. If you specify one or more instance IDs, Amazon EC2 returns information for those instances. If you do not specify instance IDs, Amazon EC2 returns information for all relevant instances. If you specify an instance ID that is not valid, an error is returned. If you specify an instance that you do not own, it is not included in the returned results. ... ``` Riepilogo Sintassi di base per l'utilizzo del comando e delle relative opzioni. Le opzioni tra parentesi quadre sono facoltative, hanno un valore predefinito oppure hanno un'opzione che può essere utilizzata in alternativa. ``` SYNOPSIS describe-instances [--dry-run | --no-dry-run] [--instance-ids ] [--filters ] [--cli-input-json ] [--starting-token ] [--page-size ] [--max-items ] [--generate-cli-skeleton] ``` Ad esempio, `describe-instances` ha un comportamento predefinito che descrive ***tutte le*** istanze nell'account corrente e nella regione. AWS Puoi specificare, a tua discrezione, un elenco di `instance-ids` per descrivere una o più istanze. `dry-run` è un flag booleano opzionale che non utilizza un valore. Per usare un flag booleano specifica il valore mostrato, in questo caso `--dry-run` o `--no-dry-run`. Anche `--generate-cli-skeleton` non utilizza un valore. Se per l'utilizzo di un'opzione sono previste condizioni, queste sono descritte nella sezione `OPTIONS` o mostrate negli esempi. Opzioni Descrizione di ogni singola opzione mostrata nella sinossi. ``` OPTIONS --dry-run | --no-dry-run (boolean) Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRun- Operation . Otherwise, it is UnauthorizedOperation . --instance-ids (list) One or more instance IDs. Default: Describes all your instances. ... ``` Esempi Esempi che mostrano l'utilizzo del comando e delle relative opzioni. Se non è disponibile alcun esempio per un comando o un caso d'uso di cui hai bisogno, richiedine uno utilizzando il link di feedback in questa pagina o nel riferimento al AWS CLI comando nella pagina di aiuto del comando. ``` EXAMPLES To describe an Amazon EC2 instance Command: aws ec2 describe-instances --instance-ids i-5203422c To describe all instances with the instance type m1.small Command: aws ec2 describe-instances --filters "Name=instance-type,Values=m1.small" To describe all instances with an Owner tag Command: aws ec2 describe-instances --filters "Name=tag-key,Values=Owner" ... ``` Output Descrizioni di ciascuno dei campi e dei tipi di dati inclusi nella risposta di AWS. Per `describe-instances`, l'output è un elenco di oggetti prenotazione, ciascuno dei quali contiene diversi campi e oggetti che includono informazioni sulle istanze a essi associate. Queste informazioni provengono dalla [documentazione API per il tipo di dati di prenotazione](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_Reservation.html) utilizzato da Amazon EC2. ``` OUTPUT Reservations -> (list) One or more reservations. (structure) Describes a reservation. ReservationId -> (string) The ID of the reservation. OwnerId -> (string) The ID of the AWS account that owns the reservation. RequesterId -> (string) The ID of the requester that launched the instances on your behalf (for example, AWS Management Console or Auto Scaling). Groups -> (list) One or more security groups. (structure) Describes a security group. GroupName -> (string) The name of the security group. GroupId -> (string) The ID of the security group. Instances -> (list) One or more instances. (structure) Describes an instance. InstanceId -> (string) The ID of the instance. ImageId -> (string) The ID of the AMI used to launch the instance. State -> (structure) The current state of the instance. Code -> (integer) The low byte represents the state. The high byte is an opaque internal value and should be ignored. ... ``` Quando AWS CLI esegue il rendering dell'output in JSON, diventa una matrice di oggetti di prenotazione, simile all'esempio seguente. ``` { "Reservations": [ { "OwnerId": "012345678901", "ReservationId": "r-4c58f8a0", "Groups": [], "RequesterId": "012345678901", "Instances": [ { "Monitoring": { "State": "disabled" }, "PublicDnsName": "ec2-52-74-16-12.us-west-2.compute.amazonaws.com", "State": { "Code": 16, "Name": "running" }, ... ``` Ogni oggetto prenotazione contiene campi che descrivono la prenotazione e una serie di oggetti istanza, ognuno con specifici campi (ad esempio, `PublicDnsName`) e oggetti (ad esempio, `State`) che lo descrivono. **Utenti Windows** Puoi *eseguire il piping* (\$1) dell'output del comando help su `more` per visualizzare il file della guida una pagina alla volta. Premete la barra spaziatrice o **PgDn**per visualizzare altre parti del documento e **q** per uscire. ``` C:\> aws ec2 describe-instances help | more ``` ## AWS CLI guida di riferimento I file della guida contengono collegamenti che non possono essere visualizzati o esplorati dalla riga di comando. È possibile visualizzare e interagire con questi collegamenti utilizzando la guida di [riferimento online AWS CLI versione 1 (guida](https://docs.aws.amazon.com/cli/v1/reference/) di . Il riferimento contiene anche il contenuto della guida per tutti AWS CLI i comandi. Le descrizioni sono presentate in modo da semplificare la navigazione e la visualizzazione su dispositivi mobili, tablet o schermi del desktop. ## Documentazione API Tutti i comandi in AWS CLI corrispondono alle richieste effettuate all'API pubblica di un AWS servizio. Ogni servizio con un’API pubblica include un riferimento API, disponibile nella home page del servizio nel [sito web della documentazione AWS](https://docs.aws.amazon.com/). Il contenuto di un riferimento API varia in base al modo in cui è costruita l'API e al protocollo utilizzato. Di solito, un riferimento API contiene informazioni dettagliate sulle operazioni supportate dall'API, sui dati inviati da e verso il servizio ed su eventuali condizioni di errore riportate dal servizio. **Sezioni della documentazione API** + **Operazioni**: informazioni dettagliate su ogni operazione e sui relativi parametri (inclusi i limiti di lunghezza o di contenuto e i valori predefiniti). Vengono elencati gli errori che possono verificarsi per questa operazione. Ogni operazione corrisponde a un sottocomando in. AWS CLI + **Tipi di dati**: informazioni dettagliate sulle strutture che un comando potrebbe richiedere come parametro o restituire in risposta a una richiesta. + **Parametri comuni**: informazioni dettagliate sui parametri condivisi da tutte le operazioni per il servizio. + **Errori comuni**: informazioni dettagliate sugli errori che possono essere restituiti da qualsiasi operazione del servizio. Il nome e la disponibilità di ogni sezione possono variare a seconda del servizio. **Specifico del servizio CLIs** Alcuni servizi dispongono di una CLI separata che risale a prima della creazione di una CLI singola AWS CLI per funzionare con tutti i servizi. Questi servizi specifici CLIs dispongono di una documentazione separata collegata alla pagina della documentazione del servizio. La documentazione relativa ai servizi specifici CLIs non si applica a. AWS CLI ## Risoluzione degli errori Per informazioni sulla diagnosi e la correzione degli AWS CLI errori, vedere. [Risoluzione degli errori relativi a AWS CLI](cli-chap-troubleshooting.md) ## Aiuto aggiuntivo Per ulteriore assistenza con i tuoi AWS CLI problemi, visita la [AWS CLI community](https://github.com/aws/aws-cli/issues) su *GitHub*.