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 téma funkce služby Blob Storage dostupné v Azure Data Lake Storage Gen2 článku.To review limitations, see the Blob storage features available in Azure Data Lake Storage Gen2 article.

PožadavkyPrerequisites

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.

Příprava prostředí pro rozhraní příkazového řádku AzurePrepare your environment for the Azure CLI

  • Použijte prostředí bash v Azure Cloud Shell.Use the Bash environment in Azure Cloud Shell.

    Spuštění služby Cloud Shell v novém okněLaunch Cloud Shell in a new window

  • Pokud tomu dáváte přednost, můžete nainstalovat Azure CLI a spouštět referenční příkazy CLI.If you prefer, install the Azure CLI to run CLI reference commands.

    • Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login.If you're using a local installation, sign in to the Azure CLI by using the az login command. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu.To finish the authentication process, follow the steps displayed in your terminal. Další možnosti přihlášení jsou popsané v tématu Přihlášení pomocí Azure CLI.For additional sign-in options, see Sign in with the Azure CLI.

    • Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití.When you're prompted, install Azure CLI extensions on first use. Další informace o rozšířeních najdete v tématu Využití rozšíření v Azure CLI.For more information about extensions, see Use extensions with the Azure CLI.

    • Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované.Run az version to find the version and dependent libraries that are installed. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.To upgrade to the latest version, run az upgrade.

  • Tento článek vyžaduje verzi rozhraní příkazového řádku Azure 2.0.46 nebo novější.This article requires version 2.0.46 or later of the Azure CLI. Pokud používáte Azure Cloud Shell, nejnovější verze je už nainstalovaná.If using Azure Cloud Shell, the latest version is already installed.

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í --auth-mode parametr, 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 --auth-mode parametr na login 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í --auth-mode parametr.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-services 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.

Následující příklad používá účet Azure AD k autorizaci operace vytvoření kontejneru.The following example uses your Azure AD account to authorize the operation to create the container. Než vytvoříte kontejner, přiřaďte roli Přispěvatel dat objektů BLOB úložiště sami sobě.Before you create the container, assign the Storage Blob Data Contributor role to yourself. I když jste vlastníkem účtu, potřebujete explicitní oprávnění k provádění operací s daty v účtu úložiště.Even if you are the account owner, you need explicit permissions to perform data operations against the storage account. Další informace o přiřazování rolí Azure najdete v tématu přiřazení role Azure k přístupu pomocí Azure CLI.For more information about assigning Azure roles, see Use Azure CLI to assign an Azure role for access.

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 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

Důležité

Rozšiřování přiřazení rolí Azure může trvat několik minut.Azure role assignments may take a few minutes to propagate.

K autorizaci operace vytvoření kontejneru můžete použít taky klíč účtu úložiště.You can also use the storage account key to authorize the operation to create the container. Další informace o autorizaci operací s daty pomocí Azure CLI najdete v tématu autorizace přístupu k objektům blob nebo Queue data ve frontě pomocí Azure CLI.For more information about authorizing data operations with Azure CLI, see Authorize access to blob or queue data with Azure CLI.

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 World a pak stiskněte klávesu ESC. Dále zadejte : x a 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.

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 úložištěm objektů BLOB pomocí Azure CLI najdete v ukázkách Azure CLI pro úložiště objektů BLOB.To learn more about working with Blob storage by using Azure CLI, explore Azure CLI samples for Blob storage.