A disposable Azure tenant for testing the code that reads one

When the simulator is worth it

Whether TenantLess is worth setting up depends mostly on the size of the estates your code has to handle. Move the slider to a size to see what an estate of that size looks like, what tends to break in code that reads it, and whether a simulator is the right tool at that point.

As a rough guide, hand-written fixtures are quicker below about 1,000 resources. Between 1,000 and 10,000, pagination and cross-references start to matter, and beyond 50,000 you are testing conditions you could not set up any other way.

Supported surface

TenantLess covers the ARM calls that a discovery scan makes rather than the whole of Azure, so compare this table with the calls your tool relies on.

• Any api-version is accepted, but it doesn't change the response shape, which always follows the versions listed above.
• A generated estate stays unchanged until you apply drift or, with writes enabled, modify it yourself. Nothing is actually running, so there are no live metrics or activity logs.
• The full matrix is in docs/compatibility.md.

Point a client at it

# pip install azure-mgmt-resource \
#   azure-mgmt-resource-subscriptions
from azure.core.credentials import AccessToken
from azure.mgmt.resource.resources import (
    ResourceManagementClient)
from azure.mgmt.resource.subscriptions import (
    SubscriptionClient)

class AnyToken:  # any non-empty bearer is accepted
    def get_token(self, *scopes, **kw):
        return AccessToken("tenantless", 2**31)

opts = dict(base_url="https://localhost:8443",
            connection_verify=False)  # self-signed cert

subs = list(SubscriptionClient(AnyToken(), **opts)
            .subscriptions.list())
rm = ResourceManagementClient(AnyToken(),
        subs[0].subscription_id, **opts)
print(len(subs), sum(1 for _ in rm.resources.list()))

# 50 131   (demo estate: 50 subscriptions,
#          131 resources over two pages)

What it simulates

TenantLess simulates seven planes of a real estate. Nothing it generates is provisioned, but everything is shaped like production, including pagination and error responses.