Managing multiple clouds with Azure CLI 2.0
If you have multiple subscriptions associated with Azure, you may have more than one cloud available. Each cloud has its own associated endpoints and capabilities, and is often associated with a particular region that has different data protection standards or requirements.
To effectively work with multiple clouds, you will need to be able to switch between which is currently active, and possibly create new clouds.
You may list your available clouds with the cloud list command. This will tell you which cloud is currently active, what its current profile is, and can provide information on regional suffixes and host names.
To get a list of the available clouds and the currently active one:
az cloud list --output table
IsActive Name Profile ---------- ----------------- --------- True AzureCloud latest AzureChinaCloud latest AzureUSGovernment latest AzureGermanCloud latest
Switching the active cloud
In order to switch the currently active cloud, you run the cloud set command. This command takes one required argument, the name of the cloud.
az cloud set --name AzureChinaCloud
If you have never authenticated for the active cloud, you will need to do so before performing any other CLI operations. For instructions on authenticating, see Log in with Azure CLI 2.0.
Register or unregister a cloud
Register a new cloud if you have your own endpoints or require a different profile. Creating a cloud is done with the cloud register command. This command requires a name, and optionally a set of capabilities and endpoint designations.
To create a cloud with a specialized endpoint for the resource manager, with a specific profile:
az cloud register --name MyCloud --endpoint-resource-manager "https://my.endpoint.manager" --profile 2017-03-09-profile
This creates the cloud, but does not automatically select it.
If you no longer require the created cloud, it can be unregistered with the cloud unregister command:
az cloud unregister --name MyCloud