(Perl) 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 Perl Downloads Perl Module for Windows, MacOS, Linux, Alpine Linux, Solaris

use chilkat();

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

$rest = chilkat::CkRest->new();

# 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
$bTls = 1;
$port = 443;
$bAutoReconnect = 1;
$success = $rest->Connect("myaccount.table.core.windows.net",$port,$bTls,$bAutoReconnect);
if ($success != 1) {
    print "ConnectFailReason: " . $rest->get_ConnectFailReason() . "\r\n";
    print $rest->lastErrorText() . "\r\n";
    exit;
}

# Provide Azure Cloud credentials for the REST call.
$azAuth = chilkat::CkAuthAzureStorage->new();
$azAuth->put_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->put_Account("myaccount");
$azAuth->put_Scheme("SharedKey");
$azAuth->put_Service("Table");

# This causes the "x-ms-version: 2019-07-07" header to be automatically added.
$azAuth->put_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"  
# }  

$json = chilkat::CkJsonObject->new();
$json->UpdateString("PartitionKey","mypartitionkey");
$json->UpdateString("RowKey","myrowkey");
$json->UpdateString("Timestamp","2013-08-22T01:12:06.2608595Z");
$json->UpdateString("Address","Mountain View");
$json->UpdateInt("Age",23);
$json->UpdateNumber("AmountDue","200.23");
$json->UpdateString("CustomerCode","c9da6455-213d-42c9-9a79-3e9149a57833");
$json->UpdateString("CustomerSince","2008-07-10T00:00:00");
$json->UpdateBool("IsActive",1);
$json->UpdateString("NumberOfOrders","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","application/json;odata=nometadata");
$rest->AddHeader("Prefer","return-no-content");
$rest->AddHeader("Content-Type","application/json");

$sbRequestBody = chilkat::CkStringBuilder->new();
$json->EmitSb($sbRequestBody);
$sbResponseBody = chilkat::CkStringBuilder->new();
# IMPORTANT: Change "mytable" to the name of your actual table.
$success = $rest->FullRequestSb("POST","/mytable",$sbRequestBody,$sbResponseBody);
if ($success != 1) {
    print $rest->lastErrorText() . "\r\n";
    exit;
}

# A status code of 204 is a success response for the case where Prefer=return-no-content.
$respStatusCode = $rest->get_ResponseStatusCode();
print "Response Status Code = " . $respStatusCode . "\r\n";
if ($respStatusCode >= 400) {
    print "Response Header:" . "\r\n";
    print $rest->responseHeader() . "\r\n";
    print "Response Body:" . "\r\n";
    print $sbResponseBody->getAsString() . "\r\n";
    exit;
}

print "Success." . "\r\n";