{ "info": { "author": "Nick Downs", "author_email": "nickryand@gmail.com", "bugtrack_url": null, "classifiers": [], "description": "###################\nec2-simple-snapshot\n###################\n.. image:: https://travis-ci.org/nickryand/ec2-simple-snapshot.png?branch=master\n :target: https://travis-ci.org/nickryand/ec2-simple-snapshot\n :alt: Build Status\n\n************\nIntroduction\n************\n\nec2-simple-snapshot is a command line tool designed to make dealing\nwith EBS snapshots simple. This tool requires Python 2.7 and the\nboto module.\n\n************\nInstallation\n************\n\nInstall via `pip`_::\n\n $ sudo pip install ec2-simple-snapshot\n\nInstall from source::\n\n $ git clone https://github.com/nickryand/ec2-simple-snapshot.git\n $ cd ec2-simple-snapshot\n $ sudo python setup.py install\n\n*************\nConfiguration\n*************\n\nAuthentication credentials are stored in a configuration file. Create\na configuration file like the following. Be sure to replace the example\ncredentials here with your own aws credentials::\n\n [default]\n aws_access_key_id = AKTESTACCESSID\n aws_secret_access_key = wJalrXUtnBERF\\GF84d91!PxRfiCYEXAMPLEKEY\n region = us-west-2\n\nThe region directive is optional here. However, if it is not set, you\nmust set the region using the ``-r REGION`` or ``--region REGION``\ncommand line option.\n\nDefault location: ``~/.aws/config``\n\nIf you would like to have your configuration file elsewhere, use the\n``-c `` or ``--config `` command line\noption to tell ec2-simple-snapshot where to look.\n\nDefault Profile: ``default``\n\nVery similar to the aws-cli tool from Amazon, you can store multiple\nprofiles in a single configuration file. This allows you to set multiple\nsets of credentials using profiles to separate them. The default profile\nis named ``default`` but can be changed using the ``-p PROFILE`` or\n``--profile PROFILE`` command line option.\n\nExample::\n\n [production]\n aws_access_key_id = AKTESTACCESSID\n aws_secret_access_key = wJalrXUtnBERF\\GF84d91!PxRfiCYEXAMPLEKEY\n region = us-east-1\n\n******************\nIAM Policy Actions\n******************\n\nThis is a list of the required set of IAM actions needed for each command.\n\n* List\n\n - ec2:DescribeSnapshots\n\n* Create\n\n - ec2:DescribeVolumes\n - ec2:CreateSnapshot\n - ec2:CreateTags\n\n* Delete\n\n - ec2:DescribeSnapshots\n - ec2:DeleteSnapshot\n\n**************\nUsage Examples\n**************\nShow help screen::\n\n $ ec2-simple-snapshot -h\n\nShow help screen for a subcommand::\n\n $ ec2-simple-snapshot -h\n\nList the two newest snapshots owned by your AWS Account::\n\n $ ec2-simple-snapshot list --count 2\n\nList snapshots taken within the last 4 days::\n\n $ ec2-simple-snapshot list --count 4 --type days\n\nDelete snapshots older than 3 days that have the tag \"Type=Backup\" and \"Name=Test\"::\n\n $ ec2-simple-snapshot delete --count 3 --type days --filter 'Type=Backup' 'Name=Test'\n\nDelete all but the last 30 snapshots, however limit deletes to 2::\n\n $ ec2-simple-snapshot delete --count 30 --limit 2\n\nCreate a snapshot for volume 'vol-123456' setting a description and adding a tag::\n\n $ ec2-simple-snapshot create \\\n > --description \"This is a test\"\n > --tags \"Environment=Production\" vol-123456\n\n**********\nTest Suite\n**********\n\nThe easiest way to get started with the testing suite is to use the `tox`_\nautomation project.\n\nInstall tox::\n\n $ pip install tox\n\nRun the test suite::\n\n $ git clone https://github.com/nickryand/ec2-simple-snapshot.git\n $ cd ec2-simple-snapshot\n $ tox\n\nIf you do not want to use tox, you can install the development dependencies\nusing `pip`_ and use the python unittest module to execute the tests.\n\nInstall dependencies and run suite::\n\n $ git clone https://github.com/nickryand/ec2-simple-snapshot.git\n $ cd ec2-simple-snapshot\n $ pip install -r requirements.txt\n $ python -m unittest discover\n\n.. _pip: http://www.pip-installer.org/\n.. _tox: http://tox.readthedocs.org/en/latest/", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/nickryand/ec2-simple-snapshot", "keywords": null, "license": "Apache 2.0", "maintainer": null, "maintainer_email": null, "name": "ec2-simple-snapshot", "package_url": "https://pypi.org/project/ec2-simple-snapshot/", "platform": "Posix; MacOS X", "project_url": "https://pypi.org/project/ec2-simple-snapshot/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://github.com/nickryand/ec2-simple-snapshot" }, "release_url": "https://pypi.org/project/ec2-simple-snapshot/1.0.2/", "requires_dist": null, "requires_python": null, "summary": "A tool to make EC2 snapshot manipulation easier.", "version": "1.0.2" }, "last_serial": 938747, "releases": { "1.0.1": [ { "comment_text": "", "digests": { "md5": "dd2ebaadccdb71a66d9705ec0d53f439", "sha256": "c1226b895871f855a26b639fed78a6ccac0b8a676d5a4eaa835e9ccbd969b655" }, "downloads": -1, "filename": "ec2-simple-snapshot-1.0.1.tar.gz", "has_sig": false, "md5_digest": "dd2ebaadccdb71a66d9705ec0d53f439", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9255, "upload_time": "2013-12-03T07:59:58", "url": "https://files.pythonhosted.org/packages/36/5a/43ecb0e43a93897952a457202880015e669b3ac5988762c916859e6eb986/ec2-simple-snapshot-1.0.1.tar.gz" } ], "1.0.2": [ { "comment_text": "", "digests": { "md5": "afc2ce3d7bf47fc1dbba72cdb577d88b", "sha256": "61c19f199d896183766621c791890c376da8b52225d99b681103027b2a295397" }, "downloads": -1, "filename": "ec2-simple-snapshot-1.0.2.tar.gz", "has_sig": false, "md5_digest": "afc2ce3d7bf47fc1dbba72cdb577d88b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9246, "upload_time": "2013-12-08T07:27:29", "url": "https://files.pythonhosted.org/packages/10/7a/2fa235de22d21d5643da91e8fa2dac03d2df9c3424760884454ddf6a84b4/ec2-simple-snapshot-1.0.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "afc2ce3d7bf47fc1dbba72cdb577d88b", "sha256": "61c19f199d896183766621c791890c376da8b52225d99b681103027b2a295397" }, "downloads": -1, "filename": "ec2-simple-snapshot-1.0.2.tar.gz", "has_sig": false, "md5_digest": "afc2ce3d7bf47fc1dbba72cdb577d88b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9246, "upload_time": "2013-12-08T07:27:29", "url": "https://files.pythonhosted.org/packages/10/7a/2fa235de22d21d5643da91e8fa2dac03d2df9c3424760884454ddf6a84b4/ec2-simple-snapshot-1.0.2.tar.gz" } ] }