Aracılığıyla paylaş

TypeScript ile kaynak nesne URL'sinden blob kopyalama

  • Makale

Bu makalede, JavaScript için Azure Depolama istemci kitaplığını kullanarak kaynak nesne URL'sinden blob kopyalama işlemi gösterilmektedir. Blobu aynı depolama hesabındaki bir kaynaktan, farklı bir depolama hesabındaki bir kaynaktan veya belirli bir URL'deki HTTP GET isteği aracılığıyla alınan erişilebilir nesnelerden kopyalayabilirsiniz.

Bu makalede ele alınan istemci kitaplığı yöntemleri, Blobu URL'den Yerleştir ve URL'den Blok Koy REST API işlemlerini kullanır. Bu yöntemler, verileri bir depolama hesabına taşımak istediğiniz ve kaynak nesnenin URL'sine sahip olmak istediğiniz kopyalama senaryoları için tercih edilir. Zaman uyumsuz zamanlama istediğiniz kopyalama işlemleri için bkz . TypeScript kullanarak zaman uyumsuz zamanlama ile blob kopyalama.

Ön koşullar

  • Bu makaledeki örneklerde JavaScript için Azure Blob Depolama istemci kitaplığıyla çalışmak üzere ayarlanmış bir projeniz olduğu varsayılır. Paket yükleme, modülleri içeri aktarma ve veri kaynaklarıyla çalışacak yetkili bir istemci nesnesi oluşturma gibi projenizi ayarlama hakkında bilgi edinmek için bkz. Azure Blob Depolama ve TypeScript'i kullanmaya başlama.
  • Yetkilendirme mekanizmasının kopyalama işlemi gerçekleştirme izinleri olmalıdır. Daha fazla bilgi edinmek için aşağıdaki REST API işlemi için yetkilendirme kılavuzuna bakın:

Kaynak nesne URL'sinden blob kopyalama hakkında

İşlem, Put Blob From URL blobun içeriğinin belirli bir URL'den okunduğu yeni bir blok blobu oluşturur. İşlem zaman uyumlu olarak tamamlar.

Kaynak, belirtilen URL'de standart bir HTTP GET isteği aracılığıyla alınabilir herhangi bir nesne olabilir. Buna blok blobları, ekleme blobları, sayfa blobları, blob anlık görüntüleri, blob sürümleri veya Azure içindeki veya dışındaki erişilebilir nesneler dahildir.

Kaynak nesne bir blok blobu olduğunda, işlenen tüm blob içeriği kopyalanır. Ancak, blok listesi korunmaz ve kaydedilmemiş bloklar kopyalanmamıştır. Hedef blobun içeriği kaynağın içeriğiyle aynıdır, ancak işlenen blok listesi korunmaz.

Hedef her zaman bir blok blobu, var olan bir blok blobu veya işlem tarafından oluşturulan yeni bir blok blobudur. Var olan bir blobun içeriğinin üzerine yeni blobun içeriği yazılır.

İşlem Put Blob From URL her zaman kaynak blob'un tamamını kopyalar. Bayt aralığının veya blok kümesinin kopyalanması desteklenmez. Kaynak URL kullanarak blok blobunun içeriğinde kısmi güncelleştirmeler gerçekleştirmek için, Blok Listesini Koy ile birlikte URL'den Blok Koy API'sini kullanın.

Blob boyutu sınırlamaları ve faturalama konuları dahil olmak üzere işlem hakkında Put Blob From URL daha fazla bilgi edinmek için bkz . URL'den Blob Ekleme açıklamaları.

Kaynak nesne URL'sinden blob kopyalama

Bu bölümde, kaynak nesne URL'sinden kopyalama işlemi gerçekleştirmek üzere JavaScript ve TypeScript için Azure Depolama istemci kitaplığı tarafından sağlanan yöntemlere genel bir bakış sunulmaktadır.

Aşağıdaki yöntem, URL'den Blob Koy REST API işlemini sarmalar ve blobun içeriğinin belirli bir URL'den okunduğu yeni bir blok blobu oluşturur:

Bu yöntemler, verileri bir depolama hesabına taşımak istediğiniz ve kaynak nesnenin URL'sine sahip olmak istediğiniz senaryolar için tercih edilir.

Büyük nesneler için tek tek bloklarla çalışmayı seçebilirsiniz. Aşağıdaki yöntem, URL'den Blok Koy REST API işlemini sarmalar. Bu yöntem, içeriklerinin kaynak URL'den okunduğu bir blobun parçası olarak işlenecek yeni bir blok oluşturur:

Azure'da bir kaynaktan blob kopyalama

Azure'da bir kaynaktan blob kopya ediyorsanız, kaynak bloba erişim Microsoft Entra Kimliği, paylaşılan erişim imzası (SAS) veya hesap anahtarı aracılığıyla yetkilendirilebilir.

Aşağıdaki örnekte, Azure içindeki bir kaynak blobdan kopyalama senaryosu gösterilmektedir:

async function copyFromSourceInAzure(
  sourceBlob: BlockBlobClient,
  destinationBlob: BlockBlobClient
): Promise<void> {
  // Get the source blob URL and create the destination blob
  await destinationBlob.syncUploadFromURL(sourceBlob.url);
}

syncUploadFromURL yöntemi, işlem için daha fazla seçenek belirtmek üzere BlockBlobSyncUploadFromURLOptions parametresini de kabul edebilir.

Azure dışındaki bir kaynaktan blob kopyalama

Azure dışındaki erişilebilir nesneler de dahil olmak üzere belirli bir URL'de HTTP GET isteği aracılığıyla alınabilen herhangi bir kaynak nesne üzerinde kopyalama işlemi gerçekleştirebilirsiniz. Aşağıdaki örnekte, erişilebilir bir kaynak nesne URL'sinden blob kopyalamaya yönelik bir senaryo gösterilmektedir.

async function copyFromExternalSource(
  sourceUrl: string,
  destinationBlob: BlockBlobClient
): Promise<void> {
  // Create the destination blob from the source URL
  await destinationBlob.syncUploadFromURL(sourceUrl);
}

Kaynaklar

JavaScript ve TypeScript için Azure Blob Depolama istemci kitaplığını kullanarak blobları kopyalama hakkında daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın.

REST API işlemleri

JavaScript ve TypeScript için Azure SDK, Azure REST API'sinin üzerinde derlenmiş kitaplıklar içerir ve tanıdık dil paradigmalarıyla REST API işlemleriyle etkileşim kurmanızı sağlar. Bu makalede ele alınan istemci kitaplığı yöntemleri aşağıdaki REST API işlemlerini kullanır:

Kod örnekleri

İstemci kitaplığı kaynakları