Azure.Storage.Blobs.Specialized Espace de noms

vous AppendBlobClient permet de manipuler des objets blob d’ajout de Stockage Azure.

Un objet blob d’ajout est composé de blocs et est optimisé pour les opérations d’ajout. Lorsque vous modifiez un objet blob d’ajout, les blocs sont ajoutés à la fin de l’objet blob uniquement, via l’opération Azure.Storage.Blobs.Specialized.AppendBlobClient.AppendBlockAsync(System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.AppendBlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) . La mise à jour ou la suppression de blocs existants n’est pas prise en charge. Contrairement à un objet blob de blocs, un objet blob d’ajout n’expose pas ses ID de bloc.

Chaque bloc d’un objet blob d’ajout peut avoir une taille différente. À compter de x-ms-version 2022-11-02, la taille maximale de l’ajout est de 100 Mo. Pour les versions précédentes, la taille maximale de l’ajout est de 4 Mo. Les objets blob d’ajout peuvent inclure jusqu’à 50 000 blocs.

BlobBaseClient vous permet de manipuler des blobs Stockage Azure.

Un BlobBatch vous permet de traiter par lot plusieurs opérations de stockage Azure dans une seule requête via SubmitBatch(BlobBatch, Boolean, CancellationToken).

Pour plus d'informations, consultez la rubrique Lot d’objets blob.

vous BlobBatchClient permet de traiter par lot plusieurs opérations de stockage Azure dans une seule requête.

vous BlobLeaseClient permet de manipuler les baux stockage Azure sur des conteneurs et des objets blob.

vous BlockBlobClient permet de manipuler des objets blob de blocs de stockage Azure.

Les objets blob de blocs vous permettent de télécharger efficacement des objets blob volumineux. Les objets BLOB de blocs sont composés de blocs, chacun étant identifié par un ID de bloc. Vous créez ou modifiez un objet BLOB de blocs en écrivant un ensemble de blocs et en validant leur ID de bloc. Chaque bloc peut avoir une taille différente, jusqu’à un maximum de 4 000 Mo (100 Mo pour les demandes utilisant des versions REST antérieures à 2019-12-2012 et 4 Mo pour les demandes utilisant des versions REST antérieures au 31-05-2016), et un objet blob de blocs peut inclure jusqu’à 50 000 blocs. La taille maximale d’un objet blob de blocs est donc d’environ 190,73 Tio (4 000 Mo x 50 000 blocs). Si vous écrivez un objet blob de blocs dont la taille ne dépasse pas 5 000 Mo, vous pouvez le charger dans son intégralité avec une seule opération d’écriture ; consultez UploadAsync(Stream, BlobUploadOptions, CancellationToken).

Quand vous téléchargez un bloc dans un objet BLOB de votre compte de stockage, il est associé à l'objet BLOB de blocs spécifié, mais il ne fait pas partie de l'objet BLOB tant que vous n'avez pas validé une liste de blocs incluant l'ID du nouveau bloc. Les nouveaux blocs restent en état non validé tant qu'ils ne sont pas spécifiquement validés ou ignorés. L'écriture d'un bloc ne met pas à jour l'heure de dernière modification d'un objet blob existant.

Les objets blob de blocs incluent des fonctionnalités qui vous aident à gérer les fichiers volumineux sur un réseau. Avec un objet blob de blocs, vous pouvez télécharger plusieurs blocs en parallèle pour réduire le temps de téléchargement. Chaque bloc peut inclure un hachage MD5 pour vérifier le transfert, ce qui vous permet de suivre la progression du chargement et de renvoyer les blocs si nécessaire. Vous pouvez charger des blocs dans n’importe quel ordre et déterminer leur séquence à l’étape finale d’engagement de la liste de blocs. Vous pouvez aussi télécharger un nouveau bloc pour remplacer un bloc validé existant associé au même ID de bloc. Vous avez une semaine pour valider les blocs dans un objet BLOB avant qu'ils soient ignorés. Tous les blocs non validés sont ignorés quand ils sont exclus lors d'une opération de validation de liste de blocs.

Vous pouvez modifier un objet blob de blocs existant en insérant, remplaçant ou supprimant des blocs existants. Après avoir téléchargé le ou les blocs modifiés, vous pouvez valider une nouvelle version de l'objet blob en validant les nouveaux blocs en même temps que les blocs existants que vous souhaitez conserver en une seule opération de validation. Pour insérer la même plage d’octets à deux emplacements différents de l’objet blob validé, vous pouvez valider le même bloc à deux emplacements dans la même opération de validation. Pour toute opération de validation, si un bloc est introuvable, l’opération d’engagement entière échoue avec une erreur et l’objet blob n’est pas modifié. Toute validation de bloc remplace les propriétés et les métadonnées existantes de l'objet BLOB, et ignore tous les blocs non validés.

Les ID de bloc sont des chaînes de longueur égale dans un objet blob. Le code client de bloc utilise généralement le codage en base 64 pour normaliser les chaînes en longueurs égales. Dans le codage en base 64, la chaîne précodée doit mesurer 64 octets maximum. Les valeurs d'ID de bloc peuvent être dupliquées dans différents objets blob. Un objet blob peut avoir jusqu’à 100 000 blocs non validés, avec une taille totale maximale de 381,46 Tio (4 000 Mo x 100 000 blocs)

Si vous écrivez un bloc pour un objet blob qui n'existe pas, un nouvel objet blob de blocs est créé avec une longueur de zéro octet. Cet objet blob apparaît dans les listes d'objets blob qui incluent les objets blob non validés. Si vous ne validez aucun bloc de cet objet BLOB, ce dernier ainsi que ses blocs non validés seront ignorés au bout d'une semaine après le dernier téléchargement de blocs. Tous les blocs non validés sont également ignorés lorsqu’un nouvel objet blob du même nom est créé à l’aide d’une seule étape (plutôt que du processus de chargement de blocs en deux étapes).

vous PageBlobClient permet de manipuler des objets blob de page Stockage Azure.

Les objets blob de pages sont une collection de pages de 512 octets optimisées pour les opérations aléatoires de lecture et d'écriture. Pour créer un objet blob de pages, vous initialisez l'objet blob de pages et spécifiez la taille maximale qu'il pourra atteindre. Pour ajouter ou mettre à jour le contenu d'un objet blob de pages, vous écrivez une ou plusieurs pages en spécifiant un décalage et une plage conformément aux limites de pages de 512 octets. Une écriture dans un objet blob de pages peut remplacer une seule page, certaines pages ou un maximum de 4 Mo de l'objet blob de pages. Les écritures dans les objets blob de pages se produisent sur place et sont immédiatement validées dans l'objet blob. La taille maximale d’un objet blob de pages est de 8 To.

Fournit des options de configuration client avancées pour la connexion à Stockage Blob Azure.

Ajoutez des méthodes faciles à BlobContainerClient découvrir pour créer AppendBlobClient des instances.