Documentation

The Azure team is always trying to improve the content resources that help you to learn and use Azure. Conceptual content, how-to topics, getting started lists, graphics, and video are just some of the ways that this is being accomplished.

We need your help to decide what content is most useful for you. We also need your advice on how to improve existing content.

If you have any feedback, please vote on an idea or create a new suggestion. Thank you!

I suggest you ...

You've used all your votes and won't be able to post a new idea, but you can still search and comment on existing ideas.

There are two ways to get more votes:

  • When an admin closes an idea you've voted on, you'll get your votes back from that idea.
  • You can remove your votes from an open idea you support.
  • To see ideas you have already voted on, select the "My feedback" filter and select "My open ideas".
(thinking…)

Enter your idea and we'll search to see if someone has already suggested it.

If a similar idea already exists, you can support and comment on it.

If it doesn't exist, you can post your idea so others can support it.

Enter your idea and we'll search to see if someone has already suggested it.

  1. Secure data in the cloud: encryption and authorization

    How to encrypt data safely and set proper authorization for permitted users/owners.

    159 votes
    Vote
    Sign in
    Check!
    (thinking…)
    Reset
    or sign in with
    • facebook
    • google
      Password icon
      I agree to the terms of service
      Signed in as (Sign out)
      You have left! (?) (thinking…)
      0 comments  ·  Flag idea as inappropriate…  ·  Admin →
      under review  ·  Jason RothJason Roth responded

      Thank you for this suggestion. I need to do more research to understand the content we have in this area.

    • Environment and Subscription management with complex or distributed development teams.

      Shows how to manage hosted service resources in a complex team environment.

      131 votes
      Vote
      Sign in
      Check!
      (thinking…)
      Reset
      or sign in with
      • facebook
      • google
        Password icon
        I agree to the terms of service
        Signed in as (Sign out)
        You have left! (?) (thinking…)
        0 comments  ·  Flag idea as inappropriate…  ·  Admin →
      • Encryption at rest documentation

        Can support provide a better documentation on Encryption-at-Rest? This is our concern. The only document I see if dated back to July 2012. Is there any current documentation?

        128 votes
        Vote
        Sign in
        Check!
        (thinking…)
        Reset
        or sign in with
        • facebook
        • google
          Password icon
          I agree to the terms of service
          Signed in as (Sign out)
          You have left! (?) (thinking…)
          1 comment  ·  Flag idea as inappropriate…  ·  Admin →
          under review  ·  Jason RothJason Roth responded

          I’ll try to find the content owners for this. It would help if you could provide a URL to the documentation that you see from 2012. Can you add this to the comments? Thanks!

        • Dynamic provisioning (instances, storage, bandwidth etc.) using Windows Azure APIs.

          Shows how to use the Windows Azure APIs to dynamically provision resources based on application needs.

          105 votes
          Vote
          Sign in
          Check!
          (thinking…)
          Reset
          or sign in with
          • facebook
          • google
            Password icon
            I agree to the terms of service
            Signed in as (Sign out)
            You have left! (?) (thinking…)
            2 comments  ·  Flag idea as inappropriate…  ·  Admin →
            under review  ·  Jason RothJason Roth responded

            I apologize for the delay on this Windows Azure feedback item. For Dynamic Provisioning, custom solutions can be created using the Service Management API (http://msdn.microsoft.com/en-us/library/windowsazure/ee460799.aspx). However, based on the comments, I believe it is more than just having the commands. At this time, we have the AutoScale (Preview) http://weblogs.asp.net/scottgu/archive/2013/06/27/windows-azure-general-availability-release-of-web-sites-mobile-services-new-autoscale-alerts-support-no-credit-card-needed-for-msdn-subscribers.aspx as well as the Autoscaling application block http://msdn.microsoft.com/en-us/library/hh680892(v=PandP.50).aspx.

            So for this documentation suggestion, I would be interested in more comments on whether these solutions meet the needs of the original request. Or is there still a need to provide guidance on how you would dynamically provision resources in a custom coding solution? Thank you.

          • Windows Azure Storage Table version management

            Shows how to manages changes to data stored in Windows Azure Storage tables.

            54 votes
            Vote
            Sign in
            Check!
            (thinking…)
            Reset
            or sign in with
            • facebook
            • google
              Password icon
              I agree to the terms of service
              Signed in as (Sign out)
              You have left! (?) (thinking…)
              1 comment  ·  Flag idea as inappropriate…  ·  Admin →
              under review  ·  Jason RothJason Roth responded

              We are looking into whether there is guidance on this in the current documentation.

            • Best practices for sharding SQL Server databases into multiple SQL Azure dbs

              The recommended solution for breaking up large SQL Server databases to fit into SQL Azure is sharding. I'd love to see examples, samples, and best practices for accomplishing this.

              33 votes
              Vote
              Sign in
              Check!
              (thinking…)
              Reset
              or sign in with
              • facebook
              • google
                Password icon
                I agree to the terms of service
                Signed in as (Sign out)
                You have left! (?) (thinking…)
                0 comments  ·  Flag idea as inappropriate…  ·  Admin →
                under review  ·  Jason RothJason Roth responded

                I apologize for the delayed response on this Windows Azure feedback item. Our Customer Advisory Team (CAT) has recently released a project called Cloud Services Fundamentals. This project contains some best practices for sharding. See this article: http://blogs.msdn.com/b/windowsazure/archive/2013/09/05/dal-sharding-of-rdbms.aspx. And see the project: http://code.msdn.microsoft.com/Cloud-Service-Fundamentals-4ca72649. In addition, there is a great paper on designing large scale Windows Azure applications here: http://msdn.microsoft.com/en-us/library/windowsazure/jj717232.aspx. Finally, there is an older post on sharding here: http://blogs.msdn.com/b/sqlazure/archive/2010/06/24/10029719.aspx.

                However, even with all of these resources, I’m not sure we have an easy-to-find paper with best practices in this area. I’m going to do some research to see if this is something we might do. Thanks for the idea. If there are other comments anyone would like to add to this request, please do so.

              • XML Schema for request/response messages of azure REST API

                Azure REST API currently does not have any published XML Schema for request and response messages. Such schema could be very helpful for developer to marshalling and validating the XML messages. In general it is also a basic need for a webservices consumer to know about the messages schema.

                19 votes
                Vote
                Sign in
                Check!
                (thinking…)
                Reset
                or sign in with
                • facebook
                • google
                  Password icon
                  I agree to the terms of service
                  Signed in as (Sign out)
                  You have left! (?) (thinking…)
                  3 comments  ·  Flag idea as inappropriate…  ·  Admin →
                • Communicate with trial users before deleting VMs

                  All marketing and informational materials concerning trial accounts from Microsoft Azure do not make any indication of a Deletion of VMs when a spending cap is reached. All information indicates that the VMs will be Disabled - but not Deleted. As an example: http://www.windowsazure.com/en-us/pricing/spending-limits/

                  I was directed by Microsoft to create a trial account as the entry point into Windows Azure, and that I could take up to 3 months to upgrade to a full subscription. As a new user, I was unaware of how to access the subscription cost incurred panel (I still have difficulty navigating it - and…

                  18 votes
                  Vote
                  Sign in
                  Check!
                  (thinking…)
                  Reset
                  or sign in with
                  • facebook
                  • google
                    Password icon
                    I agree to the terms of service
                    Signed in as (Sign out)
                    You have left! (?) (thinking…)
                    1 comment  ·  Flag idea as inappropriate…  ·  Admin →
                  • Create guidance packages for common supported scenario's. So it's very easy to get started.

                    Create guidance packages for common supported scenario's. It should be very easy to get started. It should be not more complicated than :
                    1. Set your connection string to Azure,
                    2. point to an XSD and presto there is your webservice.
                    3. Want to store received requests in a table, just add that checkbox.
                    4. Want processing on that table, just cjeck that checkbox.....

                    I could go on for a while. Having guidance will lower complexity, and give everyone a easy trouble free start. That is always a good thing.

                    12 votes
                    Vote
                    Sign in
                    Check!
                    (thinking…)
                    Reset
                    or sign in with
                    • facebook
                    • google
                      Password icon
                      I agree to the terms of service
                      Signed in as (Sign out)
                      You have left! (?) (thinking…)
                      0 comments  ·  Flag idea as inappropriate…  ·  Admin →
                      under review  ·  Jason RothJason Roth responded

                      I apologize for the delay in responding to your Windows Azure feedback item. At this time, we don’t have a plan to create guidance packages like this with variable options. However, we do want to continue to provide good documentation and samples for common scenarios. If there are holes in specific supported scenarios, please let us know by adding items to this feedback forum.

                      With this said, have you seen this model used successfully in the past? If you would like to provide more details, it would help us to evaluate whether something like this would be possible in the future. I’m going to leave this item under review to give you a chance to provide some more details on how this might work. I can’t promise that we can do it, but I would like to understand what form this would take in order to better consider it. Thank…

                    • Using custom synchronization providers against Windows Azure Storage

                      Shows how to provide custom synchronization for Windows Azure Storage.

                      11 votes
                      Vote
                      Sign in
                      Check!
                      (thinking…)
                      Reset
                      or sign in with
                      • facebook
                      • google
                        Password icon
                        I agree to the terms of service
                        Signed in as (Sign out)
                        You have left! (?) (thinking…)
                        0 comments  ·  Flag idea as inappropriate…  ·  Admin →
                        under review  ·  Jason RothJason Roth responded

                        I apologize for the delayed response to this feedback item. I assume that this suggestion is to provide documentation around the Microsoft Sync Framework and its integration with Windows Azure. Specifically with custom providers (http://msdn.microsoft.com/en-us/library/bb902847.aspx). For people following this thread or voting on it, please add comments to indicate the type of guidance needed. Also, add comments if the Sync Framework is not in mind as much as just programmatic guidance for synchronization techniques. Once there is more information on the thread, we can investigate the possibility of creating new content around this need.

                      • review articles in Documentation section occasionally & *have a date of publication or modification on it* to indicate info is up-to-date

                        The HOW TO articles in the Windows Azure documentation (http://www.windowsazure.com/en-us/documentation/) have been very helpful. However, there are times when the info there gets stale due to changes in the SDK. I understand it is a challenge to update these articles every time there is a dependent change but it is frustrating for a reader to walk through a sample and while trying it out, find that some piece used to work earlier but won't work now due to a breaking change. If there is a date of publication or modification, readers can at least guess that it could…

                        9 votes
                        Vote
                        Sign in
                        Check!
                        (thinking…)
                        Reset
                        or sign in with
                        • facebook
                        • google
                          Password icon
                          I agree to the terms of service
                          Signed in as (Sign out)
                          You have left! (?) (thinking…)
                          0 comments  ·  Flag idea as inappropriate…  ·  Admin →
                          planned  ·  Jason RothJason Roth responded

                          We are currently planning to implement this idea, both in reviewing more frequently as well as consistently adding the publish date. We completely agree that with the fast pace of Windows Azure releases, that this is more necessary. Thanks for the suggestion. I’ll update this idea when I can confirm that this process is fully in place.

                        • broken UI

                          All most all pages relating to AZURE is broken. the width of the page has a lot of padding, and doesn't fit.

                          MSDN docs seems to have changed; looks like the team behind it is having fun changing/rolling-out new CSS every other 3months or so. I hate all of them. MSDN doc is a dev-doc, and should have minimal js and CSS. Please remove all these stupid CSS/JS and return it to a simple fast-loading page.

                          PROBLEM: http://msdn.microsoft.com/library/windowsazure/dn339013.aspx (for example) is broken. because the page width is restricted to a small width and padding with absolutely useless padding. Now, a…

                          9 votes
                          Vote
                          Sign in
                          Check!
                          (thinking…)
                          Reset
                          or sign in with
                          • facebook
                          • google
                            Password icon
                            I agree to the terms of service
                            Signed in as (Sign out)
                            You have left! (?) (thinking…)
                            0 comments  ·  Flag idea as inappropriate…  ·  Admin →
                            planned  ·  Jason RothJason Roth responded

                            I apologize for the problem you’ve seen on the MSDN documentation with the fixed-width layout. We have been attempting to correct any tables or images that are affected by this layout, so I’ll try to get the page your referenced corrected.

                            However, I know that this is just one example. I want to point out that the MSDN library for Windows Azure is “skinned”, which adds the style sheet. If you ever see any problems, you can take “windowsazure” off of the URL and you’ll go to the regular MSDN view. Here is the same URL you sent but with windowsauzre removed:

                            http://msdn.microsoft.com/library/dn339013.aspx

                            Please let me know if this helps. I realize it does not correct everything that you dislike about the Windows Azure style of MSDN, and I’ll provide that feedback to the appropriate people as well. Thank you.

                          • Clarify the information on Monthly Azure credit for Visual Studio Enterprise (BizSpark) subscribers

                            I have found contradicting information on this page

                            https://azure.microsoft.com/en-gb/offers/ms-azr-0064p/

                            I am a BizSpark member and I am trying to establish whether the £95 of Azure credit per subscription for 5 developers in my team allows us to use those credits for Production.

                            The last paragraph of the Get Started section says:- "As a special BizSpark benefit, you can run both dev/test and production workloads with this offer."

                            But the Use Rights section near the bottom of the same page says:- "This benefit is for development and testing only. We reserve the right to suspend any instance (VM or cloud service)…

                            7 votes
                            Vote
                            Sign in
                            Check!
                            (thinking…)
                            Reset
                            or sign in with
                            • facebook
                            • google
                              Password icon
                              I agree to the terms of service
                              Signed in as (Sign out)
                              You have left! (?) (thinking…)
                              0 comments  ·  WindowsAzure.com  ·  Flag idea as inappropriate…  ·  Admin →
                            • Some Korean (ko-kr) Azure document pages are wrongly displayed

                              Hello,

                              First of all, thank you very much for opening docs.microsoft.com with lots of Azure related articles! Even Korean translations are so cooool!

                              Korean Azure contents are translated and shared into https://github.com/Azure/azure-content-kokr/ page (original: https://github.com/Azure/azure-content )

                              By the way, would you see those two pages?
                              [1] https://docs.microsoft.com/en-us/active-directory/active-directory-devquickstarts-dotnet
                              [2] https://docs.microsoft.com/ko-kr/active-directory/active-directory-devquickstarts-dotnet

                              [1] is the original article, and [2] is the same article but translated into Korean. However, [2] is wrongly displayed.

                              Actually I don't know why it happened. On github repository, it seemed good. Is there some problems on parsing github content for translated pages? Hope that Korean translated pages will be…

                              7 votes
                              Vote
                              Sign in
                              Check!
                              (thinking…)
                              Reset
                              or sign in with
                              • facebook
                              • google
                                Password icon
                                I agree to the terms of service
                                Signed in as (Sign out)
                                You have left! (?) (thinking…)
                                0 comments  ·  Flag idea as inappropriate…  ·  Admin →
                              • Add more metadata to every page of documentation

                                At present, documentation (whch is in the main pretty good and getting better) has little metadata. I see an artilce and don't know when it was written, or when it was updated.

                                What I would like to see on every page of documentration:
                                1. Date this copy was written
                                2. Regions to which this documentation applies (if not everywhere)
                                3. Last time the documentation was reviewed and found to be accurate.

                                I'd also like to see a change log - what changed and when. This needn't be massive - I just want to note that's new and what's not new!

                                6 votes
                                Vote
                                Sign in
                                Check!
                                (thinking…)
                                Reset
                                or sign in with
                                • facebook
                                • google
                                  Password icon
                                  I agree to the terms of service
                                  Signed in as (Sign out)
                                  You have left! (?) (thinking…)
                                  0 comments  ·  MSDN Library  ·  Flag idea as inappropriate…  ·  Admin →
                                • Associate Windows Azure with MS Training Kits

                                  I work as a SharePoint Consultant and I'm studying a lot about SharePoint 2013.

                                  As a consultant I'm frequently at customers and just have my laptop for study purposes.

                                  So my main problem is - I (and I think the most of IT Pros) doesn't have own enough hardware to study everything we need. Please take a look on some SharePoint 2013 hardware requirements:

                                  http://technet.microsoft.com/en-us/library/cc262485.aspx#hwLocServers

                                  Actually I'm studying SharePoint High Availability, so it's impractical to do any related lab with an Intel i5 + 8GB RAM (to say the truth, most of all others labs are hard to do with…

                                  5 votes
                                  Vote
                                  Sign in
                                  Check!
                                  (thinking…)
                                  Reset
                                  or sign in with
                                  • facebook
                                  • google
                                    Password icon
                                    I agree to the terms of service
                                    Signed in as (Sign out)
                                    You have left! (?) (thinking…)
                                    0 comments  ·  Training Kit  ·  Flag idea as inappropriate…  ·  Admin →
                                    under review  ·  Jason RothJason Roth responded

                                    This is a creative self-study solution, and you’re right that Windows Azure is an ideal environment for this type of short-term hardware acquisition and use. I will look into this and update this thread when I get more information.

                                  • Update documentation more frequently

                                    Hi,

                                    the documentation on MSDN should be updated more frequently to represent the current state of union more accurate.

                                    4 votes
                                    Vote
                                    Sign in
                                    Check!
                                    (thinking…)
                                    Reset
                                    or sign in with
                                    • facebook
                                    • google
                                      Password icon
                                      I agree to the terms of service
                                      Signed in as (Sign out)
                                      You have left! (?) (thinking…)
                                      0 comments  ·  Flag idea as inappropriate…  ·  Admin →
                                    • Give more information about how Microsoft Azure expects programmers to get X.509 V3 certificate....some articles talk about building one!!!

                                      I am a computer programmer that is about to write an application for Azure. I read that I need a X.509 V3 certificate. But I haven't seen any instructions telling me how Windows Azure expects new programmers should get an X.509 V3 certicate. I searched for forums but found nothing that addresses that directly. What is acceptable for Windows Azure? Can I or should I bet a certificate from a certificate seller like https://www.verisign.com ?

                                      More clear instructions about how to get acquire a X.509 certificate is needed badly.

                                      4 votes
                                      Vote
                                      Sign in
                                      Check!
                                      (thinking…)
                                      Reset
                                      or sign in with
                                      • facebook
                                      • google
                                        Password icon
                                        I agree to the terms of service
                                        Signed in as (Sign out)
                                        You have left! (?) (thinking…)
                                        1 comment  ·  Flag idea as inappropriate…  ·  Admin →
                                        under review  ·  Jason RothJason Roth responded

                                        I apologize for the delayed response. Could you let me know what you are needing the certificate for? I am guessing it might be for SSL. If so, could you look at http://www.windowsazure.com/en-us/documentation/articles/web-sites-configure-ssl-certificate/. If you struggling with how to use certificates for other uses in Azure, please add a comment, and I’ll see if we have existing documentation or whether this is something we should improve. I apologize that you weren’t able to easily find what you need. Certificates and SSL is a complex area.

                                      • Mobile Services documentation should be more than simple example code.

                                        The mobile services documentation is a bunch of implementation examples with detailed walkthroughs of how to add the service to your Azure account and simplistic example code with minimal explanation.

                                        The mobile services documentation doesn't explain what Mobile Services is, what it can and (most importantly) can't do, how to choose between Mobile Services, Websites, and Cloud Services, etc.

                                        3 votes
                                        Vote
                                        Sign in
                                        Check!
                                        (thinking…)
                                        Reset
                                        or sign in with
                                        • facebook
                                        • google
                                          Password icon
                                          I agree to the terms of service
                                          Signed in as (Sign out)
                                          You have left! (?) (thinking…)
                                          0 comments  ·  WindowsAzure.com  ·  Flag idea as inappropriate…  ·  Admin →
                                        • Azure should publish document on how to automate the workflows.

                                          Azure documentation should include the code snippets to automation. The certification prep has more details then azure website

                                          3 votes
                                          Vote
                                          Sign in
                                          Check!
                                          (thinking…)
                                          Reset
                                          or sign in with
                                          • facebook
                                          • google
                                            Password icon
                                            I agree to the terms of service
                                            Signed in as (Sign out)
                                            You have left! (?) (thinking…)
                                            0 comments  ·  Training Kit  ·  Flag idea as inappropriate…  ·  Admin →
                                          ← Previous 1 3
                                          • Don't see your idea?

                                          Feedback and Knowledge Base