{"id":24453,"library":"python-magnumclient","title":"python-magnumclient","description":"Client library for the OpenStack Magnum API, which manages containers and container orchestration engines (e.g., Kubernetes, Swarm). Current version 4.10.0, requires Python >=3.8. Releases follow OpenStack release cadence (approx. every 6 months with periodic stable updates).","status":"active","version":"4.10.0","language":"python","source_language":"en","source_url":"https://opendev.org/openstack/python-magnumclient","tags":["openstack","magnum","containers","kubernetes","client"],"install":[{"cmd":"pip install python-magnumclient","lang":"bash","label":"Default install"},{"cmd":"pip install python-magnumclient==4.10.0","lang":"bash","label":"Pin version"}],"dependencies":[{"reason":"Authentication and session handling for OpenStack APIs","package":"keystoneauth1","optional":false},{"reason":"OpenStackClient plugin support","package":"osc-lib","optional":false},{"reason":"Optional: for use as an OSC plugin","package":"python-openstackclient","optional":true}],"imports":[{"note":"Module is 'magnumclient', not 'magnum'","wrong":"from magnum import client","symbol":"client","correct":"from magnumclient import client"},{"note":"The class is 'Client', not 'MagnumClient'. Instantiate with Client() or Client(version='1', ...)","wrong":"from magnumclient import MagnumClient","symbol":"MagnumClient","correct":"from magnumclient.client import Client"}],"quickstart":{"code":"from magnumclient import client\nfrom keystoneauth1 import session as ks_session\nfrom keystoneauth1.identity import v3\n\nauth = v3.Password(auth_url='http://your-openstack:5000/v3',\n                  username='admin', password='secret',\n                  project_name='admin', user_domain_name='Default',\n                  project_domain_name='Default')\nsess = ks_session.Session(auth=auth)\nmagnum = client.Client(session=sess, interface='public', region_name='RegionOne')\nprint(magnum.clusters.list())\n","lang":"python","description":"Authenticate with OpenStack Keystone and list clusters."},"warnings":[{"fix":"Use Python >=3.8.","message":"Version 4.x dropped support for Python 2.7 and Python <3.8.","severity":"breaking","affected_versions":">=4.0.0"},{"fix":"Pass version='1' (or the API microversion you need) to Client().","message":"The commonly used 'magnumclient.client.Client()' may require explicit version argument; default version may not match your Magnum API.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Ensure Keystone catalog has 'container' service type, or pass endpoint_override directly.","message":"From version 3.x to 4.x, the 'magnum-api' service type changed from 'container-infra' to 'container' in Keystone catalog. Clients may fail to discover endpoints if configured with old service type.","severity":"breaking","affected_versions":">=4.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use 'from magnumclient import client'","cause":"Importing the wrong module name; correct module is 'magnumclient'.","error":"No module named 'magnum'"},{"fix":"Check Keystone service list for 'container' or set endpoint_override in the Client constructor.","cause":"Keystone does not have the required service type in the catalog. Typically the service type is 'container' (not 'container-infra').","error":"magnumclient.exceptions.EndpointNotFound: Could not find a suitable endpoint"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}