PageBlobClient class

PageBlobClient, sayfa blobları için geçerli olan bir dizi işlemi tanımlar.

Oluşturucular

PageBlobClient(string, PipelineLike)	PageBlobClient örneği oluşturur.
PageBlobClient(string, StorageSharedKeyCredential \| AnonymousCredential \| TokenCredential, StoragePipelineOptions)	PageBlobClient örneği oluşturur. Bu yöntem bir bloba işaret eden kodlanmış bir URL'yi veya kodlanmamış URL'yi kabul eder. Kodlanmış URL dizesi iki kez kaçılmaz, YALNıZCA URL yolundaki özel karakterlerden kaçılır. Blob adından biri varsa? veya %blob adı URL'de kodlanmalıdır.
PageBlobClient(string, string, string, StoragePipelineOptions)	PageBlobClient örneği oluşturur.

Özellikler

accountName
containerName	Blobun ilişkili olduğu depolama kapsayıcısının adı.
credential	AnonymousCredential, StorageSharedKeyCredential gibi veya hizmete yönelik isteklerin kimliğini doğrulamak için `@azure/identity` paketindeki herhangi bir kimlik bilgisi. TokenCredential arabirimini uygulayan bir nesne de sağlayabilirsiniz. Belirtilmezse, AnonymousCredential kullanılır.
name	Blobun adı.
url	Kodlanmış URL dizesi değeri.

Yöntemler

abortCopyFromURL(string, BlobAbortCopyFromURLOptions)	Bekleyen bir zaman uyumsuz Kopyalama Blobu işlemini durdurur ve sıfır uzunlukta ve tam meta veri içeren bir hedef blob bırakır. Sürüm 2012-02-12 ve daha yeni.
beginCopyFromURL(string, BlobBeginCopyFromURLOptions)	Blobu zaman uyumsuz olarak depolama hesabı içindeki bir hedefe kopyalar. Bu yöntem, kopya tamamlanana kadar süresiz olarak beklemenize olanak tanıyan uzun süre çalışan bir işlem poller döndürür. Ayrıca, bir kopya tamamlanmadan önce poller üzerindeki `cancelOperation` çağırarak da iptal edebilirsiniz. İlk istekte işlem tamamlanırsa onProgress geri çağırmasının çağrılmadığını ve tamamlanmış bir kopyanın iptal edilmeye çalışılmasının hataya neden olacağını unutmayın. Sürüm 2012-02-12 ve sonraki sürümlerde, Blobu Kopyalama işleminin kaynağı herhangi bir Azure depolama hesabında kaydedilmiş bir blob olabilir. 2015-02-21 sürümünden başlayarak, Blobu Kopyalama işleminin kaynağı herhangi bir Azure depolama hesabındaki bir Azure dosyası olabilir. Yalnızca 7 Haziran 2012 veya sonrasında oluşturulan depolama hesapları, Blobu Kopyala işleminin başka bir depolama hesabından kopyalamasına izin verir.
clearPages(number, number, PageBlobClearPagesOptions)	Belirtilen sayfaları sayfa blobundan serbest kaldırır.
create(number, PageBlobCreateOptions)	Belirtilen uzunlukta bir sayfa blobu oluşturur. Veri verilerini bir sayfa blob'una yüklemek için uploadPages'i arayın.
createIfNotExists(number, PageBlobCreateIfNotExistsOptions)	Belirtilen uzunlukta bir sayfa blobu oluşturur. Veri verilerini bir sayfa blob'una yüklemek için uploadPages'i arayın. Aynı ada sahip blob zaten varsa, mevcut blobun içeriği değişmeden kalır.
createSnapshot(BlobCreateSnapshotOptions)	Blobun salt okunur anlık görüntüsünü oluşturur.
delete(BlobDeleteOptions)	Belirtilen blobu veya anlık görüntüyü silinmek üzere işaretler. Blob daha sonra çöp toplama sırasında silinir. Bir blobu silmek için tüm anlık görüntülerini silmeniz gerektiğini unutmayın. Blobu Sil işlemiyle ikisini de aynı anda silebilirsiniz.
deleteIfExists(BlobDeleteOptions)	Varsa, belirtilen blobu veya anlık görüntüyü silinmek üzere işaretler. Blob daha sonra çöp toplama sırasında silinir. Bir blobu silmek için tüm anlık görüntülerini silmeniz gerektiğini unutmayın. Blobu Sil işlemiyle ikisini de aynı anda silebilirsiniz.
deleteImmutabilityPolicy(BlobDeleteImmutabilityPolicyOptions)	Blobdaki değişmezlik ilkesini silin.
download(number, number, BlobDownloadOptions)	Meta verileri ve özellikleri dahil olmak üzere bir blobu sistemden okur veya indirir. Anlık görüntüyü okumak için Blob Al'ı da çağırabilirsiniz. Node.js'de veriler okunabilir bir akışta döndürülebilirStreamBody içinde döndürülüyor Tarayıcılarda veriler promise blobBody içinde döndürülüyor
downloadToBuffer(Buffer, number, number, BlobDownloadToBufferOptions)	YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Arabelleğe paralel olarak bir Azure Blobu indirir. Uzaklık ve sayı isteğe bağlıdır, sağlanmazsa blob'un tamamını indirir. Uyarı: Arabellekler, Node.js/V8 sınırlamaları nedeniyle 32 bit sistemlerde yaklaşık bir gigabayt veya 64 bit sistemlerde yaklaşık iki gigabayt kadar dosyaları destekleyebilir. Bu boyuttan büyük bloblar için <xref:downloadToFile>göz önünde bulundurun.
downloadToBuffer(number, number, BlobDownloadToBufferOptions)	YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Arabelleğe paralel olarak bir Azure Blobu indirir. Uzaklık ve sayı isteğe bağlıdır, sağlanmazsa blob'un tamamını indirir. Uyarı: Arabellekler, Node.js/V8 sınırlamaları nedeniyle 32 bit sistemlerde yaklaşık bir gigabayt veya 64 bit sistemlerde yaklaşık iki gigabayt kadar dosyaları destekleyebilir. Bu boyuttan büyük bloblar için <xref:downloadToFile>göz önünde bulundurun.
downloadToFile(string, number, number, BlobDownloadOptions)	YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Azure Blob'ları yerel bir dosyaya indirir. Verilen dosya yolu zaten çıkarsa başarısız olur. Uzaklık ve sayı isteğe bağlıdır, blob'un tamamını indirmek için sırasıyla 0 ve undefined değerini geçirir.
exists(BlobExistsOptions)	Bu istemci tarafından temsil edilen Azure blob kaynağı varsa true döndürür; false olarak ayarlayın. NOT: Mevcut bir blob diğer istemciler veya uygulamalar tarafından silinebileceğinden bu işlevi dikkatli kullanın. Bu işlev tamamlandıktan sonra diğer istemciler veya uygulamalar tarafından yeni bloblar eklenebilir.
generateSasUrl(BlobGenerateSasUrlOptions)	Yalnızca paylaşılan anahtar kimlik bilgileriyle yapılan BlobClient için kullanılabilir. geçirilen istemci özelliklerine ve parametrelerine göre bir Blob Hizmeti Paylaşılan Erişim İmzası (SAS) URI'sini oluşturur. SAS, istemcinin paylaşılan anahtar kimlik bilgileriyle imzalanır.
getAppendBlobClient()	AppendBlobClient nesnesi oluşturur.
getBlobLeaseClient(string)	Blob üzerindeki kiraları yöneten bir <xref:BlobLeaseClient> alın.
getBlockBlobClient()	BlockBlobClient nesnesi oluşturur.
getPageBlobClient()	PageBlobClient nesnesi oluşturur.
getPageRanges(number, number, PageBlobGetPageRangesOptions)	Sayfa blobu veya sayfa blobunun anlık görüntüsü için geçerli sayfa aralıklarının listesini döndürür.
getPageRangesDiff(number, number, string, PageBlobGetPageRangesDiffOptions)	Belirtilen anlık görüntü ile bu sayfa blobu arasında farklılık gösteren sayfa aralıkları koleksiyonunu alır.
getPageRangesDiffForManagedDisks(number, number, string, PageBlobGetPageRangesDiffOptions)	Yönetilen diskler için belirtilen anlık görüntü ile bu sayfa blobu arasında farklılık gösteren sayfa aralıkları koleksiyonunu alır.
getProperties(BlobGetPropertiesOptions)	Blob için tüm kullanıcı tanımlı meta verileri, standart HTTP özelliklerini ve sistem özelliklerini döndürür. Blobun içeriğini döndürmez.
getTags(BlobGetTagsOptions)	Temel alınan blobla ilişkili etiketleri alır.
resize(number, PageBlobResizeOptions)	Sayfa blobunu belirtilen boyuta (512'nin katı olmalıdır) yeniden boyutlandırıyor.
setAccessTier(BlockBlobTier \| PremiumPageBlobTier \| string, BlobSetTierOptions)	Blob üzerindeki katmanı ayarlar. İşleme premium depolama hesabındaki bir sayfa blobunda ve blob depolama hesabındaki bir blok blobunda izin verilir (yalnızca yerel olarak yedekli depolama). Premium sayfa blobunun katmanı blobun izin verilen boyutunu, IOPS'sini ve bant genişliğini belirler. Blok blobu katmanı Sık Erişimli/Seyrek Erişimli/Arşiv depolama türünü belirler. Bu işlem blob'un ETag'ini güncelleştirmez.
setHTTPHeaders(BlobHTTPHeaders, BlobSetHTTPHeadersOptions)	Blob üzerindeki sistem özelliklerini ayarlar. Belirtilen blob HTTP üst bilgileri için değer sağlanmazsa veya değer sağlanmazsa, değeri olmayan bu blob HTTP üst bilgileri temizlenir.
setImmutabilityPolicy(BlobImmutabilityPolicy, BlobSetImmutabilityPolicyOptions)	Blob üzerinde değişmezlik ilkesi ayarlayın.
setLegalHold(boolean, BlobSetLegalHoldOptions)	Blob üzerinde yasal saklama ayarlayın.
setMetadata(Metadata, BlobSetMetadataOptions)	Belirtilen blob için kullanıcı tanımlı meta verileri bir veya daha fazla ad-değer çifti olarak ayarlar. Seçenek sağlanmadıysa veya parametrede tanımlı meta veri yoksa blob meta verileri kaldırılır.
setTags(Tags, BlobSetTagsOptions)	Temel alınan blob üzerindeki etiketleri ayarlar. Bir blobda en fazla 10 etiket olabilir. Etiket anahtarları 1 ile 128 karakter arasında olmalıdır. Etiket değerleri 0 ile 256 karakter arasında olmalıdır. Geçerli etiket anahtarı ve değer karakterleri küçük ve büyük harf, basamak (0-9), boşluk (' '), artı ('+'), eksi ('-'), nokta ('.'), eğik çizgi ('/'), iki nokta üst üste (':'), eşittir ('=') ve alt çizgi ('_') içerir.
startCopyIncremental(string, PageBlobStartCopyIncrementalOptions)	Bir sayfa blob'un anlık görüntüsünden bu sayfa blob'una artımlı bir kopya başlatmak için bir işlem başlatır. Anlık görüntü, yalnızca daha önce kopyalanan anlık görüntü arasındaki değişiklik değişiklikleri hedefe aktarılacak şekilde kopyalanır. Kopyalanan anlık görüntüler özgün anlık görüntünün tam kopyalarıdır ve her zamanki gibi okunabilir veya kopyalanabilir.
syncCopyFromURL(string, BlobSyncCopyFromURLOptions)	Zaman uyumlu URL'den Kopyala işlemi bir blobu veya İnternet kaynağını yeni bir bloba kopyalar. Kopya tamamlanana kadar yanıt döndürmez.
undelete(BlobUndeleteOptions)	Geçici olarak silinen blobun içeriğini ve meta verilerini ve ilişkili geçici silinen anlık görüntüleri geri yükler. Blobu Geri Alma yalnızca 2017-07-29 veya sonraki bir sürümde desteklenir.
updateSequenceNumber(SequenceNumberActionType, number, PageBlobUpdateSequenceNumberOptions)	Sayfa blob'larının sıra numarasını ayarlar.
uploadPages(HttpRequestBody, number, number, PageBlobUploadPagesOptions)	Sayfa blob'una 1 veya daha fazla sayfa yazar. Başlangıç ve bitiş uzaklıkları 512'nin katı olmalıdır.
uploadPagesFromURL(string, number, number, number, PageBlobUploadPagesFromURLOptions)	Sayfaları Karşıya Yükle işlemi, içeriklerin BIR URL'den okunduğu bir sayfa blob'una bir sayfa aralığı yazar.
withSnapshot(string)	Kaynakla aynı ancak belirtilen anlık görüntü zaman damgasıyla yeni bir PageBlobClient nesnesi oluşturur. "" değerini sağlayın, anlık görüntüyü kaldırır ve temel bloba bir İstemci döndürür.
withVersion(string)	Bu blobun bir sürümünü işaret eden yeni bir BlobClient nesnesi oluşturur. "" değerini sağlayın, versionId değerini kaldırır ve temel bloba bir İstemci döndürür.

PageBlobClient(string, PipelineLike)

PageBlobClient örneği oluşturur.

new PageBlobClient(url: string, pipeline: PipelineLike)

Parametreler

url: string

Azure Depolama sayfa blobu'na işaret eden "https://myaccount.blob.core.windows.net/mycontainer/pageblob" gibi bir İstemci dizesi. AnonymousCredential kullanıyorsanız , "https://myaccount.blob.core.windows.net/mycontainer/pageblob?sasString" gibi bir SAS ekleyebilirsiniz.

pipeline: PipelineLike

Varsayılan işlem hattı oluşturmak veya özelleştirilmiş bir işlem hattı sağlamak için newPipeline() çağrısında bulunabilirsiniz.

PageBlobClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

PageBlobClient örneği oluşturur. Bu yöntem bir bloba işaret eden kodlanmış bir URL'yi veya kodlanmamış URL'yi kabul eder. Kodlanmış URL dizesi iki kez kaçılmaz, YALNıZCA URL yolundaki özel karakterlerden kaçılır. Blob adından biri varsa? veya %blob adı URL'de kodlanmalıdır.

new PageBlobClient(url: string, credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions)

Parametreler

url: string

Azure Depolama sayfa blobu'na işaret eden "https://myaccount.blob.core.windows.net/mycontainer/pageblob" gibi bir İstemci dizesi. AnonymousCredential kullanıyorsanız , "https://myaccount.blob.core.windows.net/mycontainer/pageblob?sasString" gibi bir SAS ekleyebilirsiniz.

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

AnonymousCredential, StorageSharedKeyCredential gibi veya hizmete yönelik isteklerin kimliğini doğrulamak için @azure/identity paketindeki herhangi bir kimlik bilgisi. TokenCredential arabirimini uygulayan bir nesne de sağlayabilirsiniz. Belirtilmezse, AnonymousCredential kullanılır.

options: StoragePipelineOptions

Opsiyonel. HTTP işlem hattını yapılandırma seçenekleri.

PageBlobClient(string, string, string, StoragePipelineOptions)

PageBlobClient örneği oluşturur.

new PageBlobClient(connectionString: string, containerName: string, blobName: string, options?: StoragePipelineOptions)

Parametreler

connectionString: string

Bir Azure depolama hesabının hesap bağlantı dizesi veya SAS bağlantı dizesi. [ Not - Hesap bağlantı dizesi yalnızca NODE.JS çalışma zamanında kullanılabilir. ] Hesap bağlantı dizesi örneği - SAS bağlantı dizesi örneği DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=accountKey;EndpointSuffix=core.windows.net - BlobEndpoint=https://myaccount.blob.core.windows.net/;QueueEndpoint=https://myaccount.queue.core.windows.net/;FileEndpoint=https://myaccount.file.core.windows.net/;TableEndpoint=https://myaccount.table.core.windows.net/;SharedAccessSignature=sasString

containerName: string

Kapsayıcı adı.

blobName: string

Blob adı.

options: StoragePipelineOptions

Opsiyonel. HTTP işlem hattını yapılandırma seçenekleri.

accountName

accountName: string

Özellik Değeri

string

containerName

Blobun ilişkili olduğu depolama kapsayıcısının adı.

string containerName

Özellik Değeri

string

credential

AnonymousCredential, StorageSharedKeyCredential gibi veya hizmete yönelik isteklerin kimliğini doğrulamak için @azure/identity paketindeki herhangi bir kimlik bilgisi. TokenCredential arabirimini uygulayan bir nesne de sağlayabilirsiniz. Belirtilmezse, AnonymousCredential kullanılır.

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Özellik Değeri

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

name

Blobun adı.

string name

Özellik Değeri

string

url

Kodlanmış URL dizesi değeri.

url: string

Özellik Değeri

string

abortCopyFromURL(string, BlobAbortCopyFromURLOptions)

Bekleyen bir zaman uyumsuz Kopyalama Blobu işlemini durdurur ve sıfır uzunlukta ve tam meta veri içeren bir hedef blob bırakır. Sürüm 2012-02-12 ve daha yeni.

function abortCopyFromURL(copyId: string, options?: BlobAbortCopyFromURLOptions)

Parametreler

copyId: string

URL'den Kopyala işleminin kimliği.

options: BlobAbortCopyFromURLOptions

Blob Url'den Kopyalamayı Durdur işlemi için isteğe bağlı seçenekler.

Döndürülenler

Promise<BlobAbortCopyFromURLResponse>

beginCopyFromURL(string, BlobBeginCopyFromURLOptions)

Blobu zaman uyumsuz olarak depolama hesabı içindeki bir hedefe kopyalar. Bu yöntem, kopya tamamlanana kadar süresiz olarak beklemenize olanak tanıyan uzun süre çalışan bir işlem poller döndürür. Ayrıca, bir kopya tamamlanmadan önce poller üzerindeki cancelOperation çağırarak da iptal edebilirsiniz. İlk istekte işlem tamamlanırsa onProgress geri çağırmasının çağrılmadığını ve tamamlanmış bir kopyanın iptal edilmeye çalışılmasının hataya neden olacağını unutmayın. Sürüm 2012-02-12 ve sonraki sürümlerde, Blobu Kopyalama işleminin kaynağı herhangi bir Azure depolama hesabında kaydedilmiş bir blob olabilir. 2015-02-21 sürümünden başlayarak, Blobu Kopyalama işleminin kaynağı herhangi bir Azure depolama hesabındaki bir Azure dosyası olabilir. Yalnızca 7 Haziran 2012 veya sonrasında oluşturulan depolama hesapları, Blobu Kopyala işleminin başka bir depolama hesabından kopyalamasına izin verir.

function beginCopyFromURL(copySource: string, options?: BlobBeginCopyFromURLOptions)

Parametreler

copySource: string

kaynak Azure Blobu/Dosyası url'si.

options: BlobBeginCopyFromURLOptions

Blob Başlangıç URL'sinden Kopyalama işleminin isteğe bağlı seçenekleri.

Döndürülenler

Promise<PollerLike<PollOperationState<BlobBeginCopyFromURLResponse>, BlobBeginCopyFromURLResponse>>

clearPages(number, number, PageBlobClearPagesOptions)

Belirtilen sayfaları sayfa blobundan serbest kaldırır.

function clearPages(offset?: number, count?: number, options?: PageBlobClearPagesOptions)

Parametreler

offset: number

Temizlemek için sayfaların bayt konumu başlatılıyor.

count: number

Temizlenecek bayt sayısı.

options: PageBlobClearPagesOptions

Sayfa Blobu Sayfaları Temizle işlemine yönelik seçenekler.

Döndürülenler

Promise<PageBlobClearPagesResponse>

Sayfa Blobu Sayfaları Temizle işlemi için yanıt verileri.

create(number, PageBlobCreateOptions)

Belirtilen uzunlukta bir sayfa blobu oluşturur. Veri verilerini bir sayfa blob'una yüklemek için uploadPages'i arayın.

function create(size: number, options?: PageBlobCreateOptions)

Parametreler

size: number

sayfa blobunun boyutu.

options: PageBlobCreateOptions

Sayfa Blobu Oluşturma işleminin seçenekleri.

Döndürülenler

Promise<PageBlobCreateResponse>

Sayfa Blobu Oluşturma işlemi için yanıt verileri.

createIfNotExists(number, PageBlobCreateIfNotExistsOptions)

Belirtilen uzunlukta bir sayfa blobu oluşturur. Veri verilerini bir sayfa blob'una yüklemek için uploadPages'i arayın. Aynı ada sahip blob zaten varsa, mevcut blobun içeriği değişmeden kalır.

function createIfNotExists(size: number, options?: PageBlobCreateIfNotExistsOptions)

Parametreler

size: number

sayfa blobunun boyutu.

options: PageBlobCreateIfNotExistsOptions

Döndürülenler

Promise<PageBlobCreateIfNotExistsResponse>

createSnapshot(BlobCreateSnapshotOptions)

Blobun salt okunur anlık görüntüsünü oluşturur.

function createSnapshot(options?: BlobCreateSnapshotOptions)

Parametreler

options: BlobCreateSnapshotOptions

Blob Anlık Görüntü Oluştur işlemi için isteğe bağlı seçenekler.

Döndürülenler

Promise<BlobCreateSnapshotResponse>

delete(BlobDeleteOptions)

Belirtilen blobu veya anlık görüntüyü silinmek üzere işaretler. Blob daha sonra çöp toplama sırasında silinir. Bir blobu silmek için tüm anlık görüntülerini silmeniz gerektiğini unutmayın. Blobu Sil işlemiyle ikisini de aynı anda silebilirsiniz.

function delete(options?: BlobDeleteOptions)

Parametreler

options: BlobDeleteOptions

Blob Silme işlemi için isteğe bağlı seçenekler.

Döndürülenler

Promise<BlobDeleteResponse>

deleteIfExists(BlobDeleteOptions)

Varsa, belirtilen blobu veya anlık görüntüyü silinmek üzere işaretler. Blob daha sonra çöp toplama sırasında silinir. Bir blobu silmek için tüm anlık görüntülerini silmeniz gerektiğini unutmayın. Blobu Sil işlemiyle ikisini de aynı anda silebilirsiniz.

function deleteIfExists(options?: BlobDeleteOptions)

Parametreler

options: BlobDeleteOptions

Blob Silme işlemi için isteğe bağlı seçenekler.

Döndürülenler

Promise<BlobDeleteIfExistsResponse>

deleteImmutabilityPolicy(BlobDeleteImmutabilityPolicyOptions)

Blobdaki değişmezlik ilkesini silin.

function deleteImmutabilityPolicy(options?: BlobDeleteImmutabilityPolicyOptions)

Parametreler

options: BlobDeleteImmutabilityPolicyOptions

Blobdaki değişmezlik ilkesini silmek için isteğe bağlı seçenekler.

Döndürülenler

Promise<BlobDeleteImmutabilityPolicyResponse>

download(number, number, BlobDownloadOptions)

Meta verileri ve özellikleri dahil olmak üzere bir blobu sistemden okur veya indirir. Anlık görüntüyü okumak için Blob Al'ı da çağırabilirsiniz.

Node.js'de veriler okunabilir bir akışta döndürülebilirStreamBody içinde döndürülüyor
Tarayıcılarda veriler promise blobBody içinde döndürülüyor

function download(offset?: number, count?: number, options?: BlobDownloadOptions)

Parametreler

offset: number

Blobun indirilmesi gereken konumdan, 0'dan büyük veya buna eşit

count: number

ne kadar veri indirileceği, 0'dan büyük. Tanımsız olduğunda sonuna kadar indirilir

options: BlobDownloadOptions

Blob İndirme işlemi için isteğe bağlı seçenekler.

Örnek kullanım (Node.js):

// Download and convert a blob to a string
const downloadBlockBlobResponse = await blobClient.download();
const downloaded = await streamToBuffer(downloadBlockBlobResponse.readableStreamBody);
console.log("Downloaded blob content:", downloaded.toString());

async function streamToBuffer(readableStream) {
return new Promise((resolve, reject) => {
const chunks = [];
readableStream.on("data", (data) => {
chunks.push(data instanceof Buffer ? data : Buffer.from(data));
});
readableStream.on("end", () => {
resolve(Buffer.concat(chunks));
});
readableStream.on("error", reject);
});
}

Örnek kullanım (tarayıcı):

// Download and convert a blob to a string
const downloadBlockBlobResponse = await blobClient.download();
const downloaded = await blobToString(await downloadBlockBlobResponse.blobBody);
console.log(
  "Downloaded blob content",
  downloaded
);

async function blobToString(blob: Blob): Promise<string> {
  const fileReader = new FileReader();
  return new Promise<string>((resolve, reject) => {
    fileReader.onloadend = (ev: any) => {
      resolve(ev.target!.result);
    };
    fileReader.onerror = reject;
    fileReader.readAsText(blob);
  });
}

Döndürülenler

Promise<BlobDownloadResponseParsed>

downloadToBuffer(Buffer, number, number, BlobDownloadToBufferOptions)

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Arabelleğe paralel olarak bir Azure Blobu indirir. Uzaklık ve sayı isteğe bağlıdır, sağlanmazsa blob'un tamamını indirir.

Uyarı: Arabellekler, Node.js/V8 sınırlamaları nedeniyle 32 bit sistemlerde yaklaşık bir gigabayt veya 64 bit sistemlerde yaklaşık iki gigabayt kadar dosyaları destekleyebilir. Bu boyuttan büyük bloblar için <xref:downloadToFile>göz önünde bulundurun.

function downloadToBuffer(buffer: Buffer, offset?: number, count?: number, options?: BlobDownloadToBufferOptions)

Parametreler

buffer: Buffer

Arabellek doldurulacak, uzunluğu sayıdan büyük olmalıdır

offset: number

Blok blobunun indirilmesi gereken konumdan (bayt cinsinden)

count: number

ne kadar veri (bayt cinsinden) indirilecek. Undefined geçirirken sonuna indirilir

options: BlobDownloadToBufferOptions

BlobDownloadToBufferOptions

Döndürülenler

Promise<Buffer>

downloadToBuffer(number, number, BlobDownloadToBufferOptions)

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Arabelleğe paralel olarak bir Azure Blobu indirir. Uzaklık ve sayı isteğe bağlıdır, sağlanmazsa blob'un tamamını indirir.

Uyarı: Arabellekler, Node.js/V8 sınırlamaları nedeniyle 32 bit sistemlerde yaklaşık bir gigabayt veya 64 bit sistemlerde yaklaşık iki gigabayt kadar dosyaları destekleyebilir. Bu boyuttan büyük bloblar için <xref:downloadToFile>göz önünde bulundurun.

function downloadToBuffer(offset?: number, count?: number, options?: BlobDownloadToBufferOptions)

Parametreler

offset: number

Blok blobunun indirilmesi gereken konumdan (bayt cinsinden)

count: number

ne kadar veri (bayt cinsinden) indirilecek. Undefined geçirirken sonuna indirilir

options: BlobDownloadToBufferOptions

BlobDownloadToBufferOptions

Döndürülenler

Promise<Buffer>

downloadToFile(string, number, number, BlobDownloadOptions)

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Azure Blob'ları yerel bir dosyaya indirir. Verilen dosya yolu zaten çıkarsa başarısız olur. Uzaklık ve sayı isteğe bağlıdır, blob'un tamamını indirmek için sırasıyla 0 ve undefined değerini geçirir.

function downloadToFile(filePath: string, offset?: number, count?: number, options?: BlobDownloadOptions)

Parametreler

filePath: string

offset: number

Blok blobunun indirilmesi gereken konumdan.

count: number

ne kadar veri indirileceği. Undefined'i geçirirken sonuna kadar indirilir.

options: BlobDownloadOptions

Blob indirme seçenekleri seçenekleri.

Döndürülenler

Promise<BlobDownloadResponseParsed>

Blob indirme işlemi için yanıt verileri, ancak içeriği zaten okundu ve belirtilen yolda yerel bir dosyaya yazıldığından readableStreamBody tanımsız olarak ayarlandı.

exists(BlobExistsOptions)

Bu istemci tarafından temsil edilen Azure blob kaynağı varsa true döndürür; false olarak ayarlayın. NOT: Mevcut bir blob diğer istemciler veya uygulamalar tarafından silinebileceğinden bu işlevi dikkatli kullanın. Bu işlev tamamlandıktan sonra diğer istemciler veya uygulamalar tarafından yeni bloblar eklenebilir.

function exists(options?: BlobExistsOptions)

Parametreler

options: BlobExistsOptions

seçeneklerine tıklayın.

Döndürülenler

Promise<boolean>

generateSasUrl(BlobGenerateSasUrlOptions)

Yalnızca paylaşılan anahtar kimlik bilgileriyle yapılan BlobClient için kullanılabilir. geçirilen istemci özelliklerine ve parametrelerine göre bir Blob Hizmeti Paylaşılan Erişim İmzası (SAS) URI'sini oluşturur. SAS, istemcinin paylaşılan anahtar kimlik bilgileriyle imzalanır.

function generateSasUrl(options: BlobGenerateSasUrlOptions)

Parametreler

options: BlobGenerateSasUrlOptions

İsteğe bağlı parametreler.

Döndürülenler

Promise<string>

Bu istemci tarafından temsil edilen kaynağın URI'sini ve ardından oluşturulan SAS belirtecini içeren SAS URI'sini.

getAppendBlobClient()

AppendBlobClient nesnesi oluşturur.

function getAppendBlobClient()

Döndürülenler

AppendBlobClient

getBlobLeaseClient(string)

Blob üzerindeki kiraları yöneten bir <xref:BlobLeaseClient> alın.

function getBlobLeaseClient(proposeLeaseId?: string)

Parametreler

proposeLeaseId: string

İlk önerilen kira kimliği.

Döndürülenler

BlobLeaseClient

Blob üzerindeki kiraları yönetmek için yeni bir BlobLeaseClient nesnesi.

getBlockBlobClient()

BlockBlobClient nesnesi oluşturur.

function getBlockBlobClient()

Döndürülenler

BlockBlobClient

getPageBlobClient()

PageBlobClient nesnesi oluşturur.

function getPageBlobClient()

Döndürülenler

PageBlobClient

getPageRanges(number, number, PageBlobGetPageRangesOptions)

Sayfa blobu veya sayfa blobunun anlık görüntüsü için geçerli sayfa aralıklarının listesini döndürür.

function getPageRanges(offset?: number, count?: number, options?: PageBlobGetPageRangesOptions)

Parametreler

offset: number

Sayfa aralıklarının başlangıç bayt konumu.

count: number

Elde edilecek bayt sayısı.

options: PageBlobGetPageRangesOptions

Sayfa Blobu Aralıkları Al işleminin seçenekleri.

Döndürülenler

Promise<PageBlobGetPageRangesResponse>

Sayfa Blobu Aralıkları Al işlemi için yanıt verileri.

getPageRangesDiff(number, number, string, PageBlobGetPageRangesDiffOptions)

Belirtilen anlık görüntü ile bu sayfa blobu arasında farklılık gösteren sayfa aralıkları koleksiyonunu alır.

function getPageRangesDiff(offset: number, count: number, prevSnapshot: string, options?: PageBlobGetPageRangesDiffOptions)

Parametreler

offset: number

Sayfa blobunun bayt konumunu başlatma

count: number

Fark aralıkları elde etmek için bayt sayısı.

prevSnapshot: string

Farkı almak için anlık görüntünün zaman damgası.

options: PageBlobGetPageRangesDiffOptions

Sayfa Blobu Sayfa Aralıklarını Al Fark işleminin seçenekleri.

Döndürülenler

Promise<PageBlobGetPageRangesDiffResponse>

Sayfa Blobu Sayfa Aralığı Farkını Al işleminin yanıt verileri.

getPageRangesDiffForManagedDisks(number, number, string, PageBlobGetPageRangesDiffOptions)

Yönetilen diskler için belirtilen anlık görüntü ile bu sayfa blobu arasında farklılık gösteren sayfa aralıkları koleksiyonunu alır.

function getPageRangesDiffForManagedDisks(offset: number, count: number, prevSnapshotUrl: string, options?: PageBlobGetPageRangesDiffOptions)

Parametreler

offset: number

Sayfa blobunun bayt konumunu başlatma

count: number

Fark aralıkları elde etmek için bayt sayısı.

prevSnapshotUrl: string

Farkı almak için anlık görüntünün URL'si.

options: PageBlobGetPageRangesDiffOptions

Sayfa Blobu Sayfa Aralıklarını Al Fark işleminin seçenekleri.

Döndürülenler

Promise<PageBlobGetPageRangesDiffResponse>

Sayfa Blobu Sayfa Aralığı Farkını Al işleminin yanıt verileri.

getProperties(BlobGetPropertiesOptions)

Blob için tüm kullanıcı tanımlı meta verileri, standart HTTP özelliklerini ve sistem özelliklerini döndürür. Blobun içeriğini döndürmez.

function getProperties(options?: BlobGetPropertiesOptions)

Parametreler

options: BlobGetPropertiesOptions

Özellikleri Al işlemi için isteğe bağlı seçenekler.

Döndürülenler

Promise<BlobGetPropertiesResponse>

getTags(BlobGetTagsOptions)

Temel alınan blobla ilişkili etiketleri alır.

function getTags(options?: BlobGetTagsOptions)

Parametreler

options: BlobGetTagsOptions

Döndürülenler

Promise<BlobGetTagsResponse>

resize(number, PageBlobResizeOptions)

Sayfa blobunu belirtilen boyuta (512'nin katı olmalıdır) yeniden boyutlandırıyor.

function resize(size: number, options?: PageBlobResizeOptions)

Parametreler

size: number

Hedef boyut

options: PageBlobResizeOptions

Sayfa Blobunu Yeniden Boyutlandırma işleminin seçenekleri.

Döndürülenler

Promise<PageBlobResizeResponse>

Sayfa Blobu Yeniden Boyutlandırma işlemi için yanıt verileri.

setAccessTier(BlockBlobTier | PremiumPageBlobTier | string, BlobSetTierOptions)

Blob üzerindeki katmanı ayarlar. İşleme premium depolama hesabındaki bir sayfa blobunda ve blob depolama hesabındaki bir blok blobunda izin verilir (yalnızca yerel olarak yedekli depolama). Premium sayfa blobunun katmanı blobun izin verilen boyutunu, IOPS'sini ve bant genişliğini belirler. Blok blobu katmanı Sık Erişimli/Seyrek Erişimli/Arşiv depolama türünü belirler. Bu işlem blob'un ETag'ini güncelleştirmez.

function setAccessTier(tier: BlockBlobTier | PremiumPageBlobTier | string, options?: BlobSetTierOptions)

Parametreler

tier: BlockBlobTier | PremiumPageBlobTier | string

Blobda ayarlanacak katman. Geçerli değerler Sık Erişimli, Seyrek Erişimli veya Arşiv'tir.

options: BlobSetTierOptions

Blob Kümesi Katmanı işlemi için isteğe bağlı seçenekler.

Döndürülenler

Promise<BlobSetTierResponse>

setHTTPHeaders(BlobHTTPHeaders, BlobSetHTTPHeadersOptions)

Blob üzerindeki sistem özelliklerini ayarlar. Belirtilen blob HTTP üst bilgileri için değer sağlanmazsa veya değer sağlanmazsa, değeri olmayan bu blob HTTP üst bilgileri temizlenir.

function setHTTPHeaders(blobHTTPHeaders?: BlobHTTPHeaders, options?: BlobSetHTTPHeadersOptions)

Parametreler

blobHTTPHeaders: BlobHTTPHeaders

Belirtilen blob HTTP üst bilgileri için değer sağlanmazsa veya değer sağlanmazsa, değeri olmayan bu blob HTTP üst bilgileri temizlenir. Tarayıcının dosya türüne göre işlevsellik sağlaması blobContentType ortak bir üst bilgi ayarlanır.

options: BlobSetHTTPHeadersOptions

Blob Küme HTTP Üst Bilgileri işlemi için isteğe bağlı seçenekler.

Döndürülenler

Promise<BlobSetHTTPHeadersResponse>

setImmutabilityPolicy(BlobImmutabilityPolicy, BlobSetImmutabilityPolicyOptions)

Blob üzerinde değişmezlik ilkesi ayarlayın.

function setImmutabilityPolicy(immutabilityPolicy: BlobImmutabilityPolicy, options?: BlobSetImmutabilityPolicyOptions)

Parametreler

immutabilityPolicy: BlobImmutabilityPolicy

options: BlobSetImmutabilityPolicyOptions

Blob üzerinde değişmezlik ilkesini ayarlamak için isteğe bağlı seçenekler.

Döndürülenler

Promise<BlobSetImmutabilityPolicyResponse>

setLegalHold(boolean, BlobSetLegalHoldOptions)

Blob üzerinde yasal saklama ayarlayın.

function setLegalHold(legalHoldEnabled: boolean, options?: BlobSetLegalHoldOptions)

Parametreler

legalHoldEnabled: boolean

options: BlobSetLegalHoldOptions

Blob üzerinde yasal saklamayı ayarlamak için isteğe bağlı seçenekler.

Döndürülenler

Promise<BlobSetLegalHoldResponse>

setMetadata(Metadata, BlobSetMetadataOptions)

Belirtilen blob için kullanıcı tanımlı meta verileri bir veya daha fazla ad-değer çifti olarak ayarlar. Seçenek sağlanmadıysa veya parametrede tanımlı meta veri yoksa blob meta verileri kaldırılır.

function setMetadata(metadata?: Metadata, options?: BlobSetMetadataOptions)

Parametreler

metadata: Metadata

Var olan meta verileri bu değerle değiştirin. Değer sağlanmazsa, mevcut meta veriler kaldırılır.

options: BlobSetMetadataOptions

Meta Veri Ayarlama işlemi için isteğe bağlı seçenekler.

Döndürülenler

Promise<BlobSetMetadataResponse>

setTags(Tags, BlobSetTagsOptions)

Temel alınan blob üzerindeki etiketleri ayarlar. Bir blobda en fazla 10 etiket olabilir. Etiket anahtarları 1 ile 128 karakter arasında olmalıdır. Etiket değerleri 0 ile 256 karakter arasında olmalıdır. Geçerli etiket anahtarı ve değer karakterleri küçük ve büyük harf, basamak (0-9), boşluk (' '), artı ('+'), eksi ('-'), nokta ('.'), eğik çizgi ('/'), iki nokta üst üste (':'), eşittir ('=') ve alt çizgi ('_') içerir.

function setTags(tags: Tags, options?: BlobSetTagsOptions)

Parametreler

tags: Tags

options: BlobSetTagsOptions

Döndürülenler

Promise<BlobSetTagsResponse>

startCopyIncremental(string, PageBlobStartCopyIncrementalOptions)

Bir sayfa blob'un anlık görüntüsünden bu sayfa blob'una artımlı bir kopya başlatmak için bir işlem başlatır. Anlık görüntü, yalnızca daha önce kopyalanan anlık görüntü arasındaki değişiklik değişiklikleri hedefe aktarılacak şekilde kopyalanır. Kopyalanan anlık görüntüler özgün anlık görüntünün tam kopyalarıdır ve her zamanki gibi okunabilir veya kopyalanabilir.

function startCopyIncremental(copySource: string, options?: PageBlobStartCopyIncrementalOptions)

Parametreler

copySource: string

Kaynak sayfa blob anlık görüntüsünün adını belirtir. Örneğin, https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>

options: PageBlobStartCopyIncrementalOptions

Sayfa Blobu Kopyalama Artımlı işlemi seçenekleri.

Döndürülenler

Promise<PageBlobCopyIncrementalResponse>

Sayfa Blobu Kopyalama Artımlı işlemi için yanıt verileri.

syncCopyFromURL(string, BlobSyncCopyFromURLOptions)

Zaman uyumlu URL'den Kopyala işlemi bir blobu veya İnternet kaynağını yeni bir bloba kopyalar. Kopya tamamlanana kadar yanıt döndürmez.

function syncCopyFromURL(copySource: string, options?: BlobSyncCopyFromURLOptions)

Parametreler

copySource: string

Kopyalanacak kaynak URL, Kimlik doğrulaması için paylaşılan erişim imzası (SAS) gerekebilir

options: BlobSyncCopyFromURLOptions

Döndürülenler

Promise<BlobCopyFromURLResponse>

undelete(BlobUndeleteOptions)

Geçici olarak silinen blobun içeriğini ve meta verilerini ve ilişkili geçici silinen anlık görüntüleri geri yükler. Blobu Geri Alma yalnızca 2017-07-29 veya sonraki bir sürümde desteklenir.

function undelete(options?: BlobUndeleteOptions)

Parametreler

options: BlobUndeleteOptions

Blob Silme işleminin isteğe bağlı seçenekleri.

Döndürülenler

Promise<BlobUndeleteResponse>

updateSequenceNumber(SequenceNumberActionType, number, PageBlobUpdateSequenceNumberOptions)

Sayfa blob'larının sıra numarasını ayarlar.

function updateSequenceNumber(sequenceNumberAction: SequenceNumberActionType, sequenceNumber?: number, options?: PageBlobUpdateSequenceNumberOptions)

Parametreler

sequenceNumberAction: SequenceNumberActionType

Hizmetin blob'un sıra numarasını nasıl değiştirmesi gerektiğini gösterir.

sequenceNumber: number

sequenceNumberAction max veya update ise gereklidir

options: PageBlobUpdateSequenceNumberOptions

Sayfa Blobu Güncelleştirme Sıra Numarası işleminin seçenekleri.

Döndürülenler

Promise<PageBlobUpdateSequenceNumberResponse>

Sayfa Blobu Güncelleştirme Sıra Numarası işlemi için yanıt verileri.

uploadPages(HttpRequestBody, number, number, PageBlobUploadPagesOptions)

Sayfa blob'una 1 veya daha fazla sayfa yazar. Başlangıç ve bitiş uzaklıkları 512'nin katı olmalıdır.

function uploadPages(body: HttpRequestBody, offset: number, count: number, options?: PageBlobUploadPagesOptions)

Parametreler

body: HttpRequestBody

Karşıya yüklenecek veriler

offset: number

Hedef sayfa blobunun uzaklığı

count: number

Gövdenin içerik uzunluğu, ayrıca karşıya yüklenecek bayt sayısı

options: PageBlobUploadPagesOptions

Sayfa Blobu Sayfaları Karşıya Yükleme işleminin seçenekleri.

Döndürülenler

Promise<PageBlobUploadPagesResponse>

Sayfa Blobu Sayfaları Karşıya Yükleme işlemi için yanıt verileri.

uploadPagesFromURL(string, number, number, number, PageBlobUploadPagesFromURLOptions)

Sayfaları Karşıya Yükle işlemi, içeriklerin BIR URL'den okunduğu bir sayfa blob'una bir sayfa aralığı yazar.

function uploadPagesFromURL(sourceURL: string, sourceOffset: number, destOffset: number, count: number, options?: PageBlobUploadPagesFromURLOptions)

Parametreler

sourceURL: string

Kimlik doğrulaması için gerekli olabilir, Paylaşılan Erişim İmzası (SAS) olan kopyalama kaynağının URL'sini belirtin

sourceOffset: number

Kopyalanacak kaynak uzaklığı. Kaynak sayfa blobunun başından kopyalanacak 0 değerini geçirme

destOffset: number

Hedef sayfa blobunun uzaklığı

count: number

Kaynak sayfa blobundan karşıya yüklenecek bayt sayısı

options: PageBlobUploadPagesFromURLOptions

Döndürülenler

Promise<PageBlobUploadPagesFromURLResponse>

withSnapshot(string)

Kaynakla aynı ancak belirtilen anlık görüntü zaman damgasıyla yeni bir PageBlobClient nesnesi oluşturur. "" değerini sağlayın, anlık görüntüyü kaldırır ve temel bloba bir İstemci döndürür.

function withSnapshot(snapshot: string)

Parametreler

snapshot: string

Anlık görüntü zaman damgası.

Döndürülenler

PageBlobClient

Kaynakla aynı ancak belirtilen anlık görüntü zaman damgasına sahip yeni bir PageBlobClient nesnesi.

withVersion(string)

Bu blobun bir sürümünü işaret eden yeni bir BlobClient nesnesi oluşturur. "" değerini sağlayın, versionId değerini kaldırır ve temel bloba bir İstemci döndürür.

function withVersion(versionId: string)

Parametreler

versionId: string

versionId.

Döndürülenler

BlobClient

Bu blobun sürümüne işaret eden yeni bir BlobClient nesnesi.

PageBlobClient class

Oluşturucular

Özellikler

Yöntemler

Oluşturucu Ayrıntıları

PageBlobClient(string, PipelineLike)

Parametreler

PageBlobClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

Parametreler

PageBlobClient(string, string, string, StoragePipelineOptions)

Parametreler

Özellik Ayrıntıları

accountName

Özellik Değeri

containerName

Özellik Değeri

credential

Özellik Değeri

name

Özellik Değeri

url

Özellik Değeri

Yöntem Ayrıntıları

abortCopyFromURL(string, BlobAbortCopyFromURLOptions)

Parametreler

Döndürülenler

beginCopyFromURL(string, BlobBeginCopyFromURLOptions)

Parametreler

Döndürülenler

clearPages(number, number, PageBlobClearPagesOptions)

Parametreler

Döndürülenler

create(number, PageBlobCreateOptions)

Parametreler

Döndürülenler

createIfNotExists(number, PageBlobCreateIfNotExistsOptions)

Parametreler

Döndürülenler

createSnapshot(BlobCreateSnapshotOptions)

Parametreler

Döndürülenler

delete(BlobDeleteOptions)

Parametreler

Döndürülenler

deleteIfExists(BlobDeleteOptions)

Parametreler

Döndürülenler

deleteImmutabilityPolicy(BlobDeleteImmutabilityPolicyOptions)

Parametreler

Döndürülenler

download(number, number, BlobDownloadOptions)

Parametreler

Döndürülenler

downloadToBuffer(Buffer, number, number, BlobDownloadToBufferOptions)

Parametreler

Döndürülenler

downloadToBuffer(number, number, BlobDownloadToBufferOptions)

Parametreler

Döndürülenler

downloadToFile(string, number, number, BlobDownloadOptions)

Parametreler

Döndürülenler

exists(BlobExistsOptions)

Parametreler

Döndürülenler

generateSasUrl(BlobGenerateSasUrlOptions)

Parametreler

Döndürülenler

getAppendBlobClient()

Döndürülenler

getBlobLeaseClient(string)

Parametreler

Döndürülenler

getBlockBlobClient()

Döndürülenler

getPageBlobClient()

Döndürülenler

getPageRanges(number, number, PageBlobGetPageRangesOptions)

Parametreler

Döndürülenler