Dart

Set Container ACL

See more Azure Cloud Storage Examples

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

import 'package:chilkat/chilkat.dart';

void main() {
  // 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.

  final rest = CkRest();

  // Connect to the Azure Storage Blob Service
  final bTls = true;
  final port = 443;
  final bAutoReconnect = true;
  // In this example, the storage account name is "chilkat".
  try {
    rest.connect('chilkat.blob.core.windows.net', port, bTls, bAutoReconnect);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // Provide Azure Cloud credentials for the REST call.
  final azAuth = CkAuthAzureStorage();
  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';
  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 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.
  final prng = CkPrng();
  final randomId = prng.randomString(32, true, true, true);

  // Get the current system date/time in ISO 8061 format
  final dt = CkDateTime();
  dt.setFromCurrentSystemTime();
  final bLocal = false;
  // Get the current date/time in ISO 8061 UTC format.
  final curDtStr = dt.getAsTimestamp(bLocal);
  // The expire time will be 365 days in the future.
  dt.addDays(365);
  final expireDtStr = dt.getAsTimestamp(bLocal);

  // Build the request:
  final xml = CkXml();
  xml.tag = 'SignedIdentifiers';
  final xSignedId = xml.newChild('SignedIdentifier', '');
  xSignedId.newChild2('Id', randomId);
  final xAccessPolicy = xSignedId.newChild('AccessPolicy', '');
  xAccessPolicy.newChild2('Start', curDtStr);
  xAccessPolicy.newChild2('Expiry', expireDtStr);
  xAccessPolicy.newChild2('Permission', 'rwd');

  // Show the XML..
  print(xml.getXml());

  // The expected response is a 200 response status code with no response body.
  final String responseStr;
  try {
    responseStr = rest.fullRequestString('PUT', '/mycontainer?restype=container&comp=acl', xml.getXml());
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

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

  if (rest.responseStatusCode != 200) {
    // Examine the request/response to see what happened.
    print('response status code = ${rest.responseStatusCode}');
    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.');
}