Introduzione a Archiviazione BLOB di Azure e Go

• .NET
• Java
• JavaScript
• TypeScript
• Python
• Go

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

Documentazione | di riferimento api Pacchetto del codice | sorgente della libreria (pkg.go.dev)

Prerequisiti

• Sottoscrizione di Azure: creare un account gratuito
• Account di archiviazione di Azure: creare un account di archiviazione
• Vai 1.18+

Impostare il progetto

Questa sezione illustra come preparare un progetto da usare con il modulo client Archiviazione BLOB di Azure per Go.

Da GOPATH installare il modulo azblob usando il comando seguente:

go get github.com/Azure/azure-sdk-for-go/sdk/storage/azblob

Per eseguire l'autenticazione con Microsoft Entra ID (scelta consigliata), installare il azidentity modulo usando il comando seguente:

go get github.com/Azure/azure-sdk-for-go/sdk/azidentity

Aprire quindi il file di codice e aggiungere i percorsi di importazione necessari. In questo esempio si aggiunge il codice seguente al file con estensione go :

import (
    "github.com/Azure/azure-sdk-for-go/sdk/storage/azblob"
    "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
)

Informazioni sul modulo client BLOB:

• azblob: contiene i metodi che è possibile usare per operare sul servizio, sui contenitori e sui BLOB.

Autorizzare l'accesso e connettersi ad Archiviazione BLOB

Per connettere un'applicazione all'archiviazione BLOB, creare un oggetto client usando azblob. NewClient. 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.

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 client usando un token di autorizzazione Microsoft Entra (scelta consigliata), una chiave di accesso all'account o una firma di accesso condiviso.

ID Microsoft Entra (scelta consigliata)

Per autorizzare con Microsoft Entra ID, è necessario usare un'entità di sicurezza. Gli articoli seguenti forniscono indicazioni su diversi scenari di autenticazione:

• Autenticazione negli ambienti di sviluppo
• Autenticazione nelle app ospitate in Azure
• Autenticazione con un'entità servizio

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 l'oggetto client usando azblob. NewClient.

func getServiceClientTokenCredential(accountURL string) *azblob.Client {
    // Create a new service client with token credential
    credential, err := azidentity.NewDefaultAzureCredential(nil)
    handleError(err)

    client, err := azblob.NewClient(accountURL, credential, nil)
    handleError(err)

    return client
}

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 e creare l'oggetto client usando azblob. NewClientWithNoCredential.

func getServiceClientSAS(accountURL string, sasToken string) *azblob.Client {
    // Create a new service client with an existing SAS token

    // Append the SAS to the account URL with a "?" delimiter
    accountURLWithSAS := fmt.Sprintf("%s?%s", accountURL, sasToken)

    client, err := azblob.NewClientWithNoCredential(accountURLWithSAS, nil)
    handleError(err)

    return client
}

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. Per altre informazioni, vedere Concedere accesso limitato ai dati con firme di accesso condiviso.

Chiave dell'account

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

func getServiceClientSharedKey(accountName string, accountKey string) *azblob.Client {
    // Create a new service client with shared key credential
    credential, err := azblob.NewSharedKeyCredential(accountName, accountKey)
    handleError(err)

    accountURL := fmt.Sprintf("https://%s.blob.core.windows.net", accountName)

    client, err := azblob.NewClientWithSharedKeyCredential(accountURL, credential, nil)
    handleError(err)

    return client
}

È anche possibile creare un oggetto client usando un stringa di connessione.

func getServiceClientConnectionString(connectionString string) *azblob.Client {
    // Create a new service client with connection string
    client, err := azblob.NewClientFromConnectionString(connectionString, nil)
    handleError(err)

    return client
}

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'applicazione

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 usare le risorse dati ed eseguire azioni specifiche usando il modulo client Archiviazione BLOB di Azure per Go:

Guida	Descrizione
Creare un contenitore	Creare contenitori.
Eliminare e ripristinare contenitori	Eliminare contenitori e, se l'eliminazione temporanea è abilitata, ripristinare i contenitori eliminati.
Elencare i contenitori	Elencare i contenitori in un account e le varie opzioni disponibili per personalizzare un elenco.
Gestire proprietà e metadati (contenitori)	Gestire le proprietà e i metadati del contenitore.
Caricare i BLOB	Informazioni su come caricare BLOB usando stringhe, flussi, percorsi di file e altri metodi.
Scaricare BLOB	Scaricare i BLOB usando stringhe, flussi e percorsi di file.
Elencare i BLOB	Elencare i BLOB in modi diversi.
Eliminare e ripristinare i BLOB	Eliminare BLOB e, se l'eliminazione temporanea è abilitata, ripristinare i BLOB eliminati.
Gestire proprietà e metadati (BLOB)	Gestire le proprietà e i metadati del contenitore.

Nota

Gli esempi di codice in questa guida sono utili per iniziare a usare Archiviazione BLOB di Azure e Go. È consigliabile modificare la gestione degli errori e Context i valori per soddisfare le esigenze dell'applicazione.