PageBlobClient.StartCopyIncremental Método
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.
A StartCopyIncremental(Uri, String, PageBlobRequestConditions, CancellationToken) operação começa a copiar um instantâneo do blob de páginas sourceUri para esse blob de páginas. O instantâneo é copiado de modo que apenas as alterações diferenciais entre as instantâneo copiadas anteriormente sejam transferidas para o destino. Os instantâneos copiados são cópias completas do instantâneo original e podem ser lidos ou copiados de como de costume. 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 Blob de Cópia Incremental e Faça backup de discos de VM não gerenciados do Azure com instantâneos incrementais.
public virtual Azure.Storage.Blobs.Models.CopyFromUriOperation StartCopyIncremental (Uri sourceUri, string snapshot, Azure.Storage.Blobs.Models.PageBlobRequestConditions conditions = default, System.Threading.CancellationToken cancellationToken = default);abstract member StartCopyIncremental : Uri * string * Azure.Storage.Blobs.Models.PageBlobRequestConditions * System.Threading.CancellationToken -> Azure.Storage.Blobs.Models.CopyFromUriOperation
override this.StartCopyIncremental : Uri * string * Azure.Storage.Blobs.Models.PageBlobRequestConditions * System.Threading.CancellationToken -> Azure.Storage.Blobs.Models.CopyFromUriOperationPublic Overridable Function StartCopyIncremental (sourceUri As Uri, snapshot As String, Optional conditions As PageBlobRequestConditions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As CopyFromUriOperationParâmetros
- sourceUri
- Uri
Especifica o para o blob de página de origem como um Uri comprimento de até 2 KB. O blob de origem deve ser público ou deve ser autenticado por meio de uma assinatura de acesso compartilhado.
- snapshot
- String
O nome de um instantâneo para começar a copiar de sourceUri.
- conditions
- PageBlobRequestConditions
Opcional PageBlobRequestConditions para adicionar condições na cópia incremental a esse blob de páginas.
- cancellationToken
- CancellationToken
Opcional CancellationToken para propagar notificações de que a operação deve ser cancelada.
Retornos
Um CopyFromUriOperation que faz referência à operação de cópia incremental.
Comentários
Um RequestFailedException será gerado se ocorrer uma falha.
O destino de uma cópia incremental não deve existir ou deve ter sido criado com uma cópia incremental anterior do mesmo blob de origem. Depois de criado, o blob de destino é permanentemente associado à origem e só pode ser usado para cópias incrementais.
As GetProperties(BlobRequestConditions, CancellationToken)operações , GetBlobs(BlobTraits, BlobStates, String, CancellationToken)e GetBlobsByHierarchy(BlobTraits, BlobStates, String, String, CancellationToken) indicam se o blob é um blob de cópia incremental criado dessa maneira. Blobs de cópia incremental podem não ser baixados diretamente. As únicas operações com suporte são GetProperties(BlobRequestConditions, CancellationToken), StartCopyIncremental(Uri, String, PageBlobRequestConditions, CancellationToken)e Delete(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken). Os instantâneos copiados podem ser lidos e excluídos como de costume.
Uma cópia incremental é executada de forma assíncrona no serviço e deve ser sondada para conclusão. Você pode sondar GetProperties(BlobRequestConditions, CancellationToken) e marcar Azure.Storage.Blobs.Models.BlobProperties.CopyStatus para determinar quando a cópia foi concluída. Quando a cópia for concluída, o blob de destino conterá um novo instantâneo. A GetProperties(BlobRequestConditions, CancellationToken) operação retorna a instantâneo hora do instantâneo recém-criado.
Na primeira vez que uma cópia incremental é executada em um blob de destino, um novo blob é criado com um instantâneo totalmente copiado da origem. Cada chamada subsequente para StartCopyIncremental(Uri, String, PageBlobRequestConditions, CancellationToken) criará um novo instantâneo copiando apenas as alterações diferenciais do instantâneo copiado anteriormente. As alterações diferenciais são computadas no servidor emitindo uma GetAllPageRanges(GetPageRangesOptions, CancellationToken) chamada no blob de origem instantâneo com prevSnapshot definido como o instantâneo copiado mais recentemente. Portanto, as mesmas restrições em GetAllPageRanges(GetPageRangesOptions, CancellationToken) se aplicam a StartCopyIncremental(Uri, String, PageBlobRequestConditions, CancellationToken). Especificamente, os instantâneos devem ser copiados em ordem crescente e, se o blob de origem for recriado usando Azure.Storage.Blobs.Specialized.PageBlobClient.UploadPages(System.IO.Stream,System.Int64,System.Byte[],Azure.Storage.Blobs.Models.PageBlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) ou 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)StartCopyIncremental(Uri, String, PageBlobRequestConditions, CancellationToken) em novos instantâneos, falhará.
O espaço de armazenamento adicional consumido pelo instantâneo copiado é o tamanho dos dados diferenciais transferidos durante a cópia. Isso pode ser determinado executando uma GetAllPageRangesDiff(GetPageRangesDiffOptions, CancellationToken) chamada no instantâneo para compará-la com o instantâneo anterior.
Aplica-se a
Azure SDK for .NET