ApsaraDB RDS propose une console pour les opérations visuelles et plusieurs méthodes d'appel des API, notamment OpenAPI Explorer, les SDK Alibaba Cloud et Resource Orchestration Service (ROS). Choisissez la méthode d'intégration adaptée à votre flux de travail.
Présentation d'OpenAPI Explorer
OpenAPI Explorer est un outil Alibaba Cloud qui aide les développeurs à découvrir et à utiliser les API des services Alibaba Cloud. Il regroupe en un seul endroit la recherche intelligente, la documentation, le débogage en ligne, le téléchargement des SDK, des exemples de code, le diagnostic des erreurs et les statistiques d'appels. Utilisez OpenAPI Explorer pour appeler les API et inspecter les requêtes et les réponses. L'outil génère également automatiquement des exemples de code SDK pour les opérations testées. Pour plus d'informations, consultez la rubrique Qu'est-ce qu'une API ?
Description des versions
ApsaraDB RDS utilise des numéros de version pour gérer les versions des API. La version recommandée est 2014-08-15. Notez que 2014-08-15 est un identifiant de version, et non une date.
| Version | Description |
|---|---|
| 2014-08-15 | Recommandée |
Débogage en ligne
OpenAPI Explorer prend en charge le débogage des API pour ApsaraDB RDS. Avant d'appeler les API, examinez les versions disponibles, les endpoints et les méthodes d'intégration.
Page de débogage en ligne
Accédez à OpenAPI Explorer.
Point d'entrée de débogage : Déboguer l'API
Endpoints
Utilisez l'endpoint de la région où se trouve votre instance afin de réduire la latence. Par exemple, pour une instance située dans la région Chine (Zhangjiakou), l'endpoint public est rds.cn-zhangjiakou.aliyuncs.com et l'endpoint Virtual Private Cloud (VPC) est rds-vpc.cn-zhangjiakou.aliyuncs.com.
L'endpoint public est accessible depuis le monde entier.
-
Les endpoints VPC présentent les avantages suivants par rapport aux endpoints publics :
Sécurité élevée : les endpoints VPC sont accessibles uniquement au sein d'un VPC, ce qui offre une sécurité et une confidentialité accrues.
Réponse rapide : les données transitent via le réseau VPC, ce qui réduit la latence et évite les limitations de bande passante.
Coût réduit : le trafic via les endpoints VPC utilise le réseau interne.
Pour plus d'informations, consultez la rubrique Endpoints.
Identités utilisateur prises en charge
Par défaut, OpenAPI Explorer utilise votre compte Alibaba Cloud pour le débogage en ligne. Un compte Alibaba Cloud dispose de toutes les autorisations sur l'ensemble des API, ce qui présente des risques de sécurité. Privilégiez l'utilisation d'un utilisateur RAM ou d'un rôle RAM pour appeler les API et effectuer les opérations de maintenance courantes. Avant d'utiliser un utilisateur RAM, accordez-lui les autorisations nécessaires à la gestion des ressources ApsaraDB RDS. Pour plus d'informations, consultez la rubrique Autoriser un utilisateur RAM à gérer des instances ApsaraDB RDS.
| Identité | Prise en charge |
|---|---|
| Compte Alibaba Cloud | Oui |
| Utilisateur RAM (recommandé) | Oui |
| Rôle RAM (recommandé) | Oui |
Références
Méthodes d'intégration
ApsaraDB RDS prend en charge les SDK Alibaba Cloud, Alibaba Cloud CLI, ROS, Terraform et l'encapsulation personnalisée. Sélectionnez une méthode en fonction de votre flux de travail.
| Méthode d'appel | Prise en charge |
|---|---|
| SDK Alibaba Cloud | Oui |
| Alibaba Cloud CLI | Oui |
| ROS | Oui |
| Terraform | Oui |
| Encapsulation personnalisée | Oui |
Les SDK constituent la méthode recommandée pour la plupart des cas d'utilisation, car leur intégration est simple.
SDK Alibaba Cloud
Les SDK Alibaba Cloud sont disponibles pour Java, C#, Go, Python, TypeScript, Node.js, PHP et C++. Ces SDK gèrent la signature des requêtes, les délais d'attente et les nouvelles tentatives, et renvoient des objets de réponse structurés qui simplifient le développement. Pour plus d'informations, consultez la rubrique SDK Alibaba Cloud.
Pour connaître les langages et les dépendances pris en charge pour ApsaraDB RDS, consultez OpenAPI Explorer.
Alibaba Cloud CLI
Alibaba Cloud CLI vous permet d'exécuter des commandes aliyun pour interagir avec les services Alibaba Cloud et gérer vos ressources cloud. Pour plus d'informations, consultez la rubrique Qu'est-ce qu'Alibaba Cloud CLI ?
Pour appeler les API ApsaraDB RDS à l'aide d'Alibaba Cloud CLI, consultez la rubrique Générer une commande.
ROS
Resource Orchestration Service (ROS) automatise la création et la configuration des ressources cloud. Définissez votre infrastructure, y compris les instances Elastic Compute Service (ECS) et ApsaraDB RDS, ainsi que les relations entre ces ressources, dans un modèle. ROS provisionne ensuite l'ensemble automatiquement pour mettre en œuvre le déploiement et la maintenance automatisés. Pour plus d'informations, consultez la rubrique Qu'est-ce que ROS ?
Pour connaître les ressources et types de données ApsaraDB RDS pris en charge, consultez la rubrique Ressources ApsaraDB RDS prises en charge par ROS.
Appels API encapsulés personnalisés
Pour effectuer des appels HTTP natifs, construisez manuellement les requêtes et signez-les. Pour plus de détails sur la signature, consultez les rubriques Liste des opérations par fonction et Syntaxe des requêtes et méthode de signature V3.
Remarques d'utilisation
Si une API renvoie une erreur, vérifiez le code d'erreur et validez vos paramètres d'entrée. Pour obtenir la liste des codes d'erreur, consultez la rubrique Codes d'erreur publics.
Pour réaliser un diagnostic en libre-service à l'aide d'un ID de requête ou des détails d'erreur du SDK, utilisez Alibaba Cloud OpenAPI Diagnostics.