TableCollection.CreateOrUpdateAsync Method

Definition

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

  • Request Path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/tableServices/default/tables/{tableName}
  • Operation Id: Table_Create
  • Default Api Version: 2022-09-01
  • Resource: TableResource
public virtual System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.Storage.TableResource>> CreateOrUpdateAsync (Azure.WaitUntil waitUntil, string tableName, Azure.ResourceManager.Storage.TableData data, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateOrUpdateAsync : Azure.WaitUntil * string * Azure.ResourceManager.Storage.TableData * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.Storage.TableResource>>
override this.CreateOrUpdateAsync : Azure.WaitUntil * string * Azure.ResourceManager.Storage.TableData * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.Storage.TableResource>>
Public Overridable Function CreateOrUpdateAsync (waitUntil As WaitUntil, tableName As String, data As TableData, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ArmOperation(Of TableResource))

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.

tableName
String

A table name must be unique within a storage account and must be between 3 and 63 characters.The name must comprise of only alphanumeric characters and it cannot begin with a numeric character.

data
TableData

The parameters to provide to create a table.

cancellationToken
CancellationToken

The cancellation token to use.

Returns

Exceptions

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

tableName or data is null.

Applies to