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
Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Rychlý start pro Bash v Azure Cloud Shellu.
Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Dockeru.
Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Přihlášení pomocí Azure CLI.
Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Využití rozšíření v Azure CLI.
Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.
- 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.