Sdílet prostřednictvím

Rychlý start: Vytvoření, stažení a výpis objektů blob pomocí 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 do systému macOS, Linux nebo Windows a spustit ho z příkazového řádku. V tomto rychlém startu se naučíte používat Azure CLI k nahrání a stahování dat do a ze služby Azure Blob Storage.

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.

Autorizujte přístup k úložišti 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 povolit operace úložiště Blob pomocí Microsoft Entra ID.

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. Nastavte parametr --auth-mode na login k 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.

Pouze operace úložiště objektů Blob podporují parametr --auth-mode. 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ě

Pomocí příkazu az storage account create vytvořte účet úložiště pro obecné účely. Účet úložiště pro obecné účely lze použít pro všechny čtyři služby: 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 nahrají 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 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í blobu

Úložiště Blob podporuje blokované objekty blob, připojovací objekty blob a stránkové objekty blob. Příklady v tomto rychlém startu ukazují, jak pracovat s objekty blob bloku.

Nejprve vytvořte soubor pro nahrání do blokového blobu. 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 posledním kroku 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 pokud ano, přepíše ho. Než budete pokračovat, nahrajte tolik souborů, kolik chcete.

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

Výpis objektů blob v kontejneru pomocí příkazu az storage blob list 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í blobu

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í nástroje 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čistěte zdroje

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.

Správa blokových blobů pomocí Azure CLI

Ukázky Azure CLI pro úložiště Blob

  • Last updated on