Cloud Parallel File Storage (CPFS) prend en charge 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 à apprendre et à utiliser rapidement et efficacement les API des services cloud. Cet outil combine des fonctionnalités telles que la recherche intelligente d'API, la documentation, le débogage en ligne, l'acquisition de SDK, des exemples de code, le diagnostic d'erreurs et les statistiques d'appels. Utilisez OpenAPI Explorer pour appeler les API des services Alibaba Cloud et visualiser les requêtes et réponses d'API. OpenAPI Explorer génère également automatiquement des exemples de code SDK pour vous aider à démarrer avec les services Alibaba Cloud. Pour plus d'informations, consultez Qu'est-ce qu'OpenAPI ?.
Versions
Alibaba Cloud OpenAPI utilise des numéros de version pour gérer les publications d'API de ses 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 est 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) propose des fonctionnalités telles que le débogage d'API dans OpenAPI Explorer. Avant d'appeler une API, assurez-vous de comprendre 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 de 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, marqué d'un astérisque rouge) et ZoneId. Sélectionnez un endpoint pour une région spécifique, telle que China East 1 (Hangzhou). En bas de la page se trouve un bouton Send Request.
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 pour vous aider à choisir celle qui correspond à votre cas d'utilisation.
|
Méthode |
Fonctionnement |
Cas d'utilisation |
|
SDK (recommandé) |
Appelle l'OpenAPI via une bibliothèque cliente native au langage. Gère automatiquement l'authentification, les nouvelles tentatives et l'analyse des réponses. |
Développement d'applications ou de scripts d'automatisation en Python, Java, Go ou d'autres langages pris en charge. Idéal pour la plupart des développeurs. |
|
CLI |
Appelle l'OpenAPI via un outil en ligne de commande. Aucun codage requis. |
Exécution d'opérations ponctuelles, rédaction de scripts shell ou test interactif des appels d'API. |
|
Terraform |
Déclare les ressources CPFS sous forme d'infrastructure en tant que code. Convertit les modèles en appels OpenAPI. |
Gestion des ressources CPFS conjointement avec d'autres infrastructures cloud dans un flux de travail GitOps ou d'infrastructure en tant que code (IaC). |
|
Resource Orchestration Service (ROS) |
Utilise Alibaba Cloud ROS 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
Pour minimiser la latence, utilisez l'endpoint de 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 de n'importe où, y compris depuis l'extérieur d'Alibaba Cloud.
-
Endpoints VPC — accessibles uniquement depuis un virtual private cloud (VPC) dans la même région Alibaba Cloud. Avantages des endpoints VPC :
Sécurité accrue : les endpoints VPC ne sont accessibles que depuis un VPC, offrant une isolation et une confidentialité renforcées.
Latence réduite : les endpoints VPC utilisent des chemins réseau internes, qui offrent généralement des temps de réponse plus rapides que les endpoints publics et permettent d'éviter des problèmes tels que la latence Internet et les limitations de bande passante.
Coût réduit : les endpoints VPC utilisent la communication réseau interne.
Le tableau suivant répertorie 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 |
|
Singapour |
ap-southeast-1 |
nas.ap-southeast-1.aliyuncs.com |
nas-vpc.ap-southeast-1.aliyuncs.com |
Identités utilisateur prises en charge
|
Identité utilisateur |
Statut de prise en charge |
|
Pris en charge |
|
|
Utilisateur RAM (Recommandé) |
Pris en charge |
|
Rôle RAM (Recommandé) |
Pris en charge |
Nous vous recommandons d'utiliser un utilisateur RAM ou un rôle RAM pour effectuer des appels d'API, et d'accorder des autorisations en fonction de vos besoins métier spécifiques.
Plus d'informations
Méthodes d'intégration
Le SDK offre la configuration la plus simple et le meilleur support à long terme. Utilisez-le 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 en tant que 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++. Utilisez ces SDK pour appeler des API. Les SDK simplifient le développement en gérant la logique de signature, les délais d'attente, les nouvelles tentatives et en renvoyant 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 sur l'installation des dépendances, consultez SDK Apsara File Storage NAS.
Alibaba Cloud CLI
L'Alibaba Cloud CLI vous permet d'interagir avec les services Alibaba Cloud et de gérer vos ressources cloud depuis la ligne de commande en utilisant la commande aliyun. Pour plus d'informations sur l'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 d'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 enregistrer le RequestID ou le message d'erreur SDK renvoyé par l'appel et utiliser la Plateforme de diagnostic OpenAPI Alibaba Cloud pour un diagnostic en libre-service.