PageBlobClient.CreateIfNotExists Method

Definition

Namespace:

Azure.Storage.Blobs.Specialized

Assembly:

Azure.Storage.Blobs.dll

Package:

Azure.Storage.Blobs v12.22.2

Source:

PageBlobClient.cs

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

Response<BlobContentInfo>

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.