Introduzione a Archiviazione BLOB di Azure e JavaScript o TypeScript

• .NET
• Java
• JavaScript
• Python
• Go

Questo articolo illustra come connettersi a Archiviazione BLOB di Azure usando la libreria client Archiviazione BLOB di Azure per JavaScript. Dopo la connessione, il codice può operare su contenitori, BLOB e funzionalità del servizio di archiviazione BLOB.

Riferimento API | Pacchetto (npm) | Codice sorgente della libreria | Esempi | Inviare feedback

Prerequisiti

• Sottoscrizione di Azure: creare un account gratuito
• Account di archiviazione di Azure: creare un account di archiviazione
• Node.js LTS
• TypeScript, se applicabile
• Per le applicazioni client (browser) sono necessari strumenti per la creazione di bundle.

Impostare il progetto

Questa sezione illustra come preparare un progetto da usare con la libreria client Archiviazione BLOB di Azure per JavaScript.

Aprire un prompt dei comandi e passare alla cartella del progetto. Modificare <project-directory> con il nome della cartella:

cd <project-directory>

Se nella directory non è già presente un file package.json, inizializzare il progetto per crearlo:

npm init -y

Nella directory del progetto installare i pacchetti per le librerie client di Archiviazione BLOB di Azure e Azure Identity usando i npm install comandi o yarn add . Il pacchetto @azure/identity è necessario per le connessioni senza password ai servizi di Azure.

JavaScript

npm install @azure/storage-blob @azure/identity

TypeScript

npm install typescript @azure/storage-blob @azure/identity

Autorizzare l'accesso e connettersi ad Archiviazione BLOB

Per connettere un'applicazione ad Archiviazione BLOB, creare un'istanza della classe BlobServiceClient. Questo oggetto è il punto di partenza per interagire con le risorse dati a livello di account di archiviazione. È possibile usarlo per operare sull'account di archiviazione e sui relativi contenitori. È anche possibile usare il client del servizio per creare client contenitore o client BLOB, in base alla risorsa da usare.

Per altre informazioni sulla creazione e la gestione di oggetti client, incluse le procedure consigliate, vedere Creare e gestire oggetti client che interagiscono con le risorse dati.

È possibile autorizzare un oggetto BlobServiceClient usando un token di autorizzazione di Microsoft Entra, una chiave di accesso all'account o una firma di accesso condiviso. Per una protezione ottimale, Microsoft consiglia di usare Microsoft Entra ID con identità gestite per autorizzare le richieste sui dati BLOB. Per ulteriori informazioni, vedere Autorizzare l'accesso ai BLOB usando Microsoft Entra ID.

Microsoft Entra ID (scelta consigliata)

Per autorizzare con Microsoft Entra ID è necessario usare un'entità di sicurezza. Il tipo di entità di sicurezza da usare dipende dalla posizione in cui viene eseguita l'applicazione. Usare la tabella seguente come guida:

Posizione in cui viene eseguita l'applicazione	Entità di sicurezza principale	Linee guida
Computer locale (sviluppo e test)	Entità servizio	Per informazioni su come registrare l'app, configurare un gruppo di Microsoft Entra, assegnare ruoli e configurare le variabili di ambiente, vedere Autorizzare l'accesso usando le entità servizio per sviluppatori
Computer locale (sviluppo e test)	Identità utente	Per informazioni su come configurare un gruppo di Microsoft Entra, assegnare ruoli e accedere ad Azure, vedere Autorizzare l'accesso usando le credenziali per sviluppatori
Ospitata in Azure	Identità gestita	Per informazioni su come abilitare l'identità gestita e assegnare ruoli, vedere Autorizzare l'accesso dalle app ospitate in Azure usando un'identità gestita
Ospitata all'esterno di Azure (ad esempio, app locali)	Entità servizio	Per informazioni su come registrare l'app, assegnare ruoli e configurare le variabili di ambiente, vedere Autorizzare l'accesso dalle app locali usando un'entità servizio dell'applicazione

Autorizzare l'accesso con DefaultAzureCredential

Un modo semplice e sicuro per autorizzare l'accesso e connettersi ad Archiviazione BLOB consiste nell'ottenere un token OAuth creando un'istanza di DefaultAzureCredential. È quindi possibile usare tale credenziale per creare un BlobServiceClient oggetto .

Nell'esempio seguente viene creato un BlobServiceClient oggetto utilizzando DefaultAzureCredential:

const accountName = "<account-name>";
const accountURL = `https://${accountName}.blob.core.windows.net`;
const blobServiceClient = new BlobServiceClient(
  accountURL,
  new DefaultAzureCredential()
);

Questo esempio di codice può essere usato per progetti JavaScript o TypeScript.

Token della firma di accesso condiviso

Per usare un token di firma di accesso condiviso (SAS), aggiungere il token alla stringa dell'URL dell'account separata da un ? delimitatore. Creare quindi un BlobServiceClient oggetto con l'URL.

const accountName = "<account-name>";
const sasToken = "<sas-token>";
const accountURL = `https://${accountName}.blob.core.windows.net?${sasToken}`;
const blobServiceClient = new BlobServiceClient(accountURL);

Questo esempio di codice può essere usato per progetti JavaScript o TypeScript.

Per altre informazioni sulla generazione e la gestione dei token di firma di accesso condiviso, vedere gli articoli seguenti:

• Concedere accesso limitato alle risorse di Archiviazione di Azure tramite firme di accesso condiviso
• Creare una firma di accesso condiviso dell'account con JavaScript
• Creare una firma di accesso condiviso del servizio con JavaScript
• Creare una firma di accesso condiviso di delega utente con JavaScript

Nota

Per gli scenari in cui vengono utilizzate le firme di accesso condiviso (SAS), Microsoft consiglia di usare una firma di accesso condiviso di delega utente. Una firma di accesso condiviso della delega utente è protetta con le credenziali di Microsoft Entra, anziché dalla chiave dell'account.

Chiave dell'account

Per usare una chiave condivisa dell'account di archiviazione, specificare la chiave come stringa e inizializzare un BlobServiceClient oggetto .

const credential = new StorageSharedKeyCredential(accountName, accountKey);
const blobServiceClient = new BlobServiceClient(
  `https://${accountName}.blob.core.windows.net`,
  credential
);

Questo esempio di codice può essere usato per progetti JavaScript o TypeScript.

È anche possibile creare un oggetto BlobServiceClient usando una stringa di connessione.

const blobServiceClient = BlobServiceClient.fromConnectionString(connectionString);

Per informazioni su come ottenere le chiavi dell'account e per ottenere linee guida sulle procedure consigliate per gestire e proteggere correttamente le chiavi, vedere Gestire le chiavi di accesso dell'account di archiviazione.

Importante

La chiave di accesso dell'account deve essere usata con cautela. Se la chiave di accesso dell'account va persa o viene accidentalmente inserita in una posizione non sicura, il servizio può diventare vulnerabile. Chiunque abbia la chiave di accesso può autorizzare richieste all'account di archiviazione e di fatto ha accesso a tutti i dati. DefaultAzureCredential offre vantaggi e funzionalità avanzate per la sicurezza ed è l'approccio consigliato per la gestione dell'autorizzazione per i servizi di Azure.

Compilare l'app

Quando si creano applicazioni per lavorare con le risorse dati in Archiviazione BLOB di Azure, il codice interagisce principalmente con tre tipi di risorse: account di archiviazione, contenitori e BLOB. Per altre informazioni su questi tipi di risorse, sul modo in cui sono correlate e sul modo in cui le app interagiscono con le risorse, vedere Informazioni sull'interazione delle app con le risorse dati di Archiviazione BLOB.

Le guide seguenti illustrano come accedere ai dati ed eseguire azioni specifiche usando la libreria client Archiviazione di Azure per JavaScript:

Guida	Descrizione
Configurare un criterio di ripetizione	Implementare criteri di ripetizione per le operazioni client.
Copiare BLOB	Copiare un BLOB da una posizione a un'altra.
Creare un contenitore	Creare contenitori BLOB.
Creare una firma di accesso condiviso di delega utente	Creare una firma di accesso condiviso di delega utente per un contenitore o un BLOB.
Creare e gestire lease di BLOB	Impostare e gestire un blocco su un BLOB.
Creare e gestire lease di contenitori	Impostare e gestire un blocco su un contenitore.
Eliminare e ripristinare	Eliminare i BLOB e ripristinare i BLOB eliminati temporanea.
Eliminare e ripristinare contenitori	Eliminare i contenitori e ripristinare i contenitori eliminati temporanea.
Scaricare BLOB	Scaricare i BLOB usando stringhe, flussi e percorsi di file.
Trovare BLOB usando tag	Impostare e recuperare tag e usare tag per trovare i BLOB.
Elencare i BLOB	Elencare i BLOB in modi diversi.
Elencare i contenitori	Elencare i contenitori in un account e le varie opzioni disponibili per personalizzare un elenco.
Gestire proprietà e metadati (BLOB)	Ottenere e impostare le proprietà e i metadati per i BLOB.
Gestire proprietà e metadati (contenitori)	Ottenere e impostare le proprietà e i metadati per i contenitori.
Ottimizzazione delle prestazioni per i trasferimenti di dati	Ottimizzare le prestazioni di AzCopy per le operazioni di trasferimento dei dati.
Impostare o modificare il livello di accesso di un BLOB	Impostare o modificare il livello di accesso di un BLOB in blocchi.
Caricare i BLOB	Informazioni su come caricare BLOB usando stringhe, flussi, percorsi di file e altri metodi.