Cloud Parallel File Storage (CPFS) propose quatre méthodes pour gérer les ressources par programmation : SDK, interface de ligne de commande (CLI), Terraform et Resource Orchestration Service (ROS).
Choisir une méthode d'intégration
Alibaba Cloud met à disposition OpenAPI Explorer pour aider les développeurs à découvrir et utiliser efficacement les API des services cloud. Cet outil regroupe des fonctionnalités telles que la recherche intelligente d'API, la documentation, le débogage en ligne, l'obtention de SDK, des exemples de code, le diagnostic d'erreurs et des statistiques d'appels. Vous pouvez utiliser OpenAPI Explorer pour appeler les API des services Alibaba Cloud et consulter les requêtes et réponses associées. OpenAPI Explorer génère également automatiquement du code d'exemple SDK afin de faciliter votre prise en main des services Alibaba Cloud. Pour plus d'informations, consultez Qu'est-ce qu'OpenAPI ?.
Versions
Les OpenAPI d'Alibaba Cloud utilisent des numéros de version pour gérer les publications d'API de leurs services. Par exemple, Cloud Parallel File Storage (CPFS) prend actuellement en charge la version d'API 2017-06-26. Cet identifiant est un numéro de version, et non une date. Il représente la structure de données de l'API et n'implique pas que l'API soit restée inchangée depuis le 2017-06-26.
Cloud Parallel File Storage (CPFS) et Apsara File Storage NAS partagent le même SDK. Par conséquent, utilisez les endpoints et le SDK d'Apsara File Storage NAS lorsque vous travaillez avec CPFS.
|
Version |
Description |
|
Recommandée |
Débogage en ligne
Cloud Parallel File Storage (CPFS) offre des fonctionnalités telles que le débogage d'API dans OpenAPI Explorer. Avant d'appeler une API, familiarisez-vous avec les versions, les endpoints et les méthodes d'intégration fournis par CPFS.
Sur la page de débogage d'OpenAPI Explorer, le volet de navigation de gauche répertorie les API du système de fichiers telles que CreateFileSystem, DeleteFileSystem et DescribeFileSystems. Le volet central contient le formulaire de configuration des paramètres pour l'API CreateFileSystem. Ce formulaire comprend des champs tels que FileSystemType (valeurs valides : standard, extreme, cpfs), ChargeType (valeurs valides : PayAsYouGo, Subscription), Duration, Capacity, Bandwidth, StorageType (obligatoire, indiqué par un astérisque rouge) et ZoneId. Vous pouvez sélectionner un endpoint pour une région spécifique, par exemple China East 1 (Hangzhou). Un bouton Send Request se trouve au bas de la page.
Point d'entrée de débogage
Pour déboguer l'API, accédez à Cloud Parallel File Storage (CPFS).
Le tableau suivant compare les quatre méthodes d'intégration afin de vous aider à choisir celle qui correspond le mieux à votre cas d'utilisation.
|
Méthode |
Fonctionnement |
Cas d'utilisation |
|
SDK (recommandé) |
Appelle OpenAPI via une bibliothèque cliente native au langage. Gère automatiquement l'authentification, les nouvelles tentatives et l'analyse des réponses. |
Conception d'applications ou de scripts d'automatisation en Python, Java, Go ou dans d'autres langages pris en charge. Solution idéale pour la plupart des développeurs. |
|
CLI |
Appelle OpenAPI via un outil en ligne de commande. Aucune programmation requise. |
Exécution d'opérations ponctuelles, rédaction de scripts shell ou test interactif d'appels d'API. |
|
Terraform |
Déclare les ressources CPFS sous forme d'infrastructure as code. Convertit les modèles en appels OpenAPI. |
Gestion des ressources CPFS conjointement à d'autres infrastructures cloud dans un workflow GitOps ou infrastructure as code (IaC). |
|
Resource Orchestration Service (ROS) |
Utilise ROS d'Alibaba Cloud pour définir et déployer des piles de ressources à partir de modèles. |
Orchestration des ressources CPFS avec d'autres ressources Alibaba Cloud dans le cadre d'une pile de déploiement plus large. |
Endpoints
Afin de réduire la latence, utilisez l'endpoint correspondant à la région où se trouvent vos ressources CPFS. Par exemple, l'endpoint public pour CPFS dans la région China (Ulanqab) est nas.cn-wulanchabu.aliyuncs.com, et l'endpoint VPC est nas-vpc.cn-wulanchabu.aliyuncs.com.
Deux types d'endpoints sont disponibles :
Endpoints publics : accessibles depuis n'importe quel emplacement, y compris en dehors d'Alibaba Cloud.
-
Endpoints VPC : accessibles uniquement depuis un Virtual Private Cloud (VPC) situé dans la même région Alibaba Cloud. Avantages des endpoints VPC :
Sécurité renforcée : les endpoints VPC ne sont joignables que depuis un VPC, ce qui garantit un isolement et une confidentialité supérieurs.
Latence réduite : les endpoints VPC empruntent des chemins réseau internes, offrant généralement des temps de réponse plus rapides que les endpoints publics et permettant d'éviter les problèmes liés à la latence Internet et aux limitations de bande passante.
Coût inférieur : les endpoints VPC utilisent la communication réseau interne.
Le tableau suivant liste les régions et endpoints pris en charge pour CPFS General-purpose Edition.
|
Nom de la région |
ID de région |
Endpoint public |
Endpoint VPC |
|
China (Qingdao) |
cn-qingdao |
nas.cn-qingdao.aliyuncs.com |
nas-vpc.cn-qingdao.aliyuncs.com |
|
China (Beijing) |
cn-beijing |
nas.cn-beijing.aliyuncs.com |
nas-vpc.cn-beijing.aliyuncs.com |
|
China (Zhangjiakou) |
cn-zhangjiakou |
nas.cn-zhangjiakou.aliyuncs.com |
nas-vpc.cn-zhangjiakou.aliyuncs.com |
|
China (Hohhot) |
cn-huhehaote |
nas.cn-huhehaote.aliyuncs.com |
nas-vpc.cn-huhehaote.aliyuncs.com |
|
China (Ulanqab) |
cn-wulanchabu |
nas.cn-wulanchabu.aliyuncs.com |
nas-vpc.cn-wulanchabu.aliyuncs.com |
|
China (Hangzhou) |
cn-hangzhou |
nas.cn-hangzhou.aliyuncs.com |
nas-vpc.cn-hangzhou.aliyuncs.com |
|
China (Shanghai) |
cn-shanghai |
nas.cn-shanghai.aliyuncs.com |
nas-vpc.cn-shanghai.aliyuncs.com |
|
China (Shenzhen) |
cn-shenzhen |
nas.cn-shenzhen.aliyuncs.com |
nas-vpc.cn-shenzhen.aliyuncs.com |
|
China (Heyuan) |
cn-heyuan |
nas.cn-heyuan.aliyuncs.com |
nas-vpc.cn-heyuan.aliyuncs.com |
|
China (Chengdu) |
cn-chengdu |
nas.cn-chengdu.aliyuncs.com |
nas-vpc.cn-chengdu.aliyuncs.com |
|
Singapore |
ap-southeast-1 |
nas.ap-southeast-1.aliyuncs.com |
nas-vpc.ap-southeast-1.aliyuncs.com |
Identités utilisateur prises en charge
|
Identité utilisateur |
État de la prise en charge |
|
Pris en charge |
|
|
Utilisateur RAM (Recommandé) |
Pris en charge |
|
Rôle RAM (Recommandé) |
Pris en charge |
Nous recommandons d'utiliser un utilisateur RAM ou un rôle RAM pour effectuer les appels d'API, et d'accorder les permissions en fonction de vos besoins métier spécifiques.
Informations complémentaires
Méthodes d'intégration
Le SDK offre la configuration la plus simple et le meilleur support à long terme. Privilégiez cette solution sauf si vous avez une raison spécifique de choisir une autre méthode, comme l'écriture de scripts shell (CLI) ou la gestion de l'infrastructure as code (Terraform ou ROS).
Alibaba Cloud SDK
Alibaba Cloud fournit des SDK pour plusieurs langages de programmation, notamment Java, C#, Go, Python, Node.js/TypeScript, PHP et C++. Ces SDK permettent d'appeler les API et simplifient le développement en gérant la logique de signature, les délais d'attente, les nouvelles tentatives et en retournant des objets de réponse structurés. Pour plus d'informations sur le SDK Alibaba Cloud, consultez Alibaba Cloud SDK.
Vous pouvez utiliser le SDK Alibaba Cloud pour appeler les API Cloud Parallel File Storage (CPFS) dans OpenAPI Explorer. Pour obtenir des informations sur les langages pris en charge et l'installation des dépendances, consultez SDK Apsara File Storage NAS.
Alibaba Cloud CLI
Alibaba Cloud CLI permet d'interagir avec les services Alibaba Cloud et de gérer vos ressources cloud depuis la ligne de commande à l'aide de la commande aliyun. Pour plus d'informations sur Alibaba Cloud CLI, consultez Qu'est-ce qu'Alibaba Cloud CLI ?.
Appels d'API manuels (Non recommandé)
Pour effectuer des appels HTTP natifs, vous devez implémenter l'algorithme de signature et construire des requêtes personnalisées. Pour plus d'informations sur le mécanisme de signature, consultez Référence API et Corps de requête V3 et mécanisme de signature.
Remarques d'utilisation
Si un appel d'API renvoie une erreur, utilisez le code d'erreur retourné pour vérifier que vos paramètres et valeurs de requête sont corrects. Pour plus d'informations, consultez Centre des codes d'erreur.
Vous pouvez également noter le RequestID ou le message d'erreur SDK renvoyé par l'appel, puis utiliser la Plateforme de diagnostic OpenAPI d'Alibaba Cloud pour effectuer un diagnostic en libre-service.