public final class PageBlobURL extends BlobURL
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.Modifier and Type | Field and Description |
---|---|
static int |
MAX_PUT_PAGES_BYTES
Indicates the maximum number of bytes that may be sent in a call to putPage.
|
static int |
PAGE_BYTES
Indicates the number of bytes in a page.
|
storageClient
Constructor and Description |
---|
PageBlobURL(URL url,
com.microsoft.rest.v2.http.HttpPipeline pipeline)
Creates a new
PageBlobURL object. |
Modifier and Type | Method and Description |
---|---|
io.reactivex.Single<PageBlobsClearPagesResponse> |
clearPages(PageRange pageRange,
BlobAccessConditions accessConditions)
Frees the specified pages from the page blob.
|
io.reactivex.Single<PageBlobsCopyIncrementalResponse> |
copyIncremental(URL source,
String snapshot,
BlobAccessConditions accessConditions)
Begins an operation to start an incremental copy from one page blob's snapshot to this page
blob.
|
io.reactivex.Single<PageBlobsCreateResponse> |
create(long size,
Long sequenceNumber,
BlobHTTPHeaders headers,
Metadata metadata,
BlobAccessConditions accessConditions)
Creates a page blob of the specified length.
|
io.reactivex.Single<PageBlobsGetPageRangesResponse> |
getPageRanges(BlobRange blobRange,
BlobAccessConditions accessConditions)
Returns the list of valid page ranges for a page blob or snapshot of a page blob.
|
io.reactivex.Single<PageBlobsGetPageRangesDiffResponse> |
getPageRangesDiff(BlobRange blobRange,
String prevSnapshot,
BlobAccessConditions accessConditions)
Gets the collection of page ranges that differ between a specified snapshot and this page blob.
|
io.reactivex.Single<PageBlobsResizeResponse> |
resize(long size,
BlobAccessConditions accessConditions)
Resizes the page blob to the specified size (which must be a multiple of 512).
|
io.reactivex.Single<PageBlobsUpdateSequenceNumberResponse> |
updateSequenceNumber(SequenceNumberActionType action,
Long sequenceNumber,
BlobAccessConditions accessConditions)
Sets the page blob's sequence number.
|
io.reactivex.Single<PageBlobsUploadPagesResponse> |
uploadPages(PageRange pageRange,
io.reactivex.Flowable<ByteBuffer> body,
BlobAccessConditions accessConditions)
Writes 1 or more pages to the page blob.
|
PageBlobURL |
withPipeline(com.microsoft.rest.v2.http.HttpPipeline pipeline)
Creates a new
PageBlobURL with the given pipeline. |
PageBlobURL |
withSnapshot(String snapshot)
Creates a new
PageBlobURL with the given snapshot. |
abortCopyFromURL, acquireLease, breakLease, changeLease, createSnapshot, delete, download, getProperties, releaseLease, renewLease, setHTTPHeaders, setMetadata, startCopyFromURL, toAppendBlobURL, toBlockBlobURL, toPageBlobURL
appendToURLPath, createPipeline, toString, toURL
public static final int PAGE_BYTES
public static final int MAX_PUT_PAGES_BYTES
public PageBlobURL(URL url, com.microsoft.rest.v2.http.HttpPipeline pipeline)
PageBlobURL
object.url
- A java.net.URL
to a page blob.pipeline
- A HttpPipeline
for sending requests.public PageBlobURL withPipeline(com.microsoft.rest.v2.http.HttpPipeline pipeline)
PageBlobURL
with the given pipeline.withPipeline
in class BlobURL
pipeline
- A HttpPipeline
object to set.PageBlobURL
object with the given pipeline.public PageBlobURL withSnapshot(String snapshot) throws MalformedURLException, UnknownHostException
PageBlobURL
with the given snapshot.withSnapshot
in class BlobURL
snapshot
- A String
of the snapshot id.PageBlobURL
object with the given pipeline.MalformedURLException
- Appending the specified snapshot produced an invalid URL.UnknownHostException
- If the url contains an improperly formatted ipaddress or unknown host address.public io.reactivex.Single<PageBlobsCreateResponse> create(long size, Long sequenceNumber, BlobHTTPHeaders headers, Metadata metadata, BlobAccessConditions accessConditions)
size
- Specifies the maximum size for the page blob, up to 8 TB. The page blob size must be aligned to a
512-byte boundary.sequenceNumber
- A user-controlled value that you can use to track requests. The value of the sequence number must be
between 0 and 2^63 - 1.The default value is 0.headers
- BlobHTTPHeaders
metadata
- Metadata
accessConditions
- BlobAccessConditions
public io.reactivex.Single<PageBlobsUploadPagesResponse> uploadPages(PageRange pageRange, io.reactivex.Flowable<ByteBuffer> body, BlobAccessConditions accessConditions)
pageRange
- A PageRange
object. Given that pages must be aligned with 512-byte boundaries, the start offset must
be a modulus of 512 and the end offset must be a modulus of 512 - 1. Examples of valid byte ranges are
0-511, 512-1023, etc.body
- The data to upload.accessConditions
- BlobAccessConditions
public io.reactivex.Single<PageBlobsClearPagesResponse> clearPages(PageRange pageRange, BlobAccessConditions accessConditions)
pageRange
- A PageRange
object. Given that pages must be aligned with 512-byte boundaries, the start offset must
be a modulus of 512 and the end offset must be a modulus of 512 - 1. Examples of valid byte ranges are
0-511, 512-1023, etc.accessConditions
- BlobAccessConditions
public io.reactivex.Single<PageBlobsGetPageRangesResponse> getPageRanges(BlobRange blobRange, BlobAccessConditions accessConditions)
blobRange
- BlobRange
accessConditions
- BlobAccessConditions
public io.reactivex.Single<PageBlobsGetPageRangesDiffResponse> getPageRangesDiff(BlobRange blobRange, String prevSnapshot, BlobAccessConditions accessConditions)
blobRange
- BlobRange
prevSnapshot
- Specifies that the response will contain only pages that were changed between target blob and previous
snapshot. Changed pages include both updated and cleared pages. The target
blob may be a snapshot, as long as the snapshot specified by prevsnapshot is the older of the two.accessConditions
- BlobAccessConditions
public io.reactivex.Single<PageBlobsResizeResponse> resize(long size, BlobAccessConditions accessConditions)
size
- Resizes a page blob to the specified size. If the specified value is less than the current size of the
blob, then all pages above the specified value are cleared.accessConditions
- BlobAccessConditions
public io.reactivex.Single<PageBlobsUpdateSequenceNumberResponse> updateSequenceNumber(SequenceNumberActionType action, Long sequenceNumber, BlobAccessConditions accessConditions)
action
- Indicates how the service should modify the blob's sequence number.sequenceNumber
- The blob's sequence number. The sequence number is a user-controlled property that you can use to track
requests and manage concurrency issues.accessConditions
- BlobAccessConditions
public io.reactivex.Single<PageBlobsCopyIncrementalResponse> copyIncremental(URL source, String snapshot, BlobAccessConditions accessConditions)
source
- The source page blob.snapshot
- The snapshot on the copy source.accessConditions
- BlobAccessConditions
Copyright © 2018. All rights reserved.