Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
A CLI do Azure é a experiência da linha de comandos do Azure para a gestão de recursos do Azure. Pode utilizá-la no seu browser com o Azure Cloud Shell. Também pode instalá-la no macOS, Linux ou Windows e executá-la a partir da linha de comandos. Neste início rápido, você aprende a usar a CLI do Azure para carregar e baixar dados de e para o armazenamento de Blob do Azure.
Para acessar o Armazenamento do Azure, você precisará de uma assinatura do Azure. Se ainda não tiver uma subscrição, crie uma conta gratuita antes de começar.
Todo o acesso ao Armazenamento do Azure ocorre por meio de uma conta de armazenamento. Para este início rápido, crie uma conta de armazenamento usando o portal do Azure, o Azure PowerShell ou a CLI do Azure. Para obter ajuda para criar uma conta de armazenamento, consulte Criar uma conta de armazenamento.
Use o ambiente Bash na Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.
Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se você estiver executando no Windows ou macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.
Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.
Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.
Execute az version para descobrir a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute az upgrade.
- Este artigo requer a versão 2.0.46 ou posterior da CLI do Azure. Se estiver usando o Azure Cloud Shell, a versão mais recente já está instalada.
Você pode autorizar o acesso ao armazenamento de Blob a partir da CLI do Azure com credenciais do Microsoft Entra ou usando a chave de acesso da conta de armazenamento. Recomenda-se o uso de credenciais do Microsoft Entra. Este artigo mostra como autorizar operações de armazenamento de Blob usando o Microsoft Entra ID.
Os comandos da CLI do Azure para operações de dados no armazenamento de Blob dão suporte ao --auth-mode parâmetro, que permite especificar como autorizar uma determinada operação. Defina o parâmetro --auth-mode para login para autorizar com as credenciais do Microsoft Entra. Para obter mais informações, consulte Autorize o acesso a dados de blob ou fila com a Azure CLI.
Somente as operações de dados de armazenamento de Blob suportam o --auth-mode parâmetro. As operações de gerenciamento, como a criação de um grupo de recursos ou uma conta de armazenamento, usam automaticamente as credenciais do Microsoft Entra para autorização.
Para começar, inicie sessão na sua conta do Azure com o az login.
az login
Crie um grupo de recursos do Azure com o comando az group create. Um grupo de recursos é um contêiner lógico no qual os recursos do Azure são implantados e gerenciados.
Lembre-se de substituir os valores de espaço reservado entre parênteses angulares pelos seus próprios valores.
az group create \
--name <resource-group> \
--location <location>
Crie uma conta de armazenamento de uso geral com o comando az storage account create . A conta de armazenamento de uso geral pode ser usada para todos os quatro serviços: blobs, arquivos, tabelas e filas.
Lembre-se de substituir os valores de espaço reservado entre parênteses angulares pelos seus próprios valores.
az storage account create \
--name <storage-account> \
--resource-group <resource-group> \
--location <location> \
--sku Standard_ZRS \
--encryption-services blob
Os blobs são sempre enviados para dentro de um contentor. Você pode organizar grupos de blobs em contêineres de forma semelhante à maneira como você organiza seus arquivos em seu computador em pastas. Crie um contentor para armazenar blobs com o comando az storage container create.
O exemplo a seguir usa sua conta do Microsoft Entra para autorizar a operação para criar o contêiner. Antes de criar o contêiner, atribua a função de Colaborador de Dados de Blob de Armazenamento a si mesmo. Mesmo se você for o proprietário da conta, precisará de permissões explícitas para executar operações de dados na conta de armazenamento. Para obter mais informações sobre como atribuir funções do Azure, consulte Atribuir uma função do Azure para acesso a dados de blob.
Lembre-se de substituir os valores de espaço reservado entre parênteses angulares pelos seus próprios valores.
az ad signed-in-user show --query id -o tsv | az role assignment create \
--role "Storage Blob Data Contributor" \
--assignee @- \
--scope "/subscriptions/<subscription>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account>"
az storage container create \
--account-name <storage-account> \
--name <container> \
--auth-mode login
Importante
Pode demorar alguns minutos para que as atribuições de função do Azure se propaguem.
Você também pode usar a chave da conta de armazenamento para autorizar a operação para criar o contêiner. Para obter mais informações sobre como autorizar operações de dados com a CLI do Azure, consulte Autorizar o acesso a dados de blob ou fila com a CLI do Azure.
O armazenamento de blobs suporta blobs em bloco, blobs de acréscimo e blobs de página. Os exemplos neste guia de início rápido mostram como trabalhar com blobs de bloco.
Primeiro, crie um arquivo para carregar em um blob de bloco. Se você estiver usando o Azure Cloud Shell, use o seguinte comando para criar um arquivo:
vi helloworld
Quando o ficheiro abrir, prima inserir. Digite Hello world e pressione Esc. Em seguida, digite :x e pressione Enter.
Neste exemplo, você carrega um blob para o contêiner criado na última etapa usando o comando az storage blob upload . Não é necessário especificar um caminho de arquivo, pois o arquivo foi criado no diretório raiz. Lembre-se de substituir os valores de espaço reservado entre parênteses angulares pelos seus próprios valores.
az storage blob upload \
--account-name <storage-account> \
--container-name <container> \
--name myFile.txt \
--file myFile.txt \
--auth-mode login
Esta operação cria o blob se ele ainda não existir e substitui-o se já existir. Carregue os ficheiros que quiser antes de continuar.
Quando você carrega um blob usando a CLI do Azure, ele emite as respetivas chamadas de API REST por meio dos protocolos http e https.
Para carregar vários arquivos ao mesmo tempo, você pode usar o comando az storage blob upload-batch .
Liste os blobs no contêiner com o comando az storage blob list . Lembre-se de substituir os valores de espaço reservado entre parênteses angulares pelos seus próprios valores.
az storage blob list \
--account-name <storage-account> \
--container-name <container> \
--output table \
--auth-mode login
Use o comando az storage blob download para baixar o blob que você carregou anteriormente. Lembre-se de substituir os valores de espaço reservado entre parênteses angulares pelos seus próprios valores.
az storage blob download \
--account-name <storage-account> \
--container-name <container> \
--name myFile.txt \
--file <~/destination/path/for/file> \
--auth-mode login
O utilitário de linha de comando AzCopy oferece transferência de dados programáveis de alto desempenho para o Armazenamento do Azure. Você pode usar o AzCopy para transferir dados de e para o armazenamento de Blob e os Arquivos do Azure. Para obter mais informações sobre o AzCopy v10, a versão mais recente do AzCopy, consulte Introdução ao AzCopy. Para saber mais sobre como usar o AzCopy v10 com o armazenamento de Blob, consulte Transferir dados com o AzCopy e o armazenamento de Blob.
O exemplo a seguir usa AzCopy para carregar um arquivo local em um blob. Lembre-se de substituir os valores de amostra pelos seus próprios valores:
azcopy login
azcopy copy 'C:\myDirectory\myFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myFile.txt'
Se você quiser excluir os recursos criados como parte deste início rápido, incluindo a conta de armazenamento, exclua o grupo de recursos usando o comando az group delete . Lembre-se de substituir os valores de espaço reservado entre parênteses angulares pelos seus próprios valores.
az group delete \
--name <resource-group> \
--no-wait
Neste início rápido, você aprendeu como transferir arquivos entre um sistema de arquivos local e um contêiner no armazenamento de Blob do Azure. Para saber mais sobre como trabalhar com armazenamento de Blob usando a CLI do Azure, selecione uma opção abaixo.