Microsoft Azure Storage Connector Reference¶ The following operations allow you to work with the Microsoft Azure Storage Connector. Click an operation name to see parameter details and samples on how to use it. Initialize the connector¶ To use the Microsoft Azure Storage connector, you need to initialize the configuration before carrying out any other Microsoft Azure Storage operations. To use the Microsoft Azure Storage connector, add the element in your configuration before carrying out any Azure Storage operations. This Microsoft Azure Storage configuration authenticates with Microsoft Azure Storage by Account access key or Client Credentials, which are used for every operation. Note: To work with the Microsoft Azure Storage connector, you need to have a Microsoft Azure account. If you do not have a Microsoft Azure account, go to https://azure.microsoft.com/en-in/free/ and create a Microsoft Azure account. Initialize using Account name and Access key¶ initThe init operation is used to initialize the connection to Microsoft Azure. Parameter Name Description Required accountName The name of the Azure storage account. Yes accountKey The access key for the storage account. Yes defaultEndpointsProtocol Type of the protocol(HTTP/HTTPS) to connect. No Sample configuration <msazurestorage.init> <accountName>{$ctx:accountName}</accountName> <accountKey>{$ctx:accountKey}</accountKey> <defaultEndpointsProtocol>{$ctx:defaultEndpointsProtocol}</defaultEndpointsProtocol> </msazurestorage.init> Initialize using Client Credentials¶ initThe init operation is used to initialize the connection to Microsoft Azure. Parameter Name Description Required accountName The name of the Azure storage account. Yes clientId The client ID of the application. Yes clientSecret The client secret of the application. Yes tenantId The tenant ID of the application. Yes Sample configuration <msazurestorage.init> <accountName>{$ctx:accountName}</accountName> <clientId>{$ctx:clientId}</clientId> <clientSecret>{$ctx:clientSecret}</clientSecret> <tenantId>{$ctx:tenantId}</tenantId> </msazurestorage.init> Blobs¶ uploadBlobThe uploadBlob operation uploads a Blob file into the storage. See the related API documentation for more information. Note: Either filePath or textContent parameter is mandatory. Parameter Name Description Required containerName The name of the container. Yes fileName The name of the file. Yes filePath The path to a local file to be uploaded. No textContent Text content to be uploaded (without using a file). No blobContentType The Content-type of the file to be uploaded. No metadata The metadata of the blob. No Sample configuration <msazurestorage.uploadBlob> <containerName>{$ctx:containerName}</containerName> <fileName>{$ctx:fileName}</fileName> <filePath>{$ctx:filePath}</filePath> <blobContentType>{$ctx:fileContentType}</blobContentType> <metadata>{$ctx:metadata}</metadata> </msazurestorage.uploadBlob> Sample request { "containerName": "sales", "fileName": "sample.json", "filePath": "/home/user/Pictures/a.json", "blobContentType": "application/json", "metadata": { "key1":"value1" } } downloadBlobThe downloadBlob operation download the Blob content. See the related API documentation for more information. Note: By default, the content of the blob will be written to the HTTP response. The destinationFilePath parameter can be used to download it to local storage. Parameter Name Description Required containerName The name of the container. Yes fileName The name of the file. Yes destinationFilePath The local file path to download the blob. If the destination file already exists or if the file is not writable by the current user, an exception will be thrown. No Sample configuration <msazurestorage.downloadBlob> <containerName>{$ctx:containerName}</containerName> <fileName>{$ctx:fileName}</fileName> </msazurestorage.downloadBlob> Sample request { "containerName": "sales", "fileName": "sample.txt" } deleteBlobThe deleteBlob operation deletes a Blob file from the storage. See the related API documentation for more information. Parameter Name Description Required containerName The name of the container. Yes fileName The name of the file. Yes Sample configuration <msazurestorage.deleteBlob> <containerName>{$ctx:containerName}</containerName> <fileName>{$ctx:fileName}</fileName> </msazurestorage.deleteBlob> Sample request { "containerName": "sales", "fileName": "sample.txt" } listBlobsThe listBlobs operation retrieves information about all Blobs in a container. See the related API documentation for more information. Parameter Name Description Required containerName The name of the container. Yes Sample configuration <msazurestorage.listBlobs> <containerName>{$ctx:containerName}</containerName> </msazurestorage.listBlobs> Sample request { "containerName": "sales" } Containers¶ createContainerThe createContainer operation creates a container in the storage. See the related API documentation for more information. Parameter Name Description Required containerName The name of the container. Yes Sample configuration <msazurestorage.createContainer> <containerName>{$ctx:containerName}</containerName> </msazurestorage.createContainer> Sample request { "containerName": "sales" } deleteContainerThe deleteContainer operation deletes a container from the storage. See the related API documentation for more information. Parameter Name Description Required containerName The name of the container. Yes Sample configuration <msazurestorage.deleteContainer> <containerName>{$ctx:containerName}</containerName> </msazurestorage.deleteContainer> Sample request { "containerName": "sales" } listContainersThe listContainers operation retrieves information about all containers in the storage. See the related API documentation for more information. Sample configuration <msazurestorage.listContainers/> Metadata¶ listMetadataThe listMetadata operation list metadata for a given blob. See the related API documentation for more information. Parameter Name Description Required containerName The name of the container. Yes fileName The name of the file. Yes Sample configuration <msazurestorage.listMetadata> <containerName>{$ctx:containerName}</containerName> <fileName>{$ctx:fileName}</fileName> </msazurestorage.listMetadata> Sample request { "containerName": "sales", "fileName": "sample.txt" } uploadMetadataThe uploadMetadata operation uploads a list of metadata for a given blob. See the related API documentation for more information. Parameter Name Description Required containerName The name of the container. Yes fileName The name of the file. Yes metadata The metadata of the blob. No Sample configuration <msazurestorage.uploadMetadata> <containerName>{$ctx:containerName}</containerName> <fileName>{$ctx:fileName}</fileName> <metadata>{$ctx:metadata}</metadata> </msazurestorage.uploadMetadata> Sample request { "containerName": "sales", "fileName": "sample.json", "metadata": { "key1":"value1" } } Error codes related to Microsoft Azure Storage Connector¶ Error code Error message 700701 MS_AZURE_BLOB:CONNECTION_ERROR 700702 MS_AZURE_BLOB:INVALID_CONFIGURATION 700703 MS_AZURE_BLOB:MISSING_PARAMETERS 700704 MS_AZURE_BLOB:AUTHENTICATION_ERROR 700705 MS_AZURE_BLOB:FILE_ALREADY_EXISTS_ERROR 700706 MS_AZURE_BLOB:FILE_IO_ERROR 700707 MS_AZURE_BLOB:BLOB_STORAGE_ERROR 700708 MS_AZURE_BLOB:FILE_PERMISSION_ERROR 700709 MS_AZURE_BLOB:GENERAL_ERROR In addition to the above ERROR_DETAIL property will contain detail information about the error. For more information refer Using Fault Sequences.