BlockBlobClient class

  • 參考
套件:
@azure/storage-blob

BlockBlobClient 會定義一組適用于區塊 Blob 的作業。

Extends
BlobClient

建構函式

BlockBlobClient(string, PipelineLike)

建立 BlockBlobClient 的實例。 此方法接受指向區塊 Blob 的編碼 URL 或非編碼 URL。 編碼的 URL 字串不會逸出兩次，只會逸出 URL 路徑中的特殊字元。 如果 Blob 名稱包含 ？ 或 %blob 名稱必須在 URL 中編碼。
BlockBlobClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

建立 BlockBlobClient 的實例。 此方法接受指向區塊 Blob 的編碼 URL 或非編碼 URL。 編碼的 URL 字串不會逸出兩次，只會逸出 URL 路徑中的特殊字元。 如果 Blob 名稱包含 ？ 或 %blob 名稱必須在 URL 中編碼。
BlockBlobClient(string, string, string, StoragePipelineOptions)

建立 BlockBlobClient 的實例。

屬性

containerName

與 Blob 相關聯之儲存體容器的名稱。
name

Blob 的名稱。

繼承的屬性

accountName
credential

例如 AnonymousCredential、StorageSharedKeyCredential 或任何來自套件的 @azure/identity 認證，以驗證對服務的要求。 您也可以提供實作 TokenCredential 介面的物件。 如果未指定，則會使用 AnonymousCredential。
url

編碼的 URL 字串值。

方法

commitBlockList(string[], BlockBlobCommitBlockListOptions)

透過指定組成 Blob 的區塊識別碼清單，將 Blob 寫入。 若要寫入為 Blob 的一部分，區塊必須在先前 的 stageBlock 作業中成功寫入伺服器。 您可以只上傳已變更的區塊，然後一起認可新的和現有的區塊，以呼叫 commitBlockList 來更新 Blob。 區塊清單中未指定且永久刪除的任何區塊。

請參閱https://docs.microsoft.com/rest/api/storageservices/put-block-list
getBlockList(BlockListType, BlockBlobGetBlockListOptions)

使用指定的區塊清單篩選，傳回已上傳為區塊 Blob 一部分的區塊清單。

請參閱https://docs.microsoft.com/rest/api/storageservices/get-block-list
query(string, BlockBlobQueryOptions)

僅適用于NODE.JS執行時間。

JSON 或 CSV 格式 Blob 的快速查詢。

範例使用方式 (Node.js) ：

// Query and convert a blob to a string
const queryBlockBlobResponse = await blockBlobClient.query("select * from BlobStorage");
const downloaded = (await streamToBuffer(queryBlockBlobResponse.readableStreamBody)).toString();
console.log("Query blob content:", downloaded);

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);
  });
}
stageBlock(string, HttpRequestBody, number, BlockBlobStageBlockOptions)

將指定的區塊上傳至區塊 Blob 的「暫存區域」，以便稍後透過呼叫 commitBlockList 來認可。

請參閱https://docs.microsoft.com/rest/api/storageservices/put-block
stageBlockFromURL(string, string, number, number, BlockBlobStageBlockFromURLOptions)

階段封鎖 URL 作業會建立要認可的新區塊，作為從 URL 讀取內容的 Blob 的一部分。 從 2018-03-28 版開始，即可使用此 API。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/put-block-from-url
syncUploadFromURL(string, BlockBlobSyncUploadFromURLOptions)

建立新的區塊 Blob，其中 Blob 的內容是從指定的 URL 讀取。 從 2020-04-08 版本開始，支援此 API。 從 URL 放置 Blob 不支援部分更新;現有 Blob 的內容會以新 Blob 的內容覆寫。 若要使用來源 URL 對區塊 Blob 的內容執行部分更新，請使用 stageBlockFromURL 和 commitBlockList。
upload(HttpRequestBody, number, BlockBlobUploadOptions)

建立新的區塊 Blob，或更新現有區塊 Blob 的內容。 更新現有的區塊 Blob 會覆寫 Blob 中所有的現有中繼資料。 不支援部分更新;現有 Blob 的內容會以新內容覆寫。 若要執行區塊 Blob 的部分更新，請使用 stageBlock 和 commitBlockList。

這是非平行上傳方法，請使用 uploadFile、 uploadStream 或 uploadBrowserData ，以提升並行上傳的效能。

請參閱https://docs.microsoft.com/rest/api/storageservices/put-blob
uploadBrowserData(Blob | ArrayBuffer | ArrayBufferView, BlockBlobParallelUploadOptions)

僅適用于瀏覽器。

將瀏覽器 Blob/File/ArrayBuffer/ArrayBufferView 物件上傳至區塊 Blob。

當緩衝區長度小於或等於 256MB 時，此方法會使用 1 個上傳呼叫來完成上傳。 否則，這個方法會呼叫 stageBlock 以上傳區塊，最後呼叫 commitBlockList 來認可區塊清單。

要設定的常見 blobHTTPHeaders 選項是 blobContentType ，可讓瀏覽器根據檔案類型提供功能。
uploadData(Blob | ArrayBuffer | ArrayBufferView | Buffer, BlockBlobParallelUploadOptions)

將 Buffer (Node.js) /Blob (瀏覽器上傳至 BlockBlob) /ArrayBuffer/ArrayBufferView 物件。

當資料長度不超過指定的 maxSingleShotSize (預設值 <xref:BLOCK_BLOB_MAX_UPLOAD_BLOB_BYTES> 為) 時，此方法會使用 1 個 上傳 呼叫來完成上傳。 否則，這個方法會呼叫 stageBlock 以上傳區塊，最後呼叫 commitBlockList 來認可區塊清單。

要設定的常見 blobHTTPHeaders 選項是 blobContentType ，可讓瀏覽器根據檔案類型提供功能。
uploadFile(string, BlockBlobParallelUploadOptions)

僅適用于NODE.JS執行時間。

將區塊中的本機檔案上傳至區塊 Blob。

當檔案大小小於或等於 256MB 時，此方法會使用 1 個上傳呼叫來完成上傳。 否則，這個方法會呼叫 stageBlock 以上傳區塊，最後呼叫 commitBlockList 來認可區塊清單。
uploadStream(Readable, number, number, BlockBlobUploadStreamOptions)

僅適用于NODE.JS執行時間。

將Node.js可讀取的資料流程上傳至區塊 Blob。

效能改進秘訣：

  • 輸入資料流程 highWaterMark 最好是使用 bufferSize 參數來設定相同的值，以避免 Buffer.concat () 作業。
withSnapshot(string)

建立與來源相同的新 BlockBlobClient 物件，但具有指定的快照集時間戳記。 提供 「」 會移除快照集，並傳回基底 Blob 的 URL。

繼承的方法

abortCopyFromURL(string, BlobAbortCopyFromURLOptions)

中止暫止的非同步複製 Blob 作業，並保留長度為零和完整中繼資料的目的地 Blob。 2012-02-12 版及更新版本。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/abort-copy-blob
beginCopyFromURL(string, BlobBeginCopyFromURLOptions)

以非同步方式將 Blob 複製到儲存體帳戶內的目的地。 這個方法會傳回長時間執行的作業輪詢器，可讓您無限期等候直到複製完成為止。 您也可以藉由在輪詢器上呼叫 cancelOperation 來取消複本，再取消複本。 請注意，如果作業在第一個要求中完成，而且嘗試取消完成的複本會導致擲回錯誤，則不會叫用 onProgress 回呼。

在 2012-02-12 版和更新版本中，複製 Blob 作業的來源可以是任何 Azure 儲存體帳戶中認可的 Blob。 從 2015-02-21 版開始，複製 Blob 作業的來源可以是任何 Azure 儲存體帳戶中的 Azure 檔案。 只有在 2012 年 6 月 7 日當天或之後所建立的儲存體帳戶，才可讓您在執行複製 Blob 作業時從另一個儲存體帳戶複製 Blob。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/copy-blob

使用自動輪詢的範例：

const copyPoller = await blobClient.beginCopyFromURL('url');
const result = await copyPoller.pollUntilDone();

使用手動輪詢的範例：

const copyPoller = await blobClient.beginCopyFromURL('url');
while (!poller.isDone()) {
   await poller.poll();
}
const result = copyPoller.getResult();

使用進度更新的範例：

const copyPoller = await blobClient.beginCopyFromURL('url', {
  onProgress(state) {
    console.log(`Progress: ${state.copyProgress}`);
  }
});
const result = await copyPoller.pollUntilDone();

使用變更輪詢間隔的範例， (預設為 15 秒) ：

const copyPoller = await blobClient.beginCopyFromURL('url', {
  intervalInMs: 1000 // poll blob every 1 second for copy progress
});
const result = await copyPoller.pollUntilDone();

使用複製取消的範例：

const copyPoller = await blobClient.beginCopyFromURL('url');
// cancel operation after starting it.
try {
  await copyPoller.cancelOperation();
  // calls to get the result now throw PollerCancelledError
  await copyPoller.getResult();
} catch (err) {
  if (err.name === 'PollerCancelledError') {
    console.log('The copy was cancelled.');
  }
}
createSnapshot(BlobCreateSnapshotOptions)

建立 Blob 的唯讀快照集。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/snapshot-blob
delete(BlobDeleteOptions)

標示要刪除的指定 Blob 或快照集。 Blob 稍後會在記憶體回收時刪除。 請注意，若要刪除 Blob，您必須刪除其所有快照集。 您可以使用刪除 Blob 作業同時刪除這兩者。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob
deleteIfExists(BlobDeleteOptions)

如果指定 Blob 或快照集存在，請將其標示為刪除。 Blob 稍後會在記憶體回收時刪除。 請注意，若要刪除 Blob，您必須刪除其所有快照集。 您可以使用刪除 Blob 作業同時刪除這兩者。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob
deleteImmutabilityPolicy(BlobDeleteImmutabilityPolicyOptions)

刪除 Blob 上的不可變原則。
download(number, number, BlobDownloadOptions)

從系統讀取或下載 Blob，包括其中繼資料和屬性。 您也可以呼叫取得 Blob 來讀取快照集。

  • 在 Node.js 中，資料會在可讀取的資料流程 readableStreamBody 中傳回
  • 在瀏覽器中，資料會在 promise blobBody 中傳回

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob
downloadToBuffer(Buffer, number, number, BlobDownloadToBufferOptions)

僅適用于NODE.JS執行時間。

平行下載 Azure Blob 至緩衝區。 位移和計數是選擇性的，如果未提供，則會下載整個 Blob。

警告：緩衝區最多隻能支援 32 位系統上大約一 GB 的檔案，或 64 位系統上最多支援兩 GB 的檔案，因為Node.js/V8 的限制。 對於大於此大小的 Blob，請考慮 downloadToFile。
downloadToBuffer(number, number, BlobDownloadToBufferOptions)

僅適用于NODE.JS執行時間。

平行下載 Azure Blob 至緩衝區。 位移和計數是選擇性的，如果未提供，則會下載整個 Blob。

警告：緩衝區最多隻能支援 32 位系統上大約一 GB 的檔案，或 64 位系統上最多支援兩 GB 的檔案，因為Node.js/V8 的限制。 對於大於此大小的 Blob，請考慮 downloadToFile。
downloadToFile(string, number, number, BlobDownloadOptions)

僅適用于NODE.JS執行時間。

將 Azure Blob 下載到本機檔案。 如果指定的檔案路徑已結束，則失敗。 位移和計數是選擇性的，分別傳遞 0 和未定義，以下載整個 Blob。
exists(BlobExistsOptions)

如果此用戶端所代表的 Azure Blob 資源存在，則傳回 true;否則為 false。

注意：請小心使用此函式，因為其他用戶端或應用程式可能會刪除現有的 Blob。 反之亦然，此函式完成後，其他用戶端或應用程式可能會新增新的 Blob。
generateSasUrl(BlobGenerateSasUrlOptions)

僅適用于使用共用金鑰認證建構的 BlobClient。

根據傳入的用戶端屬性和參數，產生 Blob 服務共用存取簽章 (SAS) URI。 SAS 是由用戶端的共用金鑰認證所簽署。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
getAppendBlobClient()

建立 AppendBlobClient 物件。
getBlobLeaseClient(string)

取得 管理 Blob 租用的 BlobLeaseClient 。
getBlockBlobClient()

建立 BlockBlobClient 物件。
getPageBlobClient()

建立 PageBlobClient 物件。
getProperties(BlobGetPropertiesOptions)

傳回 Blob 之所有使用者定義的中繼資料、標準 HTTP 屬性及系統屬性。 但不會傳回 Blob 的內容。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-properties

警告： metadata 回應中傳回的物件會以小寫顯示其索引鍵，即使其原本包含大寫字元也一樣。 這與使用 選項列出 Blob includeMetadata 的ContainerClient方法所傳回的中繼資料金鑰不同，此選項會保留其原始大小寫。
getTags(BlobGetTagsOptions)

取得與基礎 Blob 相關聯的標記。
setAccessTier(string, BlobSetTierOptions)

設定 Blob 上的階層。 在進階儲存體帳戶中的分頁 Blob 和 Blob 儲存體帳戶中的區塊 Blob 上，允許此作業 (本機備援儲存體) 。 進階分頁 Blob 的層會決定 Blob 的允許大小、IOPS 和頻寬。 區塊 Blob 的層會決定經常性存取/非經常性存取/封存儲存體類型。 這項作業不會更新 Blob 的 ETag。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-tier
setHTTPHeaders(BlobHTTPHeaders, BlobSetHTTPHeadersOptions)

在 Blob 上設定系統屬性。

如果未提供任何值，或未為指定的 Blob HTTP 標頭提供任何值，則會清除沒有值的這些 Blob HTTP 標頭。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties
setImmutabilityPolicy(BlobImmutabilityPolicy, BlobSetImmutabilityPolicyOptions)

在 Blob 上設定不可變原則。
setLegalHold(boolean, BlobSetLegalHoldOptions)

在 Blob 上設定合法保存。
setMetadata(Metadata, BlobSetMetadataOptions)

將指定 Blob 的使用者定義中繼資料設為一或多個名稱/值配對。

如果未提供任何選項，或參數中未定義任何中繼資料，則會移除 Blob 中繼資料。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata
setTags(Tags, BlobSetTagsOptions)

設定基礎 Blob 上的標記。 Blob 最多可以有 10 個標記。 標記索引鍵必須介於 1 到 128 個字元之間。 標籤值必須介於 0 到 256 個字元之間。 有效的標記索引鍵和值字元包括小寫字母和大寫字母、數位 (0-9) 、空格 (' ') ，加上 ('+') 、減 ('-') 、句號 ('。') 、正斜線 ('/') 、冒號 ('：') 、等於 ('=') ，以及底線 ('_') 。
syncCopyFromURL(string, BlobSyncCopyFromURLOptions)

同步複製來源 URL 作業會將 Blob 或網際網路資源複製到新的 Blob。 在複製完成之前，它不會傳迴響應。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/copy-blob-from-url
undelete(BlobUndeleteOptions)

還原虛刪除 Blob 的內容和中繼資料，以及任何相關聯的虛刪除快照集。 只有 2017-07-29 版或更新版本才支援取消刪除 Blob。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/undelete-blob
withVersion(string)

建立指向此 Blob 版本的新 BlobClient 物件。 提供 「」 會移除 versionId，並將用戶端傳回基底 Blob。

建構函式詳細資料

BlockBlobClient(string, PipelineLike)

建立 BlockBlobClient 的實例。 此方法接受指向區塊 Blob 的編碼 URL 或非編碼 URL。 編碼的 URL 字串不會逸出兩次，只會逸出 URL 路徑中的特殊字元。 如果 Blob 名稱包含 ？ 或 %blob 名稱必須在 URL 中編碼。

new BlockBlobClient(url: string, pipeline: PipelineLike)

參數

url

string

指向 Azure 儲存體區塊 Blob 的 URL 字串，例如 「 https://myaccount.blob.core.windows.net/mycontainer/blockblob" ;。 如果使用 AnonymousCredential，您可以附加 SAS，例如 「 https://myaccount.blob.core.windows.net/mycontainer/blockblob?sasString" ;。 此方法接受指向 Blob 的編碼 URL 或非編碼 URL。 編碼的 URL 字串不會逸出兩次，只會逸出 URL 路徑中的特殊字元。 不過，如果 Blob 名稱包含 ？ 或 %blob 名稱必須在 URL 中編碼。 例如名為 「my？blob%」 的 Blob，URL 應該是 「 https://myaccount.blob.core.windows.net/mycontainer/my%3Fblob%25" ;。

pipeline
PipelineLike

呼叫 newPipeline () 以建立預設管線，或提供自訂管線。

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

建立 BlockBlobClient 的實例。 此方法接受指向區塊 Blob 的編碼 URL 或非編碼 URL。 編碼的 URL 字串不會逸出兩次，只會逸出 URL 路徑中的特殊字元。 如果 Blob 名稱包含 ？ 或 %blob 名稱必須在 URL 中編碼。

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

參數

url

string

指向 Azure 儲存體區塊 Blob 的 URL 字串，例如 「 https://myaccount.blob.core.windows.net/mycontainer/blockblob" ;。 如果使用 AnonymousCredential，您可以附加 SAS，例如 「 https://myaccount.blob.core.windows.net/mycontainer/blockblob?sasString" ;。 此方法接受指向 Blob 的編碼 URL 或非編碼 URL。 編碼的 URL 字串不會逸出兩次，只會逸出 URL 路徑中的特殊字元。 不過，如果 Blob 名稱包含 ？ 或 %blob 名稱必須在 URL 中編碼。 例如名為 「my？blob%」 的 Blob，URL 應該是 「 https://myaccount.blob.core.windows.net/mycontainer/my%3Fblob%25" ;。

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

例如 AnonymousCredential、StorageSharedKeyCredential 或任何來自套件的 @azure/identity 認證，以驗證對服務的要求。 您也可以提供實作 TokenCredential 介面的物件。 如果未指定，則會使用 AnonymousCredential。

options
StoragePipelineOptions

選擇性。 設定 HTTP 管線的選項。

BlockBlobClient(string, string, string, StoragePipelineOptions)

建立 BlockBlobClient 的實例。

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

參數

connectionString

string

帳戶連接字串或 Azure 儲存體帳戶的 SAS 連接字串。 [ 注意 - 帳戶連接字串只能用於NODE.JS執行時間。 ] 帳戶連接字串範例 -DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=accountKey;EndpointSuffix=core.windows.net SAS 連接字串範例 - 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

容器名稱。

blobName

string

Blob 名稱。

options
StoragePipelineOptions

選擇性。 設定 HTTP 管線的選項。

屬性詳細資料

containerName

與 Blob 相關聯之儲存體容器的名稱。

string containerName

屬性值

string

name

Blob 的名稱。

string name

屬性值

string

繼承的屬性詳細資料

accountName 

accountName: string

屬性值

string

繼承自BlobClient.accountName

credential

例如 AnonymousCredential、StorageSharedKeyCredential 或任何來自套件的 @azure/identity 認證，以驗證對服務的要求。 您也可以提供實作 TokenCredential 介面的物件。 如果未指定，則會使用 AnonymousCredential。

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

屬性值

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

繼承自BlobClient.credential

url

編碼的 URL 字串值。

url: string

屬性值

string

繼承自BlobClient.url

方法詳細資料

commitBlockList(string[], BlockBlobCommitBlockListOptions)

透過指定組成 Blob 的區塊識別碼清單，將 Blob 寫入。 若要寫入為 Blob 的一部分，區塊必須在先前 的 stageBlock 作業中成功寫入伺服器。 您可以只上傳已變更的區塊，然後一起認可新的和現有的區塊，以呼叫 commitBlockList 來更新 Blob。 區塊清單中未指定且永久刪除的任何區塊。

請參閱https://docs.microsoft.com/rest/api/storageservices/put-block-list

function commitBlockList(blocks: string[], options?: BlockBlobCommitBlockListOptions): Promise<BlockBlobCommitBlockListResponse>

參數

blocks

string[]

base64 編碼的 64 位元組值陣列

options
BlockBlobCommitBlockListOptions

區塊 Blob 認可區塊清單作業的選項。

傳回

Promise<BlockBlobCommitBlockListResponse>

區塊 Blob 認可區塊清單作業的回應資料。

getBlockList(BlockListType, BlockBlobGetBlockListOptions)

使用指定的區塊清單篩選，傳回已上傳為區塊 Blob 一部分的區塊清單。

請參閱https://docs.microsoft.com/rest/api/storageservices/get-block-list

function getBlockList(listType: BlockListType, options?: BlockBlobGetBlockListOptions): Promise<BlockBlobGetBlockListResponse>

參數

listType
BlockListType

指定傳回認可的區塊清單、未認可的區塊清單，或兩種清單一起傳回。

options
BlockBlobGetBlockListOptions

區塊 Blob 取得區塊清單作業的選項。

傳回

Promise<BlockBlobGetBlockListResponse>

區塊 Blob 取得區塊清單作業的回應資料。

query(string, BlockBlobQueryOptions)

僅適用于NODE.JS執行時間。

JSON 或 CSV 格式 Blob 的快速查詢。

範例使用方式 (Node.js) ：

// Query and convert a blob to a string
const queryBlockBlobResponse = await blockBlobClient.query("select * from BlobStorage");
const downloaded = (await streamToBuffer(queryBlockBlobResponse.readableStreamBody)).toString();
console.log("Query blob content:", downloaded);

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);
  });
}

function query(query: string, options?: BlockBlobQueryOptions): Promise<BlobDownloadResponseModel>

參數

query

string

options
BlockBlobQueryOptions

傳回

Promise<BlobDownloadResponseModel>

stageBlock(string, HttpRequestBody, number, BlockBlobStageBlockOptions)

將指定的區塊上傳至區塊 Blob 的「暫存區域」，以便稍後透過呼叫 commitBlockList 來認可。

請參閱https://docs.microsoft.com/rest/api/storageservices/put-block

function stageBlock(blockId: string, body: HttpRequestBody, contentLength: number, options?: BlockBlobStageBlockOptions): Promise<BlockBlobStageBlockResponse>

參數

blockId

string

base64 編碼的 64 位元組值

body
HttpRequestBody

要上傳至暫存區域的資料。

contentLength

number

要上傳的位元組數。

options
BlockBlobStageBlockOptions

區塊 Blob 階段區塊作業的選項。

傳回

Promise<BlockBlobStageBlockResponse>

區塊 Blob 階段區塊作業的回應資料。

stageBlockFromURL(string, string, number, number, BlockBlobStageBlockFromURLOptions)

階段封鎖 URL 作業會建立要認可的新區塊，作為從 URL 讀取內容的 Blob 的一部分。 從 2018-03-28 版開始，即可使用此 API。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/put-block-from-url

function stageBlockFromURL(blockId: string, sourceURL: string, offset?: number, count?: number, options?: BlockBlobStageBlockFromURLOptions): Promise<BlockBlobStageBlockFromURLResponse>

參數

blockId

string

base64 編碼的 64 位元組值

sourceURL

string

指定 Blob 的 URL。 此值可以是長度上限為 2 KB 的 URL，指定 Blob。 此值應該像出現在要求 URI 中一樣以 URL 編碼。 來源 Blob 必須是公用，或必須透過共用存取簽章進行驗證。 如果來源 Blob 是公用的，則不需要驗證才能執行作業。 以下是來源物件 URL 的一些範例： - https://myaccount.blob.core.windows.net/mycontainer/myblob - https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=

offset

number

要下載的 Blob 位置，大於或等於 0

count

number

要下載的資料量大於 0。 將在未定義時下載至結尾

options
BlockBlobStageBlockFromURLOptions

區塊 Blob 階段區塊 From URL 作業的選項。

傳回

Promise<BlockBlobStageBlockFromURLResponse>

區塊 Blob 階段區塊 From URL 作業的回應資料。

syncUploadFromURL(string, BlockBlobSyncUploadFromURLOptions)

建立新的區塊 Blob，其中 Blob 的內容是從指定的 URL 讀取。 從 2020-04-08 版本開始，支援此 API。 從 URL 放置 Blob 不支援部分更新;現有 Blob 的內容會以新 Blob 的內容覆寫。 若要使用來源 URL 對區塊 Blob 的內容執行部分更新，請使用 stageBlockFromURL 和 commitBlockList。

function syncUploadFromURL(sourceURL: string, options?: BlockBlobSyncUploadFromURLOptions): Promise<BlockBlobPutBlobFromUrlResponse>

參數

sourceURL

string

指定 Blob 的 URL。 此值可以是長度上限為 2 KB 的 URL，指定 Blob。 此值應該像出現在要求 URI 中一樣以 URL 編碼。 來源 Blob 必須是公用，或必須透過共用存取簽章進行驗證。 如果來源 Blob 是公用的，則不需要驗證才能執行作業。 以下是來源物件 URL 的一些範例： - https://myaccount.blob.core.windows.net/mycontainer/myblob - https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=

options
BlockBlobSyncUploadFromURLOptions

選用參數。

傳回

Promise<BlockBlobPutBlobFromUrlResponse>

upload(HttpRequestBody, number, BlockBlobUploadOptions)

建立新的區塊 Blob，或更新現有區塊 Blob 的內容。 更新現有的區塊 Blob 會覆寫 Blob 中所有的現有中繼資料。 不支援部分更新;現有 Blob 的內容會以新內容覆寫。 若要執行區塊 Blob 的部分更新，請使用 stageBlock 和 commitBlockList。

這是非平行上傳方法，請使用 uploadFile、 uploadStream 或 uploadBrowserData ，以提升並行上傳的效能。

請參閱https://docs.microsoft.com/rest/api/storageservices/put-blob

function upload(body: HttpRequestBody, contentLength: number, options?: BlockBlobUploadOptions): Promise<BlockBlobUploadResponse>

參數

body
HttpRequestBody

Blob、字串、ArrayBuffer、ArrayBufferView 或函式，會傳回從資料來源開始位移的新可讀取資料流程。

contentLength

number

內文的長度，以位元組為單位。 使用 Buffer.byteLength () 來計算字串的本文長度，包括非 Base64/Hex 編碼字元。

options
BlockBlobUploadOptions

區塊 Blob 上傳作業的選項。

傳回

Promise<BlockBlobUploadResponse>

區塊 Blob 上傳作業的回應資料。

使用方式範例：

const content = "Hello world!";
const uploadBlobResponse = await blockBlobClient.upload(content, content.length);

uploadBrowserData(Blob | ArrayBuffer | ArrayBufferView, BlockBlobParallelUploadOptions)

警告

此 API 現已淘汰。

Use uploadData instead.

僅適用于瀏覽器。

將瀏覽器 Blob/File/ArrayBuffer/ArrayBufferView 物件上傳至區塊 Blob。

當緩衝區長度小於或等於 256MB 時，此方法會使用 1 個上傳呼叫來完成上傳。 否則，這個方法會呼叫 stageBlock 以上傳區塊，最後呼叫 commitBlockList 來認可區塊清單。

要設定的常見 blobHTTPHeaders 選項是 blobContentType ，可讓瀏覽器根據檔案類型提供功能。

function uploadBrowserData(browserData: Blob | ArrayBuffer | ArrayBufferView, options?: BlockBlobParallelUploadOptions): Promise<BlobUploadCommonResponse>

參數

browserData

Blob | ArrayBuffer | ArrayBufferView

Blob、檔案、ArrayBuffer 或 ArrayBufferView

options
BlockBlobParallelUploadOptions

上傳瀏覽器資料的選項。

傳回

Promise<BlobUploadCommonResponse>

Blob 上傳作業的回應資料。

uploadData(Blob | ArrayBuffer | ArrayBufferView | Buffer, BlockBlobParallelUploadOptions)

將 Buffer (Node.js) /Blob (瀏覽器上傳至 BlockBlob) /ArrayBuffer/ArrayBufferView 物件。

當資料長度不超過指定的 maxSingleShotSize (預設值 <xref:BLOCK_BLOB_MAX_UPLOAD_BLOB_BYTES> 為) 時，此方法會使用 1 個 上傳 呼叫來完成上傳。 否則，這個方法會呼叫 stageBlock 以上傳區塊，最後呼叫 commitBlockList 來認可區塊清單。

要設定的常見 blobHTTPHeaders 選項是 blobContentType ，可讓瀏覽器根據檔案類型提供功能。

function uploadData(data: Blob | ArrayBuffer | ArrayBufferView | Buffer, options?: BlockBlobParallelUploadOptions): Promise<BlobUploadCommonResponse>

參數

data

Blob | ArrayBuffer | ArrayBufferView | Buffer

Buffer (Node.js) 、Blob、ArrayBuffer 或 ArrayBufferView

options
BlockBlobParallelUploadOptions

傳回

Promise<BlobUploadCommonResponse>

uploadFile(string, BlockBlobParallelUploadOptions)

僅適用于NODE.JS執行時間。

將區塊中的本機檔案上傳至區塊 Blob。

當檔案大小小於或等於 256MB 時，此方法會使用 1 個上傳呼叫來完成上傳。 否則，這個方法會呼叫 stageBlock 以上傳區塊，最後呼叫 commitBlockList 來認可區塊清單。

function uploadFile(filePath: string, options?: BlockBlobParallelUploadOptions): Promise<BlobUploadCommonResponse>

參數

filePath

string

本機檔案的完整路徑

options
BlockBlobParallelUploadOptions

上傳至區塊 Blob 作業的選項。

傳回

Promise<BlobUploadCommonResponse>

Blob 上傳作業的回應資料。

uploadStream(Readable, number, number, BlockBlobUploadStreamOptions)

僅適用于NODE.JS執行時間。

將Node.js可讀取的資料流程上傳至區塊 Blob。

效能改進秘訣：

  • 輸入資料流程 highWaterMark 最好是使用 bufferSize 參數來設定相同的值，以避免 Buffer.concat () 作業。
function uploadStream(stream: Readable, bufferSize?: number, maxConcurrency?: number, options?: BlockBlobUploadStreamOptions): Promise<BlobUploadCommonResponse>

參數

stream

Readable

Node.js可讀取資料流程

bufferSize

number

配置的每個緩衝區大小，也是上傳區塊 Blob 中的區塊大小。 預設值為 8MB

maxConcurrency

number

最大並行表示可以配置的緩衝區數目上限，與最大上傳並行的正相互關聯。 預設值為 5

options
BlockBlobUploadStreamOptions

將資料流程上傳至區塊 Blob 作業的選項。

傳回

Promise<BlobUploadCommonResponse>

Blob 上傳作業的回應資料。

withSnapshot(string)

建立與來源相同的新 BlockBlobClient 物件，但具有指定的快照集時間戳記。 提供 「」 會移除快照集，並傳回基底 Blob 的 URL。

function withSnapshot(snapshot: string): BlockBlobClient

參數

snapshot

string

快照時間戳記。

傳回

BlockBlobClient

新的 BlockBlobClient 物件與來源相同，但具有指定的快照集時間戳記。

繼承的方法的詳細資料

abortCopyFromURL(string, BlobAbortCopyFromURLOptions)

中止暫止的非同步複製 Blob 作業，並保留長度為零和完整中繼資料的目的地 Blob。 2012-02-12 版及更新版本。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/abort-copy-blob

function abortCopyFromURL(copyId: string, options?: BlobAbortCopyFromURLOptions): Promise<BlobAbortCopyFromURLResponse>

參數

copyId

string

複製來源 URL 作業的識別碼。

options
BlobAbortCopyFromURLOptions

Blob 中止複製來源 URL 作業的選擇性選項。

傳回

Promise<BlobAbortCopyFromURLResponse>

繼承自BlobClient.abortCopyFromURL

beginCopyFromURL(string, BlobBeginCopyFromURLOptions)

以非同步方式將 Blob 複製到儲存體帳戶內的目的地。 這個方法會傳回長時間執行的作業輪詢器，可讓您無限期等候直到複製完成為止。 您也可以藉由在輪詢器上呼叫 cancelOperation 來取消複本，再取消複本。 請注意，如果作業在第一個要求中完成，而且嘗試取消完成的複本會導致擲回錯誤，則不會叫用 onProgress 回呼。

在 2012-02-12 版和更新版本中，複製 Blob 作業的來源可以是任何 Azure 儲存體帳戶中認可的 Blob。 從 2015-02-21 版開始，複製 Blob 作業的來源可以是任何 Azure 儲存體帳戶中的 Azure 檔案。 只有在 2012 年 6 月 7 日當天或之後所建立的儲存體帳戶，才可讓您在執行複製 Blob 作業時從另一個儲存體帳戶複製 Blob。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/copy-blob

使用自動輪詢的範例：

const copyPoller = await blobClient.beginCopyFromURL('url');
const result = await copyPoller.pollUntilDone();

使用手動輪詢的範例：

const copyPoller = await blobClient.beginCopyFromURL('url');
while (!poller.isDone()) {
   await poller.poll();
}
const result = copyPoller.getResult();

使用進度更新的範例：

const copyPoller = await blobClient.beginCopyFromURL('url', {
  onProgress(state) {
    console.log(`Progress: ${state.copyProgress}`);
  }
});
const result = await copyPoller.pollUntilDone();

使用變更輪詢間隔的範例， (預設為 15 秒) ：

const copyPoller = await blobClient.beginCopyFromURL('url', {
  intervalInMs: 1000 // poll blob every 1 second for copy progress
});
const result = await copyPoller.pollUntilDone();

使用複製取消的範例：

const copyPoller = await blobClient.beginCopyFromURL('url');
// cancel operation after starting it.
try {
  await copyPoller.cancelOperation();
  // calls to get the result now throw PollerCancelledError
  await copyPoller.getResult();
} catch (err) {
  if (err.name === 'PollerCancelledError') {
    console.log('The copy was cancelled.');
  }
}

function beginCopyFromURL(copySource: string, options?: BlobBeginCopyFromURLOptions): Promise<PollerLikeWithCancellation<PollOperationState<BlobBeginCopyFromURLResponse>, BlobBeginCopyFromURLResponse>>

參數

copySource

string

來源 Azure Blob/檔案的 URL。

options
BlobBeginCopyFromURLOptions

Blob 開始從 URL 複製作業的選擇性選項。

傳回

Promise<PollerLikeWithCancellation<PollOperationState<BlobBeginCopyFromURLResponse>, BlobBeginCopyFromURLResponse>>

繼承自BlobClient.beginCopyFromURL

createSnapshot(BlobCreateSnapshotOptions)

建立 Blob 的唯讀快照集。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/snapshot-blob

function createSnapshot(options?: BlobCreateSnapshotOptions): Promise<BlobCreateSnapshotResponse>

參數

options
BlobCreateSnapshotOptions

Blob 建立快照集作業的選擇性選項。

傳回

Promise<BlobCreateSnapshotResponse>

繼承自BlobClient.createSnapshot

delete(BlobDeleteOptions)

標示要刪除的指定 Blob 或快照集。 Blob 稍後會在記憶體回收時刪除。 請注意，若要刪除 Blob，您必須刪除其所有快照集。 您可以使用刪除 Blob 作業同時刪除這兩者。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob

function delete(options?: BlobDeleteOptions): Promise<BlobDeleteResponse>

參數

options
BlobDeleteOptions

Blob 刪除作業的選擇性選項。

傳回

Promise<BlobDeleteResponse>

繼承自BlobClient.delete

deleteIfExists(BlobDeleteOptions)

如果指定 Blob 或快照集存在，請將其標示為刪除。 Blob 稍後會在記憶體回收時刪除。 請注意，若要刪除 Blob，您必須刪除其所有快照集。 您可以使用刪除 Blob 作業同時刪除這兩者。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob

function deleteIfExists(options?: BlobDeleteOptions): Promise<BlobDeleteIfExistsResponse>

參數

options
BlobDeleteOptions

Blob 刪除作業的選擇性選項。

傳回

Promise<BlobDeleteIfExistsResponse>

繼承自BlobClient.deleteIfExists

deleteImmutabilityPolicy(BlobDeleteImmutabilityPolicyOptions)

刪除 Blob 上的不可變原則。

function deleteImmutabilityPolicy(options?: BlobDeleteImmutabilityPolicyOptions): Promise<BlobDeleteImmutabilityPolicyResponse>

參數

options
BlobDeleteImmutabilityPolicyOptions

刪除 Blob 上不變性原則的選擇性選項。

傳回

Promise<BlobDeleteImmutabilityPolicyResponse>

繼承自BlobClient.deleteImmutabilityPolicy

download(number, number, BlobDownloadOptions)

從系統讀取或下載 Blob，包括其中繼資料和屬性。 您也可以呼叫取得 Blob 來讀取快照集。

  • 在 Node.js 中，資料會在可讀取的資料流程 readableStreamBody 中傳回
  • 在瀏覽器中，資料會在 promise blobBody 中傳回

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob

function download(offset?: number, count?: number, options?: BlobDownloadOptions): Promise<BlobDownloadResponseParsed>

參數

offset

number

要下載的 Blob 位置，大於或等於 0

count

number

要下載的資料量大於 0。 將在未定義時下載至結尾

options
BlobDownloadOptions

Blob 下載作業的選擇性選項。

範例使用方式 (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);
});
}

瀏覽器) (範例使用方式：

// 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);
  });
}

傳回

Promise<BlobDownloadResponseParsed>

繼承自BlobClient.download

downloadToBuffer(Buffer, number, number, BlobDownloadToBufferOptions)

僅適用于NODE.JS執行時間。

平行下載 Azure Blob 至緩衝區。 位移和計數是選擇性的，如果未提供，則會下載整個 Blob。

警告：緩衝區最多隻能支援 32 位系統上大約一 GB 的檔案，或 64 位系統上最多支援兩 GB 的檔案，因為Node.js/V8 的限制。 對於大於此大小的 Blob，請考慮 downloadToFile。

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

參數

buffer

Buffer

要填滿的緩衝區，長度必須大於計數

offset

number

要從中下載區塊 Blob 的位置，以位元組為單位 ()

count

number

要下載) 以位元組為單位的資料 (量。 傳遞未定義時，將會下載至結尾

options
BlobDownloadToBufferOptions

BlobDownloadToBufferOptions

傳回

Promise<Buffer>

繼承自BlobClient.downloadToBuffer

downloadToBuffer(number, number, BlobDownloadToBufferOptions)

僅適用于NODE.JS執行時間。

平行下載 Azure Blob 至緩衝區。 位移和計數是選擇性的，如果未提供，則會下載整個 Blob。

警告：緩衝區最多隻能支援 32 位系統上大約一 GB 的檔案，或 64 位系統上最多支援兩 GB 的檔案，因為Node.js/V8 的限制。 對於大於此大小的 Blob，請考慮 downloadToFile。

function downloadToBuffer(offset?: number, count?: number, options?: BlobDownloadToBufferOptions): Promise<Buffer>

參數

offset

number

要從中下載區塊 Blob 的位置，以位元組為單位 ()

count

number

要下載) 以位元組為單位的資料 (量。 傳遞未定義時，將會下載至結尾

options
BlobDownloadToBufferOptions

BlobDownloadToBufferOptions

傳回

Promise<Buffer>

繼承自BlobClient.downloadToBuffer

downloadToFile(string, number, number, BlobDownloadOptions)

僅適用于NODE.JS執行時間。

將 Azure Blob 下載到本機檔案。 如果指定的檔案路徑已結束，則失敗。 位移和計數是選擇性的，分別傳遞 0 和未定義，以下載整個 Blob。

function downloadToFile(filePath: string, offset?: number, count?: number, options?: BlobDownloadOptions): Promise<BlobDownloadResponseParsed>

參數

filePath

string

offset

number

要下載之區塊 Blob 的位置。

count

number

要下載的資料量。 將會在傳遞未定義時下載至結尾。

options
BlobDownloadOptions

Blob 下載選項的選項。

傳回

Promise<BlobDownloadResponseParsed>

Blob 下載作業的回應資料，但已將 readableStreamBody 設定為未定義，因為它的內容已經讀取並寫入指定路徑的本機檔案中。

繼承自BlobClient.downloadToFile

exists(BlobExistsOptions)

如果此用戶端所代表的 Azure Blob 資源存在，則傳回 true;否則為 false。

注意：請小心使用此函式，因為其他用戶端或應用程式可能會刪除現有的 Blob。 反之亦然，此函式完成後，其他用戶端或應用程式可能會新增新的 Blob。

function exists(options?: BlobExistsOptions): Promise<boolean>

參數

options
BlobExistsOptions

存在作業的選項。

傳回

Promise<boolean>

繼承自BlobClient.exists

generateSasUrl(BlobGenerateSasUrlOptions)

僅適用于使用共用金鑰認證建構的 BlobClient。

根據傳入的用戶端屬性和參數，產生 Blob 服務共用存取簽章 (SAS) URI。 SAS 是由用戶端的共用金鑰認證所簽署。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas

function generateSasUrl(options: BlobGenerateSasUrlOptions): Promise<string>

參數

options
BlobGenerateSasUrlOptions

選用參數。

傳回

Promise<string>

SAS URI 是由此用戶端所代表之資源的 URI 所組成，後面接著產生的 SAS 權杖。

繼承自BlobClient.generateSasUrl

getAppendBlobClient()

建立 AppendBlobClient 物件。

function getAppendBlobClient(): AppendBlobClient

傳回

AppendBlobClient

繼承自BlobClient.getAppendBlobClient

getBlobLeaseClient(string)

取得 管理 Blob 租用的 BlobLeaseClient 。

function getBlobLeaseClient(proposeLeaseId?: string): BlobLeaseClient

參數

proposeLeaseId

string

初始建議的租用識別碼。

傳回

BlobLeaseClient

用於管理 Blob 租用的新 BlobLeaseClient 物件。

繼承自BlobClient.getBlobLeaseClient

getBlockBlobClient()

建立 BlockBlobClient 物件。

function getBlockBlobClient(): BlockBlobClient

傳回

BlockBlobClient

繼承自BlobClient.getBlockBlobClient

getPageBlobClient()

建立 PageBlobClient 物件。

function getPageBlobClient(): PageBlobClient

傳回

PageBlobClient

繼承自BlobClient.getPageBlobClient

getProperties(BlobGetPropertiesOptions)

傳回 Blob 之所有使用者定義的中繼資料、標準 HTTP 屬性及系統屬性。 但不會傳回 Blob 的內容。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-properties

警告： metadata 回應中傳回的物件會以小寫顯示其索引鍵，即使其原本包含大寫字元也一樣。 這與使用 選項列出 Blob includeMetadata 的ContainerClient方法所傳回的中繼資料金鑰不同，此選項會保留其原始大小寫。

function getProperties(options?: BlobGetPropertiesOptions): Promise<BlobGetPropertiesResponse>

參數

options
BlobGetPropertiesOptions

取得屬性作業的選擇性選項。

傳回

Promise<BlobGetPropertiesResponse>

繼承自BlobClient.getProperties

getTags(BlobGetTagsOptions)

取得與基礎 Blob 相關聯的標記。

function getTags(options?: BlobGetTagsOptions): Promise<BlobGetTagsResponse>

參數

options
BlobGetTagsOptions

傳回

Promise<BlobGetTagsResponse>

繼承自BlobClient.getTags

setAccessTier(string, BlobSetTierOptions)

設定 Blob 上的階層。 在進階儲存體帳戶中的分頁 Blob 和 Blob 儲存體帳戶中的區塊 Blob 上，允許此作業 (本機備援儲存體) 。 進階分頁 Blob 的層會決定 Blob 的允許大小、IOPS 和頻寬。 區塊 Blob 的層會決定經常性存取/非經常性存取/封存儲存體類型。 這項作業不會更新 Blob 的 ETag。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-tier

function setAccessTier(tier: string, options?: BlobSetTierOptions): Promise<BlobSetTierResponse>

參數

tier

string

要設定于 Blob 上的階層。 有效值為經常性存取、非經常性存取或封存。

options
BlobSetTierOptions

Blob 設定層作業的選擇性選項。

傳回

Promise<BlobSetTierResponse>

繼承自BlobClient.setAccessTier

setHTTPHeaders(BlobHTTPHeaders, BlobSetHTTPHeadersOptions)

在 Blob 上設定系統屬性。

如果未提供任何值，或未為指定的 Blob HTTP 標頭提供任何值，則會清除沒有值的這些 Blob HTTP 標頭。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties

function setHTTPHeaders(blobHTTPHeaders?: BlobHTTPHeaders, options?: BlobSetHTTPHeadersOptions): Promise<BlobSetHTTPHeadersResponse>

參數

blobHTTPHeaders
BlobHTTPHeaders

如果未提供任何值，或未為指定的 Blob HTTP 標頭提供任何值，則會清除沒有值的這些 Blob HTTP 標頭。 要設定的通用標頭是 blobContentType 讓瀏覽器根據檔案類型提供功能。

options
BlobSetHTTPHeadersOptions

Blob 設定 HTTP 標頭作業的選擇性選項。

傳回

Promise<BlobSetHTTPHeadersResponse>

繼承自BlobClient.setHTTPHeaders

setImmutabilityPolicy(BlobImmutabilityPolicy, BlobSetImmutabilityPolicyOptions)

在 Blob 上設定不可變原則。

function setImmutabilityPolicy(immutabilityPolicy: BlobImmutabilityPolicy, options?: BlobSetImmutabilityPolicyOptions): Promise<BlobSetImmutabilityPolicyResponse>

參數

immutabilityPolicy
BlobImmutabilityPolicy
options
BlobSetImmutabilityPolicyOptions

在 Blob 上設定不變性原則的選擇性選項。

傳回

Promise<BlobSetImmutabilityPolicyResponse>

繼承自BlobClient.setImmutabilityPolicy

setLegalHold(boolean, BlobSetLegalHoldOptions)

在 Blob 上設定合法保存。

function setLegalHold(legalHoldEnabled: boolean, options?: BlobSetLegalHoldOptions): Promise<BlobSetLegalHoldResponse>

參數

legalHoldEnabled

boolean

options
BlobSetLegalHoldOptions

在 Blob 上設定合法保留的選擇性選項。

傳回

Promise<BlobSetLegalHoldResponse>

繼承自BlobClient.setLegalHold

setMetadata(Metadata, BlobSetMetadataOptions)

將指定 Blob 的使用者定義中繼資料設為一或多個名稱/值配對。

如果未提供任何選項，或參數中未定義任何中繼資料，則會移除 Blob 中繼資料。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata

function setMetadata(metadata?: Metadata, options?: BlobSetMetadataOptions): Promise<BlobSetMetadataResponse>

參數

metadata
Metadata

以此值取代現有的中繼資料。 如果未提供任何值，則會移除現有的中繼資料。

options
BlobSetMetadataOptions

設定中繼資料作業的選擇性選項。

傳回

Promise<BlobSetMetadataResponse>

繼承自BlobClient.setMetadata

setTags(Tags, BlobSetTagsOptions)

設定基礎 Blob 上的標記。 Blob 最多可以有 10 個標記。 標記索引鍵必須介於 1 到 128 個字元之間。 標籤值必須介於 0 到 256 個字元之間。 有效的標記索引鍵和值字元包括小寫字母和大寫字母、數位 (0-9) 、空格 (' ') ，加上 ('+') 、減 ('-') 、句號 ('。') 、正斜線 ('/') 、冒號 ('：') 、等於 ('=') ，以及底線 ('_') 。

function setTags(tags: Tags, options?: BlobSetTagsOptions): Promise<BlobSetTagsResponse>

參數

tags
Tags
options
BlobSetTagsOptions

傳回

Promise<BlobSetTagsResponse>

繼承自BlobClient.setTags

syncCopyFromURL(string, BlobSyncCopyFromURLOptions)

同步複製來源 URL 作業會將 Blob 或網際網路資源複製到新的 Blob。 在複製完成之前，它不會傳迴響應。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/copy-blob-from-url

function syncCopyFromURL(copySource: string, options?: BlobSyncCopyFromURLOptions): Promise<BlobCopyFromURLResponse>

參數

copySource

string

要從複製的來源 URL、共用存取簽章 (SAS) 可能需要進行驗證

options
BlobSyncCopyFromURLOptions

傳回

Promise<BlobCopyFromURLResponse>

繼承自BlobClient.syncCopyFromURL

undelete(BlobUndeleteOptions)

還原虛刪除 Blob 的內容和中繼資料，以及任何相關聯的虛刪除快照集。 只有 2017-07-29 版或更新版本才支援取消刪除 Blob。

請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/undelete-blob

function undelete(options?: BlobUndeleteOptions): Promise<BlobUndeleteResponse>

參數

options
BlobUndeleteOptions

Blob 取消刪除作業的選擇性選項。

傳回

Promise<BlobUndeleteResponse>

繼承自BlobClient.undelete

withVersion(string)

建立指向此 Blob 版本的新 BlobClient 物件。 提供 「」 會移除 versionId，並將用戶端傳回基底 Blob。

function withVersion(versionId: string): BlobClient

參數

versionId

string

versionId。

傳回

BlobClient

指向此 Blob 版本的新 BlobClient 物件。

繼承自BlobClient.withVersion