(Objective-C) Azure Table Insert Entity

See more Azure Table Service Examples

Insert an entity into an Azure table.

For more information, see https://docs.microsoft.com/en-us/rest/api/storageservices/insert-entity

Chilkat Objective-C Library Downloads MAC OS X (Cocoa) Libs iOS Libs

#import <CkoRest.h>
#import <CkoAuthAzureStorage.h>
#import <CkoJsonObject.h>
#import <CkoStringBuilder.h>

// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

CkoRest *rest = [[CkoRest alloc] init];
BOOL success;

// IMPORTANT: Make sure to change "myaccount" to your actual Azure Storage Account name.
// IMPORTANT: Also change "mytable" to the name of your Azure table.
// We're going to POST to this URL:  https://myaccount.table.core.windows.net/mytable
BOOL bTls = YES;
int port = 443;
BOOL bAutoReconnect = YES;
success = [rest Connect: @"myaccount.table.core.windows.net" port: [NSNumber numberWithInt: port] tls: bTls autoReconnect: bAutoReconnect];
if (success != YES) {
    NSLog(@"%@%d",@"ConnectFailReason: ",[rest.ConnectFailReason intValue]);
    NSLog(@"%@",rest.LastErrorText);
    return;
}

// Provide Azure Cloud credentials for the REST call.
CkoAuthAzureStorage *azAuth = [[CkoAuthAzureStorage alloc] init];
azAuth.AccessKey = @"AZURE_ACCESS_KEY";
// The account name used here should match the 1st part of the domain passed in the call to Connect (above).
azAuth.Account = @"myaccount";
azAuth.Scheme = @"SharedKey";
azAuth.Service = @"Table";

// This causes the "x-ms-version: 2019-07-07" header to be automatically added.
azAuth.XMsVersion = @"2019-07-07";
success = [rest SetAuthAzureStorage: azAuth];

// Note: The application does not need to explicitly set the following
// headers: Content-Length, x-ms-date, Authorization.  These headers
// are automatically set by Chilkat.

// 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.

// {  
//    "PartitionKey":"mypartitionkey",  
//    "RowKey":"myrowkey",  
//    "Timestamp":"2013-08-22T01:12:06.2608595Z",  
//    "Address":"Mountain View",  
//    "Age":23,  
//    "AmountDue":200.23,  
//    "CustomerCode":"c9da6455-213d-42c9-9a79-3e9149a57833",  
//    "CustomerSince":"2008-07-10T00:00:00",  
//    "IsActive":true,  
//    "NumberOfOrders":"255"  
// }  

CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"PartitionKey" value: @"mypartitionkey"];
[json UpdateString: @"RowKey" value: @"myrowkey"];
[json UpdateString: @"Timestamp" value: @"2013-08-22T01:12:06.2608595Z"];
[json UpdateString: @"Address" value: @"Mountain View"];
[json UpdateInt: @"Age" value: [NSNumber numberWithInt: 23]];
[json UpdateNumber: @"AmountDue" numericStr: @"200.23"];
[json UpdateString: @"CustomerCode" value: @"c9da6455-213d-42c9-9a79-3e9149a57833"];
[json UpdateString: @"CustomerSince" value: @"2008-07-10T00:00:00"];
[json UpdateBool: @"IsActive" value: YES];
[json UpdateString: @"NumberOfOrders" value: @"255"];

// IMPORTANT: Pay attention to the options for nometadata, minimalmetadata, or fullmetadata.
// See the Azure table service API documentation at https://docs.microsoft.com/en-us/rest/api/storageservices/insert-entity
[rest AddHeader: @"Accept" value: @"application/json;odata=nometadata"];
[rest AddHeader: @"Prefer" value: @"return-no-content"];
[rest AddHeader: @"Content-Type" value: @"application/json"];

CkoStringBuilder *sbRequestBody = [[CkoStringBuilder alloc] init];
[json EmitSb: sbRequestBody];
CkoStringBuilder *sbResponseBody = [[CkoStringBuilder alloc] init];
// IMPORTANT: Change "mytable" to the name of your actual table.
success = [rest FullRequestSb: @"POST" uriPath: @"/mytable" requestBody: sbRequestBody responseBody: sbResponseBody];
if (success != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

// A status code of 204 is a success response for the case where Prefer=return-no-content.
int respStatusCode = [rest.ResponseStatusCode intValue];
NSLog(@"%@%d",@"Response Status Code = ",respStatusCode);
if (respStatusCode >= 400) {
    NSLog(@"%@",@"Response Header:");
    NSLog(@"%@",rest.ResponseHeader);
    NSLog(@"%@",@"Response Body:");
    NSLog(@"%@",[sbResponseBody GetAsString]);
    return;
}

NSLog(@"%@",@"Success.");