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 sull’API
Prima di iniziare APIs, segui queste procedure se non conosci AWS o devi installare la AWS CLI o un AWS SDK. Se nessuna di queste condizioni si applica al tuo caso, passa a. [Ottenere le credenziali per concedere l’accesso programmatico](#grant-program-access)
## Sono nuovo AWS
Se non disponi di un AWS account, completa i seguenti passaggi per crearne uno. In alternativa, puoi iniziare a creare gratuitamente con Amazon Nova all'indirizzo [nova.amazon.com/dev](https://nova.amazon.com/dev).
**Per creare un account AWS**
1. Apri la [https://portal.aws.amazon.com/billing/registrazione.](https://portal.aws.amazon.com/billing/signup)
1. Segui le istruzioni online.
Nel corso della procedura di registrazione riceverai una telefonata o un messaggio di testo e ti verrà chiesto di inserire un codice di verifica attraverso la tastiera del telefono.
Quando si registra un AWS account, viene creato un *utente root dell'AWS account*. L'utente root ha accesso a tutte le risorse e i servizi AWS in tale account. Come procedura consigliata in materia di sicurezza, assegnate l'accesso amministrativo a un utente e utilizzate solo l'utente root per eseguire [attività che richiedono l'accesso da parte dell'utente root](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
AWS ti invia un'e-mail di conferma dopo il completamento della procedura di registrazione. In qualsiasi momento, puoi visualizzare l'attività corrente del tuo account e gestirlo accedendo a [https://aws.amazon.com/](https://aws.amazon.com/)e scegliendo **Il mio account**.
**Proteggi il tuo AWS account (utente root).**
1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/)come proprietario dell'account scegliendo **Utente root** e inserendo l'indirizzo email AWS del tuo account. Nella pagina successiva, inserisci la password.
Per informazioni sull'accesso tramite utente root, consulta [Accesso come utente root nella](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) *Guida per l'utente di AWS accesso*.
1. Abilita l'autenticazione a più fattori (MFA) per l'utente root.
Per istruzioni, consulta [Abilitare un dispositivo MFA virtuale per l'utente root (console) dell' AWS account](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) nella Guida per l'*utente IAM*.
## Devo installare la AWS CLI o un SDK AWS
Per installare la AWS CLI, segui i passaggi in [Installa o aggiorna alla versione più recente della AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
Per installare un AWS SDK, seleziona la scheda corrispondente al linguaggio di programmazione che desideri utilizzare in [Tools to Build on](https://aws.amazon.com/developer/tools/). AWS
AWS i kit di sviluppo software (SDKs) sono disponibili per molti linguaggi di programmazione più diffusi. Ogni SDK fornisce un'API, esempi di codice e documentazione che semplificano agli sviluppatori la creazione di applicazioni nella loro lingua preferita. SDKs esegue automaticamente attività utili per te, come:
+ Firma crittografata delle richieste di servizio
+ Richieste di ripetizione
+ Gestione delle risposte di errore
## Ottenere le credenziali per concedere l’accesso programmatico
Gli utenti necessitano dell'accesso programmatico se desiderano interagire con l' AWS esterno della console di AWS gestione. Il modo per concedere l'accesso programmatico dipende dal tipo di utente che accede. AWS
Per fornire agli utenti l’accesso programmatico, scegli una delle seguenti opzioni.
| Quale principale necessita dell’accesso programmatico? | Per | Come |
| --- | --- | --- |
| Utenti IAM | Limita la durata delle credenziali a lungo termine per firmare le richieste programmatiche alla AWS CLI, oppure. AWS SDKs AWS APIs | Segui le istruzioni per l’interfaccia che desideri utilizzare. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/nova/latest/nova2-userguide/getting-started-api.html) |
| Ruoli IAM | Utilizza credenziali temporanee per firmare le richieste programmatiche alla AWS CLI, oppure. AWS SDKs AWS APIs | Segui le istruzioni in [Utilizzo di credenziali temporanee con AWS risorse](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) nella Guida per l'utente IAM. |
| Utenti gestiti in IAM Identity Center | Utilizza credenziali temporanee per firmare le richieste programmatiche alla AWS CLI, oppure. AWS SDKs AWS APIs | Segui le istruzioni per l’interfaccia che desideri utilizzare. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/nova/latest/nova2-userguide/getting-started-api.html) |
## Collegare autorizzazioni Amazon Bedrock a un utente o a un ruolo
Dopo aver impostato le credenziali per l'accesso programmatico, devi configurare le autorizzazioni per un utente o un ruolo IAM per avere accesso alle azioni relative ad Amazon Bedrock. Per configurare queste autorizzazioni, procedi come segue:
1. Nella home page della console di AWS gestione, seleziona il servizio IAM o accedi alla console IAM all'indirizzo. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)
1. Seleziona **Utenti** o **Ruoli**, poi seleziona l’utente o il ruolo desiderato.
1. Nella scheda **Autorizzazioni**, scegli **Aggiungi autorizzazioni**, quindi scegli **Aggiungi policy AWS gestita**. Scegli la policy gestita [AmazonBedrockFullAccess](https://docs.aws.amazon.com/bedrock/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonBedrockFullAccess) AWS .
1. Per consentire all’utente o al ruolo di abbonarsi ai modelli, scegli **Crea policy inline**, poi specifica le seguenti autorizzazioni nell’editor JSON:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "MarketplaceBedrock",
"Effect": "Allow",
"Action": [
"aws-marketplace:ViewSubscriptions",
"aws-marketplace:Unsubscribe",
"aws-marketplace:Subscribe"
],
"Resource": "*"
}
]
}
```
## Generare una risposta per un prompt di testo utilizzando un modello Amazon Nova
[Dopo aver soddisfatto tutti i prerequisiti, puoi provare a effettuare richieste di invocazione di modelli su modelli Amazon Nova con una richiesta Converse.](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html)
Per installare la AWS CLI, segui i passaggi in [Installa o aggiorna alla versione più recente della AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). Verifica di aver configurato le credenziali per utilizzare Boto3 seguendo la procedura indicata alla pagina [Ottenere le credenziali per concedere l’accesso programmatico](#grant-program-access).
Per generare una risposta per un prompt di testo in Nova 2 Lite utilizzando la AWS CLI, esegui il seguente comando in un terminale:
```
aws bedrock-runtime converse \
--model-id us.amazon.nova-2-lite-v1:0 \
--messages '[{"role":"user","content":[{"text":"Write a short poem"}]}]' \
--additional-model-request-fields '{"reasoningConfig":{"type":"enabled","maxReasoningEffort":"low"}}'
```