IPWorks Cloud 2020 iOS Edition

Questions / Feedback?

listPageRanges (method)

Lists the page ranges of a page blob.

Syntax

- (void)listPageRanges:(NSString*)pageBlob;
public func listPageRanges(_ pageBlob: String) throws -> Void

Remarks

This method lists the allocated page ranges of the specified PageBlob in the container currently selected by Container. If Snapshot is non-empty, the allocated page ranges for the specified snapshot of PageBlob are listed instead.

The Range property can be used to restrict the results to only the page ranges within the specified range.

Calling this method will repopulate the PageRange* properties. Every page in a page blob is exactly 512 bytes in length; thus, the size of every range returned by this method will always be a multiple of 512.

Normally, ranges of pages that are not currently allocated (either because no data has been written to them, or because they've been cleared with ClearPages) will not be returned by this method. However, setting the PreviousSnapshot configuration setting to a non-empty value will cause the server to return a list of all pages that differ between that snapshot and the base PageBlob (or the later snapshot of PageBlob specified by Snapshot); refer to PreviousSnapshot for more information.

If the specified blob has an active lease, a lease Id may optionally be specified using LeaseId; the request will only succeed if the correct lease Id is specified.

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks Cloud 2020 iOS Edition - Version 20.0 [Build 8265]