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 |
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.