---
title: IdlePolicy
description: The idle policy the service reports a VM is running under.
---

```python
@final
class IdlePolicy
```

The idle policy the service reports a VM is running under.

## Constructor

`IdlePolicy` declares no `__new__` or `__init__`, so it is not constructed directly: an instance comes back from another call in this package.

## Properties

### `auto_resume`

```python
auto_resume: bool
```

`autoResumeEnabled`: whether a request to a suspended VM resumes it.

### `max_idle_sec`

```python
max_idle_sec: int
```

`maxIdleDurationSeconds`: inbound-traffic silence before an auto-suspend.

### `suspended_sec`

```python
suspended_sec: int
```

`suspendedDurationSeconds`: how long a suspended VM lasts before it is terminated.

## Special methods

### `__repr__`

```python
def __repr__() -> str
```

## Provenance

This page is generated from `bindings/microvms-py/microvms.pyi` by Griffe 2.3.0, run from `site/scripts/gen-reference.mjs` on every `pnpm run sync`, so an edit made here is overwritten by the next run.

To change the page, change the doc comment in the binding's Rust source, then regenerate the declarations with `mise run stubs`. `mise run stubs:check` fails when the committed file no longer matches the source.