Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

az cloud

Manage registered Azure clouds.

Commands

Name Description Type Status
az cloud list

List registered clouds.

 Core GA
az cloud list-profiles

List the supported profiles for a cloud.

 Core GA
az cloud register

Register a cloud.

 Core GA
az cloud set

Set the active cloud.

 Core GA
az cloud show

Get the details of a registered cloud.

 Core GA
az cloud unregister

Unregister a cloud.

 Core GA
az cloud update

Update the configuration of a cloud.

 Core GA

az cloud list

List registered clouds.

az cloud list

az cloud list-profiles

List the supported profiles for a cloud.

az cloud list-profiles [--acquire-policy-token]
 [--change-reference]
 [--name]
 [--show-all]

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--name -n

Name of a registered cloud.

Property Value
Default value: AzureCloud
--show-all

Show all available profiles supported in the CLI.

Property Value
Default value: False

az cloud register

Register a cloud.

When registering a cloud, specify only the resource manager endpoint for the autodetection of other endpoints.

az cloud register --name
 [--acquire-policy-token]
 [--change-reference]
 [--cloud-config]
 [--endpoint-active-directory]
 [--endpoint-active-directory-data-lake-resource-id]
 [--endpoint-active-directory-graph-resource-id]
 [--endpoint-active-directory-resource-id]
 [--endpoint-gallery]
 [--endpoint-management]
 [--endpoint-microsoft-graph-resource-id]
 [--endpoint-resource-manager]
 [--endpoint-sql-management]
 [--endpoint-vm-image-alias-doc]
 [--profile {latest}]
 [--skip-endpoint-discovery]
 [--suffix-acr-login-server-endpoint]
 [--suffix-azure-datalake-analytics-catalog-and-job-endpoint]
 [--suffix-azure-datalake-store-file-system-endpoint]
 [--suffix-keyvault-dns]
 [--suffix-sql-server-hostname]
 [--suffix-storage-endpoint]

Examples

Register a cloud with a config file

az cloud register -n MyCloud --cloud-config @"cloud.json"
("cloud.json" supports all the endpoint and suffix options in camel case or the JSON output format from `az cloud show`. See the example content below.)
{
 "endpointActiveDirectory": "https://login.microsoftonline.us",
 "suffixAcrLoginServerEndpoint": ".azurecr.us"
}
or
{
 "endpoints":{
 "activeDirectory": "https://login.microsoftonline.us"
 },
 "suffixes":{
 "acrLoginServerEndpoint": ".azurecr.us"
 }
}

Required Parameters

--name -n

Name of a registered cloud.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--cloud-config

JSON encoded cloud configuration. Use @{file} to load from a file.

--endpoint-active-directory

The Active Directory login endpoint.

--endpoint-active-directory-data-lake-resource-id

The Active Directory resource ID for data lake services.

--endpoint-active-directory-graph-resource-id

The Active Directory resource ID.

--endpoint-active-directory-resource-id

The resource ID to obtain AD tokens for.

--endpoint-gallery

The template gallery endpoint.

--endpoint-management

The management service endpoint.

--endpoint-microsoft-graph-resource-id

The Microsoft Graph resource ID.

--endpoint-resource-manager

The resource management endpoint.

--endpoint-sql-management

The sql server management endpoint.

--endpoint-vm-image-alias-doc

The uri of the document which caches commonly used virtual machine images.

--profile

Profile to use for this cloud. The azure stack profiles 2017-03-09-profile 2018-03-01-hybrid 2019-03-01-hybrid and 2020-09-01-hybrid have been deprecated and removed. To continue using Azure Stack, please install the Azure CLI 2.66.* (LTS) version. For more details, refer to: https://learn.microsoft.com/en-us/cli/azure/whats-new-overview#important-notice-for-azure-stack-hub-customers.

Property Value
Accepted values: latest
--skip-endpoint-discovery

If specified, the cloud endpoints' auto discovery will be skipped.

Property Value
Default value: False
--suffix-acr-login-server-endpoint

The Azure Container Registry login server suffix.

--suffix-azure-datalake-analytics-catalog-and-job-endpoint

The Data Lake analytics job and catalog service dns suffix.

--suffix-azure-datalake-store-file-system-endpoint

The Data Lake store filesystem service dns suffix.

--suffix-keyvault-dns

The Key Vault service dns suffix.

--suffix-sql-server-hostname

The dns suffix for sql servers.

--suffix-storage-endpoint

The endpoint suffix for storage accounts.

az cloud set

Set the active cloud.

az cloud set --name
 [--acquire-policy-token]
 [--change-reference]
 [--profile {latest}]

Examples

Set the active cloud. (autogenerated)

az cloud set --name MyRegisteredCloud

Required Parameters

--name -n

Name of a registered cloud.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--profile

Profile to use for this cloud. The azure stack profiles 2017-03-09-profile 2018-03-01-hybrid 2019-03-01-hybrid and 2020-09-01-hybrid have been deprecated and removed. To continue using Azure Stack, please install the Azure CLI 2.66.* (LTS) version. For more details, refer to: https://learn.microsoft.com/en-us/cli/azure/whats-new-overview#important-notice-for-azure-stack-hub-customers.

Property Value
Accepted values: latest

az cloud show

Get the details of a registered cloud.

az cloud show [--name]

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--name -n

Name of a registered cloud.

Property Value
Default value: AzureCloud

az cloud unregister

Unregister a cloud.

az cloud unregister --name
 [--acquire-policy-token]
 [--change-reference]

Examples

Unregister a cloud. (autogenerated)

az cloud unregister --name MyRegisteredCloud

Required Parameters

--name -n

Name of a registered cloud.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments

az cloud update

Update the configuration of a cloud.

az cloud update [--acquire-policy-token]
 [--change-reference]
 [--cloud-config]
 [--endpoint-active-directory]
 [--endpoint-active-directory-data-lake-resource-id]
 [--endpoint-active-directory-graph-resource-id]
 [--endpoint-active-directory-resource-id]
 [--endpoint-gallery]
 [--endpoint-management]
 [--endpoint-microsoft-graph-resource-id]
 [--endpoint-resource-manager]
 [--endpoint-sql-management]
 [--endpoint-vm-image-alias-doc]
 [--name]
 [--profile {latest}]
 [--skip-endpoint-discovery]
 [--suffix-acr-login-server-endpoint]
 [--suffix-azure-datalake-analytics-catalog-and-job-endpoint]
 [--suffix-azure-datalake-store-file-system-endpoint]
 [--suffix-keyvault-dns]
 [--suffix-sql-server-hostname]
 [--suffix-storage-endpoint]

Examples

Update the configuration of a cloud. (autogenerated)

az cloud update --profile latest

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--cloud-config

JSON encoded cloud configuration. Use @{file} to load from a file.

--endpoint-active-directory

The Active Directory login endpoint.

--endpoint-active-directory-data-lake-resource-id

The Active Directory resource ID for data lake services.

--endpoint-active-directory-graph-resource-id

The Active Directory resource ID.

--endpoint-active-directory-resource-id

The resource ID to obtain AD tokens for.

--endpoint-gallery

The template gallery endpoint.

--endpoint-management

The management service endpoint.

--endpoint-microsoft-graph-resource-id

The Microsoft Graph resource ID.

--endpoint-resource-manager

The resource management endpoint.

--endpoint-sql-management

The sql server management endpoint.

--endpoint-vm-image-alias-doc

The uri of the document which caches commonly used virtual machine images.

--name -n

Name of a registered cloud.

Property Value
Default value: AzureCloud
--profile

Profile to use for this cloud. The azure stack profiles 2017-03-09-profile 2018-03-01-hybrid 2019-03-01-hybrid and 2020-09-01-hybrid have been deprecated and removed. To continue using Azure Stack, please install the Azure CLI 2.66.* (LTS) version. For more details, refer to: https://learn.microsoft.com/en-us/cli/azure/whats-new-overview#important-notice-for-azure-stack-hub-customers.

Property Value
Accepted values: latest
--skip-endpoint-discovery

If specified, the cloud endpoints' auto discovery will be skipped.

Property Value
Default value: False
--suffix-acr-login-server-endpoint

The Azure Container Registry login server suffix.

--suffix-azure-datalake-analytics-catalog-and-job-endpoint

The Data Lake analytics job and catalog service dns suffix.

--suffix-azure-datalake-store-file-system-endpoint

The Data Lake store filesystem service dns suffix.

--suffix-keyvault-dns

The Key Vault service dns suffix.

--suffix-sql-server-hostname

The dns suffix for sql servers.

--suffix-storage-endpoint

The endpoint suffix for storage accounts.

Feedback

Was this page helpful?