PageBlobClient.GetManagedDiskPageRangesDiffAsync Method

Definition

Namespace:

Azure.Storage.Blobs.Specialized

Assembly:

Azure.Storage.Blobs.dll

Package:

Azure.Storage.Blobs v12.23.0

Source:

PageBlobClient.cs

The GetManagedDiskPageRangesDiffAsync(Nullable<HttpRange>, String, Uri, PageBlobRequestConditions, CancellationToken) operation returns the list of page ranges that differ between a previousSnapshotUri and this page blob. Changed pages include both updated and cleared pages. This API only works with managed disk storage accounts.

For more information, see Get Page Ranges.

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.PageRangesInfo>> GetManagedDiskPageRangesDiffAsync (Azure.HttpRange? range = default, string snapshot = default, Uri previousSnapshotUri = default, Azure.Storage.Blobs.Models.PageBlobRequestConditions conditions = default, System.Threading.CancellationToken cancellationToken = default);

abstract member GetManagedDiskPageRangesDiffAsync : Nullable<Azure.HttpRange> * string * Uri * Azure.Storage.Blobs.Models.PageBlobRequestConditions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.PageRangesInfo>>
override this.GetManagedDiskPageRangesDiffAsync : Nullable<Azure.HttpRange> * string * Uri * Azure.Storage.Blobs.Models.PageBlobRequestConditions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.PageRangesInfo>>

Public Overridable Function GetManagedDiskPageRangesDiffAsync (Optional range As Nullable(Of HttpRange) = Nothing, Optional snapshot As String = Nothing, Optional previousSnapshotUri As Uri = Nothing, Optional conditions As PageBlobRequestConditions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of PageRangesInfo))

Parameters

range

Nullable<HttpRange>

Optionally specifies the range of bytes over which to list ranges, inclusively. If omitted, then all ranges for the blob are returned.

snapshot

String

Optionally specifies the blob snapshot to retrieve page ranges information from. For more information on working with blob snapshots, Create a snapshot of a blob.

previousSnapshotUri

Uri

This parameter only works with managed disk storage accounts. Specifies that the response will contain only pages that were changed between target blob and previous snapshot. Changed pages include both updated and cleared pages. The target blob may be a snapshot, as long as the snapshot specified by previousSnapshotUri is the older of the two.

conditions

PageBlobRequestConditions

Optional PageBlobRequestConditions to add conditions on getting page ranges for the this blob.

cancellationToken

CancellationToken

Optional CancellationToken to propagate notifications that the operation should be cancelled.

Returns

Task<Response<PageRangesInfo>>

A Response<T> describing the valid page ranges for this blob.

Remarks

A RequestFailedException will be thrown if a failure occurs.