com.azure.storage.blob.specialized.PageBlobClient Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of azure-storage-blob Show documentation
Show all versions of azure-storage-blob Show documentation
This module contains client library for Microsoft Azure Blob Storage.
// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the MIT License.
package com.azure.storage.blob.specialized;
import com.azure.core.annotation.ReturnType;
import com.azure.core.annotation.ServiceClient;
import com.azure.core.annotation.ServiceMethod;
import com.azure.core.exception.UnexpectedLengthException;
import com.azure.core.http.RequestConditions;
import com.azure.core.http.rest.PagedFlux;
import com.azure.core.http.rest.PagedIterable;
import com.azure.core.http.rest.Response;
import com.azure.core.util.Context;
import com.azure.storage.blob.BlobClient;
import com.azure.storage.blob.implementation.util.ModelHelper;
import com.azure.storage.blob.models.BlobHttpHeaders;
import com.azure.storage.blob.models.BlobRange;
import com.azure.storage.blob.models.BlobRequestConditions;
import com.azure.storage.blob.models.BlobStorageException;
import com.azure.storage.blob.models.CopyStatusType;
import com.azure.storage.blob.models.CustomerProvidedKey;
import com.azure.storage.blob.models.PageBlobItem;
import com.azure.storage.blob.models.PageBlobRequestConditions;
import com.azure.storage.blob.models.PageList;
import com.azure.storage.blob.models.PageRange;
import com.azure.storage.blob.models.PageRangeItem;
import com.azure.storage.blob.models.SequenceNumberActionType;
import com.azure.storage.blob.options.ListPageRangesDiffOptions;
import com.azure.storage.blob.options.ListPageRangesOptions;
import com.azure.storage.blob.options.PageBlobCopyIncrementalOptions;
import com.azure.storage.blob.options.PageBlobCreateOptions;
import com.azure.storage.blob.options.PageBlobUploadPagesFromUrlOptions;
import com.azure.storage.common.Utility;
import com.azure.storage.common.implementation.Constants;
import com.azure.storage.common.implementation.StorageImplUtils;
import reactor.core.publisher.Flux;
import reactor.core.publisher.Mono;
import java.io.InputStream;
import java.net.URL;
import java.nio.ByteBuffer;
import java.time.Duration;
import java.util.Map;
import java.util.Objects;
/**
* Client to a page blob. It may only be instantiated through a {@link SpecializedBlobClientBuilder} or via the method
* {@link BlobClient#getPageBlobClient()}. This class does not hold any state about a particular blob, but is instead a
* convenient way of sending appropriate requests to the resource on the service.
*
*
* Please refer to the Azure
* Docs for more information.
*/
@ServiceClient(builder = SpecializedBlobClientBuilder.class)
public final class PageBlobClient extends BlobClientBase {
private final PageBlobAsyncClient pageBlobAsyncClient;
/**
* Indicates the number of bytes in a page.
*/
public static final int PAGE_BYTES = PageBlobAsyncClient.PAGE_BYTES;
/**
* Indicates the maximum number of bytes that may be sent in a call to putPage.
*/
public static final int MAX_PUT_PAGES_BYTES = PageBlobAsyncClient.MAX_PUT_PAGES_BYTES;
/**
* Package-private constructor for use by {@link SpecializedBlobClientBuilder}.
*
* @param pageBlobAsyncClient the async page blob client
*/
PageBlobClient(PageBlobAsyncClient pageBlobAsyncClient) {
super(pageBlobAsyncClient);
this.pageBlobAsyncClient = pageBlobAsyncClient;
}
/**
* Creates a new {@link PageBlobClient} with the specified {@code encryptionScope}.
*
* @param encryptionScope the encryption scope for the blob, pass {@code null} to use no encryption scope.
* @return a {@link PageBlobClient} with the specified {@code encryptionScope}.
*/
@Override
public PageBlobClient getEncryptionScopeClient(String encryptionScope) {
return new PageBlobClient(pageBlobAsyncClient.getEncryptionScopeAsyncClient(encryptionScope));
}
/**
* Creates a new {@link PageBlobClient} with the specified {@code customerProvidedKey}.
*
* @param customerProvidedKey the {@link CustomerProvidedKey} for the blob,
* pass {@code null} to use no customer provided key.
* @return a {@link PageBlobClient} with the specified {@code customerProvidedKey}.
*/
@Override
public PageBlobClient getCustomerProvidedKeyClient(CustomerProvidedKey customerProvidedKey) {
return new PageBlobClient(pageBlobAsyncClient.getCustomerProvidedKeyAsyncClient(customerProvidedKey));
}
/**
* Creates and opens an output stream to write data to the page blob. If the blob already exists on the service, it
* will be overwritten.
*
* @param pageRange A {@link 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.
* @return A {@link BlobOutputStream} object used to write data to the blob.
* @throws BlobStorageException If a storage service error occurred.
*/
public BlobOutputStream getBlobOutputStream(PageRange pageRange) {
return getBlobOutputStream(pageRange, null);
}
/**
* Creates and opens an output stream to write data to the page blob. If the blob already exists on the service, it
* will be overwritten.
*
* @param pageRange A {@link 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.
* @param requestConditions A {@link BlobRequestConditions} object that represents the access conditions for the
* blob.
* @return A {@link BlobOutputStream} object used to write data to the blob.
* @throws BlobStorageException If a storage service error occurred.
*/
public BlobOutputStream getBlobOutputStream(PageRange pageRange, BlobRequestConditions requestConditions) {
return BlobOutputStream.pageBlobOutputStream(pageBlobAsyncClient, pageRange, requestConditions);
}
/**
* Creates a page blob of the specified length. By default this method will not overwrite an existing blob.
* Call PutPage to upload data data to a page blob. For more information, see the
* Azure Docs.
*
*
Code Samples
*
*
*
* PageBlobItem pageBlob = client.create(size);
* System.out.printf("Created page blob with sequence number %s%n", pageBlob.getBlobSequenceNumber());
*
*
*
* @param 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.
* @return The information of the created page blob.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public PageBlobItem create(long size) {
return create(size, false);
}
/**
* Creates a page blob of the specified length. Call PutPage to upload data data to a page blob. For more
* information, see the
* Azure Docs.
*
* Code Samples
*
*
*
* boolean overwrite = false; // Default value
* PageBlobItem pageBlob = client.create(size, overwrite);
* System.out.printf("Created page blob with sequence number %s%n", pageBlob.getBlobSequenceNumber());
*
*
*
* @param 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.
* @param overwrite Whether or not to overwrite, should data exist on the blob.
* @return The information of the created page blob.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public PageBlobItem create(long size, boolean overwrite) {
BlobRequestConditions blobRequestConditions = new BlobRequestConditions();
if (!overwrite) {
blobRequestConditions.setIfNoneMatch(Constants.HeaderConstants.ETAG_WILDCARD);
}
return createWithResponse(size, null, null, null, blobRequestConditions, null, Context.NONE).getValue();
}
/**
* Creates a page blob of the specified length. Call PutPage to upload data data to a page blob. For more
* information, see the
* Azure Docs.
*
* To avoid overwriting, pass "*" to {@link BlobRequestConditions#setIfNoneMatch(String)}.
*
*
Code Samples
*
*
*
* BlobHttpHeaders headers = new BlobHttpHeaders()
* .setContentLanguage("en-US")
* .setContentType("binary");
* BlobRequestConditions blobRequestConditions = new BlobRequestConditions().setLeaseId(leaseId);
* Context context = new Context(key, value);
*
* PageBlobItem pageBlob = client
* .createWithResponse(size, sequenceNumber, headers, metadata, blobRequestConditions, timeout, context)
* .getValue();
*
* System.out.printf("Created page blob with sequence number %s%n", pageBlob.getBlobSequenceNumber());
*
*
*
* @param 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.
* @param 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.
* @param headers {@link BlobHttpHeaders}
* @param metadata Metadata to associate with the blob. If there is leading or trailing whitespace in any
* metadata key or value, it must be removed or encoded.
* @param requestConditions {@link BlobRequestConditions}
* @param timeout An optional timeout value beyond which a {@link RuntimeException} will be raised.
* @param context Additional context that is passed through the Http pipeline during the service call.
* @return The information of the created page blob.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public Response createWithResponse(long size, Long sequenceNumber, BlobHttpHeaders headers,
Map metadata, BlobRequestConditions requestConditions, Duration timeout, Context context) {
return this.createWithResponse(new PageBlobCreateOptions(size).setSequenceNumber(sequenceNumber)
.setHeaders(headers).setMetadata(metadata).setRequestConditions(requestConditions), timeout,
context);
}
/**
* Creates a page blob of the specified length. Call PutPage to upload data data to a page blob. For more
* information, see the
* Azure Docs.
*
* To avoid overwriting, pass "*" to {@link BlobRequestConditions#setIfNoneMatch(String)}.
*
*
Code Samples
*
*
*
* BlobHttpHeaders headers = new BlobHttpHeaders()
* .setContentLanguage("en-US")
* .setContentType("binary");
* BlobRequestConditions blobRequestConditions = new BlobRequestConditions().setLeaseId(leaseId);
* Context context = new Context(key, value);
*
* PageBlobItem pageBlob = client
* .createWithResponse(new PageBlobCreateOptions(size).setSequenceNumber(sequenceNumber)
* .setHeaders(headers).setMetadata(metadata).setTags(tags)
* .setRequestConditions(blobRequestConditions), timeout,
* context)
* .getValue();
*
* System.out.printf("Created page blob with sequence number %s%n", pageBlob.getBlobSequenceNumber());
*
*
*
* @param options {@link PageBlobCreateOptions}
* @param timeout An optional timeout value beyond which a {@link RuntimeException} will be raised.
* @param context Additional context that is passed through the Http pipeline during the service call.
* @return The information of the created page blob.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public Response createWithResponse(PageBlobCreateOptions options, Duration timeout, Context context) {
Mono> response = pageBlobAsyncClient.createWithResponse(options, context);
return StorageImplUtils.blockWithOptionalTimeout(response, timeout);
}
/**
* Creates a page blob of the specified length if it does not exist.
* Call PutPage to upload data to a page blob. For more information, see the
* Azure Docs.
*
* Code Samples
*
*
*
* PageBlobItem pageBlob = client.createIfNotExists(size);
* System.out.printf("Created page blob with sequence number %s%n", pageBlob.getBlobSequenceNumber());
*
*
*
* @param 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.
* @return {@link PageBlobItem} containing information of the created page blob.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public PageBlobItem createIfNotExists(long size) {
return createIfNotExistsWithResponse(new PageBlobCreateOptions(size), null, null).getValue();
}
/**
* Creates a page blob of the specified length if it does not exist. Call PutPage to upload data to a page blob.
* For more information, see the
* Azure Docs.
*
* Code Samples
*
*
*
* BlobHttpHeaders headers = new BlobHttpHeaders()
* .setContentLanguage("en-US")
* .setContentType("binary");
* Context context = new Context(key, value);
*
* Response<PageBlobItem> response = client.createIfNotExistsWithResponse(new PageBlobCreateOptions(size)
* .setHeaders(headers).setMetadata(metadata).setTags(tags), timeout, context);
*
* if (response.getStatusCode() == 409) {
* System.out.println("Already existed.");
* } else {
* System.out.printf("Create completed with status %d%n", response.getStatusCode());
* }
*
*
*
* @param options {@link PageBlobCreateOptions}
* @param timeout An optional timeout value beyond which a {@link RuntimeException} will be raised.
* @param context Additional context that is passed through the Http pipeline during the service call.
* @return A reactive {@link Response} signaling completion, whose {@link Response#getValue() value} contains a
* {@link PageBlobItem} containing information about the page blob. If {@link Response}'s status code is 201, a new
* page blob was successfully created. If status code is 409, a page blob already existed at this location.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public Response createIfNotExistsWithResponse(PageBlobCreateOptions options, Duration timeout,
Context context) {
return StorageImplUtils.blockWithOptionalTimeout(pageBlobAsyncClient.
createIfNotExistsWithResponse(options, context), timeout);
}
/**
* Writes one or more pages to the page blob. The write size must be a multiple of 512. 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
* {@code Flux} must produce the same data each time it is subscribed to.
*
*
Code Samples
*
*
*
* PageRange pageRange = new PageRange()
* .setStart(0)
* .setEnd(511);
* InputStream dataStream = new ByteArrayInputStream(data.getBytes(StandardCharsets.UTF_8));
*
* PageBlobItem pageBlob = client.uploadPages(pageRange, dataStream);
* System.out.printf("Uploaded page blob with sequence number %s%n", pageBlob.getBlobSequenceNumber());
*
*
*
* @param pageRange A {@link 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.
* @param body The data to upload. The data must be markable. This is in order to support retries. If
* the data is not markable, consider using {@link #getBlobOutputStream(PageRange)} and writing to the returned
* OutputStream. Alternatively, consider wrapping your data source in a {@link java.io.BufferedInputStream} to add
* mark support.
* @return The information of the uploaded pages.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public PageBlobItem uploadPages(PageRange pageRange, InputStream body) {
return uploadPagesWithResponse(pageRange, body, null, null, null, Context.NONE).getValue();
}
/**
* Writes one or more pages to the page blob. The write size must be a multiple of 512. 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
* {@code Flux} must produce the same data each time it is subscribed to.
*
*
Code Samples
*
*
*
* byte[] md5 = MessageDigest.getInstance("MD5").digest("data".getBytes(StandardCharsets.UTF_8));
* PageRange pageRange = new PageRange()
* .setStart(0)
* .setEnd(511);
* InputStream dataStream = new ByteArrayInputStream(data.getBytes(StandardCharsets.UTF_8));
* PageBlobRequestConditions pageBlobRequestConditions = new PageBlobRequestConditions().setLeaseId(leaseId);
* Context context = new Context(key, value);
*
* PageBlobItem pageBlob = client
* .uploadPagesWithResponse(pageRange, dataStream, md5, pageBlobRequestConditions, timeout, context).getValue();
*
* System.out.printf("Uploaded page blob with sequence number %s%n", pageBlob.getBlobSequenceNumber());
*
*
*
* @param pageRange A {@link 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.
* @param body The data to upload. The data must be markable. This is in order to support retries. If
* the data is not markable, consider using {@link #getBlobOutputStream(PageRange)} and writing to the returned
* OutputStream. Alternatively, consider wrapping your data source in a {@link java.io.BufferedInputStream} to add
* mark support.
* @param contentMd5 An MD5 hash of the page content. This hash is used to verify the integrity of the page during
* transport. When this header is specified, the storage service compares the hash of the content that has arrived
* with this header value. Note that this MD5 hash is not stored with the blob. If the two hashes do not match, the
* operation will fail.
* @param pageBlobRequestConditions {@link PageBlobRequestConditions}
* @param timeout An optional timeout value beyond which a {@link RuntimeException} will be raised.
* @param context Additional context that is passed through the Http pipeline during the service call.
* @return The information of the uploaded pages.
* @throws UnexpectedLengthException when the length of data does not match the input {@code length}.
* @throws NullPointerException if the input data is null.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public Response uploadPagesWithResponse(PageRange pageRange, InputStream body, byte[] contentMd5,
PageBlobRequestConditions pageBlobRequestConditions, Duration timeout, Context context) {
Objects.requireNonNull(body, "'body' cannot be null.");
final long length = pageRange.getEnd() - pageRange.getStart() + 1;
Flux fbb = Utility.convertStreamToByteBuffer(body, length, PAGE_BYTES, true);
Mono> response = pageBlobAsyncClient.uploadPagesWithResponse(pageRange, fbb, contentMd5,
pageBlobRequestConditions, context);
return StorageImplUtils.blockWithOptionalTimeout(response, timeout);
}
/**
* Writes one or more pages from the source page blob to this page blob. The write size must be a multiple of 512.
* For more information, see the
* Azure Docs.
*
* Code Samples
*
*
*
* PageRange pageRange = new PageRange()
* .setStart(0)
* .setEnd(511);
*
* PageBlobItem pageBlob = client.uploadPagesFromUrl(pageRange, url, sourceOffset);
*
* System.out.printf("Uploaded page blob from URL with sequence number %s%n", pageBlob.getBlobSequenceNumber());
*
*
*
* @param range A {@link 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.
* @param sourceUrl The url to the blob that will be the source of the copy. A source blob in the same storage
* account can be authenticated via Shared Key. However, if the source is a blob in another account, the source blob
* must either be public or must be authenticated via a shared access signature. If the source blob is public, no
* authentication is required to perform the operation.
* @param sourceOffset The source offset to copy from. Pass null or 0 to copy from the beginning of source page
* blob.
* @return The information of the uploaded pages.
* @throws IllegalArgumentException If {@code sourceUrl} is a malformed {@link URL}.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public PageBlobItem uploadPagesFromUrl(PageRange range, String sourceUrl, Long sourceOffset) {
return uploadPagesFromUrlWithResponse(range, sourceUrl, sourceOffset, null, null, null, null, Context.NONE)
.getValue();
}
/**
* Writes one or more pages from the source page blob to this page blob. The write size must be a multiple of 512.
* For more information, see the
* Azure Docs.
*
* Code Samples
*
*
*
* PageRange pageRange = new PageRange()
* .setStart(0)
* .setEnd(511);
* InputStream dataStream = new ByteArrayInputStream(data.getBytes(StandardCharsets.UTF_8));
* byte[] sourceContentMD5 = new byte[512];
* PageBlobRequestConditions pageBlobRequestConditions = new PageBlobRequestConditions().setLeaseId(leaseId);
* BlobRequestConditions sourceRequestConditions = new BlobRequestConditions()
* .setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));
* Context context = new Context(key, value);
*
* PageBlobItem pageBlob = client
* .uploadPagesFromUrlWithResponse(pageRange, url, sourceOffset, sourceContentMD5, pageBlobRequestConditions,
* sourceRequestConditions, timeout, context).getValue();
*
* System.out.printf("Uploaded page blob from URL with sequence number %s%n", pageBlob.getBlobSequenceNumber());
*
*
*
* @param range The destination {@link PageRange} range. 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.
* @param sourceUrl The url to the blob that will be the source of the copy. A source blob in the same storage
* account can be authenticated via Shared Key. However, if the source is a blob in another account, the source blob
* must either be public or must be authenticated via a shared access signature. If the source blob is public, no
* authentication is required to perform the operation.
* @param sourceOffset The source offset to copy from. Pass null or 0 to copy from the beginning of source blob.
* @param sourceContentMd5 An MD5 hash of the block content from the source blob. If specified, the service will
* calculate the MD5 of the received data and fail the request if it does not match the provided MD5.
* @param destRequestConditions {@link PageBlobRequestConditions}
* @param sourceRequestConditions {@link BlobRequestConditions}
* @param timeout An optional timeout value beyond which a {@link RuntimeException} will be raised.
* @param context Additional context that is passed through the Http pipeline during the service call.
* @return The information of the uploaded pages.
* @throws IllegalArgumentException If {@code sourceUrl} is a malformed {@link URL}.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public Response uploadPagesFromUrlWithResponse(PageRange range, String sourceUrl, Long sourceOffset,
byte[] sourceContentMd5, PageBlobRequestConditions destRequestConditions,
BlobRequestConditions sourceRequestConditions, Duration timeout, Context context) {
return uploadPagesFromUrlWithResponse(
new PageBlobUploadPagesFromUrlOptions(range, sourceUrl).setSourceOffset(sourceOffset)
.setSourceContentMd5(sourceContentMd5).setDestinationRequestConditions(destRequestConditions)
.setSourceRequestConditions(sourceRequestConditions),
timeout, context);
}
/**
* Writes one or more pages from the source page blob to this page blob. The write size must be a multiple of 512.
* For more information, see the
* Azure Docs.
*
* Code Samples
*
*
*
* PageRange pageRange = new PageRange()
* .setStart(0)
* .setEnd(511);
* InputStream dataStream = new ByteArrayInputStream(data.getBytes(StandardCharsets.UTF_8));
* byte[] sourceContentMD5 = new byte[512];
* PageBlobRequestConditions pageBlobRequestConditions = new PageBlobRequestConditions().setLeaseId(leaseId);
* BlobRequestConditions sourceRequestConditions = new BlobRequestConditions()
* .setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));
* Context context = new Context(key, value);
*
* PageBlobItem pageBlob = client
* .uploadPagesFromUrlWithResponse(new PageBlobUploadPagesFromUrlOptions(pageRange, url)
* .setSourceOffset(sourceOffset).setSourceContentMd5(sourceContentMD5)
* .setDestinationRequestConditions(pageBlobRequestConditions)
* .setSourceRequestConditions(sourceRequestConditions), timeout, context).getValue();
*
* System.out.printf("Uploaded page blob from URL with sequence number %s%n", pageBlob.getBlobSequenceNumber());
*
*
*
* @param options Parameters for the operation.
* @param timeout An optional timeout value beyond which a {@link RuntimeException} will be raised.
* @param context Additional context that is passed through the Http pipeline during the service call.
* @return The information of the uploaded pages.
* @throws IllegalArgumentException If {@code sourceUrl} is a malformed {@link URL}.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public Response uploadPagesFromUrlWithResponse(PageBlobUploadPagesFromUrlOptions options, Duration timeout,
Context context) {
Mono> response = pageBlobAsyncClient.uploadPagesFromUrlWithResponse(options, context);
return StorageImplUtils.blockWithOptionalTimeout(response, timeout);
}
/**
* Frees the specified pages from the page blob. The size of the range must be a multiple of 512. For more
* information, see the Azure Docs.
*
* Code Samples
*
*
*
* PageRange pageRange = new PageRange()
* .setStart(0)
* .setEnd(511);
*
* PageBlobItem pageBlob = client.clearPages(pageRange);
*
* System.out.printf("Cleared page blob with sequence number %s%n", pageBlob.getBlobSequenceNumber());
*
*
*
* @param pageRange A {@link 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.
* @return The information of the cleared pages.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public PageBlobItem clearPages(PageRange pageRange) {
return clearPagesWithResponse(pageRange, null, null, Context.NONE).getValue();
}
/**
* Frees the specified pages from the page blob. The size of the range must be a multiple of 512. For more
* information, see the Azure Docs.
*
* Code Samples
*
*
*
* PageRange pageRange = new PageRange()
* .setStart(0)
* .setEnd(511);
* PageBlobRequestConditions pageBlobRequestConditions = new PageBlobRequestConditions().setLeaseId(leaseId);
* Context context = new Context(key, value);
*
* PageBlobItem pageBlob = client
* .clearPagesWithResponse(pageRange, pageBlobRequestConditions, timeout, context).getValue();
*
* System.out.printf("Cleared page blob with sequence number %s%n", pageBlob.getBlobSequenceNumber());
*
*
*
* @param pageRange A {@link 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.
* @param timeout An optional timeout value beyond which a {@link RuntimeException} will be raised.
* @param pageBlobRequestConditions {@link PageBlobRequestConditions}
* @param context Additional context that is passed through the Http pipeline during the service call.
* @return The information of the cleared pages.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public Response clearPagesWithResponse(PageRange pageRange,
PageBlobRequestConditions pageBlobRequestConditions, Duration timeout, Context context) {
Mono> response = pageBlobAsyncClient.clearPagesWithResponse(pageRange,
pageBlobRequestConditions, context);
return StorageImplUtils.blockWithOptionalTimeout(response, timeout);
}
/**
* Returns the list of valid page ranges for a page blob or snapshot of a page blob. For more information, see the
* Azure Docs.
*
* Code Samples
*
*
*
* BlobRange blobRange = new BlobRange(offset);
* PageList pageList = client.getPageRanges(blobRange);
*
* System.out.println("Valid Page Ranges are:");
* for (PageRange pageRange : pageList.getPageRange()) {
* System.out.printf("Start: %s, End: %s%n", pageRange.getStart(), pageRange.getEnd());
* }
*
*
*
* @param blobRange {@link BlobRange}
* @return The information of the cleared pages.
* @deprecated See {@link #listPageRanges(BlobRange)}
*/
@ServiceMethod(returns = ReturnType.SINGLE)
@Deprecated
public PageList getPageRanges(BlobRange blobRange) {
return getPageRangesWithResponse(blobRange, null, null, Context.NONE).getValue();
}
/**
* Returns the list of valid page ranges for a page blob or snapshot of a page blob. For more information, see the
* Azure Docs.
*
* Code Samples
*
*
*
* BlobRange blobRange = new BlobRange(offset);
* BlobRequestConditions blobRequestConditions = new BlobRequestConditions().setLeaseId(leaseId);
* Context context = new Context(key, value);
*
* PageList pageList = client
* .getPageRangesWithResponse(blobRange, blobRequestConditions, timeout, context).getValue();
*
* System.out.println("Valid Page Ranges are:");
* for (PageRange pageRange : pageList.getPageRange()) {
* System.out.printf("Start: %s, End: %s%n", pageRange.getStart(), pageRange.getEnd());
* }
*
*
*
* @param blobRange {@link BlobRange}
* @param requestConditions {@link BlobRequestConditions}
* @param timeout An optional timeout value beyond which a {@link RuntimeException} will be raised.
* @param context Additional context that is passed through the Http pipeline during the service call.
* @return All the page ranges.
* @deprecated See {@link #listPageRanges(ListPageRangesOptions,Duration,Context)}
*/
@ServiceMethod(returns = ReturnType.SINGLE)
@Deprecated
public Response getPageRangesWithResponse(BlobRange blobRange, BlobRequestConditions requestConditions,
Duration timeout, Context context) {
return StorageImplUtils.blockWithOptionalTimeout(pageBlobAsyncClient
.getPageRangesWithResponse(blobRange, requestConditions, context), timeout);
}
/**
* Returns the list of valid page ranges for a page blob or snapshot of a page blob. For more information, see the
* Azure Docs.
*
* Code Samples
*
*
*
* BlobRange blobRange = new BlobRange(offset);
* String prevSnapshot = "previous snapshot";
* PagedIterable<PageRangeItem> iterable = client.listPageRanges(blobRange);
*
* for (PageRangeItem item : iterable) {
* System.out.printf("Offset: %s, Length: %s, isClear: %s%n", item.getRange().getOffset(),
* item.getRange().getLength(), item.isClear());
* }
*
*
*
* @param blobRange {@link BlobRange}
*
* @return A reactive response containing the information of the cleared pages.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public PagedIterable listPageRanges(BlobRange blobRange) {
return listPageRanges(new ListPageRangesOptions(blobRange), null, null);
}
/**
* Returns the list of valid page ranges for a page blob or snapshot of a page blob. For more information, see the
* Azure Docs.
*
* Code Samples
*
*
*
* ListPageRangesOptions options = new ListPageRangesOptions(new BlobRange(offset))
* .setRequestConditions(new BlobRequestConditions().setLeaseId(leaseId))
* .setMaxResultsPerPage(1000);
*
* Context context = new Context(key, value);
*
* PagedIterable<PageRangeItem> iter = client
* .listPageRanges(options, timeout, context);
*
* System.out.println("Valid Page Ranges are:");
* for (PageRangeItem item : iter) {
* System.out.printf("Offset: %s, Length: %s, isClear: %s%n", item.getRange().getOffset(),
* item.getRange().getLength(), item.isClear());
* }
*
*
*
* @param options {@link ListPageRangesOptions}
* @param timeout An optional timeout value beyond which a {@link RuntimeException} will be raised.
* @param context Additional context that is passed through the Http pipeline during the service call.
* @return A reactive response emitting all the page ranges.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public PagedIterable listPageRanges(ListPageRangesOptions options, Duration timeout,
Context context) {
return new PagedIterable<>(
// pull timeout out of options
new PagedFlux<>(
pageSize -> pageBlobAsyncClient.listPageRangesWithOptionalTimeout(
options, timeout, context).apply(null, pageSize),
(continuationToken, pageSize) -> pageBlobAsyncClient.listPageRangesWithOptionalTimeout(
options, timeout, context).apply(continuationToken, pageSize)));
}
/**
* Gets the collection of page ranges that differ between a specified snapshot and this page blob. For more
* information, see the Azure
* Docs.
*
* Code Samples
*
*
*
* BlobRange blobRange = new BlobRange(offset);
* final String prevSnapshot = "previous snapshot";
* PageList pageList = client.getPageRangesDiff(blobRange, prevSnapshot);
*
* System.out.println("Valid Page Ranges are:");
* for (PageRange pageRange : pageList.getPageRange()) {
* System.out.printf("Start: %s, End: %s%n", pageRange.getStart(), pageRange.getEnd());
* }
*
*
*
* @param blobRange {@link BlobRange}
* @param 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.
* @return All the different page ranges.
* @deprecated See {@link #listPageRangesDiff(BlobRange, String)}
*/
@ServiceMethod(returns = ReturnType.SINGLE)
@Deprecated
public PageList getPageRangesDiff(BlobRange blobRange, String prevSnapshot) {
return getPageRangesDiffWithResponse(blobRange, prevSnapshot, null, null, Context.NONE).getValue();
}
/**
* This API only works for managed disk accounts.
* Gets the collection of page ranges that differ between a specified snapshot and this page blob. For more
* information, see the Azure
* Docs.
*
* Code Samples
*
*
*
* BlobRange blobRange = new BlobRange(offset);
* final String prevSnapshot = "previous snapshot";
* BlobRequestConditions blobRequestConditions = new BlobRequestConditions().setLeaseId(leaseId);
* Context context = new Context(key, value);
*
* PageList pageList = client
* .getPageRangesDiffWithResponse(blobRange, prevSnapshot, blobRequestConditions, timeout, context).getValue();
*
* System.out.println("Valid Page Ranges are:");
* for (PageRange pageRange : pageList.getPageRange()) {
* System.out.printf("Start: %s, End: %s%n", pageRange.getStart(), pageRange.getEnd());
* }
*
*
*
* @param blobRange {@link BlobRange}
* @param 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.
* @param requestConditions {@link BlobRequestConditions}
* @param timeout An optional timeout value beyond which a {@link RuntimeException} will be raised.
* @param context Additional context that is passed through the Http pipeline during the service call.
* @return All the different page ranges.
* @deprecated See {@link #listPageRanges(ListPageRangesOptions,Duration,Context)} )}
*/
@ServiceMethod(returns = ReturnType.SINGLE)
@Deprecated
public Response getPageRangesDiffWithResponse(BlobRange blobRange, String prevSnapshot,
BlobRequestConditions requestConditions, Duration timeout, Context context) {
return StorageImplUtils.blockWithOptionalTimeout(pageBlobAsyncClient
.getPageRangesDiffWithResponse(blobRange, prevSnapshot, null, requestConditions, context),
timeout);
}
/**
* Gets the collection of page ranges that differ between a specified snapshot and this page blob. For more
* information, see the Azure
* Docs.
*
* Code Samples
*
*
*
* BlobRange blobRange = new BlobRange(offset);
* String prevSnapshot = "previous snapshot";
* PagedIterable<PageRangeItem> iterable = client.listPageRangesDiff(blobRange, prevSnapshot);
*
* for (PageRangeItem item : iterable) {
* System.out.printf("Offset: %s, Length: %s, isClear: %s%n", item.getRange().getOffset(),
* item.getRange().getLength(), item.isClear());
* }
*
*
*
* @param blobRange {@link BlobRange}
* @param 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.
*
* @return A reactive response emitting all the different page ranges.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public PagedIterable listPageRangesDiff(BlobRange blobRange, String prevSnapshot) {
return listPageRangesDiff(new ListPageRangesDiffOptions(blobRange, prevSnapshot), null, null);
}
/**
* Gets the collection of page ranges that differ between a specified snapshot and this page blob. For more
* information, see the Azure
* Docs.
*
* Code Samples
*
*
*
* ListPageRangesDiffOptions options = new ListPageRangesDiffOptions(new BlobRange(offset), "previous snapshot")
* .setRequestConditions(new BlobRequestConditions().setLeaseId(leaseId))
* .setMaxResultsPerPage(1000);
*
* Context context = new Context(key, value);
*
* PagedIterable<PageRangeItem> iter = client
* .listPageRangesDiff(options, timeout, context);
*
* System.out.println("Valid Page Ranges are:");
* for (PageRangeItem item : iter) {
* System.out.printf("Offset: %s, Length: %s, isClear: %s%n", item.getRange().getOffset(),
* item.getRange().getLength(), item.isClear());
* }
*
*
*
* @param options {@link ListPageRangesDiffOptions}.
* @param timeout An optional timeout value beyond which a {@link RuntimeException} will be raised.
* @param context Additional context that is passed through the Http pipeline during the service call.
* @return A reactive response emitting all the different page ranges.
*
* @throws IllegalArgumentException If {@code prevSnapshot} is {@code null}
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public PagedIterable listPageRangesDiff(ListPageRangesDiffOptions options, Duration timeout,
Context context) {
return new PagedIterable<>(
// pull timeout out of options
new PagedFlux<>(
pageSize -> pageBlobAsyncClient.listPageRangesDiffWithOptionalTimeout(
options, timeout, context).apply(null, pageSize),
(continuationToken, pageSize) -> pageBlobAsyncClient.listPageRangesDiffWithOptionalTimeout(
options, timeout, context).apply(continuationToken, pageSize)));
}
/**
* This API only works for managed disk accounts.
* Gets the collection of page ranges that differ between a specified snapshot and this page blob. For more
* information, see the Azure
* Docs.
*
* Code Samples
*
*
*
* BlobRange blobRange = new BlobRange(offset);
* final String prevSnapshotUrl = "previous snapshot url";
* PageList pageList = client.getPageRangesDiff(blobRange, prevSnapshotUrl);
*
* System.out.println("Valid Page Ranges are:");
* for (PageRange pageRange : pageList.getPageRange()) {
* System.out.printf("Start: %s, End: %s%n", pageRange.getStart(), pageRange.getEnd());
* }
*
*
*
* @param blobRange {@link BlobRange}
* @param prevSnapshotUrl Specifies the URL of a previous snapshot of the target blob. 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.
* @return All the different page ranges.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public PageList getManagedDiskPageRangesDiff(BlobRange blobRange, String prevSnapshotUrl) {
return getManagedDiskPageRangesDiffWithResponse(blobRange, prevSnapshotUrl, null, null, Context.NONE)
.getValue();
}
/**
* This API only works for managed disk accounts.
* Gets the collection of page ranges that differ between a specified snapshot and this page blob. For more
* information, see the Azure
* Docs.
*
* Code Samples
*
*
*
* BlobRange blobRange = new BlobRange(offset);
* final String prevSnapshotUrl = "previous snapshot url";
* BlobRequestConditions blobRequestConditions = new BlobRequestConditions().setLeaseId(leaseId);
* Context context = new Context(key, value);
*
* PageList pageList = client
* .getPageRangesDiffWithResponse(blobRange, prevSnapshotUrl, blobRequestConditions, timeout, context).getValue();
*
* System.out.println("Valid Page Ranges are:");
* for (PageRange pageRange : pageList.getPageRange()) {
* System.out.printf("Start: %s, End: %s%n", pageRange.getStart(), pageRange.getEnd());
* }
*
*
*
* @param blobRange {@link BlobRange}
* @param prevSnapshotUrl Specifies the URL of a previous snapshot of the target blob. 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.
* @param requestConditions {@link BlobRequestConditions}
* @param timeout An optional timeout value beyond which a {@link RuntimeException} will be raised.
* @param context Additional context that is passed through the Http pipeline during the service call.
* @return All the different page ranges.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public Response getManagedDiskPageRangesDiffWithResponse(BlobRange blobRange, String prevSnapshotUrl,
BlobRequestConditions requestConditions, Duration timeout, Context context) {
return StorageImplUtils.blockWithOptionalTimeout(pageBlobAsyncClient
.getPageRangesDiffWithResponse(blobRange, null, prevSnapshotUrl, requestConditions, context),
timeout);
}
/**
* Resizes the page blob to the specified size (which must be a multiple of 512). For more information, see the Azure Docs.
*
* Code Samples
*
*
*
* PageBlobItem pageBlob = client.resize(size);
* System.out.printf("Page blob resized with sequence number %s%n", pageBlob.getBlobSequenceNumber());
*
*
*
* @param 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.
* @return The resized page blob.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public PageBlobItem resize(long size) {
return resizeWithResponse(size, null, null, Context.NONE).getValue();
}
/**
* Resizes the page blob to the specified size (which must be a multiple of 512). For more information, see the Azure Docs.
*
* Code Samples
*
*
*
* BlobRequestConditions blobRequestConditions = new BlobRequestConditions().setLeaseId(leaseId);
* Context context = new Context(key, value);
*
* PageBlobItem pageBlob = client
* .resizeWithResponse(size, blobRequestConditions, timeout, context).getValue();
* System.out.printf("Page blob resized with sequence number %s%n", pageBlob.getBlobSequenceNumber());
*
*
*
* @param 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.
* @param requestConditions {@link BlobRequestConditions}
* @param timeout An optional timeout value beyond which a {@link RuntimeException} will be raised.
* @param context Additional context that is passed through the Http pipeline during the service call.
* @return The resized page blob.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public Response resizeWithResponse(long size, BlobRequestConditions requestConditions,
Duration timeout, Context context) {
Mono> response = pageBlobAsyncClient.resizeWithResponse(size, requestConditions,
context);
return StorageImplUtils.blockWithOptionalTimeout(response, timeout);
}
/**
* Sets the page blob's sequence number. For more information, see the Azure
* Docs.
*
* Code Samples
*
*
*
* PageBlobItem pageBlob = client.updateSequenceNumber(SequenceNumberActionType.INCREMENT, size);
*
* System.out.printf("Page blob updated to sequence number %s%n", pageBlob.getBlobSequenceNumber());
*
*
*
* @param action Indicates how the service should modify the blob's sequence number.
* @param 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.
* @return The updated page blob.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public PageBlobItem updateSequenceNumber(SequenceNumberActionType action,
Long sequenceNumber) {
return updateSequenceNumberWithResponse(action, sequenceNumber, null, null, Context.NONE).getValue();
}
/**
* Sets the page blob's sequence number. For more information, see the Azure
* Docs.
*
* Code Samples
*
*
*
* BlobRequestConditions blobRequestConditions = new BlobRequestConditions().setLeaseId(leaseId);
* Context context = new Context(key, value);
*
* PageBlobItem pageBlob = client.updateSequenceNumberWithResponse(
* SequenceNumberActionType.INCREMENT, size, blobRequestConditions, timeout, context).getValue();
*
* System.out.printf("Page blob updated to sequence number %s%n", pageBlob.getBlobSequenceNumber());
*
*
*
* @param action Indicates how the service should modify the blob's sequence number.
* @param 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.
* @param requestConditions {@link BlobRequestConditions}
* @param timeout An optional timeout value beyond which a {@link RuntimeException} will be raised.
* @param context Additional context that is passed through the Http pipeline during the service call.
* @return The updated page blob.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public Response updateSequenceNumberWithResponse(SequenceNumberActionType action,
Long sequenceNumber, BlobRequestConditions requestConditions, Duration timeout, Context context) {
Mono> response = pageBlobAsyncClient
.updateSequenceNumberWithResponse(action, sequenceNumber, requestConditions, context);
return StorageImplUtils.blockWithOptionalTimeout(response, timeout);
}
/**
* Begins an operation to start an incremental copy from one page blob's snapshot to this page blob. The snapshot is
* copied such that only the differential changes between the previously copied snapshot are transferred to the
* destination. The copied snapshots are complete copies of the original snapshot and can be read or copied from as
* usual. For more information, see the Azure Docs here
* and
* here.
*
* Code Samples
*
*
*
* final String snapshot = "copy snapshot";
* CopyStatusType statusType = client.copyIncremental(url, snapshot);
*
* switch (statusType) {
* case SUCCESS:
* System.out.println("Page blob copied successfully");
* break;
* case FAILED:
* System.out.println("Page blob copied failed");
* break;
* case ABORTED:
* System.out.println("Page blob copied aborted");
* break;
* case PENDING:
* System.out.println("Page blob copied pending");
* break;
* default:
* break;
* }
*
*
*
* @param source The source page blob.
* @param snapshot The snapshot on the copy source.
* @return The copy status.
* @throws IllegalArgumentException If {@code source} is a malformed {@link URL}.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public CopyStatusType copyIncremental(String source, String snapshot) {
return copyIncrementalWithResponse(source, snapshot, null, null, Context.NONE).getValue();
}
/**
* Begins an operation to start an incremental copy from one page blob's snapshot to this page blob. The snapshot is
* copied such that only the differential changes between the previously copied snapshot are transferred to the
* destination. The copied snapshots are complete copies of the original snapshot and can be read or copied from as
* usual. For more information, see the Azure Docs here
* and
* here.
*
* Code Samples
*
*
*
* final String snapshot = "copy snapshot";
* RequestConditions modifiedRequestConditions = new RequestConditions()
* .setIfNoneMatch("snapshotMatch");
* Context context = new Context(key, value);
*
* CopyStatusType statusType = client
* .copyIncrementalWithResponse(url, snapshot, modifiedRequestConditions, timeout, context).getValue();
*
* switch (statusType) {
* case SUCCESS:
* System.out.println("Page blob copied successfully");
* break;
* case FAILED:
* System.out.println("Page blob copied failed");
* break;
* case ABORTED:
* System.out.println("Page blob copied aborted");
* break;
* case PENDING:
* System.out.println("Page blob copied pending");
* break;
* default:
* break;
* }
*
*
*
* @param source The source page blob.
* @param snapshot The snapshot on the copy source.
* @param modifiedRequestConditions Standard HTTP Access conditions related to the modification of data. ETag and
* LastModifiedTime are used to construct conditions related to when the blob was changed relative to the given
* request. The request will fail if the specified condition is not satisfied.
* @param timeout An optional timeout value beyond which a {@link RuntimeException} will be raised.
* @param context Additional context that is passed through the Http pipeline during the service call.
* @return The copy status.
* @throws IllegalArgumentException If {@code source} is a malformed {@link URL}.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public Response copyIncrementalWithResponse(String source, String snapshot,
RequestConditions modifiedRequestConditions, Duration timeout, Context context) {
return copyIncrementalWithResponse(new PageBlobCopyIncrementalOptions(source, snapshot)
.setRequestConditions(
ModelHelper.populateBlobDestinationRequestConditions(modifiedRequestConditions)),
timeout, context);
}
/**
* Begins an operation to start an incremental copy from one page blob's snapshot to this page blob. The snapshot is
* copied such that only the differential changes between the previously copied snapshot are transferred to the
* destination. The copied snapshots are complete copies of the original snapshot and can be read or copied from as
* usual. For more information, see the Azure Docs here
* and
* here.
*
* Code Samples
*
*
*
* final String snapshot = "copy snapshot";
* PageBlobCopyIncrementalRequestConditions destinationRequestConditions = new PageBlobCopyIncrementalRequestConditions()
* .setIfNoneMatch("snapshotMatch");
* Context context = new Context(key, value);
*
* CopyStatusType statusType = client
* .copyIncrementalWithResponse(new PageBlobCopyIncrementalOptions(url, snapshot)
* .setRequestConditions(destinationRequestConditions), timeout, context).getValue();
*
* switch (statusType) {
* case SUCCESS:
* System.out.println("Page blob copied successfully");
* break;
* case FAILED:
* System.out.println("Page blob copied failed");
* break;
* case ABORTED:
* System.out.println("Page blob copied aborted");
* break;
* case PENDING:
* System.out.println("Page blob copied pending");
* break;
* default:
* break;
* }
*
*
*
* @param options {@link PageBlobCopyIncrementalOptions}
* @param timeout An optional timeout value beyond which a {@link RuntimeException} will be raised.
* @param context Additional context that is passed through the Http pipeline during the service call.
* @return The copy status.
* @throws IllegalArgumentException If {@code source} is a malformed {@link URL}.
*/
@ServiceMethod(returns = ReturnType.SINGLE)
public Response copyIncrementalWithResponse(PageBlobCopyIncrementalOptions options,
Duration timeout, Context context) {
Mono> response = pageBlobAsyncClient.copyIncrementalWithResponse(options, context);
return StorageImplUtils.blockWithOptionalTimeout(response, timeout);
}
}