Gerenciamento de nuvem do Azure com a CLI do Azure

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

Listar nuvens disponíveis

Você pode listar as nuvens disponíveis com o comando az cloud list. Esse comando mostra qual nuvem está ativa no momento, qual é seu perfil atual e dará informações sobre os nomes de host e sufixos regionais.

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 ativa no momento possui True na coluna IsActive. Somente uma nuvem pode estar ativa em determinado momento. Para obter informações mais detalhadas sobre uma nuvem, incluindo os pontos de extremidade que ela utiliza para os serviços do Azure, use 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"
  }
}

Alternar 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. Esse comando usa um argumento necessário, o nome da nuvem.

az cloud set --name AzureChinaCloud

Importante

Se a autenticação para a nuvem ativada tiver expirado, você precisará autenticar novamente antes de realizar outras tarefas de CLI. Se esta for a primeira vez em que troca para a nova nuvem, você também precisará definir a assinatura ativa. Para obter instruções sobre a autenticação, confira Entrar com a CLI do Azure. Para obter informações sobre o gerenciamento de assinaturas, confira Gerenciar assinaturas do Azure com a CLI do Azure

Registrar uma nova nuvem

Registre uma nova nuvem se tiver seus próprios pontos de extremidade do Azure Stack. Uma nuvem é criada com o comando az cloud register. Este comando requer um nome e um conjunto de pontos de extremidade de serviço. Para saber como registrar uma nuvem para usar com o Azure Stack, confira Usar perfis de versão da API com a CLI do Azure no Azure Stack.

Você não precisa registrar informações para regiões da Alemanha, China ou US Government. Essas nuvens são gerenciadas pela Microsoft e ficam disponíveis por padrão. Para obter mais informações sobre todas as configurações do ponto de extremidade disponíveis, confira a documentação para az cloud register.

Você não é automaticamente migrado para uma nuvem ao registrá-la. Use o comando az cloud set para escolher a nuvem recém-criada.

Atualizar uma nuvem existente

Se você tiver permissões, também poderá atualizar uma nuvem existente. A atualização de uma nuvem leva à mudança para um perfil de serviços do Azure diferente ou modifica os pontos de extremidade da conexão. Atualize uma nuvem com o comando az cloud update, que tem os mesmos argumentos de az cloud register.

Cancelar o registro de uma nuvem

Se você já não precisar de uma nuvem criada, é possível remover seu registro com o comando cloud unregister:

az cloud unregister --name MyCloud