========================
Team and repository tags
========================
.. image:: https://governance.openstack.org/tc/badges/python-cinderclient.svg
:target: https://governance.openstack.org/tc/reference/tags/index.html
.. Change things from this point on
Python bindings to the OpenStack Cinder API
===========================================
.. image:: https://img.shields.io/pypi/v/python-cinderclient.svg
:target: https://pypi.org/project/python-cinderclient/
:alt: Latest Version
This is a client for the OpenStack Cinder API. There's a Python API (the
``cinderclient`` module), and a command-line script (``cinder``). Each
implements 100% of the OpenStack Cinder API.
See the `OpenStack CLI Reference`_ for information on how to use the ``cinder``
command-line tool. You may also want to look at the
`OpenStack API documentation`_.
.. _OpenStack CLI Reference: https://docs.openstack.org/python-openstackclient/latest/cli/
.. _OpenStack API documentation: https://docs.openstack.org/api-quick-start/
The project is hosted on `Launchpad`_, where bugs can be filed. The code is
hosted on `OpenStack`_. Patches must be submitted using `Gerrit`_.
.. _OpenStack: https://opendev.org/openstack/python-cinderclient
.. _Launchpad: https://launchpad.net/python-cinderclient
.. _Gerrit: https://docs.openstack.org/infra/manual/developers.html#development-workflow
* License: Apache License, Version 2.0
* `PyPi`_ - package installation
* `Online Documentation`_
* `Blueprints`_ - feature specifications
* `Bugs`_ - issue tracking
* `Source`_
* `Specs`_
* `How to Contribute`_
.. _PyPi: https://pypi.org/project/python-cinderclient
.. _Online Documentation: https://docs.openstack.org/python-cinderclient/latest/
.. _Blueprints: https://blueprints.launchpad.net/python-cinderclient
.. _Bugs: https://bugs.launchpad.net/python-cinderclient
.. _Source: https://opendev.org/openstack/python-cinderclient
.. _How to Contribute: https://docs.openstack.org/infra/manual/developers.html
.. _Specs: https://specs.openstack.org/openstack/cinder-specs/
.. contents:: Contents:
:local:
Command-line API
----------------
Installing this package gets you a shell command, ``cinder``, that you
can use to interact with any Rackspace compatible API (including OpenStack).
You'll need to provide your OpenStack username and password. You can do this
with the ``--os-username``, ``--os-password`` and ``--os-tenant-name``
params, but it's easier to just set them as environment variables::
export OS_USERNAME=openstack
export OS_PASSWORD=yadayada
export OS_TENANT_NAME=myproject
You will also need to define the authentication url with ``--os-auth-url``
and the version of the API with ``--os-volume-api-version``. Or set them as
environment variables as well. Since Block Storage API V2 is officially
deprecated, you are encouraged to set ``OS_VOLUME_API_VERSION=3``. If you
are using Keystone, you need to set the ``OS_AUTH_URL`` to the keystone
endpoint::
export OS_AUTH_URL=http://controller:5000/v3
export OS_VOLUME_API_VERSION=3
Since Keystone can return multiple regions in the Service Catalog, you
can specify the one you want with ``--os-region-name`` (or
``export OS_REGION_NAME``). It defaults to the first in the list returned.
You'll find complete documentation on the shell by running
``cinder help``::
usage: cinder [--version] [-d] [--os-auth-system <auth-system>]
[--service-type <service-type>] [--service-name <service-name>]
[--volume-service-name <volume-service-name>]
[--os-endpoint-type <os-endpoint-type>]
[--endpoint-type <endpoint-type>]
[--os-volume-api-version <volume-api-ver>]
[--retries <retries>]
[--profile HMAC_KEY] [--os-auth-strategy <auth-strategy>]
[--os-username <auth-user-name>] [--os-password <auth-password>]
[--os-tenant-name <auth-tenant-name>]
[--os-tenant-id <auth-tenant-id>] [--os-auth-url <auth-url>]
[--os-user-id <auth-user-id>]
[--os-user-domain-id <auth-user-domain-id>]
[--os-user-domain-name <auth-user-domain-name>]
[--os-project-id <auth-project-id>]
[--os-project-name <auth-project-name>]
[--os-project-domain-id <auth-project-domain-id>]
[--os-project-domain-name <auth-project-domain-name>]
[--os-region-name <region-name>] [--os-token <token>]
[--os-url <url>] [--insecure] [--os-cacert <ca-certificate>]
[--os-cert <certificate>] [--os-key <key>] [--timeout <seconds>]
<subcommand> ...
Command-line interface to the OpenStack Cinder API.
Positional arguments:
<subcommand>
absolute-limits Lists absolute limits for a user.
api-version Display the server API version information. (Supported
by API versions 3.0 - 3.latest)
availability-zone-list
Lists all availability zones.
backup-create Creates a volume backup.
backup-delete Removes one or more backups.
backup-export Export backup metadata record.
backup-import Import backup metadata record.
backup-list Lists all backups.
backup-reset-state Explicitly updates the backup state.
backup-restore Restores a backup.
backup-show Shows backup details.
cgsnapshot-create Creates a cgsnapshot.
cgsnapshot-delete Removes one or more cgsnapshots.
cgsnapshot-list Lists all cgsnapshots.
cgsnapshot-show Shows cgsnapshot details.
consisgroup-create Creates a consistency group.
consisgroup-create-from-src
Creates a consistency group from a cgsnapshot or a
source CG.
consisgroup-delete Removes one or more consistency groups.
consisgroup-list Lists all consistency groups.
consisgroup-show Shows details of a consistency group.
consisgroup-update Updates a consistency group.
create Creates a volume.
credentials Shows user credentials returned from auth.
delete Removes one or more volumes.
encryption-type-create
Creates encryption type for a volume type. Admin only.
encryption-type-delete
Deletes encryption type for a volume type. Admin only.
encryption-type-list
Shows encryption type details for volume types. Admin
only.
encryption-type-show
Shows encryption type details for a volume type. Admin
only.
encryption-type-update
Update encryption type information for a volume type
(Admin Only).
endpoints Discovers endpoints registered by authentication
service.
extend Attempts to extend size of an existing volume.
extra-specs-list Lists current volume types and extra specs.
failover-host Failover a replicating cinder-volume host.
force-delete Attempts force-delete of volume, regardless of state.
freeze-host Freeze and disable the specified cinder-volume host.
get-capabilities Show backend volume stats and properties. Admin only.
get-pools Show pool information for backends. Admin only.
image-metadata Sets or deletes volume image metadata.
image-metadata-show
Shows volume image metadata.
list Lists all volumes.
manage Manage an existing volume.
metadata Sets or deletes volume metadata.
metadata-show Shows volume metadata.
metadata-update-all
Updates volume metadata.
migrate Migrates volume to a new host.
qos-associate Associates qos specs with specified volume type.
qos-create Creates a qos specs.
qos-delete Deletes a specified qos specs.
qos-disassociate Disassociates qos specs from specified volume type.
qos-disassociate-all
Disassociates qos specs from all its associations.
qos-get-association
Lists all associations for specified qos specs.
qos-key Sets or unsets specifications for a qos spec.
qos-list Lists qos specs.
qos-show Shows qos specs details.
quota-class-show Lists quotas for a quota class.
quota-class-update Updates quotas for a quota class.
quota-defaults Lists default quotas for a tenant.
quota-delete Delete the quotas for a tenant.
quota-show Lists quotas for a tenant.
quota-update Updates quotas for a tenant.
quota-usage Lists quota usage for a tenant.
rate-limits Lists rate limits for a user.
readonly-mode-update
Updates volume read-only access-mode flag.
rename Renames a volume.
reset-state Explicitly updates the volume state in the Cinder
database.
retype Changes the volume type for a volume.
service-disable Disables the service.
service-enable Enables the service.
service-list Lists all services. Filter by host and service binary.
(Supported by API versions 3.0 - 3.latest)
set-bootable Update bootable status of a volume.
show Shows volume details.
snapshot-create Creates a snapshot.
snapshot-delete Removes one or more snapshots.
snapshot-list Lists all snapshots.
snapshot-manage Manage an existing snapshot.
snapshot-metadata Sets or deletes snapshot metadata.
snapshot-metadata-show
Shows snapshot metadata.
snapshot-metadata-update-all
Updates snapshot metadata.
snapshot-rename Renames a snapshot.
snapshot-reset-state
Explicitly updates the snapshot state.
snapshot-show Shows snapshot details.
snapshot-unmanage Stop managing a snapshot.
thaw-host Thaw and enable the specified cinder-volume host.
transfer-accept Accepts a volume transfer.
transfer-create Creates a volume transfer.
transfer-delete Undoes a transfer.
transfer-list Lists all transfers.
transfer-show Shows transfer details.
type-access-add Adds volume type access for the given project.
type-access-list Print access information about the given volume type.
type-access-remove Removes volume type access for the given project.
type-create Creates a volume type.
type-default List the default volume type.
type-delete Deletes volume type or types.
type-key Sets or unsets extra_spec for a volume type.
type-list Lists available 'volume types'.
type-show Show volume type details.
type-update Updates volume type name, description, and/or
is_public.
unmanage Stop managing a volume.
upload-to-image Uploads volume to Image Service as an image.
version-list List all API versions. (Supported by API versions 3.0
- 3.latest)
bash-completion Prints arguments for bash_completion.
help Shows help about this program or one of its
subcommands.
list-extensions
Optional arguments:
--version show program's version number and exit
-d, --debug Shows debugging output.
--os-auth-system <auth-system>
Defaults to env[OS_AUTH_SYSTEM].
--service-type <service-type>
Service type. For most actions, default is volume.
--service-name <service-name>
Service name. Default=env[CINDER_SERVICE_NAME].
--volume-service-name <volume-service-name>
Volume service name.
Default=env[CINDER_VOLUME_SERVICE_NAME].
--os-endpoint
Use this API endpoint instead of the Service Catalog.
Default=env[CINDER_ENDPOINT]
--os-endpoint-type <os-endpoint-type>
Endpoint type, which is publicURL or internalURL.
Default=env[OS_ENDPOINT_TYPE] or nova
env[CINDER_ENDPOINT_TYPE] or publicURL.
--endpoint-type <endpoint-type>
DEPRECATED! Use --os-endpoint-type.
--os-volume-api-version <volume-api-ver>
Block Storage API version. Accepts X, X.Y (where X is
major and Y is minor
part).Default=env[OS_VOLUME_API_VERSION].
--retries <retries> Number of retries.
--profile HMAC_KEY HMAC key to use for encrypting context data for
performance profiling of operation. This key needs to
match the one configured on the cinder api server.
Without key the profiling will not be triggered even
if osprofiler is enabled on server side.
Defaults to env[OS_PROFILE].
--os-auth-strategy <auth-strategy>
Authentication strategy (Env: OS_AUTH_STRATEGY,
default keystone). For now, any other value will
disable the authentication.
--os-username <auth-user-name>
OpenStack user name. Default=env[OS_USERNAME].
--os-password <auth-password>
Password for OpenStack user. Default=env[OS_PASSWORD].
--os-tenant-name <auth-tenant-name>
Tenant name. Default=env[OS_TENANT_NAME].
--os-tenant-id <auth-tenant-id>
ID for the tenant. Default=env[OS_TENANT_ID].
--os-auth-url <auth-url>
URL for the authentication service.
Default=env[OS_AUTH_URL].
--os-user-id <auth-user-id>
Authentication user ID (Env: OS_USER_ID).
--os-user-domain-id <auth-user-domain-id>
OpenStack user domain ID. Defaults to
env[OS_USER_DOMAIN_ID].
--os-user-domain-name <auth-user-domain-name>
OpenStack user domain name. Defaults to
env[OS_USER_DOMAIN_NAME].
--os-project-id <auth-project-id>
Another way to specify tenant ID. This option is
mutually exclusive with --os-tenant-id. Defaults to
env[OS_PROJECT_ID].
--os-project-name <auth-project-name>
Another way to specify tenant name. This option is
mutually exclusive with --os-tenant-name. Defaults to
env[OS_PROJECT_NAME].
--os-project-domain-id <auth-project-domain-id>
Defaults to env[OS_PROJECT_DOMAIN_ID].
--os-project-domain-name <auth-project-domain-name>
Defaults to env[OS_PROJECT_DOMAIN_NAME].
--os-region-name <region-name>
Region name. Default=env[OS_REGION_NAME].
--os-token <token> Defaults to env[OS_TOKEN].
--os-url <url> Defaults to env[OS_URL].
API Connection Options:
Options controlling the HTTP API Connections
--insecure Explicitly allow client to perform "insecure" TLS
(https) requests. The server's certificate will not be
verified against any certificate authorities. This
option should be used with caution.
--os-cacert <ca-certificate>
Specify a CA bundle file to use in verifying a TLS
(https) server certificate. Defaults to
env[OS_CACERT].
--os-cert <certificate>
Defaults to env[OS_CERT].
--os-key <key> Defaults to env[OS_KEY].
--timeout <seconds> Set request timeout (in seconds).
Run "cinder help SUBCOMMAND" for help on a subcommand.
If you want to get a particular version API help message, you can add
``--os-volume-api-version <volume-api-ver>`` in help command, like
this::
cinder --os-volume-api-version 3.28 help
Python API
----------
There's also a complete Python API, but it has not yet been documented.
Quick-start using keystone::
# use v3 auth with http://controller:5000/v3
>>> from cinderclient.v3 import client
>>> nt = client.Client(USERNAME, PASSWORD, PROJECT_ID, AUTH_URL)
>>> nt.volumes.list()
[...]
See release notes and more at `<https://docs.openstack.org/python-cinderclient/latest/>`_.
Raw data
{
"_id": null,
"home_page": "https://docs.openstack.org/python-cinderclient/latest/",
"name": "python-cinderclient",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "",
"author": "OpenStack",
"author_email": "openstack-discuss@lists.openstack.org",
"download_url": "https://files.pythonhosted.org/packages/c5/ac/2a7e767ca2058af6ab9b257bef8cde23b607719ff876602ddb72f6104aa8/python-cinderclient-9.5.0.tar.gz",
"platform": null,
"description": "========================\nTeam and repository tags\n========================\n\n.. image:: https://governance.openstack.org/tc/badges/python-cinderclient.svg\n :target: https://governance.openstack.org/tc/reference/tags/index.html\n\n.. Change things from this point on\n\nPython bindings to the OpenStack Cinder API\n===========================================\n\n.. image:: https://img.shields.io/pypi/v/python-cinderclient.svg\n :target: https://pypi.org/project/python-cinderclient/\n :alt: Latest Version\n\nThis is a client for the OpenStack Cinder API. There's a Python API (the\n``cinderclient`` module), and a command-line script (``cinder``). Each\nimplements 100% of the OpenStack Cinder API.\n\nSee the `OpenStack CLI Reference`_ for information on how to use the ``cinder``\ncommand-line tool. You may also want to look at the\n`OpenStack API documentation`_.\n\n.. _OpenStack CLI Reference: https://docs.openstack.org/python-openstackclient/latest/cli/\n.. _OpenStack API documentation: https://docs.openstack.org/api-quick-start/\n\nThe project is hosted on `Launchpad`_, where bugs can be filed. The code is\nhosted on `OpenStack`_. Patches must be submitted using `Gerrit`_.\n\n.. _OpenStack: https://opendev.org/openstack/python-cinderclient\n.. _Launchpad: https://launchpad.net/python-cinderclient\n.. _Gerrit: https://docs.openstack.org/infra/manual/developers.html#development-workflow\n\n* License: Apache License, Version 2.0\n* `PyPi`_ - package installation\n* `Online Documentation`_\n* `Blueprints`_ - feature specifications\n* `Bugs`_ - issue tracking\n* `Source`_\n* `Specs`_\n* `How to Contribute`_\n\n.. _PyPi: https://pypi.org/project/python-cinderclient\n.. _Online Documentation: https://docs.openstack.org/python-cinderclient/latest/\n.. _Blueprints: https://blueprints.launchpad.net/python-cinderclient\n.. _Bugs: https://bugs.launchpad.net/python-cinderclient\n.. _Source: https://opendev.org/openstack/python-cinderclient\n.. _How to Contribute: https://docs.openstack.org/infra/manual/developers.html\n.. _Specs: https://specs.openstack.org/openstack/cinder-specs/\n\n\n.. contents:: Contents:\n :local:\n\nCommand-line API\n----------------\n\nInstalling this package gets you a shell command, ``cinder``, that you\ncan use to interact with any Rackspace compatible API (including OpenStack).\n\nYou'll need to provide your OpenStack username and password. You can do this\nwith the ``--os-username``, ``--os-password`` and ``--os-tenant-name``\nparams, but it's easier to just set them as environment variables::\n\n export OS_USERNAME=openstack\n export OS_PASSWORD=yadayada\n export OS_TENANT_NAME=myproject\n\nYou will also need to define the authentication url with ``--os-auth-url``\nand the version of the API with ``--os-volume-api-version``. Or set them as\nenvironment variables as well. Since Block Storage API V2 is officially\ndeprecated, you are encouraged to set ``OS_VOLUME_API_VERSION=3``. If you\nare using Keystone, you need to set the ``OS_AUTH_URL`` to the keystone\nendpoint::\n\n export OS_AUTH_URL=http://controller:5000/v3\n export OS_VOLUME_API_VERSION=3\n\nSince Keystone can return multiple regions in the Service Catalog, you\ncan specify the one you want with ``--os-region-name`` (or\n``export OS_REGION_NAME``). It defaults to the first in the list returned.\n\nYou'll find complete documentation on the shell by running\n``cinder help``::\n\n usage: cinder [--version] [-d] [--os-auth-system <auth-system>]\n [--service-type <service-type>] [--service-name <service-name>]\n [--volume-service-name <volume-service-name>]\n [--os-endpoint-type <os-endpoint-type>]\n [--endpoint-type <endpoint-type>]\n [--os-volume-api-version <volume-api-ver>]\n [--retries <retries>]\n [--profile HMAC_KEY] [--os-auth-strategy <auth-strategy>]\n [--os-username <auth-user-name>] [--os-password <auth-password>]\n [--os-tenant-name <auth-tenant-name>]\n [--os-tenant-id <auth-tenant-id>] [--os-auth-url <auth-url>]\n [--os-user-id <auth-user-id>]\n [--os-user-domain-id <auth-user-domain-id>]\n [--os-user-domain-name <auth-user-domain-name>]\n [--os-project-id <auth-project-id>]\n [--os-project-name <auth-project-name>]\n [--os-project-domain-id <auth-project-domain-id>]\n [--os-project-domain-name <auth-project-domain-name>]\n [--os-region-name <region-name>] [--os-token <token>]\n [--os-url <url>] [--insecure] [--os-cacert <ca-certificate>]\n [--os-cert <certificate>] [--os-key <key>] [--timeout <seconds>]\n <subcommand> ...\n\n Command-line interface to the OpenStack Cinder API.\n\n Positional arguments:\n <subcommand>\n absolute-limits Lists absolute limits for a user.\n api-version Display the server API version information. (Supported\n by API versions 3.0 - 3.latest)\n availability-zone-list\n Lists all availability zones.\n backup-create Creates a volume backup.\n backup-delete Removes one or more backups.\n backup-export Export backup metadata record.\n backup-import Import backup metadata record.\n backup-list Lists all backups.\n backup-reset-state Explicitly updates the backup state.\n backup-restore Restores a backup.\n backup-show Shows backup details.\n cgsnapshot-create Creates a cgsnapshot.\n cgsnapshot-delete Removes one or more cgsnapshots.\n cgsnapshot-list Lists all cgsnapshots.\n cgsnapshot-show Shows cgsnapshot details.\n consisgroup-create Creates a consistency group.\n consisgroup-create-from-src\n Creates a consistency group from a cgsnapshot or a\n source CG.\n consisgroup-delete Removes one or more consistency groups.\n consisgroup-list Lists all consistency groups.\n consisgroup-show Shows details of a consistency group.\n consisgroup-update Updates a consistency group.\n create Creates a volume.\n credentials Shows user credentials returned from auth.\n delete Removes one or more volumes.\n encryption-type-create\n Creates encryption type for a volume type. Admin only.\n encryption-type-delete\n Deletes encryption type for a volume type. Admin only.\n encryption-type-list\n Shows encryption type details for volume types. Admin\n only.\n encryption-type-show\n Shows encryption type details for a volume type. Admin\n only.\n encryption-type-update\n Update encryption type information for a volume type\n (Admin Only).\n endpoints Discovers endpoints registered by authentication\n service.\n extend Attempts to extend size of an existing volume.\n extra-specs-list Lists current volume types and extra specs.\n failover-host Failover a replicating cinder-volume host.\n force-delete Attempts force-delete of volume, regardless of state.\n freeze-host Freeze and disable the specified cinder-volume host.\n get-capabilities Show backend volume stats and properties. Admin only.\n get-pools Show pool information for backends. Admin only.\n image-metadata Sets or deletes volume image metadata.\n image-metadata-show\n Shows volume image metadata.\n list Lists all volumes.\n manage Manage an existing volume.\n metadata Sets or deletes volume metadata.\n metadata-show Shows volume metadata.\n metadata-update-all\n Updates volume metadata.\n migrate Migrates volume to a new host.\n qos-associate Associates qos specs with specified volume type.\n qos-create Creates a qos specs.\n qos-delete Deletes a specified qos specs.\n qos-disassociate Disassociates qos specs from specified volume type.\n qos-disassociate-all\n Disassociates qos specs from all its associations.\n qos-get-association\n Lists all associations for specified qos specs.\n qos-key Sets or unsets specifications for a qos spec.\n qos-list Lists qos specs.\n qos-show Shows qos specs details.\n quota-class-show Lists quotas for a quota class.\n quota-class-update Updates quotas for a quota class.\n quota-defaults Lists default quotas for a tenant.\n quota-delete Delete the quotas for a tenant.\n quota-show Lists quotas for a tenant.\n quota-update Updates quotas for a tenant.\n quota-usage Lists quota usage for a tenant.\n rate-limits Lists rate limits for a user.\n readonly-mode-update\n Updates volume read-only access-mode flag.\n rename Renames a volume.\n reset-state Explicitly updates the volume state in the Cinder\n database.\n retype Changes the volume type for a volume.\n service-disable Disables the service.\n service-enable Enables the service.\n service-list Lists all services. Filter by host and service binary.\n (Supported by API versions 3.0 - 3.latest)\n set-bootable Update bootable status of a volume.\n show Shows volume details.\n snapshot-create Creates a snapshot.\n snapshot-delete Removes one or more snapshots.\n snapshot-list Lists all snapshots.\n snapshot-manage Manage an existing snapshot.\n snapshot-metadata Sets or deletes snapshot metadata.\n snapshot-metadata-show\n Shows snapshot metadata.\n snapshot-metadata-update-all\n Updates snapshot metadata.\n snapshot-rename Renames a snapshot.\n snapshot-reset-state\n Explicitly updates the snapshot state.\n snapshot-show Shows snapshot details.\n snapshot-unmanage Stop managing a snapshot.\n thaw-host Thaw and enable the specified cinder-volume host.\n transfer-accept Accepts a volume transfer.\n transfer-create Creates a volume transfer.\n transfer-delete Undoes a transfer.\n transfer-list Lists all transfers.\n transfer-show Shows transfer details.\n type-access-add Adds volume type access for the given project.\n type-access-list Print access information about the given volume type.\n type-access-remove Removes volume type access for the given project.\n type-create Creates a volume type.\n type-default List the default volume type.\n type-delete Deletes volume type or types.\n type-key Sets or unsets extra_spec for a volume type.\n type-list Lists available 'volume types'.\n type-show Show volume type details.\n type-update Updates volume type name, description, and/or\n is_public.\n unmanage Stop managing a volume.\n upload-to-image Uploads volume to Image Service as an image.\n version-list List all API versions. (Supported by API versions 3.0\n - 3.latest)\n bash-completion Prints arguments for bash_completion.\n help Shows help about this program or one of its\n subcommands.\n list-extensions\n\n Optional arguments:\n --version show program's version number and exit\n -d, --debug Shows debugging output.\n --os-auth-system <auth-system>\n Defaults to env[OS_AUTH_SYSTEM].\n --service-type <service-type>\n Service type. For most actions, default is volume.\n --service-name <service-name>\n Service name. Default=env[CINDER_SERVICE_NAME].\n --volume-service-name <volume-service-name>\n Volume service name.\n Default=env[CINDER_VOLUME_SERVICE_NAME].\n --os-endpoint\n Use this API endpoint instead of the Service Catalog.\n Default=env[CINDER_ENDPOINT]\n --os-endpoint-type <os-endpoint-type>\n Endpoint type, which is publicURL or internalURL.\n Default=env[OS_ENDPOINT_TYPE] or nova\n env[CINDER_ENDPOINT_TYPE] or publicURL.\n --endpoint-type <endpoint-type>\n DEPRECATED! Use --os-endpoint-type.\n --os-volume-api-version <volume-api-ver>\n Block Storage API version. Accepts X, X.Y (where X is\n major and Y is minor\n part).Default=env[OS_VOLUME_API_VERSION].\n --retries <retries> Number of retries.\n --profile HMAC_KEY HMAC key to use for encrypting context data for\n performance profiling of operation. This key needs to\n match the one configured on the cinder api server.\n Without key the profiling will not be triggered even\n if osprofiler is enabled on server side.\n Defaults to env[OS_PROFILE].\n --os-auth-strategy <auth-strategy>\n Authentication strategy (Env: OS_AUTH_STRATEGY,\n default keystone). For now, any other value will\n disable the authentication.\n --os-username <auth-user-name>\n OpenStack user name. Default=env[OS_USERNAME].\n --os-password <auth-password>\n Password for OpenStack user. Default=env[OS_PASSWORD].\n --os-tenant-name <auth-tenant-name>\n Tenant name. Default=env[OS_TENANT_NAME].\n --os-tenant-id <auth-tenant-id>\n ID for the tenant. Default=env[OS_TENANT_ID].\n --os-auth-url <auth-url>\n URL for the authentication service.\n Default=env[OS_AUTH_URL].\n --os-user-id <auth-user-id>\n Authentication user ID (Env: OS_USER_ID).\n --os-user-domain-id <auth-user-domain-id>\n OpenStack user domain ID. Defaults to\n env[OS_USER_DOMAIN_ID].\n --os-user-domain-name <auth-user-domain-name>\n OpenStack user domain name. Defaults to\n env[OS_USER_DOMAIN_NAME].\n --os-project-id <auth-project-id>\n Another way to specify tenant ID. This option is\n mutually exclusive with --os-tenant-id. Defaults to\n env[OS_PROJECT_ID].\n --os-project-name <auth-project-name>\n Another way to specify tenant name. This option is\n mutually exclusive with --os-tenant-name. Defaults to\n env[OS_PROJECT_NAME].\n --os-project-domain-id <auth-project-domain-id>\n Defaults to env[OS_PROJECT_DOMAIN_ID].\n --os-project-domain-name <auth-project-domain-name>\n Defaults to env[OS_PROJECT_DOMAIN_NAME].\n --os-region-name <region-name>\n Region name. Default=env[OS_REGION_NAME].\n --os-token <token> Defaults to env[OS_TOKEN].\n --os-url <url> Defaults to env[OS_URL].\n\n API Connection Options:\n Options controlling the HTTP API Connections\n\n --insecure Explicitly allow client to perform \"insecure\" TLS\n (https) requests. The server's certificate will not be\n verified against any certificate authorities. This\n option should be used with caution.\n --os-cacert <ca-certificate>\n Specify a CA bundle file to use in verifying a TLS\n (https) server certificate. Defaults to\n env[OS_CACERT].\n --os-cert <certificate>\n Defaults to env[OS_CERT].\n --os-key <key> Defaults to env[OS_KEY].\n --timeout <seconds> Set request timeout (in seconds).\n\n Run \"cinder help SUBCOMMAND\" for help on a subcommand.\n\nIf you want to get a particular version API help message, you can add\n``--os-volume-api-version <volume-api-ver>`` in help command, like\nthis::\n\n cinder --os-volume-api-version 3.28 help\n\nPython API\n----------\n\nThere's also a complete Python API, but it has not yet been documented.\n\nQuick-start using keystone::\n\n # use v3 auth with http://controller:5000/v3\n >>> from cinderclient.v3 import client\n >>> nt = client.Client(USERNAME, PASSWORD, PROJECT_ID, AUTH_URL)\n >>> nt.volumes.list()\n [...]\n\nSee release notes and more at `<https://docs.openstack.org/python-cinderclient/latest/>`_.\n\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "OpenStack Block Storage API Client Library",
"version": "9.5.0",
"project_urls": {
"Homepage": "https://docs.openstack.org/python-cinderclient/latest/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8e2d03e6f7e6580c855cb75dee9895df300bd64cea60a2a20675e1d005483cd0",
"md5": "a9365ffc9b8fe901223892dd12685531",
"sha256": "b2ee2681c1f9785957f89be10e7e41fee130729b5c6b2f7c5fa6b542fb27eaaa"
},
"downloads": -1,
"filename": "python_cinderclient-9.5.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a9365ffc9b8fe901223892dd12685531",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 256139,
"upload_time": "2024-03-01T13:51:31",
"upload_time_iso_8601": "2024-03-01T13:51:31.300260Z",
"url": "https://files.pythonhosted.org/packages/8e/2d/03e6f7e6580c855cb75dee9895df300bd64cea60a2a20675e1d005483cd0/python_cinderclient-9.5.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c5ac2a7e767ca2058af6ab9b257bef8cde23b607719ff876602ddb72f6104aa8",
"md5": "3e6058ddac5fc0b5baf43cbaeae3f115",
"sha256": "1b9d717aff93cad420045fb6c52f6376ab72f085f8193130892020ec46c93555"
},
"downloads": -1,
"filename": "python-cinderclient-9.5.0.tar.gz",
"has_sig": false,
"md5_digest": "3e6058ddac5fc0b5baf43cbaeae3f115",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 236811,
"upload_time": "2024-03-01T13:51:34",
"upload_time_iso_8601": "2024-03-01T13:51:34.631374Z",
"url": "https://files.pythonhosted.org/packages/c5/ac/2a7e767ca2058af6ab9b257bef8cde23b607719ff876602ddb72f6104aa8/python-cinderclient-9.5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-01 13:51:34",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "python-cinderclient"
}
JSON