Skip to content

[Profile] az login: Add --get-subscriptions to limit the subscriptions that are retrieved#31977

Draft
jiasli wants to merge 1 commit intoAzure:devfrom
jiasli:login-subscription2
Draft

[Profile] az login: Add --get-subscriptions to limit the subscriptions that are retrieved#31977
jiasli wants to merge 1 commit intoAzure:devfrom
jiasli:login-subscription2

Conversation

@jiasli
Copy link
Member

@jiasli jiasli commented Aug 21, 2025

Related command
az login

Description
Resolve #31939
Partially resolve #14933

If --tenant and --get-subscriptions are specified, CLI calls Subscriptions - Get to retrieve information for the specified subscriptions without calling Subscriptions - List API.

Testing Guide

az login --tenant xxx --get-subscription xxx xxx

History Notes

[Component Name 1] BREAKING CHANGE: az command a: Make some customer-facing breaking change
[Component Name 2] az command b: Add some customer-facing feature


This checklist is used to make sure that common guidelines for a pull request are followed.

@azure-client-tools-bot-prd
Copy link

azure-client-tools-bot-prd bot commented Aug 21, 2025

️✔️AzureCLI-FullTest
️✔️acr
️✔️latest
️✔️3.12
️✔️3.13
️✔️acs
️✔️latest
️✔️3.12
️✔️3.13
️✔️advisor
️✔️latest
️✔️3.12
️✔️3.13
️✔️ams
️✔️latest
️✔️3.12
️✔️3.13
️✔️apim
️✔️latest
️✔️3.12
️✔️3.13
️✔️appconfig
️✔️latest
️✔️3.12
️✔️3.13
️✔️appservice
️✔️latest
️✔️3.12
️✔️3.13
️✔️aro
️✔️latest
️✔️3.12
️✔️3.13
️✔️backup
️✔️latest
️✔️3.12
️✔️3.13
️✔️batch
️✔️latest
️✔️3.12
️✔️3.13
️✔️batchai
️✔️latest
️✔️3.12
️✔️3.13
️✔️billing
️✔️latest
️✔️3.12
️✔️3.13
️✔️botservice
️✔️latest
️✔️3.12
️✔️3.13
️✔️cdn
️✔️latest
️✔️3.12
️✔️3.13
️✔️cloud
️✔️latest
️✔️3.12
️✔️3.13
️✔️cognitiveservices
️✔️latest
️✔️3.12
️✔️3.13
️✔️compute_recommender
️✔️latest
️✔️3.12
️✔️3.13
️✔️computefleet
️✔️latest
️✔️3.12
️✔️3.13
️✔️config
️✔️latest
️✔️3.12
️✔️3.13
️✔️configure
️✔️latest
️✔️3.12
️✔️3.13
️✔️consumption
️✔️latest
️✔️3.12
️✔️3.13
️✔️container
️✔️latest
️✔️3.12
️✔️3.13
️✔️containerapp
️✔️latest
️✔️3.12
️✔️3.13
️✔️core
️✔️latest
️✔️3.12
️✔️3.13
️✔️cosmosdb
️✔️latest
️✔️3.12
️✔️3.13
️✔️databoxedge
️✔️latest
️✔️3.12
️✔️3.13
️✔️dls
️✔️latest
️✔️3.12
️✔️3.13
️✔️dms
️✔️latest
️✔️3.12
️✔️3.13
️✔️eventgrid
️✔️latest
️✔️3.12
️✔️3.13
️✔️eventhubs
️✔️latest
️✔️3.12
️✔️3.13
️✔️feedback
️✔️latest
️✔️3.12
️✔️3.13
️✔️find
️✔️latest
️✔️3.12
️✔️3.13
️✔️hdinsight
️✔️latest
️✔️3.12
️✔️3.13
️✔️identity
️✔️latest
️✔️3.12
️✔️3.13
️✔️iot
️✔️latest
️✔️3.12
️✔️3.13
️✔️keyvault
️✔️latest
️✔️3.12
️✔️3.13
️✔️lab
️✔️latest
️✔️3.12
️✔️3.13
️✔️managedservices
️✔️latest
️✔️3.12
️✔️3.13
️✔️maps
️✔️latest
️✔️3.12
️✔️3.13
️✔️marketplaceordering
️✔️latest
️✔️3.12
️✔️3.13
️✔️monitor
️✔️latest
️✔️3.12
️✔️3.13
️✔️mysql
️✔️latest
️✔️3.12
️✔️3.13
️✔️netappfiles
️✔️latest
️✔️3.12
️✔️3.13
️✔️network
️✔️latest
️✔️3.12
️✔️3.13
️✔️policyinsights
️✔️latest
️✔️3.12
️✔️3.13
️✔️privatedns
️✔️latest
️✔️3.12
️✔️3.13
️✔️profile
️✔️latest
️✔️3.12
️✔️3.13
️✔️rdbms
️✔️latest
️✔️3.12
️✔️3.13
️✔️redis
️✔️latest
️✔️3.12
️✔️3.13
️✔️relay
️✔️latest
️✔️3.12
️✔️3.13
️✔️resource
️✔️latest
️✔️3.12
️✔️3.13
️✔️role
️✔️latest
️✔️3.12
️✔️3.13
️✔️search
️✔️latest
️✔️3.12
️✔️3.13
️✔️security
️✔️latest
️✔️3.12
️✔️3.13
️✔️servicebus
️✔️latest
️✔️3.12
️✔️3.13
️✔️serviceconnector
️✔️latest
️✔️3.12
️✔️3.13
️✔️servicefabric
️✔️latest
️✔️3.12
️✔️3.13
️✔️signalr
️✔️latest
️✔️3.12
️✔️3.13
️✔️sql
️✔️latest
️✔️3.12
️✔️3.13
️✔️sqlvm
️✔️latest
️✔️3.12
️✔️3.13
️✔️storage
️✔️latest
️✔️3.12
️✔️3.13
️✔️synapse
️✔️latest
️✔️3.12
️✔️3.13
️✔️telemetry
️✔️latest
️✔️3.12
️✔️3.13
️✔️util
️✔️latest
️✔️3.12
️✔️3.13
️✔️vm
️✔️latest
️✔️3.12
️✔️3.13

@azure-client-tools-bot-prd
Copy link

Hi @jiasli,
Since the current milestone time is less than 7 days, this pr will be reviewed in the next milestone.

@azure-client-tools-bot-prd
Copy link

azure-client-tools-bot-prd bot commented Aug 21, 2025

⚠️AzureCLI-BreakingChangeTest
⚠️profile
rule cmd_name rule_message suggest_message
⚠️ 1006 - ParaAdd login cmd login added parameter get_subscriptions

@yonzhan
Copy link
Collaborator

yonzhan commented Aug 21, 2025

az login enhancement

@github-actions
Copy link

The git hooks are available for azure-cli and azure-cli-extensions repos. They could help you run required checks before creating the PR.

Please sync the latest code with latest dev branch (for azure-cli) or main branch (for azure-cli-extensions).
After that please run the following commands to enable git hooks:

pip install azdev --upgrade
azdev setup -c <your azure-cli repo path> -r <your azure-cli-extensions repo path>

@jiasli
Copy link
Member Author

jiasli commented Jan 30, 2026

Requirements

  1. In subscription finding phase, limit the subscriptions to retrieve with --get-subscriptions. This converts the list subscription operation to multiple get individual subscription operations.
  2. In subscription selecting phase, select the default subscription with with --subscription. This bypasses interactive subscription selector ([Profile] az login: Add --subscription #31976).

Design choices

  1. Use different parameters for these 2 requirements. This will give the user more granular control of the behavior:
    • When --get-subscriptions is used, user can keep the interactive subscription selector
    • When --subscription is used, user can keep the subscription listing process
  2. Combine them into one --subscriptions which takes a list (nargs='+'). Use the first subscription as the default one. I personally do not prefer this choice, because:
    • If the user only wants to limit subscriptions, they lose interactive subscription selector
    • If the user only wants to select the default subscription, they lose the subscription listing ability

As a reference, Azure PowerShell cmdlet Connect-AzAccount has a -SkipContextPopulation parameter. If both -Subscription and -SkipContextPopulation are given, only the specified subscription is retrieved. However, this approach has a limitation: If the user wants to limit subscription finding to multiple, say, 3 subscriptions, and select one as the default, the user has to run Connect-AzAccount thrice:

Connect-AzAccount -Tenant TENANT_ID -Subscription SUB_1 -SkipContextPopulation
Connect-AzAccount -Tenant TENANT_ID -Subscription SUB_2 -SkipContextPopulation
# The last subscription will be the selected as the default one
Connect-AzAccount -Tenant TENANT_ID -Subscription SUB_3 -SkipContextPopulation

With the approach proposed in this PR, this task can be done with:

az login --tenant TENANT_ID --get-subscriptions SUB_1 SUB_2 SUB_3 --subscription SUB_3

Parameter naming alternatives

For limiting subscriptions, the parameter name can be

  1. --get-subscriptions
  2. --limit-subscriptions

For selecting subscriptions, the parameter name can be

  1. --subscription
  2. --select-subscription
  3. --default-subscription

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Account az login/account Auto-Assign Auto assign by bot

Projects

None yet

2 participants