{"id":21357757,"url":"https://github.com/rcbops/python-novaclient-buildpackage","last_synced_at":"2025-10-08T17:18:39.020Z","repository":{"id":1781571,"uuid":"2704868","full_name":"rcbops/python-novaclient-buildpackage","owner":"rcbops","description":"git-buildpackage repo for python-novaclient","archived":false,"fork":false,"pushed_at":"2012-02-13T16:10:04.000Z","size":272,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-04T18:03:40.545Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rcbops.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-11-03T20:23:04.000Z","updated_at":"2014-01-18T06:49:33.000Z","dependencies_parsed_at":"2022-09-03T15:02:09.168Z","dependency_job_id":null,"html_url":"https://github.com/rcbops/python-novaclient-buildpackage","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/rcbops/python-novaclient-buildpackage","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rcbops%2Fpython-novaclient-buildpackage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rcbops%2Fpython-novaclient-buildpackage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rcbops%2Fpython-novaclient-buildpackage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rcbops%2Fpython-novaclient-buildpackage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rcbops","download_url":"https://codeload.github.com/rcbops/python-novaclient-buildpackage/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rcbops%2Fpython-novaclient-buildpackage/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278981540,"owners_count":26079644,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-22T05:11:49.547Z","updated_at":"2025-10-08T17:18:38.990Z","avatar_url":"https://github.com/rcbops.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Python bindings to the OpenStack Nova API\n==================================================\n\nThis is a client for the OpenStack Nova API. There's a Python API (the\n``novaclient`` module), and a command-line script (``nova``). Each\nimplements 100% of the OpenStack Nova API.\n\n[PENDING] `Full documentation is available`__.\n\n__ http://packages.python.org/python-novaclient/\n\nYou'll also probably want to read `OpenStack Compute Developer Guide API`__ --\nthe first bit, at least -- to get an idea of the concepts. Rackspace is doing\nthe cloud hosting thing a bit differently from Amazon, and if you get the\nconcepts this library should make more sense.\n\n__ http://docs.openstack.org/api/\n\nThe project is hosted on `Launchpad`_, where bugs can be filed. The code is\nhosted on `Github`_. Patches must be submitted using `Gerrit`_, *not* Github\npull requests.\n\n.. _Github: https://github.com/openstack/python-novaclient\n.. _Launchpad: https://launchpad.net/python-novaclient\n.. _Gerrit: http://wiki.openstack.org/GerritWorkflow\n\nThis code a fork of `Jacobian's python-cloudservers`__ If you need API support\nfor the Rackspace API solely or the BSD license, you should use that repository.\npython-client is licensed under the Apache License like the rest of OpenStack.\n\n__ http://github.com/jacobian/python-cloudservers\n\n.. contents:: Contents:\n   :local:\n\nCommand-line API\n----------------\n\nInstalling this package gets you a shell command, ``nova``, that you\ncan use to interact with any Rackspace compatible API (including OpenStack).\n\nYou'll need to provide your OpenStack username and API key. You can do this\nwith the ``--username``, ``--password`` and  ``--projectid`` params, but it's\neasier to just set them as environment variables::\n\n    export NOVA_USERNAME=openstack\n    export NOVA_PASSWORD=yadayada\n    export NOVA_PROJECT_ID=myproject\n\nYou will also need to define the authentication url with ``--url`` and the\nversion of the API with ``--version``.  Or set them as an environment\nvariables as well::\n\n    export NOVA_URL=http://example.com:8774/v1.1/\n    export NOVA_VERSION=1.1\n\nIf you are using Keystone, you need to set the NOVA_URL to the keystone\nendpoint::\n\n    export NOVA_URL=http://example.com:5000/v2.0/\n\nSince Keystone can return multiple regions in the Service Catalog, you\ncan specify the one you want with ``--region_name`` (or\n``export NOVA_REGION_NAME``). It defaults to the first in the list returned.\n\nYou'll find complete documentation on the shell by running\n``nova help``::\n\n    usage: nova [--username USERNAME] [--password PASSWORD] [--projectid PROJECTID]\n                   [--url URL] [--version VERSION] [--region_name NAME]\n                   [--endpoint_name NAME]\n                   \u003csubcommand\u003e ...\n\n    Command-line interface to the OpenStack Nova API.\n\n    Positional arguments:\n      \u003csubcommand\u003e\n        add-fixed-ip        Add a new fixed IP address to a servers network.\n        add-floating-ip     Add a floating IP address to a server.\n        backup              Backup a server.\n        backup-schedule     Show or edit the backup schedule for a server.\n        backup-schedule-delete\n                            Delete the backup schedule for a server.\n        boot                Boot a new server.\n        delete              Immediately shut down and delete a server.\n        flavor-create       Create a new flavor\n        flavor-delete       Delete a specific flavor\n        flavor-list         Print a list of available 'flavors' (sizes of\n                            servers).\n        floating-ip-create  Allocate a floating IP to the current tenant.\n        floating-ip-delete  De-allocate a floating IP from the current tenant.\n        floating-ip-list    List allocated floating IPs for the current tenant.\n        floating-ip-pool-list\n                            List all floating ip pools.\n        get-vnc-console     Get a vnc console for a server\n        help                Display help about this program or one of its\n                            subcommands.\n        image-create        Create a new image by taking a snapshot of a running\n                            server.\n        image-delete        Delete an image.\n        image-list          Print a list of available images to boot from.\n        ip-share            Share an IP address from the given IP group onto a\n                            server.\n        ip-unshare          Stop sharing an given address with a server.\n        ipgroup-create      Create a new IP group.\n        ipgroup-delete      Delete an IP group.\n        ipgroup-list        Show IP groups.\n        ipgroup-show        Show details about a particular IP group.\n        keypair-add         Create a new key pair for use with instances\n        keypair-delete      Delete keypair by its id\n        keypair-list        Show a list of keypairs for a user\n        list                List active servers.\n        migrate             Migrate a server to a new host in the same zone.\n        reboot              Reboot a server.\n        rebuild             Shutdown, re-image, and re-boot a server.\n        remove-fixed-ip     Remove an IP address from a server.\n        remove-floating-ip  Remove a floating IP address from a server.\n        rename              Rename a server.\n        rescue              Rescue a server.\n        resize              Resize a server.\n        resize-confirm      Confirm a previous resize.\n        resize-revert       Revert a previous resize (and return to the previous\n                            VM).\n        root-password       Change the root password for a server.\n        secgroup-add-group-rule\n                            Add a source group rule to a security group.\n        secgroup-add-rule   Add a rule to a security group.\n        secgroup-create     Create a new security group.\n        secgroup-delete     Delete a security group.\n        secgroup-delete-group-rule\n                            Delete a source group rule from a security group.\n        secgroup-delete-rule\n                            Delete a rule from a security group.\n        secgroup-list       List security groups for the curent tenant.\n        secgroup-list-rules List rules for a security group.\n        show                Show details about the given server.\n        suspend             Suspend a server.\n        unpause             Unpause a server.\n        unrescue            Unrescue a server.\n        usage-list          List usage data for all tenants\n        volume-attach       Attach a volume to a server.\n        volume-create       Add a new volume.\n        volume-delete       Remove a volume.\n        volume-detach       Detach a volume from a server.\n        volume-list         List all the volumes.\n        volume-show         Show details about a volume.\n        volume-snapshot-create\n                            Add a new snapshot.\n        volume-snapshot-delete\n                            Remove a snapshot.\n        volume-snapshot-list\n                            List all the snapshots.\n        volume-snapshot-show\n                            Show details about a snapshot.\n        x509-create-cert    Create x509 cert for a user in tenant\n        x509-get-root-cert  Fetches the x509 root cert.\n        zone                Show or edit a Child Zone\n        zone-add            Add a Child Zone.\n        zone-boot           Boot a server, considering Zones.\n        zone-delete         Remove a Child Zone.\n        zone-info           Show the capabilities for this Zone.\n        zone-list           List all the immediate Child Zones.\n\n\n    Optional arguments:\n      --username USERNAME   Defaults to env[NOVA_USERNAME].\n      --password PASSWORD   Defaults to env[NOVA_PASSWORD].\n      --projectid PROJECTID Defaults to env[NOVA_PROJECT_ID].\n      --url AUTH_URL        Defaults to env[NOVA_URL] or\n                            https://auth.api.rackspacecloud.com/v1.0\n                            if undefined.\n      --version VERSION     Accepts 1.1, defaults to env[NOVA_VERSION].\n      --region_name NAME    The region name in the Keystone Service Catalog\n                            to use after authentication. Defaults to first\n                            in the list returned.\n\n    See \"nova help COMMAND\" for help on a specific command.\n\nPython API\n----------\n\n[PENDING] There's also a `complete Python API`__.\n\n__ http://packages.python.org/python-novaclient/\n\nBy way of a quick-start::\n\n    \u003e\u003e\u003e import novaclient\n    \u003e\u003e\u003e nt = novaclient.OpenStack(USERNAME, PASSWORD, PROJECT_ID [, AUTH_URL])\n    \u003e\u003e\u003e nt.flavors.list()\n    [...]\n    \u003e\u003e\u003e nt.servers.list()\n    [...]\n    \u003e\u003e\u003e s = nt.servers.create(image=2, flavor=1, name='myserver')\n\n    ... time passes ...\n\n    \u003e\u003e\u003e s.reboot()\n\n    ... time passes ...\n\n    \u003e\u003e\u003e s.delete()\n\nQuick-start using keystone::\n\n    # use v2.0 auth with http://example.com:5000/v2.0/\")\n    \u003e\u003e\u003e from novaclient.v1_1 import client\n    \u003e\u003e\u003e nt = client.Client(USER, PASS, TENANT, AUTH_URL)\n    \u003e\u003e\u003e nt.flavors.list()\n    [...]\n    \u003e\u003e\u003e nt.servers.list()\n    [...]\n    \u003e\u003e\u003e nt.keypairs.list()\n    [...]\n\n    # if you want to use the keystone api to modify users/tenants:\n    \u003e\u003e\u003e from novaclient import client\n    \u003e\u003e\u003e conn = client.HTTPClient(USER, PASS, TENANT, KEYSTONE_URL)\n    \u003e\u003e\u003e from novaclient import keystone\n    \u003e\u003e\u003e kc = keystone.Client(conn.client)\n    \u003e\u003e\u003e kc.tenants.list()\n    [...]\n\nWhat's new?\n-----------\n\n[PENDING] See `the release notes \u003chttp://packages.python.org/python-novaclient/releases.html\u003e`_.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frcbops%2Fpython-novaclient-buildpackage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frcbops%2Fpython-novaclient-buildpackage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frcbops%2Fpython-novaclient-buildpackage/lists"}