Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La CLI de Azure le ayuda a administrar la suscripción de Azure, crear grupos de administración y bloquear suscripciones. Es posible que tenga varias suscripciones en Azure. Puede formar parte de más de una organización o su organización podría dividir el acceso a determinados recursos entre agrupaciones. La CLI de Azure admite la selección de una suscripción tanto global como por comando.
Para obtener información detallada sobre las suscripciones, facturación y administración de costos, consulte la documentación sobre administración de costos y facturación.
Terminología
Un inquilino es una instancia de Microsoft Entra ID en la que reside información sobre una sola organización. Una organización multiinquilino es una organización que tiene más de una instancia de Microsoft Entra ID. Un inquilino tiene una o varias suscripciones y usuarios.
Los usuarios son las cuentas que inician sesión en Azure para crear, administrar y usar recursos. Un usuario puede tener acceso a varios inquilinos de y suscripciones de .
Suscripciones son los contratos con Microsoft para usar servicios en la nube, incluido Azure. Cada recurso está asociado a una suscripción. Las suscripciones contienen grupos de recursos.
Un grupo de recursos de Azure es un contenedor que contiene recursos relacionados para una solución de Azure. Para obtener información sobre cómo administrar grupos de recursos dentro de la suscripción, consulte Administración de grupos de recursos de Azure con la CLI de Azure
Obtener inquilino activo
Utiliza az account tenant list o az account show para obtener el identificador de entidad activa.
az account tenant list
az account show
Cambio del inquilino activo
Para cambiar de inquilino, tiene dos opciones.
Inicie sesión como usuario dentro del inquilino deseado. Utilice az login para cambiar el cliente activo y actualizar la lista de suscripciones a la que perteneces.
# sign in as a different user az login --user <myAlias@myCompany.com> --password <myPassword> # sign in with a different tenant az login --tenant <myTenantID>Si su organización requiere autenticación multifactor, puede recibir este error al usar
az login --user:Due to a configuration change made by your administrator, or because you moved to a new location, you must use multi-factor authentication to access...Al usar el comando alternativo
az login --tenant, se te pedirá abrir una página HTTPS y escribir el código proporcionado. Después, puede usar la autenticación multifactor e iniciar sesión correctamente. Para más información sobre las opciones de inicio de sesión con la CLI de Azure, consulte inicio de sesión con la CLI de Azure.
Obtención de información de suscripción
La mayoría de los comandos de la CLI de Azure actúan dentro de una suscripción. Puede especificar en qué suscripción trabajar mediante el parámetro --subscription en el comando . Si no especifica una suscripción, el comando usa la suscripción activa actual.
Para ver la suscripción que usa actualmente o para obtener una lista de suscripciones disponibles, ejecute el comando az account show o az account list. Vaya a Aprenda a usar Bash con la CLI de Azure para ver más ejemplos de formas de usar estos comandos.
Estos son ejemplos que muestran cómo obtener información de suscripción:
# get the current default subscription using show
az account show --output table
# get the current default subscription using list
az account list --query "[?isDefault]"
# get a subscription that contains search words or phrases
az account list --query "[?contains(name,'search phrase')].{SubscriptionName:name, SubscriptionID:id, TenantID:tenantId}" --output table
También puede almacenar información de suscripción en una variable para usarla en un script.
# store the default subscription in a variable
subscriptionId="$(az account list --query "[?isDefault].id" --output tsv)"
echo $subscriptionId
# store a subscription of certain name in a variable
subscriptionId="$(az account list --query "[?name=='my case sensitive subscription full name'].id" --output tsv)"
echo $subscriptionId
Sugerencia
El parámetro --output es un parámetro global que está disponible para todos los comandos. El valor table presenta la salida en un formato amigable. Para más información, consulte Formatos de salida de los comandos de la CLI de Azure.
Cambiar la suscripción activa
Las suscripciones a Azure tienen un nombre y un identificador. Puede utilizar el comando az account set para cambiar a otra suscripción especificando el ID o el nombre de la suscripción deseada.
# change the active subscription using the subscription name
az account set --subscription "My Demos"
# change the active subscription using the subscription ID
az account set --subscription "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
También puede cambiar la suscripción mediante una variable. Este es un ejemplo:
# change the active subscription using a variable
subscriptionId="$(az account list --query "[?name=='my case sensitive subscription full name'].id" --output tsv)"
az account set --subscription $subscriptionId
Si cambia a una suscripción que se encuentra en otro inquilino, también cambiará el inquilino activo. Para obtener información sobre cómo agregar una nueva suscripción a su inquilino de Microsoft Entra, consulte Asociación o incorporación de una suscripción de Azure a su inquilino de Microsoft Entra.
Si ha recibido un error de "La suscripción de ... no existe...", consulte Resolución de problemas para posibles soluciones.
Borrar la caché de suscripciones
Para actualizar la lista de suscripciones, use el comando az account clear . Tendrá que volver a iniciar sesión para ver una lista actualizada.
az account clear
az login
Borrar la memoria caché de suscripciones no es técnicamente el mismo proceso que el desconectarse de Azure. Sin embargo, al borrar la caché de suscripciones, no puede ejecutar comandos de la CLI de Azure, incluidos az account set, hasta que vuelva a iniciar sesión.
Creación de grupos de administración de Azure
Los grupos de administración de Azure contienen suscripciones. Los grupos de administración proporcionan una manera de administrar el acceso, las directivas y el cumplimiento de esas suscripciones. Para más información, consulte ¿Qué son los grupos de administración de Azure?
Use los comandos az account management-group para crear y administrar grupos de administración de Azure.
Puedes crear un grupo de gestión para varias de tus suscripciones utilizando el comando az account management-group create.
az account management-group create --name Contoso01
Para ver todos tus grupos de administración, use el comando az account management-group list:
az account management-group list
Agregue suscripciones a su nuevo grupo mediante el comando az account management-group subscription add:
az account management-group subscription add --name Contoso01 --subscription "My Demos"
az account management-group subscription add --name Contoso01 --subscription "My Second Demos"
Para quitar una suscripción, use el comando az account management-group subscription remove:
az account management-group subscription remove --name Contoso01 --subscription "My Demos"
Para quitar un grupo de administración, ejecute el comando az account management-group delete:
az account management-group delete --name Contoso01
Quitar una suscripción o eliminar un grupo de administración no elimina ni desactiva una suscripción.
Establecimiento de un bloqueo de suscripción de Azure
Como administrador, es posible que tenga que bloquear una suscripción para evitar que los usuarios la eliminen o modifiquen. Para obtener más información, consulte Bloquear recursos para evitar cambios inesperados.
En la CLI de Azure, use los comandos az account lock. Por ejemplo, el comando az account lock create puede impedir que los usuarios eliminen una suscripción:
az account lock create --name "Cannot delete subscription" --lock-type CanNotDelete
Nota:
Debe tener permisos contributor en una suscripción para crear o cambiar bloqueos.
Para ver los bloqueos actuales en tu suscripción, utiliza el comando az account lock list:
az account lock list --output table
Si crea una cuenta de solo lectura, el resultado se parece a la asignación de permisos del rol Lector a todos los usuarios. Para más información sobre cómo establecer permisos para usuarios y roles individuales, consulte Incorporación o eliminación de asignaciones de roles de Azure mediante la CLI de Azure.
Para obtener detalles de un bloqueo, utilice el comando az account lock show:
az account lock show --name "Cannot delete subscription"
Puede quitar un bloqueo mediante el comando az account lock delete:
az account lock delete --name "Cannot delete subscription"
Solución de problemas
La suscripción no existe
Además de un error tipográfico, puede recibir este error cuando hay un problema de tiempo de permisos. Por ejemplo, si se le han concedido permisos a una nueva suscripción mientras la ventana de terminal actual está abierta, puede producirse este error. La solución consiste en cerrar y volver a abrir la ventana del terminal o usar az logout después az login para actualizar la lista de suscripciones disponibles.
Este es un script para ayudarle a encontrar y cambiar una suscripción.
# See what subscription you are currently using.
az account show
# Get a list of available subscriptions.
az account list --output table
# If the subscription you are seeking is not in the list
# close and reopen your terminal window,
# or logout and then sign in again.
az logout
az login
# You can also clear your cache to refresh the
# available subscription list
az account clear
az login
# Did your available subscription list change?
az account list --output table
# If the subscription you are seeking is still not in the list,
# contact your system administrator. You cannot change your
# subscription to an ID that is not in the list.
# If the subscription you are seeking is now in the list,
# change your subscription.
az account set --subscription 00000000-0000-0000-0000-00000000000
Consulte también
Colaborar con nosotros en GitHub
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
