Szybki Start: Tworzenie, pobieranie i wyświetlanie listy obiektów BLOB za pomocą interfejsu wiersza polecenia platformy AzureQuickstart: Create, download, and list blobs with Azure CLI

Interfejs wiersza polecenia platformy Azure to środowisko wiersza polecenia platformy Azure do zarządzania jej zasobami.The Azure CLI is Azure's command-line experience for managing Azure resources. Można używać go w przeglądarce za pośrednictwem usługi Azure Cloud Shell.You can use it in your browser with Azure Cloud Shell. Istnieje także możliwość zainstalowania go w systemach macOS, Linux lub Windows, a następnie uruchomienia z poziomu wiersza polecenia.You can also install it on macOS, Linux, or Windows and run it from the command line. Ten przewodnik Szybki start zawiera opis użycia interfejsu wiersza polecenia platformy Azure do przekazywania danych do/pobierania danych z usługi Azure Blob Storage.In this quickstart, you learn to use the Azure CLI to upload and download data to and from Azure Blob storage.

Uwaga

Funkcje opisane w tym artykule są teraz dostępne dla kont, które mają hierarchiczną przestrzeń nazw.The features described in this article are now available to accounts that have a hierarchical namespace. Aby zapoznać się z ograniczeniami, zobacz znane problemy dotyczące Azure Data Lake Storage Gen2 artykułu.To review limitations, see the Known issues with Azure Data Lake Storage Gen2 article.

Wymagania wstępnePrerequisites

Aby uzyskać dostęp do usługi Azure Storage, potrzebujesz subskrypcji platformy Azure.To access Azure Storage, you'll need an Azure subscription. Jeśli nie masz jeszcze subskrypcji, przed rozpoczęciem Utwórz bezpłatne konto .If you don't already have a subscription, create a free account before you begin.

Cały dostęp do usługi Azure Storage odbywa się za pośrednictwem konta magazynu.All access to Azure Storage takes place through a storage account. Na potrzeby tego samouczka Szybki start utwórz konto magazynu przy użyciu witryny Azure Portal, programu Azure PowerShell lub interfejsu wiersza polecenia platformy Azure.For this quickstart, create a storage account using the Azure portal, Azure PowerShell, or Azure CLI. Aby uzyskać pomoc dotyczącą tworzenia konta magazynu, zobacz Tworzenie konta magazynu.For help creating a storage account, see Create a storage account.

Używanie usługi Azure Cloud ShellUse Azure Cloud Shell

Na platforma Azure hostowane jest Azure Cloud Shell, interaktywne środowisko powłoki, z którego można korzystać w przeglądarce.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Do pracy z usługami platformy Azure można używać programu Bash lub PowerShell w środowisku Cloud Shell.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. Aby uruchomić kod z tego artykułu bez konieczności instalowania narzędzi w środowisku lokalnym, można użyć wstępnie zainstalowanych poleceń środowiska Cloud Shell.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Aby uruchomić środowisko Azure Cloud Shell:To start Azure Cloud Shell:

OpcjaOption Przykład/linkExample/Link
Wybierz pozycję Wypróbuj w prawym górnym rogu bloku kodu.Select Try It in the upper-right corner of a code block. Wybranie pozycji Wypróbuj nie spowoduje automatycznego skopiowania kodu do środowiska Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Przykład funkcji Wypróbuj w środowisku Azure Cloud Shell
Przejdź do witryny https://shell.azure.com lub wybierz przycisk Uruchom Cloud Shell, aby otworzyć środowisko Cloud Shell w przeglądarce.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. Uruchamianie środowiska Cloud Shell w nowym oknieLaunch Cloud Shell in a new window
Wybierz przycisk Cloud Shell na pasku menu w prawym górnym rogu witryny Azure Portal.Select the Cloud Shell button on the menu bar at the upper right in the Azure portal. Przycisk Cloud Shell w witrynie Azure Portal

Aby uruchomić kod z tego artykułu w środowisku Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Uruchom usługę Cloud Shell.Start Cloud Shell.

  2. Wybierz przycisk Kopiuj w bloku kodu, aby skopiować kod.Select the Copy button on a code block to copy the code.

  3. Wklej kod w sesji Cloud Shell, naciskając klawisze Ctrl+Shift+V w systemach Windows i Linux lub klawisze Cmd+Shift+V w systemie 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. Naciśnij klawisz Enter, aby uruchomić kod.Select Enter to run the code.

Instalowanie interfejsu wiersza polecenia platformy Azure lokalnieInstall the Azure CLI locally

Jeśli zdecydujesz się zainstalować interfejs wiersza polecenia platformy Azure i korzystać z niego lokalnie, ten przewodnik Szybki Start będzie wymagał interfejsu wiersza polecenia platformy Azure w wersji 2.0.46 lub nowszej.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. Uruchom polecenie az --version, aby sprawdzić wersję.Run az --version to determine your version. Jeśli konieczna będzie instalacja lub uaktualnienie interfejsu, zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.If you need to install or upgrade, see Install the Azure CLI.

Jeśli używasz interfejsu wiersza polecenia platformy Azure lokalnie, musisz się zalogować i uwierzytelnić.If you are running the Azure CLI locally, you must log in and authenticate. Ten krok nie jest konieczny, jeśli używasz Azure Cloud Shell.This step is not necessary if you are using Azure Cloud Shell. Aby zalogować się do interfejsu wiersza polecenia az login platformy Azure, Uruchom i Uwierzytelnij w oknie przeglądarki:To log in to Azure CLI, run az login and authenticate in the browser window:

az login

Aby uzyskać więcej informacji o uwierzytelnianiu za pomocą interfejsu wiersza polecenia platformy Azure, zobacz Logowanie za pomocą interfejsu wiersza polecenia platformy Azure.For more information about authentication` with Azure CLI, see Sign in with Azure CLI.

Autoryzuj dostęp do magazynu obiektów BLOBAuthorize access to Blob storage

Dostęp do magazynu obiektów BLOB można autoryzować z poziomu interfejsu wiersza polecenia platformy Azure przy użyciu poświadczeń usługi Azure AD lub klucza dostępu do konta magazynu.You can authorize access to Blob storage from the Azure CLI either with Azure AD credentials or by using the storage account access key. Zalecane jest korzystanie z poświadczeń usługi Azure AD.Using Azure AD credentials is recommended. W tym artykule przedstawiono sposób autoryzacji operacji usługi BLOB Storage przy użyciu usług Azure AD.This article shows how to authorize Blob storage operations using Azure AD.

Polecenie interfejsu wiersza polecenia platformy Azure dla operacji na danych w --auth-mode usłudze BLOB Storage obsługuje parametr, który umożliwia określenie sposobu autoryzacji danej operacji.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. Ustaw --auth-mode parametr na login , aby autoryzować się przy użyciu poświadczeń usługi Azure AD.Set the --auth-mode parameter to login to authorize with Azure AD credentials. Aby uzyskać więcej informacji, zobacz Autoryzuj dostęp do danych obiektu BLOB lub kolejki za pomocą interfejsu wiersza polecenia platformy Azure.For more information, see Authorize access to blob or queue data with Azure CLI.

Tylko operacje na danych magazynu obiektów BLOB --auth-mode obsługują ten parametr.Only Blob storage data operations support the --auth-mode parameter. Operacje zarządzania, takie jak tworzenie grupy zasobów lub konta magazynu, automatycznie używają poświadczeń usługi Azure AD do autoryzacji.Management operations, such as creating a resource group or storage account, automatically use Azure AD credentials for authorization.

Tworzenie grupy zasobówCreate a resource group

Grupę zasobów platformy Azure można utworzyć za pomocą polecenia az group create.Create an Azure resource group with the az group create command. Grupa zasobów to logiczny kontener przeznaczony do wdrażania zasobów platformy Azure i zarządzania nimi.A resource group is a logical container into which Azure resources are deployed and managed.

Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach ostrych własnymi wartościami:Remember to replace placeholder values in angle brackets with your own values:

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

Tworzenie konta magazynuCreate a storage account

Do utworzenia konta magazynu (ogólnego przeznaczenia) służy polecenie az storage account create.Create a general-purpose storage account with the az storage account create command. Konta magazynu można używać z wszystkimi czterema usługami: obiektami blob, plikami, tabelami i kolejkami.The general-purpose storage account can be used for all four services: blobs, files, tables, and queues.

Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach ostrych własnymi wartościami: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

Tworzenie konteneraCreate a container

Obiekty blob są zawsze przesyłane do kontenera.Blobs are always uploaded into a container. Grupy obiektów BLOB można organizować w kontenerach podobnie jak w przypadku organizowania plików na komputerze w folderach.You can organize groups of blobs in containers similar to the way you organize your files on your computer in folders.

Do tworzenia kontenera do przechowywania obiektów blob służy polecenie az storage container create.Create a container for storing blobs with the az storage container create command. Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach ostrych własnymi wartościami: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

Przesyłanie obiektów blobUpload a blob

Usługa Blob Storage obsługuje blokowe, uzupełnialne i stronicowe obiekty blob.Blob storage supports block blobs, append blobs, and page blobs. Przykłady w tym przewodniku szybki start pokazują, jak korzystać z blokowych obiektów BLOB.The examples in this quickstart show how to work with block blobs.

Najpierw utwórz plik do przekazania do blokowego obiektu BLOB.First, create a file to upload to a block blob. Jeśli używasz Azure Cloud Shell, użyj następującego polecenia, aby utworzyć plik:If you're using Azure Cloud Shell, use the following command to create a file:

vi helloworld

Gdy plik zostanie otwarty, naciśnij klawisz INSERT.When the file opens, press insert. Wpisz Hello World, a następnie naciśnij klawisz ESC. Następnie wpisz : x, a następnie naciśnij klawisz Enter.Type Hello world, then press Esc. Next, type :x, then press Enter.

W tym przykładzie do kontenera utworzonego w ostatnim kroku zostanie przekazany obiekt blob za pomocą polecenia 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. Nie trzeba określać ścieżki pliku, ponieważ plik został utworzony w katalogu głównym.It's not necessary to specify a file path since the file was created at the root directory. Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach ostrych własnymi wartościami: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

Jeśli obiekt blob nie istnieje, zostanie utworzony. W przeciwnym razie zostanie zastąpiony.This operation creates the blob if it doesn't already exist, and overwrites it if it does. Przed kontynuowaniem można przesłać dowolną liczbę plików.Upload as many files as you like before continuing.

Aby przekazać jednocześnie wiele plików, możesz użyć polecenia az storage blob upload-batch.To upload multiple files at the same time, you can use the az storage blob upload-batch command.

Wyświetlanie listy obiektów blob w kontenerzeList the blobs in a container

Do wyświetlania listy obiektów blob w kontenerze służy polecenie az storage blob list.List the blobs in the container with the az storage blob list command. Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach ostrych własnymi wartościami: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

Pobieranie obiektu blobDownload a blob

Użyj polecenia az storage blob download, aby pobrać przesłany wcześniej obiekt blob.Use the az storage blob download command to download the blob you uploaded earlier. Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach ostrych własnymi wartościami: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 danych przy użyciu narzędzia AzCopyData transfer with AzCopy

Narzędzie wiersza polecenia AzCopy oferuje wysoce wydajny, oparty na skryptach transfer danych dla usługi Azure Storage.The AzCopy command-line utility offers high-performance, scriptable data transfer for Azure Storage. Można użyć AzCopy do transferowania danych do i z usługi BLOB Storage i Azure Files.You can use AzCopy to transfer data to and from Blob storage and Azure Files. Aby uzyskać więcej informacji na temat AzCopy V10, najnowszej wersji programu AzCopy, zobacz wprowadzenie do AzCopy.For more information about AzCopy v10, the latest version of AzCopy, see Get started with AzCopy. Aby dowiedzieć się więcej o korzystaniu z usługi AzCopy V10 z usługą BLOB Storage, zobacz transfer danych za pomocą AzCopy i BLOB Storage.To learn about using AzCopy v10 with Blob storage, see Transfer data with AzCopy and Blob storage.

Poniższy przykład używa AzCopy do przekazania pliku lokalnego do obiektu BLOB.The following example uses AzCopy to upload a local file to a blob. Pamiętaj, aby zastąpić przykładowe wartości własnymi wartościami: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'

Oczyszczanie zasobówClean up resources

Jeśli chcesz usunąć zasoby utworzone w ramach tego przewodnika Szybki Start, w tym konto magazynu, Usuń grupę zasobów za pomocą polecenia 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. Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach ostrych własnymi wartościami:Remember to replace placeholder values in angle brackets with your own values:

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

Następne krokiNext steps

W tym przewodniku szybki start przedstawiono sposób transferu plików między lokalnym systemem plików i kontenerem w usłudze Azure Blob Storage.In this quickstart, you learned how to transfer files between a local file system and a container in Azure Blob storage. Aby dowiedzieć się więcej na temat pracy z usługą BLOB Storage za pomocą interfejsu wiersza polecenia platformy Azure, zobacz przykłady interfejsu wiersza polecenia platformy Azure dla usługi BLOB Storage.To learn more about working with Blob storage by using Azure CLI, explore Azure CLI samples for Blob storage.