Boto3

Boto3 est un SDK pour Python 3 qui est compatible avec les API AWS-compliant d’OUTSCALE.

Ce guide technique explique comment démarrer avec Boto3.

Installer Boto3

Avant de commencer : Assurez-vous que Python 3.8 ou ultérieur et pip sont installés sur votre machine.

Lancez la commande suivante dans votre terminal :

pip install boto3

Boto3 est maintenant installé.

Configurer Boto3

Vous pouvez définir vos identifiants Boto3 à l’aide d’une des méthodes suivantes :

Le endpoint ne peut être configuré que lors de l’instanciation de l’objet boto3.client().

Configurer les variables d’environnement

Les variables d’export sont :

  • AWS_ACCESS_KEY_ID

  • AWS_SECRET_ACCESS_KEY

Définissez-les avec les valeurs adéquates.

Configurer les fichiers de configuration

Vous pouvez modifier les fichiers suivants :

  • ~/.aws/credentials

  • ~/.aws/config

  • /etc/boto.cfg

  • ~/.boto

Pour configurer l’un de ces fichiers, utilisez les éléments suivants :

[<PROFILE_NAME>]
aws_access_key_id=<ACCESS_KEY_ID>
aws_secret_access_key=<SECRET_KEY_ID>

Configurer un connecteur à l’aide d’un client de bas niveau

Vous pouvez définir aws_access_key_id et aws_secret_access_key comme paramètres de l’objet boto3.client(), ou utiliser les méthodes précédentes. Cependant, les paramètres region_name et endpoint_url doivent être configurés comme suit :

import boto3

connection = boto3.client(
    "<SERVICE_NAME>",
    aws_access_key_id="<ACCESS_KEY_ID>",
    aws_secret_access_key="<SECRET_ACCESS_KEY>",
    region_name="eu-west-2",
    endpoint_url="https://fcu.eu-west-2.outscale.com",
)

Initialiser Boto3

Vous trouverez ci-dessous un exemple utilisant Boto3 pour se connecter au service OUTSCALE similaire à EC2 appelé FCU. Pour en savoir plus sur nos services et nos API, voir À propos des API.

import boto3

connection = boto3.client(
    "ec2",
    aws_access_key_id="<ACCESS_KEY_ID>",
    aws_secret_access_key="<SECRET_ACCESS_KEY>",
    region_name="eu-west-2",
    endpoint_url="https://fcu.eu-west-2.outscale.com",
)

connection.describe_instances()

Le premier paramètre de l’objet boto3.client() est le nom du service. Le SDK Boto3 est conçu pour fonctionner avec les API Amazon, qui ont des équivalents dans le Cloud OUTSCALE (par exemple, l’API EC2 d’Amazon est équivalente à l’API FCU d’OUTSCALE). Vous devez configurer le nom du service avec le nom Amazon.

Le tableau suivant présente l’équivalent Amazon pour chaque nom de service 3DS OUTSCALE :

Nom du service 3DS OUTSCALE Nom du service Amazon

fcu

ec2

lbu

elb

eim

iam

directlink

directconnect

oos

s3

Pour en savoir plus sur les API fournies par OUTSCALE, voir Référence des endpoints d’API.

Pages connexes

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.