ImportError for 'ImageNotFoundException' from ECR

[mweitzel2005]

Describe the bug

Calling .describe_image() against an ECR registry works if the Docker Image tag exists but if it doesn't exists an 'ImageNotFoundException' should be handled.

Trying to import 'ImageNotFoundException' from 'botocore.exceptions' leads to an ImportError.

Expected Behavior

'ImageNotFoundException' should be available for import 'botocore.exceptions'.

Current Behavior

Trying to import 'ImageNotFoundException' from 'botocore.exceptions' leads to an ImportError.

Reproduction Steps

Create a Python script with the below and run it:

from botocore.exceptions import ClientError, ImageNotFoundException

Possible Solution

No response

Additional Information/Context

No response

SDK version used

boto3 1.21.28 / botocore 1.24.28

Environment details (OS name and version, etc.)

mac OS Sonoma

[nateprewitt]

Hi @mweitzel2005, thanks for reaching out about this. A large amount of boto3 (and botocore) doesn't actually exist as written Python code, it's generated dynamically at runtime from json models (ImageNotFoundException). So while we have base exceptions like ClientError, you'll find that the exceptions.py file in botocore is only a fraction of the exceptions we may raise.

The service specific exceptions like ImageNotFoundException referenced above actually exist on the client itself. So in this case, your code would look something like:

import boto3
ecr_client = boto3.client('ecr', region_name='us-west-2')
try:
    ecr_client.describe_images()
except ecr_client.exceptions.ImageNotFoundException:
    # your exception handling here

You should find all the errors in the documentation (e.g. describe_images) are expressed in the format ECR.Client.exceptions.<ExceptionName>. You can find the full documentation on how these work in our Error handling guide. Please let us know if you have any other questions.

[mweitzel2005]

Thanks for the clarification, that works.

[github-actions]

⚠️COMMENT VISIBILITY WARNING⚠️

Comments on closed issues are hard for our team to see.
If you need more assistance, please either tag a team member or open a new issue that references this one.
If you wish to keep having a conversation with other community members under this issue feel free to do so.