(VB.NET) DynamoDB - CreateTable

The CreateTable operation adds a new table to your account. In an AWS account, table names must be unique within each Region. That is, you can have two tables with same name if you create the tables in different Regions.

CreateTable is an asynchronous operation. Upon receiving a CreateTable request, DynamoDB immediately returns a response with a TableStatus of CREATING. After the table is created, DynamoDB sets the TableStatus to ACTIVE. You can perform read and write operations only on an ACTIVE table.

You can use the DescribeTable action to check the table status.

For more information, see https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html

Chilkat .NET Downloads Chilkat .NET Framework Chilkat for .NET Core

Dim rest As New Chilkat.Rest
Dim success As Boolean

' Implements the following CURL command:

' curl -X POST https://dynamodb.us-west-2.amazonaws.com/ \
'   -H "Accept-Encoding: identity" \
'   -H "Content-Type: application/x-amz-json-1.0" \
'   -H "Authorization: AWS4-HMAC-SHA256 Credential=<Credential>, SignedHeaders=<Headers>, Signature=<Signature>" \
'   -H "X-Amz-Date: <Date>" \
'   -H "X-Amz-Target: DynamoDB_20120810.CreateTable" \
'   -d '{
'     "AttributeDefinitions": [
'         {
'             "AttributeName": "ForumName",
'             "AttributeType": "S"
'         },
'         {
'             "AttributeName": "Subject",
'             "AttributeType": "S"
'         },
'         {
'             "AttributeName": "LastPostDateTime",
'             "AttributeType": "S"
'         }
'     ],
'     "TableName": "Thread",
'     "KeySchema": [
'         {
'             "AttributeName": "ForumName",
'             "KeyType": "HASH"
'         },
'         {
'             "AttributeName": "Subject",
'             "KeyType": "RANGE"
'         }
'     ],
'     "LocalSecondaryIndexes": [
'         {
'             "IndexName": "LastPostIndex",
'             "KeySchema": [
'                 {
'                     "AttributeName": "ForumName",
'                     "KeyType": "HASH"
'                 },
'                 {
'                     "AttributeName": "LastPostDateTime",
'                     "KeyType": "RANGE"
'                 }
'             ],
'             "Projection": {
'                 "ProjectionType": "KEYS_ONLY"
'             }
'         }
'     ],
'     "ProvisionedThroughput": {
'         "ReadCapacityUnits": 5,
'         "WriteCapacityUnits": 5
'     },
'     "Tags": [ 
'       { 
'          "Key": "Owner",
'          "Value": "BlueTeam"
'       }
'    ]
' }'

' Use the following online tool to generate REST code from a CURL command
' Convert a cURL Command to REST Source Code

Dim authAws As New Chilkat.AuthAws
authAws.AccessKey = "AWS_ACCESS_KEY"
authAws.SecretKey = "AWS_SECRET_KEY"
' Don't forget to change the region to your particular region. (Also make the same change in the call to Connect below.)
authAws.Region = "us-west-2"
authAws.ServiceName = "dynamodb"
' SetAuthAws causes Chilkat to automatically add the following headers: Authorization, X-Amz-Date
rest.SetAuthAws(authAws)

' URL: https://dynamodb.us-west-2.amazonaws.com/
Dim bTls As Boolean = True
Dim port As Integer = 443
Dim bAutoReconnect As Boolean = True
' Don't forget to change the region domain (us-west-2.amazonaws.com) to your particular region.
success = rest.Connect("dynamodb.us-west-2.amazonaws.com",port,bTls,bAutoReconnect)
If (success <> True) Then
    Debug.WriteLine("ConnectFailReason: " & rest.ConnectFailReason)
    Debug.WriteLine(rest.LastErrorText)
    Exit Sub
End If


' Note: The above code does not need to be repeatedly called for each REST request.
' The rest object can be setup once, and then many requests can be sent.  Chilkat will automatically
' reconnect within a FullRequest* method as needed.  It is only the very first connection that is explicitly
' made via the Connect method.

' Use this online tool to generate code from sample JSON:
' Generate Code to Create JSON

' The following JSON is sent in the request body.

' {
'   "AttributeDefinitions": [
'     {
'       "AttributeName": "ForumName",
'       "AttributeType": "S"
'     },
'     {
'       "AttributeName": "Subject",
'       "AttributeType": "S"
'     },
'     {
'       "AttributeName": "LastPostDateTime",
'       "AttributeType": "S"
'     }
'   ],
'   "TableName": "Thread",
'   "KeySchema": [
'     {
'       "AttributeName": "ForumName",
'       "KeyType": "HASH"
'     },
'     {
'       "AttributeName": "Subject",
'       "KeyType": "RANGE"
'     }
'   ],
'   "LocalSecondaryIndexes": [
'     {
'       "IndexName": "LastPostIndex",
'       "KeySchema": [
'         {
'           "AttributeName": "ForumName",
'           "KeyType": "HASH"
'         },
'         {
'           "AttributeName": "LastPostDateTime",
'           "KeyType": "RANGE"
'         }
'       ],
'       "Projection": {
'         "ProjectionType": "KEYS_ONLY"
'       }
'     }
'   ],
'   "ProvisionedThroughput": {
'     "ReadCapacityUnits": 5,
'     "WriteCapacityUnits": 5
'   },
'   "Tags": [
'     {
'       "Key": "Owner",
'       "Value": "BlueTeam"
'     }
'   ]
' }

Dim json As New Chilkat.JsonObject
Dim i As Integer = 0
json.I = i
json.UpdateString("AttributeDefinitions[i].AttributeName","ForumName")
json.UpdateString("AttributeDefinitions[i].AttributeType","S")
i = i + 1
json.I = i
json.UpdateString("AttributeDefinitions[i].AttributeName","Subject")
json.UpdateString("AttributeDefinitions[i].AttributeType","S")
i = i + 1
json.I = i
json.UpdateString("AttributeDefinitions[i].AttributeName","LastPostDateTime")
json.UpdateString("AttributeDefinitions[i].AttributeType","S")
json.UpdateString("TableName","Thread")
i = 0
json.I = i
json.UpdateString("KeySchema[i].AttributeName","ForumName")
json.UpdateString("KeySchema[i].KeyType","HASH")
i = i + 1
json.I = i
json.UpdateString("KeySchema[i].AttributeName","Subject")
json.UpdateString("KeySchema[i].KeyType","RANGE")

i = 0
json.I = i
Dim j As Integer = 0
json.J = j
json.UpdateString("LocalSecondaryIndexes[i].IndexName","LastPostIndex")
json.UpdateString("LocalSecondaryIndexes[i].KeySchema[j].AttributeName","ForumName")
json.UpdateString("LocalSecondaryIndexes[i].KeySchema[j].KeyType","HASH")
j = j + 1
json.J = j
json.UpdateString("LocalSecondaryIndexes[i].KeySchema[j].AttributeName","LastPostDateTime")
json.UpdateString("LocalSecondaryIndexes[i].KeySchema[j].KeyType","RANGE")
json.UpdateString("LocalSecondaryIndexes[i].Projection.ProjectionType","KEYS_ONLY")
json.UpdateInt("ProvisionedThroughput.ReadCapacityUnits",5)
json.UpdateInt("ProvisionedThroughput.WriteCapacityUnits",5)
json.UpdateString("Tags[0].Key","Owner")
json.UpdateString("Tags[0].Value","BlueTeam")

rest.AddHeader("Content-Type","application/x-amz-json-1.0")
rest.AddHeader("X-Amz-Target","DynamoDB_20120810.CreateTable")
rest.AddHeader("Accept-Encoding","identity")

Dim sbRequestBody As New Chilkat.StringBuilder
json.EmitSb(sbRequestBody)
Dim sbResponseBody As New Chilkat.StringBuilder
success = rest.FullRequestSb("POST","/",sbRequestBody,sbResponseBody)
If (success <> True) Then
    Debug.WriteLine(rest.LastErrorText)
    Exit Sub
End If

Dim respStatusCode As Integer = rest.ResponseStatusCode
Debug.WriteLine("response status code = " & respStatusCode)

If (respStatusCode >= 400) Then
    Debug.WriteLine("Response Status Code = " & respStatusCode)
    Debug.WriteLine("Response Header:")
    Debug.WriteLine(rest.ResponseHeader)
    Debug.WriteLine("Response Body:")
    Debug.WriteLine(sbResponseBody.GetAsString())
    Exit Sub
End If


Dim jsonResponse As New Chilkat.JsonObject
jsonResponse.LoadSb(sbResponseBody)

jsonResponse.EmitCompact = False
Debug.WriteLine(jsonResponse.Emit())

' Sample Response:

'  {
'     "TableDescription": {
'         "TableArn": "arn:aws:dynamodb:us-west-2:123456789012:table/Thread",
'         "AttributeDefinitions": [
'             {
'                 "AttributeName": "ForumName",
'                 "AttributeType": "S"
'             },
'             {
'                 "AttributeName": "LastPostDateTime",
'                 "AttributeType": "S"
'             },
'             {
'                 "AttributeName": "Subject",
'                 "AttributeType": "S"
'             }
'         ],
'         "CreationDateTime": 1.36372808007E9,
'         "ItemCount": 0,
'         "KeySchema": [
'             {
'                 "AttributeName": "ForumName",
'                 "KeyType": "HASH"
'             },
'             {
'                 "AttributeName": "Subject",
'                 "KeyType": "RANGE"
'             }
'         ],
'         "LocalSecondaryIndexes": [
'             {
'                 "IndexArn": "arn:aws:dynamodb:us-west-2:123456789012:table/Thread/index/LastPostIndex",
'                 "IndexName": "LastPostIndex",
'                 "IndexSizeBytes": 0,
'                 "ItemCount": 0,
'                 "KeySchema": [
'                     {
'                         "AttributeName": "ForumName",
'                         "KeyType": "HASH"
'                     },
'                     {
'                         "AttributeName": "LastPostDateTime",
'                         "KeyType": "RANGE"
'                     }
'                 ],
'                 "Projection": {
'                     "ProjectionType": "KEYS_ONLY"
'                 }
'             }
'         ],
'         "ProvisionedThroughput": {
'             "NumberOfDecreasesToday": 0,
'             "ReadCapacityUnits": 5,
'             "WriteCapacityUnits": 5
'         },
'         "TableName": "Thread",
'         "TableSizeBytes": 0,
'         "TableStatus": "CREATING"
'     }
' }


' Sample code for parsing the JSON response...
' Use the following online tool to generate parsing code from sample JSON:
' Generate Parsing Code from JSON




Dim AttributeName As String
Dim AttributeType As String
Dim KeyType As String
Dim IndexArn As String
Dim IndexName As String
Dim IndexSizeBytes As Integer
Dim ItemCount As Integer
Dim ProjectionProjectionType As String
Dim count_j As Integer

Dim TableDescriptionTableArn As String = jsonResponse.StringOf("TableDescription.TableArn")
Dim TableDescriptionCreationDateTime As String = jsonResponse.StringOf("TableDescription.CreationDateTime")
Dim TableDescriptionItemCount As Integer = jsonResponse.IntOf("TableDescription.ItemCount")
Dim TableDescriptionProvisionedThroughputNumberOfDecreasesToday As Integer = jsonResponse.IntOf("TableDescription.ProvisionedThroughput.NumberOfDecreasesToday")
Dim TableDescriptionProvisionedThroughputReadCapacityUnits As Integer = jsonResponse.IntOf("TableDescription.ProvisionedThroughput.ReadCapacityUnits")
Dim TableDescriptionProvisionedThroughputWriteCapacityUnits As Integer = jsonResponse.IntOf("TableDescription.ProvisionedThroughput.WriteCapacityUnits")
Dim TableDescriptionTableName As String = jsonResponse.StringOf("TableDescription.TableName")
Dim TableDescriptionTableSizeBytes As Integer = jsonResponse.IntOf("TableDescription.TableSizeBytes")
Dim TableDescriptionTableStatus As String = jsonResponse.StringOf("TableDescription.TableStatus")
i = 0
Dim count_i As Integer = jsonResponse.SizeOfArray("TableDescription.AttributeDefinitions")
While i < count_i
    jsonResponse.I = i
    AttributeName = jsonResponse.StringOf("TableDescription.AttributeDefinitions[i].AttributeName")
    AttributeType = jsonResponse.StringOf("TableDescription.AttributeDefinitions[i].AttributeType")
    i = i + 1
End While
i = 0
count_i = jsonResponse.SizeOfArray("TableDescription.KeySchema")
While i < count_i
    jsonResponse.I = i
    AttributeName = jsonResponse.StringOf("TableDescription.KeySchema[i].AttributeName")
    KeyType = jsonResponse.StringOf("TableDescription.KeySchema[i].KeyType")
    i = i + 1
End While
i = 0
count_i = jsonResponse.SizeOfArray("TableDescription.LocalSecondaryIndexes")
While i < count_i
    jsonResponse.I = i
    IndexArn = jsonResponse.StringOf("TableDescription.LocalSecondaryIndexes[i].IndexArn")
    IndexName = jsonResponse.StringOf("TableDescription.LocalSecondaryIndexes[i].IndexName")
    IndexSizeBytes = jsonResponse.IntOf("TableDescription.LocalSecondaryIndexes[i].IndexSizeBytes")
    ItemCount = jsonResponse.IntOf("TableDescription.LocalSecondaryIndexes[i].ItemCount")
    ProjectionProjectionType = jsonResponse.StringOf("TableDescription.LocalSecondaryIndexes[i].Projection.ProjectionType")
    j = 0
    count_j = jsonResponse.SizeOfArray("TableDescription.LocalSecondaryIndexes[i].KeySchema")
    While j < count_j
        jsonResponse.J = j
        AttributeName = jsonResponse.StringOf("TableDescription.LocalSecondaryIndexes[i].KeySchema[j].AttributeName")
        KeyType = jsonResponse.StringOf("TableDescription.LocalSecondaryIndexes[i].KeySchema[j].KeyType")
        j = j + 1
    End While
    i = i + 1
End While