Partilhar via


Início Rápido: Criar, transferir e listar blobs com a CLI do Azure

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, vai aprender a utilizar a CLI do Azure para carregar e transferir 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 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.

Prepare o seu ambiente para o CLI do Azure

  • Use o ambiente Bash no 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 estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor 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 o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando 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.

Autorizar o acesso ao armazenamento de Blob

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 --auth-mode parâmetro para login autorizar com credenciais do Microsoft Entra. Para obter mais informações, consulte Autorizar o acesso a dados de blob ou fila com a CLI do Azure.

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 início de sessão 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 contentor lógico no qual os recursos do Azure são implementados e geridos.

Lembre-se de substituir os valores de espaço reservado 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 para fins gerais com o comando az storage account create. A conta de armazenamento para fins gerais pode ser utilizada para os quatro serviços: blobs, ficheiros, tabelas e filas.

Lembre-se de substituir os valores de espaço reservado 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 contentor

Os Blobs são sempre carregados para 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 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 se propagar.

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.

Carregar um blob

O armazenamento de blobs suporta blobs de blocos, blobs de acréscimo e blobs de páginas. 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, carregue um blob para o contentor criado no último passo com 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 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

Esta operação cria o blob, caso este ainda não exista, ou substitui-o se o mesmo 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 múltiplos ficheiros em simultâneo, pode utilizar o comando az storage blob upload-batch.

Listar os blobs num contentor

Liste os blobs no contentor com o comando az storage blob list. Lembre-se de substituir os valores de espaço reservado entre colchetes angulares pelos seus próprios valores:

az storage blob list \
    --account-name <storage-account> \
    --container-name <container> \
    --output table \
    --auth-mode login

Transferir um blob

Utilize o comando az storage blob download para transferir o blob carregado anteriormente. Lembre-se de substituir os valores de espaço reservado 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 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 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'

Clean up resources (Limpar 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 de espaço reservado entre colchetes angulares pelos seus próprios valores:

az group delete \
    --name <resource-group> \
    --no-wait

Próximos passos

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.