Skip to content
Delete automatically the useless resources in your Azure subscription.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Az Subscription Cleaner

Deploy to Azure GLO Board Serverless Library

Azure Subscription Cleaner

The Simple way to keep your Azure Subscription "clean". This run on a schedule and automatically delete all "expired" resources inside your Azure Subscription, and nothing else.

A Resource is "expired" when it has a tag expireOn older then the current date.

How to deploy

There is two version of this tool. One leveraging the Azure Function the second using Azure Automation. Both are valid options it just depends on your preferences.

Solution 1: with Azure Function

Created using the PowerShell Azure Function all details is available in the azure-function folder

Solution 2: with Azure Automation

The Azure Automation Runbook will execute a PowerShell Script base on a pre-define schedule.

All details are available in the azure-automation folder

To deploy all the resources in your Azure subscription, just click on the Deploy to Azure button.

How Does it works

By Default, the tool will get triggered every morning at 5am and search for any resources tagged with expireOn with a value in the past, and delete them.

Once all the "expired" resources are deleted. It will search for empty Resource Group and delete them too.

Manage Tags

To be able to delete some resources you need to tag them with a tag expireOn and a date as value following the format YYYY-MM-dd.

From the Azure Portal

To add a tag from the portal select any resource. Then from the left panel select the ** Tags** option and add a tag with the name expireOn and the desired date.


With PowerShell

The following PowerShell command will add an expireOn tag with the value "2019-08-29" to the resource named demoWebsite in the resource group summerDemo.

    Set-AzResource -ResourceId (Get-AzResource -ResourceGroupName summerDemo -Name demoWebsite).ResourceId -Tag @{expireOn="2019-08-29"}

You could also add tags to a resource group and all its resources. This script will add the tag expireOn with the value "2019-08-29" add populate all resources to this resource group with the same tags.

Set-AzResourceGroup -ResourceId (Get-AzResourceGroup -Name "StreamCleaner").ResourceId -Tag @{expireOn="2019-08-29"}

$group = Get-AzResourceGroup "StreamCleaner"
if ($null -ne $group.Tags) {
    $resources = Get-AzResource -ResourceGroupName $group.ResourceGroupName
    foreach ($r in $resources) {
        $resourcetags = (Get-AzResource -ResourceId $r.ResourceId).Tags
        if ($resourcetags) {
            foreach ($key in $group.Tags.Keys) {
                if (-not($resourcetags.ContainsKey($key))) {
                    $resourcetags.Add($key, $group.Tags.$key)
            Set-AzResource -Tag $resourcetags -ResourceId $r.ResourceId -Force
            Set-AzResource -Tag $group.Tags -ResourceId $r.ResourceId -Force

With Azure CLI

It's also possible using Azure CLI.

To add a tag `expireOn' with a value "2019-08-29" to the website demoWebsite IF the resource doesn't have existing tags, use:

az resource tag --tags expireOn=2019-08-29 -g summerDemo -n demoWebsite --resource-type "Microsoft.Web/sites"

This will delete any existing tags on that resource. If the resource has already tags use instead the following code.

To add a tag `expireOn' with a value "2019-08-29" to a website demoWebsite that already has tags, retrieve the existing tags, reformat that value, and reapply the existing and new tags:

jsonrtag=$(az resource show -g summerDemo -n demoWebsite --resource-type "Microsoft.Web/sites" --query tags)

rt=$(echo $jsonrtag | tr -d '"{},\n' | sed 's/: /=/g')

az resource tag --tags $rt expireOn=2019-08-29 -g summerDemo -n demoWebsite --resource-type "Microsoft.Web/sites"

To Learn more how to manage tags using PowerShell and Azure CLI visit

Azure Subscription

If you don't own an Azure subscription already, you can create your free account today. It comes with 200$ credit, so you can experience almost everything without spending a dime.

Create your free Azure account today

Current Status, Future Features

There is a Glo board to see what's in progress and on the road map. Feel free to great issues to request new feature or if you find bugs.

You can’t perform that action at this time.