aws-sdk-v1 1.52.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (560) hide show
  1. checksums.yaml +7 -0
  2. data/.yardopts +7 -0
  3. data/LICENSE.txt +12 -0
  4. data/README.md +337 -0
  5. data/bin/aws-rb +179 -0
  6. data/ca-bundle.crt +3554 -0
  7. data/endpoints.json +1671 -0
  8. data/lib/aws-sdk-v1.rb +2 -0
  9. data/lib/aws-sdk.rb +1 -0
  10. data/lib/aws.rb +14 -0
  11. data/lib/aws/api_config/AutoScaling-2011-01-01.yml +1070 -0
  12. data/lib/aws/api_config/CloudFormation-2010-05-15.yml +372 -0
  13. data/lib/aws/api_config/CloudFront-2013-05-12.yml +2448 -0
  14. data/lib/aws/api_config/CloudFront-2013-08-26.yml +2599 -0
  15. data/lib/aws/api_config/CloudFront-2013-09-27.yml +2765 -0
  16. data/lib/aws/api_config/CloudFront-2013-11-11.yml +2886 -0
  17. data/lib/aws/api_config/CloudFront-2013-11-22.yml +2918 -0
  18. data/lib/aws/api_config/CloudFront-2014-01-31.yml +2934 -0
  19. data/lib/aws/api_config/CloudFront-2014-05-31.yml +3100 -0
  20. data/lib/aws/api_config/CloudSearch-2011-02-01.yml +681 -0
  21. data/lib/aws/api_config/CloudSearch-2013-01-01.yml +1164 -0
  22. data/lib/aws/api_config/CloudTrail-2013-11-01.yml +130 -0
  23. data/lib/aws/api_config/CloudWatch-2010-08-01.yml +433 -0
  24. data/lib/aws/api_config/DataPipeline-2012-10-29.yml +422 -0
  25. data/lib/aws/api_config/DirectConnect-2012-10-25.yml +735 -0
  26. data/lib/aws/api_config/DynamoDB-2011-12-05.yml +1168 -0
  27. data/lib/aws/api_config/DynamoDB-2012-08-10.yml +2105 -0
  28. data/lib/aws/api_config/EC2-2013-08-15.yml +4708 -0
  29. data/lib/aws/api_config/EC2-2013-10-01.yml +4726 -0
  30. data/lib/aws/api_config/EC2-2013-10-15.yml +4651 -0
  31. data/lib/aws/api_config/EC2-2014-02-01.yml +4755 -0
  32. data/lib/aws/api_config/EC2-2014-05-01.yml +4812 -0
  33. data/lib/aws/api_config/ELB-2012-06-01.yml +766 -0
  34. data/lib/aws/api_config/EMR-2009-03-31.yml +972 -0
  35. data/lib/aws/api_config/ElastiCache-2013-06-15.yml +1188 -0
  36. data/lib/aws/api_config/ElastiCache-2014-03-24.yml +1375 -0
  37. data/lib/aws/api_config/ElastiCache-2014-07-15.yml +1385 -0
  38. data/lib/aws/api_config/ElasticBeanstalk-2010-12-01.yml +854 -0
  39. data/lib/aws/api_config/ElasticTranscoder-2012-09-25.yml +3082 -0
  40. data/lib/aws/api_config/Glacier-2012-06-01.yml +649 -0
  41. data/lib/aws/api_config/IAM-2010-05-08.yml +1339 -0
  42. data/lib/aws/api_config/ImportExport-2010-06-01.yml +109 -0
  43. data/lib/aws/api_config/Kinesis-2013-12-02.yml +201 -0
  44. data/lib/aws/api_config/OpsWorks-2013-02-18.yml +2025 -0
  45. data/lib/aws/api_config/RDS-2013-05-15.yml +2464 -0
  46. data/lib/aws/api_config/RDS-2013-09-09.yml +2640 -0
  47. data/lib/aws/api_config/Redshift-2012-12-01.yml +2161 -0
  48. data/lib/aws/api_config/Route53-2012-12-12.yml +547 -0
  49. data/lib/aws/api_config/Route53-2013-04-01.yml +889 -0
  50. data/lib/aws/api_config/SNS-2010-03-31.yml +448 -0
  51. data/lib/aws/api_config/SQS-2012-11-05.yml +404 -0
  52. data/lib/aws/api_config/STS-2011-06-15.yml +151 -0
  53. data/lib/aws/api_config/SimpleDB-2009-04-15.yml +306 -0
  54. data/lib/aws/api_config/SimpleEmailService-2010-12-01.yml +346 -0
  55. data/lib/aws/api_config/SimpleWorkflow-2012-01-25.yml +2388 -0
  56. data/lib/aws/api_config/StorageGateway-2012-06-30.yml +748 -0
  57. data/lib/aws/api_config/StorageGateway-2013-06-30.yml +1025 -0
  58. data/lib/aws/api_config/Support-2013-04-15.yml +489 -0
  59. data/lib/aws/auto_scaling.rb +163 -0
  60. data/lib/aws/auto_scaling/activity.rb +102 -0
  61. data/lib/aws/auto_scaling/activity_collection.rb +81 -0
  62. data/lib/aws/auto_scaling/client.rb +48 -0
  63. data/lib/aws/auto_scaling/config.rb +18 -0
  64. data/lib/aws/auto_scaling/errors.rb +22 -0
  65. data/lib/aws/auto_scaling/group.rb +421 -0
  66. data/lib/aws/auto_scaling/group_collection.rb +96 -0
  67. data/lib/aws/auto_scaling/group_options.rb +155 -0
  68. data/lib/aws/auto_scaling/instance.rb +192 -0
  69. data/lib/aws/auto_scaling/instance_collection.rb +63 -0
  70. data/lib/aws/auto_scaling/launch_configuration.rb +162 -0
  71. data/lib/aws/auto_scaling/launch_configuration_collection.rb +160 -0
  72. data/lib/aws/auto_scaling/notification_configuration.rb +89 -0
  73. data/lib/aws/auto_scaling/notification_configuration_collection.rb +183 -0
  74. data/lib/aws/auto_scaling/scaling_policy.rb +142 -0
  75. data/lib/aws/auto_scaling/scaling_policy_collection.rb +72 -0
  76. data/lib/aws/auto_scaling/scaling_policy_options.rb +65 -0
  77. data/lib/aws/auto_scaling/scheduled_action.rb +141 -0
  78. data/lib/aws/auto_scaling/scheduled_action_collection.rb +202 -0
  79. data/lib/aws/auto_scaling/tag.rb +59 -0
  80. data/lib/aws/auto_scaling/tag_collection.rb +114 -0
  81. data/lib/aws/cloud_formation.rb +272 -0
  82. data/lib/aws/cloud_formation/client.rb +48 -0
  83. data/lib/aws/cloud_formation/config.rb +18 -0
  84. data/lib/aws/cloud_formation/errors.rb +22 -0
  85. data/lib/aws/cloud_formation/stack.rb +266 -0
  86. data/lib/aws/cloud_formation/stack_collection.rb +232 -0
  87. data/lib/aws/cloud_formation/stack_event.rb +73 -0
  88. data/lib/aws/cloud_formation/stack_event_collection.rb +47 -0
  89. data/lib/aws/cloud_formation/stack_options.rb +72 -0
  90. data/lib/aws/cloud_formation/stack_output.rb +53 -0
  91. data/lib/aws/cloud_formation/stack_resource.rb +117 -0
  92. data/lib/aws/cloud_formation/stack_resource_collection.rb +83 -0
  93. data/lib/aws/cloud_formation/stack_resource_summary_collection.rb +64 -0
  94. data/lib/aws/cloud_formation/stack_summary_collection.rb +123 -0
  95. data/lib/aws/cloud_front.rb +72 -0
  96. data/lib/aws/cloud_front/client.rb +57 -0
  97. data/lib/aws/cloud_front/config.rb +18 -0
  98. data/lib/aws/cloud_front/errors.rb +22 -0
  99. data/lib/aws/cloud_search.rb +73 -0
  100. data/lib/aws/cloud_search/client.rb +40 -0
  101. data/lib/aws/cloud_search/config.rb +18 -0
  102. data/lib/aws/cloud_search/errors.rb +22 -0
  103. data/lib/aws/cloud_trail.rb +72 -0
  104. data/lib/aws/cloud_trail/client.rb +35 -0
  105. data/lib/aws/cloud_trail/config.rb +18 -0
  106. data/lib/aws/cloud_trail/errors.rb +22 -0
  107. data/lib/aws/cloud_watch.rb +118 -0
  108. data/lib/aws/cloud_watch/alarm.rb +293 -0
  109. data/lib/aws/cloud_watch/alarm_collection.rb +153 -0
  110. data/lib/aws/cloud_watch/alarm_history_item.rb +50 -0
  111. data/lib/aws/cloud_watch/alarm_history_item_collection.rb +84 -0
  112. data/lib/aws/cloud_watch/client.rb +40 -0
  113. data/lib/aws/cloud_watch/config.rb +18 -0
  114. data/lib/aws/cloud_watch/errors.rb +22 -0
  115. data/lib/aws/cloud_watch/metric.rb +135 -0
  116. data/lib/aws/cloud_watch/metric_alarm_collection.rb +160 -0
  117. data/lib/aws/cloud_watch/metric_collection.rb +129 -0
  118. data/lib/aws/cloud_watch/metric_statistics.rb +69 -0
  119. data/lib/aws/core.rb +716 -0
  120. data/lib/aws/core/async_handle.rb +90 -0
  121. data/lib/aws/core/cacheable.rb +77 -0
  122. data/lib/aws/core/client.rb +787 -0
  123. data/lib/aws/core/collection.rb +263 -0
  124. data/lib/aws/core/collection/simple.rb +82 -0
  125. data/lib/aws/core/collection/with_limit_and_next_token.rb +71 -0
  126. data/lib/aws/core/collection/with_next_token.rb +97 -0
  127. data/lib/aws/core/configuration.rb +542 -0
  128. data/lib/aws/core/credential_providers.rb +639 -0
  129. data/lib/aws/core/data.rb +247 -0
  130. data/lib/aws/core/deprecations.rb +84 -0
  131. data/lib/aws/core/endpoints.rb +37 -0
  132. data/lib/aws/core/http/connection_pool.rb +369 -0
  133. data/lib/aws/core/http/curb_handler.rb +148 -0
  134. data/lib/aws/core/http/handler.rb +89 -0
  135. data/lib/aws/core/http/net_http_handler.rb +144 -0
  136. data/lib/aws/core/http/patch.rb +102 -0
  137. data/lib/aws/core/http/request.rb +259 -0
  138. data/lib/aws/core/http/response.rb +81 -0
  139. data/lib/aws/core/indifferent_hash.rb +88 -0
  140. data/lib/aws/core/inflection.rb +56 -0
  141. data/lib/aws/core/ini_parser.rb +42 -0
  142. data/lib/aws/core/json_client.rb +47 -0
  143. data/lib/aws/core/json_parser.rb +76 -0
  144. data/lib/aws/core/json_request_builder.rb +35 -0
  145. data/lib/aws/core/json_response_parser.rb +79 -0
  146. data/lib/aws/core/lazy_error_classes.rb +108 -0
  147. data/lib/aws/core/log_formatter.rb +428 -0
  148. data/lib/aws/core/managed_file.rb +32 -0
  149. data/lib/aws/core/meta_utils.rb +45 -0
  150. data/lib/aws/core/model.rb +62 -0
  151. data/lib/aws/core/naming.rb +30 -0
  152. data/lib/aws/core/option_grammar.rb +738 -0
  153. data/lib/aws/core/options/json_serializer.rb +82 -0
  154. data/lib/aws/core/options/validator.rb +155 -0
  155. data/lib/aws/core/options/xml_serializer.rb +118 -0
  156. data/lib/aws/core/page_result.rb +75 -0
  157. data/lib/aws/core/policy.rb +941 -0
  158. data/lib/aws/core/query_client.rb +41 -0
  159. data/lib/aws/core/query_error_parser.rb +24 -0
  160. data/lib/aws/core/query_request_builder.rb +47 -0
  161. data/lib/aws/core/query_response_parser.rb +35 -0
  162. data/lib/aws/core/region.rb +85 -0
  163. data/lib/aws/core/region_collection.rb +80 -0
  164. data/lib/aws/core/resource.rb +413 -0
  165. data/lib/aws/core/resource_cache.rb +40 -0
  166. data/lib/aws/core/response.rb +215 -0
  167. data/lib/aws/core/response_cache.rb +50 -0
  168. data/lib/aws/core/rest_error_parser.rb +24 -0
  169. data/lib/aws/core/rest_json_client.rb +40 -0
  170. data/lib/aws/core/rest_request_builder.rb +154 -0
  171. data/lib/aws/core/rest_response_parser.rb +66 -0
  172. data/lib/aws/core/rest_xml_client.rb +47 -0
  173. data/lib/aws/core/service_interface.rb +83 -0
  174. data/lib/aws/core/signers/base.rb +46 -0
  175. data/lib/aws/core/signers/cloud_front.rb +56 -0
  176. data/lib/aws/core/signers/s3.rb +159 -0
  177. data/lib/aws/core/signers/version_2.rb +72 -0
  178. data/lib/aws/core/signers/version_3.rb +86 -0
  179. data/lib/aws/core/signers/version_3_https.rb +61 -0
  180. data/lib/aws/core/signers/version_4.rb +228 -0
  181. data/lib/aws/core/signers/version_4/chunk_signed_stream.rb +191 -0
  182. data/lib/aws/core/uri_escape.rb +44 -0
  183. data/lib/aws/core/xml/frame.rb +245 -0
  184. data/lib/aws/core/xml/frame_stack.rb +85 -0
  185. data/lib/aws/core/xml/grammar.rb +307 -0
  186. data/lib/aws/core/xml/parser.rb +70 -0
  187. data/lib/aws/core/xml/root_frame.rb +65 -0
  188. data/lib/aws/core/xml/sax_handlers/libxml.rb +47 -0
  189. data/lib/aws/core/xml/sax_handlers/nokogiri.rb +56 -0
  190. data/lib/aws/core/xml/sax_handlers/ox.rb +41 -0
  191. data/lib/aws/core/xml/sax_handlers/rexml.rb +47 -0
  192. data/lib/aws/core/xml/stub.rb +123 -0
  193. data/lib/aws/data_pipeline.rb +72 -0
  194. data/lib/aws/data_pipeline/client.rb +36 -0
  195. data/lib/aws/data_pipeline/config.rb +18 -0
  196. data/lib/aws/data_pipeline/errors.rb +20 -0
  197. data/lib/aws/direct_connect.rb +73 -0
  198. data/lib/aws/direct_connect/client.rb +36 -0
  199. data/lib/aws/direct_connect/config.rb +18 -0
  200. data/lib/aws/direct_connect/errors.rb +22 -0
  201. data/lib/aws/dynamo_db.rb +230 -0
  202. data/lib/aws/dynamo_db/attribute_collection.rb +456 -0
  203. data/lib/aws/dynamo_db/batch_get.rb +213 -0
  204. data/lib/aws/dynamo_db/batch_write.rb +254 -0
  205. data/lib/aws/dynamo_db/binary.rb +35 -0
  206. data/lib/aws/dynamo_db/client.rb +129 -0
  207. data/lib/aws/dynamo_db/client/v20111205.rb +1266 -0
  208. data/lib/aws/dynamo_db/client/v20120810.rb +1409 -0
  209. data/lib/aws/dynamo_db/client_v2.rb +44 -0
  210. data/lib/aws/dynamo_db/config.rb +24 -0
  211. data/lib/aws/dynamo_db/errors.rb +20 -0
  212. data/lib/aws/dynamo_db/expectations.rb +40 -0
  213. data/lib/aws/dynamo_db/item.rb +133 -0
  214. data/lib/aws/dynamo_db/item_collection.rb +856 -0
  215. data/lib/aws/dynamo_db/item_data.rb +31 -0
  216. data/lib/aws/dynamo_db/keys.rb +41 -0
  217. data/lib/aws/dynamo_db/primary_key_element.rb +48 -0
  218. data/lib/aws/dynamo_db/resource.rb +33 -0
  219. data/lib/aws/dynamo_db/table.rb +492 -0
  220. data/lib/aws/dynamo_db/table_collection.rb +165 -0
  221. data/lib/aws/dynamo_db/types.rb +111 -0
  222. data/lib/aws/ec2.rb +428 -0
  223. data/lib/aws/ec2/attachment.rb +135 -0
  224. data/lib/aws/ec2/attachment_collection.rb +54 -0
  225. data/lib/aws/ec2/availability_zone.rb +86 -0
  226. data/lib/aws/ec2/availability_zone_collection.rb +43 -0
  227. data/lib/aws/ec2/block_device_mappings.rb +53 -0
  228. data/lib/aws/ec2/client.rb +154 -0
  229. data/lib/aws/ec2/collection.rb +36 -0
  230. data/lib/aws/ec2/config.rb +21 -0
  231. data/lib/aws/ec2/customer_gateway.rb +90 -0
  232. data/lib/aws/ec2/customer_gateway_collection.rb +73 -0
  233. data/lib/aws/ec2/dhcp_options.rb +106 -0
  234. data/lib/aws/ec2/dhcp_options_collection.rb +87 -0
  235. data/lib/aws/ec2/elastic_ip.rb +209 -0
  236. data/lib/aws/ec2/elastic_ip_collection.rb +93 -0
  237. data/lib/aws/ec2/errors.rb +32 -0
  238. data/lib/aws/ec2/export_task.rb +120 -0
  239. data/lib/aws/ec2/export_task_collection.rb +67 -0
  240. data/lib/aws/ec2/filtered_collection.rb +87 -0
  241. data/lib/aws/ec2/has_permissions.rb +44 -0
  242. data/lib/aws/ec2/image.rb +270 -0
  243. data/lib/aws/ec2/image_collection.rb +219 -0
  244. data/lib/aws/ec2/instance.rb +803 -0
  245. data/lib/aws/ec2/instance_collection.rb +402 -0
  246. data/lib/aws/ec2/internet_gateway.rb +122 -0
  247. data/lib/aws/ec2/internet_gateway/attachment.rb +78 -0
  248. data/lib/aws/ec2/internet_gateway_collection.rb +54 -0
  249. data/lib/aws/ec2/key_pair.rb +82 -0
  250. data/lib/aws/ec2/key_pair_collection.rb +99 -0
  251. data/lib/aws/ec2/network_acl.rb +256 -0
  252. data/lib/aws/ec2/network_acl/association.rb +56 -0
  253. data/lib/aws/ec2/network_acl/entry.rb +147 -0
  254. data/lib/aws/ec2/network_acl_collection.rb +64 -0
  255. data/lib/aws/ec2/network_interface.rb +237 -0
  256. data/lib/aws/ec2/network_interface/attachment.rb +100 -0
  257. data/lib/aws/ec2/network_interface_collection.rb +103 -0
  258. data/lib/aws/ec2/permission_collection.rb +174 -0
  259. data/lib/aws/ec2/region.rb +106 -0
  260. data/lib/aws/ec2/region_collection.rb +51 -0
  261. data/lib/aws/ec2/reserved_instances.rb +57 -0
  262. data/lib/aws/ec2/reserved_instances_collection.rb +40 -0
  263. data/lib/aws/ec2/reserved_instances_offering.rb +60 -0
  264. data/lib/aws/ec2/reserved_instances_offering_collection.rb +45 -0
  265. data/lib/aws/ec2/resource.rb +161 -0
  266. data/lib/aws/ec2/resource_tag_collection.rb +211 -0
  267. data/lib/aws/ec2/route_table.rb +205 -0
  268. data/lib/aws/ec2/route_table/association.rb +119 -0
  269. data/lib/aws/ec2/route_table/route.rb +119 -0
  270. data/lib/aws/ec2/route_table_collection.rb +72 -0
  271. data/lib/aws/ec2/security_group.rb +482 -0
  272. data/lib/aws/ec2/security_group/ip_permission.rb +135 -0
  273. data/lib/aws/ec2/security_group/ip_permission_collection.rb +82 -0
  274. data/lib/aws/ec2/security_group_collection.rb +133 -0
  275. data/lib/aws/ec2/snapshot.rb +143 -0
  276. data/lib/aws/ec2/snapshot_collection.rb +131 -0
  277. data/lib/aws/ec2/subnet.rb +161 -0
  278. data/lib/aws/ec2/subnet_collection.rb +119 -0
  279. data/lib/aws/ec2/tag.rb +81 -0
  280. data/lib/aws/ec2/tag_collection.rb +107 -0
  281. data/lib/aws/ec2/tagged_collection.rb +67 -0
  282. data/lib/aws/ec2/tagged_item.rb +85 -0
  283. data/lib/aws/ec2/volume.rb +185 -0
  284. data/lib/aws/ec2/volume_collection.rb +102 -0
  285. data/lib/aws/ec2/vpc.rb +174 -0
  286. data/lib/aws/ec2/vpc_collection.rb +70 -0
  287. data/lib/aws/ec2/vpn_connection.rb +99 -0
  288. data/lib/aws/ec2/vpn_connection/telemetry.rb +49 -0
  289. data/lib/aws/ec2/vpn_connection_collection.rb +96 -0
  290. data/lib/aws/ec2/vpn_gateway.rb +123 -0
  291. data/lib/aws/ec2/vpn_gateway/attachment.rb +45 -0
  292. data/lib/aws/ec2/vpn_gateway_collection.rb +77 -0
  293. data/lib/aws/elastic_beanstalk.rb +49 -0
  294. data/lib/aws/elastic_beanstalk/client.rb +36 -0
  295. data/lib/aws/elastic_beanstalk/config.rb +18 -0
  296. data/lib/aws/elastic_beanstalk/errors.rb +22 -0
  297. data/lib/aws/elastic_transcoder.rb +29 -0
  298. data/lib/aws/elastic_transcoder/client.rb +48 -0
  299. data/lib/aws/elastic_transcoder/config.rb +18 -0
  300. data/lib/aws/elastic_transcoder/errors.rb +23 -0
  301. data/lib/aws/elasticache.rb +49 -0
  302. data/lib/aws/elasticache/client.rb +41 -0
  303. data/lib/aws/elasticache/config.rb +18 -0
  304. data/lib/aws/elasticache/errors.rb +22 -0
  305. data/lib/aws/elb.rb +66 -0
  306. data/lib/aws/elb/availability_zone_collection.rb +138 -0
  307. data/lib/aws/elb/backend_server_policy_collection.rb +139 -0
  308. data/lib/aws/elb/client.rb +35 -0
  309. data/lib/aws/elb/config.rb +18 -0
  310. data/lib/aws/elb/errors.rb +26 -0
  311. data/lib/aws/elb/instance_collection.rb +168 -0
  312. data/lib/aws/elb/listener.rb +190 -0
  313. data/lib/aws/elb/listener_collection.rb +113 -0
  314. data/lib/aws/elb/listener_opts.rb +45 -0
  315. data/lib/aws/elb/load_balancer.rb +280 -0
  316. data/lib/aws/elb/load_balancer_collection.rb +146 -0
  317. data/lib/aws/elb/load_balancer_policy.rb +93 -0
  318. data/lib/aws/elb/load_balancer_policy_collection.rb +208 -0
  319. data/lib/aws/emr.rb +87 -0
  320. data/lib/aws/emr/client.rb +35 -0
  321. data/lib/aws/emr/config.rb +18 -0
  322. data/lib/aws/emr/errors.rb +22 -0
  323. data/lib/aws/emr/instance_group.rb +138 -0
  324. data/lib/aws/emr/instance_group_collection.rb +82 -0
  325. data/lib/aws/emr/job_flow.rb +307 -0
  326. data/lib/aws/emr/job_flow_collection.rb +183 -0
  327. data/lib/aws/errors.rb +162 -0
  328. data/lib/aws/glacier.rb +79 -0
  329. data/lib/aws/glacier/archive.rb +56 -0
  330. data/lib/aws/glacier/archive_collection.rb +146 -0
  331. data/lib/aws/glacier/client.rb +49 -0
  332. data/lib/aws/glacier/config.rb +19 -0
  333. data/lib/aws/glacier/errors.rb +22 -0
  334. data/lib/aws/glacier/resource.rb +30 -0
  335. data/lib/aws/glacier/vault.rb +145 -0
  336. data/lib/aws/glacier/vault_collection.rb +75 -0
  337. data/lib/aws/glacier/vault_notification_configuration.rb +29 -0
  338. data/lib/aws/iam.rb +408 -0
  339. data/lib/aws/iam/access_key.rb +185 -0
  340. data/lib/aws/iam/access_key_collection.rb +128 -0
  341. data/lib/aws/iam/account_alias_collection.rb +79 -0
  342. data/lib/aws/iam/client.rb +49 -0
  343. data/lib/aws/iam/collection.rb +83 -0
  344. data/lib/aws/iam/config.rb +18 -0
  345. data/lib/aws/iam/errors.rb +22 -0
  346. data/lib/aws/iam/group.rb +111 -0
  347. data/lib/aws/iam/group_collection.rb +132 -0
  348. data/lib/aws/iam/group_policy_collection.rb +47 -0
  349. data/lib/aws/iam/group_user_collection.rb +84 -0
  350. data/lib/aws/iam/login_profile.rb +111 -0
  351. data/lib/aws/iam/mfa_device.rb +52 -0
  352. data/lib/aws/iam/mfa_device_collection.rb +127 -0
  353. data/lib/aws/iam/policy.rb +46 -0
  354. data/lib/aws/iam/policy_collection.rb +188 -0
  355. data/lib/aws/iam/resource.rb +62 -0
  356. data/lib/aws/iam/server_certificate.rb +148 -0
  357. data/lib/aws/iam/server_certificate_collection.rb +138 -0
  358. data/lib/aws/iam/signing_certificate.rb +186 -0
  359. data/lib/aws/iam/signing_certificate_collection.rb +131 -0
  360. data/lib/aws/iam/user.rb +200 -0
  361. data/lib/aws/iam/user_collection.rb +133 -0
  362. data/lib/aws/iam/user_group_collection.rb +98 -0
  363. data/lib/aws/iam/user_policy.rb +90 -0
  364. data/lib/aws/iam/user_policy_collection.rb +45 -0
  365. data/lib/aws/iam/virtual_mfa_device.rb +139 -0
  366. data/lib/aws/iam/virtual_mfa_device_collection.rb +73 -0
  367. data/lib/aws/import_export.rb +73 -0
  368. data/lib/aws/import_export/client.rb +35 -0
  369. data/lib/aws/import_export/config.rb +19 -0
  370. data/lib/aws/import_export/errors.rb +22 -0
  371. data/lib/aws/kinesis.rb +53 -0
  372. data/lib/aws/kinesis/client.rb +35 -0
  373. data/lib/aws/kinesis/config.rb +18 -0
  374. data/lib/aws/kinesis/errors.rb +20 -0
  375. data/lib/aws/ops_works.rb +29 -0
  376. data/lib/aws/ops_works/client.rb +35 -0
  377. data/lib/aws/ops_works/config.rb +18 -0
  378. data/lib/aws/ops_works/errors.rb +20 -0
  379. data/lib/aws/rails.rb +195 -0
  380. data/lib/aws/rds.rb +70 -0
  381. data/lib/aws/rds/client.rb +42 -0
  382. data/lib/aws/rds/config.rb +18 -0
  383. data/lib/aws/rds/db_instance.rb +215 -0
  384. data/lib/aws/rds/db_instance_collection.rb +75 -0
  385. data/lib/aws/rds/db_snapshot.rb +163 -0
  386. data/lib/aws/rds/db_snapshot_collection.rb +89 -0
  387. data/lib/aws/rds/errors.rb +22 -0
  388. data/lib/aws/record.rb +139 -0
  389. data/lib/aws/record/abstract_base.rb +689 -0
  390. data/lib/aws/record/attributes.rb +388 -0
  391. data/lib/aws/record/conversion.rb +38 -0
  392. data/lib/aws/record/dirty_tracking.rb +287 -0
  393. data/lib/aws/record/errors.rb +143 -0
  394. data/lib/aws/record/exceptions.rb +51 -0
  395. data/lib/aws/record/hash_model.rb +204 -0
  396. data/lib/aws/record/hash_model/attributes.rb +195 -0
  397. data/lib/aws/record/hash_model/finder_methods.rb +172 -0
  398. data/lib/aws/record/hash_model/scope.rb +108 -0
  399. data/lib/aws/record/model.rb +453 -0
  400. data/lib/aws/record/model/attributes.rb +377 -0
  401. data/lib/aws/record/model/finder_methods.rb +232 -0
  402. data/lib/aws/record/model/scope.rb +212 -0
  403. data/lib/aws/record/naming.rb +31 -0
  404. data/lib/aws/record/scope.rb +203 -0
  405. data/lib/aws/record/validations.rb +694 -0
  406. data/lib/aws/record/validator.rb +246 -0
  407. data/lib/aws/record/validators/acceptance.rb +49 -0
  408. data/lib/aws/record/validators/block.rb +36 -0
  409. data/lib/aws/record/validators/confirmation.rb +41 -0
  410. data/lib/aws/record/validators/count.rb +106 -0
  411. data/lib/aws/record/validators/exclusion.rb +41 -0
  412. data/lib/aws/record/validators/format.rb +55 -0
  413. data/lib/aws/record/validators/inclusion.rb +54 -0
  414. data/lib/aws/record/validators/length.rb +105 -0
  415. data/lib/aws/record/validators/method.rb +31 -0
  416. data/lib/aws/record/validators/numericality.rb +136 -0
  417. data/lib/aws/record/validators/presence.rb +43 -0
  418. data/lib/aws/redshift.rb +51 -0
  419. data/lib/aws/redshift/client.rb +35 -0
  420. data/lib/aws/redshift/config.rb +18 -0
  421. data/lib/aws/redshift/errors.rb +22 -0
  422. data/lib/aws/route_53.rb +86 -0
  423. data/lib/aws/route_53/change_batch.rb +161 -0
  424. data/lib/aws/route_53/change_info.rb +72 -0
  425. data/lib/aws/route_53/client.rb +38 -0
  426. data/lib/aws/route_53/config.rb +18 -0
  427. data/lib/aws/route_53/errors.rb +22 -0
  428. data/lib/aws/route_53/hosted_zone.rb +134 -0
  429. data/lib/aws/route_53/hosted_zone_collection.rb +101 -0
  430. data/lib/aws/route_53/resource_record_set.rb +251 -0
  431. data/lib/aws/route_53/resource_record_set_collection.rb +110 -0
  432. data/lib/aws/s3.rb +156 -0
  433. data/lib/aws/s3/access_control_list.rb +265 -0
  434. data/lib/aws/s3/acl_object.rb +264 -0
  435. data/lib/aws/s3/acl_options.rb +204 -0
  436. data/lib/aws/s3/bucket.rb +742 -0
  437. data/lib/aws/s3/bucket_collection.rb +162 -0
  438. data/lib/aws/s3/bucket_lifecycle_configuration.rb +473 -0
  439. data/lib/aws/s3/bucket_tag_collection.rb +111 -0
  440. data/lib/aws/s3/bucket_version_collection.rb +79 -0
  441. data/lib/aws/s3/cipher_io.rb +120 -0
  442. data/lib/aws/s3/client.rb +2067 -0
  443. data/lib/aws/s3/client/xml.rb +266 -0
  444. data/lib/aws/s3/config.rb +48 -0
  445. data/lib/aws/s3/cors_rule.rb +108 -0
  446. data/lib/aws/s3/cors_rule_collection.rb +194 -0
  447. data/lib/aws/s3/data_options.rb +191 -0
  448. data/lib/aws/s3/encryption_utils.rb +146 -0
  449. data/lib/aws/s3/errors.rb +94 -0
  450. data/lib/aws/s3/multipart_upload.rb +353 -0
  451. data/lib/aws/s3/multipart_upload_collection.rb +76 -0
  452. data/lib/aws/s3/object_collection.rb +353 -0
  453. data/lib/aws/s3/object_metadata.rb +103 -0
  454. data/lib/aws/s3/object_upload_collection.rb +77 -0
  455. data/lib/aws/s3/object_version.rb +154 -0
  456. data/lib/aws/s3/object_version_collection.rb +89 -0
  457. data/lib/aws/s3/paginated_collection.rb +75 -0
  458. data/lib/aws/s3/policy.rb +74 -0
  459. data/lib/aws/s3/prefix_and_delimiter_collection.rb +47 -0
  460. data/lib/aws/s3/prefixed_collection.rb +85 -0
  461. data/lib/aws/s3/presign_v4.rb +136 -0
  462. data/lib/aws/s3/presigned_post.rb +554 -0
  463. data/lib/aws/s3/request.rb +62 -0
  464. data/lib/aws/s3/s3_object.rb +1784 -0
  465. data/lib/aws/s3/tree.rb +116 -0
  466. data/lib/aws/s3/tree/branch_node.rb +68 -0
  467. data/lib/aws/s3/tree/child_collection.rb +104 -0
  468. data/lib/aws/s3/tree/leaf_node.rb +94 -0
  469. data/lib/aws/s3/tree/node.rb +22 -0
  470. data/lib/aws/s3/tree/parent.rb +87 -0
  471. data/lib/aws/s3/uploaded_part.rb +82 -0
  472. data/lib/aws/s3/uploaded_part_collection.rb +84 -0
  473. data/lib/aws/s3/website_configuration.rb +102 -0
  474. data/lib/aws/simple_db.rb +218 -0
  475. data/lib/aws/simple_db/attribute.rb +156 -0
  476. data/lib/aws/simple_db/attribute_collection.rb +240 -0
  477. data/lib/aws/simple_db/client.rb +67 -0
  478. data/lib/aws/simple_db/config.rb +20 -0
  479. data/lib/aws/simple_db/consistent_read_option.rb +42 -0
  480. data/lib/aws/simple_db/delete_attributes.rb +62 -0
  481. data/lib/aws/simple_db/domain.rb +123 -0
  482. data/lib/aws/simple_db/domain_collection.rb +86 -0
  483. data/lib/aws/simple_db/domain_metadata.rb +110 -0
  484. data/lib/aws/simple_db/errors.rb +55 -0
  485. data/lib/aws/simple_db/expect_condition_option.rb +45 -0
  486. data/lib/aws/simple_db/item.rb +93 -0
  487. data/lib/aws/simple_db/item_collection.rb +654 -0
  488. data/lib/aws/simple_db/item_data.rb +73 -0
  489. data/lib/aws/simple_db/put_attributes.rb +60 -0
  490. data/lib/aws/simple_email_service.rb +443 -0
  491. data/lib/aws/simple_email_service/client.rb +37 -0
  492. data/lib/aws/simple_email_service/config.rb +18 -0
  493. data/lib/aws/simple_email_service/email_address_collection.rb +69 -0
  494. data/lib/aws/simple_email_service/errors.rb +22 -0
  495. data/lib/aws/simple_email_service/identity.rb +230 -0
  496. data/lib/aws/simple_email_service/identity_collection.rb +81 -0
  497. data/lib/aws/simple_email_service/quotas.rb +66 -0
  498. data/lib/aws/simple_workflow.rb +227 -0
  499. data/lib/aws/simple_workflow/activity_task.rb +178 -0
  500. data/lib/aws/simple_workflow/activity_task_collection.rb +123 -0
  501. data/lib/aws/simple_workflow/activity_type.rb +131 -0
  502. data/lib/aws/simple_workflow/activity_type_collection.rb +93 -0
  503. data/lib/aws/simple_workflow/client.rb +69 -0
  504. data/lib/aws/simple_workflow/config.rb +18 -0
  505. data/lib/aws/simple_workflow/count.rb +49 -0
  506. data/lib/aws/simple_workflow/decision_task.rb +603 -0
  507. data/lib/aws/simple_workflow/decision_task_collection.rb +223 -0
  508. data/lib/aws/simple_workflow/domain.rb +122 -0
  509. data/lib/aws/simple_workflow/domain_collection.rb +169 -0
  510. data/lib/aws/simple_workflow/errors.rb +20 -0
  511. data/lib/aws/simple_workflow/history_event.rb +276 -0
  512. data/lib/aws/simple_workflow/history_event_collection.rb +76 -0
  513. data/lib/aws/simple_workflow/option_formatters.rb +82 -0
  514. data/lib/aws/simple_workflow/resource.rb +94 -0
  515. data/lib/aws/simple_workflow/type.rb +89 -0
  516. data/lib/aws/simple_workflow/type_collection.rb +140 -0
  517. data/lib/aws/simple_workflow/workflow_execution.rb +384 -0
  518. data/lib/aws/simple_workflow/workflow_execution_collection.rb +617 -0
  519. data/lib/aws/simple_workflow/workflow_type.rb +177 -0
  520. data/lib/aws/simple_workflow/workflow_type_collection.rb +91 -0
  521. data/lib/aws/sns.rb +76 -0
  522. data/lib/aws/sns/client.rb +35 -0
  523. data/lib/aws/sns/config.rb +18 -0
  524. data/lib/aws/sns/errors.rb +22 -0
  525. data/lib/aws/sns/has_delivery_policy.rb +68 -0
  526. data/lib/aws/sns/message.rb +204 -0
  527. data/lib/aws/sns/originators/from_auto_scaling.rb +68 -0
  528. data/lib/aws/sns/policy.rb +47 -0
  529. data/lib/aws/sns/subscription.rb +165 -0
  530. data/lib/aws/sns/subscription_collection.rb +78 -0
  531. data/lib/aws/sns/topic.rb +403 -0
  532. data/lib/aws/sns/topic_collection.rb +62 -0
  533. data/lib/aws/sns/topic_subscription_collection.rb +54 -0
  534. data/lib/aws/sqs.rb +80 -0
  535. data/lib/aws/sqs/client.rb +53 -0
  536. data/lib/aws/sqs/config.rb +20 -0
  537. data/lib/aws/sqs/errors.rb +125 -0
  538. data/lib/aws/sqs/policy.rb +48 -0
  539. data/lib/aws/sqs/queue.rb +856 -0
  540. data/lib/aws/sqs/queue_collection.rb +186 -0
  541. data/lib/aws/sqs/received_message.rb +190 -0
  542. data/lib/aws/sqs/received_sns_message.rb +116 -0
  543. data/lib/aws/storage_gateway.rb +72 -0
  544. data/lib/aws/storage_gateway/client.rb +42 -0
  545. data/lib/aws/storage_gateway/config.rb +18 -0
  546. data/lib/aws/storage_gateway/errors.rb +22 -0
  547. data/lib/aws/sts.rb +164 -0
  548. data/lib/aws/sts/client.rb +55 -0
  549. data/lib/aws/sts/config.rb +18 -0
  550. data/lib/aws/sts/errors.rb +22 -0
  551. data/lib/aws/sts/federated_session.rb +56 -0
  552. data/lib/aws/sts/policy.rb +30 -0
  553. data/lib/aws/sts/session.rb +48 -0
  554. data/lib/aws/support.rb +29 -0
  555. data/lib/aws/support/client.rb +35 -0
  556. data/lib/aws/support/config.rb +18 -0
  557. data/lib/aws/support/errors.rb +20 -0
  558. data/lib/aws/version.rb +17 -0
  559. data/rails/init.rb +15 -0
  560. metadata +634 -0
@@ -0,0 +1,165 @@
1
+ # Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License"). You
4
+ # may not use this file except in compliance with the License. A copy of
5
+ # the License is located at
6
+ #
7
+ # http://aws.amazon.com/apache2.0/
8
+ #
9
+ # or in the "license" file accompanying this file. This file is
10
+ # distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
11
+ # ANY KIND, either express or implied. See the License for the specific
12
+ # language governing permissions and limitations under the License.
13
+
14
+ module AWS
15
+ class DynamoDB
16
+
17
+ # Represents the tables in your account. Each table is
18
+ # represented by an instance of the {Table} class.
19
+ #
20
+ # ## Schemas
21
+ #
22
+ # Before you can operate on items in a table you must specify the schema.
23
+ # You do this by calling #hash_key= (and optionally #range_key=) on
24
+ # a table.
25
+ #
26
+ # table = dynamo_db.tables['mytable']
27
+ # table.hash_key = [:id, :string]
28
+ #
29
+ # @example Creating a Table
30
+ # table = dynamo_db.tables.create('mytable', 10, 10, :hash_key => { :id => :string })
31
+ #
32
+ # @example Enumerating Tables
33
+ # dynamo_db.tables.each {|table| puts table.name }
34
+ #
35
+ # @example Getting a Table by Name
36
+ # table = dynamo_db.tables['mytable']
37
+ #
38
+ class TableCollection
39
+
40
+ include Core::Collection::WithLimitAndNextToken
41
+
42
+ # Creates a new table.
43
+ #
44
+ # table = dynamo_db.tables.create('mytable', 25, 25,
45
+ # :hash_key => { :id => :string })
46
+ #
47
+ # @note Creating a table is an eventualy consistent operation. You
48
+ # can not interact with the table until its status
49
+ # ({Table#status}) is `:active`.
50
+ #
51
+ # @param [String] name The name of the table.
52
+ #
53
+ # @param [Integer] read_capacity_units Sets the minimum
54
+ # number of reads supported before read requests are throttled.
55
+ #
56
+ # @param [Integer] write_capacity_units Sets the minimum
57
+ # number of writes supported before writes requests are throttled.
58
+ #
59
+ # @param [Hash] options
60
+ #
61
+ # @option options [Hash] :hash_key A hash key is a combination
62
+ # of an attribute name and type. If you want to have the
63
+ # hash key on the string attribute username you would call #create
64
+ # with:
65
+ #
66
+ # :hash_key => { :username => :string }
67
+ #
68
+ # The other supported types are `:number` and `:binary`. If you
69
+ # wanted to set the hash key on a numeric (integer) attribute then you
70
+ # could call #create with:
71
+ #
72
+ # :hash_key => { :id => :number }
73
+ #
74
+ # All tables require a hash key. If `:hash_key` is not provided
75
+ # then a default hash key will be provided. The default hash
76
+ # key is:
77
+ #
78
+ # :hash_key => { :id => :string }
79
+ #
80
+ # @option options [String] :range_key You can setup a table to use
81
+ # composite keys by providing a `:range_key`. Range keys are
82
+ # configured the same way as hash keys. They are useful
83
+ # for ordering items that share the same hash key.
84
+ #
85
+ # @return [Table] The newly created table.
86
+ #
87
+ def create name, read_capacity_units, write_capacity_units, options = {}
88
+
89
+ client_opts = {
90
+ :table_name => name.to_s,
91
+ :key_schema => key_schema(options),
92
+ :provisioned_throughput => {
93
+ :read_capacity_units => read_capacity_units,
94
+ :write_capacity_units => write_capacity_units,
95
+ },
96
+ }
97
+
98
+ response = client.create_table(client_opts)
99
+
100
+ Table.new(name, :config => config)
101
+
102
+ end
103
+
104
+ # References a table by name.
105
+ #
106
+ # dynamo_db.tables["MyTable"]
107
+ #
108
+ # @param [String] name
109
+ # @return [Table] Returns the table with the given name.
110
+ def [] name
111
+ Table.new(name, :config => config)
112
+ end
113
+
114
+ # @api private
115
+ protected
116
+ def _each_item next_token, limit, options = {}, &block
117
+
118
+ options[:limit] = limit if limit
119
+ options[:exclusive_start_table_name] = next_token if next_token
120
+
121
+ response = client.list_tables(options)
122
+ response.data['TableNames'].each do |name|
123
+ yield Table.new(name, :config => config)
124
+ end
125
+
126
+ response.data['LastEvaluatedTableName']
127
+
128
+ end
129
+
130
+ private
131
+ def key_schema options
132
+
133
+ hash_key, range_key = options.values_at(:hash_key, :range_key)
134
+
135
+ # default options for :hash_key
136
+ hash_key ||= { :id => :string }
137
+
138
+ schema = {}
139
+ schema[:hash_key_element] = schema_element(hash_key, "hash")
140
+ if range_key
141
+ schema[:range_key_element] = schema_element(range_key, "range")
142
+ end
143
+ schema
144
+
145
+ end
146
+
147
+ private
148
+ def schema_element desc, key_type
149
+
150
+ (name, type) = desc.to_a.first
151
+
152
+ unless [:string, :number, :binary].include?(type)
153
+ msg = "invalid #{key_type} key type, expected :string, :number or :binary"
154
+ raise ArgumentError, msg
155
+ end
156
+
157
+ { :attribute_name => name.to_s,
158
+ :attribute_type => type.to_s[0,1].upcase }
159
+
160
+ end
161
+
162
+ end
163
+
164
+ end
165
+ end
@@ -0,0 +1,111 @@
1
+ # Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License"). You
4
+ # may not use this file except in compliance with the License. A copy of
5
+ # the License is located at
6
+ #
7
+ # http://aws.amazon.com/apache2.0/
8
+ #
9
+ # or in the "license" file accompanying this file. This file is
10
+ # distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
11
+ # ANY KIND, either express or implied. See the License for the specific
12
+ # language governing permissions and limitations under the License.
13
+
14
+ require 'bigdecimal'
15
+ require 'set'
16
+ require 'base64'
17
+
18
+ module AWS
19
+ class DynamoDB
20
+
21
+ # @api private
22
+ module Types
23
+
24
+ def value_from_response(hash, options = {})
25
+ (type, value) = hash.to_a.first
26
+ case type
27
+ when "S", :s
28
+ value
29
+ when "SS", :ss
30
+ Set[*value]
31
+ when "N", :n
32
+ cast_number(value, options)
33
+ when "NS", :ns
34
+ Set[*value.map {|v| cast_number(v, options) }]
35
+ when "B", :b
36
+ cast_binary(value)
37
+ when "BS", :bs
38
+ Set[*value.map{|v| cast_binary(v) }]
39
+ end
40
+ end
41
+
42
+ def values_from_response_hash(hash, options = {})
43
+ hash.inject({}) do |h, (key, value_hash)|
44
+ h.update(key => value_from_response(value_hash))
45
+ end
46
+ end
47
+
48
+ def format_attribute_value(value, context = nil)
49
+
50
+ indicator = type_indicator(value, context)
51
+
52
+ value =
53
+ case
54
+ when value == :empty_number_set then []
55
+ when indicator == :n then value.to_s
56
+ when indicator == :ns then value.map(&:to_s)
57
+ else value
58
+ end
59
+
60
+ { indicator => value }
61
+
62
+ end
63
+
64
+ protected
65
+
66
+ def cast_number number, options = {}
67
+
68
+ cfg = self.respond_to?(:config) ? self.config :
69
+ (options[:config] || AWS.config)
70
+
71
+ cfg.dynamo_db_big_decimals ? BigDecimal.new(number.to_s) : number.to_f
72
+
73
+ end
74
+
75
+ def cast_binary data
76
+ DynamoDB::Binary.new(data)
77
+ end
78
+
79
+ def type_indicator(value, context)
80
+ case
81
+ when value.kind_of?(DynamoDB::Binary) then :b
82
+ when value.respond_to?(:to_str) then :s
83
+ when value.kind_of?(Numeric) then :n
84
+ when value.respond_to?(:each)
85
+ indicator = nil
86
+ value.each do |v|
87
+ member_indicator = type_indicator(v, context)
88
+ raise_error("nested collections", context) if
89
+ member_indicator.to_s.size > 1
90
+ raise_error("mixed types", context) if
91
+ indicator and member_indicator != indicator
92
+ indicator = member_indicator
93
+ end
94
+ indicator ||= :s
95
+ :"#{indicator}s"
96
+ when value == :empty_number_set
97
+ :ns
98
+ else
99
+ raise_error("unsupported attribute type #{value.class}", context)
100
+ end
101
+ end
102
+
103
+ def raise_error(msg, context)
104
+ msg = "#{msg} in #{context}" if context
105
+ raise ArgumentError, msg
106
+ end
107
+
108
+ end
109
+
110
+ end
111
+ end
data/lib/aws/ec2.rb ADDED
@@ -0,0 +1,428 @@
1
+ # Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License"). You
4
+ # may not use this file except in compliance with the License. A copy of
5
+ # the License is located at
6
+ #
7
+ # http://aws.amazon.com/apache2.0/
8
+ #
9
+ # or in the "license" file accompanying this file. This file is
10
+ # distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
11
+ # ANY KIND, either express or implied. See the License for the specific
12
+ # language governing permissions and limitations under the License.
13
+
14
+ require 'aws/core'
15
+ require 'aws/ec2/config'
16
+
17
+ module AWS
18
+
19
+ # Provides an expressive, object-oriented interface to Amazon EC2.
20
+ #
21
+ # ## Credentials
22
+ #
23
+ # You can setup default credentials for all AWS services via
24
+ # AWS.config:
25
+ #
26
+ # AWS.config(
27
+ # :access_key_id => 'YOUR_ACCESS_KEY_ID',
28
+ # :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
29
+ #
30
+ # Or you can set them directly on the EC2 interface:
31
+ #
32
+ # ec2 = AWS::EC2.new(
33
+ # :access_key_id => 'YOUR_ACCESS_KEY_ID',
34
+ # :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
35
+ #
36
+ # ## Instances
37
+ #
38
+ # EC2 uses instances to run your software.
39
+ #
40
+ # To run an instance:
41
+ #
42
+ # ec2.instances.create(:image_id => "ami-8c1fece5")
43
+ #
44
+ # To get an instance by ID:
45
+ #
46
+ # i = ec2.instances["i-12345678"]
47
+ # i.exists?
48
+ #
49
+ # To get a list of instances:
50
+ #
51
+ # ec2.instances.inject({}) { |m, i| m[i.id] = i.status; m }
52
+ # # => { "i-12345678" => :running, "i-87654321" => :shutting_down }
53
+ #
54
+ # ## Security Groups
55
+ #
56
+ # A security group is a named collection of access rules. These access
57
+ # rules specify which ingress (i.e., incoming) network traffic should be
58
+ # delivered to your instance. All other ingress traffic will be discarded.
59
+ #
60
+ # To create a security group:
61
+ #
62
+ # websvr = ec2.security_groups.create('webservers')
63
+ #
64
+ # Then you can add ingress authorizations. In the following example
65
+ # we add a rule that allows web traffic from the entire internet.
66
+ #
67
+ # # web traffic
68
+ # websvr.authorize_ingress(:tcp, 80)
69
+ #
70
+ # You can also specify a port range. Here we are opening FTP traffic:
71
+ #
72
+ # # ftp traffic
73
+ # websvr.authorize_ingress(:tcp, 20..21)
74
+ #
75
+ # If you want to limit an authorization to a particular CIDR IP address or
76
+ # list of address, just add them to the #authorize_ingress call.
77
+ #
78
+ # # ssh access
79
+ # websrvr.authorize_ingress(:tcp, 22, '1.1.1.1/0', '2.2.2.2/0')
80
+ #
81
+ # You can also provide another security group instead of CIDR IP addresses.
82
+ # This allows incoming traffic from EC2 instances in the given security
83
+ # group(s).
84
+ #
85
+ # # get two existing security groups
86
+ # dbsvrs = ec2.security_groups.filter('group-name', 'db-servers').first
87
+ # websvrs = ec2.security_groups.filter('group-name', 'web-servers').first
88
+ #
89
+ # # allow instances in the 'web-servers' security group to connect
90
+ # # to instances in the 'db-servers' security group over tcp port 3306
91
+ # dbsvrs.authorize_ingress(:tcp, 3306, websvrs)
92
+ #
93
+ # There are a few handy shortcuts for allowing pings:
94
+ #
95
+ # wbsvrs.allow_ping
96
+ #
97
+ # Just like with authorize_ingress you can pass a security group or a list
98
+ # of CIDR IP addresses to allow ping to limit where you can ping from.
99
+ #
100
+ # You can also use the same parameters from the examples above to
101
+ # {SecurityGroup#revoke_ingress} and {SecurityGroup#disallow_ping}.
102
+ #
103
+ # You can specify other protocols than `:tcp`, like :udp and :icmp.
104
+ #
105
+ # ## Elastic IPs
106
+ #
107
+ # You can allocate up to 5 elastic IP addresses for each account.
108
+ # You can associate those elastic IP addresses with EC2 instances:
109
+ #
110
+ # instance = ec2.instances['i-12345678']
111
+ # ip = ec2.elastic_ips.allocate
112
+ #
113
+ # instance.ip_address # 1.1.1.1
114
+ # ip.ip_address # 2.2.2.2
115
+ #
116
+ # instance.associate_elastic_ip(ip)
117
+ # instance.ip_address # 2.2.2.2
118
+ #
119
+ # instance.disassociate_elastic_ip
120
+ # instance.ip_address # 1.1.1.1
121
+ #
122
+ # When you are done with an elastic IP address you should release it.
123
+ # In the following example we release all elastic IP addresses that are
124
+ # not currently associated with an instance:
125
+ #
126
+ # ec2.elastic_ips.select{|ip| !ip.associated? }.each(&:release)
127
+ #
128
+ # ## Key Pairs
129
+ #
130
+ # Public Amazon Machine Image (AMI) instances have no password, and you need a
131
+ # public/private key pair to log in to them. The public key half
132
+ # of this pair is embedded in your instance, allowing you to use
133
+ # the private key to log in securely without a password.
134
+ #
135
+ # You can generate a key pair yourself and then send the public
136
+ # part to EC2 using {KeyPairCollection#import}. For example:
137
+ #
138
+ # key_pair = ec2.key_pairs.import("mykey", File.read("~/.ssh/identity.pub"))
139
+ #
140
+ # You can also ask EC2 to generate a key pair for you. For
141
+ # example:
142
+ #
143
+ # key_pair = ec2.key_pairs.create("mykey")
144
+ # File.open("~/.ssh/ec2", "wb") do |f|
145
+ # f.write(key_pair.private_key)
146
+ # end
147
+ #
148
+ # ## Filtering and Tagging
149
+ #
150
+ # Any of the collections in the interface may be filtered by a
151
+ # number of different parameters. For example, to get all the
152
+ # windows images owned by amazon where the description includes
153
+ # the string "linux", you can do this:
154
+ #
155
+ # ec2.images.with_owner("amazon").
156
+ # filter("platform", "windows").
157
+ # filter("description", "*linux*")
158
+ #
159
+ # Similarly, you can tag images, instances, security groups,
160
+ # snapshots, and volumes with free-form key-value metadata and
161
+ # filter on that metadata. For example:
162
+ #
163
+ # ec2.images["ami-123"].tags << "myapp"
164
+ # ec2.images.tagged("myapp") # will include ami-123
165
+ #
166
+ # ## Regions
167
+ #
168
+ # Amazon has data centers in different areas of the world (e.g.,
169
+ # North America, Europe, Asia, etc.). Correspondingly, EC2 is
170
+ # available to use in different Regions. By launching instances in
171
+ # separate Regions, you can design your application to be closer
172
+ # to specific customers or to meet legal or other
173
+ # requirements. Prices for Amazon EC2 usage vary by Region (for
174
+ # more information about pricing by Region, go to the
175
+ # [Amazon EC2 Pricing page](http://aws.amazon.com/ec2/pricing)).
176
+ # You can use the Ruby SDK to see which regions are available for your
177
+ # account:
178
+ #
179
+ # ec2.regions.map(&:name) # => ["us-east-1", ...]
180
+ #
181
+ # The default region is `us-east-1`; you can access other regions
182
+ # like this:
183
+ #
184
+ # ec2 = AWS::EC2.new(:region => "us-west-1")
185
+ # ec2.instances.create(:image_id => 'ami-3bc9997e')
186
+ #
187
+ # ## Availability Zones
188
+ #
189
+ # Each Region contains multiple distinct locations called
190
+ # Availability Zones. Each Availability Zone is engineered to be
191
+ # isolated from failures in other Availability zones and to
192
+ # provide inexpensive, low-latency network connectivity to other
193
+ # zones in the same Region. By launching instances in separate
194
+ # Availability Zones, you can protect your applications from the
195
+ # failure of a single location.
196
+ #
197
+ # You can use the {#availability_zones} collection to get information
198
+ # about the available zones available to your account. For
199
+ # example:
200
+ #
201
+ # ec2.availability_zones.map(&:name) # => ["us-east-1a", ...]
202
+ #
203
+ # ## Images
204
+ #
205
+ # An Amazon Machine Image (AMI) contains all information necessary
206
+ # to boot instances of your software. For example, an AMI might
207
+ # contain all the software to act as a web server (e.g., Linux,
208
+ # Apache, and your web site) or it might contain all the software
209
+ # to act as a Hadoop node (e.g., Linux, Hadoop, and a custom
210
+ # application).
211
+ #
212
+ # You can use the {#images} collection to get information about
213
+ # the images available to your account. For example:
214
+ #
215
+ # ec2.images.with_owner("amazon").map(&:name)
216
+ #
217
+ # You can also use the images collection to create new images:
218
+ #
219
+ # ec2.images.create(
220
+ # :image_location => "mybucket/manifest.xml",
221
+ # :name => "my-image")
222
+ #
223
+ # @!attribute [r] client
224
+ # @return [Client] the low-level EC2 client object
225
+ class EC2
226
+
227
+ autoload :Attachment, 'aws/ec2/attachment'
228
+ autoload :AttachmentCollection, 'aws/ec2/attachment_collection'
229
+ autoload :AvailabilityZone, 'aws/ec2/availability_zone'
230
+ autoload :AvailabilityZoneCollection, 'aws/ec2/availability_zone_collection'
231
+ autoload :BlockDeviceMappings, 'aws/ec2/block_device_mappings'
232
+ autoload :Client, 'aws/ec2/client'
233
+ autoload :Collection, 'aws/ec2/collection'
234
+ autoload :CustomerGateway, 'aws/ec2/customer_gateway'
235
+ autoload :CustomerGatewayCollection, 'aws/ec2/customer_gateway_collection'
236
+ autoload :DHCPOptions, 'aws/ec2/dhcp_options'
237
+ autoload :DHCPOptionsCollection, 'aws/ec2/dhcp_options_collection'
238
+ autoload :ElasticIp, 'aws/ec2/elastic_ip'
239
+ autoload :ElasticIpCollection, 'aws/ec2/elastic_ip_collection'
240
+ autoload :Errors, 'aws/ec2/errors'
241
+ autoload :ExportTask, 'aws/ec2/export_task'
242
+ autoload :ExportTaskCollection, 'aws/ec2/export_task_collection'
243
+ autoload :FilteredCollection, 'aws/ec2/filtered_collection'
244
+ autoload :HasPermissions, 'aws/ec2/has_permissions'
245
+ autoload :Image, 'aws/ec2/image'
246
+ autoload :ImageCollection, 'aws/ec2/image_collection'
247
+ autoload :Instance, 'aws/ec2/instance'
248
+ autoload :InstanceCollection, 'aws/ec2/instance_collection'
249
+ autoload :InternetGateway, 'aws/ec2/internet_gateway'
250
+ autoload :InternetGatewayCollection, 'aws/ec2/internet_gateway_collection'
251
+ autoload :KeyPair, 'aws/ec2/key_pair'
252
+ autoload :KeyPairCollection, 'aws/ec2/key_pair_collection'
253
+ autoload :NetworkACL, 'aws/ec2/network_acl'
254
+ autoload :NetworkACLCollection, 'aws/ec2/network_acl_collection'
255
+ autoload :NetworkInterface, 'aws/ec2/network_interface'
256
+ autoload :NetworkInterfaceCollection, 'aws/ec2/network_interface_collection'
257
+ autoload :PermissionCollection, 'aws/ec2/permission_collection'
258
+ autoload :Region, 'aws/ec2/region'
259
+ autoload :RegionCollection, 'aws/ec2/region_collection'
260
+ autoload :ReservedInstances, 'aws/ec2/reserved_instances'
261
+ autoload :ReservedInstancesCollection, 'aws/ec2/reserved_instances_collection'
262
+ autoload :ReservedInstancesOffering, 'aws/ec2/reserved_instances_offering'
263
+ autoload :ReservedInstancesOfferingCollection, 'aws/ec2/reserved_instances_offering_collection'
264
+ autoload :Resource, 'aws/ec2/resource'
265
+ autoload :ResourceObject, 'aws/ec2/tag_collection'
266
+ autoload :ResourceTagCollection, 'aws/ec2/resource_tag_collection'
267
+ autoload :RouteTable, 'aws/ec2/route_table'
268
+ autoload :RouteTableCollection, 'aws/ec2/route_table_collection'
269
+ autoload :SecurityGroup, 'aws/ec2/security_group'
270
+ autoload :SecurityGroupCollection, 'aws/ec2/security_group_collection'
271
+ autoload :Snapshot, 'aws/ec2/snapshot'
272
+ autoload :SnapshotCollection, 'aws/ec2/snapshot_collection'
273
+ autoload :Subnet, 'aws/ec2/subnet'
274
+ autoload :SubnetCollection, 'aws/ec2/subnet_collection'
275
+ autoload :Tag, 'aws/ec2/tag'
276
+ autoload :TagCollection, 'aws/ec2/tag_collection'
277
+ autoload :TaggedCollection, 'aws/ec2/tagged_collection'
278
+ autoload :TaggedItem, 'aws/ec2/tagged_item'
279
+ autoload :Volume, 'aws/ec2/volume'
280
+ autoload :VolumeCollection, 'aws/ec2/volume_collection'
281
+ autoload :VPC, 'aws/ec2/vpc'
282
+ autoload :VPCCollection, 'aws/ec2/vpc_collection'
283
+ autoload :VPNConnection, 'aws/ec2/vpn_connection'
284
+ autoload :VPNConnectionCollection, 'aws/ec2/vpn_connection_collection'
285
+ autoload :VPNGateway, 'aws/ec2/vpn_gateway'
286
+ autoload :VPNGatewayCollection, 'aws/ec2/vpn_gateway_collection'
287
+
288
+ include Core::ServiceInterface
289
+
290
+ endpoint_prefix 'ec2'
291
+
292
+ # @return [InstanceCollection] A collection representing all instances
293
+ def instances
294
+ InstanceCollection.new(:config => config)
295
+ end
296
+
297
+ # @return [SecurityGroupCollection] A collection representing all security
298
+ # groups.
299
+ def security_groups
300
+ SecurityGroupCollection.new(:config => config)
301
+ end
302
+
303
+ # @return [ElasticIpCollection] A collection representing all
304
+ # elastic IP addresses for this account.
305
+ def elastic_ips
306
+ ElasticIpCollection.new(:config => config)
307
+ end
308
+
309
+ # @return [KeyPairCollection] A collection representing all key pairs.
310
+ def key_pairs
311
+ KeyPairCollection.new(:config => config)
312
+ end
313
+
314
+ # @return [TagCollection] A collection representing all EC2 tags for
315
+ # all resource types.
316
+ def tags
317
+ TagCollection.new(:config => config)
318
+ end
319
+
320
+ # @return [RegionCollection] A collection representing all EC2
321
+ # regions.
322
+ def regions
323
+ RegionCollection.new(:config => config)
324
+ end
325
+
326
+ # @return [AvailabilityZoneCollection] A collection representing
327
+ # all EC2 availability zones.
328
+ def availability_zones
329
+ AvailabilityZoneCollection.new(:config => config)
330
+ end
331
+
332
+ # @return [ImageCollection] A collection representing
333
+ # all Amazon Machine Images available to your account.
334
+ def images
335
+ ImageCollection.new(:config => config)
336
+ end
337
+
338
+ # @return [VolumeCollection] A collection representing
339
+ # all EBS volumes available to your account.
340
+ def volumes
341
+ VolumeCollection.new(:config => config)
342
+ end
343
+
344
+ # @return [ReservedInstancesCollection] A collection representing all
345
+ # purchased reserved instance offerings.
346
+ def reserved_instances
347
+ ReservedInstancesCollection.new(:config => config)
348
+ end
349
+
350
+ # @return [ReservedInstancesOfferingCollection] A collection representing all
351
+ # reserved instance offerings that may be purchased.
352
+ def reserved_instances_offerings
353
+ ReservedInstancesOfferingCollection.new(:config => config)
354
+ end
355
+
356
+ # @return [SnapshotCollection] A collection representing
357
+ # all EBS snapshots available to your account.
358
+ def snapshots
359
+ SnapshotCollection.new(:config => config)
360
+ end
361
+
362
+ # @return [VPCCollection] A collection representing
363
+ # all VPCs in your account.
364
+ def vpcs
365
+ VPCCollection.new(:config => config)
366
+ end
367
+
368
+ # @return [SubnetCollection] Returns a collection that represents all
369
+ # of the subnets associated with this account (across all VPCs).
370
+ def subnets
371
+ SubnetCollection.new(:config => config)
372
+ end
373
+
374
+ # @return [NetworkACLCollection] Returns a collection that represents
375
+ # all of the network ACLs for this account.
376
+ def network_acls
377
+ NetworkACLCollection.new(:config => config)
378
+ end
379
+
380
+ # @return [RouteTableCollection] Returns a collection that represents
381
+ # all of the route tables for this account.
382
+ def route_tables
383
+ RouteTableCollection.new(:config => config)
384
+ end
385
+
386
+ # @return [NetworkInterfaceCollection] Returns a collection that
387
+ # represents all of the network interfaces for this account.
388
+ def network_interfaces
389
+ NetworkInterfaceCollection.new(:config => config)
390
+ end
391
+
392
+ # @return [InternetGatewayCollection] Returns a collection that
393
+ # represents all of the internet gateways for this account.
394
+ def internet_gateways
395
+ InternetGatewayCollection.new(:config => config)
396
+ end
397
+
398
+ # @return [CustomerGatewayCollection] Returns a collection that
399
+ # represents all of the customer gateways for this account.
400
+ def customer_gateways
401
+ CustomerGatewayCollection.new(:config => config)
402
+ end
403
+
404
+ # @return [VPNGatewayCollection] Returns a collection that
405
+ # represents all of the vpn gateways for this account.
406
+ def vpn_gateways
407
+ VPNGatewayCollection.new(:config => config)
408
+ end
409
+
410
+ # @return [DHCPOptionsCollection] Returns a collection that
411
+ # represents all of the dhcp options for this account.
412
+ def dhcp_options
413
+ DHCPOptionsCollection.new(:config => config)
414
+ end
415
+
416
+ # @return [VPNConnections] Returns a collection that
417
+ # represents all of vpn connections for this account.
418
+ def vpn_connections
419
+ VPNConnectionCollection.new(:config => config)
420
+ end
421
+
422
+ # @return [ExportTaskCollection]
423
+ def export_tasks
424
+ ExportTaskCollection.new(:config => config)
425
+ end
426
+
427
+ end
428
+ end