Sdílet prostřednictvím


Rychlý start: Vytváření, stahování a výpis objektů blob s využitím Azure CLI

Azure CLI je prostředí příkazového řádku Azure pro správu prostředků Azure. Můžete ho používat ve svém prohlížeči prostřednictvím služby Azure Cloud Shell. Můžete ho také nainstalovat v systému macOS, Linux nebo Windows a spouštět z příkazového řádku. 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.

Požadavky

Pro přístup ke službě Azure Storage budete potřebovat předplatné Azure. Pokud ještě nemáte předplatné, vytvořte si před zahájením bezplatný účet .

Veškerý přístup ke službě Azure Storage probíhá prostřednictvím účtu úložiště. Pro účely tohoto rychlého startu vytvořte účet úložiště pomocí webu Azure Portal, Azure PowerShellu nebo Azure CLI. Nápovědu k vytvoření účtu úložiště najdete v tématu Vytvoření účtu úložiště.

Příprava prostředí pro rozhraní příkazového řádku Azure

  • Tento článek vyžaduje verzi 2.0.46 nebo novější azure CLI. Pokud používáte Azure Cloud Shell, je už nainstalovaná nejnovější verze.

Autorizace přístupu k úložišti objektů blob

Přístup k úložišti objektů blob můžete autorizovat z Azure CLI pomocí přihlašovacích údajů Microsoft Entra nebo pomocí přístupového klíče účtu úložiště. Doporučuje se používat přihlašovací údaje Microsoft Entra. Tento článek ukazuje, jak autorizovat operace úložiště objektů blob pomocí ID Microsoft Entra.

Příkazy Azure CLI pro operace s daty v úložišti objektů blob podporují --auth-mode parametr, který umožňuje určit, jak autorizovat danou operaci. --auth-mode Nastavte parametr na login autorizaci pomocí přihlašovacích údajů Microsoft Entra. Další informace najdete v tématu Autorizace přístupu k datům objektů blob nebo front pomocí Azure CLI.

Parametr podporují --auth-mode pouze operace úložiště objektů blob. Operace správy, jako je například vytvoření skupiny prostředků nebo účtu úložiště, k autorizaci automaticky používají přihlašovací údaje Microsoft Entra.

Začněte tím, že se přihlásíte ke svému účtu Azure pomocí příkazu az login.

az login

Vytvoření skupiny zdrojů

Vytvořte skupinu prostředků Azure pomocí příkazu az group create. Skupina prostředků je logický kontejner, ve kterém se nasazují a spravují prostředky Azure.

Nezapomeňte nahradit zástupné hodnoty v hranatých závorkách vlastními hodnotami:

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

Vytvoření účtu úložiště

Účet úložiště pro obecné účely vytvoříte příkazem az storage account create. Účet úložiště pro obecné účely můžete použít pro všechny čtyři služby: objekty blob, soubory, tabulky a fronty.

Nezapomeňte nahradit zástupné hodnoty v hranatých závorkách vlastními hodnotami:

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

Vytvoření kontejneru

Objekty blob se vždy nahrávají do kontejneru. Skupiny objektů blob můžete uspořádat v kontejnerech podobně jako soubory v počítači ve složkách. K vytvoření kontejneru pro ukládání objektů blob použijte příkaz az storage container create.

Následující příklad používá váš účet Microsoft Entra k autorizaci operace k vytvoření kontejneru. Před vytvořením kontejneru přiřaďte roli Přispěvatel dat objektů blob služby Storage sami sobě. I když jste vlastníkem účtu, potřebujete explicitní oprávnění k provádění operací s daty s účtem úložiště. Další informace o přiřazování rolí Azure najdete v tématu Přiřazení role Azure pro přístup k datům objektů blob.

Nezapomeňte nahradit zástupné hodnoty v hranatých závorkách vlastními hodnotami:

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

Důležité

Rozšíření přiřazení rolí Azure může trvat několik minut.

K autorizaci operace k vytvoření kontejneru můžete použít také klíč účtu úložiště. Další informace o autorizaci operací s daty pomocí Azure CLI najdete v tématu Autorizace přístupu k datům objektů blob nebo front pomocí Azure CLI.

Nahrání objektu blob

Úložiště objektů blob podporuje objekty blob bloku, doplňovací objekty blob a objekty blob stránky. Příklady v tomto rychlém startu ukazují, jak pracovat s objekty blob bloku.

Nejprve vytvořte soubor pro nahrání do objektu blob bloku. Pokud používáte Azure Cloud Shell, vytvořte soubor pomocí následujícího příkazu:

vi helloworld

Po otevření souboru stiskněte klávesu Insert. Napište Hello world a stiskněte klávesu Esc. Potom zadejte :x a stiskněte 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. Vzhledem k tomu, že byl soubor vytvořen v kořenovém adresáři, není nutné zadávat cestu k souboru. Nezapomeňte nahradit zástupné hodnoty v hranatých závorkách vlastními hodnotami:

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

Tato operace vytvoří objekt blob, pokud ještě neexistuje, a přepíše ho, pokud už existoval. Než budete pokračovat, můžete nahrát libovolné množství souborů.

Když nahrajete objekt blob pomocí Azure CLI, vydá příslušná volání rozhraní REST API přes protokoly HTTP a HTTPS.

Pokud chcete nahrát více souborů najednou, můžete použít příkaz az storage blob upload-batch.

Seznam objektů blob v kontejneru

Pomocí příkazu az storage blob list zobrazte seznam objektů blob v kontejneru. Nezapomeňte nahradit zástupné hodnoty v hranatých závorkách vlastními hodnotami:

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

Stažení objektu blob

Pomocí příkazu az storage blob download stáhněte objekt blob, který jste nahráli dříve. Nezapomeňte nahradit zástupné hodnoty v hranatých závorkách vlastními hodnotami:

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

Přenos dat pomocí AzCopy

Nástroj příkazového řádku AzCopy nabízí vysoce výkonný a skriptovatelný přenos dat pro Azure Storage. AzCopy můžete použít k přenosu dat do a ze služby Blob Storage a ze služby Azure Files. Další informace o nástroji AzCopy v10, nejnovější verzi nástroje AzCopy, najdete v tématu Začínáme s nástrojem AzCopy. Další informace o používání nástroje AzCopy v10 s úložištěm objektů blob najdete v tématu Přenos dat pomocí nástroje AzCopy a úložiště objektů blob.

Následující příklad používá AzCopy k nahrání místního souboru do objektu blob. Nezapomeňte nahradit ukázkové hodnoty vlastními hodnotami:

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

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

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

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

Další kroky

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. Pokud chcete získat další informace o práci s úložištěm objektů blob pomocí Azure CLI, vyberte níže požadovanou možnost.