Merge pull request #250057 from RoseHJM/mdb-quotas

MDB quota articles

Author: v-dirichards

articles/dev-box/how-to-determine-your-quota-usage.md

@@ -0,0 +1,61 @@
+--- 
+title: How to determine your resource usage and quota 
+description: Learn how to determine where the Dev Box resources for your subscription are used and if you have any spare capacity against your quota.  
+services: dev-box
+ms.service: dev-box
+author: RoseHJM
+ms.author: rosemalcolm
+ms.topic: how-to 
+ms.date: 08/21/2023 
+--- 
+
+# Determine resource usage and quota  
+
+To ensure that resources are available for customers, Microsoft Dev Box has a limit on the number of each type of resource that can be used in a subscription. This limit is called a quota. You can see the default quota for each resource type by subscription type here: 
+
+Keeping track of how your quota of VM cores is being used across your subscriptions can be difficult. You may want to know what your current usage is, how much you have left, and in what regions you have capacity. To help you understand where and how you're using your quota, Azure provides the Usage + Quotas page. 
+
+## Determine your usage and quota
+
+1. In the [Azure portal](https://portal.azure.com), go to the subscription you want to examine. 
+
+1. On the Subscription page, under Settings, select **Usage + quotas**.
+
+   :::image type="content" source="media/how-to-determine-your-quota-usage/subscription-overview.png" alt-text="Screenshot showing the Subscription overview left menu, with Usage and quotas highlighted." lightbox="media/how-to-determine-your-quota-usage/subscription-overview.png"::: 
+ 
+1. To view Usage + quotas information about Microsoft Dev Box, select **Dev Box**.  
+
+   :::image type="content" source="media/how-to-determine-your-quota-usage/select-dev-box.png" alt-text="Screenshot showing the Usage and quotas page, with Dev Box highlighted." lightbox="media/how-to-determine-your-quota-usage/select-dev-box.png":::    
+ 
+1. In this example, you can see the **Quota name**, the **Region**, the **Subscription** the quota is assigned to, the **Current Usage**, and whether or not the limit is **Adjustable**.
+
+   :::image type="content" source="media/how-to-determine-your-quota-usage/example-subscription.png" alt-text="Screenshot showing the Usage and quotas page, with column headings highlighted." lightbox="media/how-to-determine-your-quota-usage/example-subscription.png":::    
+
+1. You can also see that the usage is grouped by level; regular, low, and no usage. 
+
+   :::image type="content" source="media/how-to-determine-your-quota-usage/example-subscription-groups.png" alt-text="Screenshot showing the Usage and quotas page, with VM size groups highlighted." lightbox="media/how-to-determine-your-quota-usage/example-subscription-groups.png" :::
+ 
+1. To view quota and usage information for specific regions, select the **Region:** filter, select the regions to display, and then select **Apply**. 
+
+   :::image type="content" source="media/how-to-determine-your-quota-usage/select-regions.png"  lightbox="media/how-to-determine-your-quota-usage/select-regions.png" alt-text="Screenshot showing the Usage and quotas page, with Regions drop down highlighted.":::
+ 
+1. To view only the items that are using part of your quota, select the **Usage:** filter, and then select **Only items with usage**. 
+
+   :::image type="content" source="media/how-to-determine-your-quota-usage/select-items-with-usage.png" lightbox="media/how-to-determine-your-quota-usage/select-items-with-usage.png" alt-text="Screenshot showing the Usage and quotas page, with Usage drop down and Only show items with usage option highlighted.":::
+ 
+1. To view items that are using above a certain amount of your quota, select the **Usage:** filter, and then select **Select custom usage**. 
+
+   :::image type="content" source="media/how-to-determine-your-quota-usage/select-custom-usage-before.png" alt-text="Screenshot showing the Usage and quotas page, with Usage drop down and Select custom usage option highlighted." lightbox="media/how-to-determine-your-quota-usage/select-custom-usage-before.png" :::
+ 
+1. You can then set a custom usage threshold, so only the items using above the specified percentage of the quota are displayed.  
+ 
+   :::image type="content" source="media/how-to-determine-your-quota-usage/select-custom-usage.png" alt-text="Screenshot showing the Usage and quotas page, with Select custom usage option and configuration settings highlighted."  lightbox="media/how-to-determine-your-quota-usage/select-custom-usage.png":::
+
+1. Select **Apply**. 
+
+ Each subscription has its own Usage + quotas page, which covers all the various services in the subscription, not just Microsoft Dev Box. 
+
+## Related content 
+
+- Check the default quota for each resource type by subscription type: [Microsoft Dev Box limits](/azure/azure-resource-manager/management/azure-subscription-service-limits#microsoft-dev-box-limits).
+- To learn how to request a quota increase, see [Request a quota limit increase](./how-to-request-quota-increase.md). 

articles/dev-box/how-to-request-quota-increase.md

@@ -0,0 +1,138 @@
+---
+title:  Request a quota limit increase for Dev Box resources
+description: Learn how to request a quota increase to expand the number of dev box resources you can use in your subscription. Request an increase for dev box cores and other resources.
+services: dev-box
+ms.service: dev-box
+author: RoseHJM
+ms.author: rosemalcolm
+ms.topic: how-to
+ms.date: 08/22/2023
+---
+
+# Request a quota limit increase
+
+This article describes how to submit a support request for increasing the number of resources for Microsoft Dev Box in your Azure subscription. 
+
+When you reach the limit for a resource in your subscription, you can request a limit increase (sometimes called a capacity increase, or a quota increase) to extend the number of resources available. The request process allows the Microsoft Dev Box team to ensure that your subscription isn't involved in any cases of fraud or unintentional, sudden large-scale deployments. 
+
+The time it takes to increase your quota varies depending on the VM size, region, and number of resources requested.  You won't have to go through the process of requesting extra capacity often, but to ensure you have the resources you require when you need them, you should:
+
+- Request capacity as far in advance as possible.
+- If possible, be flexible on the region where you're requesting capacity.
+- Recognize that capacity remains assigned for the lifetime of a subscription. When dev box resources are deleted, the capacity remains assigned to the subscription. 
+- Request extra capacity only if you need more than is already assigned to your subscription. 
+- Make incremental requests for VM cores rather than making large, bulk requests. Break requests for large numbers of cores into smaller requests for extra flexibility in how those requests are fulfilled.
+
+Learn more about the general [process for creating Azure support requests](/azure/azure-portal/supportability/how-to-create-azure-support-request).
+
+## Prerequisites
+
+- To create a support request, your Azure account needs the [Owner](/azure/role-based-access-control/built-in-roles#owner), [Contributor](/azure/role-based-access-control/built-in-roles#contributor), or [Support Request Contributor](/azure/role-based-access-control/built-in-roles#support-request-contributor) role at the subscription level.
+- Before you create a support request for a limit increase, you need to gather additional information.
+
+## Gather information for your request
+
+You'll find submitting a support request for additional quota is quicker if you gather the required information before you begin the request process. 
+
+- **Determine your current quota usage**
+
+   For each of your subscriptions, you can check your current usage of each Deployment Environments resource type in each region. Determine your current usage by following these steps: [Determine usage and quota](./how-to-determine-your-quota-usage.md).
+
+- **Determine the region for the additional quota**
+
+   Dev Box resources can exist in many regions. You can choose to deploy resources in multiple regions close to your dev box users. For more information about Azure regions, how they relate to global geographies, and which services are available in each region, see [Azure global infrastructure](https://azure.microsoft.com/explore/global-infrastructure/products-by-region/).
+
+- **Choose the quota type of the additional quota.**
+
+   The following Dev Box resources are limited by subscription. You can request an increase in the number of resources for each of these types.
+
+   - Dev box definitions
+   - Dev centers
+   - Network settings
+   - Pools
+   - Projects
+   - Network connections
+   - Dev Box general cores
+   - Other
+ 
+   When you want to increase the number of dev boxes available to your developers, you should request an increase in the number of Dev Box general cores. 
+
+## Submit a new support request
+
+Follow these steps to request a limit increase:  
+
+1. On the Azure portal home page, select Support & troubleshooting, and then select  **Help + support**
+
+    :::image type="content" source="./media/how-to-request-capacity-increase/submit-new-request.png" alt-text="Screenshot of the Azure portal home page, highlighting the Request core limit increase button." lightbox="./media/how-to-request-capacity-increase/submit-new-request.png":::
+
+1. On the **Help + support** page, select **Create a support request**.
+
+    :::image type="content" source="./media/how-to-request-capacity-increase/create-support-request.png" alt-text="Screenshot of the Help + support page, highlighting Create a support request." lightbox="./media/how-to-request-capacity-increase/create-support-request.png":::
+
+1. On the **New support request** page, enter the following information, and then select **Next**.
+
+    | Name              | Value   |
+    | ----------------- | ------- |
+    | **Issue type**    | *Service and subscription limits (quotas)* |
+    | **Subscription**  | Select the subscription to which the request applies. |
+    | **Quota type**    | *Microsoft Dev Box* |
+
+1. On the **Additional details** tab, in the **Problem details** section, select **Enter details**.
+ 
+    :::image type="content" source="media/how-to-request-capacity-increase/enter-details.png" alt-text="Screenshot of the New support request page, highlighting Enter details." lightbox="media/how-to-request-capacity-increase/enter-details.png"::: 
+
+1. In **Quota details**, enter the following information, and then select **Next**.
+ 
+    | Name              | Value   |
+    | ----------------- | ------- |
+    | **Region**        | Select the **Region** in which you want to increase your quota. | 
+    | **Quota type**    | When you select a Region, Azure displays your current usage and your current for all quota types. </br> Select the **Quota type** that you want to increase. | 
+    | **New total limit** | Enter the new total limit that you want to request. |
+    | **Is it a limit decrease?** | Select **Yes** or **No**. |
+    | **Additional information** | Enter any extra information about your request. |
+
+    :::image type="content" source="media/how-to-request-capacity-increase/quota-details.png" alt-text="Screenshot of the Quota details pane." lightbox="media/how-to-request-capacity-increase/quota-details.png":::
+
+1. Select **Save and continue**.
+## Complete the support request
+
+To complete the support request, enter the following information:
+
+1. Complete the remainder of the support request **Additional details** tab using the following information:
+
+   ### Advanced diagnostic information
+
+   |Name |Value |
+   |---------|---------|
+   |**Allow collection of advanced diagnostic information**|Select yes or no.|
+
+   ### Support method
+
+   |Name |Value |
+   |---------|---------|
+   |**Support plan**|Select your support plan.|
+   |**Severity**|Select the severity of the issue.|
+   |**Preferred contact method**|Select email or phone.|
+   |**Your availability**|Enter your availability.|
+   |**Support language**|Select your language preference.|
+
+   ### Contact information
+
+   |Name |Value |
+   |---------|---------|
+   |**First name**|Enter your first name.|
+   |**Last name**|Enter your last name.|
+   |**Email**|Enter your contact email.|
+   |**Additional email for notification**|Enter an email for notifications.|
+   |**Phone**|Enter your contact phone number.|
+   |**Country/region**|Enter your location.|
+   |**Save contact changes for future support requests.**|Select the check box to save changes.|
+
+1. Select **Next**.
+
+1. On the **Review + create** tab, review the information, and then select **Create**.
+ 
+## Related content
+
+- To learn how to check your quota usage, see [Determine usage and quota](./how-to-determine-your-quota-usage.md).
+- Check the default quota for each resource type by subscription type: [Microsoft Dev Box limits](/azure/azure-resource-manager/management/azure-subscription-service-limits#microsoft-dev-box-limits)