Wprowadzenie do usługi Azure Blob Storage i języka Go

• .NET
• Java
• JavaScript
• Python
• Go

W tym artykule pokazano, jak nawiązać połączenie z usługą Azure Blob Storage przy użyciu modułu klienta usługi Azure Blob Storage dla języka Go. Po nawiązaniu połączenia skorzystaj z przewodników dla deweloperów , aby dowiedzieć się, jak kod może działać na kontenerach, obiektach blob i funkcjach usługi Blob Storage.

Jeśli chcesz zacząć od kompletnego przykładu, zobacz Szybki start: biblioteka klienta usługi Azure Blob Storage dla języka Go.

Dokumentacja referencyjna interfejsu API | Kod źródłowy biblioteki | Pakiet (pkg.go.dev)

Prerequisites

• Subskrypcja platformy Azure — utwórz jedną bezpłatnie
• Konto usługi Azure Storage — utwórz konto usługi Azure Storage
• Przejdź do wersji 1.18 lub nowszej

Konfigurowanie projektu

Ta sekcja przeprowadzi Cię przez proces przygotowywania projektu do pracy z modułem klienta usługi Azure Blob Storage dla języka Go.

Z poziomu programu GOPATH zainstaluj moduł azblob przy użyciu następującego polecenia:

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

Aby uwierzytelnić się przy użyciu identyfikatora Entra firmy Microsoft (zalecane), zainstaluj azidentity moduł przy użyciu następującego polecenia:

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

Następnie otwórz plik kodu i dodaj niezbędne ścieżki importu. W tym przykładzie dodamy następujący kod do pliku .go :

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

Informacje o module klienta blob

• azblob: zawiera metody, których można użyć do obsługi usług, kontenerów i obiektów blob.

Autoryzowanie dostępu i nawiązywanie połączenia z usługą Blob Storage

Aby połączyć aplikację z usługą Blob Storage, utwórz obiekt klienta przy użyciu polecenia azblob. NewClient. Ten obiekt jest punktem wyjścia do interakcji z zasobami danych na poziomie konta magazynowego. Można go użyć do obsługi konta przechowywania i jego kontenerów.

Aby dowiedzieć się więcej na temat tworzenia obiektów klienta i zarządzania nimi, w tym najlepszych rozwiązań, zobacz Tworzenie obiektów klienta korzystających z zasobów danych i zarządzanie nimi.

Obiekt klienta można autoryzować przy użyciu tokenu autoryzacji entra firmy Microsoft (zalecane), klucza dostępu do konta lub sygnatury dostępu współdzielonego (SAS).

Microsoft Entra ID (zalecane)

Aby autoryzować za pomocą Microsoft Entra ID, musisz użyć podmiotu zabezpieczeń. Poniższe artykuły zawierają wskazówki dotyczące różnych scenariuszy uwierzytelniania:

• Uwierzytelnianie w środowiskach deweloperskich
• Uwierzytelnianie w aplikacjach hostowanych na platformie Azure
• Uwierzytelnianie przy użyciu jednostki usługi

Autoryzowanie dostępu za pomocą DefaultAzureCredential

Łatwym i bezpiecznym sposobem autoryzowania dostępu i nawiązywania połączenia z usługą Blob Storage jest uzyskanie tokenu OAuth przez utworzenie wystąpienia DefaultAzureCredential . Następnie możesz użyć tego poświadczenia, aby utworzyć obiekt klienta przy użyciu 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

Aby użyć tokenu sygnatury dostępu współdzielonego (SAS), dołącz token do ciągu adresu URL konta i utwórz obiekt klienta przy użyciu 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
}

Note

W przypadku scenariuszy, w których są używane sygnatury dostępu współdzielonego (SAS), firma Microsoft zaleca używanie sygnatury dostępu delegowanej przez użytkownika. Sygnatura dostępu współdzielonego (SAS) dla delegacji użytkownika jest zabezpieczona przy użyciu poświadczeń Microsoft Entra zamiast klucza konta. Aby uzyskać więcej informacji, zobacz Udzielanie ograniczonego dostępu do danych za pomocą sygnatur dostępu współdzielonego (SAS).

Klucz konta

Aby użyć współdzielonego klucza konta magazynu, wprowadź klucz jako ciąg znaków i zainicjuj obiekt klienta przy użyciu 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
}

Obiekt klienta można również utworzyć przy użyciu parametrów połączenia.

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

    return client
}

Aby uzyskać informacje na temat uzyskiwania kluczy konta i wytycznych dotyczących najlepszych rozwiązań dotyczących prawidłowego zarządzania kluczami i ich ochrony, zobacz Zarządzanie kluczami dostępu do konta magazynu.

Important

Klucz dostępu do konta powinien być używany ostrożnie. Jeśli klucz dostępu do twojego konta zostanie utracony lub przypadkowo umieszczony w niezabezpieczonej lokalizacji, usługa może stać się podatna na zagrożenia. Każdy, kto ma klucz dostępu, może autoryzować żądania dotyczące konta magazynowego i praktycznie ma dostęp do wszystkich danych. DefaultAzureCredential zapewnia ulepszone funkcje zabezpieczeń i korzyści oraz jest zalecanym podejściem do zarządzania autoryzacją usług Azure.

Kompilowanie aplikacji

Podczas tworzenia aplikacji do pracy z zasobami danych w usłudze Azure Blob Storage kod wchodzi głównie w interakcję z trzema typami zasobów: kontami magazynu, kontenerami i obiektami blob. Aby dowiedzieć się więcej o tych typach zasobów, sposobie ich powiązania ze sobą i sposobie interakcji aplikacji z zasobami, zobacz Omówienie sposobu interakcji aplikacji z zasobami danych usługi Blob Storage.

W poniższych przewodnikach przedstawiono sposób uzyskiwania dostępu do danych i wykonywania określonych akcji przy użyciu modułu klienta usługi Azure Blob Storage dla języka Go:

Guide	Description
Konfigurowanie zasad ponawiania prób	Zaimplementuj reguły ponawiania dla operacji klientów.
Kopiowanie obiektów blob	Skopiuj blob z jednej lokalizacji do innej.
Tworzenie kontenera	Tworzenie kontenerów.
Usuwanie i przywracanie obiektów blob	Usuń obiekty blob i jeśli włączono usuwanie miękkie, przywróć usunięte obiekty blob.
Usuwanie i przywracanie kontenerów	Usuń kontenery, a jeśli włączono usuwanie nietrwałe, przywróć usunięte kontenery.
Pobierz obiekty blob	Pobierz bloby przy użyciu ciągów, strumieni i ścieżek plików.
Znajdowanie obiektów blob przy użyciu tagów	Ustawianie i pobieranie tagów oraz używanie tagów do znajdowania blobów.
Wyświetlanie listy obiektów blob	Wyświetlanie listy obiektów blob na różne sposoby.
Lista kontenerów	Lista kontenerów na koncie oraz różne dostępne opcje dostosowania listy.
Zarządzanie właściwościami i metadanymi (bloby)	Zarządzanie właściwościami i metadanymi kontenera.
Zarządzanie właściwościami i metadanymi (kontenerami)	Zarządzanie właściwościami i metadanymi kontenera.
Przekazywanie obiektów blob	Dowiedz się, jak przesyłać obiekty blob przy użyciu ciągów, strumieni, ścieżek plików i innych metod.

Note

Przykłady kodu w tym przewodniku ułatwiają rozpoczęcie pracy z usługami Azure Blob Storage i Go. Należy zmodyfikować obsługę błędów i Context wartości, aby spełniały potrzeby aplikacji.