Swift

Azure Storage: Lease Container

See more Azure Cloud Storage Examples

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

func chilkatTest() {
    var success: Bool = false

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

    let rest = CkoRest()!

    // Connect to the Azure Storage Blob Service
    var bTls: Bool = true
    var port: Int = 443
    var bAutoReconnect: Bool = true
    // In this example, the storage account name is "chilkat".
    success = rest.connect(hostname: "chilkat.blob.core.windows.net", port: port, tls: bTls, autoReconnect: bAutoReconnect)
    if success != true {
        print("\(rest.lastErrorText!)")
        return
    }

    // Provide Azure Cloud credentials for the REST call.
    let azAuth = CkoAuthAzureStorage()!
    azAuth.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.account = "chilkat"
    azAuth.scheme = "SharedKey"
    azAuth.service = "Blob"
    // This causes the "x-ms-version: 2021-08-06" header to be automatically added.
    azAuth.xMsVersion = "2021-08-06"
    success = rest.setAuthAzureStorage(authProvider: 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)
    let crypt = CkoCrypt2()!
    var guid: String? = crypt.generateUuid()
    print("Lease ID: \(guid!)")
    success = rest.addHeader(name: "x-ms-lease-id", value: 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(name: "x-ms-lease-action", value: "acquire")

    // The lease duration..
    success = rest.addHeader(name: "x-ms-lease-duration", value: "15")

    // In this example, we are acquiring a lease for the container named "mycontainer".
    var responseStr: String? = rest.fullRequestNoBody(httpVerb: "PUT", uriPath: "/mycontainer?restype=container&comp=lease")
    if rest.lastMethodSuccess != true {
        print("\(rest.lastErrorText!)")
        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.intValue < 200) || (rest.responseStatusCode.intValue > 202) {
        // Examine the request/response to see what happened.
        print("response status code = \(rest.responseStatusCode.intValue)")
        print("response status text = \(rest.responseStatusText!)")
        print("response header: \(rest.responseHeader!)")
        print("response body (if any): \(responseStr!)")
        print("---")
        print("LastRequestStartLine: \(rest.lastRequestStartLine!)")
        print("LastRequestHeader: \(rest.lastRequestHeader!)")
        return
    }

    print("Success: Lease acquired.")

}