Aracılığıyla paylaş

Azure Blob Depolama ve JavaScript veya TypeScript kullanmaya başlama

  • Makale

Bu makalede JavaScript için Azure Blob Depolama istemci kitaplığını kullanarak Azure Blob Depolama nasıl bağlanabileceğiniz gösterilmektedir. Bağlandıktan sonra kodunuzun Blob Depolama hizmetinin kapsayıcıları, blobları ve özellikleri üzerinde nasıl çalışabileceğini öğrenmek için geliştirici kılavuzlarını kullanın.

Tam bir örnekle başlamak istiyorsanız Bkz. JavaScript veya TypeScript için istemci kitaplığı hızlı başlangıcı.

API başvuru | Paketi (npm) | Kitaplık kaynak kodu | Örnekleri | Geri bildirimde bulunmak

Önkoşullar

Projenizi ayarlama

Bu bölümde, JavaScript için Azure Blob Depolama istemci kitaplığıyla çalışmak üzere bir proje hazırlama işleminde size yol gösterilir.

Bir komut istemi açın ve proje klasörünüze gidin. Klasör adınızla değiştirin <project-directory> :

cd <project-directory>

Dizininizde henüz bir package.json dosya yoksa, dosyayı oluşturmak için projeyi başlatın:

npm init -y

Proje dizininizden veya yarn add komutlarını kullanarak npm install Azure Blob Depolama ve Azure Identity istemci kitaplıkları için paketleri yükleyin. Azure hizmetlerine parolasız bağlantılar için @azure/kimlik paketi gereklidir.

npm install @azure/storage-blob @azure/identity

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

Bir uygulamayı Blob Depolama'ya bağlamak için BlobServiceClient sınıfının bir örneğini oluşturun. 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. Çalışmanız gereken kaynağa bağlı olarak kapsayıcı istemcileri veya blob istemcileri oluşturmak için hizmet istemcisini de 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, hesap erişim anahtarı veya paylaşılan erişim imzası (SAS) kullanarak bir nesneyi yetkilandırabilirsiniz BlobServiceClient . En iyi güvenlik için Microsoft, blob verilerine yönelik istekleri yetkilendirmek için yönetilen kimliklerle Microsoft Entra Id kullanılmasını önerir. Daha fazla bilgi için bkz . Microsoft Entra Id kullanarak bloblara erişimi yetkilendirme.

Microsoft Entra Id ile yetkilendirmek için bir güvenlik sorumlusu kullanmanız gerekir. İhtiyacınız olan güvenlik sorumlusu türü, uygulamanızın nerede çalıştığına bağlıdır. Kılavuz olarak aşağıdaki tabloyu kullanın:

Uygulamanın çalıştığı yer Güvenlik sorumlusu Rehber
Yerel makine (geliştirme ve test) Hizmet sorumlusu Uygulamayı kaydetmeyi, bir Microsoft Entra grubu ayarlamayı, rolleri atamayı ve ortam değişkenlerini yapılandırmayı öğrenmek için bkz . Geliştirici hizmet sorumlularını kullanarak erişimi yetkilendirme
Yerel makine (geliştirme ve test) Kullanıcı kimliği Microsoft Entra grubu ayarlamayı, rol atamayı ve Azure'da oturum açmayı öğrenmek için bkz . Geliştirici kimlik bilgilerini kullanarak erişimi yetkilendirme
Azure'da barındırılan Yönetilen kimlik Yönetilen kimliği etkinleştirmeyi ve rol atamayı öğrenmek için bkz . Yönetilen kimlik kullanarak Azure tarafından barındırılan uygulamalardan erişimi yetkilendirme
Azure dışında barındırılan (örneğin, şirket içi uygulamalar) Hizmet sorumlusu Uygulamayı kaydetmeyi, rolleri atamayı ve ortam değişkenlerini yapılandırmayı öğrenmek için bkz . Uygulama hizmet sorumlusu kullanarak şirket içi uygulamalardan erişimi yetkilendirme

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 bir BlobServiceClient nesne oluşturabilirsiniz.

Aşağıdaki örnek kullanarak DefaultAzureCredentialbir BlobServiceClient nesne oluşturur:

const accountName = "<account-name>";
const accountURL = `https://${accountName}.blob.core.windows.net`;
const blobServiceClient = new BlobServiceClient(
  accountURL,
  new DefaultAzureCredential()
);

Bu kod örneği JavaScript veya TypeScript projeleri için kullanılabilir.

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, JavaScript için Azure Depolama istemci kitaplığını kullanarak verilere nasıl erişebileceğiniz ve belirli eylemleri nasıl gerçekleştirebileceğiniz gösterilmektedir:

Kılavuz Açıklama
Yeniden deneme ilkesi yapılandırma İstemci işlemleri için yeniden deneme ilkeleri uygulayın.
Blobları kopyalama Blobu bir konumdan diğerine kopyalayın.
Kapsayıcı oluşturma Blob kapsayıcıları oluşturma.
Kullanıcı temsilcisi SAS öğesi oluşturma Kapsayıcı veya blob için kullanıcı temsilcisi SAS'i oluşturun.
Blob kiralamaları oluşturma ve yönetme Blob üzerinde kilit oluşturma ve yönetme.
Kapsayıcı kiralamaları oluşturma ve yönetme Kapsayıcıda kilit oluşturma ve yönetme.
Silme ve geri yükleme Blobları silin ve geçici olarak silinen blobları geri yükleyin.
Kapsayıcıları silme ve geri yükleme Kapsayıcıları silin ve geçici olarak silinen kapsayıcıları geri yükleyin.
Blobları indirme Dizeleri, akışları ve dosya yollarını kullanarak blobları indirin.
Etiketleri kullanarak blobları bulma Etiketleri ayarlayıp alın ve blobları bulmak için etiketleri kullanın.
Blobları listeleme Blobları farklı şekillerde listeleyin.
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 (bloblar) yönetme Bloblar için özellikleri ve meta verileri alın ve ayarlayın.
Özellikleri ve meta verileri (kapsayıcılar) yönetme Kapsayıcıların özelliklerini ve meta verilerini alın ve ayarlayın.
Veri aktarımları için performans ayarlama Veri aktarımı işlemleri için performansı iyileştirme.
Blob erişim katmanını ayarlama veya değiştirme Blok blobu için erişim katmanını ayarlayın veya değiştirin.
Blobları karşıya yükleme Dizeleri, akışları, dosya yollarını ve diğer yöntemleri kullanarak blobları karşıya yüklemeyi öğrenin.