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: Queue_Create
  • Default Api Version: 2023-05-01
  • Resource: StorageQueueResource
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 is an empty string, and was expected to be non-empty.

queueName or data is null.

Applies to