CreateBlock Method

Creates a new block to be committed as part of a block blob.

Object Oriented Interface

public function doCreateBlock($blobname, $blockid);

Procedural Interface

inazure_blob_do_createblock($res, $blobname, $blockid);

Remarks

This method will create a new block to be committed as part of the blob specified by blobName. By default, blockId will be Base64 encoded by the component. Thus you will not need to encode the blockId values yourself. EncodeBlockId can be set to false, to turn off the automatic encoding (thus all encoding/decoding must be handled manually). Prior to encoding, the blockId must be less than or equal to 64 bytes in size. Note for a given blob, all block IDs must be the same length.

After a block has been created, it will not be committed as part of the blob content until PutBlockList is called.

Note the maximum number of uncommitted blocks that may be associated with a blob is 100,000, and the maximum size of the uncommitted block list is 400 GB.

Any uncommitted blocks will be garbage collected if there are no successful calls to CreateBlock or PutBlockList on the blob within a week following the last successful CreateBlock call. If CreateBlob is called on the blob, any uncommitted blocks will be garbage collected.

If the blob has an active lease, LeaseId must be specified prior to calling CreateBlock.