CloudTable.CreateIfNotExists Method

Definition

Namespace:

Microsoft.Azure.Cosmos.Table

Assembly:

Microsoft.Azure.Cosmos.Table.dll

Package:

Microsoft.Azure.Cosmos.Table v1.0.8

Overloads

CreateIfNotExists(TableRequestOptions, OperationContext, String, Nullable<Int32>, Nullable<Int32>)	Creates the table if it does not already exist.
CreateIfNotExists(IndexingMode, Nullable<Int32>, Nullable<Int32>)	Creates the table if it does not already exist.

CreateIfNotExists(TableRequestOptions, OperationContext, String, Nullable<Int32>, Nullable<Int32>)

Creates the table if it does not already exist.

public virtual bool CreateIfNotExists (Microsoft.Azure.Cosmos.Table.TableRequestOptions requestOptions = default, Microsoft.Azure.Cosmos.Table.OperationContext operationContext = default, string serializedIndexingPolicy = default, int? throughput = default, int? defaultTimeToLive = default);

abstract member CreateIfNotExists : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * string * Nullable<int> * Nullable<int> -> bool
override this.CreateIfNotExists : Microsoft.Azure.Cosmos.Table.TableRequestOptions * Microsoft.Azure.Cosmos.Table.OperationContext * string * Nullable<int> * Nullable<int> -> bool

Public Overridable Function CreateIfNotExists (Optional requestOptions As TableRequestOptions = Nothing, Optional operationContext As OperationContext = Nothing, Optional serializedIndexingPolicy As String = Nothing, Optional throughput As Nullable(Of Integer) = Nothing, Optional defaultTimeToLive As Nullable(Of Integer) = Nothing) As Boolean

Parameters

requestOptions

TableRequestOptions

A TableRequestOptions object that specifies additional options for the request.

operationContext

OperationContext

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

serializedIndexingPolicy

String

CosmosDB table indexing policy.

throughput

Nullable<Int32>

CosmosDB table throughput.

defaultTimeToLive

Nullable<Int32>

CosmosDB table time to live in seconds. Null implies TTL is off, -1 equals TTL is on and retain rows indefinitely, any other value sets TTL.

Returns

Boolean

true if table was created; otherwise, false.

Remarks

This API performs an existence check and therefore requires list permissions.

CreateIfNotExists(IndexingMode, Nullable<Int32>, Nullable<Int32>)

Creates the table if it does not already exist.

public virtual bool CreateIfNotExists (Microsoft.Azure.Cosmos.IndexingMode indexingMode, int? throughput = default, int? defaultTimeToLive = default);

abstract member CreateIfNotExists : Microsoft.Azure.Cosmos.IndexingMode * Nullable<int> * Nullable<int> -> bool
override this.CreateIfNotExists : Microsoft.Azure.Cosmos.IndexingMode * Nullable<int> * Nullable<int> -> bool

Public Overridable Function CreateIfNotExists (indexingMode As IndexingMode, Optional throughput As Nullable(Of Integer) = Nothing, Optional defaultTimeToLive As Nullable(Of Integer) = Nothing) As Boolean

Parameters

indexingMode

IndexingMode

CosmosDB table indexing mode

throughput

Nullable<Int32>

CosmosDB table throughput.

defaultTimeToLive

Nullable<Int32>

CosmosDB table time to live in seconds. Null implies TTL is off, -1 equals TTL is on and retain rows indefinitely, any other value sets TTL.

Returns

Boolean

true if table was created; otherwise, false.

Remarks

This API performs an existence check and therefore requires list permissions.