Ideally, this method should transparently handle the pagination in the background and return a generator.

Here are a couple of examples of how we do this in other drivers:

* https://github.com/apache/libcloud/blob/trunk/libcloud/storage/base.py#L182
* https://github.com/apache/libcloud/blob/trunk/libcloud/storage/drivers/azure_blobs.py#L359
* https://github.com/apache/libcloud/blob/trunk/libcloud/dns/drivers/zerigo.py#L146