Registry / aws / python-manilaclient

python-manilaclient

library6.1.0pypypi✓ verified 87d ago

Python client library for the OpenStack Shared File Systems API (Manila). Current version 6.0.0, requires Python >=3.10. Release follows OpenStack cycle.

aws devops http-networking

pip install python-manilaclient

package ↗homepage ↗

INSTALL

IMPORT

SIG · PYTHON-MANILACLIEN

python-manilaclient

awspythonv6.1.0

Install

10.6s avg

Import

554ms

Disk

121MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v6.1.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.554s · 111.2MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 10.6s · import 0.554s · 113MB

121MB installed

● package 121MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

client

✓ from manilaclient import client

The correct import is from manilaclient (package name).

exceptions

✓ from manilaclient import exceptions

✗ from manilaclient.exceptions import *

Avoid wildcard imports; import specific exceptions like manilaclient.exceptions.ClientException.

shell

✓ from manilaclient import shell

For CLI usage, use the manila command, but programmatic shell access is via this module.

Authenticate and list shares.

import os from manilaclient import client # Use version 2 (default) or 1 version = '2' os_username = os.environ.get('OS_USERNAME', '') os_password = os.environ.get('OS_PASSWORD', '') os_tenant_name = os.environ.get('OS_TENANT_NAME', '') os_auth_url = os.environ.get('OS_AUTH_URL', '') # Authenticate and create client manila_client = client.Client(version, os_username, os_password, os_tenant_name, os_auth_url) # List shares shares = manila_client.shares.list() print(shares)

manila --version

Debug

Known issues

breakingSupport for v1 API removed in version 5.0.0. Use v2 API only.

fix

Use '2' as the version argument. Ensure your OpenStack deployment supports Manila v2.

affects: >=5.0.0

breakingMinimum required Python version is now 3.10 (as of 6.0.0).

fix

Upgrade Python environment to 3.10 or later.

affects: >=6.0.0

gotchaThe client expects OS_TENANT_NAME (or OS_PROJECT_NAME) for scoping; missing env vars cause authentication errors.

fix

Set OS_PROJECT_NAME or OS_TENANT_NAME in environment.

affects: all

deprecatedUse of auth_token parameter is deprecated; prefer session-based authentication.

fix

Pass a keystoneauth1 session using the 'session' parameter instead.

affects: <6.0.0

Errors

Common errors & fixes

manilaclient.exceptions.AmbiguousEndpoints: Endpoints for manila found multiple times

Multiple service endpoints in Keystone catalog (e.g., public and admin).

fix

Set the OS_ENDPOINT_TYPE environment variable to 'publicURL' or 'internalURL'.

manilaclient.exceptions.Unauthorized: Unauthorized (HTTP 401)

Invalid credentials or missing/incorrect OS_AUTH_URL, OS_USERNAME, OS_PASSWORD.

fix

Check OpenStack RC file and ensure environment variables are set correctly.

ImportError: cannot import name 'Client' from 'manilaclient'

Using older install or wrong import path (e.g., 'from manilaclient.client import Client').

fix

Use 'from manilaclient import client' and then instantiate 'client.Client(...)'.

manilaclient.exceptions.HttpException: The resource could not be found. (HTTP 404)

Specifying a share ID or snapshot ID that does not exist, or using v2 API on a v1-only endpoint.

fix

Verify resource IDs. If using v2, ensure Manila API v2 is enabled.

Upgrade

Version history

6.1.0latest on PyPI · released May 19, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

31 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/python-manilaclient/ ↗

homepagehttps://docs.openstack.org/python-manilaclient/ ↗