Quickstart: Blobs maken, downloaden, uploaden en weergeven met Azure CLI
Azure CLI is de nieuwe opdrachtregel van Azure voor het beheren van Azure-resources. U kunt deze gebruiken in uw browser met Azure Cloud Shell. U kunt deze ook installeren op Mac OS, Linux of Windows en uitvoeren vanaf de opdrachtregel. In deze quickstart leert u hoe u Azure CLI kunt gebruiken om gegevens naar en van Azure Blob-opslag te uploaden en te downloaden.
Vereisten
U hebt een Azure-abonnement nodig voor toegang tot Azure Storage. Als u nog geen abonnement hebt, maakt u een gratis account voordat u begint.
Alle toegang tot Azure Storage vindt plaats via een opslagaccount. Voor deze quickstart gaat u een opslagaccount maken met de Azure-portal, Azure PowerShell of Azure CLI. Zie voor meer informatie over het maken van een opslagaccount Een opslagaccount maken.
De omgeving voorbereiden op de Azure CLI
Gebruik de Bash-omgeving in Azure Cloud Shell. Zie quickstart voor Bash in Azure Cloud Shell voor meer informatie.
Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.
Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.
Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.
Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.
- Voor dit artikel is versie 2.0.46 of hoger van Azure CLI vereist. Als u Azure Cloud Shell gebruikt, is de nieuwste versie al geïnstalleerd.
Toegang tot Blob Storage autoriseren
U kunt toegang tot Blob Storage vanuit de Azure CLI autoriseren met Microsoft Entra-referenties of met behulp van de toegangssleutel voor het opslagaccount. Het gebruik van Microsoft Entra-referenties wordt aanbevolen. In dit artikel wordt beschreven hoe u Blob Storage-bewerkingen kunt autoriseren met behulp van Microsoft Entra-id.
Azure CLI-opdrachten voor gegevensbewerkingen voor Blob Storage ondersteunen de parameter --auth-mode, waarmee u kunt opgeven hoe een bepaalde bewerking moet worden geautoriseerd. Stel de --auth-mode parameter in om login te autoriseren met Microsoft Entra-referenties. Zie Toegang verlenen tot blob- of wachtrijgegevens met Azure CLI voor meer informatie.
Alleen Blob Storage-gegevensbewerkingen ondersteunen de parameter --auth-mode. Beheerbewerkingen, zoals het maken van een resourcegroep of opslagaccount, gebruiken automatisch Microsoft Entra-referenties voor autorisatie.
Meld u om te beginnen aan bij uw Azure-account met az login.
az login
Een brongroep maken
Maak een Azure-resourcegroep met de opdracht az group create. Een resourcegroep is een logische container waarin Azure-resources worden geïmplementeerd en beheerd.
Vergeet niet om de waarden van de tijdelijke aanduidingen tussen de punthaken te vervangen door uw eigen waarden:
az group create \
--name <resource-group> \
--location <location>
Een opslagaccount maken
Maak een algemeen opslagaccount met de opdracht az storage account create. Het algemeen opslagaccount kan voor alle vier de services worden gebruikt: blobs, bestanden, tabellen en wachtrijen.
Vergeet niet om de waarden van de tijdelijke aanduidingen tussen de punthaken te vervangen door uw eigen waarden:
az storage account create \
--name <storage-account> \
--resource-group <resource-group> \
--location <location> \
--sku Standard_ZRS \
--encryption-services blob
Een container maken
Blobs worden altijd naar een container geüpload. U kunt groepen blobs ordenen in containers net zoals u bestanden op uw computer in mappen ordent. Gebruik de opdracht az storage container create om een container te maken voor het opslaan van blobs.
In het volgende voorbeeld wordt uw Microsoft Entra-account gebruikt om de bewerking te autoriseren om de container te maken. Voordat u de container maakt, moet u de rol Storage Blob Data Contributor aan uzelf toewijzen. Zelfs als u de eigenaar van het account bent, hebt u expliciete machtigingen nodig om gegevensbewerkingen uit te voeren voor het opslagaccount. Zie Een Azure-rol toewijzen voor toegang tot blobgegevens voor meer informatie over het toewijzen van Azure-rollen.
Vergeet niet om de waarden van de tijdelijke aanduidingen tussen de punthaken te vervangen door uw eigen waarden:
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
Belangrijk
Het kan enkele minuten duren voordat Azure-roltoewijzingen worden doorgegeven.
U kunt ook de sleutel voor het opslagaccount gebruiken om de bewerking voor het maken van de container te autoriseren. Zie Toegang verlenen tot blob- of wachtrijgegevens met Azure CLI voor meer informatie over het autoriseren van gegevensbewerkingen met Azure CLI.
Blob uploaden
Blob-opslag ondersteunt blok-blobs, toevoeg-blobs en pagina-blobs. In de voorbeelden van deze quickstart wordt getoond hoe u blok-blobs gebruikt.
Maak eerst een bestand om naar een blok-blob te uploaden. Als u Azure Cloud Shell gebruikt, gebruikt u de volgende opdracht om een bestand te maken:
vi helloworld
Wanneer het bestand wordt geopend, drukt u op Insert. Typ Hallo wereld en druk op Esc. Typ vervolgens :x en druk op Enter.
In dit voorbeeld wordt met de opdracht az storage blob upload een blob geüpload naar de container die u in de laatste stap hebt gemaakt. Het is niet nodig om een bestandspad op te geven omdat het bestand is gemaakt in de hoofdmap. Vergeet niet om de waarden van de tijdelijke aanduidingen tussen de punthaken te vervangen door uw eigen waarden:
az storage blob upload \
--account-name <storage-account> \
--container-name <container> \
--name myFile.txt \
--file myFile.txt \
--auth-mode login
Met deze bewerking wordt de blob gemaakt als deze nog niet bestaat, of overschreven als dat wel het geval is. Upload zoveel bestanden als u nodig hebt, voordat u doorgaat.
Wanneer u een blob uploadt met behulp van de Azure CLI, worden de respectieve REST API-aanroepen via http- en https-protocollen uitgevoerd.
Als u meerdere bestanden tegelijk wilt uploaden, kunt u de opdracht az storage blob upload-batch gebruiken.
Blobs in een container vermelden
Gebruik de opdracht az storage blob list om de blobs in de container weer te geven. Vergeet niet om de waarden van de tijdelijke aanduidingen tussen de punthaken te vervangen door uw eigen waarden:
az storage blob list \
--account-name <storage-account> \
--container-name <container> \
--output table \
--auth-mode login
Blob downloaden
Gebruik de opdracht az storage blob download om de blob te downloaden die u eerder hebt geüpload. Vergeet niet om de waarden van de tijdelijke aanduidingen tussen de punthaken te vervangen door uw eigen waarden:
az storage blob download \
--account-name <storage-account> \
--container-name <container> \
--name myFile.txt \
--file <~/destination/path/for/file> \
--auth-mode login
Gegevensoverdracht met AzCopy
Het AzCopy-opdrachtregelprogramma biedt high-performance, scriptbare gegevensoverdracht voor Azure Storage. U kunt met AzCopy gegevens overzetten naar en van Blob Storage en Azure Files. Zie Aan de slag met AzCopy voor meer informatie over AzCopy v10, de nieuwste versie van AzCopy. Zie Gegevens overzetten met AzCopy en Blob Storage voor meer informatie over het gebruik van AzCopy v10 met Blob Storage.
In het volgende voorbeeld wordt AzCopy gebruikt om een lokaal bestand te uploaden naar een blob. Vergeet niet om de voorbeeldwaarden te vervangen door uw eigen waarden:
azcopy login
azcopy copy 'C:\myDirectory\myFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myFile.txt'
Resources opschonen
Als u de resources wilt verwijderen die u hebt gemaakt als onderdeel van deze quickstart, inclusief het opslagaccount, verwijdert u de resourcegroep met behulp van de opdracht az group delete. Vergeet niet om de waarden van de tijdelijke aanduidingen tussen de punthaken te vervangen door uw eigen waarden:
az group delete \
--name <resource-group> \
--no-wait
Volgende stappen
In deze quickstart hebt u geleerd hoe u bestanden kunt overzetten tussen een lokaal bestandssysteem en een container in Azure Blob Storage. Selecteer hieronder een optie voor meer informatie over het werken met Blob Storage met behulp van Azure CLI.