Búsqueda de una cuenta de nivel Gratis de Azure Cosmos DB existente en una suscripción mediante la CLI de Azure
SE APLICA A: 
NoSQL MongoDB Cassandra Gremlin Table
El script de este artículo muestra cómo buscar una cuenta de nivel Gratis de Azure Cosmos DB en una suscripción.
Cada suscripción de Azure puede tener hasta una cuenta de nivel Gratis de Azure Cosmos DB. Si está intentando crear una cuenta de nivel Gratis, es posible que la opción esté deshabilitada en Azure Portal o se produce un error al intentar crear una cuenta de nivel Gratis. Si se produce alguno de estos problemas, use este script para buscar el nombre de la cuenta de nivel Gratis existente y el grupo de recursos al que pertenece.
Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.
Requisitos previos
Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Inicio rápido para Bash en Azure Cloud Shell.
Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.
Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.
En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.
Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.
- En este artículo se necesita la versión 2.9.1 de la CLI de Azure o cualquier versión posterior. Si usa Azure Cloud Shell, ya está instalada la versión más reciente.
Script de ejemplo
Inicio de Azure Cloud Shell
Azure Cloud Shell es un shell interactivo gratuito que puede usar para ejecutar los pasos de este artículo. Tiene las herramientas comunes de Azure preinstaladas y configuradas para usarlas en la cuenta.
Para abrir Cloud Shell, seleccione Pruébelo en la esquina superior derecha de un bloque de código. También puede ir a https://shell.azure.com para iniciar Cloud Shell en una pestaña independiente del explorador.
Cuando se abra Cloud Shell, compruebe que Bash está seleccionado para el entorno. En las sesiones siguientes se usará la CLI de Azure en un entorno de Bash, seleccione Copiar para copiar los bloques de código, péguelos en Cloud Shell y, luego, presione Entrar para ejecutarlos.
Inicio de sesión en Azure
Cloud Shell se autentica de forma automática en la cuenta inicial con la que ha iniciado sesión. Use el script siguiente para iniciar sesión con otra suscripción, y reemplace <Subscription ID> con el id. de la suscripción de Azure. Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
Para más información, vea Establecimiento de la suscripción activa o Inicio de sesión de forma interactiva
Ejecute el 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
Referencia de ejemplo
Este script usa los siguientes comandos. Cada comando de la tabla crea un vínculo a documentación específica del comando.
| Get-Help | Notas |
|---|---|
| az group list | Enumera todos los grupos de recursos de una suscripción de Azure. |
| az cosmosdb list | Enumera todas las cuentas de Azure Cosmos DB de un grupo de recursos. |
Pasos siguientes
Para más información, consulte la documentación de la CLI de Azure Cosmos DB.
Si desea ver ejemplos de la CLI de Azure para API específicas, consulte: