Tous les produits
Search
Centre de documentation

ENS:Gérer les ressources ENS avec la CLI

Dernière mise à jour :Aug 10, 2026

La CLI Alibaba Cloud est un outil en ligne de commande polyvalent basé sur OpenAPI Explorer. Elle vous permet d'automatiser la gestion et la maintenance des ressources ENS, notamment en appelant les opérations d'API ENS.

Prérequis

Familiarisez-vous avec la CLI Alibaba Cloud. Pour plus d'informations, consultez la rubrique Présentation de la CLI Alibaba Cloud.

Installer la CLI Alibaba Cloud

La CLI Alibaba Cloud est disponible pour Windows, Linux et macOS. Sélectionnez le package d'installation correspondant à votre système d'exploitation :

  • Système d'exploitation Windows : Windows.

  • Système d'exploitation Linux : Linux.

  • Système d'exploitation macOS : macOS.

Vous pouvez également utiliser Cloud Shell pour déboguer les commandes de la CLI Alibaba Cloud. Pour plus d'informations, consultez la rubrique Présentation de Cloud Shell.

Configurer la CLI Alibaba Cloud

Important

Un compte Alibaba Cloud dispose des autorisations nécessaires pour gérer et accéder aux API de tous les services Alibaba Cloud. L'utilisation d'un compte Alibaba Cloud pour appeler des opérations d'API peut engendrer des risques de sécurité. Nous vous recommandons de créer et d'utiliser un utilisateur RAM (Resource Access Management) pour appeler des opérations d'API ou effectuer des opérations courantes d'O&M.

Avant d'utiliser la CLI Alibaba Cloud, configurez vos identifiants et l'ID de votre région. La CLI Alibaba Cloud prend en charge divers types d'identifiants. Pour plus d'informations, consultez la rubrique Types d'identifiants. Cet exemple utilise des identifiants AccessKey.

  1. Créez un utilisateur RAM et accordez-lui les autorisations requises. Pour plus d'informations, consultez les rubriques Créer un utilisateur RAM et Accorder des autorisations à un utilisateur RAM.

    Important

    Pour cet exemple, vous devez attribuer la stratégie AliyunENSFullAccess à l'utilisateur RAM. Cette stratégie accorde un contrôle total pour interroger et modifier les instances ENS. Vous pouvez également attribuer la stratégie AliyunENSReadOnlyAccess ou une stratégie personnalisée selon vos besoins. Pour plus d'informations, consultez la rubrique Référence des stratégies personnalisées pour ENS.

  2. Après avoir créé et autorisé l'utilisateur RAM, créez une paire de clés AccessKey pour celui-ci. Notez l'AccessKey ID et l'AccessKey Secret pour la configuration des identifiants. Pour plus d'informations, consultez la rubrique Créer une paire de clés AccessKey.

  3. Obtenez et notez l'ID d'une région disponible. La CLI Alibaba Cloud utilise l'ID de région spécifié pour initier les appels d'API. Pour plus d'informations sur les régions disponibles, consultez la rubrique Endpoints.

    Remarque

    Lorsque vous utilisez la CLI Alibaba Cloud, vous pouvez utiliser l'option --region pour spécifier une région pour une seule commande. Cette option remplace le paramètre de région défini dans votre configuration d'identifiants par défaut et les variables d'environnement. Pour plus d'informations, consultez la rubrique Options de commande.

  4. Utilisez la paire de clés AccessKey de l'utilisateur RAM pour configurer les identifiants basés sur AccessKey. Nommez le profil de configuration AkProfile. Pour plus d'informations, consultez la rubrique Configurer et gérer les identifiants.

Générer une commande CLI

  1. Connectez-vous à la page de débogage d'API pour ENS.

  2. Sur la page de débogage d'API, utilisez la zone de recherche de gauche pour trouver l'API que vous souhaitez utiliser. Dans la section Parameter Configuration, renseignez les paramètres requis. Cliquez ensuite sur l'onglet CLI Example situé à côté de la section Parameter Configuration pour générer un exemple de commande.

    • Cliquez sur l'icône image. Vous êtes redirigé vers Cloud Shell. Vous pouvez déboguer la commande dans Cloud Shell.

    • Cliquez sur l'icône image pour copier la commande CLI dans le presse-papiers et collez-la dans votre shell local.

      • Lorsque vous collez l'exemple de commande dans votre shell pour le débogage, prêtez attention aux formats des paramètres. Pour plus d'informations sur les formats de paramètres de la CLI Alibaba Cloud, consultez la rubrique Formats de paramètres.

      • L'exemple généré par OpenAPI Explorer inclut par défaut l'option --region . Lorsque vous exécutez la commande localement, la CLI Alibaba Cloud privilégie cette option, en ignorant les paramètres de région définis dans votre configuration d'identifiants par défaut et les variables d'environnement. Vous pouvez supprimer ou conserver cette option selon vos besoins.

Appeler une opération d'API

Syntaxe

La CLI Alibaba Cloud utilise la syntaxe de commande suivante. Pour plus d'informations, consultez la rubrique Syntaxe.

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

Options de commande

Spécifiez des options de commande pour modifier le comportement de la commande ou activer des fonctionnalités étendues. Les options courantes incluent :

  • --profile <profileName> : Lorsque vous utilisez l'option --profile et spécifiez un nom de configuration valide profileName, la CLI Alibaba Cloud ignore la configuration d'identifiants par défaut et les variables d'environnement, et privilégie la configuration spécifiée pour invoquer la commande.

  • --help : À n'importe quel niveau de commande, utilisez l'option --help pour obtenir de l'aide sur cette commande. Pour plus d'informations, consultez la rubrique Obtenir des informations d'aide.

Pour plus d'informations, consultez la rubrique Options de ligne de commande pour les appels d'API.

Exemple d'appel

L'exemple suivant appelle la commande RebootInstance dans ENS pour redémarrer une instance. Pour plus d'informations sur la commande RebootInstance, consultez la rubrique RebootInstance.

  1. Exécutez la commande suivante :

    aliyun ens RebootInstance --InstanceId i-5xxx8d3x --endpoint ens.aliyuncs.com
  2. Consultez la sortie de la commande.

    {
        "Code": "0",
        "RequestId": "845748BB-9E66-52DB-B4F5-4305601AD2CF"
    }
Remarque

Si une erreur est renvoyée après l'appel d'une opération d'API ENS, vérifiez si les paramètres et les valeurs saisis sont valides en fonction du code d'erreur.

Vous pouvez également enregistrer l'ID de requête à partir de la réponse ou du message d'erreur du SDK et utiliser Alibaba Cloud OpenAPI Diagnostics pour diagnostiquer le problème.