Управление облаком Azure с помощью Azure CLI

  • Статья

При работе в разных регионах или использовании Azure Stack вам может понадобиться несколько облаков. Корпорация Майкрософт предоставляет доступные для использования облака в соответствии с местным законодательством в пределах каждого региона. В этой статье показано, как получить сведения об облаках, изменить текущее облако, а также зарегистрировать новые облака или отменить их регистрацию.

Получение списка доступных облаков

Вы можете отобразить список доступных облаков с помощью команды az cloud list. Эта команда показывает, какое облако сейчас используется и какой у него текущий профиль, а также отображает сведения о суффиксах регионов и именах узлов.

Получить сведения об активном облаке и полном списке доступных облаков можно так:

az cloud list --output table

IsActive    Name               Profile
----------  -----------------  ---------
True        AzureCloud         latest
            AzureChinaCloud    latest
            AzureUSGovernment  latest
            AzureGermanCloud   latest

Активное сейчас облако обозначено значением True в столбце IsActive. В одно и то же время использоваться может только одно облако. Получить дополнительные сведения об облаке, включая описание конечных точек, используемых им для служб 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 с помощью Azure CLI.

Регистрация нового облака

Зарегистрируйте новое облако, если у вас есть свои конечные точки для Azure Stack. Облако создается с помощью команды az cloud register. Для этой команды требуется имя и набор конечных точек службы. Сведения о регистрации облака для использования Azure Stack см. в статье Использование профилей версий API и Azure CLI в Azure Stack.

Вам не нужно регистрировать сведения в регионах "Китай", "US Government" или "Германия". Эти облака управляются корпорацией Майкрософт и доступны по умолчанию. Дополнительные сведения обо всех доступных конечных точках см. в документации по az cloud register.

Регистрация в облаке не подразумевает автоматическое переключение на него. Для выбора нового облака используйте команду az cloud set.

Обновление существующего облака

При наличии соответствующих разрешений вы также можете обновить существующее облако. Обновление облака приводит к переключению на другой профиль служб Azure или изменению конечных точек подключения. Это можно сделать с помощью команды az cloud update, которая принимает те же аргументы, что и команда az cloud register.

Отмена регистрации облака

Если созданное облако вам больше не нужно, его регистрацию можно отменить с помощью команды az cloud unregister:

az cloud unregister --name MyCloud