使用 Azure CLI 选择云

如果跨不同的区域工作或使用 Azure Stack,可能需要使用多个云。 Microsoft 提供符合区域法规和客户用途的云。 本文介绍如何获取有关云的信息、更改当前云,以及注册或取消注册新云。

可用云的列表

可以使用 az cloud list 命令列出可用的云。 此命令显示当前处于活动状态的云和当前的配置文件,以及有关区域后缀和主机名的信息。

获取活动的云以及所有可用云的列表:

az cloud list --output table
Name               Profile    IsActive  
-----------------  ---------  ----------
AzureCloud         latest     
AzureChinaCloud    latest     True
AzureUSGovernment  latest
AzureGermanCloud   latest

IsActive 列中,当前处于活动状态的云的值为 True。 在任何时候,只能有一个云处于活动状态。 若要获取有关某个云的更多详细信息,包括它对 Azure 服务使用的终结点,请使用 cloud show 命令:

az cloud show --name AzureChinaCloud --output json
{
  "endpoints": {
    "activeDirectory": "https://login.chinacloudapi.cn",
    "activeDirectoryDataLakeResourceId": null,
    "activeDirectoryGraphResourceId": "https://graph.chinacloudapi.cn/",
    "activeDirectoryResourceId": "https://management.core.chinacloudapi.cn/",
    "batchResourceId": "https://batch.chinacloudapi.cn/",
    "gallery": "https://gallery.chinacloudapi.cn/",
    "management": "https://management.core.chinacloudapi.cn/",
    "resourceManager": "https://management.chinacloudapi.cn",
    "sqlManagement": "https://management.core.chinacloudapi.cn:8443/",
    "vmImageAliasDoc": "https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/arm-compute/quickstart-templates/aliases.json"
  },
  "isActive": false,
  "name": "AzureChinaCloud",
  "profile": "latest",
  "suffixes": {
    "azureDatalakeAnalyticsCatalogAndJobEndpoint": null,
    "azureDatalakeStoreFileSystemEndpoint": null,
    "keyvaultDns": ".vault.azure.cn",
    "sqlServerHostname": ".database.chinacloudapi.cn",
    "storageEndpoint": "core.chinacloudapi.cn"
  }
}

切换活动的云

若要切换当前处于活动状态的云,请运行 az cloud set 命令。 此命令采用一个必需参数,即云的名称。

az cloud set --name AzureChinaCloud

Important

如果已激活的云的身份验证已过期,则在执行其他任何 CLI 任务之前,需要重新进行身份验证。 首次切换到新云时,还需要设置活动的订阅。 有关身份验证的说明,请参阅使用 Azure CLI 登录。 有关订阅管理的信息,请参阅使用 Azure CLI 管理 Azure 订阅

注册新云

如果对 Azure Stack 使用了自己的终结点,请注册新云。 可以使用 az cloud register 命令创建云。 此命令需要一个名称和一组服务终结点。 若要了解如何注册用于 Azure Stack 的云,请参阅在 Azure Stack 中配合 Azure CLI 使用 API 版本配置文件

在中国,不需要注册自己的云。 它由 Microsoft 管理,在默认情况下可用。 有关所有可用终结点设置的详细信息,请参阅 az cloud register 的文档

注册某个云不会自动切换到该云。 使用 az cloud set 命令选择新建的云。

更新现有的云

如果拥有所需权限的话,则还可以更新现有的云。 更新某个云会切换到不同的 Azure 服务配置文件或修改连接终结点。 使用 az cloud update 命令并添加与 az cloud register 相同的参数来更新云。

注销云

如果不再需要某个已创建的云,可以使用 cloud unregister 命令将它取消注册:

az cloud unregister --name MyCloud