Quickstart: Blobs maken, downloaden en vermelden met Azure CLI

Azure CLI is de opdrachtregelervaring 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 de Azure CLI gebruikt om gegevens te uploaden en te downloaden van en naar Azure Blob Storage.

Vereiste voorwaarden

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.

Uw omgeving voorbereiden voor de Azure CLI

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie Aan de slag met Azure Cloud Shell voor meer informatie.

  

• Als je de voorkeur geeft aan het lokaal uitvoeren van CLI-referentiecommando's, installeer dan de Azure CLI. Als je op Windows of macOS werkt, overweeg dan om Azure CLI in een Docker-container uit te voeren. Voor meer informatie, zie Hoe u de Azure CLI in een Docker-container kunt uitvoeren.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met de opdracht az login. Om het authenticatieproces te voltooien, volgt u de stappen die op uw terminal worden weergegeven. Zie Verifiëren bij Azure met behulp van Azure CLI voor andere aanmeldingsopties.

  • Wanneer u daarom wordt gevraagd, installeer de Azure CLI-extensie bij het eerste gebruik. Zie Extensies gebruiken en beheren met de Azure CLIvoor meer informatie over extensies.

  • Voer az version uit om de geïnstalleerde versie en de afhankelijke bibliotheken te vinden. Voer az upgrade uit om naar de nieuwste versie te upgraden.

• Voor dit artikel is versie 2.0.46 of hoger van De 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 --auth-mode parameter, waarmee u kunt opgeven hoe u een bepaalde bewerking kunt autoriseren. Stel de --auth-mode-parameter in op login om te autoriseren met Microsoft Entra-referenties. Zie Toegang verlenen tot blob- of wachtrijgegevens met Azure CLI voor meer informatie.

Alleen de blob-opslaggegevensbewerkingen ondersteunen de --auth-mode parameter. 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 hoekige haken te vervangen door uw eigen waarden.

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

Een opslagaccount maken

Maak een opslagaccount voor algemeen gebruik met de opdracht az storage account create . Het opslagaccount voor algemeen gebruik kan worden gebruikt voor alle vier de services: blobs, bestanden, tabellen en wachtrijen.

Vergeet niet om de waarden van de tijdelijke aanduidingen tussen de hoekige haken 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

Maak een container aan

Blobs worden altijd naar een container geüpload. U kunt groepen blobs ordenen in containers die vergelijkbaar zijn met de manier waarop u uw 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 Inzender voor opslagblobgegevens aan uzelf toewijzen. Zelfs als u de accounteigenaar 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 hoekige haken 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

U kunt ook de sleutel van het opslagaccount gebruiken om de bewerking te autoriseren om de container te maken. Zie Toegang tot blob- of wachtrijgegevens autoriseren met Azure CLI voor meer informatie over het autoriseren van gegevensbewerkingen met Azure CLI.

Een blob uploaden

Blob-opslag ondersteunt blok-blobs, toevoeg-blobs en pagina-blobs. In de voorbeelden in deze quickstart ziet u hoe u met blokblobs kunt werken.

Maak eerst een bestand om te uploaden naar een blokblob. 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 Invoegen. Typ Hallo wereld en druk op Esc. Typ vervolgens :x en druk op Enter.

In dit voorbeeld uploadt u een blob naar de container die u in de laatste stap hebt gemaakt met behulp van de opdracht az storage blob upload . 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 hoekige haken 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 en overschrijft deze 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.

De blobs van een container weergeven

Geef de blobs in de container weer met de opdracht az storage blob list . Vergeet niet om de waarden van de tijdelijke aanduidingen tussen de hoekige haken te vervangen door uw eigen waarden.

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

Een 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 hoekige haken 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 geeft hoogwaardige prestaties en 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'

De hulpbronnen 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 hoekige haken 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 overdraagt 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.