Quickstart: Criar, transferir e listar bolhas com 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

As funcionalidades descritas neste artigo estão agora disponíveis para contas que têm um espaço hierárquico de nomes.The features described in this article are now available to accounts that have a hierarchical namespace. Para rever as limitações, consulte as funcionalidades de armazenamento Blob disponíveis no artigo da Azure Data Lake Storage Gen2.To review limitations, see the Blob storage features available in Azure Data Lake Storage Gen2 article.

Pré-requisitosPrerequisites

Para aceder ao Azure Storage, precisará de uma subscrição do Azure.To access Azure Storage, you'll need an Azure subscription. Se ainda não tiver 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 Azure Storage 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.

Prepare o seu ambiente para o CLI do AzurePrepare your environment for the Azure CLI

  • Utilize o ambiente Bash em Azure Cloud Shell.Use the Bash environment in Azure Cloud Shell.

    Iniciar Cloud Shell numa nova janelaLaunch Cloud Shell in a new window

  • Se preferir, instale o CLI do Azure para executar comandos de referência de CLI.If you prefer, install the Azure CLI to run CLI reference commands.

    • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login.If you're using a local installation, sign in to the Azure CLI by using the az login command. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal.To finish the authentication process, follow the steps displayed in your terminal. Para obter mais opções de início de sessão, veja Iniciar sessão com o CLI do Azure.For additional sign-in options, see Sign in with the Azure CLI.

    • Quando lhe for pedido, instale as extensões do CLI do Azure durante a primeira utilização.When you're prompted, install Azure CLI extensions on first use. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.For more information about extensions, see Use extensions with the Azure CLI.

    • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas.Run az version to find the version and dependent libraries that are installed. Para atualizar para a versão mais recente, execute o comando az upgrade.To upgrade to the latest version, run az upgrade.

  • Este artigo requer a versão 2.0.46 ou posterior do Azure CLI.This article requires version 2.0.46 or later of the Azure CLI. Se utilizar o Azure Cloud Shell, a versão mais recente já está instalada.If using Azure Cloud Shell, the latest version is already installed.

Autorizar o acesso ao armazenamento blobAuthorize access to Blob storage

Pode autorizar o acesso ao armazenamento blob a partir do CLI Azure, quer com credenciais AZure AD, 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 AZure AD.Using Azure AD credentials is recommended. Este artigo mostra como autorizar operações de armazenamento Blob usando Azure AD.This article shows how to authorize Blob storage operations using Azure AD.

O Azure CLI ordena operações de dados contra o suporte de armazenamento --auth-mode Blob, o parâmetro, 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. Desa esta medida para --auth-mode login autorizar com credenciais AZure AD.Set the --auth-mode parameter to login to authorize with Azure AD credentials. Para obter mais informações, consulte Autorizar o acesso aos dados de 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 armazenamento blob suportam o --auth-mode parâmetro.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 Azure AD 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 recursosCreate 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 nos suportes angulares com os seus próprios valores: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 nos suportes angulares com os seus próprios valores: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-services 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 recipientes semelhantes à forma como organiza os seus ficheiros no seu 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.

O exemplo a seguir utiliza a sua conta Azure AD para autorizar a operação de criação do recipiente.The following example uses your Azure AD account to authorize the operation to create the container. Antes de criar o recipiente, atribua a função de Contribuinte de Dados de Armazenamento blob a si mesmo.Before you create the container, assign the Storage Blob Data Contributor role to yourself. Mesmo que você é o proprietário da conta, você precisa de permissões explícitas para realizar operações de dados contra a conta de armazenamento.Even if you are the account owner, you need explicit permissions to perform data operations against the storage account. Para obter mais informações sobre a atribuição de funções Azure, consulte Use Azure CLI para atribuir uma função Azure para acesso.For more information about assigning Azure roles, see Use Azure CLI to assign an Azure role for access.

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

az ad signed-in-user show --query objectId -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ções azure podem demorar alguns minutos a propagar-se.Azure role assignments may take a few minutes to propagate.

Também pode utilizar a chave da conta de armazenamento para autorizar a operação para criar o recipiente.You can also use the storage account key to authorize the operation to create the container. Para obter mais informações sobre a autorização de operações de dados com o Azure CLI, consulte Autorizar o acesso aos dados de blob ou fila com o Azure CLI.For more information about authorizing data operations with Azure CLI, see Authorize access to blob or queue data with Azure CLI.

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 bloco.The examples in this quickstart show how to work with block blobs.

Primeiro, crie um ficheiro para carregar para uma bolha de bloco.First, create a file to upload to a block blob. Se estiver a utilizar o 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 arquivo desde que o ficheiro foi criado no diretório de 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 nos suportes angulares com os seus próprios valores: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 nos suportes angulares com os seus próprios valores: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 nos suportes angulares com os seus próprios valores: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 da linha de comando AzCopy oferece transferência de dados scriptable de alto desempenho para 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 a AzCopy v10, a versão mais recente do AzCopy, consulte Começar com a AzCopy.For more information about AzCopy v10, the latest version of AzCopy, see Get started with AzCopy. Para saber sobre a utilização do AzCopy v10 com armazenamento Blob, consulte os dados de 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 a seguir utiliza o AzCopy para enviar 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 pelos seus próprios valores: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 os recursosClean up resources

Se pretender eliminar os recursos que criou como parte deste arranque rápido, 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 nos suportes angulares com os seus próprios valores: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 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 como trabalhar com o armazenamento blob utilizando o Azure CLI, explore as amostras do Azure CLI para armazenamento blob.To learn more about working with Blob storage by using Azure CLI, explore Azure CLI samples for Blob storage.