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à.
# Nozioni di base su Amazon Textract
In questa sezione vengono forniti gli argomenti per iniziare a utilizzare Amazon Textract. Se non conosci Amazon Textract, ti consigliamo di esaminare prima i concetti e la terminologia in[Come funziona Amazon Textract](how-it-works.md).
Puoi provare l'API utilizzando la dimostrazione nella console Amazon Textract. Per ulteriori informazioni, consulta[https://console.aws.amazon.com/textract/](https://console.aws.amazon.com/textract/).
**Topics**
+ [Fase 1: Impostazione di un account AWS e creazione di un utente IAM](setting-up.md)
+ [Fase 2: Configurazione diAWS CLIeAWSSDK](setup-awscli-sdk.md)
+ [Fase 3: Nozioni di base sull'uso diAWS CLIeAWSSDK API](get-started-exercise.md)
# Fase 1: Impostazione di un account AWS e creazione di un utente IAM
Prima di usare Amazon Textract per la prima volta, è necessario completare le seguenti operazioni:
1. [Registrati ad AWS](#setting-up-signup).
1. [Creare un utente IAM](#setting-up-iam).
## Registrati ad AWS
Quando effettui la registrazione ad Amazon Web Services (AWS), l'account AWS viene automaticamente registrato per tutti i servizi rilasciati in AWS. Ti vengono addebitati solo i servizi che utilizzi.
Con Amazon Textract vengono erogati esclusivamente i costi per le risorse utilizzate. Per ulteriori informazioni sulle tariffe di utilizzo di Amazon Textract, consulta[Prezzi di Amazon Textract](https://aws.amazon.com/textract/pricing/). Se sei un nuovo cliente AWS, puoi iniziare a utilizzare Amazon Textract gratuitamente. Per ulteriori informazioni, consulta [Piano di utilizzo gratuito AWS](https://aws.amazon.com/free/).
Se disponi già di un account AWS, passa all'operazione successiva. Se non disponi ancora di un account AWS, effettua la procedura seguente per crearne uno.
**Per creare un account AWS**
1. Apri la pagina [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup).
1. Segui le istruzioni online.
Come parte della procedura di registrazione riceverai una telefonata, durante la quale dovrai inserire un codice di verifica sulla tastiera del telefono.
Annota l'ID del tuo account AWS perché sarà necessario per eseguire l'operazione successiva.
## Creare un utente IAM
Per accedere ai servizi in AWS, come Amazon Textract, è necessario fornire le credenziali. In questo modo, il servizio può stabilire se si dispone delle autorizzazioni per accedere alle risorse del servizio stesso. Per la console è necessaria la password. Per consentire all'account AWS di accedere a AWS CLI o all'API, è possibile creare chiavi di accesso. È sconsigliabile tuttavia accedere ad AWS utilizzando le credenziali dell'account AWS. Consigliamo invece di effettuare queste operazioni:
+ UtilizzaAWS Identity and Access Management(IAM) per creare un utente IAM.
+ Aggiungere l'utente a un gruppo IAM con autorizzazioni amministrative.
Potrai quindi accedere ad AWS utilizzando un URL speciale e le credenziali dell'utente IAM.
Se hai effettuato la registrazione ad AWS senza creare un utente IAM per te stesso, puoi crearne uno utilizzando la console IAM. Per creare un utente IAM nel tuo account, utilizza la procedura indicata di seguito.
**Creazione di utente IAM e accesso alla console**
1. Crea un utente IAM con autorizzazioni da amministratore nel tuo account AWS. Per istruzioni, consulta [Creating Your First IAM User and Administrators Group](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html) (Creazione del primo utente e del primo gruppo di amministratori IAM) nella *IAM User Guide* (Guida per l'utente di IAM).
1. Come utente IAM, accedi alla Console di gestione AWS utilizzando un URL speciale. Per ulteriori informazioni, consulta[Modalità di accesso degli utenti al tuo account](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_how-users-sign-in.html)nella*IAM User Guide*.
**Nota**
Un utente IAM con autorizzazioni da amministratore dispone di accesso illimitato allaAWSservizi nel tuo account. I codici di esempio in questa guida presumono che tu disponga di un utente con la`AmazonTextractFullAccess`autorizzazioni.`AmazonS3ReadOnlyAccess`è richiesto per gli esempi che accedono ai documenti archiviati in un bucket Amazon S3. A seconda dei requisiti di sicurezza, si consiglia di utilizzare un gruppo IAM che è limitato a queste autorizzazioni. Per ulteriori informazioni, consulta[Creazione di gruppi IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_create.html).
Per ulteriori informazioni su IAM, consulta:
+ [AWS Identity and Access Management (IAM)](https://aws.amazon.com/iam/)
+ [Nozioni di base](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started.html)
+ [Guida per l'utente di IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/)
## Fase successiva
[Fase 2: Configurazione diAWS CLIeAWSSDK](setup-awscli-sdk.md)
# Fase 2: Configurazione diAWS CLIeAWSSDK
La procedura seguente mostra come installare la AWS Command Line Interface (AWS CLI) e gli SDK AWS usati negli esempi contenuti in questa documentazione.
Esistono diversi modi per autenticare le chiamate SDK AWS. Gli esempi di questa guida presuppongono che tu stia utilizzando un profilo di credenziali predefinito per chiamare i comandi AWS CLI e le operazioni API SDK AWS. Le credenziali predefinite funzioneranno tra i servizi, quindi se hai già configurato le credenziali non devi farlo di nuovo. Tuttavia, se si desidera creare un altro set di credenziali per questo servizio, è possibile creare un profilo nome. Per ulteriori informazioni sulla creazione dei profili,[vedi Profili denominati.](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html)
Per un elenco di disponibiliAWSRegioni, vedi[Regioni ed endpoint](https://docs.aws.amazon.com/general/latest/gr/rande.html)nella*Riferimento generale di Amazon Web Services*.
**Per installare e configurare AWS CLI e gli SDK AWS**
1. Scarica e installa AWS CLI e gli SDK AWS che desideri usare. In questa guida vengono forniti degli esempi per laAWS CLI, Java e Python. Per informazioni su altri SDK AWS, consulta [Strumenti per Amazon Web Services](https://aws.amazon.com/tools/).
+ [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html)
+ [AWS SDK per Java](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/)
+ [AWS SDK per Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)
1. Creare una chiave di accesso per l'utente creato in[Creare un utente IAM](setting-up.md#setting-up-iam).
1. Accedi all'Console di gestione AWS e apri la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Nel pannello di navigazione, seleziona **Users** (Utenti).
1. Selezionare il nome dell'utente creato in[Creare un utente IAM](setting-up.md#setting-up-iam).
1. Selezionare la scheda **Security Credentials (Credenziali di sicurezza)**.
1. Selezionare **Create access key (Crea chiave di accesso)**. Quindi, selezionare **Download .csv file (Scarica file .csv)** per salvare l'ID chiave di accesso e la chiave di accesso segreta in un file CSV sul computer. Archiviare il file in un posto sicuro. Non sarà possibile accedere nuovamente alla chiave di accesso segreta dopo la chiusura di questa finestra di dialogo. Dopo aver scaricato il file CSV, selezionare**Chiudi**.
1. Impostare credenziali nel file del profilo delle credenziali di AWS nel sistema locale, che si trova in:
+ `~/.aws/credentials`in Linux, macOS o Unix.
+ `C:\Users\USERNAME\.aws\credentials`in Windows.
La`.aws`la cartella non esiste prima della prima configurazione iniziale dell'istanza AWS. La prima volta che configuri le credenziali con la CLI, questa cartella verrà creata. Per ulteriori informazioni sulle credenziali AWS, consulta[Impostazioni del file di configurazione e delle credenziali.](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
Questo file deve contenere righe nel seguente formato:
```
[default]
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key
```
Sostituire l'ID chiave di accesso e la chiave di accesso segreta*your\$1access\$1key\$1id*e*your\$1secret\$1access\$1key*.
1. Impostazione della regione AWS predefinita in AWS`config`nel sistema locale, che si trova in:
+ `~/.aws/config`in Linux, macOS o Unix.
+ `C:\Users\USERNAME\.aws\config`in Windows.
La`.aws`la cartella non esiste prima della prima configurazione iniziale dell'istanza AWS. La prima volta che configuri le credenziali con la CLI, questa cartella verrà creata. Per ulteriori informazioni sulle credenziali AWS, consulta[Impostazioni del file di configurazione e delle credenziali.](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
Questo file deve contenere le seguenti righe:
```
[default]
region = your_aws_region
```
Sostituire la regione AWS desiderata (ad esempio «us-west-2") per*your\$1aws\$1region*.
**Nota**
Se non scegli una regione, la regione us-east-1 viene utilizzata per impostazione predefinita.
## Fase successiva
[Fase 3: Nozioni di base sull'uso diAWS CLIeAWSSDK API](get-started-exercise.md)
# Fase 3: Nozioni di base sull'uso diAWS CLIeAWSSDK API
Dopo aver impostato ilAWS CLIeAWSPer creare applicazioni che utilizzano Amazon Textract. I seguenti argomenti illustrano le nozioni di base su Amazon Textract.
+ [Analisi del testo del documento con Amazon Textract](analyzing-document-text.md)
## Formattazione degli esempi di AWS CLI
Gli esempi di AWS CLI in questa guida sono formattati per il sistema operativo Linux. Per usare gli esempi con Microsoft Windows, occorre modificare la formattazione JSON del parametro `--document` e modificare le interruzioni riga da barre rovesciate (\$1) a caret (^). Per ulteriori informazioni sulla formattazione per JSON, consulta [Specifica di valori di parametri per l'interfaccia a riga di comando di AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html).