Quickstart: Criar, descarregar e listar bolhas com o Azure CLIQuickstart: Create, download, and list blobs with Azure CLI

A CLI do Azure é a experiência da linha de comandos do Azure para a gestão de recursos do Azure.The Azure CLI is Azure's command-line experience for managing Azure resources. Pode utilizá-la no seu browser com o Azure Cloud Shell.You can use it in your browser with Azure Cloud Shell. Também pode instalá-la no macOS, Linux ou Windows e executá-la a partir da linha de comandos.You can also install it on macOS, Linux, or Windows and run it from the command line. 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.In this quickstart, you learn to use the Azure CLI to upload and download data to and from Azure Blob storage.

Nota

Os recursos descritos neste artigo agora estão disponíveis para contas que têm um namespace hierárquico.The features described in this article are now available to accounts that have a hierarchical namespace. Para revisar as limitações, consulte os problemas conhecidos com Azure data Lake Storage Gen2 artigo.To review limitations, see the Known issues with Azure Data Lake Storage Gen2 article.

Pré-requisitosPrerequisites

Para aceder ao Armazenamento Azure, necessitará de uma subscrição Azure.To access Azure Storage, you'll need an Azure subscription. Se ainda não tem uma subscrição, crie uma conta gratuita antes de começar.If you don't already have a subscription, create a free account before you begin.

Todo o acesso ao Armazenamento Azure ocorre através de uma conta de armazenamento.All access to Azure Storage takes place through a storage account. Para este arranque rápido, crie uma conta de armazenamento utilizando o portal Azure,Azure PowerShell ou Azure CLI.For this quickstart, create a storage account using the Azure portal, Azure PowerShell, or Azure CLI. Para ajudar a criar uma conta de armazenamento, consulte Criar uma conta de armazenamento.For help creating a storage account, see Create a storage account.

Utilizar o Azure Cloud ShellUse Azure Cloud Shell

O Azure acolhe o Azure Cloud Shell, um ambiente interativo de conchas que pode utilizar através do seu navegador.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Pode utilizar a Bash ou a PowerShell com a Cloud Shell para trabalhar com os serviços Azure.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. Pode utilizar os comandos pré-instalados cloud Shell para executar o código neste artigo sem ter de instalar nada no seu ambiente local.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Para iniciar a Casca de Nuvem Azure:To start Azure Cloud Shell:

OpçãoOption Exemplo/LigaçãoExample/Link
Selecione Experimentar no canto superior direito de um bloco de código.Select Try It in the upper-right corner of a code block. Selecionar Tente Não copia automaticamente o código para Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Exemplo de teste para Azure Cloud Shell
Vá para https://shell.azure.com, ou selecione o botão Launch Cloud Shell para abrir cloud Shell no seu navegador.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. lançar Cloud Shell numa nova janelaLaunch Cloud Shell in a new window
Selecione o botão Cloud Shell na barra de menu na parte superior direita no portal Azure.Select the Cloud Shell button on the menu bar at the upper right in the Azure portal. Botão Cloud Shell no portal do Azure

Para executar o código neste artigo em Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Começa a Cloud Shell.Start Cloud Shell.

  2. Selecione o botão Copiar num bloco de código para copiar o código.Select the Copy button on a code block to copy the code.

  3. Colhe o código na sessão Cloud Shell selecionando Ctrl+Shift+V no Windows e Linux ou selecionando cmd+Shift+V no macOS.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Selecione Entrar para executar o código.Select Enter to run the code.

Instale o Azure CLI localmenteInstall the Azure CLI locally

Se optar por instalar e utilizar o Azure CLI localmente, este quickstart requer que esteja a executar a versão Azure CLI 2.0.46 ou posterior.If you choose to install and use the Azure CLI locally, this quickstart requires that you are running the Azure CLI version 2.0.46 or later. Execute az --version para determinar a versão.Run az --version to determine your version. Se precisar de instalar ou atualizar, veja Instalar a CLI do Azure.If you need to install or upgrade, see Install the Azure CLI.

Se estiver a executar o Azure CLI localmente, tem de fazer login e autenticar.If you are running the Azure CLI locally, you must log in and authenticate. Este passo não é necessário se estiver a utilizar a Azure Cloud Shell.This step is not necessary if you are using Azure Cloud Shell. Para iniciar sessão no Azure CLI, faça az login e autenticar na janela do navegador:To log in to Azure CLI, run az login and authenticate in the browser window:

az login

Para mais informações sobre a autenticação' com o Azure CLI, consulte O Signin em com o Azure CLI.For more information about authentication` with Azure CLI, see Sign in with Azure CLI.

Autorizar o acesso ao armazenamento blobAuthorize access to Blob storage

Pode autorizar o acesso ao armazenamento Blob a partir do Azure CLI, quer com credenciais De AD Azure, quer utilizando a chave de acesso à conta de armazenamento.You can authorize access to Blob storage from the Azure CLI either with Azure AD credentials or by using the storage account access key. Recomenda-se a utilização de credenciais AD Azure.Using Azure AD credentials is recommended. Este artigo mostra como autorizar operações de armazenamento blob usando a AD Azure.This article shows how to authorize Blob storage operations using Azure AD.

Os comandos Azure CLI para operações de dados contra o armazenamento Blob suportam o parâmetro --auth-mode, o que lhe permite especificar como autorizar uma determinada operação.Azure CLI commands for data operations against Blob storage support the --auth-mode parameter, which enables you to specify how to authorize a given operation. Defina o parâmetro --auth-mode para login autorizar com credenciais Azure AD.Set the --auth-mode parameter to login to authorize with Azure AD credentials. Para mais informações, consulte Autorizar o acesso a dados blob ou fila com o Azure CLI.For more information, see Authorize access to blob or queue data with Azure CLI.

Apenas as operações de dados de armazenamento blob suportam o parâmetro --auth-mode.Only Blob storage data operations support the --auth-mode parameter. As operações de gestão, tais como a criação de um grupo de recursos ou uma conta de armazenamento, utilizam automaticamente credenciais de AD Azure para autorização.Management operations, such as creating a resource group or storage account, automatically use Azure AD credentials for authorization.

Criar um grupo de recursos:Create a resource group

Crie um grupo de recursos do Azure com o comando az group create.Create an Azure resource group with the az group create command. Um grupo de recursos é um contentor lógico no qual os recursos do Azure são implementados e geridos.A resource group is a logical container into which Azure resources are deployed and managed.

Lembre-se de substituir os valores do espaço reservado em suportes angulares por valores próprios:Remember to replace placeholder values in angle brackets with your own values:

az group create \
    --name <resource-group> \
    --location <location>

Criar uma conta de armazenamentoCreate a storage account

Crie uma conta de armazenamento para fins gerais com o comando az storage account create.Create a general-purpose storage account with the az storage account create command. A conta de armazenamento para fins gerais pode ser utilizada para os quatro serviços: blobs, ficheiros, tabelas e filas.The general-purpose storage account can be used for all four services: blobs, files, tables, and queues.

Lembre-se de substituir os valores do espaço reservado em suportes angulares por valores próprios:Remember to replace placeholder values in angle brackets with your own values:

az storage account create \
    --name <storage-account> \
    --resource-group <resource-group> \
    --location <location> \
    --sku Standard_ZRS \
    --encryption blob

Criar um contentorCreate a container

Os Blobs são sempre carregados para um contentor.Blobs are always uploaded into a container. Pode organizar grupos de bolhas em contentores semelhantes à forma como organiza os seus ficheiros no computador em pastas.You can organize groups of blobs in containers similar to the way you organize your files on your computer in folders.

Crie um contentor para armazenar blobs com o comando az storage container create.Create a container for storing blobs with the az storage container create command. Lembre-se de substituir os valores do espaço reservado em suportes angulares por valores próprios:Remember to replace placeholder values in angle brackets with your own values:

az storage container create \
    --account-name <storage-account> \
    --name <container> \
    --auth-mode login

Carregar um blobUpload a blob

O armazenamento de blobs suporta blobs de blocos, blobs de acréscimo e blobs de páginas.Blob storage supports block blobs, append blobs, and page blobs. Os exemplos neste arranque rápido mostram como trabalhar com bolhas de blocos.The examples in this quickstart show how to work with block blobs.

Primeiro, crie um ficheiro para fazer o upload para uma bolha de bloco.First, create a file to upload to a block blob. Se estiver a utilizar a Azure Cloud Shell, utilize o seguinte comando para criar um ficheiro:If you're using Azure Cloud Shell, use the following command to create a file:

vi helloworld

Quando o ficheiro abrir, prima a inserção.When the file opens, press insert. Tipo Olá mundo, em seguida, prima Esc. Em seguida, escreva :x, em seguida, prima Enter.Type Hello world, then press Esc. Next, type :x, then press Enter.

Neste exemplo, carregue um blob para o contentor criado no último passo com o comando az storage blob upload.In this example, you upload a blob to the container you created in the last step using the az storage blob upload command. Não é necessário especificar um caminho de ficheiro, uma vez que o ficheiro foi criado no diretório raiz.It's not necessary to specify a file path since the file was created at the root directory. Lembre-se de substituir os valores do espaço reservado em suportes angulares por valores próprios:Remember to replace placeholder values in angle brackets with your own values:

az storage blob upload \
    --account-name <storage-account> \
    --container-name <container> \
    --name helloworld \
    --file helloworld \
    --auth-mode login

Esta operação cria o blob, caso este ainda não exista, ou substitui-o se o mesmo já existir.This operation creates the blob if it doesn't already exist, and overwrites it if it does. Carregue os ficheiros que quiser antes de continuar.Upload as many files as you like before continuing.

Para carregar múltiplos ficheiros em simultâneo, pode utilizar o comando az storage blob upload-batch.To upload multiple files at the same time, you can use the az storage blob upload-batch command.

Listar os blobs num contentorList the blobs in a container

Liste os blobs no contentor com o comando az storage blob list.List the blobs in the container with the az storage blob list command. Lembre-se de substituir os valores do espaço reservado em suportes angulares por valores próprios:Remember to replace placeholder values in angle brackets with your own values:

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

Transferir um blobDownload a blob

Utilize o comando az storage blob download para transferir o blob carregado anteriormente.Use the az storage blob download command to download the blob you uploaded earlier. Lembre-se de substituir os valores do espaço reservado em suportes angulares por valores próprios:Remember to replace placeholder values in angle brackets with your own values:

az storage blob download \
    --account-name <storage-account> \
    --container-name <container> \
    --name helloworld \
    --file ~/destination/path/for/file \
    --auth-mode login

Transferência de dados com o AzCopyData transfer with AzCopy

O utilitário de linha de comando AzCopy oferece transferência de dados de alto desempenho e scriptable para o Armazenamento Azure.The AzCopy command-line utility offers high-performance, scriptable data transfer for Azure Storage. Pode utilizar o AzCopy para transferir dados de e para o armazenamento blob e ficheiros Azure.You can use AzCopy to transfer data to and from Blob storage and Azure Files. Para mais informações sobre o AzCopy v10, a versão mais recente do AzCopy, consulte Get started with AzCopy.For more information about AzCopy v10, the latest version of AzCopy, see Get started with AzCopy. Para aprender sobre a utilização do AzCopy v10 com armazenamento Blob, consulte os dados da Transferência com armazenamento AzCopy e Blob.To learn about using AzCopy v10 with Blob storage, see Transfer data with AzCopy and Blob storage.

O exemplo que se segue utiliza o AzCopy para fazer o upload de um ficheiro local para uma bolha.The following example uses AzCopy to upload a local file to a blob. Lembre-se de substituir os valores da amostra por valores próprios:Remember to replace the sample values with your own values:

azcopy login
azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt'

Limpar recursosClean up resources

Se pretender eliminar os recursos que criou como parte deste quickstart, incluindo a conta de armazenamento, elimine o grupo de recursos utilizando o comando de eliminação do grupo AZ.If you want to delete the resources you created as part of this quickstart, including the storage account, delete the resource group by using the az group delete command. Lembre-se de substituir os valores do espaço reservado em suportes angulares por valores próprios:Remember to replace placeholder values in angle brackets with your own values:

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

Passos seguintesNext steps

Neste arranque rápido, aprendeu a transferir ficheiros entre um sistema de ficheiros local e um contentor no armazenamento do Azure Blob.In this quickstart, you learned how to transfer files between a local file system and a container in Azure Blob storage. Para saber mais sobre a utilização de blobs no Armazenamento do Azure, avance para o tutorial para utilizar o armazenamento de Blobs do Azure.To learn more about working with blobs in Azure Storage, continue to the tutorial for working with Azure Blob storage.