Tous les produits
Search
Centre de documentation

File Storage NAS:Exemple d'intégration de la CLI

Dernière mise à jour :Aug 28, 2026

Alibaba Cloud Command Line Interface (CLI) est un outil en ligne de commande polyvalent développé à partir des API. Vous pouvez utiliser Alibaba Cloud CLI pour interagir avec File Storage NAS (NAS) et gérer vos ressources NAS via un outil shell. Cette rubrique explique comment utiliser Alibaba Cloud CLI pour appeler les opérations API de NAS.

Contexte

Pour plus d'informations sur Alibaba Cloud CLI, consultez la rubrique Présentation d'Alibaba Cloud CLI

Installer Alibaba Cloud CLI

Vous devez installer Alibaba Cloud CLI avant de pouvoir l'utiliser. L'installation est possible sur les systèmes d'exploitation Windows, Linux et macOS. Choisissez le package d'installation adapté au système d'exploitation de votre appareil. Pour plus de détails, reportez-vous aux rubriques suivantes :

Vous pouvez également utiliser Cloud Shell fourni par Alibaba Cloud pour déboguer les commandes que vous souhaitez exécuter dans Alibaba Cloud CLI. Pour en savoir plus sur Cloud Shell, consultez la rubrique Qu'est-ce que Cloud Shell ?

Configurer Alibaba Cloud CLI

Important

Un compte Alibaba Cloud dispose des autorisations nécessaires pour appeler toutes les opérations API. L'utilisation d'un compte Alibaba Cloud pour effectuer des opérations présente un risque élevé. Nous vous recommandons d'appeler les opérations API ou d'effectuer les tâches courantes d'exploitation et de maintenance en tant qu'utilisateur Resource Access Management (RAM). Vous devez attacher la politique AliyunNASFullAccess à l'utilisateur RAM.

Avant d'utiliser Alibaba Cloud CLI, vous devez configurer les informations d'identification, telles que les identifiants d'identité et l'ID de région, dans Alibaba Cloud CLI. Alibaba Cloud CLI prend en charge divers types d'identifiants d'identité. Pour plus de détails, consultez la rubrique Configurer et gérer les identifiants. Dans cet exemple, nous utilisons des identifiants AccessKey. Procédez comme suit :

  1. Créez un utilisateur RAM et accordez-lui les autorisations de gestion des services Alibaba Cloud selon vos besoins métier. Pour plus d'informations, consultez les rubriques Créer un utilisateur RAM et Gérer les autorisations des utilisateurs RAM.

  2. Une fois l'utilisateur RAM créé et autorisé, créez une paire de clés AccessKey pour cet utilisateur et notez l'AccessKey ID ainsi que l'AccessKey Secret pour la configuration ultérieure des identifiants. Pour plus de détails, consultez la rubrique Créer une clé AccessKey.

  3. Spécifiez un ID de région. Alibaba Cloud CLI appelle les opérations API dans la région spécifiée. Pour connaître la liste des régions disponibles, consultez la rubrique Endpoints.

  4. Utilisez la paire de clés AccessKey de l'utilisateur RAM pour configurer les identifiants d'identité dans le fichier de configuration nommé AkProfile. Pour plus de détails, consultez la rubrique Configurer et gérer les identifiants.

Générer une commande CLI

  1. Connectez-vous au Portail OpenAPI.

  2. Sur la page de débogage de l'API, recherchez l'API souhaitée dans la zone de recherche à gauche. Dans la section Parameter Configuration, saisissez les paramètres conformément à la documentation de l'API, puis cliquez sur l'onglet CLI Example situé à droite de Parameter Configuration pour générer un exemple de commande incluant ces paramètres.

    • Cliquez sur Run Command pour ouvrir Cloud Shell et déboguer rapidement la commande.

    • Cliquez sur Copy pour copier l'exemple de commande dans le presse-papiers. Vous pouvez ensuite le coller dans votre outil shell local pour l'exécuter.

      • Lorsque vous copiez et collez la commande CLI dans le shell local, veillez à respecter les formats de paramètres. Pour plus d'informations sur les formats de paramètres d'Alibaba Cloud CLI, consultez la rubrique Comprendre les paramètres de commande.

      • Par défaut, l'option --region est ajoutée à la commande exemple générée dans OpenAPI Explorer. Lorsque vous copiez la commande dans votre outil shell, Alibaba Cloud CLI ignore les informations de région présentes dans les configurations d'identifiants par défaut et les variables d'environnement, et exécute la commande en priorité dans la région spécifiée. Vous pouvez supprimer ou conserver cette option selon vos besoins métier.

Utiliser Alibaba Cloud CLI pour appeler les opérations API de NAS

Syntaxe

Dans Alibaba Cloud CLI, vous pouvez utiliser la syntaxe suivante pour exécuter des commandes. Pour plus de détails, consultez la rubrique Générer et exécuter des commandes CLI avec OpenAPI Explorer.

aliyun <command> <subcommand> [options and parameters]

Options de commande

Lorsque vous utilisez Alibaba Cloud CLI, vous pouvez spécifier des options de commande pour modifier le comportement des commandes ou activer des fonctionnalités étendues. Les options de commande suivantes sont fréquemment utilisées :

  • --profile<profileName> : Après avoir utilisé l'option --profile et son paramètre profileName pour spécifier un profil de configuration, Alibaba Cloud CLI ignore les identifiants d'identité par défaut et les configurations de variables d'environnement, et utilise les configurations que vous avez spécifiées pour exécuter les commandes.

  • --help : Vous pouvez spécifier l'option --help pour obtenir des informations d'aide sur une commande. Pour plus de détails, consultez la rubrique Utiliser la commande d'aide.

Exemples

Remarque

Dans les exemples suivants, les commandes sont exécutées dans l'invite de commandes de Windows. Les formats de paramètres des commandes varient selon les autres systèmes d'exploitation. Pour plus d'informations sur les formats de paramètres d'Alibaba Cloud CLI, consultez la rubrique Comprendre les paramètres de commande.

  • Exemple 1 : Utilisez Alibaba Cloud CLI pour appeler l'opération CreateFileSystem de NAS afin de créer un système de fichiers Network File System (NFS) General-purpose Capacity facturé au paiement à l'utilisation.

    1. Exécutez la commande suivante :

      aliyun nas CreateFileSystem --FileSystemType standard --ChargeType PayAsYouGo --StorageType Capacity --ProtocolType NFS
    2. Consultez la sortie de la commande.

      {
              "FileSystemId": "6a2464****",
              "RequestId": "3879AB9C-1DED-5A49-A015-350138B23BF0"
      }
  • Exemple 2 : Utilisez Alibaba Cloud CLI pour appeler l'opération CreateAccessGroup de NAS afin de créer un groupe d'autorisations nommé vpc_test.

    1. Exécutez la commande suivante :

      aliyun nas CreateAccessGroup --AccessGroupName vpc_test --AccessGroupType Vpc
    2. Consultez la sortie de la commande.

      {
              "AccessGroupName": "vpc_test",
              "RequestId": "95CB3005-C251-5E11-A949-29CB2C7A9C54"
      }
Remarque

Si une erreur est renvoyée après l'appel d'une opération API de NAS, vous devez vérifier la validité des paramètres de requête et de leurs valeurs en fonction du code d'erreur renvoyé.

Vous pouvez également utiliser l'ID de requête ou le message d'erreur SDK issu de la réponse avec la pour diagnostiquer le problème.