Closed garethr closed 9 years ago
Our API docs are directly generated from the service API docs, which includes a few examples that may help. What I can do is forward this on to the EC2 doc teams to see if they can add clarity to the function description.
All of the samples on that page use the nested ip_permissions array, non of them use the top-level attributes. Which reinforces the feeling that it's two parallel implementations, maybe for backwards compatibility. Even just stating that or deprecating those bits, would be a useful signal.
I suspect you are correct about two implementations. We've passed along the documentation feedback. Thanks!
The SDK docs around authorize_security_group_ingress at http://docs.aws.amazon.com/sdkforruby/api/frames.html are difficult to follow. Specifically:
Ultimately, this method feels like two separate implementations tied together.
This stood out as the rest of the SDK I've used (for https://github.com/garethr/puppetlabs-aws) has been obvious in use, even without referring to the documentation in many cases.