Partilhar via


BlobBaseClient Classe

Definição

O BlobBaseClient permite manipular os blobs do Armazenamento do Azure.

public class BlobBaseClient
type BlobBaseClient = class
Public Class BlobBaseClient
Herança
BlobBaseClient
Derivado

Construtores

BlobBaseClient()

Inicializa uma nova instância da classe BlobBaseClient.

BlobBaseClient(String, String, String)

Inicializa uma nova instância da classe BlobBaseClient.

BlobBaseClient(String, String, String, BlobClientOptions)

Inicializa uma nova instância da classe BlobBaseClient.

BlobBaseClient(Uri, AzureSasCredential, BlobClientOptions)

Inicializa uma nova instância da classe BlobBaseClient.

BlobBaseClient(Uri, BlobClientOptions)

Inicializa uma nova instância da classe BlobBaseClient.

BlobBaseClient(Uri, StorageSharedKeyCredential, BlobClientOptions)

Inicializa uma nova instância da classe BlobBaseClient.

BlobBaseClient(Uri, TokenCredential, BlobClientOptions)

Inicializa uma nova instância da classe BlobBaseClient.

Propriedades

AccountName

Obtém o nome da conta de armazenamento correspondente ao cliente de blob.

BlobContainerName

Obtém o nome do contêiner correspondente ao cliente de blob.

CanGenerateSasUri

Determina se o cliente é capaz de gerar uma SAS. Se o cliente for autenticado com um StorageSharedKeyCredential.

Name

Obtém o nome do blob.

Uri

Obtém o ponto de extremidade primário Uri do blob.

Métodos

AbortCopyFromUri(String, BlobRequestConditions, CancellationToken)

A AbortCopyFromUri(String, BlobRequestConditions, CancellationToken) operação anula um pendente CopyFromUriOperatione deixa um blob com comprimento zero e metadados completos.

Para obter mais informações, consulte Anular Copiar Blob.

AbortCopyFromUriAsync(String, BlobRequestConditions, CancellationToken)

A AbortCopyFromUriAsync(String, BlobRequestConditions, CancellationToken) operação anula um pendente CopyFromUriOperatione deixa um blob com comprimento zero e metadados completos.

Para obter mais informações, consulte Anular Copiar Blob.

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

A operação CreateSnapshot(IDictionary<String,String>, BlobRequestConditions, CancellationToken) cria um instantâneo somente leitura de um blob.

Para obter mais informações, consulte Blob de instantâneos.

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

A operação CreateSnapshotAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken) cria um instantâneo somente leitura de um blob.

Para obter mais informações, consulte Blob de instantâneos.

Delete(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

A operação Delete(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) marca o blob ou o instantâneo especificado para exclusão. O blob é excluído posteriormente durante a coleta de lixo, o que pode levar vários minutos.

Observe que para excluir um blob, você deve excluir todos os seus instantâneos. Você pode excluir ambos ao mesmo tempo usando IncludeSnapshots.

Para obter mais informações, consulte Excluir Blob.

DeleteAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

A operação DeleteAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) marca o blob ou o instantâneo especificado para exclusão. O blob é excluído posteriormente durante a coleta de lixo, o que pode levar vários minutos.

Observe que para excluir um blob, você deve excluir todos os seus instantâneos. Você pode excluir ambos ao mesmo tempo usando IncludeSnapshots.

Para obter mais informações, consulte Excluir Blob.

DeleteIfExists(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

A DeleteIfExists(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) operação marca o blob ou o instantâneo especificado para exclusão, se o blob existir. O blob é excluído posteriormente durante a coleta de lixo, o que pode levar vários minutos.

Observe que para excluir um blob, você deve excluir todos os seus instantâneos. Você pode excluir ambos ao mesmo tempo usando IncludeSnapshots.

Para obter mais informações, consulte Excluir Blob.

DeleteIfExistsAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

A DeleteIfExistsAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) operação marca o blob ou o instantâneo especificado para exclusão, se o blob existir. O blob é excluído posteriormente durante a coleta de lixo, o que pode levar vários minutos.

Observe que para excluir um blob, você deve excluir todos os seus instantâneos. Você pode excluir ambos ao mesmo tempo usando IncludeSnapshots.

Para obter mais informações, consulte Excluir Blob.

DeleteImmutabilityPolicy(CancellationToken)

Exclui a Política de Imutabilidade associada ao Blob. Observe que o Controle de Versão de Blobs deve estar habilitado em sua conta de armazenamento e o blob deve estar em um contêiner com armazenamento imutável com controle de versão habilitado para chamar essa API.

DeleteImmutabilityPolicyAsync(CancellationToken)

Exclui a Política de Imutabilidade associada ao Blob. Observe que o Controle de Versão de Blobs deve estar habilitado em sua conta de armazenamento e o blob deve estar em um contêiner com armazenamento imutável com controle de versão habilitado para chamar essa API.

DownloadContent()

A DownloadContent() operação baixa um blob do serviço, incluindo seus metadados e propriedades.

Para obter mais informações, consulte Obter Blob.

DownloadContent(BlobDownloadOptions, CancellationToken)

A DownloadContent(BlobDownloadOptions, CancellationToken) operação baixa um blob do serviço, incluindo seus metadados e propriedades.

Para obter mais informações, consulte Obter Blob.

DownloadContent(CancellationToken)

A DownloadContent(CancellationToken) operação baixa um blob do serviço, incluindo seus metadados e propriedades.

Para obter mais informações, consulte Obter Blob.

DownloadContentAsync()

A DownloadContentAsync() operação baixa um blob do serviço, incluindo seus metadados e propriedades.

Para obter mais informações, consulte Obter Blob.

DownloadContentAsync(BlobDownloadOptions, CancellationToken)

A DownloadContentAsync(BlobDownloadOptions, CancellationToken) operação baixa um blob do serviço, incluindo seus metadados e propriedades.

Para obter mais informações, consulte Obter Blob.

DownloadContentAsync(CancellationToken)

A DownloadContentAsync(CancellationToken) operação baixa um blob do serviço, incluindo seus metadados e propriedades.

Para obter mais informações, consulte Obter Blob.

DownloadStreaming(BlobDownloadOptions, CancellationToken)

A DownloadStreaming(BlobDownloadOptions, CancellationToken) operação baixa um blob do serviço, incluindo seus metadados e propriedades.

Para obter mais informações, consulte Obter Blob.

DownloadStreamingAsync(BlobDownloadOptions, CancellationToken)

A DownloadStreamingAsync(BlobDownloadOptions, CancellationToken) operação baixa um blob do serviço, incluindo seus metadados e propriedades.

Para obter mais informações, consulte Obter Blob.

DownloadTo(Stream)

A DownloadTo(Stream) operação baixa um blob usando solicitações paralelas e grava o conteúdo destinationem .

DownloadTo(Stream, BlobDownloadToOptions, CancellationToken)

A Azure.Storage.Blobs.Specialized.BlobBaseClient.DownloadTo(System.String,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken) operação baixa um blob usando solicitações paralelas e grava o conteúdo options.Path.Path em ou options.Stream.Stream.

DownloadTo(Stream, CancellationToken)

A DownloadTo(Stream, CancellationToken) operação baixa um blob usando solicitações paralelas e grava o conteúdo destinationem .

DownloadTo(String)

A DownloadTo(String) operação baixa um blob usando solicitações paralelas e grava o conteúdo pathem .

DownloadTo(String, BlobDownloadToOptions, CancellationToken)

A Azure.Storage.Blobs.Specialized.BlobBaseClient.DownloadTo(System.String,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken) operação baixa um blob usando solicitações paralelas e grava o conteúdo options.Path.Path em ou options.Stream.Stream.

DownloadTo(String, CancellationToken)

A DownloadTo(String, CancellationToken) operação baixa um blob usando solicitações paralelas e grava o conteúdo pathem .

DownloadToAsync(Stream)

O DownloadToAsync(Stream) baixa um blob usando solicitações paralelas e grava o conteúdo destinationem .

DownloadToAsync(Stream, BlobDownloadToOptions, CancellationToken)

A Azure.Storage.Blobs.Specialized.BlobBaseClient.DownloadToAsync(System.IO.Stream,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken) operação baixa um blob usando solicitações paralelas e grava o conteúdo options.Path.Path em ou options.Stream.Stream.

DownloadToAsync(Stream, CancellationToken)

A DownloadToAsync(Stream, CancellationToken) operação baixa um blob usando solicitações paralelas e grava o conteúdo destinationem .

DownloadToAsync(String)

O DownloadToAsync(String) baixa um blob usando solicitações paralelas e grava o conteúdo pathem .

DownloadToAsync(String, BlobDownloadToOptions, CancellationToken)

A Azure.Storage.Blobs.Specialized.BlobBaseClient.DownloadToAsync(System.IO.Stream,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken) operação baixa um blob usando solicitações paralelas e grava o conteúdo options.Path.Path em ou options.Stream.Stream.

DownloadToAsync(String, CancellationToken)

A DownloadToAsync(String, CancellationToken) operação baixa um blob usando solicitações paralelas e grava o conteúdo pathem .

Exists(CancellationToken)

A Exists(CancellationToken) operação pode ser chamada em um BlobBaseClient para ver se o blob associado existe no contêiner na conta de armazenamento no serviço de armazenamento.

ExistsAsync(CancellationToken)

A ExistsAsync(CancellationToken) operação pode ser chamada em um BlobBaseClient para ver se o blob associado existe no contêiner na conta de armazenamento no serviço de armazenamento.

GenerateSasUri(BlobSasBuilder)

O GenerateSasUri(BlobSasBuilder) retorna um Uri que gera um Uri de SAS (Assinatura de Acesso Compartilhado) do Serviço blob com base nas propriedades do cliente e no construtor. A SAS é assinada pela credencial de chave compartilhada do cliente.

Para marcar se o cliente puder assinar uma Sas de Serviço, consulte CanGenerateSasUri.

Para obter mais informações, consulte Construindo uma SAS de serviço.

GenerateSasUri(BlobSasPermissions, DateTimeOffset)

O GenerateSasUri(BlobSasPermissions, DateTimeOffset) retorna um Uri que gera um Uri de SAS (Assinatura de Acesso Compartilhado) do Serviço blob com base nas propriedades e parâmetros do cliente passados. A SAS é assinada pela credencial de chave compartilhada do cliente.

Para marcar se o cliente puder assinar uma Sas de Serviço, consulte CanGenerateSasUri.

Para obter mais informações, consulte Construindo uma SAS de serviço.

GetBlobLeaseClientCore(String)

Inicializa uma nova instância da classe BlobLeaseClient.

GetCopyAuthorizationHeaderAsync(BlobBaseClient, CancellationToken)

Obtenha um BlobBaseClientpara HttpAuthorization passar a autorização ao executar o serviço para a cópia de serviço em que o OAuth é necessário para autenticar a origem.

GetParentBlobContainerClientCore()

Crie um novo BlobContainerClient que aponte para o contêiner pai deste BlobBaseClient. O novo BlockBlobClient usa o mesmo pipeline de política de solicitação que o BlobBaseClient.

GetProperties(BlobRequestConditions, CancellationToken)

A operação GetProperties(BlobRequestConditions, CancellationToken) retorna todos os metadados definidos pelo usuário, propriedades HTTP padrão e propriedades do sistema para o blob. Ela não retorna o conteúdo do blob.

Para obter mais informações, consulte Obter propriedades de blob.

GetPropertiesAsync(BlobRequestConditions, CancellationToken)

A operação GetPropertiesAsync(BlobRequestConditions, CancellationToken) retorna todos os metadados definidos pelo usuário, propriedades HTTP padrão e propriedades do sistema para o blob. Ela não retorna o conteúdo do blob.

Para obter mais informações, consulte Obter propriedades de blob.

GetTags(BlobRequestConditions, CancellationToken)

Obtém as marcas associadas ao blob subjacente.

Para obter mais informações, consulte Obter marcas de blob

GetTagsAsync(BlobRequestConditions, CancellationToken)

Obtém as marcas associadas ao blob subjacente.

Para obter mais informações, consulte Obter marcas de blob

OpenRead(BlobOpenReadOptions, CancellationToken)

Abre um fluxo para ler do blob. O fluxo só baixará o blob à medida que o fluxo for lido.

OpenReadAsync(BlobOpenReadOptions, CancellationToken)

Abre um fluxo para ler do blob. O fluxo só baixará o blob à medida que o fluxo for lido.

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

A SetAccessTier(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken) operação define a camada em um blob. A operação é permitida em um blob de páginas em uma conta de armazenamento premium e em um blob de blocos em uma conta de armazenamento de blobs ou de uso geral v2.

A camada de um blob de página premium determina o tamanho, o IOPS e a largura de banda permitidos do blob. A camada de um blob de blocos determina o tipo de armazenamento Hot/Cool/Archive. Essa operação não atualiza a ETag do blob. Para obter informações detalhadas sobre camadas de armazenamento de blobs em nível de blob de blocos.

Para obter mais informações sobre como definir a camada, consulte Camadas de Armazenamento de Blobs.

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

A SetAccessTierAsync(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken) operação define a camada em um blob. A operação é permitida em um blob de páginas em uma conta de armazenamento premium e em um blob de blocos em uma conta de armazenamento de blobs ou de uso geral v2.

A camada de um blob de página premium determina o tamanho, o IOPS e a largura de banda permitidos do blob. A camada de um blob de blocos determina o tipo de armazenamento Hot/Cool/Archive. Essa operação não atualiza a ETag do blob. Para obter informações detalhadas sobre camadas de armazenamento de blobs em nível de blob de blocos.

Para obter mais informações sobre como definir a camada, consulte Camadas de Armazenamento de Blobs.

SetHttpHeaders(BlobHttpHeaders, BlobRequestConditions, CancellationToken)

A operação SetHttpHeaders(BlobHttpHeaders, BlobRequestConditions, CancellationToken) define as propriedades do sistema no blob.

Para obter mais informações, consulte Definir propriedades de blob.

SetHttpHeadersAsync(BlobHttpHeaders, BlobRequestConditions, CancellationToken)

A operação SetHttpHeadersAsync(BlobHttpHeaders, BlobRequestConditions, CancellationToken) define as propriedades do sistema no blob.

Para obter mais informações, consulte Definir propriedades de blob.

SetImmutabilityPolicy(BlobImmutabilityPolicy, BlobRequestConditions, CancellationToken)

Define a Política de Imutabilidade em um Blob, Instantâneo de Blob ou Versão do Blob. Observe que o Controle de Versão de Blobs deve ser habilitado em sua conta de armazenamento e o blob deve estar em um Contêiner com armazenamento imutável com controle de versão habilitado para chamar essa API.

SetImmutabilityPolicyAsync(BlobImmutabilityPolicy, BlobRequestConditions, CancellationToken)

Define a Política de Imutabilidade em um Blob, Instantâneo de Blob ou Versão do Blob. Observe que o Controle de Versão de Blobs deve ser habilitado em sua conta de armazenamento e o blob deve estar em um Contêiner com armazenamento imutável com controle de versão habilitado para chamar essa API.

SetLegalHold(Boolean, CancellationToken)

Define uma retenção legal no blob. Observe que o Controle de Versão de Blobs deve ser habilitado em sua conta de armazenamento e o blob deve estar em um Contêiner com armazenamento imutável com controle de versão habilitado para chamar essa API.

SetLegalHoldAsync(Boolean, CancellationToken)

Define uma retenção legal no blob. Observe que o Controle de Versão de Blobs deve ser habilitado em sua conta de armazenamento e o blob deve estar em um Contêiner com armazenamento imutável com controle de versão habilitado para chamar essa API.

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

A operação SetMetadata(IDictionary<String,String>, BlobRequestConditions, CancellationToken) estabelece metadados definidos pelo usuário para o blob especificado como um ou mais pares de nome-valor.

Para obter mais informações, consulte Definir Metadados de Blob.

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

A operação SetMetadataAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken) estabelece metadados definidos pelo usuário para o blob especificado como um ou mais pares de nome-valor.

Para obter mais informações, consulte Definir Metadados de Blob.

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

Define marcas no blob subjacente. Um blob pode ter até 10 marcas. As teclas de marca devem ter entre 1 e 128 caracteres. Os valores de marca devem estar entre 0 e 256 caracteres. Os caracteres válidos de chave de marca e valor incluem letras maiúsculas e minúsculas, dígitos (0-9), espaço (' '), mais ('+'), menos ('-'), ponto ('.'), barra ('/'), dois-pontos (':'), igual a ('=') e sublinhado ('_') .

Para obter mais informações, consulte Definir Marcas de Blob.

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

Define marcas no blob subjacente. Um blob pode ter até 10 marcas. As teclas de marca devem ter entre 1 e 128 caracteres. Os valores de marca devem estar entre 0 e 256 caracteres. Os caracteres válidos de chave de marca e valor incluem letras maiúsculas e minúsculas, dígitos (0-9), espaço (' '), mais ('+'), menos ('-'), ponto ('.'), barra ('/'), dois-pontos (':'), igual a ('=') e sublinhado ('_') .

Para obter mais informações, consulte Definir Marcas de Blob.

StartCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken)

A StartCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken) operação inicia uma cópia assíncrona dos dados do source para esse blob. Você pode marcar o Azure.Storage.Blobs.Models.BlobProperties.CopyStatus retornado do GetProperties(BlobRequestConditions, CancellationToken) para determinar se a cópia foi concluída.

Para obter mais informações, consulte Copiar Blob.

StartCopyFromUriAsync(Uri, BlobCopyFromUriOptions, CancellationToken)

A 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) operação inicia uma cópia assíncrona dos dados do source para esse blob. Você pode marcar o Azure.Storage.Blobs.Models.BlobProperties.CopyStatus retornado do GetPropertiesAsync(BlobRequestConditions, CancellationToken) para determinar se a cópia foi concluída.

Para obter mais informações, consulte Copiar Blob.

SyncCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken)

A operação Copiar Blob da URL copia um blob para um destino dentro da conta de armazenamento de forma síncrona para tamanhos de blob de origem de até 256 MiB. Essa API está disponível a partir da versão 2018-03-28. A origem de uma operação copiar blob da URL pode ser qualquer blob de bloco confirmado em qualquer conta de armazenamento do Azure que seja pública ou autorizada com uma assinatura de acesso compartilhado.

O tamanho do blob de origem pode ter um comprimento máximo de até 256 MiB.

Para obter mais informações, consulte Copiar Blob da URL.

SyncCopyFromUriAsync(Uri, BlobCopyFromUriOptions, CancellationToken)

A operação Copiar Blob da URL copia um blob para um destino dentro da conta de armazenamento de forma síncrona para tamanhos de blob de origem de até 256 MiB. Essa API está disponível a partir da versão 2018-03-28. A origem de uma operação copiar blob da URL pode ser qualquer blob de blocos confirmado em qualquer conta de armazenamento do Azure que seja pública ou autorizada com uma assinatura de acesso compartilhado.

O tamanho do blob de origem pode ter um comprimento máximo de até 256 MiB.

Para obter mais informações, consulte Copiar Blob da URL.

Undelete(CancellationToken)

A Undelete(CancellationToken) operação restaura o conteúdo e os metadados de um blob com exclusão reversível e todos os instantâneos excluídos temporariamente associados.

Para obter mais informações, consulte Cancelar a exclusão do Blob.

UndeleteAsync(CancellationToken)

A UndeleteAsync(CancellationToken) operação restaura o conteúdo e os metadados de um blob com exclusão reversível e todos os instantâneos excluídos temporariamente associados.

Para obter mais informações, consulte Cancelar a exclusão do Blob.

WithCustomerProvidedKey(Nullable<CustomerProvidedKey>)

Inicializa uma nova instância da BlobBaseClient classe com uma origem idêntica Uri , mas o especificado customerProvidedKey.

WithEncryptionScope(String)

Inicializa uma nova instância da BlobBaseClient classe com uma origem idêntica Uri , mas o especificado encryptionScope.

WithSnapshot(String)

Inicializa uma nova instância da BlobBaseClient classe com uma origem idêntica Uri , mas o carimbo de data/hora especificado snapshot .

Para obter mais informações, consulte Crie uma instantâneo de um blob.

WithSnapshotCore(String)

Cria uma nova instância da BlobBaseClient classe com uma origem idêntica Uri , mas o carimbo de data/hora especificado snapshot .

WithVersion(String)

Inicializa uma nova instância da BlobBaseClient classe com uma origem idêntica Uri , mas o carimbo de data/hora especificado versionId .

Métodos de Extensão

GetBlobLeaseClient(BlobBaseClient, String)

Inicializa uma nova instância da classe BlobLeaseClient.

GetParentBlobContainerClient(BlobBaseClient)

Crie um novo BlobContainerClient que aponte para o contêiner pai desse BlobBaseClient. O novo BlockBlobClient usa o mesmo pipeline de política de solicitação que o BlobBaseClient.

Aplica-se a