{"id":5435,"date":"2017-03-15T11:30:11","date_gmt":"2017-03-15T15:30:11","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/azuregov\/?p=5435"},"modified":"2017-03-15T11:30:11","modified_gmt":"2017-03-15T15:30:11","slug":"getting-started-with-storage-in-azure-government","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/azuregov\/getting-started-with-storage-in-azure-government\/","title":{"rendered":"Getting Started with Storage in Azure Government"},"content":{"rendered":"

Azure Government uses the same underlying technologies as commercial Azure, enabling you to use the development tools you\u2019re already familiar with. However, Azure Government provides a physical and network-isolated instance of Azure which results in a higher level of compliance and security. As a result of this, we use different physical endpoints<\/a> for our services such as Azure Storage. Getting started with Storage on Azure Government is quite easy.<\/p>\n

The Microsoft Azure Storage Explorer<\/a> has quickly become one of the most popular tools for working with Azure Storage. It is cross-platform and free. We are happy to announce the accessibility of Azure Government through the Azure Storage Explorer as of the 0.8.9 release. Government customers will now be able to take advantage of all the latest features of the Azure Storage Explorer such as being able to create and manage blobs, queues, tables, and file shares.<\/p>\n

When you open the Azure Storage Explorer desktop application it will ask you how you want to connect to your storage account. The newest version will now give you the option to add an \u201cAzure US Government\u201d account:<\/p>\n

\"1\"<\/a><\/p>\n

Once you\u2019re logged in, the Azure Storage Explorer enables you to quickly and easily see the resources inside your storage account. In the screenshot below, you can see my storage account named \u201csamplegovstorageacct\u201d which has a blob container, a storage queue, and a storage table called \u201cContacts\u201d. With a quick double-click, we can see the contents of our Contacts table:<\/p>\n

\"2\"<\/a><\/p>\n

Check out the full list of features and download the latest version of the Microsoft Azure Storage Explorer on their home page here<\/a>.<\/p>\n

The Azure Storage Explorer is great for quickly connecting to your storage accounts. However, for the keen observers, you noticed that in the last screenshot the URL for our storage looked a little different than the URL for storage in commercial Azure \u2013 specifically, the domain ended with \u201ccore.usgovcloudapi.net\u201d, rather than \u201ccore.windows.net\u201d. These endpoint differences must be taken into account when you connect to storage in Azure Government with C#.<\/p>\n

Let see this in action. First, let\u2019s go to the Azure Government portal and select our \u201csamplegovstorageacct\u201d and then click the \u201cAccess Keys\u201d tab:<\/p>\n

\"3\"<\/a><\/p>\n

From here we can copy\/paste the storage account name and key. For the simplicity of the sample code, I\u2019ll just paste them into variables \u2013 but these values can be stored in Azure Key Vault<\/a> (which is available on Azure Government<\/a>) for maximum security.<\/p>\n

Next let\u2019s create a new project in Visual Studio and add a reference to the WindowsAzure.Storage NuGet package<\/a>. This NuGet package contains classes we will need to connect.<\/p>\n

Now it\u2019s just a simple matter of 2 lines of C# code to connect:<\/p>\n\n\n\n
var credentials = new StorageCredentials(storageAccountName, storageAccountKey);<\/p>\n

var storageAccount = new CloudStorageAccount(credentials, “core.usgovcloudapi.net”, useHttps: true);<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Notice on the second line we had to use a particular constructor for the CloudStorageAccount<\/a> \u2013 enabling us to explicitly pass in the endpoint suffix of \u201ccore.usgovcloudapi.net\u201d. This constructor is the only<\/u><\/strong> difference your code requires to connect to storage in Azure Government as compared with commercial Azure.<\/p>\n

At this point, we can interact with storage as we normally would. For example, if we want to retrieve a specific record from our table storage we could do it like this:<\/p>\n\n\n\n
var tableClient = storageAccount.CreateCloudTableClient();<\/p>\n

var table = tableClient.GetTableReference(“Contacts”);<\/p>\n

var retrieveOperation = TableOperation.Retrieve<ContactEntity>(“gov-partition1”, “0fb52a6c-3784-4dc5-aa6d-ecda4426dbda”);<\/p>\n

var result = await table.ExecuteAsync(retrieveOperation);<\/p>\n

var contact = result.Result as ContactEntity;<\/p>\n

Console.WriteLine($”Contact: {contact.FirstName} {contact.LastName}”);<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

We welcome your comments and suggestions to help us continually improve your Azure Government experience. To stay up to date on all things Azure Government, be sure to subscribe to our RSS feed<\/a> and to receive emails, click \u201cSubscribe by Email!\u201d on the Azure Government Blog<\/a>. To experience the power of Azure Government for your organization, sign up for an Azure Government Trial<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"

Azure Government uses the same underlying technologies as commercial Azure, enabling you to use the development tools you\u2019re already familiar with. However, Azure Government provides a physical and network-isolated instance of Azure which results in a higher level of compliance and security. As a result of this, we use different physical endpoints for our services […]<\/p>\n","protected":false},"author":1789,"featured_media":20423,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[2,1,21,25,30],"tags":[75,95,311,531],"class_list":["post-5435","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-announcements","category-azuregov","category-onboarding","category-portalpreview","category-storage-backup-recovery","tag-azure","tag-azure-government","tag-getting-started","tag-storage"],"acf":[],"blog_post_summary":"

Azure Government uses the same underlying technologies as commercial Azure, enabling you to use the development tools you\u2019re already familiar with. However, Azure Government provides a physical and network-isolated instance of Azure which results in a higher level of compliance and security. As a result of this, we use different physical endpoints for our services […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/azuregov\/wp-json\/wp\/v2\/posts\/5435","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/azuregov\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/azuregov\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azuregov\/wp-json\/wp\/v2\/users\/1789"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azuregov\/wp-json\/wp\/v2\/comments?post=5435"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/azuregov\/wp-json\/wp\/v2\/posts\/5435\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azuregov\/wp-json\/wp\/v2\/media\/20423"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/azuregov\/wp-json\/wp\/v2\/media?parent=5435"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azuregov\/wp-json\/wp\/v2\/categories?post=5435"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/azuregov\/wp-json\/wp\/v2\/tags?post=5435"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}