Share via


ShareClient.CreateIfNotExistsAsync Method

Definition

The Azure.Storage.Files.Shares.ShareClient.CreateIfNotExistsAsync(System.Collections.Generic.IDictionary{System.String,System.String},System.Nullable{System.Int32},System.Threading.CancellationToken) operation creates a new share under the specified account. If a share with the same name already exists, it is not changed.

For more information, see Create Share.

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.Models.ShareInfo>> CreateIfNotExistsAsync (Azure.Storage.Files.Shares.Models.ShareCreateOptions options = default, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateIfNotExistsAsync : Azure.Storage.Files.Shares.Models.ShareCreateOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.Models.ShareInfo>>
override this.CreateIfNotExistsAsync : Azure.Storage.Files.Shares.Models.ShareCreateOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.Models.ShareInfo>>
Public Overridable Function CreateIfNotExistsAsync (Optional options As ShareCreateOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of ShareInfo))

Parameters

options
ShareCreateOptions

Optional parameters.

cancellationToken
CancellationToken

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

Returns

A Response<T> describing the newly created share. If the share already exists, null.

Remarks

A RequestFailedException will be thrown if a failure occurs.

Applies to