Delphi DLL

Azure File Service: List Shares

See more Azure Cloud Storage Examples

Sample code to list the file shares in an Azure storage account. Delphi DLL

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, DtObj, Rest, AuthAzureStorage, Xml, CkDateTime;

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Boolean;
rest: HCkRest;
bTls: Boolean;
port: Integer;
bAutoReconnect: Boolean;
azAuth: HCkAuthAzureStorage;
responseStr: PWideChar;
xml: HCkXml;
lastMod: HCkDateTime;
numShares: Integer;
i: Integer;
dt: HCkDtObj;

begin
success := False;

// Azure File Service Example: List all the file shares in a storage account.
// See also: https://docs.microsoft.com/en-us/rest/api/storageservices/list-shares

// 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.file.core.windows.net',port,bTls,bAutoReconnect);
if (success = False) then
  begin
    Memo1.Lines.Add(CkRest__lastErrorText(rest));
    Exit;
  end;

// 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,'File');
// 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.

// Send the GET request to list the shares.
responseStr := CkRest__fullRequestNoBody(rest,'GET','/?comp=list');
if (CkRest_getLastMethodSuccess(rest) = False) then
  begin
    Memo1.Lines.Add(CkRest__lastErrorText(rest));
    Exit;
  end;

// When successful, the Azure Storage service will respond with a 200 response status code,
// with an XML response body.

if (CkRest_getResponseStatusCode(rest) <> 200) then
  begin
    // Examine the request/response to see what happened.
    Memo1.Lines.Add('response status code = ' + IntToStr(CkRest_getResponseStatusCode(rest)));
    Memo1.Lines.Add('response status text = ' + CkRest__responseStatusText(rest));
    Memo1.Lines.Add('response header: ' + CkRest__responseHeader(rest));
    Memo1.Lines.Add('response body (if any): ' + responseStr);
    Memo1.Lines.Add('---');
    Memo1.Lines.Add('LastRequestStartLine: ' + CkRest__lastRequestStartLine(rest));
    Memo1.Lines.Add('LastRequestHeader: ' + CkRest__lastRequestHeader(rest));
    Exit;
  end;

// Load the XML response for parsing.
// An example of the response XML is shown below.
xml := CkXml_Create();
success := CkXml_LoadXml(xml,responseStr);

Memo1.Lines.Add(CkXml__getXml(xml));

// Here's a sample response:

// <?xml version="1.0" encoding="utf-8" ?>
// <EnumerationResults ServiceEndpoint="https://chilkat.file.core.windows.net/">
//     <Shares>
//         <Share>
//             <Name>beardie</Name>
//             <Properties>
//                 <Last-Modified>Mon, 26 Jun 2017 21:24:57 GMT</Last-Modified>
//                 <Etag>"0x8D4BCD9CBD872E5"</Etag>
//                 <Quota>5120</Quota>
//             </Properties>
//         </Share>
//         <Share>
//             <Name>pip</Name>
//             <Properties>
//                 <Last-Modified>Mon, 26 Jun 2017 21:24:44 GMT</Last-Modified>
//                 <Etag>"0x8D4BCD9C3D823D1"</Etag>
//                 <Quota>5120</Quota>
//             </Properties>
//         </Share>
//     </Shares>
//     <NextMarker />
// </EnumerationResults>

// Let's iterate over the file shares
lastMod := CkDateTime_Create();

numShares := CkXml_NumChildrenAt(xml,'Shares');
i := 0;
dt := CkDtObj_Create();
while i < numShares do
  begin
    Memo1.Lines.Add('---- Share ' + IntToStr(i) + ' ----');
    CkXml_putI(xml,i);
    Memo1.Lines.Add('Name: ' + CkXml__getChildContent(xml,'Shares|Share[i]|Name'));
    CkDateTime_SetFromRfc822(lastMod,CkXml__getChildContent(xml,'Shares|Share[i]|Properties|Last-Modified'));
    CkDateTime_ToDtObj(lastMod,True,dt);

    Memo1.Lines.Add('Last-Modified YMD: ' + IntToStr(CkDtObj_getYear(dt)) + ',' + IntToStr(CkDtObj_getMonth(dt)) + ',' + IntToStr(CkDtObj_getDay(dt)));
    i := i + 1;
  end;

// Output for the above loop:

// ---- Share 0 ----
// Name: beardie
// Last-Modified YMD: 2017,6,26
// ---- Share 1 ----
// Name: pip
// Last-Modified YMD: 2017,6,26
// 

Memo1.Lines.Add('Success.');

CkRest_Dispose(rest);
CkAuthAzureStorage_Dispose(azAuth);
CkXml_Dispose(xml);
CkDateTime_Dispose(lastMod);
CkDtObj_Dispose(dt);

end;