Začínáme s platformou Azure Blob Storage a programovacím jazykem Go

• .NET
• Java
• JavaScript
• Python
• Jí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í se pomocí příruček pro vývojáře dozvíte, jak váš kód funguje s kontejnery, objekty blob a funkcemi služby Blob Storage.

Pokud chcete začít s úplným příkladem, podívejte se na Quickstart: Klientská knihovna Azure Blob Storage pro Go.

Referenční dokumentace API | Zdrojový kód knihovny | Balíček (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 blob klientském modulu:

• azblob: Obsahuje metody, které můžete použít pro práci se službou, kontejnery a bloby.

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 pro práci 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 pomocí ID Microsoft Entra, musíte použít bezpečnostní objekt. 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í služebního principála

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, kdy se používají sdílené přístupové podpisy (SAS), Microsoft doporučuje používat SAS s delegováním uživatele. Delegování SAS je zabezpečeno pomocí přihlašovacích údajů Microsoft Entra namí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.

Sestavte aplikaci

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 o těchto typech zdrojů, o tom, jak se vzájemně vztahují a jak aplikace interagují se zdroji, naleznete v tématu Vysvětlení způsobu interakce aplikací s datovými zdroji služby Blob Storage.

Následující příručky ukazují, jak získat přístup k datům a provádět konkrétní akce pomocí klientského modulu Azure Blob Storage pro Go:

Průvodce	Popis
Nakonfigurujte zásady opakování	Implementujte zásady opakování pro klientské operace.
Kopírování blobů	Zkopírujte blob z jednoho umístění do druhého.
Vytvoření kontejneru	Vytvořte kontejnery.
Odstranění a obnovení blobů	Odstraňte objekty blob a pokud je povolený softwarový režim odstranění, obnovte odstraněné objekty blob.
Odstranění a obnovení kontejnerů	Odstraňte kontejnery a pokud je povolené obnovitelné odstranění, obnovte odstraněné kontejnery.
Stažení blobů	Stáhněte blob pomocí řetězců, datových proudů a cest k souborům.
Vyhledání objektů blob pomocí značek	Nastavte a načtěte značky a použijte je k vyhledávání objektů typu blob.
Seznam blobů	Vypsat objekty blob různými způsoby
Výpis kontejnerů	Zobrazte seznam kontejnerů na účtu a různé možnosti pro přizpůsobení seznamu.
Správa vlastností a metadat (objektů blob)	Správa vlastností a metadat kontejneru
Správa vlastností a metadat (kontejnerů)	Správa vlastností a metadat kontejneru
** Nahrát bloby	Naučte se nahrávat objekty blob pomocí řetězců, streamů, cest k souborům a dalších metod.

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.