Skip to content

Commit a4251a0

Browse files
committed
WIP
1 parent 4e3c0f9 commit a4251a0

File tree

3 files changed

+36
-25
lines changed

3 files changed

+36
-25
lines changed

articles/dev-box/how-to-auto-delete-dev-box.md

Lines changed: 32 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -17,59 +17,68 @@ ms.custom:
1717

1818
# Configure Microsoft Dev Box autodeletion
1919

20-
Microsoft Dev Box autodeletion (public preview) helps organizations manage resources and control costs by automatically deleting unused Dev Boxes. This article explains how to enable the feature, configure autodeletion settings, and cancel scheduled deletions in both the Azure portal and developer portal. Use these steps to optimize Dev Box usage in your Azure subscription.
20+
Microsoft Dev Box Auto Delete (Preview) helps organizations manage resources and control costs by automatically deleting unused Dev Boxes. This article explains how to enable the feature, configure autodeletion settings, and cancel scheduled deletions in both the Azure portal and developer portal. Use these steps to optimize Dev Box usage in your Azure subscription.
2121

2222
## Prerequisites
2323

2424
- Microsoft Dev Box configured with a dev center and at least one project.
2525

2626
## Enable the preview feature
2727

28-
To enable the Dev Box autodeletion feature in your Azure subscription, follow these steps:
28+
While Dev Box Auto Delete feature is in Preview, you must manually enable it in your Azure subscription. Follow these steps:
2929

30-
1. Go to the Azure subscription where you want to enable the Dev Box autodeletion feature.
31-
1. In the navigation pane, select **Preview features**.
32-
1. Type "auto delete" in the search box.
33-
1. Select **Dev Box Auto Delete Preview**, and follow the prompts to register this feature to your subscription.
34-
35-
After you register the feature, it will be enabled for your subscription.
30+
1. Sign in to the [Azure portal](https://portal.azure.com).
31+
1. Go to the Azure subscription where you want to enable Dev Box autodeletion.
32+
1. In the left menu, select **Preview features**.
33+
1. In the search box, type "Dev Box Auto".
34+
1. Select **Dev Box Auto Delete Preview**, and the select **Register**.
3635

3736
:::image type="content" source="media/how-to-auto-delete-dev-box/dev-box-auto-delete-enable-preview.png" alt-text="Screenshot of the Azure portal showing the Preview features pane with Dev Box Auto Delete Preview selected.":::
38-
37+
38+
After you register the feature, it will be available for use in your subscription.
39+
3940
## Set up autodeletion in a project
4041

41-
To configure autodeletion for unused Dev Boxes in a project, follow these steps in the Azure portal:
42+
To configure autodeletion for unused dev boxes in a project, follow these steps in the Azure portal:
4243

4344
1. Open an existing Dev Box project, or create a new one in your subscription.
44-
1. Go to **Settings > Dev box settings**.
45-
1. Go to the **Cost controls** section.
46-
1. Select **Automatically delete unused dev boxes**.
47-
1. Set the following options:
48-
- Inactivity threshold: Enter the number of inactive days before a Dev Box is scheduled for automatic deletion (for example, 7 days).
49-
- Grace period: Enter the number of days the developer or admin has to respond and keep the Dev Box (for example, 7 days).
45+
1. In the left menu, under **Settings**, select **Dev box settings**.
46+
1. On the **Dev box settings** page, in the **Cost controls** section, select **Automatically delete unused dev boxes**.
47+
48+
:::image type="content" source="media/how-to-auto-delete-dev-box/dev-box-auto-delete-enable.png" alt-text="Screenshot of the Azure portal showing the option to enable automatic deletion of unused dev boxes in project settings.":::
49+
50+
1. When automatic deletion is enabled, you can configure the following options:
51+
- **Inactivity threshold**: Enter the number of inactive days before a Dev Box is scheduled for automatic deletion (for example, 7 days).
52+
- **Grace period**: Enter the number of days the developer or admin has to respond and keep the Dev Box (for example, 7 days).
5053

5154
:::image type="content" source="media/how-to-auto-delete-dev-box/dev-box-auto-delete-settings.png" alt-text="Screenshot of the Dev box settings page in Azure portal showing the cost controls section with autodeletion options.":::
5255

56+
1. Select **Apply**.
57+
5358
## Cancel scheduled deletions in the Azure portal
5459

5560
To cancel a scheduled deletion in the Azure portal, follow these steps:
5661

5762
1. Go to the pool that has your Dev Box scheduled for deletion.
5863
1. Select that pool to view its Dev Boxes. You need Project Admin access to finish this step.
5964
1. Select the ellipses (**...**) next to the Dev Box scheduled for deletion.
60-
1. Select **Cancel deletion**. The selected Dev Box isn't deleted.
65+
1. Select **Cancel deletion**.
6166

62-
:::image type="content" source="media/how-to-auto-delete-dev-box/dev-box-azure-portal-cancel-auto-delete.png" alt-text="Screenshot of the Azure portal showing the pool details and the cancel deletion option for a Dev Box.":::
67+
:::image type="content" source="media/how-to-auto-delete-dev-box/dev-box-azure-portal-cancel-auto-delete.png" alt-text="Screenshot of the Azure portal showing the pool details and the cancel deletion option for a Dev Box.":::
6368

64-
## Cancel scheduled deletions in the developer portal
69+
The selected dev box isn't deleted.
6570

66-
Developers get an email notification when their Dev Box is scheduled for deletion after reaching the inactivity threshold.
71+
## Cancel scheduled deletions in the developer portal
6772

68-
1. Go to the Dev Box developer portal to cancel the scheduled deletion if you still need the Dev Box.
69-
1. In the developer portal, find the scheduled deletion notice.
73+
After reaching the inactivity threshold, you'll get an email notification warning you that your Dev Box is scheduled for deletion. If you want to cancel the scheduled deletion and keep your dev box, follow these steps:
74+
75+
1. Sign in to the [developer portal](https://aka.ms/devbox-portal).
76+
1. In the developer portal, find the dev box scheduled for deletion.
7077
1. Select **Keep this dev box** to cancel the automatic deletion.
7178

72-
:::image type="content" source="media/how-to-auto-delete-dev-box/dev-box-developer-portal-keep.png" alt-text="Screenshot of the Dev Box developer portal showing the scheduled deletion notice and the option to keep the dev box.":::
79+
:::image type="content" source="media/how-to-auto-delete-dev-box/dev-box-developer-portal-keep.png" alt-text="Screenshot of the Dev Box developer portal showing the scheduled deletion notice and the option to keep the dev box.":::
80+
81+
The selected dev box isn't deleted.
7382

7483
## Related content
7584

-1.67 KB
Loading

articles/dev-box/toc.yml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,7 @@ items:
105105
- name: Connect to a dev box with a dev tunnel
106106
href: how-to-set-up-dev-tunnels.md
107107
- name: AI on Dev Box
108-
items:
108+
items:
109109
- name: Configure Serverless GPU
110110
href: how-to-configure-dev-box-serverless-gpu.md
111111
- name: Security
@@ -136,6 +136,8 @@ items:
136136
href: how-to-configure-stop-on-disconnect.md
137137
- name: Skip or delay an automatic shutdown
138138
href: how-to-skip-delay-stop.md
139+
- name: Automatically delete unused dev boxes
140+
href: how-to-auto-delete-dev-box.md
139141
- name: Connect devices to dev boxes
140142
items:
141143
- name: Connect physical devices to a dev box
@@ -172,7 +174,7 @@ items:
172174
href: how-to-get-help.md
173175
- name: Reference
174176
items:
175-
- name: 'Reference: imagedefinition.yaml and task.yaml files'
177+
- name: "Reference: imagedefinition.yaml and task.yaml files"
176178
href: reference-dev-box-customizations.md
177179
displayName: Customize, schema, yaml, imagedefinition, task
178180
- name: Install Azure CLI devcenter extension

0 commit comments

Comments
 (0)