Avvio rapido: Creare, scaricare ed elencare BLOB con l'interfaccia della riga di comando di Azure
L'interfaccia della riga di comando di Azure è l'esperienza della riga di comando di Azure per gestire le risorse di Azure. È possibile usarla nel browser con Azure Cloud Shell. È anche possibile installarla in macOS, Linux o Windows ed eseguirla dalla riga di comando. Questa guida introduttiva spiega come usare l'interfaccia della riga di comando di Azure per caricare e scaricare dati in Archiviazione BLOB di Azure.
Prerequisiti
Per accedere ad Archiviazione di Azure è necessaria una sottoscrizione di Azure. Se non si ha già una sottoscrizione, creare un account gratuito prima di iniziare.
L'accesso ad Archiviazione di Azure viene eseguito esclusivamente tramite un account di archiviazione. Per questa guida introduttiva, creare rapidamente un account di archiviazione usando il portale di Azure, Azure PowerShell o l'interfaccia della riga di comando di Azure. Per informazioni sulla creazione di un account di archiviazione, vedere Creare un account di archiviazione.
Preparare l'ambiente per l'interfaccia della riga di comando di Azure
Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido per Bash in Azure Cloud Shell.
Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.
Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere con l'interfaccia della riga di comando di Azure.
Quando richiesto, installare l'estensione dell'interfaccia della riga di comando di Azure al primo uso. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.
Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.
- Questo articolo richiede l'interfaccia della riga di comando di Azure versione 2.0.46 o successiva. Se si usa Azure Cloud Shell, la versione più recente è già installata.
Autorizzare l'accesso all'archiviazione BLOB
È possibile autorizzare l'accesso all'archiviazione BLOB dall'interfaccia della riga di comando di Azure con le credenziali di Microsoft Entra o usando la chiave di accesso dell'account di archiviazione. È consigliabile usare le credenziali di Microsoft Entra. Questo articolo illustra come autorizzare le operazioni di archiviazione BLOB usando Microsoft Entra ID.
I comandi dell'interfaccia della riga di comando di Azure per le operazioni sui dati dell'archiviazione BLOB supportano il parametro --auth-mode, che consente di specificare come autorizzare una determinata operazione. Impostare il --auth-mode parametro su login per autorizzare con le credenziali di Microsoft Entra. Per altre informazioni, vedere Autorizzare l'accesso ai dati di BLOB o code con l'interfaccia della riga di comando di Azure.
Solo le operazioni sui dati dell'archiviazione BLOB supportano il parametro --auth-mode. Le operazioni di gestione, ad esempio la creazione di un gruppo di risorse o un account di archiviazione, usano automaticamente le credenziali di Microsoft Entra per l'autorizzazione.
Per iniziare, accedere all'account Azure con il comando az login.
az login
Creare un gruppo di risorse
Creare un gruppo di risorse di Azure con il comando az group create. Un gruppo di risorse è un contenitore logico in cui vengono distribuite e gestite le risorse di Azure.
È necessario ricordare di sostituire i valori segnaposto tra parentesi uncinate con i valori personalizzati:
az group create \
--name <resource-group> \
--location <location>
Creare un account di archiviazione
Creare un account di archiviazione per utilizzo generico con il comando az storage account create. L'account di archiviazione per utilizzo generico può essere usato per tutti e quattro i servizi: BLOB, file, tabelle e code.
È necessario ricordare di sostituire i valori segnaposto tra parentesi uncinate con i valori personalizzati:
az storage account create \
--name <storage-account> \
--resource-group <resource-group> \
--location <location> \
--sku Standard_ZRS \
--encryption-services blob
Creazione di un contenitore
Gli elementi BLOB vengono sempre caricati in un contenitore. È possibile organizzare i gruppi di BLOB in contenitori, modo simile a come si organizzano i file in cartelle sul computer. Creare un contenitore per l'archiviazione di BLOB con il comando az storage container create.
Nell'esempio seguente viene usato l'account Microsoft Entra per autorizzare l'operazione a creare il contenitore. Prima di creare il contenitore, assegnare il ruolo Collaboratore ai dati dei BLOB di archiviazione a se stessi. Anche se si è il proprietario dell'account, sono necessarie autorizzazioni esplicite per eseguire operazioni sui dati nell'account di archiviazione. Per altre informazioni sull'assegnazione dei ruoli di Azure, vedere Assegnare un ruolo di Azure per l'accesso ai dati BLOB.
È necessario ricordare di sostituire i valori segnaposto tra parentesi uncinate con i valori personalizzati:
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
Importante
La propagazione delle assegnazioni dei ruoli può richiedere alcuni minuti.
È anche possibile usare la chiave dell'account di archiviazione per autorizzare l'operazione di creazione del contenitore. Per altre informazioni sull'autorizzazione delle operazioni sui dati con l'interfaccia della riga di comando di Azure, vedere Autorizzare l'accesso ai dati di BLOB o code con l'interfaccia della riga di comando di Azure.
Caricare un BLOB
L'archiviazione BLOB supporta BLOB in blocchi, BLOB di aggiunta e BLOB di pagine. Gli esempi in questa Guida di avvio rapido illustrano come usare i BLOB in blocchi.
Creare prima di tutto un file da caricare in un BLOB in blocchi. Se si usa Azure Cloud Shell, usare il comando seguente per creare un file:
vi helloworld
Quando si apre il file, premere INS. Digitare Hello world, quindi premere ESC. Digitare quindi :x, quindi premere INVIO.
In questo esempio si usa il comando az storage blob upload per caricare un BLOB nel contenitore creato nel passaggio precedente. Non è necessario specificare un percorso perché il file è stato creato nella directory radice. È necessario ricordare di sostituire i valori segnaposto tra parentesi uncinate con i valori personalizzati:
az storage blob upload \
--account-name <storage-account> \
--container-name <container> \
--name myFile.txt \
--file myFile.txt \
--auth-mode login
Questa operazione crea il BLOB se non esiste o lo sovrascrive se esiste già. Caricare tutti i file desiderati prima di continuare.
Quando si carica un BLOB usando l'interfaccia della riga di comando di Azure, rilascia le rispettive chiamate API REST tramite protocolli http e https.
Per caricare più file contemporaneamente, è possibile usare il comando az storage blob upload-batch.
Elencare i BLOB in un contenitore
Elencare i BLOB nel contenitore con il comando az storage blob list. È necessario ricordare di sostituire i valori segnaposto tra parentesi uncinate con i valori personalizzati:
az storage blob list \
--account-name <storage-account> \
--container-name <container> \
--output table \
--auth-mode login
Scaricare un BLOB
Usare il comando az storage blob download per scaricare il BLOB caricato in precedenza. È necessario ricordare di sostituire i valori segnaposto tra parentesi uncinate con i valori personalizzati:
az storage blob download \
--account-name <storage-account> \
--container-name <container> \
--name myFile.txt \
--file <~/destination/path/for/file> \
--auth-mode login
Trasferimento dati con AzCopy
L'utilità da riga di comando AzCopy offre il trasferimento dei dati di script a elevate prestazioni per Archiviazione di Azure. È possibile usare AzCopy per trasferire i dati da e verso Archiviazione BLOB e File di Azure. Per altre informazioni su AzCopy v10, la versione più recente, vedere Introduzione ad AzCopy. Per informazioni sull'uso di AzCopy v10 con archiviazione BLOB, vedere Trasferire dati con AzCopy e archiviazione BLOB.
Gli esempi seguenti usano AzCopy per caricare un file locale in un BLOB. Ricordarsi di sostituire i valori dell'esempio con i propri valori:
azcopy login
azcopy copy 'C:\myDirectory\myFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myFile.txt'
Pulire le risorse
Se si vogliono eliminare le risorse create come parte di questo argomento di avvio rapido, incluso l'account di archiviazione, eliminare il gruppo di risorse usando il comando az group delete. È necessario ricordare di sostituire i valori segnaposto tra parentesi uncinate con i valori personalizzati:
az group delete \
--name <resource-group> \
--no-wait
Passaggi successivi
In questa Guida di avvio rapido è stato descritto il trasferimento di file tra un file system locale e un contenitore in Archiviazione BLOB di Azure. Per altre informazioni sull'uso dell'archiviazione BLOB tramite l'interfaccia della riga di comando di Azure, selezionare un'opzione di seguito.