C
C
Set Container ACL
See more Azure Cloud Storage Examples
Azure Storage Blob Service REST API: Sample code to set the permissions of a container.Chilkat C Downloads
#include <C_CkRest.h>
#include <C_CkAuthAzureStorage.h>
#include <C_CkPrng.h>
#include <C_CkDateTime.h>
#include <C_CkXml.h>
void ChilkatSample(void)
{
BOOL success;
HCkRest rest;
BOOL bTls;
int port;
BOOL bAutoReconnect;
HCkAuthAzureStorage azAuth;
HCkPrng prng;
const char *randomId;
HCkDateTime dt;
BOOL bLocal;
const char *curDtStr;
const char *expireDtStr;
HCkXml xml;
HCkXml xSignedId;
HCkXml xAccessPolicy;
const char *responseStr;
success = FALSE;
// Azure Blob Service Example: Set Container ACL
// See also: https://msdn.microsoft.com/en-us/library/azure/dd179391.aspx
// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
rest = CkRest_Create();
// Connect to the Azure Storage Blob Service
bTls = TRUE;
port = 443;
bAutoReconnect = TRUE;
// In this example, the storage account name is "chilkat".
success = CkRest_Connect(rest,"chilkat.blob.core.windows.net",port,bTls,bAutoReconnect);
if (success != TRUE) {
printf("%s\n",CkRest_lastErrorText(rest));
CkRest_Dispose(rest);
return;
}
// Provide Azure Cloud credentials for the REST call.
azAuth = CkAuthAzureStorage_Create();
CkAuthAzureStorage_putAccessKey(azAuth,"AZURE_ACCESS_KEY");
// The account name used here should match the 1st part of the domain passed in the call to Connect (above).
CkAuthAzureStorage_putAccount(azAuth,"chilkat");
CkAuthAzureStorage_putScheme(azAuth,"SharedKey");
CkAuthAzureStorage_putService(azAuth,"Blob");
// This causes the "x-ms-version: 2021-08-06" header to be automatically added.
CkAuthAzureStorage_putXMsVersion(azAuth,"2021-08-06");
success = CkRest_SetAuthAzureStorage(rest,azAuth);
// Note: The application does not need to explicitly set the following
// headers: x-ms-date, Authorization. These headers
// are automatically set by Chilkat.
// The XML body of the request will look like this:
// <?xml version="1.0" encoding="utf-8"?>
// <SignedIdentifiers>
// <SignedIdentifier>
// <Id>unique-character-value-of-up-to-64-chars</Id>
// <AccessPolicy>
// <Start>start-time</Start>
// <Expiry>expiry-time</Expiry>
// <Permission>abbreviated-permission-list</Permission>
// </AccessPolicy>
// </SignedIdentifier>
// </SignedIdentifiers>
// Generate a random 32-character string.
prng = CkPrng_Create();
randomId = CkPrng_randomString(prng,32,TRUE,TRUE,TRUE);
// Get the current system date/time in ISO 8061 format
dt = CkDateTime_Create();
CkDateTime_SetFromCurrentSystemTime(dt);
bLocal = FALSE;
// Get the current date/time in ISO 8061 UTC format.
curDtStr = CkDateTime_getAsTimestamp(dt,bLocal);
// The expire time will be 365 days in the future.
success = CkDateTime_AddDays(dt,365);
expireDtStr = CkDateTime_getAsTimestamp(dt,bLocal);
// Build the request:
xml = CkXml_Create();
CkXml_putTag(xml,"SignedIdentifiers");
xSignedId = CkXml_NewChild(xml,"SignedIdentifier","");
CkXml_NewChild2(xSignedId,"Id",randomId);
xAccessPolicy = CkXml_NewChild(xSignedId,"AccessPolicy","");
CkXml_NewChild2(xAccessPolicy,"Start",curDtStr);
CkXml_NewChild2(xAccessPolicy,"Expiry",expireDtStr);
CkXml_NewChild2(xAccessPolicy,"Permission","rwd");
CkXml_Dispose(xAccessPolicy);
CkXml_Dispose(xSignedId);
// Show the XML..
printf("%s\n",CkXml_getXml(xml));
// The expected response is a 200 response status code with no response body.
responseStr = CkRest_fullRequestString(rest,"PUT","/mycontainer?restype=container&comp=acl",CkXml_getXml(xml));
if (CkRest_getLastMethodSuccess(rest) != TRUE) {
printf("%s\n",CkRest_lastErrorText(rest));
CkRest_Dispose(rest);
CkAuthAzureStorage_Dispose(azAuth);
CkPrng_Dispose(prng);
CkDateTime_Dispose(dt);
CkXml_Dispose(xml);
return;
}
// When successful, the Azure Storage service will respond with a 200 response status code,
// with no response body.
if (CkRest_getResponseStatusCode(rest) != 200) {
// Examine the request/response to see what happened.
printf("response status code = %d\n",CkRest_getResponseStatusCode(rest));
printf("response status text = %s\n",CkRest_responseStatusText(rest));
printf("response header: %s\n",CkRest_responseHeader(rest));
printf("response body (if any): %s\n",responseStr);
printf("---\n");
printf("LastRequestStartLine: %s\n",CkRest_lastRequestStartLine(rest));
printf("LastRequestHeader: %s\n",CkRest_lastRequestHeader(rest));
CkRest_Dispose(rest);
CkAuthAzureStorage_Dispose(azAuth);
CkPrng_Dispose(prng);
CkDateTime_Dispose(dt);
CkXml_Dispose(xml);
return;
}
printf("Success.\n");
CkRest_Dispose(rest);
CkAuthAzureStorage_Dispose(azAuth);
CkPrng_Dispose(prng);
CkDateTime_Dispose(dt);
CkXml_Dispose(xml);
}