使用 Azure CLI 进行 Azure 云管理

2025-05-22

如果跨不同区域工作或使用 Azure Stack，可能需要使用多个云。 Microsoft提供云，以便遵守可供你使用的区域法律。本文介绍如何获取有关云的信息、更改当前云以及注册或注销新云。

列出可用的云

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

获取活动云和所有可用云的列表：

az cloud list --output table

IsActive    Name               Profile
----------  -----------------  ---------
True        AzureCloud         latest
            AzureChinaCloud    latest
            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"
  }
}

切换当前激活的云端

若要使用配置文件设置默认云，请参阅 CLI 配置值和环境变量。若要切换活动云，请运行 az cloud set 命令。此命令采用一个必需参数，即云的名称。

az cloud set --name AzureChinaCloud

重要

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

注册新云

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

无需为中国、美国政府或德国区域注册信息。这些云由Microsoft管理，默认情况下可用。有关所有可用终结点设置的详细信息，请参阅相关az cloud register文档。

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

更新现有云

如果拥有权限，还可以更新现有云。更新云以切换到不同的 Azure 服务配置文件或修改连接终结点。使用 az cloud update 命令更新云，该命令采用与相同的参数 az cloud register。

取消注册云

如果不再需要已创建的云，可以使用 az cloud unregister 命令将其注销：

az cloud unregister --name MyCloud

通过