Rychlý Start: vytvoření, stažení a výpis objektů BLOB pomocí Azure CLIQuickstart: Create, download, and list blobs with Azure CLI

Azure CLI je prostředí příkazového řádku Azure pro správu prostředků Azure.The Azure CLI is Azure's command-line experience for managing Azure resources. Můžete ho používat ve svém prohlížeči prostřednictvím služby Azure Cloud Shell.You can use it in your browser with Azure Cloud Shell. Můžete ho také nainstalovat v systému macOS, Linux nebo Windows a spouštět z příkazového řádku.You can also install it on macOS, Linux, or Windows and run it from the command line. V tomto rychlém startu zjistíte, jak pomocí Azure CLI nahrávat data do úložiště objektů blob v Azure a stahovat data z úložiště objektů blob v Azure.In this quickstart, you learn to use the Azure CLI to upload and download data to and from Azure Blob storage.

Poznámka

Funkce popsané v tomto článku jsou nyní k dispozici pro účty, které mají hierarchický obor názvů.The features described in this article are now available to accounts that have a hierarchical namespace. Chcete-li zkontrolovat omezení, přečtěte si článek známé problémy s Azure Data Lake Storage Gen2 .To review limitations, see the Known issues with Azure Data Lake Storage Gen2 article.

PředpokladyPrerequisites

Pokud chcete získat přístup k Azure Storage, budete potřebovat předplatné Azure.To access Azure Storage, you'll need an Azure subscription. Pokud ještě předplatné nemáte, vytvořte si bezplatný účet před tím, než začnete.If you don't already have a subscription, create a free account before you begin.

Veškerý přístup k Azure Storage probíhá prostřednictvím účtu úložiště.All access to Azure Storage takes place through a storage account. V tomto rychlém startu vytvořte účet úložiště pomocí Azure Portal, Azure PowerShell nebo Azure CLI.For this quickstart, create a storage account using the Azure portal, Azure PowerShell, or Azure CLI. Nápovědu k vytvoření účtu úložiště najdete v tématu Vytvoření účtu úložiště.For help creating a storage account, see Create a storage account.

Použití Azure Cloud ShelluUse Azure Cloud Shell

Hostitelé Azure Azure Cloud Shell interaktivní prostředí prostředí, které můžete používat v prohlížeči.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Pro práci se službami Azure můžete použít buď bash, nebo PowerShell s Cloud Shell.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. Můžete použít Cloud Shell předinstalované příkazy ke spuštění kódu v tomto článku, aniž byste museli instalovat cokoli do svého místního prostředí.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Spuštění Azure Cloud Shell:To start Azure Cloud Shell:

MožnostOption Příklad nebo propojeníExample/Link
Zvolte Vyzkoušet v pravém horním rohu bloku kódu.Select Try It in the upper-right corner of a code block. Při výběru možnosti vyzkoušet se kód automaticky nezkopíruje do Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Příklad pokusu o Azure Cloud Shell
Přejít na https://shell.azure.comnebo vyberte tlačítko Spustit Cloud Shell a otevřete Cloud Shell v prohlížeči.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. spustit Cloud Shell v novém okněLaunch Cloud Shell in a new window
Vyberte tlačítko Cloud Shell na panelu nabídek v pravém horním rohu Azure Portal.Select the Cloud Shell button on the menu bar at the upper right in the Azure portal. Tlačítko Cloud Shell na webu Azure Portal

Chcete-li spustit kód v tomto článku v Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Spusťte Cloud Shell.Start Cloud Shell.

  2. Vyberte tlačítko Kopírovat na bloku kódu ke zkopírování kódu.Select the Copy button on a code block to copy the code.

  3. Vložte kód do relace Cloud Shell tak, že vyberete Ctrl+SHIFT+v v systému Windows a Linux nebo vyberete možnost cmd+SHIFT+v v 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. Vyberte ENTER a spusťte kód.Select Enter to run the code.

Místní instalace Azure CLIInstall the Azure CLI locally

Pokud se rozhodnete nainstalovat a používat rozhraní příkazového řádku Azure CLI místně, musíte mít spuštěnou verzi Azure CLI 2.0.46 nebo novější.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. Svou verzi zjistíte spuštěním příkazu az --version.Run az --version to determine your version. Pokud potřebujete instalaci nebo upgrade, přečtěte si téma Instalace Azure CLI.If you need to install or upgrade, see Install the Azure CLI.

Pokud používáte Azure CLI místně, musíte se přihlásit a ověřit.If you are running the Azure CLI locally, you must log in and authenticate. Tento krok není nutný, pokud používáte Azure Cloud Shell.This step is not necessary if you are using Azure Cloud Shell. Pokud se chcete přihlásit k rozhraní příkazového řádku Azure, spusťte az login a ověřte v okně prohlížeče:To log in to Azure CLI, run az login and authenticate in the browser window:

az login

Další informace o ověřování pomocí rozhraní příkazového řádku Azure najdete v tématu přihlášení pomocí Azure CLI.For more information about authentication` with Azure CLI, see Sign in with Azure CLI.

Autorizace přístupu k úložišti objektů BLOBAuthorize access to Blob storage

Přístup k úložišti objektů blob můžete autorizovat z Azure CLI buď pomocí přihlašovacích údajů Azure AD, nebo pomocí přístupového klíče účtu úložiště.You can authorize access to Blob storage from the Azure CLI either with Azure AD credentials or by using the storage account access key. Doporučuje se použít přihlašovací údaje Azure AD.Using Azure AD credentials is recommended. Tento článek ukazuje, jak autorizovat operace BLOB Storage pomocí Azure AD.This article shows how to authorize Blob storage operations using Azure AD.

Příkazy rozhraní příkazového řádku Azure pro datové operace s úložištěm objektů BLOB podporují parametr --auth-mode, který umožňuje určit, jak autorizovat danou operaci.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. Nastavte parametr --auth-mode, aby login k autorizaci pomocí přihlašovacích údajů Azure AD.Set the --auth-mode parameter to login to authorize with Azure AD credentials. Další informace najdete v tématu autorizace přístupu k datům BLOB nebo Queue pomocí Azure CLI.For more information, see Authorize access to blob or queue data with Azure CLI.

Pouze datové operace služby Blob Storage podporují parametr --auth-mode.Only Blob storage data operations support the --auth-mode parameter. Operace správy, jako je vytvoření skupiny prostředků nebo účtu úložiště, automaticky používají přihlašovací údaje Azure AD k autorizaci.Management operations, such as creating a resource group or storage account, automatically use Azure AD credentials for authorization.

Vytvoření skupiny prostředkůCreate a resource group

Vytvořte skupinu prostředků Azure pomocí příkazu az group create.Create an Azure resource group with the az group create command. Skupina prostředků je logický kontejner, ve kterém se nasazují a spravují prostředky Azure.A resource group is a logical container into which Azure resources are deployed and managed.

Nezapomeňte nahradit zástupné hodnoty v lomených závorkách vlastními hodnotami:Remember to replace placeholder values in angle brackets with your own values:

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

Vytvoření účtu úložištěCreate a storage account

Účet úložiště pro obecné účely vytvoříte příkazem az storage account create.Create a general-purpose storage account with the az storage account create command. Účet úložiště pro obecné účely můžete použít pro všechny čtyři služby: objekty blob, soubory, tabulky a fronty.The general-purpose storage account can be used for all four services: blobs, files, tables, and queues.

Nezapomeňte nahradit zástupné hodnoty v lomených závorkách vlastními hodnotami: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

Vytvoření kontejneruCreate a container

Objekty blob se vždy nahrávají do kontejneru.Blobs are always uploaded into a container. Skupiny objektů blob můžete uspořádat v kontejnerech podobně jako při organizování souborů v počítači ve složkách.You can organize groups of blobs in containers similar to the way you organize your files on your computer in folders.

K vytvoření kontejneru pro ukládání objektů blob použijte příkaz az storage container create.Create a container for storing blobs with the az storage container create command. Nezapomeňte nahradit zástupné hodnoty v lomených závorkách vlastními hodnotami: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

Nahrání objektu blobUpload a blob

Úložiště objektů blob podporuje objekty blob bloku, doplňovací objekty blob a objekty blob stránky.Blob storage supports block blobs, append blobs, and page blobs. Příklady v tomto rychlém startu ukazují, jak pracovat s objekty blob bloku.The examples in this quickstart show how to work with block blobs.

Nejdřív vytvořte soubor, který se nahraje do objektu blob bloku.First, create a file to upload to a block blob. Pokud používáte Azure Cloud Shell, vytvořte soubor pomocí následujícího příkazu:If you're using Azure Cloud Shell, use the following command to create a file:

vi helloworld

Po otevření souboru stiskněte Vložit.When the file opens, press insert. Zadejte Hello Worlda pak stiskněte klávesu ESC. Dále zadejte : xa potom stiskněte klávesu ENTER.Type Hello world, then press Esc. Next, type :x, then press Enter.

V tomto příkladu nahrajete objekt blob do kontejneru, který jste vytvořili v předchozím kroku, a to pomocí příkazu 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. Není nutné zadávat cestu k souboru, protože soubor byl vytvořen v kořenovém adresáři.It's not necessary to specify a file path since the file was created at the root directory. Nezapomeňte nahradit zástupné hodnoty v lomených závorkách vlastními hodnotami: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

Tato operace vytvoří objekt blob, pokud ještě neexistuje, a přepíše ho, pokud už existoval.This operation creates the blob if it doesn't already exist, and overwrites it if it does. Než budete pokračovat, můžete nahrát libovolné množství souborů.Upload as many files as you like before continuing.

Pokud chcete nahrát více souborů najednou, můžete použít příkaz az storage blob upload-batch.To upload multiple files at the same time, you can use the az storage blob upload-batch command.

Zobrazí seznam objektů blob v kontejneruList the blobs in a container

Pomocí příkazu az storage blob list zobrazte seznam objektů blob v kontejneru.List the blobs in the container with the az storage blob list command. Nezapomeňte nahradit zástupné hodnoty v lomených závorkách vlastními hodnotami: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

Stažení objektu blobDownload a blob

Pomocí příkazu az storage blob download stáhněte objekt blob, který jste nahráli dříve.Use the az storage blob download command to download the blob you uploaded earlier. Nezapomeňte nahradit zástupné hodnoty v lomených závorkách vlastními hodnotami: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

Přenos dat pomocí AzCopyData transfer with AzCopy

Nástroj příkazového řádku AzCopy nabízí vysoce výkonný a skriptový přenos dat pro Azure Storage.The AzCopy command-line utility offers high-performance, scriptable data transfer for Azure Storage. AzCopy můžete použít k přenosu dat do a ze služby Blob Storage a souborů Azure.You can use AzCopy to transfer data to and from Blob storage and Azure Files. Další informace o AzCopy v10 za účelem, nejnovější verzi AzCopy, najdete v tématu Začínáme s AzCopy.For more information about AzCopy v10, the latest version of AzCopy, see Get started with AzCopy. Další informace o použití AzCopy v10 za účelem s úložištěm objektů BLOB najdete v tématu přenos dat pomocí AzCopy a BLOB Storage.To learn about using AzCopy v10 with Blob storage, see Transfer data with AzCopy and Blob storage.

Následující příklad používá AzCopy k nahrání místního souboru do objektu BLOB.The following example uses AzCopy to upload a local file to a blob. Nezapomeňte nahradit vzorové hodnoty vlastními hodnotami: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'

Vyčištění prostředkůClean up resources

Pokud chcete odstranit prostředky, které jste vytvořili v rámci tohoto rychlého startu, včetně účtu úložiště, odstraňte skupinu prostředků pomocí příkazu AZ Group Delete .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. Nezapomeňte nahradit zástupné hodnoty v lomených závorkách vlastními hodnotami:Remember to replace placeholder values in angle brackets with your own values:

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

Další krokyNext steps

V tomto rychlém startu jste zjistili, jak přenášet soubory mezi místním systémem souborů a kontejnerem v úložišti objektů BLOB v Azure.In this quickstart, you learned how to transfer files between a local file system and a container in Azure Blob storage. Další informace o práci s objekty blob ve službě Azure Storage najdete v kurzu práce s úložištěm objektů blob v Azure.To learn more about working with blobs in Azure Storage, continue to the tutorial for working with Azure Blob storage.