put_pages Method

Uploads a range of pages to a page blob.

Syntax

def put_pages(page_blob: str, write_offset: int) -> None: ...

Remarks

This method uploads a range of pages to the specified PageBlob in the container currently selected by container, starting at the byte offset specified by WriteOffset. The uploaded data is immediately available as part of the page blob, which must already exist.

The upload data's size, in bytes, must be a multiple of 512 no larger than 4MB (4194304 bytes). The value passed for WriteOffset must also be a multiple of 512; WriteOffset % == 0.

Note that writing a page full of zeros will not actually clear said page, so it will still incur data storage charges. It is recommended that applications avoid writing pages that only contain zeros, or clear such pages using the clear_pages method.

If the specified blob has an active lease, its lease Id must be specified using lease_id, or the request will fail.