upcloud-api

What it is and what it does

upcloud-api is an object-oriented Python wrapper around UpCloud's cloud infrastructure API. It provides classes for servers, storage, and networking resources, allowing you to create, modify, and destroy cloud infrastructure programmatically. The package handles authentication, request marshalling, and response parsing, so you work with Python objects rather than raw HTTP calls.

The client is designed for both direct scripting and integration into larger automation tools like Ansible. It includes convenience methods that combine multiple API calls (e.g., stop-and-destroy) and helper functions for common tasks like retrieving public IPs or converting resources to dictionaries. The documentation recommends testing thoroughly before production use and suggests using a separate UpCloud account for development.

Use it for:

• Automate server provisioning and teardown in CI/CD pipelines or infrastructure-as-code workflows.
• Build custom dashboards or monitoring tools that query server state and resource usage across your UpCloud account.
• Implement dynamic scaling logic that creates or destroys servers based on application demand.
• Clone existing server configurations or storage volumes to quickly spin up new environments.
• Manage server lifecycle operations (start, stop, upgrade, destroy) from Python scripts or scheduled tasks.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Object-oriented Python client for UpCloud's cloud infrastructure API, enabling programmatic management of servers, storage, and networking resources.

Yes. The package is actively maintained, has low install friction, carries a permissive MIT license, and integrates cleanly with a single well-known dependency. It is suitable for anyone managing UpCloud infrastructure programmatically. Test your use cases thoroughly before production deployment, as the documentation emphasizes, and consider using a separate dev account initially.

Install

upcloud-api on PyPI

pip install upcloud-api

uv add upcloud-api

poetry add upcloud-api

Installing upcloud-api

Before you install

Low friction install with a single dependency (requests). Actively maintained with recent commits and a release within the past year. Supports modern Python versions (3.9–3.13 and PyPy3).

License in practice

MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute this package freely provided you include the license notice.

Quickstart

pip install upcloud-api

from upcloud_api import CloudManager, Credentials

credentials = Credentials.parse()
manager = CloudManager(**credentials.dict)
manager.get_account()

Requires valid UpCloud API credentials (username and password or environment variables); the package does not authenticate without them.

Verify before relying

• Whether the convenience functions that combine multiple API endpoints cover the most common workflows or require custom orchestration.
• Performance characteristics and rate-limiting behavior when managing large numbers of servers or storage resources.
• Completeness of API coverage relative to the current UpCloud API specification version.

Package facts

Evidence: upcloud_api-2.9.0-py3-none-any.whl

Tags

More Internet packages