Share via


PageBlobClient.CreateIfNotExists Method

Definition

The CreateIfNotExists(Int64, PageBlobCreateOptions, CancellationToken) operation creates a new page blob of the specified size. If the blob already exists, the content of the existing blob will remain unchanged. If the blob does not already exists, a new page blob with the specified size will be created. Azure.Storage.Blobs.Specialized.PageBlobClient.UploadPages(System.IO.Stream,System.Int64,System.Byte[],Azure.Storage.Blobs.Models.PageBlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) operation.

For more information, see https://docs.microsoft.com/rest/api/storageservices/put-blob.

public virtual Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo> CreateIfNotExists (long size, Azure.Storage.Blobs.Models.PageBlobCreateOptions options, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateIfNotExists : int64 * Azure.Storage.Blobs.Models.PageBlobCreateOptions * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>
override this.CreateIfNotExists : int64 * Azure.Storage.Blobs.Models.PageBlobCreateOptions * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>
Public Overridable Function CreateIfNotExists (size As Long, options As PageBlobCreateOptions, Optional cancellationToken As CancellationToken = Nothing) As Response(Of BlobContentInfo)

Parameters

size
Int64

Specifies the maximum size for the page blob, up to 8 TB. The size must be aligned to a 512-byte boundary.

options
PageBlobCreateOptions

Optional parameters.

cancellationToken
CancellationToken

Optional CancellationToken to propagate notifications that the operation should be cancelled.

Returns

If the page blob does not already exist, A Response<T> describing the newly created page blob. Otherwise, null.

Remarks

A RequestFailedException will be thrown if a failure occurs.

Applies to