Cette rubrique explique comment utiliser le SDK Simple Log Service pour Python afin d'appeler l'opération ListProject de Simple Log Service et d'interroger un projet.
Consulter la documentation de l'API
Avant d'appeler une opération d'API, nous vous recommandons de lire la documentation pour connaître les paramètres et les autorisations requis. Pour plus d'informations, consultez la page Liste des opérations par fonction.
Créer un utilisateur RAM et lui accorder des autorisations
La paire AccessKey d'un compte Alibaba Cloud dispose d'autorisations sur toutes les opérations d'API. Nous vous recommandons de créer et d'utiliser un utilisateur Resource Access Management (RAM) pour appeler des opérations d'API ou effectuer des tâches d'exploitation et de maintenance courantes.
Si vous avez déjà créé un utilisateur RAM et lui avez accordé des autorisations, ignorez cette étape.
Connectez-vous à la console RAM.
-
Créez un utilisateur RAM.
Dans le volet de navigation de gauche, choisissez .
Sur la page Users, cliquez sur Create User.
Sur la page Create User, définissez les champs Logon Name et Display Name sur config-openapi-operator, puis sélectionnez OpenAPI Access pour le champ Access Mode.
-
Cliquez sur OK.
Après la création de l'utilisateur RAM, le système génère automatiquement un ID AccessKey et un secret AccessKey pour cet utilisateur. Pour plus d'informations, consultez la page Créer une paire AccessKey. Nous vous recommandons d'enregistrer la paire AccessKey. Vous devrez saisir ces identifiants lors de l'utilisation de l'utilisateur RAM pour appeler une opération d'API.
-
Accordez des autorisations à l'utilisateur RAM.
RemarquePar défaut, un utilisateur RAM ne dispose d'aucune autorisation. Après avoir créé un utilisateur RAM, vous devez lui attacher des politiques système, telles que AliyunLogFullAccess et AliyunLogReadOnlyAccess, ou des politiques personnalisées. Pour plus d'informations, consultez la page Présentation. Dans cet exemple, la politique AliyunLogReadOnlyAccess est attachée à l'utilisateur RAM. Cette politique accorde des autorisations en lecture seule sur les ressources Simple Log Service.
Sur la page Users, recherchez l'utilisateur RAM config-openapi-operator et cliquez sur Add Permissions dans la colonne Actions.
Dans le panneau Add Permissions, sélectionnez AliyunLogReadOnlyAccess et cliquez sur OK.
Confirmez le résultat de l'autorisation, puis cliquez sur Complete.
Appeler une opération d'API
Cet exemple utilise le SDK Simple Log Service pour Python pour appeler une opération d'API. Si vous utilisez un SDK Simple Log Service dans un autre langage de programmation, la procédure suivante s'applique également. Pour plus d'informations, consultez la page SDK Simple Log Service.
Préparer un environnement Python
Installez Python. Pour plus d'informations, visitez le site officiel de Python.
Le SDK Simple Log Service pour Python prend en charge Python 3 et versions ultérieures.
Exécutez la commande python -V pour afficher la version de Python installée.
Configurer les variables d'environnement
Pour éviter les risques de sécurité liés au codage en dur de la paire AccessKey dans votre code métier, nous vous recommandons de configurer des variables d'environnement pour gérer la paire AccessKey.
-
Système d'exploitation Linux ou macOS
Remplacez
<access_key_id>et<access_key_secret>dans les commandes suivantes par l'ID AccessKey et le secret AccessKey de l'utilisateur RAM. Ensuite, exécutez les commandes suivantes sur votre appareil :export ALIBABA_CLOUD_ACCESS_KEY_ID=<access_key_id> export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<access_key_secret> -
Système d'exploitation Windows
Créez un fichier de variables d'environnement, ajoutez les variables d'environnement
ALIBABA_CLOUD_ACCESS_KEY_IDetALIBABA_CLOUD_ACCESS_KEY_SECRET, et saisissez l'ID AccessKey et le secret AccessKey de l'utilisateur RAM. Redémarrez ensuite le système d'exploitation Windows.
Télécharger l'exemple de code
Accédez à la page ListProject.
Dans l'onglet Parameters, configurez les paramètres. Par exemple, saisissez le nom du projet dont vous souhaitez interroger les informations dans le champ projectName.
Dans l'onglet SDK Sample Code, sélectionnez Python et cliquez sur Download Project pour télécharger le package d'exemple de code.
Décompressez le package d'exemple de code sur votre ordinateur et accédez au répertoire alibabacloud_sample.
Installer les dépendances
Après avoir téléchargé l'exemple de code, ouvrez le fichier README.md pour consulter des informations telles que la version du SDK et les dépendances.
pip install alibabacloud-sls20201230
Exécuter le code
Exécutez le fichier sample.py. La réponse d'exemple suivante est renvoyée :
[LOG]
{
"headers": {
"server": "AliyunSLS",
"content-type": "application/json",
"content-length": "230",
"connection": "keep-alive",
"access-control-allow-origin": "*",
"date": "Tue, 25 Jul 2023 10:08:25 GMT",
"x-log-time": "1690279705",
"x-log-requestid": "64BF9F199ED2B749708E5445"
},
"statusCode": 200,
"body": {
"count": 1,
"projects": [
{
"createTime": "1656666120",
"description": "",
"lastModifyTime": "1665978308",
"owner": "",
"projectName": "re****-nginx",
"region": "cn-hangzhou",
"resourceGroupId": "rg-a****a",
"status": "Normal"
}
],
"total": 1
}
}