Azure Blob Depolama ve Go ile çalışmaya başlama

• .NET
• Java
• JavaScript
• TypeScript
• Python
• Git

Bu makalede Go için Azure Blob Depolama istemci modülünü kullanarak Azure Blob Depolama nasıl bağlanabileceğiniz gösterilmektedir. Bağlandıktan sonra kodunuz Blob Depolama hizmetinin kapsayıcıları, blobları ve özellikleri üzerinde çalışabilir.

API başvuru belgeleri | Kitaplık kaynak kodu | Paketi (pkg.go.dev)

Önkoşullar

• Azure aboneliği - ücretsiz bir abonelik oluşturun
• Azure depolama hesabı - depolama hesabı oluşturma
• Go 1.18+

Projenizi ayarlama

Bu bölümde Go için Azure Blob Depolama istemci modülüyle çalışmak üzere bir proje hazırlama işleminde size yol gösterir.

GOPATH'inizden aşağıdaki komutu kullanarak azblob modülünü yükleyin:

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

Microsoft Entra Id ile kimlik doğrulaması yapmak için (önerilen), aşağıdaki komutu kullanarak modülü yükleyin azidentity :

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

Ardından kod dosyanızı açın ve gerekli içeri aktarma yollarını ekleyin. Bu örnekte, .go dosyamıza aşağıdakileri ekleyeceğiz:

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

Blob istemci modülü bilgileri:

• azblob: Hizmet, kapsayıcılar ve bloblar üzerinde çalışmak için kullanabileceğiniz yöntemleri içerir.

Erişimi yetkilendirme ve Blob Depolama'ya bağlanma

Bir uygulamayı Blob Depolama'ya bağlamak için azblob kullanarak bir istemci nesnesi oluşturun. NewClient. Bu nesne, depolama hesabı düzeyinde veri kaynaklarıyla etkileşim kurmak için başlangıç noktanızdır. Depolama hesabında ve kapsayıcılarında çalışmak için bunu kullanabilirsiniz.

en iyi yöntemler de dahil olmak üzere istemci nesneleri oluşturma ve yönetme hakkında daha fazla bilgi edinmek için bkz . Veri kaynaklarıyla etkileşim kuran istemci nesneleri oluşturma ve yönetme.

Microsoft Entra yetkilendirme belirteci (önerilen), hesap erişim anahtarı veya paylaşılan erişim imzası (SAS) kullanarak bir istemci nesnesini yetkilendikleyebilirsiniz.

Microsoft Entra Id (önerilen)

Microsoft Entra Id ile yetkilendirmek için bir güvenlik sorumlusu kullanmanız gerekir. Aşağıdaki makaleler farklı kimlik doğrulama senaryoları hakkında rehberlik sağlar:

• Geliştirme ortamlarında kimlik doğrulaması
• Azure tarafından barındırılan uygulamalarda kimlik doğrulaması
• Hizmet sorumlusuyla kimlik doğrulaması

DefaultAzureCredential kullanarak erişimi yetkilendirme

Erişimi yetkilendirmenin ve Blob Depolama'ya bağlanmanın kolay ve güvenli bir yolu, DefaultAzureCredential örneği oluşturarak bir OAuth belirteci almaktır. Ardından bu kimlik bilgilerini kullanarak azblob kullanarak istemci nesnesi oluşturabilirsiniz. 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 belirteci

Paylaşılan erişim imzası (SAS) belirteci kullanmak için belirteci hesap URL dizesine ekleyin ve azblob kullanarak istemci nesnesini oluşturun. 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
}

Not

Paylaşılan erişim imzalarının (SAS) kullanıldığı senaryolar için Microsoft, kullanıcı temsilcisi SAS'sini kullanmanızı önerir. Kullanıcı temsilcisi SAS'sinin güvenliği hesap anahtarı yerine Microsoft Entra kimlik bilgileriyle sağlanır. Daha fazla bilgi için bkz . Paylaşılan erişim imzalarıyla (SAS) verilere sınırlı erişim verme.

Hesap anahtarı

Depolama hesabı paylaşılan anahtarı kullanmak için anahtarı dize olarak sağlayın ve azblob kullanarak bir istemci nesnesi başlatın. 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
}

ayrıca bağlantı dizesi kullanarak bir istemci nesnesi de oluşturabilirsiniz.

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

    return client
}

Hesap anahtarlarını alma hakkında bilgi edinmek ve anahtarlarınızı düzgün bir şekilde yönetmek ve korumak için en iyi yöntem yönergeleri için bkz . Depolama hesabı erişim anahtarlarını yönetme.

Önemli

Hesap erişim anahtarı dikkatli kullanılmalıdır. Hesap erişim anahtarınız kaybolursa veya yanlışlıkla güvenli olmayan bir konuma yerleştirilirse, hizmetiniz güvenlik açığına maruz kalabilir. Erişim anahtarına sahip olan herkes, depolama hesabına yönelik istekleri yetkilendirebiliyor ve tüm verilere etkin bir şekilde erişim sahibi oluyor. DefaultAzureCredential gelişmiş güvenlik özellikleri ve avantajları sağlar ve Azure hizmetlerine yetkilendirmeyi yönetmek için önerilen yaklaşımdır.

Uygulamanızı derleme

Azure Blob Depolama'daki veri kaynaklarıyla çalışacak uygulamalar oluştururken kodunuz öncelikli olarak üç kaynak türüyle etkileşim kurar: depolama hesapları, kapsayıcılar ve bloblar. Bu kaynak türleri, birbirleriyle ilişkileri ve uygulamaların kaynaklarla nasıl etkileşim kurduğu hakkında daha fazla bilgi edinmek için bkz . Uygulamaların Blob Depolama veri kaynaklarıyla nasıl etkileşim kuracaklarını anlama.

Aşağıdaki kılavuzlarda Go için Azure Blob Depolama istemci modülünü kullanarak veri kaynaklarıyla çalışma ve belirli eylemleri gerçekleştirme adımları gösterilmektedir:

Kılavuz	Açıklama
Kapsayıcı oluşturma	Kapsayıcılar oluşturun.
Kapsayıcıları silme ve geri yükleme	Kapsayıcıları silin ve geçici silme etkinleştirildiyse silinen kapsayıcıları geri yükleyin.
Kapsayıcıları listeleme	Bir hesaptaki kapsayıcıları ve listeyi özelleştirmek için kullanılabilecek çeşitli seçenekleri listeleyin.
Özellikleri ve meta verileri (kapsayıcılar) yönetme	Kapsayıcı özelliklerini ve meta verilerini yönetme.
Blobları karşıya yükleme	Dizeleri, akışları, dosya yollarını ve diğer yöntemleri kullanarak blobları karşıya yüklemeyi öğrenin.
Blobları indirme	Dizeleri, akışları ve dosya yollarını kullanarak blobları indirin.
Blobları listeleme	Blobları farklı şekillerde listeleyin.
Blobları silme ve geri yükleme	Blobları silin ve geçici silme etkinleştirildiyse silinen blobları geri yükleyin.
Etiketleri kullanarak blobları bulma	Etiketleri ayarlayıp alın ve blobları bulmak için etiketleri kullanın.
Özellikleri ve meta verileri (bloblar) yönetme	Kapsayıcı özelliklerini ve meta verilerini yönetme.

Not

Bu kılavuzdaki kod örnekleri, Azure Blob Depolama ve Go ile çalışmaya başlamanıza yardımcı olmak için tasarlanmıştır. Hata işlemeyi ve Context değerleri uygulamanızın gereksinimlerini karşılayacak şekilde değiştirmeniz gerekir.