Cannot Import ServiceUnavailableException

Hello,

I’m trying to use boto3 to work with AWS firehose. As per the boto3 docs on the AWS firehose method put_record(), my code should be prepared to catch ServiceUnavailableException:

If the PutRecord operation throws a ServiceUnavailableException , back off and retry. If the exception persists, it is possible that the throughput limits have been exceeded for the delivery stream.

I cannot find where ServiceUnavialableException is defined. It certainly is not in boto3 or botocore…

In [31]: from boto3.exceptions import ServiceUnavailableException
---------------------------------------------------------------------------
ImportError                               Traceback (most recent call last)
<ipython-input-31-d0ffff8323fb> in <module>()
----> 1 from boto3.exceptions import ServiceUnavailableException

ImportError: cannot import name ServiceUnavailableException

In [32]: from botocore.exceptions import ServiceUnavailableException
---------------------------------------------------------------------------
ImportError                               Traceback (most recent call last)
<ipython-input-32-47b3b14f7ff7> in <module>()
----> 1 from botocore.exceptions import ServiceUnavailableException

ImportError: cannot import name ServiceUnavailableException

A ServiceUnavialableException does appear to de defined in boto though (from boto.logs.exceptions import ServiceUnavailableException). Surely boto's version of the exception is not what I’m expected to use?

[kyleknap]

Yes we will retry automatically if we start getting 503’s. I also do not think that the upstream source should have that in the documentation. I will look into getting that updated. And that is pretty much the logic for how long backoff will take as implemented here

[yotamss]

Also got confused by the docs, any plans to add that to the docs?