Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

AmazonCloudFormationException is listed in Cloudformation.DescribeStacks but does not exist #2930

Open
kanbara opened this issue Nov 6, 2019 · 1 comment
Assignees

Comments

@kanbara
Copy link

@kanbara kanbara commented Nov 6, 2019

Please fill out the sections below to help us address your issue.

Version of AWS SDK for Go?

Any

Version of Go (go version)?

1.13.4

What issue did you see?

CloudFormation.DescribeStacks says that it will return an AmazonCloudFormationException if the stack does not exist, but there is no trace of this exception in the code.

e.g.

DescribeStacks API operation for AWS CloudFormation.

Returns the description for the specified stack; if no stack name was specified, then it returns the description for all the stacks created.

If the stack does not exist, an AmazonCloudFormationException is returned.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS CloudFormation's API operation DescribeStacks for usage and error information. See also, https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStacks

Steps to reproduce

Search through AWS documentation as well as the aws-sdk-go, and find no reference to the implementation of this error on the Go side. If it is returned from the API, there is no way to tell that this error is there, and use it in code.

@diehlaws

This comment has been minimized.

Copy link
Contributor

@diehlaws diehlaws commented Nov 7, 2019

Hi @kanbara, thanks for reaching out to us about this. Descriptions for a service's API calls within the documentation for the AWS SDKs are pulled in from the API reference for the service in question - in this case, the note regarding the AmazonCloudFormationException comes from the DescribeStacks page in CloudFormation's API reference.

That being said, the DescribeStacks API call is the only page within CloudFormation's API reference in which AmazonCloudFormationException is mentioned. I don't see any reference to this exception type in CloudFormation's API model; this model is used by all of the AWS SDKs for their CloudFormation calls, so it appears that this may not be a valid exception type. I've reached out to the CloudFormation team internally for clarification on this, and will update the issue once I have more information.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
2 participants
You can’t perform that action at this time.