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

BlobBatchClient class

  • Ссылка
Пакет:
@azure/storage-blob

BlobBatchClient позволяет выполнять пакетные запросы к службе BLOB-объектов службы хранилища Azure.

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

BlobBatchClient(string, PipelineLike)

Создает экземпляр BlobBatchClient.
BlobBatchClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

Создает экземпляр BlobBatchClient.

Методы

createBatch()

Создает объект <xref:BlobBatch>. BlobBatch представляет собой агрегированный набор операций с большими двоичными объектами.
deleteBlobs(BlobClient[], BlobDeleteOptions)

Создайте несколько операций удаления, чтобы пометить указанные большие двоичные объекты или моментальные снимки для удаления. Обратите внимание, что для удаления большого двоичного объекта необходимо удалить все его моментальные снимки. Вы можете удалить оба одновременно. См. сведения об операции удаления. Операция (вложенный запрос) будет проходить проверку подлинности и авторизоваться с указанными учетными данными. См . сведения об авторизации пакета BLOB-объектов.
deleteBlobs(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, BlobDeleteOptions)

Создайте несколько операций удаления, чтобы пометить указанные большие двоичные объекты или моментальные снимки для удаления. Обратите внимание, что для удаления большого двоичного объекта необходимо удалить все его моментальные снимки. Вы можете удалить оба одновременно. См. сведения об операции удаления. Операции будут проходить проверку подлинности и авторизоваться с помощью указанных учетных данных. См . сведения об авторизации пакета BLOB-объектов.
setBlobsAccessTier(BlobClient[], AccessTier, BlobSetTierOptions)

Создайте несколько операций уровня набора, чтобы задать уровень в большом двоичном объекте. Операция разрешена для страничного BLOB-объекта в учетной записи хранения класса Premium и блочного BLOB-объекта в учетной записи хранения BLOB-объектов (только локально избыточное хранилище). Уровень страничного BLOB-объекта уровня "Премиум" определяет допустимый размер, операции ввода-вывода в секунду и пропускную способность большого двоичного объекта. Уровень блочного BLOB-объекта определяет тип горячего, холодного или архивного хранилища. Эта операция не обновляет ETag большого двоичного объекта. См . сведения о настройке уровня BLOB-объектов. Операция (вложенный запрос) будет проходить проверку подлинности и авторизоваться с помощью указанных учетных данных. См. сведения об авторизации пакетной службы BLOB-объектов.
setBlobsAccessTier(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, AccessTier, BlobSetTierOptions)

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

Отправка пакетного запроса, состоящего из нескольких вложенных запросов. Получение blobBatchClient и другие сведения перед запуском фрагментов кода. blobServiceClient.getBlobBatchClient() предоставляет blobBatchClient

Пример использования:

let batchRequest = new BlobBatch();
await batchRequest.deleteBlob(urlInString0, credential0);
await batchRequest.deleteBlob(urlInString1, credential1, {
 deleteSnapshots: "include"
});
const batchResp = await blobBatchClient.submitBatch(batchRequest);
console.log(batchResp.subResponsesSucceededCount);

Пример использования аренды:

let batchRequest = new BlobBatch();
await batchRequest.setBlobAccessTier(blockBlobClient0, "Cool");
await batchRequest.setBlobAccessTier(blockBlobClient1, "Cool", {
 conditions: { leaseId: leaseId }
});
const batchResp = await blobBatchClient.submitBatch(batchRequest);
console.log(batchResp.subResponsesSucceededCount);

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

BlobBatchClient(string, PipelineLike)

Создает экземпляр BlobBatchClient.

new BlobBatchClient(url: string, pipeline: PipelineLike)

Параметры

url

string

URL-адрес, указывающий на службу BLOB-объектов службы хранилища Azure, например "https://myaccount.blob.core.windows.net". Вы можете добавить SAS при использовании AnonymousCredential, например "https://myaccount.blob.core.windows.net?sasString"".

pipeline
PipelineLike

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

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

Создает экземпляр BlobBatchClient.

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

Параметры

url

string

URL-адрес, указывающий на службу BLOB-объектов службы хранилища Azure, например "https://myaccount.blob.core.windows.net". Вы можете добавить SAS при использовании AnonymousCredential, например "https://myaccount.blob.core.windows.net?sasString"".

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

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

options
StoragePipelineOptions

Параметры для настройки конвейера HTTP.

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

createBatch()

Создает объект <xref:BlobBatch>. BlobBatch представляет собой агрегированный набор операций с большими двоичными объектами.

function createBatch()

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

BlobBatch

deleteBlobs(BlobClient[], BlobDeleteOptions)

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

function deleteBlobs(blobClients: BlobClient[], options?: BlobDeleteOptions)

Параметры

blobClients

BlobClient[]

BlobClients для удаляемых BLOB-объектов.

options
BlobDeleteOptions

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

Promise<BlobBatchDeleteBlobsResponse>

deleteBlobs(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, BlobDeleteOptions)

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

function deleteBlobs(urls: string[], credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: BlobDeleteOptions)

Параметры

urls

string[]

URL-адреса удаляемых ресурсов BLOB-объектов.

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

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

options
BlobDeleteOptions

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

Promise<BlobBatchDeleteBlobsResponse>

setBlobsAccessTier(BlobClient[], AccessTier, BlobSetTierOptions)

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

function setBlobsAccessTier(blobClients: BlobClient[], tier: AccessTier, options?: BlobSetTierOptions)

Параметры

blobClients

BlobClient[]

BlobClients для больших двоичных объектов, которые должны иметь новый уровень.

tier
AccessTier
options
BlobSetTierOptions

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

Promise<BlobBatchSetBlobsAccessTierResponse>

setBlobsAccessTier(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, AccessTier, BlobSetTierOptions)

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

function setBlobsAccessTier(urls: string[], credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, tier: AccessTier, options?: BlobSetTierOptions)

Параметры

urls

string[]

URL-адреса удаляемого ресурса BLOB-объекта.

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

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

tier
AccessTier
options
BlobSetTierOptions

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

Promise<BlobBatchSetBlobsAccessTierResponse>

submitBatch(BlobBatch, BlobBatchSubmitBatchOptionalParams)

Отправка пакетного запроса, состоящего из нескольких вложенных запросов. Получение blobBatchClient и другие сведения перед запуском фрагментов кода. blobServiceClient.getBlobBatchClient() предоставляет blobBatchClient

Пример использования:

let batchRequest = new BlobBatch();
await batchRequest.deleteBlob(urlInString0, credential0);
await batchRequest.deleteBlob(urlInString1, credential1, {
 deleteSnapshots: "include"
});
const batchResp = await blobBatchClient.submitBatch(batchRequest);
console.log(batchResp.subResponsesSucceededCount);

Пример использования аренды:

let batchRequest = new BlobBatch();
await batchRequest.setBlobAccessTier(blockBlobClient0, "Cool");
await batchRequest.setBlobAccessTier(blockBlobClient1, "Cool", {
 conditions: { leaseId: leaseId }
});
const batchResp = await blobBatchClient.submitBatch(batchRequest);
console.log(batchResp.subResponsesSucceededCount);

function submitBatch(batchRequest: BlobBatch, options?: BlobBatchSubmitBatchOptionalParams)

Параметры

batchRequest
BlobBatch

Набор операций Delete или SetTier.

options
BlobBatchSubmitBatchOptionalParams

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

Promise<BlobBatchSubmitBatchResponse>