BlobBatchClient class
BlobBatchClient позволяет выполнять пакетные запросы к службе BLOB-объектов службы хранилища Azure.
Конструкторы
| Blob |
Создает экземпляр BlobBatchClient. |
| Blob |
Создает экземпляр BlobBatchClient. |
Методы
| create |
Создает объект <xref:BlobBatch>. BlobBatch представляет собой агрегированный набор операций с большими двоичными объектами. |
| delete |
Создайте несколько операций удаления, чтобы пометить указанные большие двоичные объекты или моментальные снимки для удаления. Обратите внимание, что для удаления большого двоичного объекта необходимо удалить все его моментальные снимки. Вы можете удалить оба одновременно. См. сведения об операции удаления. Операция (вложенный запрос) будет проходить проверку подлинности и авторизоваться с указанными учетными данными. См . сведения об авторизации пакета BLOB-объектов. |
| delete |
Создайте несколько операций удаления, чтобы пометить указанные большие двоичные объекты или моментальные снимки для удаления. Обратите внимание, что для удаления большого двоичного объекта необходимо удалить все его моментальные снимки. Вы можете удалить оба одновременно. См. сведения об операции удаления. Операции будут проходить проверку подлинности и авторизоваться с помощью указанных учетных данных. См . сведения об авторизации пакета BLOB-объектов. |
| set |
Создайте несколько операций уровня набора, чтобы задать уровень в большом двоичном объекте. Операция разрешена для страничного BLOB-объекта в учетной записи хранения класса Premium и блочного BLOB-объекта в учетной записи хранения BLOB-объектов (только локально избыточное хранилище). Уровень страничного BLOB-объекта уровня "Премиум" определяет допустимый размер, операции ввода-вывода в секунду и пропускную способность большого двоичного объекта. Уровень блочного BLOB-объекта определяет тип горячего, холодного или архивного хранилища. Эта операция не обновляет ETag большого двоичного объекта. См . сведения о настройке уровня BLOB-объектов. Операция (вложенный запрос) будет проходить проверку подлинности и авторизоваться с помощью указанных учетных данных. См. сведения об авторизации пакетной службы BLOB-объектов. |
| set |
Создайте несколько операций уровня набора, чтобы задать уровень в большом двоичном объекте. Операция разрешена для страничного BLOB-объекта в учетной записи хранения класса Premium и блочного BLOB-объекта в учетной записи хранения BLOB-объектов (только локально избыточное хранилище). Уровень страничного BLOB-объекта уровня "Премиум" определяет допустимый размер, операции ввода-вывода в секунду и пропускную способность большого двоичного объекта. Уровень блочного BLOB-объекта определяет тип горячего, холодного или архивного хранилища. Эта операция не обновляет ETag большого двоичного объекта. См . сведения о настройке уровня BLOB-объектов. Операция (вложенный запрос) будет проходить проверку подлинности и авторизоваться с помощью указанных учетных данных. См. сведения об авторизации пакетной службы BLOB-объектов. |
| submit |
Отправка пакетного запроса, состоящего из нескольких вложенных запросов.
Получение Пример использования: Пример использования аренды: |
Сведения о конструкторе
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()Возвращаемое значение
deleteBlobs(BlobClient[], BlobDeleteOptions)
Создайте несколько операций удаления, чтобы пометить указанные большие двоичные объекты или моментальные снимки для удаления. Обратите внимание, что для удаления большого двоичного объекта необходимо удалить все его моментальные снимки. Вы можете удалить оба одновременно. См. сведения об операции удаления. Операция (вложенный запрос) будет проходить проверку подлинности и авторизоваться с указанными учетными данными. См . сведения об авторизации пакета BLOB-объектов.
function deleteBlobs(blobClients: BlobClient[], options?: BlobDeleteOptions)Параметры
- blobClients
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
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.
Возвращаемое значение
Promise<BlobBatchSubmitBatchResponse>
Azure SDK for JavaScript
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по