> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/dsx-air/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/dsx-air/_mcp/server.

# air_sdk.endpoints.systems

Stub file for systems endpoint type hints.

## Classes

| Name                                                             | Description                                             |
| ---------------------------------------------------------------- | ------------------------------------------------------- |
| [`System`](#air_sdkendpointssystemssystem)                       | System model representing a system in the AIR platform. |
| [`SystemEndpointAPI`](#air_sdkendpointssystemssystemendpointapi) | API client for System endpoints.                        |

## Module Contents

```python
class air_sdk.endpoints.systems.System
```

**Bases**: `air_sdk.air_model.AirModel`

System model representing a system in the AIR platform.

```python
id: str
```

```python
created: datetime.datetime
```

```python
modified: datetime.datetime
```

```python
name: str
```

```python
simulation: Simulation | None
```

```python
image: Image
```

```python
memory: int
```

```python
storage: int
```

```python
cpu: int
```

```python
category: str
```

```python
labels: dict[str, Any] | None
```

```python
split_options: list[int] | None
```

```python
get_model_api() -> type[SystemEndpointAPI]
```

```python
model_api: SystemEndpointAPI
```

```python
class air_sdk.endpoints.systems.SystemEndpointAPI
```

**Bases**: `air_sdk.air_model.BaseEndpointAPI[air_sdk.endpoints.systems.System]`

API client for System endpoints.

```python
API_PATH: str
```

```python
model: type[System]
```

```python
list(
    *,
    limit: int = ...,
    offset: int = ...,
    ordering: str = ...,
    search: str = ...,
    labels__group: str = ...,
    labels__model: str = ...,
    labels__sku: str = ...,
    category: str = ...,
    id: str = ...,
    image: Image | PrimaryKey = ...,
    name: str = ...,
    simulation: Simulation | PrimaryKey = ...
) -> Iterator[System]
```

List all systems with optional filtering.

**Parameters:**

* `limit` – Maximum number of results to return per page
* `offset` – The initial index from which to return the results
* `ordering` – Order objects by field. Prefix with "-" for desc order
* `search` – Search by name
* `labels__group` – Filter by group
* `labels__model` – Filter by model
* `labels__sku` – Filter by sku
* `category` – Filter by category
* `id` – Filter by ID
* `image` – Filter by image
* `simulation` – Filter by simulation

**Returns:**

Iterator of System instances

**Example:**

```python
>>> # List all systems
>>> for system in api.systems.list():
...     print(system.name)

>>> # Search by name
>>> for system in api.systems.list(search='my-system'):
...     print(system.name)

>>> # Order by name descending
>>> for system in api.systems.list(ordering='-name'):
...     print(system.name)
```

```python
get(pk: PrimaryKey) -> System
```

Get a specific system by ID.

**Parameters:**

* `pk` – The system ID (string or UUID)

**Returns:**

The System instance

**Example:**

```python
>>> system = api.systems.get('system-id')
>>> print(system.name)
```