def datacenters(self):
j, _ = self.request('<STR_LIT:GET>', '<STR_LIT>')<EOL>self.known_locations.update(j)<EOL>return j<EOL>
::

    GET /:login/datacenters

:Returns: all datacenters (mapping from short location key to 
    full URL) that this cloud is aware of
:rtype: :py:class:`dict`

This method also updates the local `known_locations` attribute based 
upon this information.