Kom igång med Azure Blob Storage och Go

Artikel
10/31/2024

Den här artikeln visar hur du ansluter till Azure Blob Storage med hjälp av Azure Blob Storage-klientmodulen för Go. När koden är ansluten kan den fungera på containrar, blobar och funktioner i Blob Storage-tjänsten.

API-referensdokumentationEns källkodspaket | för bibliotek (pkg.go.dev) |

Förutsättningar

Azure-prenumeration – skapa en kostnadsfritt
Azure Storage-konto – skapa ett lagringskonto
Gå 1.18+

Konfigurera projektet

Det här avsnittet beskriver hur du förbereder ett projekt för att arbeta med Azure Blob Storage-klientmodulen för Go.

Från din GOPATH installerar du azblob-modulen med följande kommando:

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

Om du vill autentisera med Microsoft Entra-ID (rekommenderas) installerar du modulen azidentity med följande kommando:

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

Öppna sedan kodfilen och lägg till nödvändiga importsökvägar. I det här exemplet lägger vi till följande i . go-filen :

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

Information om blobklientmodul:

azblob: Innehåller de metoder som du kan använda för att arbeta med tjänsten, containrar och blobar.

Auktorisera åtkomst och ansluta till Blob Storage

Om du vill ansluta en app till Blob Storage skapar du ett klientobjekt med azblob . NewClient. Det här objektet är startpunkten för att interagera med dataresurser på lagringskontonivå. Du kan använda den för att arbeta med lagringskontot och dess containrar.

Mer information om hur du skapar och hanterar klientobjekt, inklusive metodtips, finns i Skapa och hantera klientobjekt som interagerar med dataresurser.

Du kan auktorisera ett klientobjekt med hjälp av en Microsoft Entra-auktoriseringstoken (rekommenderas), en kontoåtkomstnyckel eller en signatur för delad åtkomst (SAS).

Om du vill auktorisera med Microsoft Entra-ID måste du använda ett säkerhetsobjekt. Följande artiklar innehåller vägledning om olika autentiseringsscenarier:

Auktorisera åtkomst med defaultAzureCredential

Ett enkelt och säkert sätt att auktorisera åtkomst och ansluta till Blob Storage är att hämta en OAuth-token genom att skapa en DefaultAzureCredential-instans . Du kan sedan använda autentiseringsuppgifterna för att skapa klientobjektet med 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
}

Om du vill använda en SAS-token (signatur för delad åtkomst) lägger du till token i konto-URL-strängen och skapar klientobjektet med 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
}

Kommentar

För scenarier där signaturer för delad åtkomst (SAS) används rekommenderar Microsoft att du använder en SAS för användardelegering. En SAS för användardelegering skyddas med Microsoft Entra-autentiseringsuppgifter i stället för kontonyckeln. Mer information finns i Bevilja begränsad åtkomst till data med signaturer för delad åtkomst (SAS).

Om du vill använda en delad nyckel för lagringskontot anger du nyckeln som en sträng och initierar ett klientobjekt med 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
}

Du kan också skapa ett klientobjekt med hjälp av en anslutningssträng.

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

    return client
}

Information om hur du hämtar kontonycklar och riktlinjer för bästa praxis för korrekt hantering och skydd av dina nycklar finns i Hantera åtkomstnycklar för lagringskonton.

Viktigt!

Kontoåtkomstnyckeln bör användas med försiktighet. Om din kontoåtkomstnyckel går förlorad eller oavsiktligt placeras på en osäker plats kan tjänsten bli sårbar. Alla som har åtkomstnyckeln kan auktorisera begäranden mot lagringskontot och har effektivt åtkomst till alla data. DefaultAzureCredential ger förbättrade säkerhetsfunktioner och fördelar och är den rekommenderade metoden för att hantera auktorisering till Azure-tjänster.

Skapa appen

När du skapar appar för att arbeta med dataresurser i Azure Blob Storage interagerar koden främst med tre resurstyper: lagringskonton, containrar och blobar. Mer information om dessa resurstyper, hur de relaterar till varandra och hur appar interagerar med resurser finns i Förstå hur appar interagerar med Blob Storage-dataresurser.

Följande guider visar hur du kommer åt data och utför specifika åtgärder med hjälp av Azure Blob Storage-klientmodulen för Go:

Guide	beskrivning
Konfigurera en återförsöksprincip	Implementera återförsöksprinciper för klientåtgärder.
Kopiera blobar	Kopiera en blob från en plats till en annan.
Skapa en container	Skapa containrar.
Ta bort och återställa blobar	Ta bort blobar och återställ borttagna blobar om mjuk borttagning är aktiverat.
Ta bort och återställa containrar	Ta bort containrar och återställ borttagna containrar om mjuk borttagning är aktiverat.
Ladda ned blobar	Ladda ned blobar med hjälp av strängar, strömmar och filsökvägar.
Hitta blobar med taggar	Ange och hämta taggar och använd taggar för att hitta blobar.
Lista blobar	Lista blobar på olika sätt.
Lista containrar	Visa en lista över containrar i ett konto och de olika alternativ som är tillgängliga för att anpassa en lista.
Hantera egenskaper och metadata (blobar)	Hantera containeregenskaper och metadata.
Hantera egenskaper och metadata (containrar)	Hantera containeregenskaper och metadata.
Ladda upp blobar	Lär dig hur du laddar upp blobar med hjälp av strängar, strömmar, filsökvägar och andra metoder.

Kommentar

Kodexemplen i den här guiden är avsedda att hjälpa dig att komma igång med Azure Blob Storage och Go. Du bör ändra felhantering och Context värden för att uppfylla programmets behov.

Dela via