Share via


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

  • 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.