Erste Schritte mit Azure Blob Storage und Go

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

In diesem Artikel erfahren Sie, wie Sie mithilfe des Azure Blob Storage-Clientmoduls für Go eine Verbindung mit Azure Blob Storage herstellen. Nach der Verbindung kann Ihr Code Container, Blobs und Features des Blob Storage-Diensts verwenden.

API-Referenzdokumentation | Quellcode der Bibliothek | Paket (pkg.go.dev)

Voraussetzungen

• Azure-Abonnement – Erstellen eines kostenlosen Kontos
• Azure Storage-Konto – Erstellen eines Speicherkontos
• Go 1.18+

Einrichten des Projekts

In diesem Abschnitt wird beschrieben, wie ein Projekt zur Verwendung mit dem Azure Blob Storage-Clientmodul für Go vorbereitet wird.

Verwenden Sie in GOPATH den folgenden Befehl, um das Modul azblob zu installieren:

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

Um sich mit Microsoft Entra ID zu authentifizieren (empfohlen), installieren Sie das azidentity-Modul mit dem folgenden Befehl:

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

Öffnen Sie dann Ihre Codedatei, und fügen Sie die erforderlichen Importpfade hinzu. In diesem Beispiel fügen Sie Ihrer GO-Datei Folgendes hinzu:

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

Informationen zum Blobclientmodul

• azblob: Enthält die Methoden, die Sie für den Betrieb des Diensts, der Container und der Blobs verwenden können.

Autorisieren des Zugriffs und Herstellen einer Verbindung mit Blob Storage

Um eine Anwendung mit Blob Storage zu verbinden, erstellen Sie ein Clientobjekt mithilfe von azblob.NewClient. Dieses Objekt ist Ihr Ausgangspunkt für die Interaktion mit Datenressourcen auf Speicherkontoebene. Sie können es verwenden, um das Speicherkonto und seine Container zu verwenden.

Weitere Informationen zum Erstellen und Verwalten von Clientobjekten finden Sie unter Erstellen und Verwalten von Clientobjekten, die mit Datenressourcen interagieren.

Sie können ein Clientobjekt mithilfe eines Microsoft Entra-Autorisierungstokens (empfohlen), eines Kontozugriffsschlüssels oder einer SAS (Shared Access Signature) autorisieren.

Microsoft Entra ID (empfohlen)

Um mit Microsoft Entra ID zu autorisieren, müssen Sie einen Sicherheitsprinzipal verwenden. Die folgenden Artikel enthalten Anleitungen zu verschiedenen Authentifizierungsszenarien:

• Authentifizierung in Entwicklungsumgebungen
• Authentifizierung der von Azure gehosteten Apps
• Authentifizierung anhand eines Dienstprinzipal

Autorisieren des Zugriffs mithilfe von DefaultAzureCredential

Eine einfache und sichere Möglichkeit zum Autorisieren des Zugriffs und zum Herstellen einer Verbindung mit Blob Storage ist das Abrufen eines OAuth-Tokens durch Erstellung einer DefaultAzureCredential-Instanz. Anschließend können Sie mithilfe dieser Anmeldeinformationen und azblob.NewClient das Clientobjekt erstellen.

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
}

SAS-Token

Um ein SAS-Token (Shared Access Signature) zu verwenden, fügen Sie das Token an die URL-Zeichenfolge des Kontos an und erstellen das Clientobjekt mithilfe von 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
}

Hinweis

Für Szenarien, in denen SAS (Shared Access Signatures) verwendet werden, empfiehlt Microsoft die Verwendung einer Benutzerdelegierungs-SAS. Eine Benutzerdelegierungs-SAS wird mit Microsoft Entra-Anmeldeinformationen und nicht mithilfe des Kontoschlüssels geschützt. Weitere Informationen finden Sie unter Gewähren von eingeschränktem Zugriff auf Daten mithilfe von SAS (Shared Access Signature).

Kontoschlüssel

Wenn Sie einen freigegebenen Schlüssel des Speicherkontos verwenden möchten, geben Sie den Schlüssel als Zeichenfolge an, und initialisieren Sie ein Clientobjekt mithilfe von 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
}

Sie können ein Clientobjekt auch mithilfe einer Verbindungszeichenfolge erstellen.

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

    return client
}

Informationen zum Abrufen von Kontoschlüsseln und Best Practices-Richtlinien für die ordnungsgemäße Verwaltung und Sicherung Ihrer Schlüssel finden Sie unter Verwalten von Speicherkonto-Zugriffsschlüsseln.

Wichtig

Der Kontozugriffsschlüssel sollte mit Vorsicht verwendet werden. Wenn Ihr Kontozugriffsschlüssel verloren geht oder versehentlich an einem unsicheren Ort gespeichert wird, kann Ihr Dienst anfällig werden. Jeder, der über den Zugriffsschlüssel verfügt, kann Anforderungen für das Speicherkonto autorisieren und hat somit Zugriff auf alle Daten. DefaultAzureCredential bietet erweiterte Sicherheitsfeatures und Vorteile und ist der empfohlene Ansatz zum Verwalten der Autorisierung für Azure-Dienste.

Erstellen Ihrer Anwendung

Wenn Sie Anwendungen für die Arbeit mit Datenressourcen in Azure Blob Storage erstellen, interagiert Ihr Code primär mit drei Ressourcentypen: Speicherkonten, Container und Blobs. Weitere Informationen zu diesen Ressourcentypen, deren Beziehung zueinander und zur Interaktion von Apps mit Ressourcen finden Sie unter Grundlegendes zur Interaktion von Apps mit Blob Storage-Datenressourcen.

In den folgenden Leitfäden wird gezeigt, wie Sie mit Datenressourcen arbeiten und bestimmte Aktionen mithilfe des Azure Blob Storage-Clientmoduls für Go ausführen:

Handbuch	BESCHREIBUNG
Container erstellen	Erstellen von Containern.
Löschen und Wiederherstellen von Containern	Löschen von Containern und Wiederherstellen gelöschter Container, für die vorläufiges Löschen aktiviert ist.
Auflisten von Containern	Auflisten von Containern in einem Konto und der verschiedenen verfügbaren Optionen zum Anpassen einer Auflistung.
Verwalten von Eigenschaften und Metadaten (Container)	Verwalten von Containereigenschaften und -metadaten
Hochladen von Blobs	Erfahren Sie, wie Sie Blobs mithilfe von Zeichenfolgen, Streams, Dateipfaden und anderen Methoden hochladen.
Herunterladen von Blobs	Herunterladen von Blobs mithilfe von Zeichenfolgen, Streams und Dateipfaden.
Auflisten von Blobs	Auflisten von Blobs auf unterschiedliche Weise.
Löschen und Wiederherstellen von Blobs	Löschen von Blobs und Wiederherstellen gelöschter Blobs, wenn das vorläufige Löschen aktiviert ist.
Suchen von Blobs mithilfe von Tags	Festlegen und Abrufen von Tags sowie Verwenden von Tags für die Suche nach Blobs.
Verwalten von Eigenschaften und Metadaten (Blobs)	Verwalten von Containereigenschaften und -metadaten

Hinweis

Die Codebeispiele in diesem Leitfaden sollen Ihnen bei den ersten Schritten mit Azure Blob Storage und Go helfen. Sie sollten die Fehlerbehandlung und Context-Werte so ändern, dass sie den Anforderungen Ihrer Anwendung entsprechen.