Updated Branches: refs/heads/trunk dd20d6461 -> b4a708f31
docs: Add an example of how to use Amazon temporary security credentials. Project: http://git-wip-us.apache.org/repos/asf/libcloud/repo Commit: http://git-wip-us.apache.org/repos/asf/libcloud/commit/b4a708f3 Tree: http://git-wip-us.apache.org/repos/asf/libcloud/tree/b4a708f3 Diff: http://git-wip-us.apache.org/repos/asf/libcloud/diff/b4a708f3 Branch: refs/heads/trunk Commit: b4a708f31023f1af1d3b7967c9ef6383c7f92ce5 Parents: dd20d64 Author: Tomaz Muraus <[email protected]> Authored: Fri Jan 17 17:29:44 2014 +0100 Committer: Tomaz Muraus <[email protected]> Committed: Fri Jan 17 17:29:44 2014 +0100 ---------------------------------------------------------------------- docs/compute/drivers/ec2.rst | 20 ++++++++++++++++++++ .../compute/ec2/temporary_credentials.py | 6 ++++++ 2 files changed, 26 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/libcloud/blob/b4a708f3/docs/compute/drivers/ec2.rst ---------------------------------------------------------------------- diff --git a/docs/compute/drivers/ec2.rst b/docs/compute/drivers/ec2.rst index 232dfc8..d7d6f71 100644 --- a/docs/compute/drivers/ec2.rst +++ b/docs/compute/drivers/ec2.rst @@ -21,6 +21,25 @@ It allows users to rent virtual servers in more than 8 regions such as: * Asia Pacific (Tokyo) Region * South America (Sao Paulo) Region +Using temporary security credentials +------------------------------------ + +Since Libcloud 0.14.0 above, all the Amazon drivers support using temporary +security credentials. + +Temporary credentials can be used by passing ``token`` argument to the driver +constructor in addition to the access and secret key. In this case ``token`` +represents a temporary session token, access key represents temporary +access key and secret key represents a temporary secret key. + +For example: + +.. literalinclude:: /examples/compute/ec2/temporary_credentials.py + :language: python + +For more information, please refer to the `Using Temporary Security +Credentials`_ section of the official documentation. + Examples -------- @@ -38,3 +57,4 @@ API Docs :inherited-members: .. _`Amazon Elastic Compute Cloud (EC2)`: https://aws.amazon.com/ec2/ +.. _`Using Temporary Security Credentials`: http://docs.aws.amazon.com/STS/latest/UsingSTS/using-temp-creds.html http://git-wip-us.apache.org/repos/asf/libcloud/blob/b4a708f3/docs/examples/compute/ec2/temporary_credentials.py ---------------------------------------------------------------------- diff --git a/docs/examples/compute/ec2/temporary_credentials.py b/docs/examples/compute/ec2/temporary_credentials.py new file mode 100644 index 0000000..b1e78e6 --- /dev/null +++ b/docs/examples/compute/ec2/temporary_credentials.py @@ -0,0 +1,6 @@ +from libcloud.compute.types import Provider +from libcloud.compute.providers import get_driver + +cls = get_driver(Provider.EC2_US_WEST) +driver = cls('temporary access key', 'temporary secret key', + token='temporary session token')
