Share via


StorageQueueCollection.CreateOrUpdateAsync Method

Definition

Creates a new queue with the specified queue name, under the specified account.

  • Request Path. : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/queueServices/default/queues/{queueName}.
  • Operation Id. : StorageQueues_Create.
  • Default Api Version. : 2025-06-01.
public virtual System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.Storage.StorageQueueResource>> CreateOrUpdateAsync(Azure.WaitUntil waitUntil, string queueName, Azure.ResourceManager.Storage.StorageQueueData data, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateOrUpdateAsync : Azure.WaitUntil * string * Azure.ResourceManager.Storage.StorageQueueData * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.Storage.StorageQueueResource>>
override this.CreateOrUpdateAsync : Azure.WaitUntil * string * Azure.ResourceManager.Storage.StorageQueueData * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.Storage.StorageQueueResource>>
Public Overridable Function CreateOrUpdateAsync (waitUntil As WaitUntil, queueName As String, data As StorageQueueData, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ArmOperation(Of StorageQueueResource))

Parameters

waitUntil
WaitUntil

Completed if the method should wait to return until the long-running operation has completed on the service; Started if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples.

queueName
String

A queue name must be unique within a storage account and must be between 3 and 63 characters.The name must comprise of lowercase alphanumeric and dash(-) characters only, it should begin and end with an alphanumeric character and it cannot have two consecutive dash(-) characters.

data
StorageQueueData

Queue properties and metadata to be created with.

cancellationToken
CancellationToken

The cancellation token to use.

Returns

Exceptions

queueName or data is null.

queueName is an empty string, and was expected to be non-empty.

Applies to