Skip to content
microvms-agentd

Region

View as MarkdownOpen in ChatGPTOpen in ClaudeOpen in Claude CodeOpen in Cursor
@final
class Region

An AWS region, by its name.

Region.parse takes any well-formed region name; the five named constructors cover the regions of AWS’s first MicroVMs launch.

Constructor

Section titled “Constructor”

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

Properties

Section titled “Properties”

is_measured

Section titled “is_measured”
is_measured: bool

Whether AWS was measured running MicroVMs here: membership in Region.measured().

is_supported

Section titled “is_supported”
is_supported: bool

Deprecated since 1.3.0: use is_measured.

Whether this is one of the five named regions, as in 1.2, and a DeprecationWarning.

name

Section titled “name”
name: str

The wire spelling, which is also the endpoint’s middle segment.

Methods

Section titled “Methods”

ap_northeast_1

Section titled “ap_northeast_1”
@staticmethod
def ap_northeast_1() -> Region

eu_west_1

Section titled “eu_west_1”
@staticmethod
def eu_west_1() -> Region

measured

Section titled “measured”
@staticmethod
def measured() -> list[Region]

The regions AWS was measured running MicroVMs in: the 14 the Pricing API priced on 2026-10-24.

parse

Section titled “parse”
@staticmethod
def parse(name: str) -> Region

Any well-formed region name, or InvalidArgError for a malformed one.

The boundary a region name arrives at from an environment variable or a config file, where it is still a string. The check is the core’s FromStr, message and all — this is a call, not a check written here.

supported

Section titled “supported”
@staticmethod
def supported() -> list[Region]

Deprecated since 1.3.0: AWS runs MicroVMs in more regions than these five; use Region.measured().

The five named regions, as 1.2 returned, and a DeprecationWarning.

unlisted

Section titled “unlisted”
@staticmethod
def unlisted(name: str) -> Region

Deprecated since 1.3.0: Region.parse takes any well-formed region name.

Builds the region without the shape check, as 1.2 did, and raises a DeprecationWarning. Region.unlisted("us-east-1") == Region.us_east_1().

us_east_1

Section titled “us_east_1”
@staticmethod
def us_east_1() -> Region

us_east_2

Section titled “us_east_2”
@staticmethod
def us_east_2() -> Region

us_west_2

Section titled “us_west_2”
@staticmethod
def us_west_2() -> Region

Special methods

Section titled “Special methods”

__eq__

Section titled “__eq__”
def __eq__(other: object, /) -> bool

__hash__

Section titled “__hash__”
def __hash__() -> int

__repr__

Section titled “__repr__”
def __repr__() -> str

__str__

Section titled “__str__”
def __str__() -> str

Provenance

Section titled “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.