BlockBlobURL Class

Definition

Represents a URL to a block blob. It may be obtained by direct construction or via the create method on a ContainerURL object. This class does not hold any state about a particular blob but is instead a convenient way of sending off appropriate requests to the resource on the service. Please refer to the Azure Docs for more information on block blobs.

public class BlockBlobURL extends BlobURL
Inheritance
java.lang.Object
BlockBlobURL

Inherited Members

Constructors

BlockBlobURL(URL url, HttpPipeline pipeline)

Creates aBlockBlobURL 

</code> object pointing to the account specified by the URL and using the provided pipeline to make HTTP requests.</p>

Fields

MAX_BLOCKS

Indicates the maximum number of blocks allowed in a block blob.

MAX_STAGE_BLOCK_BYTES

Indicates the maximum number of bytes that can be sent in a call to stageBlock.

MAX_UPLOAD_BLOB_BYTES

Indicates the maximum number of bytes that can be sent in a call to upload.

Methods

commitBlockList(List<String> base64BlockIDs, BlobHTTPHeaders headers, Metadata metadata, BlobAccessConditions accessConditions, Context context)

Writes a blob by specifying the list of block IDs that are to make up the blob. In order to be written as part of a blob, a block must have been successfully written to the server in a prior stageBlock operation. You can call commitBlockList to update a blob by uploading only those blocks that have changed, then committing the new and existing blocks together. Any blocks not specified in the block list and permanently deleted. For more information, see the Azure Docs.

For more efficient bulk-upload scenarios, please refer to the TransferManager for convenience methods.

getBlockList(BlockListType listType, LeaseAccessConditions leaseAccessConditions, Context context)

Returns the list of blocks that have been uploaded as part of a block blob using the specified block list filter. For more information, see the Azure Docs.

stageBlock(String base64BlockID, Flowable<ByteBuffer> data, long length, LeaseAccessConditions leaseAccessConditions, Context context)

Uploads the specified block to the block blob's "staging area" to be later committed by a call to commitBlockList. For more information, see the Azure Docs.

Note that the data passed must be replayable if retries are enabled (the default). In other words, the Flowable 

</code> must produce the same data each time it is subscribed to.</p>

stageBlockFromURL(String base64BlockID, URL sourceURL, BlobRange sourceRange, byte[] sourceContentMD5, LeaseAccessConditions leaseAccessConditions, Context context)

Creates a new block to be committed as part of a blob where the contents are read from a URL. For more information, see the Azure Docs.

upload(Flowable<ByteBuffer> data, long length, BlobHTTPHeaders headers, Metadata metadata, BlobAccessConditions accessConditions, Context context)

Creates a new block blob, or updates the content of an existing block blob. Updating an existing block blob overwrites any existing metadata on the blob. Partial updates are not supported with PutBlob; the content of the existing blob is overwritten with the new content. To perform a partial update of a block blob's, use PutBlock and PutBlockList. For more information, see the Azure Docs.

Note that the data passed must be replayable if retries are enabled (the default). In other words, the Flowable 

</code> must produce the same data each time it is subscribed to.</p>

For more efficient bulk-upload scenarios, please refer to the TransferManager for convenience methods.

withPipeline(HttpPipeline pipeline)

Creates a new BlockBlobURL with the given pipeline.

withSnapshot(String snapshot)

Creates a new BlockBlobURL with the given snapshot.

Applies to