Azure.Storage.Blobs.Specialized Espacio de nombres

Clases

AppendBlobClient

AppendBlobClient permite manipular blobs en anexos de Azure Storage.

Un blob en anexos se compone de bloques y está optimizado para las operaciones de anexión. Al modificar un blob en anexos, los bloques se agregan solo al final del blob a través de la Azure.Storage.Blobs.Specialized.AppendBlobClient.AppendBlockAsync(System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.AppendBlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) operación . No se admite la actualización o eliminación de bloques existentes. A diferencia de un blob en bloques, un blob en anexos no expone sus identificadores de bloque.

Cada bloque de un blob en anexos puede tener un tamaño diferente. A partir de x-ms-version 2022-11-02, el tamaño máximo de anexión es de 100 MB. En las versiones anteriores, el tamaño máximo de anexión es de 4 MB. Los blobs en anexos pueden incluir hasta 50 000 bloques.

BlobBaseClient

BlobBaseClient permite manipular los blobs de Azure Storage.

BlobBatch

Un BlobBatch permite procesar por lotes varias operaciones de Azure Storage en una sola solicitud a través de SubmitBatch(BlobBatch, Boolean, CancellationToken).

Para obtener más información, vea Blob Batch.

BlobBatchClient

BlobBatchClient permite procesar por lotes varias operaciones de Azure Storage en una sola solicitud.

BlobLeaseClient

BlobLeaseClient permite manipular concesiones de Azure Storage en contenedores y blobs.

BlockBlobClient

BlockBlobClient permite manipular blobs en bloques de Azure Storage.

Los blobs en bloques permiten cargar blobs grandes de manera eficiente. Los blobs en bloques están formados por bloques, cada uno de los cuales se identifica mediante un identificador de bloque. Es posible crear o modificar un blob en bloques escribiendo un conjunto de bloques y confirmándolos mediante sus identificadores de bloque. Cada bloque puede tener un tamaño diferente, hasta un máximo de 4000 MB (100 MB para las solicitudes que usan versiones REST anteriores a 2019-12-12 y 4 MB para las solicitudes que usan versiones REST anteriores a 2016-05-31) y un blob en bloques puede incluir hasta 50 000 bloques. Por lo tanto, el tamaño máximo de un blob en bloques es de aproximadamente 190,73 TiB (4000 MB X 50 000 bloques). Si está escribiendo un blob en bloques que no tenga más de 5000 MB de tamaño, puede cargarlo en su totalidad con una sola operación de escritura; vea UploadAsync(Stream, BlobUploadOptions, CancellationToken).

Cuando se carga un bloque en un blob de la cuenta de almacenamiento, este está asociado al blob en bloques especificado, pero no se convierte en parte del blob hasta que se confirme una lista de bloques que incluya el identificador del nuevo bloque. Los bloques nuevos permanecen sin confirmar hasta que se confirman o descartan específicamente. Cuando se escribe un bloque no se actualiza la última hora de modificación de los blobs existentes.

Los blobs en bloques disponen de características que ayudan a administrar archivos grandes en varias redes. Con un blob en bloques, puede cargar varios bloques en paralelo para reducir el tiempo de carga. Cada bloque puede incluir un hash MD5 para comprobar la transferencia, por lo que puede realizar un seguimiento del progreso de la carga y volver a enviar bloques según sea necesario. Puede cargar bloques en cualquier orden y determinar su secuencia en el paso de compromiso de la lista de bloqueos final. También puede cargar un bloque nuevo para reemplazar un bloque existente sin confirmar en el mismo identificador de bloque. Tiene una semana para confirmar los bloques de un blob antes de que se descarten. Todos los bloques sin confirmar se descartan también cuando se produce una operación de confirmación de lista de bloques sin incluirlos.

Puede modificar un blob en bloques existente si inserta, reemplaza o elimina los bloques existentes. Después de cargar el bloque o bloques que han cambiado, puede confirmar una versión nueva del blob; para ello, debe confirmar los bloques nuevos con los bloques existentes que desea mantener mediante una sola operación de confirmación. Para insertar el mismo intervalo de bytes en dos ubicaciones diferentes del blob confirmado, puede confirmar el mismo bloque en dos lugares dentro de la misma operación de confirmación. Para cualquier operación de confirmación, si no se encuentra ningún bloque, se produce un error en toda la operación de compromiso y el blob no se modifica. Las confirmaciones de bloque sobrescriben las propiedades y metadatos existentes del blob, y descartan todos los bloques sin confirmar.

Los identificadores de bloque son cadenas de igual longitud en un blob. El código de cliente del bloque suele utilizar codificación de base 64 para homogenizar las cadenas según la misma longitud. Cuando se utiliza codificación de base 64, la cadena codificada previamente debe ser de 64 bytes o menos. Los valores de identificador de bloque puede duplicarse en diferentes blobs. Un blob puede tener hasta 100 000 bloques sin confirmar, con un tamaño total máximo de 381,46 TiB (4000 MB x 100 000 bloques)

Si escribe un bloque para un blob que no exista, se creará un blob en bloques nuevo con cero bytes de longitud. Este blob aparecerá en listas de blobs con blobs sin confirmar. Si no confirma bloques para este blob, tanto el blob como los bloques sin confirmar se descartarán una vez transcurra una semana desde la última vez que se actualizó el bloque correctamente. Todos los bloques no confirmados también se descartan cuando se crea un nuevo blob del mismo nombre mediante un solo paso (en lugar del proceso de carga y confirmación de bloque de dos pasos).

PageBlobClient

PageBlobClient permite manipular blobs en páginas de Azure Storage.

Los blobs en páginas son un conjunto de páginas de 512 bytes optimizadas para operaciones aleatorias de lectura y escritura. Para crear un blob en páginas, se inicializa el blob en páginas y se especifica el tamaño máximo que puede alcanzar el blob en páginas. Para agregar o actualizar el contenido de un blob en páginas, se escribe una página o varias páginas especificando un desplazamiento y un intervalo que se alinean con los límites de las páginas de 512 bytes. Una escritura en un blob en páginas puede sobrescribir solo una página, varias páginas o hasta 4 MB del blob. La escritura en blobs en páginas se realiza en contexto y se confirma inmediatamente en el blob. El tamaño máximo de un blob en páginas es de 8 TB.

SpecializedBlobClientOptions

Proporciona opciones avanzadas de configuración de cliente para conectarse a Azure Blob Storage.

SpecializedBlobExtensions

Agregue métodos fáciles de detectar a BlobContainerClient para crear AppendBlobClient instancias.