33 lines
827 B
ReStructuredText
33 lines
827 B
ReStructuredText
.. _guide_session:
|
|
|
|
Session
|
|
=======
|
|
A session manages state about a particular configuration. By default a
|
|
session is created for you when needed. However it is possible and
|
|
recommended to maintain your own session(s) in some scenarios. Sessions
|
|
typically store:
|
|
|
|
* Credentials
|
|
* Region
|
|
* Other configurations
|
|
|
|
Default Session
|
|
---------------
|
|
The ``boto3`` module acts as a proxy to the default session, which is
|
|
created automatically when needed. Example default session use::
|
|
|
|
# Using the default session
|
|
sqs = boto3.client('sqs')
|
|
s3 = boto3.resource('s3')
|
|
|
|
Custom Session
|
|
--------------
|
|
It is also possible to manage your own session and create clients or
|
|
resources from it::
|
|
|
|
# Creating your own session
|
|
session = boto3.session.Session()
|
|
|
|
sqs = session.client('sqs')
|
|
s3 = session.resource('s3')
|