Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Démarrez avec l'API
Avant de commencer APIs, suivez ces procédures si vous utilisez la AWS CLI AWS ou un AWS SDK pour la première fois ou si vous devez les installer. Si aucune de ces conditions ne s'applique à vous, passez à[Obtention des informations d’identification pour accorder un accès programmatique](#grant-program-access).
## Je suis nouveau AWS
Si vous n'avez pas de AWS compte, suivez les étapes ci-dessous pour en créer un. Vous pouvez également commencer à créer gratuitement avec Amazon Nova sur [nova.amazon.com/dev](https://nova.amazon.com/dev).
**Pour créer un AWS compte**
1. Ouvrez l'[https://portal.aws.amazon.com/billing/inscription.](https://portal.aws.amazon.com/billing/signup)
1. Suivez les instructions en ligne.
Dans le cadre de la procédure d’inscription, vous recevrez un appel téléphonique ou un SMS et vous saisirez un code de vérification en utilisant le clavier numérique du téléphone.
Lorsque vous créez un AWS compte, un *AWS utilisateur root* est créé. L'utilisateur root a accès à tous les services et ressources AWS du compte. Pour des raisons de sécurité, attribuez un accès administratif à un utilisateur et utilisez uniquement l'utilisateur root pour effectuer [les tâches nécessitant un accès utilisateur root](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
AWS vous envoie un e-mail de confirmation une fois le processus d'inscription terminé. À tout moment, vous pouvez consulter l'activité actuelle de votre compte et gérer votre compte en accédant à [https://aws.amazon.com/](https://aws.amazon.com/)et en choisissant **Mon compte**.
**Sécurisez votre AWS compte (utilisateur root)**
1. Connectez-vous en [AWS Management Console](https://console.aws.amazon.com/)tant que propriétaire du compte en choisissant **Utilisateur root** et en saisissant l'adresse e-mail de votre AWS compte. Sur la page suivante, saisissez votre mot de passe.
Pour obtenir de l'aide pour vous connecter en utilisant l'utilisateur root, consultez [la section Connexion en tant qu'utilisateur root](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) dans le *Guide de l'utilisateur de AWS connexion*.
1. Activez l’authentification multifactorielle (MFA) pour votre utilisateur racine.
Pour obtenir des instructions, consultez la section [Activer un périphérique MFA virtuel pour l'utilisateur root de votre AWS compte (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) dans le guide de l'utilisateur *IAM*.
## J'ai besoin d'installer la AWS CLI ou un AWS SDK
Pour installer la AWS CLI, suivez les étapes décrites dans la [section Installer ou mettre à jour vers la dernière version de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
Pour installer un AWS SDK, sélectionnez l'onglet correspondant au langage de programmation que vous souhaitez utiliser dans [Tools to Build on AWS](https://aws.amazon.com/developer/tools/).
AWS des kits de développement logiciel (SDKs) sont disponibles pour de nombreux langages de programmation courants. Chaque SDK fournit une API, des exemples de code et de la documentation qui permettent aux développeurs de créer plus facilement des applications dans leur langue préférée. SDKs effectuer automatiquement des tâches utiles pour vous, telles que :
+ Signature cryptographique des requêtes de service
+ Nouvelle tentative de demandes
+ Gestion des réponses d’erreur
## Obtention des informations d’identification pour accorder un accès programmatique
Les utilisateurs ont besoin d'un accès programmatique s'ils souhaitent interagir AWS en dehors de la console de AWS gestion. La manière d'accorder un accès programmatique dépend du type d'utilisateur qui y accède AWS.
Pour accorder aux utilisateurs un accès programmatique, choisissez l’une des options suivantes.
| Quel principal a besoin d’un accès programmatique ? | À | En |
| --- | --- | --- |
| Utilisateurs IAM | Limitez la durée des informations d'identification à long terme pour signer les demandes programmatiques adressées à la AWS CLI AWS SDKs, ou AWS APIs. | Suivez les instructions de l’interface que vous souhaitez utiliser. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/nova/latest/nova2-userguide/getting-started-api.html) |
| Rôles IAM | Utilisez des informations d'identification temporaires pour signer les demandes programmatiques adressées à la AWS CLI AWS SDKs, ou AWS APIs. | Suivez les instructions de la section [Utilisation d'informations d'identification temporaires avec AWS des ressources](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) dans le Guide de l'utilisateur IAM. |
| Utilisateurs gérés dans IAM Identity Center | Utilisez des informations d'identification temporaires pour signer les demandes programmatiques adressées à la AWS CLI AWS SDKs, ou AWS APIs. | Suivez les instructions de l’interface que vous souhaitez utiliser. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/nova/latest/nova2-userguide/getting-started-api.html) |
## Attribution des autorisations Amazon Bedrock à un utilisateur ou à un rôle
Après avoir configuré les informations d'identification pour l'accès par programmation, vous devez configurer les autorisations pour qu'un utilisateur ou un rôle IAM ait accès aux actions liées à Amazon Bedrock. Pour configurer ces autorisations, procédez comme suit :
1. Sur la page d'accueil de la console de AWS gestion, sélectionnez le service IAM ou accédez à la console IAM à l'adresse. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)
1. Sélectionnez **Utilisateurs** ou **Rôles**, puis votre utilisateur ou votre rôle.
1. Dans l'onglet **Autorisations**, choisissez **Ajouter des autorisations**, puis sélectionnez **Ajouter une politique AWS gérée**. Choisissez la stratégie gérée par [AmazonBedrockFullAccess](https://docs.aws.amazon.com/bedrock/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonBedrockFullAccess) AWS .
1. Pour autoriser l’utilisateur ou le rôle à s’abonner à des modèles, choisissez **Créer une politique en ligne**, puis spécifiez les autorisations suivantes dans l’éditeur JSON :
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "MarketplaceBedrock",
"Effect": "Allow",
"Action": [
"aws-marketplace:ViewSubscriptions",
"aws-marketplace:Unsubscribe",
"aws-marketplace:Subscribe"
],
"Resource": "*"
}
]
}
```
## Générer une réponse à une invite de texte à l’aide d’un modèle Amazon Nova
Une fois que vous avez rempli toutes les conditions requises, vous pouvez tester l'envoi de demandes d'invocation de modèles aux modèles Amazon Nova à l'aide d'une demande [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html).
Pour installer la AWS CLI, suivez les étapes décrites dans la [section Installer ou mettre à jour vers la dernière version de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). Vérifiez que vous avez configuré vos informations d’identification pour utiliser Boto3 en suivant les étapes décrites dans [Obtention des informations d’identification pour accorder un accès programmatique](#grant-program-access).
Pour générer une réponse à une invite de texte dans Nova 2 Lite à l'aide de la AWS CLI, exécutez la commande suivante dans un terminal :
```
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"}}'
```