{"action":"opened","issue":{"url":"https://api.github.com/repos/boto/boto3/issues/136","labels_url":"https://api.github.com/repos/boto/boto3/issues/136/labels{/name}","comments_url":"https://api.github.com/repos/boto/boto3/issues/136/comments","events_url":"https://api.github.com/repos/boto/boto3/issues/136/events","html_url":"https://github.com/boto/boto3/issues/136","id":89235537,"number":136,"title":"boto3 methods as described in documentation","user":{"login":"iMilnb","id":1702247,"avatar_url":"https://avatars.githubusercontent.com/u/1702247?v=3","gravatar_id":"","url":"https://api.github.com/users/iMilnb","html_url":"https://github.com/iMilnb","followers_url":"https://api.github.com/users/iMilnb/followers","following_url":"https://api.github.com/users/iMilnb/following{/other_user}","gists_url":"https://api.github.com/users/iMilnb/gists{/gist_id}","starred_url":"https://api.github.com/users/iMilnb/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/iMilnb/subscriptions","organizations_url":"https://api.github.com/users/iMilnb/orgs","repos_url":"https://api.github.com/users/iMilnb/repos","events_url":"https://api.github.com/users/iMilnb/events{/privacy}","received_events_url":"https://api.github.com/users/iMilnb/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2015-06-18T08:44:30Z","updated_at":"2015-06-18T08:44:30Z","closed_at":null,"body":"Hi,\r\n\r\nboto3 documentation says:\r\n\r\n```\r\n# Boto 2.x\r\nec2_connection.run_instances('<ami-image-id>')\r\n\r\n# Boto 3\r\nec2.create_instances(ImageId='<ami-image-id>', MinCount=1, MaxCount=5)\r\n```\r\nBut as a matter of fact, there's very little if none documentation on `create_instance` usage, I merely discovered how to pass more parameters using completion in `ipython`. On the contrary, the `run_instances` method is fully described. This is true for all `boto3` vs `boto2` paragraphs in the _Migrating from Boto 2.x_ section.\r\nAre we supposed to use the documented methods or to discover parameters from the \"new\" methods?\r\n\r\nThanks"}}