Gestion de cloud Azure CLI avec Azure CLI

Si vous travaillez sur différentes régions ou utilisez Azure Stack, vous devrez peut-être utiliser plusieurs clouds. Microsoft fournit des clouds conformes aux lois régionales, qui sont à votre disposition. Cet article vous explique comment obtenir des informations sur les clouds, modifier le cloud actuel, et inscrire ou désinscrire de nouveaux clouds.

Répertorier les clouds disponibles

Vous pouvez lister les clouds disponibles avec la commande az cloud list. Cette commande indique quel cloud est actuellement actif, quel est son profil actuel, et elle fournit des informations concernant les noms d’hôte et les suffixes régionaux.

Pour obtenir le cloud actif et une liste de tous les clouds disponibles :

az cloud list --output table

IsActive    Name               Profile
----------  -----------------  ---------
True        AzureCloud         latest
            AzureChinaCloud    latest
            AzureUSGovernment  latest
            AzureGermanCloud   latest

Le cloud actuellement actif a True dans la colonne IsActive. Un seul cloud peut être actif à tout moment. Pour obtenir des informations plus détaillées sur un cloud, y compris sur les points de terminaison qu’il utilise pour les services Azure, utilisez la commande cloud show :

az cloud show --name AzureChinaCloud --output json

{
  "endpoints": {
    "activeDirectory": "https://login.chinacloudapi.cn",
    "activeDirectoryDataLakeResourceId": null,
    "activeDirectoryGraphResourceId": "https://graph.chinacloudapi.cn/",
    "activeDirectoryResourceId": "https://management.core.chinacloudapi.cn/",
    "batchResourceId": "https://batch.chinacloudapi.cn/",
    "gallery": "https://gallery.chinacloudapi.cn/",
    "management": "https://management.core.chinacloudapi.cn/",
    "resourceManager": "https://management.chinacloudapi.cn",
    "sqlManagement": "https://management.core.chinacloudapi.cn:8443/",
    "vmImageAliasDoc": "https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/arm-compute/quickstart-templates/aliases.json"
  },
  "isActive": false,
  "name": "AzureChinaCloud",
  "profile": "latest",
  "suffixes": {
    "azureDatalakeAnalyticsCatalogAndJobEndpoint": null,
    "azureDatalakeStoreFileSystemEndpoint": null,
    "keyvaultDns": ".vault.azure.cn",
    "sqlServerHostname": ".database.chinacloudapi.cn",
    "storageEndpoint": "core.chinacloudapi.cn"
  }
}

Changer de cloud actif

Pour définir le cloud par défaut à l’aide d’un fichier de configuration, consultez Valeurs de configuration de l’interface CLI et variables d’environnement. Pour changer le cloud actif, exécutez la commande az cloud set. Cette commande accepte un argument obligatoire, qui est le nom du cloud.

az cloud set --name AzureChinaCloud

Important

Si l’authentification pour le cloud activé a expiré, vous devez vous authentifier de nouveau avant d’effectuer d’autres tâches CLI. S’il s’agit de la première fois que vous changez vers le nouveau cloud, vous devez également configurer l’abonnement actif. Pour obtenir des instructions sur l’authentification, consultez Se connecter avec Azure CLI. Pour plus d’informations sur la gestion des abonnements, consultez Gestion des abonnements Azure avec Azure CLI

Inscrire un nouveau cloud

Inscrivez un nouveau cloud si vous disposez de vos propres points de terminaison pour Azure Stack. La création d’un cloud s’effectue avec la commande az cloud register. Cette commande nécessite un nom et un ensemble de points de terminaison de service. Pour savoir comment inscrire un cloud pour utilisation avec Azure Stack, consultez Utiliser des profils de version d’API avec Azure CLI dans Azure Stack.

Vous n’avez pas besoin d’enregistrer d’informations pour les régions suivantes : Chine, Administration américaine ou Allemagne. Ces clouds sont gérés par Microsoft et disponibles par défaut. Pour plus d’informations sur tous les paramètres de point de terminaison disponibles, consultez la documentation pour az cloud register.

L’inscription d’un cloud n’active pas automatiquement ce dernier. Utilisez la commande az cloud set pour sélectionner le cloud récemment créé.

Mettre à jour un cloud existant

Si vous disposez des autorisations, vous pouvez également mettre à jour un cloud existant. La mise à jour d’un cloud bascule vers un profil de services Azure différent, ou modifie les points de terminaison de connexion. Mettez à jour un cloud avec la commande az cloud update, qui accepte les mêmes arguments que az cloud register.

Désinscrire un cloud

Si vous n’avez plus besoin du cloud créé, il peut être désinscrit avec la commande az cloud unregister :

az cloud unregister --name MyCloud