UpdatePageBlob Method
Updates a page blob's size and/or sequence number.
Syntax
azureblob.updatePageBlob(pageBlob, newSize, sequenceNumAction, newSequenceNum, [callback])
Callback
The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).
The callback for this method is defined as:
function(err){ }
'err' is the error that occurred. If there was no error, then 'err' is 'null'.
'err' has 2 properties which hold detailed information:
err.code err.message
Remarks
This method updates the size and/or sequence number of the specified PageBlob in the container currently selected by Container.
NewSize must either be -1 (to keep the page blob's current size), or a multiple of 512; i.e. NewSize % 512 == 0. If NewSize is less than the page blob's current size, all pages above the specified value are cleared.
SequenceNumAction determines how the page blob's sequence number should be changed; possible values are:
None (0) | The page blob's sequence number remains unchanged. NewSequenceNum is ignored. |
Increment (1) | The page blob's sequence number is incremented by 1. NewSequenceNum is ignored. |
Update (2) | The page blob's sequence number is set to NewSequenceNum. |
Use Greater (3) | The page blob's sequence number is set to the greater of NewSequenceNum and the current sequence number. |
In cases where NewSequenceNum is used, it must be a value in the range 0 to 2^63 - 1, inclusive.
If the specified blob has an active lease, its lease Id must be specified using LeaseId, or the request will fail.