Gerenciamento de nuvem do Azure com a CLI do Azure

Se você trabalha em regiões diferentes ou usa o Azure Stack, talvez seja necessário usar mais de uma nuvem. A Microsoft fornece nuvens que estão em conformidade com as leis regionais, que estão disponíveis para seu uso. Este artigo mostra como obter informações sobre nuvens, alterar a nuvem atual e registar ou anular o registo de nuvens novas.

Lista de nuvens disponíveis

Pode listar as clouds disponíveis com o comando az cloud list. Este comando exibe a nuvem atualmente ativa, seu perfil atual e informações sobre sufixos regionais e nomes de host.

Para obter a nuvem ativa e uma lista de todas as nuvens disponíveis:

az cloud list --output table

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

A nuvem atualmente ativa tem True na coluna IsActive. Apenas uma nuvem pode estar ativa a qualquer momento. 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"
  }
}

Alterar a nuvem ativa

Para definir a nuvem padrão usando um arquivo de configuração, consulte Valores de configuração da CLI e variáveis de ambiente. Para alternar a nuvem ativa, execute o comando az cloud set. Este comando utiliza um argumento obrigatório, o nome da cloud.

az cloud set --name AzureChinaCloud

Registar uma nova nuvem

Se tiver os seus próprios pontos finais para o Azure Stack registe uma nova cloud. A criação de uma nuvem é realizada 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).

Você não precisa registrar informações para as regiões da China, do governo dos EUA ou da Alemanha. A Microsoft gerencia essas nuvens e elas estão disponíveis por padrão. Para obter mais informações sobre as configurações de ponto de extremidade disponíveis, consulte a documentação sobre az cloud register.

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

Atualizar uma nuvem existente

Se tiver permissões, também pode atualizar uma cloud existente. A atualização de uma nuvem muda para um perfil diferente dos serviços do Azure ou modifica os pontos finais de 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 nuvem

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