ShareClient.CreateIfNotExistsAsync Method

Definition

Namespace:

Azure.Storage.Files.Shares

Assembly:

Azure.Storage.Files.Shares.dll

Package:

Azure.Storage.Files.Shares v12.17.1

Overloads

CreateIfNotExistsAsync(IDictionary<String,String>, Nullable<Int32>, CancellationToken)	The CreateIfNotExistsAsync(IDictionary<String,String>, Nullable<Int32>, 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.
CreateIfNotExistsAsync(ShareCreateOptions, CancellationToken)	The CreateIfNotExistsAsync(IDictionary<String,String>, Nullable<Int32>, 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.

CreateIfNotExistsAsync(IDictionary<String,String>, Nullable<Int32>, CancellationToken)

Source:

ShareClient.cs

The CreateIfNotExistsAsync(IDictionary<String,String>, Nullable<Int32>, 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 (System.Collections.Generic.IDictionary<string,string> metadata = default, int? quotaInGB = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateIfNotExistsAsync : System.Collections.Generic.IDictionary<string, string> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.Models.ShareInfo>>
override this.CreateIfNotExistsAsync : System.Collections.Generic.IDictionary<string, string> * Nullable<int> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.Models.ShareInfo>>

Public Overridable Function CreateIfNotExistsAsync (Optional metadata As IDictionary(Of String, String) = Nothing, Optional quotaInGB As Nullable(Of Integer) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of ShareInfo))

Parameters

metadata

IDictionary<String,String>

Optional custom metadata to set for this share.

quotaInGB

Nullable<Int32>

Optional. Maximum size of the share in bytes. If unspecified, use the service's default value.

cancellationToken

CancellationToken

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

Returns

Task<Response<ShareInfo>>

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

Remarks

A RequestFailedException will be thrown if a failure occurs.

CreateIfNotExistsAsync(ShareCreateOptions, CancellationToken)

Source:

ShareClient.cs

The CreateIfNotExistsAsync(IDictionary<String,String>, Nullable<Int32>, 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, 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 (options As ShareCreateOptions, 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

Task<Response<ShareInfo>>

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

Remarks

A RequestFailedException will be thrown if a failure occurs.