(Objective-C) Azure Storage: Set Blob Service Properties

Azure Storage Blob Service REST API: Sample code to set a blob's service properties.

Chilkat Objective-C Library Downloads MAC OS X (Cocoa) Libs iOS Libs

#import <CkoRest.h>
#import <CkoAuthAzureStorage.h>
#import <CkoXml.h>
#import <NSString.h>

// Azure Blob Service Example: Set Blob Service Properties
// See also: https://msdn.microsoft.com/en-us/library/azure/hh452235.aspx

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

CkoRest *rest = [[CkoRest alloc] init];

// Connect to the Azure Storage Blob Service
BOOL bTls = YES;
int port = 443;
BOOL bAutoReconnect = YES;
// In this example, the storage account name is "chilkat".
BOOL success = [rest Connect: @"chilkat.blob.core.windows.net" port: [NSNumber numberWithInt: port] tls: bTls autoReconnect: bAutoReconnect];
if (success != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

// Provide Azure Cloud credentials for the REST call.
CkoAuthAzureStorage *azAuth = [[CkoAuthAzureStorage alloc] init];
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: 2020-08-04" header to be automatically added.
azAuth.XMsVersion = @"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.

// This example will set logging properties.  The XML body of the request
// will look like this:

// <?xml version="1.0" encoding="utf-8"?>
// <StorageServiceProperties>
//     <Logging>
//         <Version>version-number</Version>
//         <Delete>true|false</Delete>
//         <Read>true|false</Read>
//         <Write>true|false</Write>
//         <RetentionPolicy>
//             <Enabled>true|false</Enabled>
//             <Days>number-of-days</Days>
//         </RetentionPolicy>
//     </Logging>

// Build the request:
CkoXml *xml = [[CkoXml alloc] init];
xml.Tag = @"StorageServiceProperties";
CkoXml *xLogging = [xml NewChild: @"Logging" content: @""];
[xLogging NewChild2: @"Version" content: @"1.0"];
[xLogging NewChild2: @"Delete" content: @"true"];
[xLogging NewChild2: @"Read" content: @"true"];
[xLogging NewChild2: @"Write" content: @"true"];
CkoXml *xRetension = [xLogging NewChild: @"RetentionPolicy" content: @""];
[xRetension NewChild2: @"Enabled" content: @"true"];
[xRetension NewChild2: @"Days" content: @"7"];

// The expected response is a 202 response status code with no response body.
NSString *responseStr = [rest FullRequestString: @"PUT" uriPath: @"/?restype=service&comp=properties" bodyText: [xml GetXml]];
if (rest.LastMethodSuccess != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

// When successful, the Azure Storage service will respond with a 202 response code,
// with no response body.
if ([rest.ResponseStatusCode intValue] != 202) {
    // Examine the request/response to see what happened.
    NSLog(@"%@%d",@"response status code = ",[rest.ResponseStatusCode intValue]);
    NSLog(@"%@%@",@"response status text = ",rest.ResponseStatusText);
    NSLog(@"%@%@",@"response header: ",rest.ResponseHeader);
    NSLog(@"%@%@",@"response body (if any): ",responseStr);
    NSLog(@"%@",@"---");
    NSLog(@"%@%@",@"LastRequestStartLine: ",rest.LastRequestStartLine);
    NSLog(@"%@%@",@"LastRequestHeader: ",rest.LastRequestHeader);
    return;
}

NSLog(@"%@",@"Success: Blob service properties updated!");