Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A CLI do Azure é a experiência de linha de comando do Azure para gerenciar recursos do Azure. Você pode usá-la em seu navegador com o Azure Cloud Shell. Você também pode instalá-lo no Windows, no Linux ou no macOS e executá-lo na linha de comando. Neste início rápido, você aprenderá a usar a CLI do Azure para carregar e baixar dados de e para o Armazenamento de Blobs do Azure.
Pré-requisitos
Para acessar o Armazenamento do Azure, você precisará de uma assinatura do Azure. Se você ainda não tiver uma assinatura, 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 sobre como criar uma conta de armazenamento, confira Criar uma conta de armazenamento.
Preparar o ambiente para a CLI do Azure
Utilize o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Introdução ao Azure Cloud Shell.
Se você preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se você estiver executando no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira Como executar a CLI do Azure em um contêiner do Docker.
Se você estiver usando uma instalação local, entre na CLI do Azure usando o comando az login . Para concluir o processo de autenticação, siga as etapas exibidas em seu terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.
Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar e gerenciar extensões com a CLI do Azure.
Execute o comando az version para localizar 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 você está usando o Azure Cloud Shell, a versão mais recente já está instalada.
Autorizar o acesso ao Blob Storage
Você pode autorizar o acesso ao Armazenamento de Blobs por meio da CLI do Azure com as credenciais do Microsoft Entra ou usando a chave de acesso da conta de armazenamento. É recomendável usar as credenciais do Microsoft Entra. Este artigo mostra como autorizar operações de Armazenamento de Blobs usando a ID do Microsoft Entra.
Os comandos da CLI do Azure para operações de dados no Armazenamento de Blobs dão suporte ao parâmetro, o --auth-mode que permite especificar como autorizar uma determinada operação. Defina o parâmetro --auth-mode como login para autorizar com as credenciais do Microsoft Entra. Para obter mais informações, confira Autorizar o acesso a dados de blob ou de filas com a CLI do Azure.
Somente operações de dados de armazenamento de blobs dão suporte ao --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, entre em sua conta do Azure com o logon az.
az login
Criar um grupo de recursos
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 dos espaços reservados entre colchetes angulares pelos seus próprios valores:
az group create \
--name <resource-group> \
--location <location>
Criar uma conta de armazenamento
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 dos espaços reservados entre colchetes 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
Criar um contêiner
Os blobs são sempre carregados em um contêiner. Você pode organizar grupos de blobs em contêineres semelhantes à maneira como organiza seus arquivos em seu computador em pastas. Crie um contêiner para armazenar os 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 Colaborador de Dados do Blob de Armazenamento a si mesmo. Mesmo se você for o proprietário da conta, você 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 aos dados de blob.
Lembre-se de substituir os valores dos espaços reservados entre colchetes 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
As atribuições de função do Azure podem levar alguns minutos para serem propagadas.
Você também pode usar a chave da conta de armazenamento para autorizar a operação a 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.
Carregar um blob
O Armazenamento de Blobs dá suporte a blobs de blocos, blobs de acréscimo e blobs de páginas. Os exemplos deste início rápido mostram como trabalhar com blobs de blocos.
Primeiro, crie um arquivo para carregar em um blob de blocos. Se você estiver usando o Azure Cloud Shell, use o seguinte comando para criar um arquivo:
vi helloworld
Quando o arquivo for aberto, pressione Insert. Digite Olá, mundo e pressione Esc. Em seguida, digite :x e pressione Enter.
Neste exemplo, você carrega um blob no contêiner criado na última etapa usando o comando az storage blob upload. Não é necessário especificar um caminho de arquivo desde que o arquivo foi criado no diretório raiz. Lembre-se de substituir os valores dos espaços reservados entre colchetes 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
Essa operação criará o blob se ele ainda não existir e o substituirá se existir. Carregue quantos arquivos desejar antes de continuar.
Quando você carrega um blob usando a CLI do Azure, ele emite as respectivas chamadas à API REST por meio de protocolos http e https.
Para carregar vários arquivos ao mesmo tempo, você pode usar o comando az storage blob upload-batch .
Listar os blobs em um contêiner
Liste os blobs no contêiner com o comando az storage blob list . Lembre-se de substituir os valores dos espaços reservados entre colchetes angulares pelos seus próprios valores:
az storage blob list \
--account-name <storage-account> \
--container-name <container> \
--output table \
--auth-mode login
Baixar um blob
Use o comando az storage blob download para baixar o blob que você carregou anteriormente. Lembre-se de substituir os valores dos espaços reservados entre colchetes 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
Transferência de dados com o AzCopy
O utilitário de linha de comando AzCopy oferece transferência de dados de alto desempenho e scriptável para o Armazenamento do Azure. Você pode usar o AzCopy para transferir dados de e para o Armazenamento de Blobs e 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 Blobs, consulte Transferir dados com o AzCopy e o Armazenamento de Blobs.
O exemplo a seguir usa o AzCopy para carregar um arquivo local em um blob. Lembre-se de substituir os valores de exemplo por seus próprios valores:
azcopy login
azcopy copy 'C:\myDirectory\myFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myFile.txt'
Limpar os recursos
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 dos espaços reservados entre colchetes angulares pelos seus próprios valores:
az group delete \
--name <resource-group> \
--no-wait
Próximas etapas
Neste início rápido, você aprendeu a transferir arquivos entre um sistema de arquivos local e um contêiner no Armazenamento de Blobs do Azure. Para saber mais sobre como trabalhar com o Armazenamento de Blobs usando a CLI do Azure, selecione uma opção abaixo.