BlockBlobClient Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
O BlockBlobClient permite manipular blobs de blocos do Armazenamento do Azure.
Os blobs de bloco permitem atualizar blobs grandes eficientemente. Os blobs de bloco são compostos de blocos, e cada um deles é identificado por uma ID de bloco. Crie ou modifique um blob de bloco gravando um conjunto de blocos e confirmando-os pelas suas IDs de bloco. Cada bloco pode ter um tamanho diferente, até um máximo de 4.000 MB (100 MB para solicitações que usam versões REST antes de 2019-12-12 e 4 MB para solicitações que usam versões REST antes de 2016-05-31), e um blob de blocos pode incluir até 50.000 blocos. O tamanho máximo de um blob de blocos é, portanto, aproximadamente 190,73 TiB (4.000 MB X 50.000 blocos). Se você estiver escrevendo um blob de blocos que não tenha mais de 5.000 MB de tamanho, poderá carregá-lo em sua totalidade com uma única operação de gravação; consulte UploadAsync(Stream, BlobUploadOptions, CancellationToken).
Ao carregar um bloco em um blob na sua conta de armazenamento, ele é associado ao blob de bloco especificado, mas não se torna parte do blob até que você confirme uma lista de blocos que inclua a nova ID do bloco. Os novos blocos permanecem em um estado não confirmado até que sejam especificamente confirmados ou descartados. A gravação de um bloco não atualiza a hora em que um blob existente foi modificado pela última vez.
Os blobs de bloco incluem recursos que ajudam a gerenciar arquivos grandes pelas redes. Com um blob de bloco, é possível carregar vários blocos paralelamente para diminuir o tempo de carregamento. Cada bloco pode incluir um hash MD5 para verificar a transferência, para que você possa acompanhar o progresso do upload e reenançar blocos conforme necessário. Você pode carregar blocos em qualquer ordem e determinar sua sequência na etapa final de compromisso da lista de blocos. Também é possível carregar um novo bloco para substituir um bloco não confirmado existente da mesma ID de bloco. Você tem uma semana para confirmar blocos em um blob antes de eles serem descartados. Todos os blocos não confirmados também são descartados quando uma operação de confirmação da lista de blocos ocorre, mas não os inclui.
Você pode modificar um blob de bloco existente inserindo, substituindo ou excluindo blocos existentes. Após carregar os blocos que foram alterados, é possível confirmar uma nova versão do blob ao confirmar os novos blocos com os blocos existentes que deseja manter usando uma única operação de confirmação. Para inserir o mesmo intervalo de bytes em dois locais diferentes do blob confirmado, você pode confirmar o mesmo bloco em dois locais dentro da mesma operação de confirmação. Para qualquer operação de confirmação, se qualquer bloco não for encontrado, toda a operação de compromisso falhará com um erro e o blob não será modificado. Qualquer confirmação de bloco substitui as propriedades e os metadados existentes do blob, além de descartar todos os blocos não confirmados.
As IDs de bloco são cadeias de caracteres de comprimento igual em um blob. O código de cliente do bloco geralmente usa a codificação de base 64 para padronizar cadeias de caracteres em tamanhos iguais. Ao usar a codificação de base 64, a cadeia de caracteres pré-codificada deve ter 64 bytes ou menos. Os valores da ID de bloco podem ser duplicados em blobs diferentes. Um blob pode ter até 100.000 blocos não confirmados, com um tamanho total máximo de aproximadamente 381,46 TiB (4.000 MB x 100.000 blocos)
Se você gravar um bloco para um blob que não existe, um novo blob de bloco será criado, com um comprimento de zero bytes. Esse blob aparecerá em listas de blobs que incluem blobs não confirmados. Se você não confirmar nenhum bloco para esse blob, ele e seus blocos não confirmados serão descartados uma semana após o último carregamento bem-sucedido do bloco. Todos os blocos não confirmados também são descartados quando um novo blob de mesmo nome é criado usando uma única etapa (em vez do processo de upload e confirmação de bloco de duas etapas).
public class BlockBlobClient : Azure.Storage.Blobs.Specialized.BlobBaseClienttype BlockBlobClient = class
inherit BlobBaseClientPublic Class BlockBlobClient
Inherits BlobBaseClient- Herança
Construtores
| BlockBlobClient() |
Inicializa uma nova instância da BlockBlobClient classe para zombar. |
| BlockBlobClient(String, String, String) |
Inicializa uma nova instância da classe BlockBlobClient. |
| BlockBlobClient(String, String, String, BlobClientOptions) |
Inicializa uma nova instância da classe BlockBlobClient. |
| BlockBlobClient(Uri, AzureSasCredential, BlobClientOptions) |
Inicializa uma nova instância da classe BlockBlobClient. |
| BlockBlobClient(Uri, BlobClientOptions) |
Inicializa uma nova instância da classe BlockBlobClient. |
| BlockBlobClient(Uri, StorageSharedKeyCredential, BlobClientOptions) |
Inicializa uma nova instância da classe BlockBlobClient. |
| BlockBlobClient(Uri, TokenCredential, BlobClientOptions) |
Inicializa uma nova instância da classe BlockBlobClient. |
Propriedades
| AccountName |
Obtém o nome da conta de armazenamento correspondente ao cliente blob. (Herdado de BlobBaseClient) |
| BlobContainerName |
Obtém o nome do contêiner correspondente ao cliente blob. (Herdado de BlobBaseClient) |
| BlockBlobMaxBlocks |
Obtém o número máximo de blocos permitidos em um blob de blocos. |
| BlockBlobMaxStageBlockLongBytes |
Obtém o número máximo de bytes que podem ser enviados em uma chamada para 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 |
Obtém o número máximo de bytes que podem ser enviados em uma chamada para UploadAsync(Stream, BlobUploadOptions, CancellationToken). |
| CanGenerateSasUri |
Determina se o cliente é capaz de gerar uma SAS. Se o cliente for autenticado com um StorageSharedKeyCredential. (Herdado de BlobBaseClient) |
| Name |
Obtém o nome do blob. (Herdado de BlobBaseClient) |
| Uri |
Obtém o ponto de extremidade primário Uri do blob. (Herdado de BlobBaseClient) |
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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken) |
A operação CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken) grava um blob especificando a lista de IDs de bloco que constituem o blob. Para ser gravado como parte de um blob, um bloco deve ter sido gravado com êxito no servidor em uma operação 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. Você pode chamar CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken) para atualizar um blob carregando apenas os blocos que foram alterados e depois confirmando os blocos novos e existentes em conjunto. Para fazer isso, especifique se um bloco deve ser confirmado da lista de blocos confirmados ou da lista de blocos não confirmados, ou confirme a versão mais recente carregada do bloco, independentemente da lista à qual ele pertença. Todos os blocos não especificados na lista de blocos e excluídos permanentemente. Para obter mais informações, consulte Colocar Lista de Blocos. |
| CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) |
A operação CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) grava um blob especificando a lista de IDs de bloco que constituem o blob. Para ser gravado como parte de um blob, um bloco deve ter sido gravado com êxito no servidor em uma operação 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. Você pode chamar CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) para atualizar um blob carregando apenas os blocos que foram alterados e depois confirmando os blocos novos e existentes em conjunto. Para fazer isso, especifique se um bloco deve ser confirmado da lista de blocos confirmados ou da lista de blocos não confirmados, ou confirme a versão mais recente carregada do bloco, independentemente da lista à qual ele pertença. Todos os blocos não especificados na lista de blocos e excluídos permanentemente. Para obter mais informações, consulte Colocar Lista de Blocos. |
| CreateClient(Uri, BlobClientOptions, HttpPipeline) |
Inicializa uma nova instância da classe BlockBlobClient. |
| 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âneo. (Herdado de BlobBaseClient) |
| 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âneo. (Herdado de BlobBaseClient) |
| Delete(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) |
A operação Delete(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) marca o blob ou o instantâneo especificado para exclusão. O blob é posteriormente excluído 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. (Herdado de BlobBaseClient) |
| DeleteAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) |
A operação DeleteAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) marca o blob ou o instantâneo especificado para exclusão. O blob é posteriormente excluído 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. (Herdado de BlobBaseClient) |
| 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 é posteriormente excluído 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. (Herdado de BlobBaseClient) |
| 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 é posteriormente excluído 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. (Herdado de BlobBaseClient) |
| DeleteImmutabilityPolicy(CancellationToken) |
Exclui a Política de Imutabilidade associada ao 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. (Herdado de BlobBaseClient) |
| DeleteImmutabilityPolicyAsync(CancellationToken) |
Exclui a Política de Imutabilidade associada ao 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. (Herdado de BlobBaseClient) |
| DownloadContent() |
A DownloadContent() operação baixa um blob do serviço, incluindo seus metadados e propriedades. Para obter mais informações, consulte Obter Blob. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| DownloadContentAsync() |
A DownloadContentAsync() operação baixa um blob do serviço, incluindo seus metadados e propriedades. Para obter mais informações, consulte Obter Blob. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| DownloadTo(Stream) |
A DownloadTo(Stream) operação baixa um blob usando solicitações paralelas e grava o conteúdo |
| 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 |
| DownloadTo(Stream, CancellationToken) |
A DownloadTo(Stream, CancellationToken) operação baixa um blob usando solicitações paralelas e grava o conteúdo |
| DownloadTo(String) |
A DownloadTo(String) operação baixa um blob usando solicitações paralelas e grava o conteúdo |
| 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 |
| DownloadTo(String, CancellationToken) |
A DownloadTo(String, CancellationToken) operação baixa um blob usando solicitações paralelas e grava o conteúdo |
| DownloadToAsync(Stream) |
O DownloadToAsync(Stream) baixa um blob usando solicitações paralelas e grava o conteúdo |
| 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 |
| DownloadToAsync(Stream, CancellationToken) |
A DownloadToAsync(Stream, CancellationToken) operação baixa um blob usando solicitações paralelas e grava o conteúdo |
| DownloadToAsync(String) |
O DownloadToAsync(String) baixa um blob usando solicitações paralelas e grava o conteúdo |
| 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 |
| DownloadToAsync(String, CancellationToken) |
A DownloadToAsync(String, CancellationToken) operação baixa um blob usando solicitações paralelas e grava o conteúdo |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| GetBlobLeaseClientCore(String) |
Inicializa uma nova instância da classe BlobLeaseClient. (Herdado de BlobBaseClient) |
| GetBlockList(BlockListTypes, String, BlobRequestConditions, CancellationToken) |
A GetBlockList(BlockListTypes, String, BlobRequestConditions, CancellationToken) operação recupera a lista de blocos que foram carregados como parte de um blob de blocos. Há duas listas de blocos mantidas para um blob. A lista Bloco Confirmado tem blocos que foram confirmados com êxito em um determinado blob com CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken). A lista Bloco Não Confirmado tem blocos que foram carregados para um blob usando 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), mas que ainda não foram confirmados. Esses blocos são armazenados no Azure em associação com um blob, mas ainda não fazem parte do blob. |
| GetBlockListAsync(BlockListTypes, String, BlobRequestConditions, CancellationToken) |
A GetBlockListAsync(BlockListTypes, String, BlobRequestConditions, CancellationToken) operação recupera a lista de blocos que foram carregados como parte de um blob de blocos. Há duas listas de blocos mantidas para um blob. A lista Bloco Confirmado tem blocos que foram confirmados com êxito em um determinado blob com CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken). A lista Bloco Não Confirmado tem blocos que foram carregados para um blob usando 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), mas que ainda não foram confirmados. Esses blocos são armazenados no Azure em associação com um blob, mas ainda não fazem parte do blob. |
| 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. (Herdado de 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| GetTags(BlobRequestConditions, CancellationToken) |
Obtém as marcas associadas ao blob subjacente. Para obter mais informações, consulte Obter marcas de blob (Herdado de BlobBaseClient) |
| GetTagsAsync(BlobRequestConditions, CancellationToken) |
Obtém as marcas associadas ao blob subjacente. Para obter mais informações, consulte Obter marcas de blob (Herdado de BlobBaseClient) |
| OpenRead(BlobOpenReadOptions, CancellationToken) |
Abre um fluxo para ler do blob. O fluxo só baixará o blob à medida que o fluxo for lido. (Herdado de BlobBaseClient) |
| OpenReadAsync(BlobOpenReadOptions, CancellationToken) |
Abre um fluxo para ler do blob. O fluxo só baixará o blob à medida que o fluxo for lido. (Herdado de BlobBaseClient) |
| OpenWrite(Boolean, BlockBlobOpenWriteOptions, CancellationToken) |
Abre um fluxo para gravação no blob. |
| OpenWriteAsync(Boolean, BlockBlobOpenWriteOptions, CancellationToken) |
Abre um fluxo para gravação no blob. Se o blob existir, ele será substituído. |
| Query(String, BlobQueryOptions, CancellationToken) |
A Query(String, BlobQueryOptions, CancellationToken) API retorna o resultado de uma consulta no blob. Para obter mais informações, consulte Consultar Conteúdo do Blob. |
| QueryAsync(String, BlobQueryOptions, CancellationToken) |
A QueryAsync(String, BlobQueryOptions, CancellationToken) API retorna o resultado de uma consulta no blob. Para obter mais informações, consulte Consultar Conteúdo do Blob. |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| StageBlock(String, Stream, BlockBlobStageBlockOptions, CancellationToken) |
A StageBlock(String, Stream, BlockBlobStageBlockOptions, CancellationToken) operação cria um novo bloco como parte da "área de preparo" de um blob de blocos a ser eventualmente confirmada por meio da CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) operação. Para obter mais informações, consulte Coloque Bloquear. |
| StageBlockAsync(String, Stream, BlockBlobStageBlockOptions, CancellationToken) |
A StageBlockAsync(String, Stream, BlockBlobStageBlockOptions, CancellationToken) operação cria um novo bloco como parte da "área de preparo" de um blob de blocos a ser eventualmente confirmada por meio da CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) operação. Para obter mais informações, consulte Coloque Bloquear. |
| StageBlockFromUri(Uri, String, StageBlockFromUriOptions, CancellationToken) |
A StageBlockFromUri(Uri, String, StageBlockFromUriOptions, CancellationToken) operação cria um novo bloco a ser confirmado como parte de um blob em que o conteúdo é lido do Para obter mais informações, consulte Colocar Bloquear da URL. |
| StageBlockFromUriAsync(Uri, String, StageBlockFromUriOptions, CancellationToken) |
A StageBlockFromUriAsync(Uri, String, StageBlockFromUriOptions, CancellationToken) operação cria um novo bloco a ser confirmado como parte de um blob em que o conteúdo é lido do Para obter mais informações, consulte Colocar Bloquear da URL. |
| StartCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken) |
A StartCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken) operação inicia uma cópia assíncrona dos dados do Para obter mais informações, consulte Copiar Blob. (Herdado de BlobBaseClient) |
| 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 Para obter mais informações, consulte Copiar Blob. (Herdado de BlobBaseClient) |
| 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. (Herdado de BlobBaseClient) |
| 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 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. (Herdado de BlobBaseClient) |
| SyncUploadFromUri(Uri, BlobSyncUploadFromUriOptions, CancellationToken) |
A operação Carregar do URI cria um novo Blob de Blocos em que o conteúdo do blob é lido de uma determinada URL. Essa API tem suporte a partir da versão 2020-04-08. Não há suporte para atualizações parciais com Put Blob da URL; o conteúdo de um blob existente é substituído pelo conteúdo do novo blob. Para executar atualizações parciais no conteúdo de um blob de blocos usando uma URL de origem, use a API Put Block from URL em conjunto com Put Block List. |
| SyncUploadFromUri(Uri, Boolean, CancellationToken) |
A operação Carregar do URI cria um novo Blob de Blocos em que o conteúdo do blob é lido de uma determinada URL. Essa API tem suporte a partir da versão 2020-04-08. Não há suporte para atualizações parciais com Put Blob da URL; o conteúdo de um blob existente é substituído pelo conteúdo do novo blob. Para executar atualizações parciais no conteúdo de um blob de blocos usando uma URL de origem, use a API Put Block from URL em conjunto com Put Block List. |
| SyncUploadFromUriAsync(Uri, BlobSyncUploadFromUriOptions, CancellationToken) |
A operação Carregar do URI cria um novo Blob de Blocos em que o conteúdo do blob é lido de uma determinada URL. Essa API tem suporte a partir da versão 2020-04-08. Não há suporte para atualizações parciais com Put Blob da URL; o conteúdo de um blob existente é substituído pelo conteúdo do novo blob. Para executar atualizações parciais no conteúdo de um blob de blocos usando uma URL de origem, use a API Put Block from URL em conjunto com Put Block List. |
| SyncUploadFromUriAsync(Uri, Boolean, CancellationToken) |
A operação Carregar do URI cria um novo Blob de Blocos em que o conteúdo do blob é lido de uma determinada URL. Essa API tem suporte a partir da versão 2020-04-08. Não há suporte para atualizações parciais com Put Blob da URL; o conteúdo de um blob existente é substituído pelo conteúdo do novo blob. Para executar atualizações parciais no conteúdo de um blob de blocos usando uma URL de origem, use a API Put Block from URL em conjunto com Put Block List. |
| Undelete(CancellationToken) |
A Undelete(CancellationToken) operação restaura o conteúdo e os metadados de um blob excluído temporariamente e de todos os instantâneos excluídos reversível associados. Para obter mais informações, consulte Desdelete Blob. (Herdado de BlobBaseClient) |
| UndeleteAsync(CancellationToken) |
A UndeleteAsync(CancellationToken) operação restaura o conteúdo e os metadados de um blob excluído temporariamente e de todos os instantâneos excluídos reversível associados. Para obter mais informações, consulte Desdelete Blob. (Herdado de BlobBaseClient) |
| Upload(Stream, BlobUploadOptions, CancellationToken) |
A Upload(Stream, BlobUploadOptions, CancellationToken) operação substitui o conteúdo do blob, criando um novo blob de blocos se nenhum existir. Substituir um blob de blocos existente substitui todos os metadados existentes no blob. Defina as condições de acesso por meio Conditions de para evitar a substituição de dados existentes. As atualizações parciais não têm suporte em Upload(Stream, BlobUploadOptions, CancellationToken); o conteúdo de blob existente é substituído pelo conteúdo no novo blob. Para executar uma atualização parcial do conteúdo de um blob de blocos, use as 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) operações e CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken) . Para obter mais informações, consulte Coloque Blob. |
| UploadAsync(Stream, BlobUploadOptions, CancellationToken) |
A UploadAsync(Stream, BlobUploadOptions, CancellationToken) operação substitui o conteúdo do blob, criando um novo blob de blocos se nenhum existir. Substituir um blob de blocos existente substitui todos os metadados existentes no blob. Defina as condições de acesso por meio Conditions de para evitar a substituição de dados existentes. As atualizações parciais não têm suporte em UploadAsync(Stream, BlobUploadOptions, CancellationToken); o conteúdo de blob existente é substituído pelo conteúdo no novo blob. Para executar uma atualização parcial do conteúdo de um blob de blocos, use as 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) operações e CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) . Para obter mais informações, consulte Coloque Blob. |
| WithCustomerProvidedKey(Nullable<CustomerProvidedKey>) |
Inicializa uma nova instância da BlockBlobClient classe com uma origem idêntica Uri , mas o especificado |
| WithEncryptionScope(String) |
Inicializa uma nova instância da BlockBlobClient classe com uma origem idêntica Uri , mas o especificado |
| WithSnapshot(String) |
Inicializa uma nova instância da BlockBlobClient classe com uma origem idêntica Uri , mas o carimbo de data/hora especificado Para obter mais informações, consulte Crie uma instantâneo de um blob. |
| WithSnapshotCore(String) |
Cria uma nova instância da BlockBlobClient classe com uma origem idêntica Uri , mas o carimbo de data/hora especificado |
| WithVersion(String) |
Inicializa uma nova instância da BlockBlobClient classe com uma origem idêntica Uri , mas o carimbo de data/hora especificado |
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
Azure SDK for .NET