air_sdk

NVIDIA Air SDK.

This is the API reference for the air_sdk package. Use the navigation to browse individual modules:

endpoints — per-resource docs (simulations, nodes, images, etc.)
const — SDK constants and configuration values
exceptions — error types raised by the SDK
types — TypedDict and enum definitions used in API payloads

Subpackages

endpoints - API endpoint modules…

Submodules

types
exceptions - SDK-specific exceptions
const - Constants shared throughout the SDK.

Classes

Name	Description
`AirApi`	None

Module Contents

class air_sdk.AirApi(
    api_url: str = const.AIR_API_URL,
    authenticate: bool = True,
    api_key: str | None = None,
    username: str | None = None,
    password: str | None = None,
    bearer_token: str | None = None,
    auto_patch: bool = True
)

Initialization:

Initialize AirApi and optionally authenticate with a local NGC config.

For cleaner initialization, consider using one of the factory methods:

AirApi.with_api_key()
AirApi.with_device_login()
AirApi.with_ngc_config()

with_api_key(
    api_key: str,
    api_url: str = const.AIR_API_URL,
    auto_patch: bool = True
) -> AirApi

Initialize API with an explicit NGC API Key.

The api_key is also known as a Starfleet API Key, or ‘SAK’.

with_device_login(
    email: str,
    org_num: str,
    api_url: str = const.AIR_API_URL,
    auto_patch: bool = True
) -> AirApi

Initialize API with device login authentication.

with_ngc_config(
    api_url: str = const.AIR_API_URL,
    auto_patch: bool = True
) -> AirApi

Initialize API using NGC config for authentication.

auth_with_ngc_config() -> None

Authenticate with a local NGC config.

This method is called by the AirApi constructor if authenticate is True.

checkpoints: CheckpointEndpointAPI

histories: HistoryEndpointAPI

images: ImageEndpointAPI

image_shares: ImageShareEndpointAPI

image_publish_access_records: ImagePublishAccessRecordEndpointAPI

simulations: SimulationEndpointAPI

systems: SystemEndpointAPI

nodes: NodeEndpointAPI

interfaces: InterfaceEndpointAPI

breakouts: None

Decorators: @abstractmethod

Breakouts endpoint - not supported in current API version.

Raises:

NotImplementedError

links: LinkEndpointAPI

services: ServiceEndpointAPI

simulation_interfaces: InterfaceEndpointAPI

node_instructions: NodeInstructionEndpointAPI

simulation_nodes: NodeEndpointAPI

ztp_scripts: ZTPScriptEndpointAPI

workers: WorkerEndpointAPI

worker_client_certificates: WorkerClientCertificateEndpointAPI

fleets: FleetEndpointAPI

marketplace_demos: MarketplaceDemoEndpointAPI

marketplace_demo_publish_access_records: MarketplaceDemoPublishAccessRecordEndpointAPI

marketplace_demo_tags: MarketplaceDemoTagEndpointAPI

ssh_keys: SSHKeyEndpointAPI

trainings: TrainingEndpointAPI

plugin_image_manifests: PluginImageManifestEndpointAPI

manifests: PluginImageManifestEndpointAPI

os_image_manifests: OSImageManifestEndpointAPI

os_templates: OSTemplateEndpointAPI

platform_information: PlatformInformationEndpointAPI

cloud_inits: CloudInitEndpointAPI

Cloud-init endpoint for V2 backwards compatibility.

user_configs: UserConfigEndpointAPI

organizations: OrganizationEndpointAPI

Organization / Resource Budget endpoint.

resource_budgets: OrganizationEndpointAPI

Resource Budget endpoint (alias for organizations).

topologies: None

Decorators: @abstractmethod

Topologies endpoint - not supported in current API version.

Raises:

NotImplementedError

api_tokens: None

Decorators: @abstractmethod

API Tokens endpoint - not supported in current API version.

Raises:

NotImplementedError

permissions: None

Decorators: @abstractmethod

Permissions endpoint - not supported in current API version.

Raises:

NotImplementedError

permission: None

Decorators: @abstractmethod

Permission endpoint - not supported in current API version.

Raises:

NotImplementedError

accounts: None

Decorators: @abstractmethod

Accounts endpoint - not supported in current API version.

Raises:

NotImplementedError

simulation: SimulationEndpointAPI

Deprecated alias for simulations (v1 backward compatibility).

service: ServiceEndpointAPI

Deprecated alias for services (v1 backward compatibility).

set_connect_timeout(t_delta: datetime.timedelta) -> None

set_read_timeout(t_delta: datetime.timedelta) -> None

set_page_size(n: int) -> None

Set the page size of paginated responses.