BlockBlobClient Clase

Definición

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

public class BlockBlobClient : Azure.Storage.Blobs.Specialized.BlobBaseClient
type BlockBlobClient = class
    inherit BlobBaseClient
Public Class BlockBlobClient
Inherits BlobBaseClient
Herencia
BlockBlobClient

Constructores

BlockBlobClient()

Inicializa una nueva instancia de la BlockBlobClient clase para simular.

BlockBlobClient(String, String, String)

Inicializa una nueva instancia de la clase BlockBlobClient.

BlockBlobClient(String, String, String, BlobClientOptions)

Inicializa una nueva instancia de la clase BlockBlobClient.

BlockBlobClient(Uri, AzureSasCredential, BlobClientOptions)

Inicializa una nueva instancia de la clase BlockBlobClient.

BlockBlobClient(Uri, BlobClientOptions)

Inicializa una nueva instancia de la clase BlockBlobClient.

BlockBlobClient(Uri, StorageSharedKeyCredential, BlobClientOptions)

Inicializa una nueva instancia de la clase BlockBlobClient.

BlockBlobClient(Uri, TokenCredential, BlobClientOptions)

Inicializa una nueva instancia de la clase BlockBlobClient.

Propiedades

AccountName

Obtiene el nombre de la cuenta de almacenamiento correspondiente al cliente de blobs.

(Heredado de BlobBaseClient)
BlobContainerName

Obtiene el nombre del contenedor correspondiente al cliente de blobs.

(Heredado de BlobBaseClient)
BlockBlobMaxBlocks

Obtiene el número máximo de bloques permitidos en un blob en bloques.

BlockBlobMaxStageBlockLongBytes

Obtiene el número máximo de bytes que se pueden enviar en una llamada a Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlockAsync(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken).

BlockBlobMaxUploadBlobLongBytes

Obtiene el número máximo de bytes que se pueden enviar en una llamada a UploadAsync(Stream, BlobUploadOptions, CancellationToken).

CanGenerateSasUri

Determina si el cliente puede generar una SAS. Si el cliente se autentica con un StorageSharedKeyCredential.

(Heredado de BlobBaseClient)
Name

Obtiene el nombre del blob.

(Heredado de BlobBaseClient)
Uri

Obtiene el punto de conexión principal Uri del blob.

(Heredado de BlobBaseClient)

Métodos

AbortCopyFromUri(String, BlobRequestConditions, CancellationToken)

La AbortCopyFromUri(String, BlobRequestConditions, CancellationToken) operación anula un objeto pendiente CopyFromUriOperationy deja un blob con longitud cero y metadatos completos.

Para obtener más información, vea Anule la copia del blob.

(Heredado de BlobBaseClient)
AbortCopyFromUriAsync(String, BlobRequestConditions, CancellationToken)

La AbortCopyFromUriAsync(String, BlobRequestConditions, CancellationToken) operación anula un objeto pendiente CopyFromUriOperationy deja un blob con longitud cero y metadatos completos.

Para obtener más información, vea Anule la copia del blob.

(Heredado de BlobBaseClient)
CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken)

La operación CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken) escribe un blob especificando la lista de identificadores de bloque que conforman el blob. Para poder escribirlo como parte de un blob, un bloque se debe haber escrito correctamente en el servidor en una operación Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) anterior. Puede llamar a CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken) para actualizar un blob cargando solo los bloques que han cambiado y luego confirmando a la vez los bloques nuevos y los existentes. Puede hacerlo especificando si se debe confirmar un bloque de la lista de bloques confirmados o de la lista de bloques sin confirmar, o bien confirmar la versión del bloque que se ha cargado en último lugar, independientemente de la lista a la que pertenezca. Los bloques no especificados en la lista de bloques y eliminados permanentemente.

Para obtener más información, vea Colocar lista de bloques.

CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken)

La operación CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) escribe un blob especificando la lista de identificadores de bloque que conforman el blob. Para poder escribirlo como parte de un blob, un bloque se debe haber escrito correctamente en el servidor en una operación Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) anterior. Puede llamar a CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) para actualizar un blob cargando solo los bloques que han cambiado y luego confirmando a la vez los bloques nuevos y los existentes. Puede hacerlo especificando si se debe confirmar un bloque de la lista de bloques confirmados o de la lista de bloques sin confirmar, o bien confirmar la versión del bloque que se ha cargado en último lugar, independientemente de la lista a la que pertenezca. Los bloques no especificados en la lista de bloques y eliminados permanentemente.

Para obtener más información, vea Colocar lista de bloques.

CreateClient(Uri, BlobClientOptions, HttpPipeline)

Inicializa una nueva instancia de la clase BlockBlobClient.

CreateSnapshot(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

La operación CreateSnapshot(IDictionary<String,String>, BlobRequestConditions, CancellationToken) crea una instantánea de solo lectura de un blob.

Para obtener más información, vea Blob de instantáneas.

(Heredado de BlobBaseClient)
CreateSnapshotAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

La operación CreateSnapshotAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken) crea una instantánea de solo lectura de un blob.

Para obtener más información, vea Blob de instantáneas.

(Heredado de BlobBaseClient)
Delete(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

La operación Delete(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) marca para su eliminación la instantánea o el blob especificado. El blob se elimina posteriormente durante la recolección de elementos no utilizados, lo que puede tardar varios minutos.

Tenga en cuenta que para eliminar un blob, debe eliminar todas sus instantáneas. Puede eliminar ambos al mismo tiempo mediante IncludeSnapshots.

Para obtener más información, vea Eliminar blob.

(Heredado de BlobBaseClient)
DeleteAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

La operación DeleteAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) marca para su eliminación la instantánea o el blob especificado. El blob se elimina posteriormente durante la recolección de elementos no utilizados, lo que puede tardar varios minutos.

Tenga en cuenta que para eliminar un blob, debe eliminar todas sus instantáneas. Puede eliminar ambos al mismo tiempo mediante IncludeSnapshots.

Para obtener más información, vea Eliminar blob.

(Heredado de BlobBaseClient)
DeleteIfExists(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

La DeleteIfExists(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) operación marca el blob o la instantánea especificados para su eliminación, si el blob existe. El blob se elimina posteriormente durante la recolección de elementos no utilizados, lo que puede tardar varios minutos.

Tenga en cuenta que para eliminar un blob, debe eliminar todas sus instantáneas. Puede eliminar ambos al mismo tiempo mediante IncludeSnapshots.

Para obtener más información, vea Eliminar blob.

(Heredado de BlobBaseClient)
DeleteIfExistsAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

La DeleteIfExistsAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) operación marca el blob o la instantánea especificados para su eliminación, si el blob existe. El blob se elimina posteriormente durante la recolección de elementos no utilizados, lo que puede tardar varios minutos.

Tenga en cuenta que para eliminar un blob, debe eliminar todas sus instantáneas. Puede eliminar ambos al mismo tiempo mediante IncludeSnapshots.

Para obtener más información, vea Eliminar blob.

(Heredado de BlobBaseClient)
DeleteImmutabilityPolicy(CancellationToken)

Elimina la directiva de inmutabilidad asociada al blob. Tenga en cuenta que el control de versiones de blobs debe estar habilitado en la cuenta de almacenamiento y el blob debe estar en un contenedor con almacenamiento inmutable con control de versiones habilitado para llamar a esta API.

(Heredado de BlobBaseClient)
DeleteImmutabilityPolicyAsync(CancellationToken)

Elimina la directiva de inmutabilidad asociada al blob. Tenga en cuenta que el control de versiones de blobs debe estar habilitado en la cuenta de almacenamiento y el blob debe estar en un contenedor con almacenamiento inmutable con control de versiones habilitado para llamar a esta API.

(Heredado de BlobBaseClient)
DownloadContent()

La DownloadContent() operación descarga un blob del servicio, incluidos sus metadatos y propiedades.

Para obtener más información, vea Obtener blob.

(Heredado de BlobBaseClient)
DownloadContent(BlobDownloadOptions, CancellationToken)

La DownloadContent(BlobDownloadOptions, CancellationToken) operación descarga un blob del servicio, incluidos sus metadatos y propiedades.

Para obtener más información, vea Obtener blob.

(Heredado de BlobBaseClient)
DownloadContent(CancellationToken)

La DownloadContent(CancellationToken) operación descarga un blob del servicio, incluidos sus metadatos y propiedades.

Para obtener más información, vea Obtener blob.

(Heredado de BlobBaseClient)
DownloadContentAsync()

La DownloadContentAsync() operación descarga un blob del servicio, incluidos sus metadatos y propiedades.

Para obtener más información, vea Obtener blob.

(Heredado de BlobBaseClient)
DownloadContentAsync(BlobDownloadOptions, CancellationToken)

La DownloadContentAsync(BlobDownloadOptions, CancellationToken) operación descarga un blob del servicio, incluidos sus metadatos y propiedades.

Para obtener más información, vea Obtener blob.

(Heredado de BlobBaseClient)
DownloadContentAsync(CancellationToken)

La DownloadContentAsync(CancellationToken) operación descarga un blob del servicio, incluidos sus metadatos y propiedades.

Para obtener más información, vea Obtener blob.

(Heredado de BlobBaseClient)
DownloadStreaming(BlobDownloadOptions, CancellationToken)

La DownloadStreaming(BlobDownloadOptions, CancellationToken) operación descarga un blob del servicio, incluidos sus metadatos y propiedades.

Para obtener más información, vea Obtener blob.

(Heredado de BlobBaseClient)
DownloadStreamingAsync(BlobDownloadOptions, CancellationToken)

La DownloadStreamingAsync(BlobDownloadOptions, CancellationToken) operación descarga un blob del servicio, incluidos sus metadatos y propiedades.

Para obtener más información, vea Obtener blob.

(Heredado de BlobBaseClient)
DownloadTo(Stream)

La DownloadTo(Stream) operación descarga un blob mediante solicitudes paralelas y escribe el contenido en destination.

(Heredado de BlobBaseClient)
DownloadTo(Stream, BlobDownloadToOptions, CancellationToken)

La Azure.Storage.Blobs.Specialized.BlobBaseClient.DownloadTo(System.String,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken) operación descarga un blob mediante solicitudes paralelas y escribe el contenido options.Path.Path en o options.Stream.Stream.

(Heredado de BlobBaseClient)
DownloadTo(Stream, CancellationToken)

La DownloadTo(Stream, CancellationToken) operación descarga un blob mediante solicitudes paralelas y escribe el contenido en destination.

(Heredado de BlobBaseClient)
DownloadTo(String)

La DownloadTo(String) operación descarga un blob mediante solicitudes paralelas y escribe el contenido en path.

(Heredado de BlobBaseClient)
DownloadTo(String, BlobDownloadToOptions, CancellationToken)

La Azure.Storage.Blobs.Specialized.BlobBaseClient.DownloadTo(System.String,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken) operación descarga un blob mediante solicitudes paralelas y escribe el contenido options.Path.Path en o options.Stream.Stream.

(Heredado de BlobBaseClient)
DownloadTo(String, CancellationToken)

La DownloadTo(String, CancellationToken) operación descarga un blob mediante solicitudes paralelas y escribe el contenido en path.

(Heredado de BlobBaseClient)
DownloadToAsync(Stream)

DownloadToAsync(Stream) descarga un blob mediante solicitudes paralelas y escribe el contenido en destination.

(Heredado de BlobBaseClient)
DownloadToAsync(Stream, BlobDownloadToOptions, CancellationToken)

La Azure.Storage.Blobs.Specialized.BlobBaseClient.DownloadToAsync(System.IO.Stream,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken) operación descarga un blob mediante solicitudes paralelas y escribe el contenido options.Path.Path en o options.Stream.Stream.

(Heredado de BlobBaseClient)
DownloadToAsync(Stream, CancellationToken)

La DownloadToAsync(Stream, CancellationToken) operación descarga un blob mediante solicitudes paralelas y escribe el contenido en destination.

(Heredado de BlobBaseClient)
DownloadToAsync(String)

DownloadToAsync(String) descarga un blob mediante solicitudes paralelas y escribe el contenido en path.

(Heredado de BlobBaseClient)
DownloadToAsync(String, BlobDownloadToOptions, CancellationToken)

La Azure.Storage.Blobs.Specialized.BlobBaseClient.DownloadToAsync(System.IO.Stream,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken) operación descarga un blob mediante solicitudes paralelas y escribe el contenido options.Path.Path en o options.Stream.Stream.

(Heredado de BlobBaseClient)
DownloadToAsync(String, CancellationToken)

La DownloadToAsync(String, CancellationToken) operación descarga un blob mediante solicitudes paralelas y escribe el contenido en path.

(Heredado de BlobBaseClient)
Exists(CancellationToken)

Se Exists(CancellationToken) puede llamar a la operación en BlobBaseClient para ver si el blob asociado existe en el contenedor de la cuenta de almacenamiento en el servicio de almacenamiento.

(Heredado de BlobBaseClient)
ExistsAsync(CancellationToken)

Se ExistsAsync(CancellationToken) puede llamar a la operación en BlobBaseClient para ver si el blob asociado existe en el contenedor de la cuenta de almacenamiento en el servicio de almacenamiento.

(Heredado de BlobBaseClient)
GenerateSasUri(BlobSasBuilder)

GenerateSasUri(BlobSasBuilder) devuelve un Uri valor de tipo que genera un URI de firma de acceso compartido (SAS) de Blob Service basado en las propiedades y el generador del cliente. La SAS está firmada por la credencial de clave compartida del cliente.

Para comprobar si el cliente puede firmar una sas de servicio, consulte CanGenerateSasUri.

Para obtener más información, vea Construcción de una SAS de servicio.

(Heredado de BlobBaseClient)
GenerateSasUri(BlobSasPermissions, DateTimeOffset)

GenerateSasUri(BlobSasPermissions, DateTimeOffset) devuelve un Uri valor de tipo que genera un URI de firma de acceso compartido (SAS) de Blob Service basado en las propiedades y parámetros del cliente pasados. La SAS está firmada por la credencial de clave compartida del cliente.

Para comprobar si el cliente puede firmar una sas de servicio, consulte CanGenerateSasUri.

Para obtener más información, vea Construcción de una SAS de servicio.

(Heredado de BlobBaseClient)
GetBlobLeaseClientCore(String)

Inicializa una nueva instancia de la clase BlobLeaseClient.

(Heredado de BlobBaseClient)
GetBlockList(BlockListTypes, String, BlobRequestConditions, CancellationToken)

La GetBlockList(BlockListTypes, String, BlobRequestConditions, CancellationToken) operación de operación recupera la lista de bloques que se han cargado como parte de un blob en bloques. Hay dos listas de bloques mantenidas para un blob. La lista Bloques confirmados tiene bloques que se han confirmado correctamente en un blob determinado con CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken). La lista Bloque no confirmado tiene bloques que se han cargado para un blob mediante Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken), pero que aún no se han confirmado. Estos bloques se almacenan en Azure asociados a un blob, pero aún no forman parte de él.

GetBlockListAsync(BlockListTypes, String, BlobRequestConditions, CancellationToken)

La GetBlockListAsync(BlockListTypes, String, BlobRequestConditions, CancellationToken) operación de operación recupera la lista de bloques que se han cargado como parte de un blob en bloques. Hay dos listas de bloques mantenidas para un blob. La lista Bloques confirmados tiene bloques que se han confirmado correctamente en un blob determinado con CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken). La lista Bloque no confirmado tiene bloques que se han cargado para un blob mediante Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlockAsync(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken), pero que aún no se han confirmado. Estos bloques se almacenan en Azure asociados a un blob, pero aún no forman parte de él.

GetParentBlobContainerClientCore()

Cree un nuevo BlobContainerClient que apunte a este BlobBaseClientcontenedor primario. El nuevo BlockBlobClient usa la misma canalización de directiva de solicitud que .BlobBaseClient

(Heredado de BlobBaseClient)
GetProperties(BlobRequestConditions, CancellationToken)

La operación GetProperties(BlobRequestConditions, CancellationToken) devuelve todos los metadatos definidos por el usuario, las propiedades HTTP estándar y las propiedades del sistema para el blob. No devuelve el contenido de los blobs.

Para obtener más información, vea Obtiene las propiedades de blob.

(Heredado de BlobBaseClient)
GetPropertiesAsync(BlobRequestConditions, CancellationToken)

La operación GetPropertiesAsync(BlobRequestConditions, CancellationToken) devuelve todos los metadatos definidos por el usuario, las propiedades HTTP estándar y las propiedades del sistema para el blob. No devuelve el contenido de los blobs.

Para obtener más información, vea Obtiene las propiedades de blob.

(Heredado de BlobBaseClient)
GetTags(BlobRequestConditions, CancellationToken)

Obtiene las etiquetas asociadas al blob subyacente.

Para obtener más información, vea Obtención de etiquetas de blob

(Heredado de BlobBaseClient)
GetTagsAsync(BlobRequestConditions, CancellationToken)

Obtiene las etiquetas asociadas al blob subyacente.

Para obtener más información, vea Obtención de etiquetas de blob

(Heredado de BlobBaseClient)
OpenRead(BlobOpenReadOptions, CancellationToken)

Abre un flujo para leer del blob. La secuencia solo descargará el blob a medida que se lea la secuencia.

(Heredado de BlobBaseClient)
OpenReadAsync(BlobOpenReadOptions, CancellationToken)

Abre un flujo para leer del blob. La secuencia solo descargará el blob a medida que se lea la secuencia.

(Heredado de BlobBaseClient)
OpenWrite(Boolean, BlockBlobOpenWriteOptions, CancellationToken)

Abre un flujo para escribir en el blob.

OpenWriteAsync(Boolean, BlockBlobOpenWriteOptions, CancellationToken)

Abre un flujo para escribir en el blob. Si el blob existe, se sobrescribirá.

Query(String, BlobQueryOptions, CancellationToken)

La Query(String, BlobQueryOptions, CancellationToken) API devuelve el resultado de una consulta en el blob.

Para obtener más información, vea Consultar el contenido del blob.

QueryAsync(String, BlobQueryOptions, CancellationToken)

La QueryAsync(String, BlobQueryOptions, CancellationToken) API devuelve el resultado de una consulta en el blob.

Para obtener más información, vea Consultar el contenido del blob.

SetAccessTier(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken)

La SetAccessTier(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken) operación establece el nivel en un blob. La operación se permite en un blob en páginas en una cuenta de Premium Storage y en un blob en bloques en una cuenta de almacenamiento de blobs o de uso general v2.

El nivel de un blob en páginas Premium determina el tamaño, IOPS y ancho de banda permitidos del blob. El nivel de un blob en bloques determina el tipo de almacenamiento frecuente, esporádico o de archivo. Esta operación no actualiza la ETag del blob. Para obtener información detallada sobre los niveles de blob en bloques , niveles de Blob Storage.

Para obtener más información sobre cómo establecer el nivel, consulte Niveles de Blob Storage.

(Heredado de BlobBaseClient)
SetAccessTierAsync(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken)

La SetAccessTierAsync(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken) operación establece el nivel en un blob. La operación se permite en un blob en páginas en una cuenta de Premium Storage y en un blob en bloques en una cuenta de almacenamiento de blobs o de uso general v2.

El nivel de un blob en páginas Premium determina el tamaño, IOPS y ancho de banda permitidos del blob. El nivel de un blob en bloques determina el tipo de almacenamiento frecuente, esporádico o de archivo. Esta operación no actualiza la ETag del blob. Para obtener información detallada sobre los niveles de blob en bloques , niveles de Blob Storage.

Para obtener más información sobre cómo establecer el nivel, consulte Niveles de Blob Storage.

(Heredado de BlobBaseClient)
SetHttpHeaders(BlobHttpHeaders, BlobRequestConditions, CancellationToken)

La operación SetHttpHeaders(BlobHttpHeaders, BlobRequestConditions, CancellationToken) establece las propiedades del sistema en el blob.

Para obtener más información, vea Establecer propiedades de blob.

(Heredado de BlobBaseClient)
SetHttpHeadersAsync(BlobHttpHeaders, BlobRequestConditions, CancellationToken)

La operación SetHttpHeadersAsync(BlobHttpHeaders, BlobRequestConditions, CancellationToken) establece las propiedades del sistema en el blob.

Para obtener más información, vea Establecer propiedades de blob.

(Heredado de BlobBaseClient)
SetImmutabilityPolicy(BlobImmutabilityPolicy, BlobRequestConditions, CancellationToken)

Establece la directiva de inmutabilidad en un blob, una instantánea de blobs o una versión de blob. Tenga en cuenta que el control de versiones de blobs debe estar habilitado en la cuenta de almacenamiento y el blob debe estar en un contenedor con almacenamiento inmutable con control de versiones habilitado para llamar a esta API.

(Heredado de BlobBaseClient)
SetImmutabilityPolicyAsync(BlobImmutabilityPolicy, BlobRequestConditions, CancellationToken)

Establece la directiva de inmutabilidad en un blob, una instantánea de blobs o una versión de blob. Tenga en cuenta que el control de versiones de blobs debe estar habilitado en la cuenta de almacenamiento y el blob debe estar en un contenedor con almacenamiento inmutable con control de versiones habilitado para llamar a esta API.

(Heredado de BlobBaseClient)
SetLegalHold(Boolean, CancellationToken)

Establece una suspensión legal en el blob. Tenga en cuenta que el control de versiones de blobs debe estar habilitado en la cuenta de almacenamiento y el blob debe estar en un contenedor con almacenamiento inmutable con control de versiones habilitado para llamar a esta API.

(Heredado de BlobBaseClient)
SetLegalHoldAsync(Boolean, CancellationToken)

Establece una suspensión legal en el blob. Tenga en cuenta que el control de versiones de blobs debe estar habilitado en la cuenta de almacenamiento y el blob debe estar en un contenedor con almacenamiento inmutable con control de versiones habilitado para llamar a esta API.

(Heredado de BlobBaseClient)
SetMetadata(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

La operación SetMetadata(IDictionary<String,String>, BlobRequestConditions, CancellationToken) establece metadatos definidos por el usuario para el blob especificado como uno o varios pares nombre-valor.

Para obtener más información, vea Establecer metadatos de blob.

(Heredado de BlobBaseClient)
SetMetadataAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

La operación SetMetadataAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken) establece metadatos definidos por el usuario para el blob especificado como uno o varios pares nombre-valor.

Para obtener más información, vea Establecer metadatos de blob.

(Heredado de BlobBaseClient)
SetTags(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

Establece etiquetas en el blob subyacente. Un blob puede tener hasta 10 etiquetas. Las claves de etiqueta deben tener entre 1 y 128 caracteres. Los valores de etiqueta deben tener entre 0 y 256 caracteres. Los caracteres de clave y valor válidos incluyen letras minúsculas y mayúsculas, dígitos (0-9), espacio (' '), más ('+'), menos ('-'), punto ('.'), barra diagonal ('/'), dos puntos (':'), iguales ('=') y subrayado de subrayado ('_') .

Para obtener más información, vea Establecer etiquetas de blob.

(Heredado de BlobBaseClient)
SetTagsAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

Establece etiquetas en el blob subyacente. Un blob puede tener hasta 10 etiquetas. Las claves de etiqueta deben tener entre 1 y 128 caracteres. Los valores de etiqueta deben tener entre 0 y 256 caracteres. Los caracteres de clave y valor válidos incluyen letras minúsculas y mayúsculas, dígitos (0-9), espacio (' '), más ('+'), menos ('-'), punto ('.'), barra diagonal ('/'), dos puntos (':'), iguales ('=') y subrayado de subrayado ('_') .

Para obtener más información, vea Establecer etiquetas de blob.

(Heredado de BlobBaseClient)
StageBlock(String, Stream, BlockBlobStageBlockOptions, CancellationToken)

La StageBlock(String, Stream, BlockBlobStageBlockOptions, CancellationToken) operación crea un nuevo bloque como parte del "área de almacenamiento provisional" de un blob en bloques que finalmente se confirmará a través de la CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) operación.

Para obtener más información, vea Put Block.

StageBlockAsync(String, Stream, BlockBlobStageBlockOptions, CancellationToken)

La StageBlockAsync(String, Stream, BlockBlobStageBlockOptions, CancellationToken) operación crea un nuevo bloque como parte del "área de almacenamiento provisional" de un blob en bloques que finalmente se confirmará a través de la CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) operación.

Para obtener más información, vea Put Block.

StageBlockFromUri(Uri, String, StageBlockFromUriOptions, CancellationToken)

La StageBlockFromUri(Uri, String, StageBlockFromUriOptions, CancellationToken) operación crea un nuevo bloque que se confirmará como parte de un blob donde se lee el contenido de .sourceUri

Para obtener más información, vea Coloque Bloquear de la dirección URL.

StageBlockFromUriAsync(Uri, String, StageBlockFromUriOptions, CancellationToken)

La StageBlockFromUriAsync(Uri, String, StageBlockFromUriOptions, CancellationToken) operación crea un nuevo bloque que se confirmará como parte de un blob donde se lee el contenido de .sourceUri

Para obtener más información, vea Coloque Bloquear de la dirección URL.

StartCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken)

La StartCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken) operación inicia una copia asincrónica de los datos de source a este blob. Puede comprobar el Azure.Storage.Blobs.Models.BlobProperties.CopyStatus devuelto desde GetProperties(BlobRequestConditions, CancellationToken) para determinar si la copia se ha completado.

Para obtener más información, vea Copiar blob.

(Heredado de BlobBaseClient)
StartCopyFromUriAsync(Uri, BlobCopyFromUriOptions, CancellationToken)

La Azure.Storage.Blobs.Specialized.BlobBaseClient.StartCopyFromUri(System.Uri,System.Collections.Generic.IDictionary{System.String,System.String},System.Nullable{Azure.Storage.Blobs.Models.AccessTier},Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.Blobs.Models.BlobRequestConditions,System.Nullable{Azure.Storage.Blobs.Models.RehydratePriority},System.Threading.CancellationToken) operación inicia una copia asincrónica de los datos de source a este blob. Puede comprobar el Azure.Storage.Blobs.Models.BlobProperties.CopyStatus devuelto desde GetPropertiesAsync(BlobRequestConditions, CancellationToken) para determinar si la copia se ha completado.

Para obtener más información, vea Copiar blob.

(Heredado de BlobBaseClient)
SyncCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken)

La operación Copy Blob From URL copia un blob en un destino dentro de la cuenta de almacenamiento de forma sincrónica para tamaños de blob de origen de hasta 256 MiB. Esta API está disponible a partir de la versión 2018-03-28. El origen de una operación Copy Blob From URL puede ser cualquier blob en bloques confirmado en cualquier cuenta de Azure Storage que sea pública o autorizada con una firma de acceso compartido.

El tamaño del blob de origen puede ser una longitud máxima de hasta 256 MiB.

Para obtener más información, vea Copie blob desde la dirección URL.

(Heredado de BlobBaseClient)
SyncCopyFromUriAsync(Uri, BlobCopyFromUriOptions, CancellationToken)

La operación Copy Blob From URL copia un blob en un destino dentro de la cuenta de almacenamiento de forma sincrónica para tamaños de blob de origen de hasta 256 MiB. Esta API está disponible a partir de la versión 2018-03-28. El origen de una operación Copy Blob From URL puede ser cualquier blob en bloques confirmado en cualquier cuenta de Azure Storage que sea pública o autorizada con una firma de acceso compartido.

El tamaño del blob de origen puede ser una longitud máxima de hasta 256 MiB.

Para obtener más información, vea Copie blob desde la dirección URL.

(Heredado de BlobBaseClient)
SyncUploadFromUri(Uri, BlobSyncUploadFromUriOptions, CancellationToken)

La operación Cargar desde URI crea un nuevo blob en bloques donde el contenido del blob se lee desde una dirección URL determinada. Esta API se admite a partir de la versión 2020-04-08.

No se admiten actualizaciones parciales con Put Blob from URL; El contenido de un blob existente se sobrescribe con el contenido del nuevo blob. Para realizar actualizaciones parciales en el contenido de un blob en bloques mediante una dirección URL de origen, use la API Put Block from URL junto con Put Block List.

SyncUploadFromUri(Uri, Boolean, CancellationToken)

La operación Cargar desde URI crea un nuevo blob en bloques donde el contenido del blob se lee desde una dirección URL determinada. Esta API se admite a partir de la versión 2020-04-08.

No se admiten actualizaciones parciales con Put Blob from URL; El contenido de un blob existente se sobrescribe con el contenido del nuevo blob. Para realizar actualizaciones parciales en el contenido de un blob en bloques mediante una dirección URL de origen, use la API Put Block from URL junto con Put Block List.

SyncUploadFromUriAsync(Uri, BlobSyncUploadFromUriOptions, CancellationToken)

La operación Cargar desde URI crea un nuevo blob en bloques donde el contenido del blob se lee desde una dirección URL determinada. Esta API se admite a partir de la versión 2020-04-08.

No se admiten actualizaciones parciales con Put Blob from URL; El contenido de un blob existente se sobrescribe con el contenido del nuevo blob. Para realizar actualizaciones parciales en el contenido de un blob en bloques mediante una dirección URL de origen, use la API Put Block from URL junto con Put Block List.

SyncUploadFromUriAsync(Uri, Boolean, CancellationToken)

La operación Cargar desde URI crea un nuevo blob en bloques donde el contenido del blob se lee desde una dirección URL determinada. Esta API se admite a partir de la versión 2020-04-08.

No se admiten actualizaciones parciales con Put Blob from URL; El contenido de un blob existente se sobrescribe con el contenido del nuevo blob. Para realizar actualizaciones parciales en el contenido de un blob en bloques mediante una dirección URL de origen, use la API Put Block from URL junto con Put Block List.

Undelete(CancellationToken)

La Undelete(CancellationToken) operación restaura el contenido y los metadatos de un blob eliminado temporalmente y las instantáneas de eliminación temporal asociadas.

Para obtener más información, vea Recuperar blob.

(Heredado de BlobBaseClient)
UndeleteAsync(CancellationToken)

La UndeleteAsync(CancellationToken) operación restaura el contenido y los metadatos de un blob eliminado temporalmente y las instantáneas de eliminación temporal asociadas.

Para obtener más información, vea Recuperar blob.

(Heredado de BlobBaseClient)
Upload(Stream, BlobUploadOptions, CancellationToken)

La Upload(Stream, BlobUploadOptions, CancellationToken) operación sobrescribe el contenido del blob, creando un nuevo blob en bloques si no existe ninguno. Al sobrescribir un blob en bloques existente, se reemplazan los metadatos existentes en el blob.

Establezca las condiciones de acceso a través Conditions de para evitar sobrescribir los datos existentes.

Las actualizaciones parciales no se admiten con Upload(Stream, BlobUploadOptions, CancellationToken); el contenido del blob existente se sobrescribe con el contenido del nuevo. Para realizar una actualización parcial del contenido de un blob en bloques, use las Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) operaciones y CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken) .

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

UploadAsync(Stream, BlobUploadOptions, CancellationToken)

La UploadAsync(Stream, BlobUploadOptions, CancellationToken) operación sobrescribe el contenido del blob, creando un nuevo blob en bloques si no existe ninguno. Al sobrescribir un blob en bloques existente, se reemplazan los metadatos existentes en el blob.

Establezca las condiciones de acceso a través Conditions de para evitar sobrescribir los datos existentes.

Las actualizaciones parciales no se admiten con UploadAsync(Stream, BlobUploadOptions, CancellationToken); el contenido del blob existente se sobrescribe con el contenido del nuevo. Para realizar una actualización parcial del contenido de un blob en bloques, use las Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) operaciones y CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) .

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

WithCustomerProvidedKey(Nullable<CustomerProvidedKey>)

Inicializa una nueva instancia de la BlockBlobClient clase con un origen idéntico Uri , pero el especificado customerProvidedKey.

WithEncryptionScope(String)

Inicializa una nueva instancia de la BlockBlobClient clase con un origen idéntico Uri , pero el especificado encryptionScope.

WithSnapshot(String)

Inicializa una nueva instancia de la BlockBlobClient clase con un origen idéntico Uri , pero la marca de tiempo especificada snapshot .

Para obtener más información, vea Cree una instantánea de un blob.

WithSnapshotCore(String)

Crea una nueva instancia de la BlockBlobClient clase con un origen idéntico Uri , pero la marca de tiempo especificada snapshot .

WithVersion(String)

Inicializa una nueva instancia de la BlockBlobClient clase con un origen idéntico Uri , pero la marca de tiempo especificada versionId .

Métodos de extensión

GetBlobLeaseClient(BlobBaseClient, String)

Inicializa una nueva instancia de la clase BlobLeaseClient.

GetParentBlobContainerClient(BlobBaseClient)

Cree un nuevo BlobContainerClient que apunte a este BlobBaseClientcontenedor primario. El nuevo BlockBlobClient usa la misma canalización de directiva de solicitud que .BlobBaseClient

Se aplica a