Connect and Upload Files Programmatically to Azure Blob Storage
Connect to Cloud environment's Azure Blob Storage programmatically.
Connect to Azure Blob Storage programmatically
This article provides the steps needed to programmatically connect to your Umbraco Cloud Environment's Azure Blob Storage containers, to persist files programmatically. You will need access to the Blob Storage credentials to authenticate and find the files created programmatically in the Azure Blob Storage.
By the end of this article you will have connected and uploaded a file to your Cloud Blob Storage. The list of the files within the folder will only be available on the Azure Storage so they are not visible publicly. This is with the exception of each individual file that can be shared publicly via the *.blob.core.windows.net
URL.
An alternative to this guide is to use Umbraco Storage Providers package or MediaFileManager.FileSystem
abstraction from the Custom File Systems (IFileSystem) article.
Follow these steps to get started:
Clone down your Umbraco Cloud Project. You can find more information on how to clone a project in the Working Locally article.
Run your project.
Install
Azure.Storage.Blobs
package on your project. You can do it either via NuGet Package Manager on Visual Studio or install it via NuGet.Run the project to complete the installation of the package.
Add a new class called
BlobStorageService
which serves as a service that has a method to connect to Blob Storage:
Add a new class called
BlobStorageComposer
to inject the service:
Add a new class called
BlobStorageController
which serves as the Surface Controller:
Here, the controller is used to create a directory named FolderProgramatically
and a .txt
file in Azure Blob Storage.
In the above code, update the SASUrl
and containerName
values with your own from the Umbraco Cloud Settings. To find these values, refer to the instructions in the Connect to Azure Storage Explorer to upload files manually article.
You can also secure the values in Secrets Management in the project Settings on Umbraco Cloud so you do not store them in code. For more information, see the Secrets Management article.
Run the project.
Visit the
{{yourProjectURL}}/umbraco/surface/BlobStorage/BlobUpdate
endpoint in the backoffice of your project to manually trigger the creation of the file to the Blob Storage.Connect to your Blob Storage and there you will find the folder and file that has been created programmatically:
References
For more information, see the following articles from Microsoft:
Last updated