idyl fleet-lease - IDYL Docs

View and manage this account’s leases on provider-operated capacity. A lease entitles you to deploy workloads against capacity a provider creates and runs for you. The fulfilling fleet stays the provider’s: it never appears among your own fleets and may be replaced without changing the lease. A lease’s terms are settled when it is created. Provider, capacity, term, and pricing are what you committed to and cannot be changed; the subnet the lease serves is set once, and cancelling is the only way to release it. Leases carry a name you choose and a 12-digit ID the platform assigns. Commands address a lease by its ID; the name is what a manifest matches on.

Usage

idyl fleet-lease

Aliases

fleet-leases
lease
leases

Commands

Command	Description
`idyl fleet-lease cancel`	Cancel a fleet lease
`idyl fleet-lease events`	Show what has been observed about a lease
`idyl fleet-lease get`	Get a fleet lease, or list them
`idyl fleet-lease rate-card`	Show the published price for leased capacity
`idyl fleet-lease usage`	Show a lease’s metered machine time

Inherited flags

Flag	Description
`-a <string>, --account-id <string>`	Account ID to use, overriding the current context.
`-c <string>, --context <string>`	Use the named context for this command.
`--homedir <string>`	Override the configuration directory. Defaults to ~/.config/idyl.
`-n <string>, --namespace <string>`	Namespace to address, overriding the entered context.
`--network <string>`	Override the Network for this command.
`-p <string>, --profile <string>`	Override the access profile for this command.
`-s <string>, --subnet <string>`	Subnet to use for this command, overriding the current context.
`--workspace <string>`	Workspace within the namespace, overriding the entered context.

Examples

idyl fleet-lease list
idyl fleet-lease get <lease-id>
idyl fleet-lease rate-card
idyl fleet-lease events <lease-id>
idyl fleet-lease usage <lease-id> --start 2026-08-01T00:00:00Z --end 2026-09-01T00:00:00Z
idyl fleet-lease cancel <lease-id>

Subcommand reference

`idyl fleet-lease cancel`

Cancel a fleet lease and release the capacity serving it. Cancellation is asynchronous: the lease stops placement, drains its workloads, and terminates through its status phases rather than disappearing on request. It is also the only way to release the subnet a lease serves, because a lease’s subnet is set once.

Usage

idyl fleet-lease cancel <lease-id> [flags]

Flags

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.
`-y, --yes`	Skip confirmation prompts.

Examples

idyl fleet-lease cancel <lease-id>

`idyl fleet-lease events`

Show a lease’s observed history, oldest first. A lease’s status says whether the capacity it entitles you to is serving. Its events say what happened on the way: the terms being accepted, capacity being built, machines that started and never joined, the lease being fulfilled, the steps of it winding down. The fulfilling fleet belongs to the provider, so this is the consumer’s view of that history: you learn that capacity was refused and which class of refusal it was, never the provider’s account, its roles, or text its cloud wrote. Identical consecutive observations are collapsed into one row that counts up. Use —watch to keep reading. Following resumes from the position each page ended at, so nothing is read twice and nothing is missed.

Usage

idyl fleet-lease events <lease-id> [flags]

Flags

Flag	Description
`--limit <uint>`	Maximum events to return per page; the platform may return fewer. Default: `0`.
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.
`-w, --watch`	Keep reading, printing events as they are observed.

Examples

idyl fleet-lease events <lease-id>
idyl fleet-lease events <lease-id> --watch
idyl fleet-lease events <lease-id> --limit 20 -o json

`idyl fleet-lease get`

Get one fleet lease, or list the account’s leases. With no argument, lists every lease the account holds. With a 12-digit lease ID, shows that lease: the terms it was signed with, the subnet it serves, and the fleet currently fulfilling it.

Usage

idyl fleet-lease get [lease-id] [flags]

Aliases

list
ls

Flags

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, yaml, or manifest (the resource as a manifest `idyl apply` accepts). Default: `table`.

Examples

idyl fleet-lease list
idyl fleet-lease get <lease-id>

`idyl fleet-lease rate-card`

Show the platform’s current published price for leased fleet capacity. The card prices one capacity shape — a cloud, a region, and an instance type — per entry. A lease must state the card’s price for the shape it asks for, and the accepted price is then locked to that lease for its whole life: republishing the card reprices new leases only. A shape the card does not price cannot be leased.

Usage

idyl fleet-lease rate-card [flags]

Flags

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.

Examples

idyl fleet-lease rate-card
idyl fleet-lease rate-card -o json

`idyl fleet-lease usage`

Show the machine time one lease metered over a window. Both bounds are required and neither is defaulted. Usage of an unbounded window has no meaning while machines are still running, and a window the caller did not choose is a number they would have no reason to trust. Times are RFC 3339. The start is inclusive and the end is exclusive, so a machine launched before the window or still running past its end reports only the part that falls inside. The rate shown is the one the lease locked when it was signed, echoed so the metered hours can be read against the price they meter at. It is not a charge: what a lease is invoiced is settled by billing.

Usage

idyl fleet-lease usage <lease-id> [flags]

Flags

Flag	Description
`--end <string>`	Required. End of the window, exclusive (RFC 3339).
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.
`--start <string>`	Required. Start of the window, inclusive (RFC 3339).

Examples

idyl fleet-lease usage <lease-id> --start 2026-08-01T00:00:00Z --end 2026-09-01T00:00:00Z

​Usage

​Aliases

​Commands

​Inherited flags

​Examples

​Subcommand reference

​idyl fleet-lease cancel

​Usage

​Flags

​Examples

​idyl fleet-lease events

​Usage

​Flags

​Examples

​idyl fleet-lease get

​Usage

​Aliases

​Flags

​Examples

​idyl fleet-lease rate-card

​Usage

​Flags

​Examples

​idyl fleet-lease usage

​Usage

​Flags

​Examples

Usage

Aliases

Commands

Inherited flags

Examples

Subcommand reference

`idyl fleet-lease cancel`

Usage

Flags

Examples

`idyl fleet-lease events`

Usage

Flags

Examples

`idyl fleet-lease get`

Usage

Aliases

Flags

Examples

`idyl fleet-lease rate-card`

Usage

Flags

Examples

`idyl fleet-lease usage`

Usage

Flags

Examples