Rechercher un compte de niveau gratuit Azure Cosmos DB existant à l’aide d’Azure CLI
S’APPLIQUE À : NoSQL MongoDB Cassandra Gremlin Table
Le script de cet article montre comment localiser un compte de niveau gratuit Azure Cosmos DB dans un abonnement.
Chaque abonnement Azure peut avoir jusqu’à un compte de niveau gratuit Azure Cosmos DB. Si vous essayez de créer un compte de niveau gratuit, l’option peut être désactivée dans le Portail Azure ou vous obtenez une erreur lors de la tentative de création d’un compte de niveau gratuit. Si l’un de ces problèmes se produit, utilisez ce script pour localiser le nom du compte de niveau gratuit existant et le groupe de ressources auquel il appartient.
Si vous n’avez pas d’abonnement Azure, créez un compte gratuit Azure avant de commencer.
Prérequis
Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.
Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.
Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.
Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.
Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.
- Cet article nécessite la version 2.9.1 ou ultérieure d’Azure CLI. Si vous utilisez Azure Cloud Shell, la version la plus récente est déjà installée.
Exemple de script
Lancement d’Azure Cloud Shell
Azure Cloud Shell est un interpréteur de commandes interactif et gratuit que vous pouvez utiliser pour exécuter les étapes de cet article. Il contient des outils Azure courants préinstallés et configurés pour être utilisés avec votre compte.
Pour ouvrir Cloud Shell, sélectionnez simplement Essayer en haut à droite d’un bloc de code. Vous pouvez aussi lancer Cloud Shell dans un onglet distinct du navigateur en accédant à https://shell.azure.com.
Quand Cloud Shell s’ouvre, vérifiez que Bash est sélectionné pour votre environnement. Les sessions ultérieures utiliseront Azure CLI dans un environnement Bash. Sélectionnez Copier pour copier les blocs de code, collez-les dans Cloud Shell, puis appuyez sur Entrée pour les exécuter.
Connexion à Azure
Cloud Shell est automatiquement authentifié sous le compte initial utilisé pour la connexion. Utilisez le script suivant pour vous connecter avec un autre abonnement, en remplaçant <Subscription ID>
par votre ID d’abonnement Azure. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit Azure avant de commencer.
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
Pour plus d’informations, consultez Définir l’abonnement actif ou Se connecter de manière interactive
Exécuter le script
# Azure Cosmos DB offers one free-tier account per subscription
# This script will find if you have a free-tier account and output
# the name of the Cosmos DB account and its resource group
# These can remain commented out if running in Azure Cloud Shell
#az login
#az account set -s {your subscription id}
isFound=0
# Iterate through all the resource groups in the subscription
for rg in $(az group list --query "[].name" --output tsv)
do
echo "Checking resource group: $rg"
# Return the Cosmos DB account in the resource group marked as free tier
ft=$(az cosmosdb list -g $rg --query "[?enableFreeTier].name" --output tsv)
if [ ${#ft} -gt 0 ]; then
echo "$ft is a free tier account in resource group: $rg"
isFound=1
break
fi
done
if [ $isFound -eq 0 ]; then
echo "No Free Tier accounts in subscription"
fi
Informations de référence sur l’exemple
Ce script utilise les commandes suivantes. Chaque commande du tableau renvoie à une documentation spécifique.
Commande | Notes |
---|---|
az group list | Lister tous les groupes de ressources d’un abonnement Azure. |
az cosmosdb list | Répertorie tous les comptes Azure Cosmos DB dans un groupe de ressources. |
Étapes suivantes
Pour plus d’informations sur l’interface CLI Azure Cosmos DB, consultez la documentation sur l’interface CLI Azure Cosmos DB.
Pour obtenir des exemples de l’interface Azure CLI pour des API spécifiques, consultez :