(Visual FoxPro) Set Container ACL

Azure Storage Blob Service REST API: Sample code to set the permissions of a container.

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

LOCAL loRest
LOCAL lnBTls
LOCAL lnPort
LOCAL lnBAutoReconnect
LOCAL lnSuccess
LOCAL loAzAuth
LOCAL loPrng
LOCAL lcRandomId
LOCAL loDt
LOCAL lnBLocal
LOCAL lcCurDtStr
LOCAL lcExpireDtStr
LOCAL loXml
LOCAL loXSignedId
LOCAL loXAccessPolicy
LOCAL lcResponseStr

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

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Rest')
loRest = CreateObject('Chilkat.Rest')

* Connect to the Azure Storage Blob Service
lnBTls = 1
lnPort = 443
lnBAutoReconnect = 1
* In this example, the storage account name is "chilkat".
lnSuccess = loRest.Connect("chilkat.blob.core.windows.net",lnPort,lnBTls,lnBAutoReconnect)
IF (lnSuccess <> 1) THEN
    ? loRest.LastErrorText
    RELEASE loRest
    CANCEL
ENDIF

* Provide Azure Cloud credentials for the REST call.
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.AuthAzureStorage')
loAzAuth = CreateObject('Chilkat.AuthAzureStorage')
loAzAuth.AccessKey = "AZURE_ACCESS_KEY"
* The account name used here should match the 1st part of the domain passed in the call to Connect (above).
loAzAuth.Account = "chilkat"
loAzAuth.Scheme = "SharedKey"
loAzAuth.Service = "Blob"
* This causes the "x-ms-version: 2021-08-06" header to be automatically added.
loAzAuth.XMsVersion = "2021-08-06"
lnSuccess = loRest.SetAuthAzureStorage(loAzAuth)

* 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.
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Prng')
loPrng = CreateObject('Chilkat.Prng')
lcRandomId = loPrng.RandomString(32,1,1,1)

* Get the current system date/time in ISO 8061 format
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.CkDateTime')
loDt = CreateObject('Chilkat.CkDateTime')
loDt.SetFromCurrentSystemTime()
lnBLocal = 0
* Get the current date/time in ISO 8061 UTC format.
lcCurDtStr = loDt.GetAsTimestamp(lnBLocal)
* The expire time will be 365 days in the future.
lnSuccess = loDt.AddDays(365)
lcExpireDtStr = loDt.GetAsTimestamp(lnBLocal)

* Build the request:
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Xml')
loXml = CreateObject('Chilkat.Xml')
loXml.Tag = "SignedIdentifiers"
loXSignedId = loXml.NewChild("SignedIdentifier","")
loXSignedId.NewChild2("Id",lcRandomId)
loXAccessPolicy = loXSignedId.NewChild("AccessPolicy","")
loXAccessPolicy.NewChild2("Start",lcCurDtStr)
loXAccessPolicy.NewChild2("Expiry",lcExpireDtStr)
loXAccessPolicy.NewChild2("Permission","rwd")
RELEASE loXAccessPolicy
RELEASE loXSignedId

* Show the XML..
? loXml.GetXml()

* The expected response is a 200 response status code with no response body.
lcResponseStr = loRest.FullRequestString("PUT","/mycontainer?restype=container&comp=acl",loXml.GetXml())
IF (loRest.LastMethodSuccess <> 1) THEN
    ? loRest.LastErrorText
    RELEASE loRest
    RELEASE loAzAuth
    RELEASE loPrng
    RELEASE loDt
    RELEASE loXml
    CANCEL
ENDIF

* When successful, the Azure Storage service will respond with a 200 response status code,
* with no response body.

IF (loRest.ResponseStatusCode <> 200) THEN
    * Examine the request/response to see what happened.
    ? "response status code = " + STR(loRest.ResponseStatusCode)
    ? "response status text = " + loRest.ResponseStatusText
    ? "response header: " + loRest.ResponseHeader
    ? "response body (if any): " + lcResponseStr
    ? "---"
    ? "LastRequestStartLine: " + loRest.LastRequestStartLine
    ? "LastRequestHeader: " + loRest.LastRequestHeader
    RELEASE loRest
    RELEASE loAzAuth
    RELEASE loPrng
    RELEASE loDt
    RELEASE loXml
    CANCEL
ENDIF

? "Success."

RELEASE loRest
RELEASE loAzAuth
RELEASE loPrng
RELEASE loDt
RELEASE loXml