Share via


StorageQueueCollection.CreateOrUpdate 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 Azure.ResourceManager.ArmOperation<Azure.ResourceManager.Storage.StorageQueueResource> CreateOrUpdate (Azure.WaitUntil waitUntil, string queueName, Azure.ResourceManager.Storage.StorageQueueData data, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateOrUpdate : Azure.WaitUntil * string * Azure.ResourceManager.Storage.StorageQueueData * System.Threading.CancellationToken -> Azure.ResourceManager.ArmOperation<Azure.ResourceManager.Storage.StorageQueueResource>
override this.CreateOrUpdate : Azure.WaitUntil * string * Azure.ResourceManager.Storage.StorageQueueData * System.Threading.CancellationToken -> Azure.ResourceManager.ArmOperation<Azure.ResourceManager.Storage.StorageQueueResource>
Public Overridable Function CreateOrUpdate (waitUntil As WaitUntil, queueName As String, data As StorageQueueData, Optional cancellationToken As CancellationToken = Nothing) As 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