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

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

    rest := chilkat.NewRest()

    // Connect to the Azure Storage Blob Service
    bTls := true
    port := 443
    bAutoReconnect := true
    // In this example, the storage account name is "chilkat".
    success := rest.Connect("chilkat.blob.core.windows.net",port,bTls,bAutoReconnect)
    if success != true {
        fmt.Println(rest.LastErrorText())
        rest.DisposeRest()
        return
    }

    // Provide Azure Cloud credentials for the REST call.
    azAuth := chilkat.NewAuthAzureStorage()
    azAuth.SetAccessKey("AZURE_ACCESS_KEY")
    // The account name used here should match the 1st part of the domain passed in the call to Connect (above).
    azAuth.SetAccount("chilkat")
    azAuth.SetScheme("SharedKey")
    azAuth.SetService("Blob")
    // This causes the "x-ms-version: 2020-08-04" header to be automatically added.
    azAuth.SetXMsVersion("2020-08-04")
    success = rest.SetAuthAzureStorage(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 lease ID needs to be a GUID.  (UUID and GUID are synonymous)
    crypt := chilkat.NewCrypt2()
    guid := crypt.GenerateUuid()
    fmt.Println("Lease ID: ", *guid)
    success = rest.AddHeader("x-ms-lease-id",*guid)

    // The action can be "acquire", "renew", "change", "release", or "break".
    // See https://msdn.microsoft.com/en-us/library/azure/jj159103.aspx
    success = rest.AddHeader("x-ms-lease-action","acquire")

    // The lease duration..
    success = rest.AddHeader("x-ms-lease-duration","15")

    // In this example, we are acquiring a lease for the container named "mycontainer".
    responseStr := rest.FullRequestNoBody("PUT","/mycontainer?restype=container&comp=lease")
    if rest.LastMethodSuccess() != true {
        fmt.Println(rest.LastErrorText())
        rest.DisposeRest()
        azAuth.DisposeAuthAzureStorage()
        crypt.DisposeCrypt2()
        return
    }

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

    if (rest.ResponseStatusCode() < 200) || (rest.ResponseStatusCode() > 202) {
        // Examine the request/response to see what happened.
        fmt.Println("response status code = ", rest.ResponseStatusCode())
        fmt.Println("response status text = ", rest.ResponseStatusText())
        fmt.Println("response header: ", rest.ResponseHeader())
        fmt.Println("response body (if any): ", *responseStr)
        fmt.Println("---")
        fmt.Println("LastRequestStartLine: ", rest.LastRequestStartLine())
        fmt.Println("LastRequestHeader: ", rest.LastRequestHeader())
        rest.DisposeRest()
        azAuth.DisposeAuthAzureStorage()
        crypt.DisposeCrypt2()
        return
    }

    fmt.Println("Success: Lease acquired.")

    rest.DisposeRest()
    azAuth.DisposeAuthAzureStorage()
    crypt.DisposeCrypt2()