ActionTrail propose une console visuelle et prend en charge plusieurs méthodes d'appel de ses API, notamment le débogage en ligne avec OpenAPI Explorer, les SDK Alibaba Cloud, Terraform et Resource Orchestration Service (ROS). Choisissez la méthode d'intégration la plus adaptée pour améliorer votre efficacité de développement.
Terraform,
OpenAPI Explorer
OpenAPI Explorer est un outil complet d'Alibaba Cloud qui aide les développeurs à apprendre et à utiliser rapidement les API. Il intègre la recherche intelligente d'API, la documentation, le débogage en ligne, l'obtention de SDK, des exemples de code, le diagnostic des erreurs d'appel d'API et les statistiques d'appels. Utilisez OpenAPI Explorer pour appeler les API des services Alibaba Cloud et visualiser les requêtes et réponses API. OpenAPI Explorer génère également automatiquement des exemples de code SDK pour vous aider à prendre en main les produits Alibaba Cloud. Pour plus d'informations, consultez Qu'est-ce qu'OpenAPI ?.
Version
Alibaba Cloud utilise des versions pour gérer les API lors des principales mises à jour de produits. ActionTrail prend actuellement en charge la version d'API 2020-07-06. La chaîne 2020-07-06 est un identifiant de version, et non une date. Cet identifiant représente le dernier ensemble d'opérations API et n'indique pas que l'API est obsolète.
|
Version |
Description |
|
Recommandée |
Débogage en ligne
ActionTrail fournit des fonctionnalités de débogage d'API dans OpenAPI Explorer. Avant d'appeler une API, familiarisez-vous avec les versions disponibles, les endpoints et les méthodes d'intégration pour ActionTrail.
Sur la page ActionTrail dans OpenAPI Explorer, le volet de navigation de gauche répertorie les API disponibles par catégorie, telles que DescribeRegions pour les régions et CreateTrail/DeleteTrail pour les trails. Dans le panneau de débogage central, sélectionnez un endpoint, tel que China (Shanghai), configurez les paramètres de requête comme AcceptLanguage, puis cliquez sur Initiate Call pour déboguer l'API en ligne. Le volet de droite affiche la description de l'API et la documentation des paramètres.
Portail de débogage
Accédez au portail de débogage d'API à l'adresse suivante : Liste de débogage de l'API ActionTrail
Endpoints
Pour minimiser la latence, sélectionnez un endpoint situé dans la même région que vos ressources. Par exemple, dans la région China (Zhangjiakou), l'endpoint public pour ActionTrail est actiontrail.cn-zhangjiakou.aliyuncs.com, et l'endpoint VPC est actiontrail-vpc.cn-zhangjiakou.aliyuncs.com.
Les endpoints publics sont accessibles globalement.
-
Les endpoints VPC sont accessibles uniquement depuis un VPC dans une région Alibaba Cloud spécifique. Avantages :
Sécurité élevée : les endpoints VPC sont accessibles uniquement depuis un VPC.
Réponse plus rapide : comme le trafic via un endpoint VPC utilise le réseau interne, les temps de réponse sont généralement plus rapides et évitent les problèmes tels que la latence du réseau public et les limites de bande passante.
Coûts réduits : les endpoints VPC utilisent la communication par réseau interne.
Pour plus d'informations, consultez Endpoints.
Identités
Un compte Alibaba Cloud dispose d'un accès complet aux API, ce qui pose un risque de sécurité. Pour une sécurité renforcée, nous recommandons d'utiliser un utilisateur RAM pour les appels d'API et les opérations quotidiennes d'O&M. Avant d'appeler une API, accordez des autorisations à l'utilisateur RAM en fonction de vos besoins métier. L'utilisateur RAM doit disposer des autorisations nécessaires pour gérer les ressources ActionTrail. Pour plus d'informations, consultez Utiliser RAM pour le contrôle d'accès.
|
Identity |
Supported |
|
Oui |
|
|
Utilisateur RAM (recommandé) |
Oui |
|
Rôle RAM (recommandé) |
Oui |
Informations complémentaires
Méthodes d'intégration
Le SDK Alibaba Cloud est la méthode recommandée pour appeler les API, car il s'agit de la méthode la plus simple et la mieux prise en charge.
Méthodes d'intégration
|
Method |
Supported |
|
SDK Alibaba Cloud (recommandé) |
Oui |
|
Oui |
|
|
Oui |
|
|
Oui |
-
SDK Alibaba Cloud
Alibaba Cloud propose des SDK pour plusieurs langages de programmation, notamment Java, C#, Go, Python, Node.js/TypeScript, PHP et C++. Intégrez un SDK dans votre application pour appeler directement les API. Les SDK encapsulent la logique de signature, le mécanisme de délai d'expiration et le mécanisme de nouvelle tentative, et renvoient des objets de réponse structurés. Pour plus d'informations sur les SDK Alibaba Cloud, consultez SDK Alibaba Cloud.
Utilisez un SDK Alibaba Cloud pour appeler les opérations d'API ActionTrail dans OpenAPI Explorer. Pour obtenir des informations sur les langages pris en charge et sur l'installation des dépendances, consultez SDK ActionTrail.
-
CLI Alibaba Cloud
Alibaba Cloud Command Line Interface (CLI) est un outil de ligne de commande polyvalent basé sur les API. Utilisez Alibaba Cloud CLI pour interagir avec les services Alibaba Cloud et gérer vos ressources Alibaba Cloud dans un shell. Pour plus d'informations sur Alibaba Cloud CLI, consultez Qu'est-ce qu'Alibaba Cloud CLI ?.
Utilisez Alibaba Cloud CLI pour appeler les opérations d'API ActionTrail .
-
Resource Orchestration Service (ROS)
Resource Orchestration Service (ROS) est un service Alibaba Cloud qui simplifie la gestion des ressources cloud. Les développeurs et les administrateurs peuvent écrire des modèles pour définir les ressources Alibaba Cloud requises, telles que les instances Elastic Compute Service (ECS) et les instances ApsaraDB RDS, ainsi que les dépendances entre ces ressources. Le moteur d'orchestration ROS crée et configure automatiquement toutes les ressources en fonction des modèles pour mettre en œuvre le déploiement automatisé et les opérations d'O&M. Pour plus d'informations, consultez Qu'est-ce que Resource Orchestration Service ?.
Utilisez ROS pour appeler les opérations d'API ActionTrail. Pour plus d'informations, consultez Exemple d'intégration ROS.
-
Requêtes HTTP directes
Si vous effectuez des requêtes HTTP directes, vous devez implémenter l'algorithme de signature et construire la requête HTTP vous-même. Pour plus d'informations sur le mécanisme de signature, consultez Vue d'ensemble des API et Corps de requête V3 et mécanisme de signature.
Notes
Si un appel d'API échoue, utilisez le code d'erreur renvoyé pour vérifier vos paramètres de requête et leurs valeurs.
Vous pouvez également diagnostiquer les erreurs en utilisant le RequestID de la réponse ou les informations d'erreur du SDK sur la page Dépannage OpenAPI.
FAQ
ActionTrail vous aide à surveiller et à enregistrer les activités de votre compte Alibaba Cloud. Il prend en charge l'analyse comportementale, l'analyse de sécurité, le suivi des modifications de ressources et l'audit de conformité. Pour plus d'informations, consultez Qu'est-ce qu'ActionTrail ?.
En plus du SDK Java, ActionTrail prend également en charge les SDK pour d'autres langages de programmation tels que C#, Go, Python, Node.js/TypeScript, PHP et C++. Pour plus d'informations, consultez Référence SDK.