Začínáme se službou Azure Blob Storage a Go

• .NET
• Java
• JavaScript
• TypeScript
• Python
• Přejít

V tomto článku se dozvíte, jak se připojit ke službě Azure Blob Storage pomocí klientského modulu Azure Blob Storage pro Go. Po připojení může váš kód pracovat s kontejnery, objekty blob a funkcemi služby Blob Storage.

Referenční dokumentace k | rozhraní API – Balíček zdrojového kódu | knihovny (pkg.go.dev)

Požadavky

• Předplatné Azure – vytvoření bezplatného předplatného
• Účet úložiště Azure – Vytvoření účtu úložiště
• Go 1.18+

Nastavení projektu

Tato část vás provede přípravou projektu pro práci s modulem klienta Azure Blob Storage pro Go.

Z GOPATH nainstalujte modul azblob pomocí následujícího příkazu:

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

Pokud se chcete ověřit pomocí Microsoft Entra ID (doporučeno), nainstalujte azidentity modul pomocí následujícího příkazu:

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

Pak otevřete soubor kódu a přidejte potřebné cesty k importu. V tomto příkladu přidáme do souboru .go následující:

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

Informace o modulu klienta objektů blob:

• azblob: Obsahuje metody, které můžete použít k provozu se službou, kontejnery a objekty blob.

Autorizace přístupu a připojení ke službě Blob Storage

Pokud chcete připojit aplikaci ke službě Blob Storage, vytvořte objekt klienta pomocí příkazu azblob. NewClient. Tento objekt je vaším výchozím bodem pro interakci s datovými prostředky na úrovni účtu úložiště. Můžete ho použít k provozu s účtem úložiště a jeho kontejnery.

Další informace o vytváření a správě klientských objektů, včetně osvědčených postupů, najdete v tématu Vytváření a správa klientských objektů, které pracují s datovými prostředky.

Klientský objekt můžete autorizovat pomocí autorizačního tokenu Microsoft Entra (doporučeno), přístupového klíče účtu nebo sdíleného přístupového podpisu (SAS).

Microsoft Entra ID (doporučeno)

Pokud chcete autorizovat s ID Microsoft Entra, musíte použít instanční objekt zabezpečení. Následující články obsahují pokyny k různým scénářům ověřování:

• Ověřování ve vývojových prostředích
• Ověřování v aplikacích hostovaných v Azure
• Ověřování pomocí instančního objektu

Autorizace přístupu pomocí DefaultAzureCredential

Snadným a bezpečným způsobem autorizace přístupu a připojení ke službě Blob Storage je získání tokenu OAuth vytvořením instance DefaultAzureCredential . Tyto přihlašovací údaje pak můžete použít k vytvoření objektu klienta pomocí příkazu 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 SAS

Pokud chcete použít token sdíleného přístupového podpisu (SAS), připojte token k řetězci adresy URL účtu a vytvořte objekt klienta pomocí příkazu 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
}

Poznámka:

Ve scénářích, ve kterých se používají sdílené přístupové podpisy (SAS), microsoft doporučuje používat SAS delegování uživatele. Sas delegování uživatele je zabezpečený pomocí přihlašovacích údajů Microsoft Entra místo klíče účtu. Další informace najdete v tématu Udělení omezeného přístupu k datům pomocí sdílených přístupových podpisů (SAS).

Klíč účtu

Pokud chcete použít sdílený klíč účtu úložiště, zadejte klíč jako řetězec a inicializujte objekt klienta pomocí příkazu 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
}

Objekt klienta můžete vytvořit také pomocí připojovací řetězec.

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

    return client
}

Informace o tom, jak získat klíče účtu a osvědčené postupy pro správnou správu a ochranu klíčů, najdete v tématu Správa přístupových klíčů k účtu úložiště.

Důležité

Přístupový klíč účtu by se měl používat s opatrností. Pokud dojde ke ztrátě nebo náhodnému umístění přístupového klíče k účtu do nezabezpečeného umístění, může být vaše služba zranitelná. Každý, kdo má přístupový klíč, může autorizovat požadavky na účet úložiště a efektivně má přístup ke všem datům. DefaultAzureCredential poskytuje vylepšené funkce a výhody zabezpečení a je doporučeným přístupem ke správě autorizace služeb Azure.

Sestavení aplikace

Při vytváření aplikací pro práci s datovými prostředky ve službě Azure Blob Storage váš kód primárně komunikuje se třemi typy prostředků: účty úložiště, kontejnery a objekty blob. Další informace otěchtoch materiálech najdete v tématu Vysvětlení způsobu interakce aplikací s datovými prostředky blob Storage.

Následující příručky ukazují, jak pracovat s datovými prostředky a provádět konkrétní akce pomocí klientského modulu Azure Blob Storage pro Go:

Průvodce	Popis
Vytvoření kontejneru	Vytvořte kontejnery.
Odstranění a obnovení kontejnerů	Odstraňte kontejnery a pokud je povolené obnovitelné odstranění, obnovte odstraněné kontejnery.
Výpis kontejnerů	Vypište kontejnery v účtu a různé možnosti, které můžete přizpůsobit výpis.
Správa vlastností a metadat (kontejnerů)	Správa vlastností a metadat kontejneru
Nahrání objektů blob	Naučte se nahrávat objekty blob pomocí řetězců, datových proudů, cest k souborům a dalších metod.
Stažení objektů blob	Stáhněte objekty blob pomocí řetězců, datových proudů a cest k souborům.
Výpis objektů blob	Výpis objektů blob různými způsoby
Odstranění a obnovení objektů blob	Odstraňte objekty blob a pokud je povolené obnovitelné odstranění, obnovte odstraněné objekty blob.
Vyhledání objektů blob pomocí značek	Nastavte a načtěte značky a použijte značky k vyhledání objektů blob.
Správa vlastností a metadat (objektů blob)	Správa vlastností a metadat kontejneru

Poznámka:

Ukázky kódu v této příručce vám pomůžou začít se službou Azure Blob Storage a Go. Měli byste upravit zpracování chyb a Context hodnoty tak, aby vyhovovaly potřebám vaší aplikace.