BlockBlobClient class

Ссылка

Пакет:: @azure/storage-blob

BlockBlobClient определяет набор операций, применимых к блочных BLOB-объектам.

Extends: BlobClient

Конструкторы

BlockBlobClient(string, PipelineLike)	Создает экземпляр BlockBlobClient. Этот метод принимает закодированный URL-адрес или некодированный URL-адрес, указывающий на блочный большой двоичный объект. Строка ЗАкодированного URL-адреса не будет экранирована дважды, будут экранированы только специальные символы в пути URL-адреса. Если имя большого двоичного объекта включается? или %, имя большого двоичного объекта должно быть закодировано в URL-адресе.
BlockBlobClient(string, StorageSharedKeyCredential \| AnonymousCredential \| TokenCredential, StoragePipelineOptions)	Создает экземпляр BlockBlobClient. Этот метод принимает закодированный URL-адрес или некодированный URL-адрес, указывающий на блочный большой двоичный объект. Строка ЗАкодированного URL-адреса не будет экранирована дважды, будут экранированы только специальные символы в пути URL-адреса. Если имя большого двоичного объекта включается? или %, имя большого двоичного объекта должно быть закодировано в URL-адресе.
BlockBlobClient(string, string, string, StoragePipelineOptions)	Создает экземпляр BlockBlobClient.

Свойства

containerName	Имя контейнера хранилища, с которым связан большой двоичный объект.
name	Имя большого двоичного объекта.

Унаследованные свойства

accountName
credential	Например, AnonymousCredential, StorageSharedKeyCredential или любые учетные данные из пакета `@azure/identity` для проверки подлинности запросов к службе. Можно также предоставить объект, реализующий интерфейс TokenCredential. Если не указано, используется AnonymousCredential.
url	Закодированное строковое значение URL-адреса.

Методы

commitBlockList(string[], BlockBlobCommitBlockListOptions)	Записывает большой двоичный объект, указав список блочных идентификаторов, составляющих большой двоичный объект. Для записи в рамках большого двоичного объекта блок должен быть успешно записан на сервер до операции stageBlock. Вы можете вызвать commitBlockList для обновления большого двоичного объекта, отправив только те блоки, которые изменились, а затем фиксируют новые и существующие блоки вместе. Все блоки, не указанные в списке блоков и безвозвратно удаленные. См. https://docs.microsoft.com/rest/api/storageservices/put-block-list
getBlockList(BlockListType, BlockBlobGetBlockListOptions)	Возвращает список блоков, которые были отправлены в составе блочного большого двоичного объекта с помощью указанного фильтра списка блоков. См. https://docs.microsoft.com/rest/api/storageservices/get-block-list
query(string, BlockBlobQueryOptions)	ДОСТУПНО ТОЛЬКО В СРЕДЕ ВЫПОЛНЕНИЯ NODE.JS. Быстрый запрос к форматируемой BLOB-объекту JSON или CSV. Пример использования (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, RequestBodyType, number, BlockBlobStageBlockOptions)	Отправляет указанный блок в область промежуточного хранения блочного BLOB-объекта, чтобы позже зафиксировать вызов commitBlockList. См. https://docs.microsoft.com/rest/api/storageservices/put-block
stageBlockFromURL(string, string, number, number, BlockBlobStageBlockFromURLOptions)	Операция "Блок этапа из URL-адреса" создает новый блок для фиксации в составе большого двоичного объекта, в котором содержимое считывается из URL-адреса. Этот API доступен начиная с версии 2018-03-28. См. https://docs.microsoft.com/en-us/rest/api/storageservices/put-block-from-url
syncUploadFromURL(string, BlockBlobSyncUploadFromURLOptions)	Создает новый блочный BLOB-объект, в котором содержимое большого двоичного объекта считываются из заданного URL-адреса. Этот API поддерживается начиная с версии 2020-04-08. Частичные обновления не поддерживаются с помощью PUT BLOB-объекта из URL-адреса; Содержимое существующего большого двоичного объекта перезаписывается содержимым нового большого двоичного объекта. Чтобы выполнить частичные обновления содержимого блочного blob-объекта с помощью исходного URL-адреса, используйте stageBlockFromURL и commitBlockList.
upload(RequestBodyType, number, BlockBlobUploadOptions)	Создает новый блочный большой двоичный объект или обновляет содержимое существующего блочного большого двоичного объекта. Обновление существующего блочного BLOB-объекта перезаписывает все существующие метаданные большого двоичного объекта. Частичные обновления не поддерживаются; Содержимое существующего большого двоичного объекта перезаписывается новым содержимым. Чтобы выполнить частичное обновление блочного большого двоичного объекта, используйте stageBlock и commitBlockList. Это не параллельный метод отправки, используйте uploadFile, uploadStream или uploadBrowserData для повышения производительности при отправке параллелизма. См. https://docs.microsoft.com/rest/api/storageservices/put-blob
uploadBrowserData(Blob \| ArrayBuffer \| ArrayBufferView, BlockBlobParallelUploadOptions)	ДОСТУПНО ТОЛЬКО В БРАУЗЕРАХ. Отправляет объект BLOB-объекта браузера,File/ArrayBuffer/ArrayBufferView в блок больших двоичных объектов. Если длина буфера меньше или равна 256 МБ, этот метод будет использовать 1 вызов отправки для завершения отправки. В противном случае этот метод вызовет stageBlock для отправки блоков и, наконец, вызовет commitBlockList для фиксации списка блокировок. Распространенный параметр blobHTTPHeaders установлен `blobContentType`, что позволяет браузеру предоставлять функциональные возможности на основе типа файла.
uploadData(Blob \| ArrayBuffer \| ArrayBufferView \| Buffer, BlockBlobParallelUploadOptions)	Отправляет объект Buffer(Node.js)/Blob(browsers)/ArrayBuffer/ArrayBufferView в BlockBlob. Если длина данных не превышает maxSingleShotS ize (по умолчанию <xref:BLOCK_BLOB_MAX_UPLOAD_BLOB_BYTES>), этот метод будет использовать 1 отправки для завершения отправки. В противном случае этот метод вызовет stageBlock для отправки блоков и, наконец, вызовет commitBlockList для фиксации списка блокировок. Распространенный параметр blobHTTPHeaders установлен `blobContentType`, что позволяет браузеру предоставлять функциональные возможности на основе типа файла.
uploadFile(string, BlockBlobParallelUploadOptions)	ДОСТУПНО ТОЛЬКО В СРЕДЕ ВЫПОЛНЕНИЯ NODE.JS. Отправляет локальный файл в блоки в блочный большой двоичный объект. Если размер файла меньше или равен 256 МБ, этот метод будет использовать 1 вызов отправки для завершения отправки. В противном случае этот метод вызовет stageBlock для отправки блоков и, наконец, вызовет commitBlockList для фиксации списка блоков.
uploadStream(Readable, number, number, BlockBlobUploadStreamOptions)	ДОСТУПНО ТОЛЬКО В СРЕДЕ ВЫПОЛНЕНИЯ NODE.JS. Отправляет поток Node.js для чтения в блочный большой двоичный объект. СОВЕТЫ ПО УЛУЧШЕНИЮ ПРОИЗВОДИТЕЛЬНОСТИ: Входной поток highWaterMark лучше задать то же значение с параметром bufferSize, что позволит избежать операций Buffer.concat().
withSnapshot(string)	Создает новый объект BlockBlobClient, идентичный источнику, но с указанной меткой времени моментального снимка. Укажите "" приведет к удалению моментального снимка и возврату URL-адреса базовому BLOB-объекту.

Наследуемые методы

abortCopyFromURL(string, BlobAbortCopyFromURLOptions)	Прервана ожидающая асинхронная операция копирования BLOB-объектов и оставляет целевой большой двоичный объект нулевой длиной и полными метаданными. Версия 2012-02-12 и более позднюю. См. https://docs.microsoft.com/en-us/rest/api/storageservices/abort-copy-blob
beginCopyFromURL(string, BlobBeginCopyFromURLOptions)	Асинхронно копирует большой двоичный объект в место назначения в учетной записи хранения. Этот метод возвращает длительный опрос операций, позволяющий ждать неограниченное время, пока копия не будет завершена. Вы также можете отменить копию перед его завершением, вызвав `cancelOperation` на опросе. Обратите внимание, что обратный вызов onProgress не будет вызываться, если операция завершается в первом запросе, и попытка отменить завершенную копию приведет к возникновению ошибки. В версии 2012-02-12 и более поздних версиях источник операции копирования BLOB-объектов может быть зафиксированным BLOB-объектом в любой учетной записи хранения Azure. Начиная с версии 2015-02-21 источник операции копирования BLOB-объектов может быть файлом Azure в любой учетной записи хранения Azure. Только учетные записи хранения, созданные 7 июня 2012 г., позволяют операции копирования 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)	Создает моментальный снимок большого двоичного объекта только для чтения. См. https://docs.microsoft.com/en-us/rest/api/storageservices/snapshot-blob
delete(BlobDeleteOptions)	Помечает указанный большой двоичный объект или моментальный снимок для удаления. Большой двоичный объект позже удаляется во время сборки мусора. Обратите внимание, что для удаления большого двоичного объекта необходимо удалить все его моментальные снимки. Вы можете одновременно удалить оба объекта с помощью операции удаления BLOB-объектов. См. https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob
deleteIfExists(BlobDeleteOptions)	Помечает указанный большой двоичный объект или моментальный снимок для удаления, если он существует. Большой двоичный объект позже удаляется во время сборки мусора. Обратите внимание, что для удаления большого двоичного объекта необходимо удалить все его моментальные снимки. Вы можете одновременно удалить оба объекта с помощью операции удаления BLOB-объектов. См. https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob
deleteImmutabilityPolicy(BlobDeleteImmutabilityPolicyOptions)	Удалите политику immutablility в большом двоичном объекте.
download(number, number, BlobDownloadOptions)	Считывает или загружает большой двоичный объект из системы, включая его метаданные и свойства. Вы также можете вызвать get BLOB-объект для чтения моментального снимка. В Node.jsданные возвращаются в потоке, доступном для чтения, доступном для чтенияStreamBody В браузерах данные возвращаются в объекте blobBody обещания См. https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob
downloadToBuffer(Buffer, number, number, BlobDownloadToBufferOptions)	ДОСТУПНО ТОЛЬКО В СРЕДЕ ВЫПОЛНЕНИЯ NODE.JS. Загружает большой двоичный объект Azure параллельно с буфером. Смещение и количество необязательными, загружает весь большой двоичный объект, если они не предоставлены. Предупреждение. Буферы могут поддерживать только файлы до одного гигабайта в 32-разрядных системах или около двух гигабайтов в 64-разрядных системах из-за ограничений Node.js/V8. Для больших двоичных объектов, превышающих этот размер, рекомендуется downloadToFile.
downloadToBuffer(number, number, BlobDownloadToBufferOptions)	ДОСТУПНО ТОЛЬКО В СРЕДЕ ВЫПОЛНЕНИЯ NODE.JS. Загружает большой двоичный объект Azure параллельно с буфером. Смещение и количество необязательными, загружает весь большой двоичный объект, если они не предоставлены. Предупреждение. Буферы могут поддерживать только файлы до одного гигабайта в 32-разрядных системах или около двух гигабайтов в 64-разрядных системах из-за ограничений Node.js/V8. Для больших двоичных объектов, превышающих этот размер, рекомендуется downloadToFile.
downloadToFile(string, number, number, BlobDownloadOptions)	ДОСТУПНО ТОЛЬКО В СРЕДЕ ВЫПОЛНЕНИЯ NODE.JS. Загружает большой двоичный объект Azure в локальный файл. Завершается ошибкой, если указанный путь к файлу уже завершается. Смещение и число являются необязательными, передайте 0 и не определено соответственно, чтобы скачать весь большой двоичный объект.
exists(BlobExistsOptions)	Возвращает значение true, если ресурс BLOB-объектов Azure, представленный этим клиентом; False в противном случае. ПРИМЕЧАНИЕ. Используйте эту функцию с осторожностью, так как существующий большой двоичный объект может быть удален другими клиентами или приложениями. Наоборот, новые большие двоичные объекты могут быть добавлены другими клиентами или приложениями после завершения этой функции.
generateSasUrl(BlobGenerateSasUrlOptions)	Доступно только для BLOBClient, созданного с использованием учетных данных общего ключа. Создает универсальный код ресурса (SAS) подписанного URL-адреса службы BLOB-объектов на основе свойств клиента и параметров, переданных в. SAS подписан учетными данными общего ключа клиента. См. https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
getAccountInfo(BlobGetAccountInfoOptions)	Операция Get Account Information возвращает имя sku и тип учетной записи для указанной учетной записи. Операция получения сведений об учетной записи доступна в версиях служб, начиная с версии 2018-03-28. См. https://docs.microsoft.com/en-us/rest/api/storageservices/get-account-information
getAppendBlobClient()	Создает объект AppendBlobClient.
getBlobLeaseClient(string)	Получите BlobLeaseClient, которая управляет арендой большого двоичного объекта.
getBlockBlobClient()	Создает объект BlockBlobClient.
getPageBlobClient()	Создает объект PageBlobClient.
getProperties(BlobGetPropertiesOptions)	Возвращает все пользовательские метаданные, стандартные свойства HTTP и системные свойства большого двоичного объекта. Он не возвращает содержимое большого двоичного объекта. См. https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-properties ПРЕДУПРЕЖДЕНИЕ. Объект `metadata`, возвращенный в ответе, будет иметь свои ключи в нижнем регистре, даже если они первоначально содержали прописные символы. Это отличается от ключей метаданных, возвращаемых методами ContainerClient, которые перечисляют большие двоичные объекты с помощью параметра `includeMetadata`, который будет хранить исходный регистр.
getTags(BlobGetTagsOptions)	Возвращает теги, связанные с базовым BLOB-объектом.
setAccessTier(string, BlobSetTierOptions)	Задает уровень в большом двоичном объекте. Операция разрешена на странице большого двоичного объекта в учетной записи хранения класса Premium и в блочных BLOB-объектах в учетной записи хранения BLOB-объектов (только локально избыточное хранилище). Уровень большого двоичного объекта страницы уровня "Премиум" определяет допустимый размер, операции ввода-вывода в секунду и пропускную способность большого двоичного объекта. Уровень блочного большого двоичного объекта определяет тип хранилища Hot/Cool/Archive. Эта операция не обновляет ETag большого двоичного объекта. См. https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-tier
setHTTPHeaders(BlobHTTPHeaders, BlobSetHTTPHeadersOptions)	Задает системные свойства большого двоичного объекта. Если для указанных заголовков HTTP большого двоичного объекта не задано никакого значения, эти заголовки HTTP БОЛЬШИХ двоичных объектов без значения будут удалены. См. https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties
setImmutabilityPolicy(BlobImmutabilityPolicy, BlobSetImmutabilityPolicyOptions)	Задайте политику неизменяемости в большом двоичном объекте.
setLegalHold(boolean, BlobSetLegalHoldOptions)	Установите юридическое удержание большого двоичного объекта.
setMetadata(Metadata, BlobSetMetadataOptions)	Задает определяемые пользователем метаданные для указанного большого двоичного объекта в виде одной или нескольких пар "имя-значение". Если параметр не указан или метаданные, определенные в параметре, метаданные большого двоичного объекта будут удалены. См. https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata
setTags(Tags, BlobSetTagsOptions)	Задает теги в базовом большом двоичном объекте. Большой двоичный объект может содержать до 10 тегов. Ключи тегов должны быть от 1 до 128 символов. Значения тегов должны быть от 0 до 256 символов. Допустимые символы тегов и символов значений включают буквы нижнего и верхнего регистра, цифры (0–9), пробел ("), плюс ("+"), минус ("-"), период ("."), косую черту ("/"), двоеточие (":"), равное ("=") и подчеркивание ('_').
syncCopyFromURL(string, BlobSyncCopyFromURLOptions)	Синхронная операция копирования из URL-адреса копирует большой двоичный объект или интернет-ресурс в новый большой двоичный объект. Он не вернет ответ до завершения копирования. См. https://docs.microsoft.com/en-us/rest/api/storageservices/copy-blob-from-url
undelete(BlobUndeleteOptions)	Восстанавливает содержимое и метаданные обратимого удаленного большого двоичного объекта и всех связанных обратимо удаленных моментальных снимков. Отмена удаления BLOB-объектов поддерживается только в версии 2017-07-29 или более поздней версии. См. https://docs.microsoft.com/en-us/rest/api/storageservices/undelete-blob
withVersion(string)	Создает новый объект BlobClient, указывающий на версию этого большого двоичного объекта. Укажите "" приведет к удалению идентификатора версии и возвратите клиенту базовый большой двоичный объект.

Сведения о конструкторе

BlockBlobClient(string, PipelineLike)

Создает экземпляр BlockBlobClient. Этот метод принимает закодированный URL-адрес или некодированный URL-адрес, указывающий на блочный большой двоичный объект. Строка ЗАкодированного URL-адреса не будет экранирована дважды, будут экранированы только специальные символы в пути URL-адреса. Если имя большого двоичного объекта включается? или %, имя большого двоичного объекта должно быть закодировано в URL-адресе.

new BlockBlobClient(url: string, pipeline: PipelineLike)

Параметры

url: string

Строка URL-адреса, указывающая на большой двоичный объект хранилища Azure, например "https://myaccount.blob.core.windows.net/mycontainer/blockblob". При использовании AnonymousCredential можно добавить SAS, например "https://myaccount.blob.core.windows.net/mycontainer/blockblob?sasString". Этот метод принимает закодированный URL-адрес или НЕкодированный URL-адрес, указывающий на большой двоичный объект. Строка ЗАкодированного URL-адреса не будет экранирована дважды, будут экранированы только специальные символы в пути URL-адреса. Однако если имя большого двоичного объекта включается? или %, имя большого двоичного объекта должно быть закодировано в URL-адресе. Например, большой двоичный объект с именем "my?blob%", URL-адрес должен быть "https://myaccount.blob.core.windows.net/mycontainer/my%3Fblob%25".

pipeline: PipelineLike

Вызовите newPipeline() для создания конвейера по умолчанию или предоставления настраиваемого конвейера.

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

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

Параметры

url: string

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

Строка подключения учетной записи или строка подключения SAS учетной записи хранения Azure. [ Примечание. Строка подключения учетной записи может использоваться только в среде выполнения NODE.JS. ] Пример строки подключения учетной записи — пример строки подключения SAS 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

Имя контейнера.

blobName: string

Имя BLOB-объекта.

options: StoragePipelineOptions

Необязательный. Параметры настройки конвейера HTTP.

Сведения о свойстве

containerName

Имя контейнера хранилища, с которым связан большой двоичный объект.

string containerName

Значение свойства

string

name

Имя большого двоичного объекта.

string name

Значение свойства

string

Сведения об унаследованном свойстве

accountName

accountName: string

Значение свойства

string

унаследовано отBLOBClient.accountName

credential

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Значение свойства

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

наследуется отBLOBClient.credential

url

Закодированное строковое значение URL-адреса.

url: string

Значение свойства

string

наследуется отBLOBClient.url

Сведения о методе

commitBlockList(string[], BlockBlobCommitBlockListOptions)

Записывает большой двоичный объект, указав список блочных идентификаторов, составляющих большой двоичный объект. Для записи в рамках большого двоичного объекта блок должен быть успешно записан на сервер до операции stageBlock. Вы можете вызвать commitBlockList для обновления большого двоичного объекта, отправив только те блоки, которые изменились, а затем фиксируют новые и существующие блоки вместе. Все блоки, не указанные в списке блоков и безвозвратно удаленные.

См. https://docs.microsoft.com/rest/api/storageservices/put-block-list

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

Параметры

blocks: string[]

Массив 64-байтового значения, закодированного в кодировке Base64

options: BlockBlobCommitBlockListOptions

Параметры операции блочного списка фиксации blob-объектов.

Возвращаемое значение

Promise<BlockBlobCommitBlockListResponse>

Ответные данные для операции блочного списка блок-объектов BLOB-объектов.

getBlockList(BlockListType, BlockBlobGetBlockListOptions)

Возвращает список блоков, которые были отправлены в составе блочного большого двоичного объекта с помощью указанного фильтра списка блоков.

См. 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-объект Get Block List".

query(string, BlockBlobQueryOptions)

ДОСТУПНО ТОЛЬКО В СРЕДЕ ВЫПОЛНЕНИЯ NODE.JS.

Быстрый запрос к форматируемой BLOB-объекту JSON или CSV.

Пример использования (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, RequestBodyType, number, BlockBlobStageBlockOptions)

Отправляет указанный блок в область промежуточного хранения блочного BLOB-объекта, чтобы позже зафиксировать вызов commitBlockList.

См. https://docs.microsoft.com/rest/api/storageservices/put-block

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

Параметры

blockId: string

64-байтовое значение, закодированное в кодировке Base64

body: HttpRequestBody

Данные для отправки в промежуточную область.

contentLength: number

Количество байтов для отправки.

options: BlockBlobStageBlockOptions

Параметры операции блока блочного этапа BLOB-объектов.

Возвращаемое значение

Promise<BlockBlobStageBlockResponse>

Ответные данные для операции блока блочного блока BLOB-объектов.

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

Операция "Блок этапа из URL-адреса" создает новый блок для фиксации в составе большого двоичного объекта, в котором содержимое считывается из URL-адреса. Этот API доступен начиная с версии 2018-03-28.

См. 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

64-байтовое значение, закодированное в кодировке Base64

sourceURL: string

Указывает URL-адрес большого двоичного объекта. Значение может быть URL-адресом до 2 КБ длиной, указывающей большой двоичный объект. Значение должно быть закодировано URL-адресом, так как оно будет отображаться в URI запроса. Исходный BLOB-объект должен быть общедоступным или пройти проверку подлинности с помощью подписанного URL-адреса. Если исходный большой двоичный объект является общедоступным, для выполнения операции не требуется проверка подлинности. Ниже приведены некоторые примеры URL-адресов исходного объекта: https://myaccount.blob.core.windows.net/mycontainer/myblob - https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=

offset: number

С какой позиции большого двоичного объекта для скачивания больше или равно 0

count: number

Сколько данных нужно скачать, больше 0. Будет скачивать в конец, когда не определено

options: BlockBlobStageBlockFromURLOptions

Параметры для блока этапа блочного большого двоичного объекта из операции URL-адреса.

Возвращаемое значение

Promise<BlockBlobStageBlockFromURLResponse>

Ответные данные для блока этапа блочного большого двоичного объекта из операции URL-адреса.

syncUploadFromURL(string, BlockBlobSyncUploadFromURLOptions)

Создает новый блочный BLOB-объект, в котором содержимое большого двоичного объекта считываются из заданного URL-адреса. Этот API поддерживается начиная с версии 2020-04-08. Частичные обновления не поддерживаются с помощью PUT BLOB-объекта из URL-адреса; Содержимое существующего большого двоичного объекта перезаписывается содержимым нового большого двоичного объекта. Чтобы выполнить частичные обновления содержимого блочного blob-объекта с помощью исходного URL-адреса, используйте stageBlockFromURL и commitBlockList.

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

Параметры

sourceURL: string

options: BlockBlobSyncUploadFromURLOptions

Необязательные параметры.

Возвращаемое значение

Promise<BlockBlobPutBlobFromUrlResponse>

upload(RequestBodyType, number, BlockBlobUploadOptions)

Создает новый блочный большой двоичный объект или обновляет содержимое существующего блочного большого двоичного объекта. Обновление существующего блочного BLOB-объекта перезаписывает все существующие метаданные большого двоичного объекта. Частичные обновления не поддерживаются; Содержимое существующего большого двоичного объекта перезаписывается новым содержимым. Чтобы выполнить частичное обновление блочного большого двоичного объекта, используйте stageBlock и commitBlockList.

Это не параллельный метод отправки, используйте uploadFile, uploadStream или uploadBrowserData для повышения производительности при отправке параллелизма.

См. https://docs.microsoft.com/rest/api/storageservices/put-blob

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

Параметры

body: HttpRequestBody

Blob, string, 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 в блок больших двоичных объектов.

Если длина буфера меньше или равна 256 МБ, этот метод будет использовать 1 вызов отправки для завершения отправки. В противном случае этот метод вызовет stageBlock для отправки блоков и, наконец, вызовет commitBlockList для фиксации списка блокировок.

Распространенный параметр blobHTTPHeaders установлен blobContentType, что позволяет браузеру предоставлять функциональные возможности на основе типа файла.

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

Параметры

browserData: Blob | ArrayBuffer | ArrayBufferView

Blob, File, ArrayBuffer или ArrayBufferView

options: BlockBlobParallelUploadOptions

Параметры отправки данных браузера.

Возвращаемое значение

Promise<BlobUploadCommonResponse>

Ответные данные для операции отправки BLOB-объектов.

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

Отправляет объект Buffer(Node.js)/Blob(browsers)/ArrayBuffer/ArrayBufferView в BlockBlob.

Если длина данных не превышает maxSingleShotS ize (по умолчанию <xref:BLOCK_BLOB_MAX_UPLOAD_BLOB_BYTES>), этот метод будет использовать 1 отправки для завершения отправки. В противном случае этот метод вызовет stageBlock для отправки блоков и, наконец, вызовет commitBlockList для фиксации списка блокировок.

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.

Отправляет локальный файл в блоки в блочный большой двоичный объект.

Если размер файла меньше или равен 256 МБ, этот метод будет использовать 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 для чтения в блочный большой двоичный объект.

СОВЕТЫ ПО УЛУЧШЕНИЮ ПРОИЗВОДИТЕЛЬНОСТИ:

Входной поток highWaterMark лучше задать то же значение с параметром bufferSize, что позволит избежать операций Buffer.concat().

function uploadStream(stream: Readable, bufferSize?: number, maxConcurrency?: number, options?: BlockBlobUploadStreamOptions): Promise<BlobUploadCommonResponse>

Параметры

stream: Readable

Node.js доступный для чтения поток

bufferSize: number

Размер каждого выделенного буфера, а также размер блока в отправленном блочного BLOB-объекта. Значение по умолчанию — 8 МБ

maxConcurrency: number

Максимальное число параллелизмов указывает максимальное количество буферов, которые могут быть выделены, положительная корреляция с максимальной загрузкой параллелизма. Значение по умолчанию — 5

options: BlockBlobUploadStreamOptions

Параметры отправки потока в операцию блочного BLOB-объекта.

Возвращаемое значение

Promise<BlobUploadCommonResponse>

Ответные данные для операции отправки BLOB-объектов.

withSnapshot(string)

Создает новый объект BlockBlobClient, идентичный источнику, но с указанной меткой времени моментального снимка. Укажите "" приведет к удалению моментального снимка и возврату URL-адреса базовому BLOB-объекту.

function withSnapshot(snapshot: string): BlockBlobClient

Параметры

snapshot: string

Метка времени моментального снимка.

Возвращаемое значение

BlockBlobClient

Новый объект BlockBlobClient идентичен источнику, но с указанной меткой времени моментального снимка.

Сведения о наследуемом методе

abortCopyFromURL(string, BlobAbortCopyFromURLOptions)

Прервана ожидающая асинхронная операция копирования 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)

Асинхронно копирует большой двоичный объект в место назначения в учетной записи хранения. Этот метод возвращает длительный опрос операций, позволяющий ждать неограниченное время, пока копия не будет завершена. Вы также можете отменить копию перед его завершением, вызвав cancelOperation на опросе. Обратите внимание, что обратный вызов onProgress не будет вызываться, если операция завершается в первом запросе, и попытка отменить завершенную копию приведет к возникновению ошибки.

В версии 2012-02-12 и более поздних версиях источник операции копирования BLOB-объектов может быть зафиксированным BLOB-объектом в любой учетной записи хранения Azure. Начиная с версии 2015-02-21 источник операции копирования BLOB-объектов может быть файлом Azure в любой учетной записи хранения Azure. Только учетные записи хранения, созданные 7 июня 2012 г., позволяют операции копирования 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

URL-адрес исходного BLOB-объекта Или файла Azure.

options: BlobBeginCopyFromURLOptions

Необязательные параметры для операции запуска копирования BLOB-объектов из URL-адреса.

Возвращаемое значение

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

унаследован отBLOBClient.beginCopyFromURL

createSnapshot(BlobCreateSnapshotOptions)

Создает моментальный снимок большого двоичного объекта только для чтения.

См. https://docs.microsoft.com/en-us/rest/api/storageservices/snapshot-blob

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

Параметры

options: BlobCreateSnapshotOptions

Необязательные параметры операции создания моментального снимка БОЛЬШОго двоичного объекта.

Возвращаемое значение

Promise<BlobCreateSnapshotResponse>

наследуется отBLOBClient.createSnapshot

delete(BlobDeleteOptions)

Помечает указанный большой двоичный объект или моментальный снимок для удаления. Большой двоичный объект позже удаляется во время сборки мусора. Обратите внимание, что для удаления большого двоичного объекта необходимо удалить все его моментальные снимки. Вы можете одновременно удалить оба объекта с помощью операции удаления 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-объектов.

См. 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)

Удалите политику immutablility в большом двоичном объекте.

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

Параметры

options: BlobDeleteImmutabilityPolicyOptions

Необязательные параметры для удаления политики неизменяемости в большом двоичном объекте.

Возвращаемое значение

Promise<BlobDeleteImmutabilityPolicyResponse>

наследуется отBLOBClient.deleteImmutabilityPolicy

download(number, number, BlobDownloadOptions)

Считывает или загружает большой двоичный объект из системы, включая его метаданные и свойства. Вы также можете вызвать get BLOB-объект для чтения моментального снимка.

В Node.jsданные возвращаются в потоке, доступном для чтения, доступном для чтенияStreamBody
В браузерах данные возвращаются в объекте blobBody обещания

См. https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob

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

Параметры

offset: number

С какой позиции большого двоичного объекта для скачивания больше или равно 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 параллельно с буфером. Смещение и количество необязательными, загружает весь большой двоичный объект, если они не предоставлены.

Предупреждение. Буферы могут поддерживать только файлы до одного гигабайта в 32-разрядных системах или около двух гигабайтов в 64-разрядных системах из-за ограничений Node.js/V8. Для больших двоичных объектов, превышающих этот размер, рекомендуется downloadToFile.

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

Параметры

buffer: Buffer

Буфер для заполнения должен иметь длину больше, чем число

offset: number

Положение блочного большого двоичного объекта для скачивания (в байтах)

count: number

Сколько данных (в байтах) нужно скачать. Будет загружаться в конец при передаче неопределенных

options: BlobDownloadToBufferOptions

BlobDownloadToBufferOptions

Возвращаемое значение

Promise<Buffer>

унаследован отBLOBClient.downloadToBuffer

downloadToBuffer(number, number, BlobDownloadToBufferOptions)

ДОСТУПНО ТОЛЬКО В СРЕДЕ ВЫПОЛНЕНИЯ NODE.JS.

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

Параметры

offset: number

Положение блочного большого двоичного объекта для скачивания (в байтах)

count: number

Сколько данных (в байтах) нужно скачать. Будет загружаться в конец при передаче неопределенных

options: BlobDownloadToBufferOptions

BlobDownloadToBufferOptions

Возвращаемое значение

Promise<Buffer>

унаследован отBLOBClient.downloadToBuffer

downloadToFile(string, number, number, BlobDownloadOptions)

ДОСТУПНО ТОЛЬКО В СРЕДЕ ВЫПОЛНЕНИЯ NODE.JS.

Загружает большой двоичный объект Azure в локальный файл. Завершается ошибкой, если указанный путь к файлу уже завершается. Смещение и число являются необязательными, передайте 0 и не определено соответственно, чтобы скачать весь большой двоичный объект.

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

Параметры

filePath: string

offset: number

С какой позиции блочного большого двоичного объекта можно скачать.

count: number

Сколько данных нужно скачать. Будет скачиваться в конец при передаче неопределенного значения.

options: BlobDownloadOptions

Параметры скачивания BLOB-объектов.

Возвращаемое значение

Promise<BlobDownloadResponseParsed>

Данные отклика для операции скачивания BLOB-объектов, но при использовании readableStreamBody установлено значение undefined, так как его содержимое уже считывается и записывается в локальный файл по указанному пути.

унаследовано отBLOBClient.downloadToFile

exists(BlobExistsOptions)

Возвращает значение true, если ресурс BLOB-объектов Azure, представленный этим клиентом; False в противном случае.

ПРИМЕЧАНИЕ. Используйте эту функцию с осторожностью, так как существующий большой двоичный объект может быть удален другими клиентами или приложениями. Наоборот, новые большие двоичные объекты могут быть добавлены другими клиентами или приложениями после завершения этой функции.

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

Параметры

options: BlobExistsOptions

параметры операции "Существует".

Возвращаемое значение

Promise<boolean>

наследуется отBLOBClient.существует

generateSasUrl(BlobGenerateSasUrlOptions)

Доступно только для BLOBClient, созданного с использованием учетных данных общего ключа.

Создает универсальный код ресурса (SAS) подписанного URL-адреса службы BLOB-объектов на основе свойств клиента и параметров, переданных в. SAS подписан учетными данными общего ключа клиента.

См. https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas

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

Параметры

options: BlobGenerateSasUrlOptions

Необязательные параметры.

Возвращаемое значение

Promise<string>

URI SAS, состоящий из URI ресурса, представленного этим клиентом, за которым следует созданный маркер SAS.

наследуется отBLOBClient.generateSasUrl

getAccountInfo(BlobGetAccountInfoOptions)

Операция Get Account Information возвращает имя sku и тип учетной записи для указанной учетной записи. Операция получения сведений об учетной записи доступна в версиях служб, начиная с версии 2018-03-28.

См. https://docs.microsoft.com/en-us/rest/api/storageservices/get-account-information

function getAccountInfo(options?: BlobGetAccountInfoOptions): Promise<BlobGetAccountInfoResponse>

Параметры

options: BlobGetAccountInfoOptions

Параметры операции получения сведений об учетной записи службы.

Возвращаемое значение

Promise<BlobGetAccountInfoResponse>

Ответные данные для операции получения сведений об учетной записи службы.

наследуется отBLOBClient.getAccountInfo

getAppendBlobClient()

Создает объект AppendBlobClient.

function getAppendBlobClient(): AppendBlobClient

Возвращаемое значение

AppendBlobClient

унаследован отBLOBClient.getAppendBlobClient

getBlobLeaseClient(string)

Получите BlobLeaseClient, которая управляет арендой большого двоичного объекта.

function getBlobLeaseClient(proposeLeaseId?: string): BlobLeaseClient

Параметры

proposeLeaseId: string

Первоначальный предлагаемый идентификатор аренды.

Возвращаемое значение

BlobLeaseClient

Новый объект BlobLeaseClient для управления арендой большого двоичного объекта.

наследуется отBLOBClient.getBlobLeaseClient

getBlockBlobClient()

Создает объект BlockBlobClient.

function getBlockBlobClient(): BlockBlobClient

Возвращаемое значение

BlockBlobClient

унаследован отBLOBClient.getBlockBlobClient

getPageBlobClient()

Создает объект PageBlobClient.

function getPageBlobClient(): PageBlobClient

Возвращаемое значение

PageBlobClient

наследуется отBLOBClient.getPageBlobClient

getProperties(BlobGetPropertiesOptions)

Возвращает все пользовательские метаданные, стандартные свойства HTTP и системные свойства большого двоичного объекта. Он не возвращает содержимое большого двоичного объекта.

См. https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-properties

ПРЕДУПРЕЖДЕНИЕ. Объект metadata, возвращенный в ответе, будет иметь свои ключи в нижнем регистре, даже если они первоначально содержали прописные символы. Это отличается от ключей метаданных, возвращаемых методами ContainerClient, которые перечисляют большие двоичные объекты с помощью параметра includeMetadata, который будет хранить исходный регистр.

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)

Задает уровень в большом двоичном объекте. Операция разрешена на странице большого двоичного объекта в учетной записи хранения класса Premium и в блочных BLOB-объектах в учетной записи хранения BLOB-объектов (только локально избыточное хранилище). Уровень большого двоичного объекта страницы уровня "Премиум" определяет допустимый размер, операции ввода-вывода в секунду и пропускную способность большого двоичного объекта. Уровень блочного большого двоичного объекта определяет тип хранилища Hot/Cool/Archive. Эта операция не обновляет ETag большого двоичного объекта.

См. https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-tier

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

Параметры

tier: string

Уровень, который необходимо задать в большом двоичном объекте. Допустимые значения: "Горячий", "Холодный" или "Архив".

options: BlobSetTierOptions

Необязательные параметры для операции набора BLOB-объектов.

Возвращаемое значение

Promise<BlobSetTierResponse>

унаследован отBLOBClient.setAccessTier

setHTTPHeaders(BlobHTTPHeaders, BlobSetHTTPHeadersOptions)

Задает системные свойства большого двоичного объекта.

Если для указанных заголовков HTTP большого двоичного объекта не задано никакого значения, эти заголовки HTTP БОЛЬШИХ двоичных объектов без значения будут удалены.

См. https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties

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

Параметры

blobHTTPHeaders: BlobHTTPHeaders

Если для указанных заголовков HTTP большого двоичного объекта не задано никакого значения, эти заголовки HTTP БОЛЬШИХ двоичных объектов без значения будут удалены. Общий заголовок, который необходимо задать, blobContentType позволяет браузеру предоставлять функциональные возможности на основе типа файла.

options: BlobSetHTTPHeadersOptions

Необязательные параметры операции набора заголовков HTTP для набора BLOB-объектов.

Возвращаемое значение

Promise<BlobSetHTTPHeadersResponse>

наследуется отBLOBClient.setHTTPHeaders

setImmutabilityPolicy(BlobImmutabilityPolicy, BlobSetImmutabilityPolicyOptions)

Задайте политику неизменяемости в большом двоичном объекте.

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

Параметры

immutabilityPolicy: BlobImmutabilityPolicy

options: BlobSetImmutabilityPolicyOptions

Необязательные параметры для задания политики неизменяемости в большом двоичном объекте.

Возвращаемое значение

Promise<BlobSetImmutabilityPolicyResponse>

наследуется отBLOBClient.setImmutabilityPolicy

setLegalHold(boolean, BlobSetLegalHoldOptions)

Установите юридическое удержание большого двоичного объекта.

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

Параметры

legalHoldEnabled: boolean

options: BlobSetLegalHoldOptions

Необязательные параметры для задания юридического удержания большого двоичного объекта.

Возвращаемое значение

Promise<BlobSetLegalHoldResponse>

унаследован отBLOBClient.setLegalHold

setMetadata(Metadata, BlobSetMetadataOptions)

Задает определяемые пользователем метаданные для указанного большого двоичного объекта в виде одной или нескольких пар "имя-значение".

Если параметр не указан или метаданные, определенные в параметре, метаданные большого двоичного объекта будут удалены.

См. 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)

Задает теги в базовом большом двоичном объекте. Большой двоичный объект может содержать до 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-адреса копирует большой двоичный объект или интернет-ресурс в новый большой двоичный объект. Он не вернет ответ до завершения копирования.

См. https://docs.microsoft.com/en-us/rest/api/storageservices/copy-blob-from-url

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

Параметры

copySource: string

Исходный URL-адрес для копирования, возможно, требуется для проверки подлинности.

options: BlobSyncCopyFromURLOptions

Возвращаемое значение

Promise<BlobCopyFromURLResponse>

наследуется отBLOBClient.syncCopyFromURL

undelete(BlobUndeleteOptions)

Восстанавливает содержимое и метаданные обратимого удаленного большого двоичного объекта и всех связанных обратимо удаленных моментальных снимков. Отмена удаления BLOB-объектов поддерживается только в версии 2017-07-29 или более поздней версии.

См. 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)

Создает новый объект BlobClient, указывающий на версию этого большого двоичного объекта. Укажите "" приведет к удалению идентификатора версии и возвратите клиенту базовый большой двоичный объект.

function withVersion(versionId: string): BlobClient

Параметры

versionId: string

Идентификатор версии.

Возвращаемое значение

BlobClient

Новый объект BLOBClient, указывающий на версию этого большого двоичного объекта.

унаследован отBLOBClient.withVersion

Поделиться через

BlockBlobClient class

Конструкторы

Свойства

Унаследованные свойства

Методы

Наследуемые методы

Сведения о конструкторе

BlockBlobClient(string, PipelineLike)

Параметры

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

Параметры

BlockBlobClient(string, string, string, StoragePipelineOptions)

Параметры

Сведения о свойстве

containerName

Значение свойства

name

Значение свойства

Сведения об унаследованном свойстве

accountName

Значение свойства

credential

Значение свойства

url

Значение свойства

Сведения о методе

commitBlockList(string[], BlockBlobCommitBlockListOptions)

Параметры

Возвращаемое значение

getBlockList(BlockListType, BlockBlobGetBlockListOptions)

Параметры

Возвращаемое значение

query(string, BlockBlobQueryOptions)

Параметры

Возвращаемое значение

stageBlock(string, RequestBodyType, number, BlockBlobStageBlockOptions)

Параметры

Возвращаемое значение

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

Параметры

Возвращаемое значение

syncUploadFromURL(string, BlockBlobSyncUploadFromURLOptions)

Параметры

Возвращаемое значение

upload(RequestBodyType, number, BlockBlobUploadOptions)

Параметры

Возвращаемое значение

uploadBrowserData(Blob | ArrayBuffer | ArrayBufferView, BlockBlobParallelUploadOptions)

Параметры

Возвращаемое значение

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

Параметры

Возвращаемое значение

uploadFile(string, BlockBlobParallelUploadOptions)

Параметры

Возвращаемое значение

uploadStream(Readable, number, number, BlockBlobUploadStreamOptions)

Параметры

Возвращаемое значение

withSnapshot(string)

Параметры

Возвращаемое значение

Сведения о наследуемом методе

abortCopyFromURL(string, BlobAbortCopyFromURLOptions)

Параметры

Возвращаемое значение

beginCopyFromURL(string, BlobBeginCopyFromURLOptions)

Параметры

Возвращаемое значение

createSnapshot(BlobCreateSnapshotOptions)

Параметры

Возвращаемое значение

delete(BlobDeleteOptions)

Параметры

Возвращаемое значение

deleteIfExists(BlobDeleteOptions)

Параметры

Возвращаемое значение

deleteImmutabilityPolicy(BlobDeleteImmutabilityPolicyOptions)