Gestão da cloud do Azure com a CLI do Azure

  • Artigo

Se trabalha em diferentes regiões ou utiliza o Azure Stack, poderá ter de utilizar mais do que uma cloud. A Microsoft oferece clouds para estar em conformidade com as leis regionais, que estão disponíveis para sua utilização. Este artigo mostra como obter informações sobre clouds, alterar a cloud atual e registar ou anular o registo de clouds novas.

Lista de clouds disponíveis

Pode listar as clouds disponíveis com o comando az cloud list. Este comando mostra a cloud que está atualmente ativa, qual é o perfil atual da mesma e informações sobre sufixos regionais e nomes de anfitriões.

Para obter a cloud ativa e uma lista de todas as clouds disponíveis:

az cloud list --output table

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

A cloud atualmente ativa tem True na coluna IsActive. Apenas uma cloud pode estar ativa em qualquer altura. Para obter informações mais detalhadas sobre uma cloud, incluindo os pontos finais que utiliza para serviços do Azure, utilize o comando 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"
  }
}

Mudar a cloud ativa

Para definir a cloud predefinida com um ficheiro de configuração, veja Valores de configuração da CLI e variáveis de ambiente. Para mudar a cloud ativa, execute o comando az cloud set . Este comando utiliza um argumento obrigatório, o nome da cloud.

az cloud set --name AzureChinaCloud

Importante

Se a autenticação para a cloud ativada tiver expirado, tem de autenticar novamente antes de realizar quaisquer outras tarefas da CLI. Se esta for a primeira vez que muda para uma nova cloud, também tem de definir a subscrição ativa. Para obter instruções sobre a autenticação, veja Iniciar sessão com a CLI do Azure. Para obter informações sobre a gestão de subscrições, veja Gerir subscrições do Azure com a CLI do Azure

Registar uma cloud nova

Se tiver os seus próprios pontos finais para o Azure Stack registe uma nova cloud. A criação de clouds é feita com o comando az cloud register. Este comando precisa de um nome e de um conjunto de pontos finais de serviço. Para saber como registar uma cloud para utilização com o Azure Stack, veja Use API version profiles with Azure CLI in Azure Stack (Utilizar perfis de versão da API com a CLI do Azure no Azure Stack).

Não precisa de registar informações para a China, o Governo norte-americano ou as regiões alemãs. Estas clouds são geridas pela Microsoft e estão disponíveis por predefinição. Para obter mais informações sobre todas as definições de ponto final disponíveis, veja a documentação para az cloud register.

Registar uma cloud não muda automaticamente para a mesma. Utilize o comando az cloud set para selecionar a cloud recém-criada.

Atualizar uma cloud existente

Se tiver permissões, também pode atualizar uma cloud existente. A atualização de uma cloud muda para um perfil do serviço do Azure diferente ou modifica os pontos finais da ligação. Atualize uma cloud com o comando az cloud update, que aceita os mesmos argumentos que az cloud register.

Anular o registo de uma cloud

Se já não precisa de uma cloud criada, pode anular o registo da mesma com o comando az cloud unregister:

az cloud unregister --name MyCloud