Compartir a través de


BlobBaseClient Clase

Definición

BlobBaseClient permite manipular los blobs de Azure Storage.

public class BlobBaseClient
type BlobBaseClient = class
Public Class BlobBaseClient
Herencia
BlobBaseClient
Derivado

Constructores

BlobBaseClient()

Inicializa una nueva instancia de la clase BlobBaseClient.

BlobBaseClient(String, String, String)

Inicializa una nueva instancia de la clase BlobBaseClient.

BlobBaseClient(String, String, String, BlobClientOptions)

Inicializa una nueva instancia de la clase BlobBaseClient.

BlobBaseClient(Uri, AzureSasCredential, BlobClientOptions)

Inicializa una nueva instancia de la clase BlobBaseClient.

BlobBaseClient(Uri, BlobClientOptions)

Inicializa una nueva instancia de la clase BlobBaseClient.

BlobBaseClient(Uri, StorageSharedKeyCredential, BlobClientOptions)

Inicializa una nueva instancia de la clase BlobBaseClient.

BlobBaseClient(Uri, TokenCredential, BlobClientOptions)

Inicializa una nueva instancia de la clase BlobBaseClient.

Propiedades

AccountName

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

BlobContainerName

Obtiene el nombre del contenedor correspondiente al cliente de blobs.

CanGenerateSasUri

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

Name

Obtiene el nombre del blob.

Uri

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

Métodos

AbortCopyFromUri(String, BlobRequestConditions, CancellationToken)

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

Para obtener más información, vea Anule la opción Copy Blob (Copiar blob).

AbortCopyFromUriAsync(String, BlobRequestConditions, CancellationToken)

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

Para obtener más información, vea Anule la opción Copy Blob (Copiar blob).

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.

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.

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 más adelante 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 Elimine el blob.

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 más adelante 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 Elimine el blob.

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 más adelante 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 Elimine el blob.

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 más adelante 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 Elimine el blob.

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.

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.

DownloadContent()

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

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

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.

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.

DownloadContentAsync()

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

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

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.

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.

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.

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.

DownloadTo(Stream)

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

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.

DownloadTo(Stream, CancellationToken)

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

DownloadTo(String)

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

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.

DownloadTo(String, CancellationToken)

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

DownloadToAsync(Stream)

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

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.

DownloadToAsync(Stream, CancellationToken)

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

DownloadToAsync(String)

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

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.

DownloadToAsync(String, CancellationToken)

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

Exists(CancellationToken)

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

ExistsAsync(CancellationToken)

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

GenerateSasUri(BlobSasBuilder)

GenerateSasUri(BlobSasBuilder) devuelve un Uri 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.

GenerateSasUri(BlobSasPermissions, DateTimeOffset)

GenerateSasUri(BlobSasPermissions, DateTimeOffset) devuelve un Uri objeto 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.

GetBlobLeaseClientCore(String)

Inicializa una nueva instancia de la clase BlobLeaseClient.

GetCopyAuthorizationHeaderAsync(BlobBaseClient, CancellationToken)

Obtenga un BlobBaseClientHttpAuthorization para pasar la autorización al realizar la copia del servicio al servicio donde OAuth es necesario para autenticar el origen.

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

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 del blob.

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 del blob.

GetTags(BlobRequestConditions, CancellationToken)

Obtiene las etiquetas asociadas al blob subyacente.

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

GetTagsAsync(BlobRequestConditions, CancellationToken)

Obtiene las etiquetas asociadas al blob subyacente.

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

OpenRead(BlobOpenReadOptions, CancellationToken)

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

OpenReadAsync(BlobOpenReadOptions, CancellationToken)

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

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 de 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 permitido, las IOPS y el ancho de banda del blob. El nivel de un blob en bloques determina el tipo de almacenamiento de acceso frecuente, esporádico o de archivo. Esta operación no actualiza la etiqueta 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 Almacenamiento de blobs.

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 de 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 permitido, las IOPS y el ancho de banda del blob. El nivel de un blob en bloques determina el tipo de almacenamiento de acceso frecuente, esporádico o de archivo. Esta operación no actualiza la etiqueta 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 Almacenamiento de blobs.

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.

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.

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.

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.

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.

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.

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.

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.

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 bajo ('_') .

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

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 bajo ('_') .

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

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.

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.

SyncCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken)

La operación Copy Blob From URL copia un blob en un destino dentro de la cuenta de almacenamiento sincrónicamente 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 el blob de la dirección URL.

SyncCopyFromUriAsync(Uri, BlobCopyFromUriOptions, CancellationToken)

La operación Copy Blob From URL copia un blob en un destino dentro de la cuenta de almacenamiento sincrónicamente 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 Almacenamiento de Azure 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.

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.

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.

WithCustomerProvidedKey(Nullable<CustomerProvidedKey>)

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

WithEncryptionScope(String)

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

WithSnapshot(String)

Inicializa una nueva instancia de la BlobBaseClient 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 BlobBaseClient clase con un origen idéntico Uri , pero la marca de tiempo especificada snapshot .

WithVersion(String)

Inicializa una nueva instancia de la BlobBaseClient 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