Gérer Alibaba Cloud CDN avec la CLI - CDN - Centre de documentation Alibaba Cloud

La CLI Alibaba Cloud est un outil de ligne de commande unifié basé sur OpenAPI Explorer qui automatise la gestion et la maintenance d'Alibaba Cloud CDN. Cette rubrique explique comment installer, configurer et utiliser la CLI Alibaba Cloud pour appeler les opérations API d'Alibaba Cloud CDN.

Prérequis

Avant de commencer, 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

Installez la CLI Alibaba Cloud adaptée à votre système d'exploitation avant de commencer.

Windows : Installer la CLI sous Windows.
Linux : Installer ou mettre à jour la CLI.
macOS : Installer la CLI sous macOS.

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

Configurer la CLI Alibaba Cloud

Important

Un compte Alibaba Cloud (compte racine) dispose d'un accès administratif complet à vos services et ressources, ce qui présente un risque de sécurité important. Nous vous recommandons vivement de créer et d'utiliser un utilisateur RAM pour l'accès API ou les opérations quotidiennes.

Configurez vos identifiants et un ID de région avant d'utiliser la CLI Alibaba Cloud. La CLI Alibaba Cloud prend en charge divers types d'identifiants. Pour plus d'informations, consultez la rubrique Configurer et gérer les identifiants. Cette rubrique utilise les identifiants AccessKey (AK) à titre d'exemple.

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
Cet exemple nécessite d'attacher la stratégie AliyunCDNReadOnlyAccess à l'utilisateur RAM. Vous pouvez également attacher la stratégie AliyunCDNFullAccess, qui accorde un contrôle total pour interroger et modifier les noms de domaine Alibaba Cloud CDN, ou créer une stratégie personnalisée. Pour plus d'informations, consultez la rubrique Référence des stratégies personnalisées CDN.
Une fois l'utilisateur RAM créé et autorisé, créez une paire de clés AccessKey. Notez l'AccessKey ID et l'AccessKey Secret. Pour plus d'informations, consultez la rubrique Créer une clé AccessKey.
Obtenez et notez un ID de région disponible. La CLI Alibaba Cloud envoie les requêtes API vers la région que vous spécifiez. Pour obtenir la liste des régions disponibles, consultez la rubrique Structure de la requête.

Remarque
Utilisez l'option --region pour spécifier une région pour une commande. Cette option remplace la région par défaut configurée dans vos identifiants et variables d'environnement. Pour plus d'informations, consultez la rubrique Options de ligne de commande.
Utilisez la paire de clés AccessKey de l'utilisateur RAM pour configurer les identifiants. Nommez le profil de configuration AkProfile. Pour plus d'informations, consultez la rubrique Endpoints.

Générer un exemple de commande CLI

Accédez à la page Débogage de l'API Alibaba Cloud CDN.
Dans la zone de recherche de gauche, recherchez l'API que vous souhaitez utiliser. Dans l'onglet Parameters, configurez les paramètres selon la documentation de l'API. Cliquez sur l'onglet CLI Example pour générer un exemple de commande avec vos paramètres configurés.
- Cliquez sur l'icône pour ouvrir Cloud Shell et déboguer la commande.
- Cliquez sur l'icône pour copier l'exemple CLI. Collez-le ensuite dans votre shell local pour exécuter la commande.
  - Lorsque vous collez l'exemple dans votre shell local, vérifiez le format des paramètres. Pour plus d'informations, consultez la rubrique Comprendre les paramètres de commande.
  - Par défaut, OpenAPI Explorer ajoute l'option --region à l'exemple généré. Cette option remplace la région par défaut dans la configuration de vos identifiants et les variables d'environnement. Supprimez-la ou conservez-la selon vos besoins.

Appeler une opération API

Structure de la commande

Les commandes de la CLI Alibaba Cloud suivent cette structure. Pour plus d'informations, consultez la rubrique Générer et appeler une commande.

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

Options de ligne de commande courantes

Utilisez les options de ligne de commande pour modifier le comportement par défaut d'une commande. Les options courantes incluent :

--profile <profileName> : Spécifie un profil d'identifiants à utiliser à la place de celui par défaut. Lorsqu'elle est définie, la CLI Alibaba Cloud ignore la configuration d'identifiants par défaut et les variables d'environnement.
--help : Affiche les informations d'aide pour une 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.

Exemple

L'exemple suivant appelle l'opération DescribeUserDomains pour interroger tous les noms de domaine et leurs statuts sous votre compte. Pour plus d'informations, consultez la rubrique DescribeUserDomains.

Exécutez la commande.

aliyun cdn DescribeUserDomains --DomainName mxxxio.top

La commande renvoie la sortie suivante.

{
  "Domains": {
    "PageData": [
      {
        "CdnType": "web",
        "Cname": "mxxx.xxxp.w.kunlunq.com",
        "Coverage": "domestic",
        "Description": "",
        "DomainId": 201xxx553,
        "DomainName": "mjlxxxao.top",
        "DomainStatus": "online",
        "GlobalResourcePlan": "off",
        "GmtCreated": "2024-08-27T06:29:36Z",
        "GmtModified": "2024-08-27T06:34:04Z",
        "ResourceGroupId": "rg-acfmwpdflelaoai",
        "Sandbox": "",
        "Sources": {
          "Source": [
            {
              "Content": "183.xxx.xxx.88.cn-hangzhou.sae.aliyuncs.com",
              "Port": 80,
              "Priority": "20",
              "Type": "domain",
              "Weight": "10"
            }
          ]
        }
      }
    ]
  },
  "PageNumber": 1,
  "PageSize": 20,
  "RequestId": "E4EBD2BF-5EB0-4044-9B97-xxxxxx",
  "TotalCount": 1
}
            }
          ]
        },
        "SslProtocol": "off"
      }
    ]
  },
  "PageNumber": 1,
  "PageSize": 20,
  "RequestId": "34C9E61F-02A0-5EB5-BBCB-16B531ABB9E0",
  "TotalCount": 1
}

Remarque

Si un appel API Alibaba Cloud CDN renvoie une erreur, vérifiez le code d'erreur pour vous assurer que vos paramètres de requête et leurs valeurs sont corrects.

Vous pouvez également utiliser le RequestId ou le message d'erreur SDK de la réponse avec Alibaba Cloud OpenAPI Diagnostics pour résoudre le problème.