Megosztás a következőn keresztül:


Quickstart: Create, download, and list blobs with Azure CLI

Az Azure CLI az Azure parancssori felülete, amely Azure-erőforrások kezelésére szolgál. Használhatja a böngészőjében az Azure Cloud Shell-lel. Vagy telepítheti macOS, Linux és Windows rendszeren, és futtathatja a parancssorból. In this quickstart, you learn to use the Azure CLI to upload and download data to and from Azure Blob storage.

Előfeltételek

Az Azure Storage eléréséhez Azure-előfizetésre lesz szüksége. Ha még nem rendelkezik előfizetéssel, a kezdés előtt hozzon létre egy ingyenes fiókot .

Az Azure Storage-hoz való minden hozzáférés egy tárfiókon keresztül történik. Ebben a rövid útmutatóban hozzon létre egy tárfiókot az Azure Portal, az Azure PowerShell vagy az Azure CLI használatával. A tárfiókok létrehozásával kapcsolatban lásd : Tárfiók létrehozása.

A környezet előkészítése az Azure CLI-re

  • Ez a cikk az Azure CLI 2.0.46-os vagy újabb verzióját igényli. Az Azure Cloud Shell használata esetén a legújabb verzió már telepítve van.

Blob Storage-hozzáférés engedélyezése

A Blob Storage-hoz való hozzáférést az Azure CLI-ből engedélyezheti a Microsoft Entra hitelesítő adataival vagy a tárfiók hozzáférési kulcsával. Using Microsoft Entra credentials is recommended. This article shows how to authorize Blob storage operations using Microsoft Entra ID.

A Blob Storage-beli adatműveletek Azure CLI-parancsai támogatják a --auth-mode paramétert, amely lehetővé teszi egy adott művelet engedélyezésének megadását. Set the --auth-mode parameter to login to authorize with Microsoft Entra credentials. További információ: Blob- vagy üzenetsoradatokhoz való hozzáférés engedélyezése az Azure CLI-vel.

A paramétert csak a --auth-mode Blob Storage-adatműveletek támogatják. Az olyan felügyeleti műveletek, mint például egy erőforráscsoport vagy tárfiók létrehozása, automatikusan a Microsoft Entra hitelesítő adatait használják az engedélyezéshez.

To begin, sign-in to to your Azure account with the az login.

az login

Erőforráscsoport létrehozása

Hozzon létre egy Azure-erőforráscsoportot az az group create paranccsal. Az erőforráscsoport egy logikai tároló, amelyben az Azure-erőforrások üzembe helyezése és felügyelete történik.

Ne felejtse el lecserélni a szögletes zárójelek helyőrző értékeit a saját értékeire:

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

Tárfiók létrehozása

Create a general-purpose storage account with the az storage account create command. The general-purpose storage account can be used for all four services: blobs, files, tables, and queues.

Ne felejtse el lecserélni a szögletes zárójelek helyőrző értékeit a saját értékeire:

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

Tároló létrehozása

A blobok minden esetben egy tárolóba lesznek feltöltve. You can organize groups of blobs in containers similar to the way you organize your files on your computer in folders. Create a container for storing blobs with the az storage container create command.

Az alábbi példa a Microsoft Entra-fiókjával engedélyezi a műveletet a tároló létrehozásához. Before you create the container, assign the Storage Blob Data Contributor role to yourself. Even if you are the account owner, you need explicit permissions to perform data operations against the storage account. For more information about assigning Azure roles, see Assign an Azure role for access to blob data.

Ne felejtse el lecserélni a szögletes zárójelek helyőrző értékeit a saját értékeire:

az ad signed-in-user show --query id -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

Fontos

Az Azure-szerepkör-hozzárendelések érvénybe lépése eltarthat néhány percig.

You can also use the storage account key to authorize the operation to create the container. For more information about authorizing data operations with Azure CLI, see Authorize access to blob or queue data with Azure CLI.

Blob feltöltése

A Blob Storage támogatja a blokkblobokat, a hozzáfűző blobokat és a lapblobokat. The examples in this quickstart show how to work with block blobs.

First, create a file to upload to a block blob. If you're using Azure Cloud Shell, use the following command to create a file:

vi helloworld

When the file opens, press insert. Type Hello world, then press Esc. Next, type :x, then press Enter.

In this example, you upload a blob to the container you created in the last step using the az storage blob upload command. It's not necessary to specify a file path since the file was created at the root directory. Ne felejtse el lecserélni a szögletes zárójelek helyőrző értékeit a saját értékeire:

az storage blob upload \
    --account-name <storage-account> \
    --container-name <container> \
    --name myFile.txt \
    --file myFile.txt \
    --auth-mode login

This operation creates the blob if it doesn't already exist, and overwrites it if it does. Mielőtt továbblépne, töltsön fel annyi fájlt, amennyit csak szeretne.

When you upload a blob using the Azure CLI, it issues respective REST API calls via http and https protocols.

To upload multiple files at the same time, you can use the az storage blob upload-batch command.

Tárolóban lévő blobok kilistázása

List the blobs in the container with the az storage blob list command. Ne felejtse el lecserélni a szögletes zárójelek helyőrző értékeit a saját értékeire:

az storage blob list \
    --account-name <storage-account> \
    --container-name <container> \
    --output table \
    --auth-mode login

Download a blob

Use the az storage blob download command to download the blob you uploaded earlier. Ne felejtse el lecserélni a szögletes zárójelek helyőrző értékeit a saját értékeire:

az storage blob download \
    --account-name <storage-account> \
    --container-name <container> \
    --name myFile.txt \
    --file <~/destination/path/for/file> \
    --auth-mode login

Adatátvitel az AzCopy használatával

Az AzCopy parancssori segédprogram nagy teljesítményű, szkriptelhető adatátvitelt biztosít az Azure Storage-hoz. Az AzCopy használatával adatokat továbbíthat a Blob Storage-ba és az Azure Filesba. Az AzCopy legújabb verziójával, az AzCopy 10-es verziójával kapcsolatos további információkért tekintse meg az AzCopy használatának első lépéseit. Az AzCopy v10 blobtárolóval való használatáról további információt az Adatok átvitele az AzCopy és a Blob Storage használatával című témakörben talál.

Az alábbi példa az AzCopy használatával tölt fel egy helyi fájlt egy blobba. Ne felejtse el lecserélni a mintaértékeket a saját értékeire:

azcopy login
azcopy copy 'C:\myDirectory\myFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myFile.txt'

Erőforrások tisztítása

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. Ne felejtse el lecserélni a szögletes zárójelek helyőrző értékeit a saját értékeire:

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

Következő lépések

In this quickstart, you learned how to transfer files between a local file system and a container in Azure Blob storage. To learn more about working with Blob storage by using Azure CLI, select an option below.