add_block Method
Adds a block to the Blocks properties.
Syntax
def add_block(id: str, block_list_type: int) -> None: ...
Remarks
This method adds a block to the Block* properties. Id specifies the block's Id, and BlockListType specifies where the server should search for this block.
Block Ids must be Base64-encoded when sent to the server. By default, the class will automatically Base64-encode block Ids as they are sent, and Base64-decode them as they are received. This behavior can be configured using the EncodeBlockIds configuration setting.
All block Ids must be less than or equal to 64 bytes in length before being Base64-encoded. Additionally, all blocks Ids within a single block blob must be unique, and of the exact same length after Base64-encoding.
Valid values for BlockListType are:
Value | Meaning During put_block_list Operations |
abktCommitted (0) | Search for a committed block with the specified Id. |
abktUncommitted (1) | Search for an uncommitted block with the specified Id. |
abktLatest (2) | Search for an uncommitted block with the specified Id; and then, if one isn't found, search for a committed block. |