CloudBlobContainer.CreateIfNotExistsAsync Method

Reference

Definition

Namespace:: Microsoft.Azure.Storage.Blob

Assembly:: Microsoft.Azure.Storage.Blob.dll

Package:: Microsoft.Azure.Storage.Blob v11.2.3

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Overloads

CreateIfNotExistsAsync()	Initiates an asynchronous operation that creates the container if it does not already exist.
CreateIfNotExistsAsync(CancellationToken)	Initiates an asynchronous operation that creates the container if it does not already exist.
CreateIfNotExistsAsync(BlobRequestOptions, OperationContext)	Initiates an asynchronous operation that creates the container if it does not already exist.
CreateIfNotExistsAsync(BlobContainerPublicAccessType, BlobRequestOptions, OperationContext)	Initiates an asynchronous operation that creates the container if it does not already exist.
CreateIfNotExistsAsync(BlobRequestOptions, OperationContext, CancellationToken)	Initiates an asynchronous operation that creates the container if it does not already exist.
CreateIfNotExistsAsync(BlobContainerPublicAccessType, BlobRequestOptions, OperationContext, CancellationToken)	Initiates an asynchronous operation that creates the container if it does not already exist.
CreateIfNotExistsAsync(BlobContainerPublicAccessType, BlobContainerEncryptionScopeOptions, BlobRequestOptions, OperationContext, CancellationToken)	Initiates an asynchronous operation that creates the container if it does not already exist.

CreateIfNotExistsAsync()

Initiates an asynchronous operation that creates the container if it does not already exist.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync ();

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member CreateIfNotExistsAsync : unit -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : unit -> System.Threading.Tasks.Task<bool>

Public Overridable Function CreateIfNotExistsAsync () As Task(Of Boolean)

Returns

Task<Boolean>

A Task<TResult> object that represents the asynchronous operation.

Attributes: DoesServiceRequestAttribute

Remarks

This API requires Create or Write permissions.

Applies to

CreateIfNotExistsAsync(CancellationToken)

Initiates an asynchronous operation that creates the container if it does not already exist.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (System.Threading.CancellationToken cancellationToken);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member CreateIfNotExistsAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function CreateIfNotExistsAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

Parameters

cancellationToken: CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

Task<Boolean>

A Task<TResult> object that represents the asynchronous operation.

Attributes: DoesServiceRequestAttribute

Remarks

This API requires Create or Write permissions.

Applies to

CreateIfNotExistsAsync(BlobRequestOptions, OperationContext)

Initiates an asynchronous operation that creates the container if it does not already exist.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member CreateIfNotExistsAsync : Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<bool>

Public Overridable Function CreateIfNotExistsAsync (options As BlobRequestOptions, operationContext As OperationContext) As Task(Of Boolean)

Parameters

options: BlobRequestOptions

A BlobRequestOptions object that specifies additional options for the request.

operationContext: OperationContext

An OperationContext object that represents the context for the current operation.

Returns

Task<Boolean>

A Task<TResult> object that represents the asynchronous operation.

Attributes: DoesServiceRequestAttribute

Remarks

This API requires Create or Write permissions.

Applies to

CreateIfNotExistsAsync(BlobContainerPublicAccessType, BlobRequestOptions, OperationContext)

Initiates an asynchronous operation that creates the container if it does not already exist.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Storage.Blob.BlobContainerPublicAccessType accessType, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member CreateIfNotExistsAsync : Microsoft.Azure.Storage.Blob.BlobContainerPublicAccessType * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Storage.Blob.BlobContainerPublicAccessType * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<bool>

Public Overridable Function CreateIfNotExistsAsync (accessType As BlobContainerPublicAccessType, options As BlobRequestOptions, operationContext As OperationContext) As Task(Of Boolean)

Parameters

accessType: BlobContainerPublicAccessType

An BlobContainerPublicAccessType object that specifies whether data in the container may be accessed publicly and the level of access.

options: BlobRequestOptions

A BlobRequestOptions object that specifies additional options for the request.

operationContext: OperationContext

An OperationContext object that represents the context for the current operation.

Returns

Task<Boolean>

A Task<TResult> object that represents the asynchronous operation.

Attributes: DoesServiceRequestAttribute

Remarks

This API requires Create or Write permissions.

Applies to

CreateIfNotExistsAsync(BlobRequestOptions, OperationContext, CancellationToken)

Initiates an asynchronous operation that creates the container if it does not already exist.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member CreateIfNotExistsAsync : Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function CreateIfNotExistsAsync (options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of Boolean)

Parameters

options: BlobRequestOptions

A BlobRequestOptions object that specifies additional options for the request.

operationContext: OperationContext

An OperationContext object that represents the context for the current operation.

cancellationToken: CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

Task<Boolean>

A Task<TResult> object that represents the asynchronous operation.

Attributes: DoesServiceRequestAttribute

Remarks

This API requires Create or Write permissions.

Applies to

CreateIfNotExistsAsync(BlobContainerPublicAccessType, BlobRequestOptions, OperationContext, CancellationToken)

Initiates an asynchronous operation that creates the container if it does not already exist.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Storage.Blob.BlobContainerPublicAccessType accessType, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member CreateIfNotExistsAsync : Microsoft.Azure.Storage.Blob.BlobContainerPublicAccessType * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Storage.Blob.BlobContainerPublicAccessType * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function CreateIfNotExistsAsync (accessType As BlobContainerPublicAccessType, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of Boolean)

Parameters

accessType: BlobContainerPublicAccessType

An BlobContainerPublicAccessType object that specifies whether data in the container may be accessed publicly and the level of access.

options: BlobRequestOptions

A BlobRequestOptions object that specifies additional options for the request.

operationContext: OperationContext

An OperationContext object that represents the context for the current operation.

cancellationToken: CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

Task<Boolean>

A Task<TResult> object that represents the asynchronous operation.

Attributes: DoesServiceRequestAttribute

Remarks

This API requires Create or Write permissions.

Applies to

CreateIfNotExistsAsync(BlobContainerPublicAccessType, BlobContainerEncryptionScopeOptions, BlobRequestOptions, OperationContext, CancellationToken)

Initiates an asynchronous operation that creates the container if it does not already exist.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<bool> CreateIfNotExistsAsync (Microsoft.Azure.Storage.Blob.BlobContainerPublicAccessType accessType, Microsoft.Azure.Storage.Blob.BlobContainerEncryptionScopeOptions encryptionScopeOptions, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member CreateIfNotExistsAsync : Microsoft.Azure.Storage.Blob.BlobContainerPublicAccessType * Microsoft.Azure.Storage.Blob.BlobContainerEncryptionScopeOptions * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.CreateIfNotExistsAsync : Microsoft.Azure.Storage.Blob.BlobContainerPublicAccessType * Microsoft.Azure.Storage.Blob.BlobContainerEncryptionScopeOptions * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function CreateIfNotExistsAsync (accessType As BlobContainerPublicAccessType, encryptionScopeOptions As BlobContainerEncryptionScopeOptions, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of Boolean)

Parameters

accessType: BlobContainerPublicAccessType

An BlobContainerPublicAccessType object that specifies whether data in the container may be accessed publicly and the level of access.

encryptionScopeOptions: BlobContainerEncryptionScopeOptions

An BlobContainerEncryptionScopeOptions object that specifies encryption scope options to set for this container.

options: BlobRequestOptions

A BlobRequestOptions object that specifies additional options for the request.

operationContext: OperationContext

An OperationContext object that represents the context for the current operation.

cancellationToken: CancellationToken

A CancellationToken to observe while waiting for a task to complete.

Returns

Task<Boolean>

A Task<TResult> object that represents the asynchronous operation.

Attributes: DoesServiceRequestAttribute

Remarks

This API requires Create or Write permissions.

Applies to

Share via

CloudBlobContainer.CreateIfNotExistsAsync Method

Definition

Overloads

CreateIfNotExistsAsync()

Returns

Remarks

Applies to

CreateIfNotExistsAsync(CancellationToken)

Parameters

Returns

Remarks

Applies to

CreateIfNotExistsAsync(BlobRequestOptions, OperationContext)

Parameters

Returns

Remarks

Applies to

CreateIfNotExistsAsync(BlobContainerPublicAccessType, BlobRequestOptions, OperationContext)

Parameters

Returns

Remarks

Applies to

CreateIfNotExistsAsync(BlobRequestOptions, OperationContext, CancellationToken)

Parameters

Returns

Remarks

Applies to

CreateIfNotExistsAsync(BlobContainerPublicAccessType, BlobRequestOptions, OperationContext, CancellationToken)

Parameters

Returns

Remarks

Applies to

CreateIfNotExistsAsync(BlobContainerPublicAccessType, BlobContainerEncryptionScopeOptions, BlobRequestOptions, OperationContext, CancellationToken)

Parameters

Returns

Remarks

Applies to

Additional resources