ENS prend en charge plusieurs méthodes d'intégration, notamment les SDK, la CLI, Terraform et ROS. Utilisez ces méthodes pour automatiser la gestion des ressources ENS et améliorer l'efficacité du développement.
Vue d'ensemble d'OpenAPI Explorer
OpenAPI Explorer est un portail tout-en-un dédié aux opérations API Alibaba Cloud. Il propose une recherche intelligente, une documentation, un débogage en ligne, le téléchargement de SDK, des exemples de code, un diagnostic des erreurs et des statistiques d'appels. Depuis ce portail, appelez des opérations API, visualisez les requêtes et les réponses, et générez directement des exemples de code SDK.
Pour plus d'informations, consultez la section Vue d'ensemble.
Description de la version
|
Version de l'API |
Description |
|
Nous vous recommandons d'utiliser cette version. |
Débogage en ligne
ENS permet le débogage des API via OpenAPI Explorer. Avant d'appeler des opérations API, examinez les informations spécifiques à ENS suivantes : versions, endpoints, styles d'API et méthodes d'appel.
Sur la page ENS d'OpenAPI Explorer, le volet de navigation de gauche répertorie les catégories de service, telles que les instances, les disques, les snapshots, les images, les groupes de sécurité et les réseaux. Dans le volet central, configurez les paramètres de l'API, sélectionnez une adresse de service (par exemple China (Hangzhou)) et saisissez les paramètres de requête. Le volet de droite affiche la documentation de l'API, y compris les limites de débit, les paramètres de requête et les paramètres de réponse, dans les onglets Documentation, Debugging Result, SDK Sample et CLI Sample.
Débogage
Accédez au portail de débogage des API ENS.
Endpoints
Utilisez l'endpoint de la région Singapour ens.ap-southeast-1.aliyuncs.com.
Pour plus d'informations, consultez la section Endpoints.
Identités
Par défaut, OpenAPI Explorer utilise votre compte Alibaba Cloud pour le débogage en ligne. Étant donné qu'un compte Alibaba Cloud dispose de toutes les autorisations API, son utilisation directe peut présenter des risques de sécurité. Nous vous recommandons d'utiliser plutôt un utilisateur Resource Access Management (RAM). Avant d'appeler des opérations API en tant qu'utilisateur RAM, accordez les autorisations requises en fonction de vos besoins métier. L'utilisateur RAM doit disposer des autorisations nécessaires pour gérer les ressources ENS. Pour plus d'informations, consultez la section Stratégies système pour ENS.
|**Identité**
|
**Prise en charge**
| | --- | --- | |
[Compte Alibaba Cloud](t2522466.xdita#3948d68066ppy)
|
Oui
| |
[Utilisateur RAM](t2522466.xdita#265242420egiy) (recommandé)
|
Oui
| |
[Rôle RAM](t2522466.xdita#5b7a31e066wma) (recommandé)
|
Oui
|
Accordez uniquement les autorisations minimales requises à un utilisateur RAM ou à un rôle RAM, puis utilisez cette identité pour appeler les opérations API.
Références
Méthodes d'intégration
Méthodes d'appel
|**Méthode d'appel**
|
**Prise en charge**
| | --- | --- | |
[SDK Alibaba Cloud](#507f3ec1c5tva) (recommandé)
|
Oui
| |
[CLI Alibaba Cloud](#4bbd1ba8f7xzv)
|
Oui
| |
[Terraform](#ca9fbc29081q7)
|
Oui
| |
[ROS](#0748151d51vk8)
|
Oui
| |
[Encapsulation d'API personnalisée](#b49f657224aig)
|
Oui
|
SDK Alibaba Cloud
Les SDK Alibaba Cloud sont disponibles en Java, C#, Go, Python, TypeScript, Node.js, PHP et C++. Ces SDK encapsulent la logique de signature, la gestion des délais d'expiration et les mécanismes de nouvelle tentative, et renvoient des objets de réponse structurés. Pour plus d'informations, consultez la section SDK Alibaba Cloud.
Utilisez les SDK Alibaba Cloud pour appeler les API ENS. Pour connaître les langages pris en charge et les instructions d'installation, consultez le centre des SDK ENS.
CLI Alibaba Cloud
La CLI Alibaba Cloud vous permet d'appeler les opérations API ENS. Pour plus d'informations, consultez la section Exemples de commandes.
Exécutez les commandes
aliyunpour interagir avec les services Alibaba Cloud et gérer les ressources de cloud computing. Pour plus d'informations, consultez la section Qu'est-ce que la CLI Alibaba Cloud ?
Terraform
Terraform est un outil open source permettant de prévisualiser, configurer et gérer l'infrastructure et les ressources cloud. À l'instar du service Resource Orchestration Service (ROS), Terraform interprète les modèles et appelle les opérations API correspondantes. Pour plus d'informations, consultez la section Qu'est-ce que Terraform ?
Pour savoir comment orchestrer les ressources ENS avec Terraform, consultez la section Intégration des ressources à l'aide de Terraform.
-
Ressources prises en charge
Terraform permet de gérer les ressources ENS, y compris les ressources standard et les sources de données. Pour plus d'informations sur Terraform, consultez la section Qu'est-ce que Terraform ?
Type de ressource
Nom de la ressource
Description
Ressources
Fournit des disques.ENS
Fournit des pièces jointes d'instance de disque.ENS
Fournit des adresses IP élastiques (EIP).ENS
Fournit des ressources d'image.ENS
Fournit des instances.ENS
Fournit des pièces jointes de groupe de sécurité d'instance.ENS
Fournit des paires de clés.ENS
Fournit des équilibreurs de charge.ENS
Fournit des réseaux.ENS
Fournit des groupes de sécurité.ENS
Fournit des snapshots.ENS
Fournit des vSwitches.ENS
Sources de données
Fournit les paires de clés de l'utilisateur Alibaba Cloud actuel.ENS
ROS
Le service Resource Orchestration Service (ROS) simplifie la gestion des ressources cloud. Créez des modèles décrivant les ressources requises, telles que les instances Elastic Compute Service (ECS) et ApsaraDB RDS, ainsi que leurs dépendances. ROS crée et configure ensuite automatiquement toutes les ressources pour un déploiement et une exploitation/maintenance automatisés. Pour plus d'informations, consultez la section Qu'est-ce que ROS ?.
-
Utilisez ROS pour appeler les opérations API de ENS. Les ressources orchestrables par ROS incluent les ressources standard et les sources de données.
-
Ressources standard :
ALIYUN::ENS::Disk : crée un disque de données en paiement à l'utilisation ou par abonnement.
ALIYUN::ENS::DiskInstanceAttachment : attache un disque de données à une instance ENS.
ALIYUN::ENS::Instance : crée une instance ENS.
ALIYUN::ENS::InstanceSecurityGroupAttachment : ajoute une instance ENS à un groupe de sécurité.
ALIYUN::ENS::KeyPair : importe la clé publique d'une paire de clés chiffrée RSA (Rivest-Shamir-Adleman).
ALIYUN::ENS::Network : crée un VPC (Virtual Private Cloud).
ALIYUN::ENS::NetworkAcl : crée une liste de contrôle d'accès réseau (ACL).
ALIYUN::ENS::NetworkAclAssociation : associe une ACL à des réseaux.
ALIYUN::ENS::SecurityGroup : crée un groupe de sécurité.
ALIYUN::ENS::Snapshot : crée un snapshot.
ALIYUN::ENS::vSwitch : crée un vSwitch.
-
Sources de données :
DATASOURCE::ENS::Instances : interroge les détails des instances ENS.
-
Pour savoir comment orchestrer les ressources ENS avec ROS, consultez la section Intégration des ressources à l'aide de ROS.
Encapsulation d'API personnalisée
Pour effectuer des appels HTTP natifs, construisez et signez vous-même les requêtes. Pour plus d'informations, consultez les sections Liste des opérations par fonction et Syntaxe de requête et méthode de signature V3.
Remarques sur l'utilisation
En cas d'échec d'un appel API, vérifiez le code d'erreur renvoyé par rapport à vos paramètres de requête. Pour plus d'informations, consultez le Centre des codes d'erreur.
Utilisez également l'identifiant RequestID renvoyé ou le message d'erreur du SDK avec la plateforme de diagnostic des API OpenAPI Alibaba Cloud pour effectuer un autodiagnostic.