Aan de slag met Azure Blob Storage en Go

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

In dit artikel leest u hoe u verbinding maakt met Azure Blob Storage met behulp van de Azure Blob Storage-clientmodule voor Go. Zodra de code is verbonden, kan uw code worden uitgevoerd op containers, blobs en functies van de Blob Storage-service.

Broncodepakket voor API-referentiedocumentatiebibliotheek | | (pkg.go.dev)

Vereisten

• Azure-abonnement: u kunt een gratis abonnement nemen
• Azure Storage-account: maak een opslagaccount
• Go 1.18+

Uw project instellen

In deze sectie wordt uitgelegd hoe u een project voorbereidt voor gebruik met de Azure Blob Storage-clientmodule voor Go.

Installeer vanuit uw GOPATH de azblob-module met behulp van de volgende opdracht:

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

Als u wilt verifiëren met Microsoft Entra ID (aanbevolen), installeert u de azidentity module met behulp van de volgende opdracht:

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

Open vervolgens het codebestand en voeg de benodigde importpaden toe. In dit voorbeeld voegen we het volgende toe aan ons GO-bestand :

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

Informatie over de Blob-clientmodule:

• azblob: Bevat de methoden die u kunt gebruiken om te werken op de service, containers en blobs.

Toegang autoriseren en verbinding maken met Blob Storage

Als u een toepassing wilt verbinden met Blob Storage, maakt u een clientobject met behulp van azblob. NewClient. Dit object is het startpunt om te communiceren met gegevensbronnen op het niveau van het opslagaccount. U kunt het gebruiken om te werken op het opslagaccount en de bijbehorende containers.

Zie Clientobjecten maken en beheren die interactie hebben met gegevensbronnen voor meer informatie over het maken en beheren van clientobjecten, inclusief aanbevolen procedures.

U kunt een clientobject autoriseren met behulp van een Microsoft Entra-autorisatietoken (aanbevolen), een toegangssleutel voor een account of een SAS (Shared Access Signature).

Microsoft Entra-id (aanbevolen)

Als u wilt autoriseren met Microsoft Entra-id, moet u een beveiligingsprincipaal gebruiken. De volgende artikelen bevatten richtlijnen voor verschillende verificatiescenario's:

• Verificatie in ontwikkelomgevingen
• Verificatie in door Azure gehoste apps
• Verificatie met een service-principal

Toegang autoriseren met DefaultAzureCredential

Een eenvoudige en veilige manier om toegang te verlenen en verbinding te maken met Blob Storage is door een OAuth-token te verkrijgen door een DefaultAzureCredential-exemplaar te maken. Vervolgens kunt u die referentie gebruiken om het clientobject te maken met behulp van 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
}

SAS-token

Als u een SAS-token (Shared Access Signature) wilt gebruiken, voegt u het token toe aan de url-tekenreeks van het account en maakt u het clientobject met behulp van 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
}

Notitie

Voor scenario's waarin SHARED Access Signatures (SAS) worden gebruikt, raadt Microsoft aan een SAS voor gebruikersdelegering te gebruiken. Een SAS voor gebruikersdelegering wordt beveiligd met Microsoft Entra-referenties in plaats van de accountsleutel. Zie Beperkte toegang verlenen tot gegevens met Shared Access Signatures (SAS) voor meer informatie.

Accountsleutel

Als u een gedeelde sleutel voor een opslagaccount wilt gebruiken, geeft u de sleutel op als een tekenreeks en initialiseert u een clientobject met behulp van 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
}

U kunt ook een clientobject maken met behulp van een verbindingsreeks.

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

    return client
}

Zie Toegangssleutels voor opslagaccounts beheren voor informatie over het verkrijgen van accountsleutels en aanbevolen procedures voor het correct beheren en beveiligen van uw sleutels.

Belangrijk

De toegangssleutel voor het account moet voorzichtig worden gebruikt. Als uw accounttoegangssleutel verloren gaat of per ongeluk op een onveilige locatie is geplaatst, kan uw service kwetsbaar worden. Iedereen met de toegangssleutel kan aanvragen voor het opslagaccount autoriseren en heeft effectief toegang tot alle gegevens. DefaultAzureCredential biedt verbeterde beveiligingsfuncties en voordelen en is de aanbevolen benadering voor het beheren van autorisatie voor Azure-services.

Uw toepassing bouwen

Wanneer u toepassingen bouwt om te werken met gegevensresources in Azure Blob Storage, communiceert uw code voornamelijk met drie resourcetypen: opslagaccounts, containers en blobs. Voor meer informatie over deze resourcetypen, hoe deze zich verhouden tot elkaar en hoe apps communiceren met resources, raadpleegt u Begrijpen hoe apps communiceren met Blob Storage-gegevensresources.

De volgende handleidingen laten zien hoe u met gegevensbronnen kunt werken en specifieke acties kunt uitvoeren met behulp van de Azure Blob Storage-clientmodule voor Go:

Guide	Beschrijving
Een container maken	Containers maken.
Containers verwijderen en herstellen	Verwijder containers en als voorlopig verwijderen is ingeschakeld, herstelt u verwijderde containers.
Containers weergeven	Lijst met containers in een account en de verschillende opties die beschikbaar zijn om een vermelding aan te passen.
Eigenschappen en metagegevens beheren (containers)	Containereigenschappen en metagegevens beheren.
Blobs uploaden	Meer informatie over het uploaden van blobs met behulp van tekenreeksen, streams, bestandspaden en andere methoden.
Blobs downloaden	Download blobs met behulp van tekenreeksen, streams en bestandspaden.
Blobs vermelden	Geef blobs op verschillende manieren weer.
Blobs verwijderen en herstellen	Verwijder blobs en als voorlopig verwijderen is ingeschakeld, herstelt u verwijderde blobs.
Blobs zoeken met behulp van tags	Stel tags in en haal ze op en gebruik tags om blobs te zoeken.
Eigenschappen en metagegevens beheren (blobs)	Containereigenschappen en metagegevens beheren.

Notitie

De codevoorbeelden in deze handleiding zijn bedoeld om u te helpen aan de slag te gaan met Azure Blob Storage en Go. U moet foutafhandeling en Context -waarden wijzigen om te voldoen aan de behoeften van uw toepassing.