Snabbstart: Skapa, ladda ner och lista blobar med Azure CLI
Azure CLI är Azures kommandoradsmiljö för att hantera Azure-resurser. Du kan använda det i din webbläsare med Azure Cloud Shell. Du kan även installera det på macOS, Linux eller Windows och köra det från kommandoraden. I den här snabbstarten lär du dig att använda Azure CLI för att ladda upp och ned data till och från Azure Blob Storage.
Förutsättningar
Du behöver en Azure-prenumeration för att få åtkomst till Azure Storage. Om du inte redan har en prenumeration skapar du ett kostnadsfritt konto innan du börjar.
All åtkomst till Azure Storage sker via ett lagringskonto. För den här snabbstarten skapar du ett lagringskonto med hjälp av Azure-portalen, Azure PowerShell eller Azure CLI. Hjälp med att skapa ett lagringskonto finns i Skapa ett lagringskonto.
Förbereda din miljö för Azure CLI
Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Snabbstart för Bash i Azure Cloud Shell.
Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör i Windows eller macOS kan du köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.
Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Andra inloggningsalternativ finns i Logga in med Azure CLI.
När du uppmanas att installera Azure CLI-tillägget vid första användningen. Mer information om tillägg finns i Använda tillägg med Azure CLI.
Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.
- Den här artikeln kräver version 2.0.46 eller senare av Azure CLI. Om du använder Azure Cloud Shell är den senaste versionen redan installerad.
Auktorisera åtkomst till Blob Storage
Du kan auktorisera åtkomst till Blob Storage från Azure CLI antingen med Microsoft Entra-autentiseringsuppgifter eller med hjälp av åtkomstnyckeln för lagringskontot. Användning av Microsoft Entra-autentiseringsuppgifter rekommenderas. Den här artikeln visar hur du auktoriserar bloblagringsåtgärder med hjälp av Microsoft Entra-ID.
Azure CLI-kommandon för dataåtgärder mot Blob Storage stöder parametern --auth-mode , som gör att du kan ange hur du auktoriserar en viss åtgärd. Ange parametern --auth-mode till login för att auktorisera med Microsoft Entra-autentiseringsuppgifter. Mer information finns i Auktorisera åtkomst till blob- eller ködata med Azure CLI.
Endast bloblagringsdataåtgärder stöder parametern --auth-mode . Hanteringsåtgärder, till exempel att skapa en resursgrupp eller ett lagringskonto, använder automatiskt Microsoft Entra-autentiseringsuppgifter för auktorisering.
Börja med att logga in på ditt Azure-konto med az login.
az login
Skapa en resursgrupp
Skapa en Azure-resursgrupp med kommandot az group create. En resursgrupp är en logisk container där Azure-resurser distribueras och hanteras.
Kom ihåg att ersätta platshållarvärden i vinkelparenteser med dina egna värden:
az group create \
--name <resource-group> \
--location <location>
Skapa ett lagringskonto
Skapa ett allmänt lagringskonto med kommandot az storage account create. Det allmänna lagringskontot kan användas för alla fyra tjänsterna: blobar, filer, tabeller och köer.
Kom ihåg att ersätta platshållarvärden i vinkelparenteser med dina egna värden:
az storage account create \
--name <storage-account> \
--resource-group <resource-group> \
--location <location> \
--sku Standard_ZRS \
--encryption-services blob
Skapa en container
Blobar laddas alltid upp till en container. Du kan ordna grupper av blobar i containrar på liknande sätt som du organiserar dina filer på datorn i mappar. Skapa en behållare för att lagra blobar med kommandot az storage container create.
I följande exempel används ditt Microsoft Entra-konto för att auktorisera åtgärden för att skapa containern. Innan du skapar containern tilldelar du rollen Storage Blob Data Contributor till dig själv. Även om du är kontoägare behöver du explicit behörighet för att utföra dataåtgärder mot lagringskontot. Mer information om hur du tilldelar Azure-roller finns i Tilldela en Azure-roll för åtkomst till blobdata.
Kom ihåg att ersätta platshållarvärden i vinkelparenteser med dina egna värden:
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
Viktigt!
Det kan ta några minuter att sprida Azure-rolltilldelningar.
Du kan också använda lagringskontonyckeln för att auktorisera åtgärden för att skapa containern. Mer information om hur du auktoriserar dataåtgärder med Azure CLI finns i Auktorisera åtkomst till blob- eller ködata med Azure CLI.
Ladda upp en blob
Blob Storage stöder blockblobar, tilläggsblobar och sidblobar. Exemplen i den här snabbstarten visar hur du arbetar med blockblobar.
Skapa först en fil som ska laddas upp till en blockblob. Om du använder Azure Cloud Shell använder du följande kommando för att skapa en fil:
vi helloworld
Tryck på Infoga när filen öppnas. Skriv Hello World och tryck sedan på Esc. Skriv sedan :x och tryck sedan på Retur.
I det här exemplet laddar vi upp en blob till den container som vi skapade i det senaste steget med kommandot az storage blob upload. Det är inte nödvändigt att ange en filsökväg sedan filen skapades i rotkatalogen. Kom ihåg att ersätta platshållarvärden i vinkelparenteser med dina egna värden:
az storage blob upload \
--account-name <storage-account> \
--container-name <container> \
--name myFile.txt \
--file myFile.txt \
--auth-mode login
Den här åtgärden skapar bloben om den inte redan finns, och skriver över den om den finns. Ladda upp så många filer som du vill innan du fortsätter.
När du laddar upp en blob med Hjälp av Azure CLI utfärdar den respektive REST API-anrop via http- och https-protokoll.
Om du vill ladda upp flera filer samtidigt kan du använda kommandot az storage blob upload-batch.
Visa blobar i en container
Lista blobarna i containern med kommandot az storage blob list. Kom ihåg att ersätta platshållarvärden i vinkelparenteser med dina egna värden:
az storage blob list \
--account-name <storage-account> \
--container-name <container> \
--output table \
--auth-mode login
Ladda ned en blob
Använd kommandot az storage blob download för att ladda ned den blob som du laddade upp tidigare. Kom ihåg att ersätta platshållarvärden i vinkelparenteser med dina egna värden:
az storage blob download \
--account-name <storage-account> \
--container-name <container> \
--name myFile.txt \
--file <~/destination/path/for/file> \
--auth-mode login
Dataöverföring med AzCopy
Kommandoradsverktyget AzCopy erbjuder högpresterande, skriptbar dataöverföring för Azure Storage. Du kan använda AzCopy för att överföra data till och från Blob Storage och Azure Files. Mer information om AzCopy v10, den senaste versionen av AzCopy, finns i Komma igång med AzCopy. Mer information om hur du använder AzCopy v10 med Blob Storage finns i Överföra data med AzCopy och Blob Storage.
I följande exempel används AzCopy för att ladda upp en lokal fil till en blob. Kom ihåg att ersätta exempelvärdena med dina egna värden:
azcopy login
azcopy copy 'C:\myDirectory\myFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myFile.txt'
Rensa resurser
Om du vill ta bort de resurser som du skapade som en del av den här snabbstarten, inklusive lagringskontot, tar du bort resursgruppen med kommandot az group delete . Kom ihåg att ersätta platshållarvärden i vinkelparenteser med dina egna värden:
az group delete \
--name <resource-group> \
--no-wait
Nästa steg
I den här snabbstarten har du lärt dig hur du överför filer mellan ett lokalt filsystem och en container i Azure Blob Storage. Om du vill veta mer om hur du arbetar med Blob Storage med hjälp av Azure CLI väljer du ett alternativ nedan.