PageBlobClient.UploadPagesFromUriAsync Method

Reference

Definition

Namespace:: Azure.Storage.Blobs.Specialized

Assembly:: Azure.Storage.Blobs.dll

Package:: Azure.Storage.Blobs v12.22.2

Package:: Azure.Storage.Blobs v12.23.0-beta.2

Source:: PageBlobClient.cs

Source:: PageBlobClient.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

The UploadPagesFromUriAsync(Uri, HttpRange, HttpRange, PageBlobUploadPagesFromUriOptions, CancellationToken) operation writes a range of pages to a page blob where the contents are read from sourceUri.

For more information, see Put Page From URL.

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.PageInfo>> UploadPagesFromUriAsync (Uri sourceUri, Azure.HttpRange sourceRange, Azure.HttpRange range, Azure.Storage.Blobs.Models.PageBlobUploadPagesFromUriOptions options = default, System.Threading.CancellationToken cancellationToken = default);

abstract member UploadPagesFromUriAsync : Uri * Azure.HttpRange * Azure.HttpRange * Azure.Storage.Blobs.Models.PageBlobUploadPagesFromUriOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.PageInfo>>
override this.UploadPagesFromUriAsync : Uri * Azure.HttpRange * Azure.HttpRange * Azure.Storage.Blobs.Models.PageBlobUploadPagesFromUriOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.PageInfo>>

Public Overridable Function UploadPagesFromUriAsync (sourceUri As Uri, sourceRange As HttpRange, range As HttpRange, Optional options As PageBlobUploadPagesFromUriOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of PageInfo))

Parameters

sourceUri: Uri

Specifies the Uri of the source blob. The value may be a Uri of up to 2 KB in length that specifies a blob. The source blob must either be public or must be authenticated via a shared access signature. If the source blob is public, no authentication is required to perform the operation.

sourceRange: HttpRange

Optionally only upload the bytes of the blob in the sourceUri in the specified range.

range: HttpRange

Specifies the range to be written as a page. Both the start and end of the range must be specified and can be up to 4MB in size. Given that pages must be aligned with 512-byte boundaries, the start of the range must be a modulus of 512 and the end of the range must be a modulus of 512 – 1. Examples of valid byte ranges are 0-511, 512-1023, etc.