Snabb start: skapa, ladda ned och lista blobar med Azure CLIQuickstart: Create, download, and list blobs with Azure CLI

Azure CLI är Azures kommandoradsmiljö för att hantera Azure-resurser.The Azure CLI is Azure's command-line experience for managing Azure resources. Du kan använda det i din webbläsare med Azure Cloud Shell.You can use it in your browser with Azure Cloud Shell. Du kan även installera det på macOS, Linux eller Windows och köra det från kommandoraden.You can also install it on macOS, Linux, or Windows and run it from the command line. I den här snabbstarten lär du dig att använda Azure CLI för att ladda upp och ned data till och från Azure Blob Storage.In this quickstart, you learn to use the Azure CLI to upload and download data to and from Azure Blob storage.

Anteckning

De funktioner som beskrivs i den här artikeln är nu tillgängliga för konton som har ett hierarkiskt namn område.The features described in this article are now available to accounts that have a hierarchical namespace. Information om hur du granskar begränsningar finns i artikeln kända problem med Azure Data Lake Storage Gen2 .To review limitations, see the Known issues with Azure Data Lake Storage Gen2 article.

KravPrerequisites

Du behöver en Azure-prenumeration för att få åtkomst till Azure Storage.To access Azure Storage, you'll need an Azure subscription. Om du inte redan har en prenumeration kan du skapa ett kostnads fritt konto innan du börjar.If you don't already have a subscription, create a free account before you begin.

All åtkomst till Azure Storage sker via ett lagringskonto.All access to Azure Storage takes place through a storage account. För den här snabbstarten skapar du ett lagringskonto med hjälp av Azure-portalen, Azure PowerShell eller Azure CLI.For this quickstart, create a storage account using the Azure portal, Azure PowerShell, or Azure CLI. Hjälp med att skapa kontot finns i Skapa ett lagringskonto.For help creating the account, see Create a storage account.

Använda Azure Cloud ShellUse Azure Cloud Shell

Azure-värdar Azure Cloud Shell, en interaktiv gränssnitts miljö som du kan använda via webbläsaren.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Du kan använda antingen bash eller PowerShell med Cloud Shell för att arbeta med Azure-tjänster.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. Du kan använda Cloud Shell förinstallerade kommandona för att köra koden i den här artikeln utan att behöva installera något i din lokala miljö.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Starta Azure Cloud Shell:To start Azure Cloud Shell:

AlternativOption Exempel/länkExample/Link
Välj Prova i det övre högra hörnet av ett kodblock.Select Try It in the upper-right corner of a code block. Om du väljer testa kopieras inte koden automatiskt till Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Exempel på hur du provar Azure Cloud Shell
Gå till https://shell.azure.com, eller Välj knappen Starta Cloud Shell för att öppna Cloud Shell i webbläsaren.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. starta Cloud Shell i ett nytt fönsterLaunch Cloud Shell in a new window
Välj knappen Cloud Shell i den övre högra meny raden i Azure Portal.Select the Cloud Shell button on the top-right menu bar in the Azure portal. Cloud Shell-knappen i Azure Portal

För att köra koden i den här artikeln i Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Starta Cloud Shell.Start Cloud Shell.

  2. Kopiera koden genom att klicka på kopierings knappen på ett kodblock.Select the Copy button on a code block to copy the code.

  3. Klistra in koden i Cloud Shell-sessionen genom att välja Ctrl+Shift+V på Windows och Linux eller genom att välja cmd+Shift+V på 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. Välj RETUR för att köra koden.Select Enter to run the code.

Om du väljer att installera och använda CLI lokalt måste du köra Azure CLI version 2.0.4 eller senare.If you choose to install and use the CLI locally, this quickstart requires that you are running the Azure CLI version 2.0.4 or later. Kör az --version för att fastställa din version.Run az --version to determine your version. Om du behöver installera eller uppgradera kan du läsa informationen i Installera Azure CLI.If you need to install or upgrade, see Install the Azure CLI.

Skapa en resursgruppCreate a resource group

Skapa en Azure-resursgrupp med kommandot az group create.Create an Azure resource group with the az group create command. En resursgrupp är en logisk container där Azure-resurser distribueras och hanteras.A resource group is a logical container into which Azure resources are deployed and managed.

Kom ihåg att ersätta plats hållarnas värden inom vinkelparenteser med dina egna värden:Remember to replace placeholder values in angle brackets with your own values:

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

Skapa ett lagringskontoCreate a storage account

Skapa ett allmänt lagringskonto med kommandot az storage account create.Create a general-purpose storage account with the az storage account create command. Det allmänna lagringskontot kan användas för alla fyra tjänsterna: blobar, filer, tabeller och köer.The general-purpose storage account can be used for all four services: blobs, files, tables, and queues.

Kom ihåg att ersätta plats hållarnas värden inom vinkelparenteser med dina egna värden:Remember to replace placeholder values in angle brackets with your own values:

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

Ange autentiseringsuppgifterna för lagringskontotSpecify storage account credentials

Azure CLI behöver dina autentiseringsuppgifter för lagringskontot för de flesta kommandona i den här självstudien.The Azure CLI needs your storage account credentials for most of the commands in this tutorial. Det finns flera alternativ för att göra det, och ett av de enklaste sätten att ange dem är att ställa in miljövariablerna AZURE_STORAGE_ACCOUNT och AZURE_STORAGE_KEY.While there are several options for doing so, one of the easiest ways to provide them is to set AZURE_STORAGE_ACCOUNT and AZURE_STORAGE_KEY environment variables.

Anteckning

Den här artikeln visar hur du ställer in miljövariabler med bash.This article shows how to set environment variables using Bash. Andra miljöer kan kräva modifiering av syntaxen.Other environments may require syntax modifications.

Börja med att visa dina lagrings konto nycklar med hjälp av kommandot AZ Storage Account Keys List .First, display your storage account keys by using the az storage account keys list command. Kom ihåg att ersätta plats hållarnas värden inom vinkelparenteser med dina egna värden:Remember to replace placeholder values in angle brackets with your own values:

az storage account keys list \
    --account-name <account-name> \
    --resource-group <resource-group-name> \
    --output table

Ange nu miljövariablerna AZURE_STORAGE_ACCOUNT och AZURE_STORAGE_KEY.Now, set the AZURE_STORAGE_ACCOUNT and AZURE_STORAGE_KEY environment variables. Du kan göra detta i bash-gränssnittet med hjälp av kommandot export.You can do this in the Bash shell by using the export command. Kom ihåg att ersätta plats hållarnas värden inom vinkelparenteser med dina egna värden:Remember to replace placeholder values in angle brackets with your own values:

export AZURE_STORAGE_ACCOUNT="<account-name>"
export AZURE_STORAGE_KEY="<account-key>"

Mer information om hur du hämtar åtkomst nycklar för kontot med hjälp av Azure Portal finns i Hantera åtkomst nycklar för lagrings kontot.For more information on how to retrieve the account access keys using the Azure portal, see Manage storage account access keys.

Skapa en containerCreate a container

Blobar laddas alltid upp till en container.Blobs are always uploaded into a container. Du kan ordna grupper av blobar på samma sätt som du ordnar filer i mappar på datorn.You can organize groups of blobs similar to the way you organize your files on your computer in folders.

Skapa en behållare för att lagra blobar med kommandot az storage container create.Create a container for storing blobs with the az storage container create command.

az storage container create --name sample-container

Ladda upp en blobUpload a blob

Blob Storage stöder blockblobar, tilläggsblobar och sidblobar.Blob storage supports block blobs, append blobs, and page blobs. I exemplen i den här snabb starten visas hur du arbetar med block-blobbar.The examples in this quickstart show how to work with block blobs.

Börja med att skapa en fil som ska laddas upp till en Block-Blob.First, create a file to upload to a block blob. Om du använder Azure Cloud Shell använder du följande kommando för att skapa en fil:If you're using Azure Cloud Shell, use the following command to create a file:

vi helloworld

När filen öppnas trycker du på Infoga.When the file opens, press insert. Skriv Hej världenoch tryck sedan på ESC. Skriv sedan : xoch tryck på RETUR.Type Hello world, then press Esc. Next, type :x, then press Enter.

I det här exemplet laddar vi upp en blob till den container som vi skapade i det senaste steget med kommandot 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. Du behöver inte ange en fil Sök väg sedan filen skapades i rot katalogen:It's not necessary to specify a file path since the file was created at the root directory:

az storage blob upload \
    --container-name sample-container \
    --name helloworld \
    --file helloworld

Den här åtgärden skapar bloben om den inte redan finns, och skriver över den om den finns.This operation creates the blob if it doesn't already exist, and overwrites it if it does. Ladda upp så många filer som du vill innan du fortsätter.Upload as many files as you like before continuing.

Om du vill ladda upp flera filer samtidigt kan du använda kommandot az storage blob upload-batch.To upload multiple files at the same time, you can use the az storage blob upload-batch command.

Visa en lista över blobarna i en containerList the blobs in a container

Lista blobarna i containern med kommandot az storage blob list.List the blobs in the container with the az storage blob list command.

az storage blob list \
    --container-name sample-container \
    --output table

Ladda ned en blobDownload a blob

Använd kommandot az storage blob download för att ladda ned den blob som du laddade upp tidigare.Use the az storage blob download command to download the blob you uploaded earlier.

az storage blob download \
    --container-name sample-container \
    --name helloworld \
    --file ~/destination/path/for/file

Dataöverföring med AzCopyData transfer with AzCopy

Verktyget AzCopy är ett annat alternativ för högpresterande, skriptbar dataöverföring för Azure Storage.The AzCopy utility is another option for high-performance scriptable data transfer for Azure Storage. Du kan använda AzCopy för att överföra data till och från Blob, File och Table Storage.You can use AzCopy to transfer data to and from Blob, File, and Table storage.

I följande exempel används AzCopy för att ladda upp en fil med namnet File. txt till behållaren för exempel behållare .The following example uses AzCopy to upload a file called myfile.txt to the sample-container container. Kom ihåg att ersätta plats hållarnas värden inom vinkelparenteser med dina egna värden:Remember to replace placeholder values in angle brackets with your own values:

azcopy \
    --source /mnt/myfiles \
    --destination https://<account-name>.blob.core.windows.net/sample-container \
    --dest-key <account-key> \
    --include "myfile.txt"

Rensa resurserClean up resources

Om du inte längre behöver någon av resurserna i resurs gruppen, inklusive lagrings kontot som du skapade i den här snabb starten, tar du bort resurs gruppen med kommandot AZ Group Delete .If you no longer need any of the resources in your resource group, including the storage account you created in this quickstart, delete the resource group with the az group delete command. Kom ihåg att ersätta plats hållarnas värden inom vinkelparenteser med dina egna värden:Remember to replace placeholder values in angle brackets with your own values:

az group delete --name <resource-group-name>

Nästa stegNext steps

I den här snabb starten har du lärt dig hur du överför filer mellan ett lokalt fil system och en behållare i Azure Blob Storage.In this quickstart, you learned how to transfer files between a local file system and a container in Azure Blob storage. Om du vill veta mer om att arbeta med blobar i Azure Storage kan du fortsätta med de självstudierna.To learn more about working with blobs in Azure Storage, continue to the tutorial for working with Azure Blob storage.