Skip to content
The getting started sample demonstrates how to perform common tasks using the Azure Blob Service in C++ including uploading a blob, CRUD operations, listing, as well as blob snapshot creation.
C++ CMake C
Branch: master
Clone or download
pablo cibraro
pablo cibraro Removed unused files
Latest commit e6e0fe9 Aug 17, 2016
Type Name Latest commit message Commit time
Failed to load latest commit information.
storage-blob-cpp-getting-started Removed unused files Aug 17, 2016 Initializing repository files. Aug 5, 2016
LICENSE Initializing repository files. Aug 5, 2016 Initial version Aug 17, 2016
storage-blob-cpp-getting-started.sln Initial version Aug 17, 2016

services platforms author

Azure Storage Service Samples in C++

Demonstrates how to use the Blob Service.

  • Azure Blob storage is a service that stores unstructured data in the cloud as objects/blobs. Blob storage can store any type of text or binary data, such as documents, media files or application installers. Blob storage is also refered to as object storage. This sample demostrates how to perform common tasks for managing containers and blobs with data.

Note: This sample uses the Windows Azure Storage client library for C++ available through a Nuget package, which depends on the Visual Studio version you will use for development. For Visual Studio 2015, use the Nuget package "wastorage.v140". For Visual Studio 2013, use "wastorage.v120".

If you don't have a Microsoft Azure subscription you can get a FREE trial account here.

Running this sample in Windows

This sample can be run using either the Azure Storage Emulator that installs as part of the Windows Azure SDK - or by updating the storage_connection_string variable defined at the top of the program.

To run the sample using the Storage Emulator (Windows Azure SDK):

  1. Download and Install the Azure Storage Emulator here.
  2. Start the Azure Storage Emulator (once only) by pressing the Start button or the Windows key and searching for it by typing "Azure Storage Emulator". Select it from the list of applications to start it.
  3. Set breakpoints and run the project using F10.

To run the sample using the Storage Service

  1. Open the storage-getting-started.cpp file and find the variable storage_connection_string. Replace the value (UseDevelopmentStorage=True) with the connection string for the storage service (AccountName=[]...)
  2. Create a Storage Account through the Azure Portal and provide your [AccountName] and [AccountKey] in the storage_connection_string variable.
  3. Set breakpoints and run the project using F10.

Running this sample in Linux

In order to compile and run this sample in Linux, you first need to get a local copy of the C++ REST SDK (aka Casablanca) from [here] ( and the Azure Storage Client Library for C++ from [here] ( Both libraries must be compiled following the instructions described in the corresponding Github repositories. Once you have these libraries, follow these instructions to build the samples,

  • Clone the project using git:
git clone

The project is cloned to a folder called storage-blob-cpp-getting-started. Always use the master branch, which contains the latest release.

  • Build the samples:
cd storage-blob-cpp-getting-started/storage-blob-cpp-getting-started
mkdir build
cd build
CASABLANCA_DIR=<path to Casablanca> AZURESTORAGE_DIR=<path to AzureStorage> CXX=g++-4.8 cmake .. -DCMAKE_BUILD_TYPE=Release

In the above command, replace <path to Casablanca> to point to your local installation of Casablanca and <path to Casablanca> to point to your local installation of the Azure Storage Client library. For example, if the file exists at location ~/Github/Casablanca/cpprestsdk/Release/build.release/Binaries/ and the file exists at location ~/Github/azure-storage-cpp/Microsoft.WindowsAzure.Storage/build.release/Binaries/, then your cmake command should be:

CASABLANCA_DIR=~/Github/Casablanca/cpprestsdk AZURESTORAGE_DIR=~/Github/azure-storage-cpp CXX=g++-4.8 cmake .. -DCMAKE_BUILD_TYPE=Release

The sample is generated under storage-blob-cpp-getting-started/storage-blob-cpp-getting-started/build/Binaries/.

More information

You can’t perform that action at this time.