(DataFlex) Azure Storage: Lease Container

Azure Storage Blob Service REST API: Sample code to establishes a lock on a container for delete operations. The lock duration can be 15 to 60 seconds, or can be infinite.

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

Use ChilkatAx-win32.pkg

Procedure Test
    Handle hoRest
    Boolean iBTls
    Integer iPort
    Boolean iBAutoReconnect
    Boolean iSuccess
    Variant vAzAuth
    Handle hoAzAuth
    Handle hoCrypt
    String sGuid
    String sResponseStr
    String sTemp1
    Integer iTemp1
    Integer iTemp2
    Boolean bTemp1

    // Azure Blob Service Example: Lease Container
    // See also: https://msdn.microsoft.com/en-us/library/azure/jj159103.aspx

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

    Get Create (RefClass(cComChilkatRest)) To hoRest
    If (Not(IsComObjectCreated(hoRest))) Begin
        Send CreateComObject of hoRest
    End

    // Connect to the Azure Storage Blob Service
    Move True To iBTls
    Move 443 To iPort
    Move True To iBAutoReconnect
    // In this example, the storage account name is "chilkat".
    Get ComConnect Of hoRest "chilkat.blob.core.windows.net" iPort iBTls iBAutoReconnect To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoRest To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // Provide Azure Cloud credentials for the REST call.
    Get Create (RefClass(cComChilkatAuthAzureStorage)) To hoAzAuth
    If (Not(IsComObjectCreated(hoAzAuth))) Begin
        Send CreateComObject of hoAzAuth
    End
    Set ComAccessKey Of hoAzAuth To "AZURE_ACCESS_KEY"
    // The account name used here should match the 1st part of the domain passed in the call to Connect (above).
    Set ComAccount Of hoAzAuth To "chilkat"
    Set ComScheme Of hoAzAuth To "SharedKey"
    Set ComService Of hoAzAuth To "Blob"
    // This causes the "x-ms-version: 2021-08-06" header to be automatically added.
    Set ComXMsVersion Of hoAzAuth To "2021-08-06"
    Get pvComObject of hoAzAuth to vAzAuth
    Get ComSetAuthAzureStorage Of hoRest vAzAuth To iSuccess

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

    // The lease ID needs to be a GUID.  (UUID and GUID are synonymous)
    Get Create (RefClass(cComChilkatCrypt2)) To hoCrypt
    If (Not(IsComObjectCreated(hoCrypt))) Begin
        Send CreateComObject of hoCrypt
    End
    Get ComGenerateUuid Of hoCrypt To sGuid
    Showln "Lease ID: " sGuid
    Get ComAddHeader Of hoRest "x-ms-lease-id" sGuid To iSuccess

    // The action can be "acquire", "renew", "change", "release", or "break".
    // See https://msdn.microsoft.com/en-us/library/azure/jj159103.aspx
    Get ComAddHeader Of hoRest "x-ms-lease-action" "acquire" To iSuccess

    // The lease duration..
    Get ComAddHeader Of hoRest "x-ms-lease-duration" "15" To iSuccess

    // In this example, we are acquiring a lease for the container named "mycontainer".
    Get ComFullRequestNoBody Of hoRest "PUT" "/mycontainer?restype=container&comp=lease" To sResponseStr
    Get ComLastMethodSuccess Of hoRest To bTemp1
    If (bTemp1 <> True) Begin
        Get ComLastErrorText Of hoRest To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // When successful, the Azure Storage service will respond with a 200, 201, or 202 response status code,
    // with no response body.

    // The status code depends on the operation:
    //    Acquire: A successful operation returns status code 201 (Created).
    //    Renew: A successful operation returns status code 200 (OK).
    //    Change: A successful operation returns status code 200 (OK).
    //    Release: A successful operation returns status code 200 (OK).
    //    Break: A successful operation returns status code 202 (Accepted).

    Get ComResponseStatusCode Of hoRest To iTemp1
    Get ComResponseStatusCode Of hoRest To iTemp2
    If ((iTemp1 < 200) Or (iTemp2 > 202)) Begin
        // Examine the request/response to see what happened.
        Get ComResponseStatusCode Of hoRest To iTemp1
        Showln "response status code = " iTemp1
        Get ComResponseStatusText Of hoRest To sTemp1
        Showln "response status text = " sTemp1
        Get ComResponseHeader Of hoRest To sTemp1
        Showln "response header: " sTemp1
        Showln "response body (if any): " sResponseStr
        Showln "---"
        Get ComLastRequestStartLine Of hoRest To sTemp1
        Showln "LastRequestStartLine: " sTemp1
        Get ComLastRequestHeader Of hoRest To sTemp1
        Showln "LastRequestHeader: " sTemp1
        Procedure_Return
    End

    Showln "Success: Lease acquired."


End_Procedure