cloudcheckr 0.0.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 34b30e8a8bdde0cc99dc92f685533bda3c4153e4
-  data.tar.gz: 76adc2d38a7fe2afff6d1782d07939b710a31a8e
+  metadata.gz: dec582152815019c9671a80a39292bb06e20a3aa
+  data.tar.gz: 91019358515155970f75a17af21282dd3f0a2743
 SHA512:
-  metadata.gz: d6289c4350798ebe152b91fb08888a7d517fbbf9edf642e0883e86d9edb86d79809f52bd7bf6fb5a7bd90992602acf19f8ad48384eeb3811cdf7215d063b989c
-  data.tar.gz: 7d970ac7fbd8425a0c042e75d5f440417370ce8137f4447874de530646de6ca9717aada16f7173f63af4cec0ac1a09f85f695b588492e61bc98ca197bd85fb4d
+  metadata.gz: d23ddc22acb2a9a37ec7e0aa5de661abe3b16416e9e1bb69c032126d06316b7abdb5b22ab514f7dcf0ffdc7a2e8078fcc13a4510cdfcebd8ecda3282849b0902
+  data.tar.gz: 7f817f70d6d89f74321cfb83d53b9ad2d1380b889a033efa09c66fc7f76c08ca2fd3c5e2e59efbabba23d04cdfb10410d666240bd4793057a1dc8583790af134

data/.gitignore

@@ -20,3 +20,4 @@ tmp
 *.o
 *.a
 mkmf.log
+.env

data/README.md

@@ -1,6 +1,6 @@
-# Cloudcheckr
+# CloudCheckr
 
-TODO: Write a gem description
+This is the Ruby client for the CloudCheckr API.
 
 ## Installation
 
@@ -18,7 +18,133 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+The API client uses JSON by default. Here's how to instantiate an API client.
+
+```ruby
+# The only thing you need is an API key
+client = CloudCheckr::API::Client.new(access_key: "146D0Y8R...W6U0463K")
+
+# Another option is to set the API key globally
+CloudCheckr::API.access_key("146D0Y8R...W6U0463K")
+client = CloudCheckr::API::Client.new
+
+# Alternatively, keep the API key in an environment variable
+ENV['CLOUDCHECKR_ACCESS_KEY'] = "146D0Y8R...W6U0463K"
+client = CloudCheckr::API::Client.new
+
+# Use XML instead (not fully implemented)
+client = CloudCheckr::API::Client.new(format: :xml)
+```
+
+Each endpoint (or "API call") is grouped into a "controller". The API client has a method representing each controller, and each controller has a method for each API call.
+
+```ruby
+client = CloudCheckr::API::Client.new
+
+# The API client is pre-configured with a list of controllers, for which you can get a listing
+# Call any of these as a method on the `client`
+controller_names = client.controller_names
+# => [:account, :alert, :best_practice, :billing, :change_monitoring, :cloudwatch, :cloudwatchevent, :help, :inventory, :security]
+
+# Each controller is pre-configured with a list of API calls, for which you can also get a listing
+# Call any of these as a method on a controller
+api_calls = client.help.api_calls
+# => [:get_all_api_endpoints]
+
+# Let's get a list of all endpoints available to you based on your API access key
+# NOTE: The API client is pre-configured with a cached list of endpoints 
+#       and does not use the results of this call, specific to your API access key
+# https://api.cloudcheckr.com/api/help.json/get_all_api_endpoints?access_key=[access_key]
+endpoints = client.help.get_all_api_endpoints
+# => [{"controller_name"=>"account", "api_calls"=>[{"method_name"=>"get_users"...
+
+# As an example, we'll call the first endpoint listed in the above response
+# https://api.cloudcheckr.com/api/account.json/get_users?access_key=[access_key]
+users = client.account.get_users
+# => {"users_and_accounts"=>[{"username"=>"user@example.com", "account_names"=>["Example"]}]}
+
+# Pass parameters to an API call
+client.account.remove_user(email: "user@example.com")
+
+# Pass headers to an API call
+client.account.remove_user({email: "user@example.com"}, {'Content-Type': 'application/json'})
+```
+
+_NOTE: The controllers and API calls are defined in [endpoints.yml](./lib/cloud_checkr/api/endpoints.yml) (which is a cached listing retrieved from [get_all_api_endpoints](http://support.cloudcheckr.com/cloudcheckr-api-userguide/cloudcheckr-api-reference-guide/#get_all_api_endpoints))._
+
+Here's more information about the [API Reference](http://support.cloudcheckr.com/cloudcheckr-api-userguide/cloudcheckr-api-reference-guide/).
+
+### Admin API
+
+Some endpoints are admin-level and require an account name.
+
+```ruby
+access_key = "146D0Y8R...W6U0463K"
+account    = "Account Name"
+
+# Create an API client for with a default account specified
+client = CloudCheckr::API::Client.new(access_key: access_key, use_account: account)
+
+# Another option is to set the default account globally
+CloudCheckr::API.use_account(account)
+client = CloudCheckr::API::Client.new
+
+# Alternatively, keep the API key in an environment variable
+ENV['CLOUDCHECKR_USE_ACCOUNT'] = account
+client = CloudCheckr::API::Client.new
+```
+
+Here's more information about the [Admin API](http://support.cloudcheckr.com/cloudcheckr-api-userguide/cloudcheckr-admin-api-reference-guide/).
+
+Here's the [Admin API User Guide](http://support.cloudcheckr.com/cloudcheckr-api-userguide/).
+
+### Faraday
+
+The API client uses [Faraday](https://github.com/lostisland/faraday) under the hood. [Faraday Middleware](https://github.com/lostisland/faraday_middleware) is utilized to parse JSON and XML responses. JSON responses are wrapped in [Hashie::Mash](https://github.com/intridea/hashie) for easy access to data.
+
+It's easy to customize Faraday to your liking.
+
+```ruby
+# Globally apply Faraday settings
+CloudCheckr::API.connection_builder do |faraday|
+  faraday.request :url_encoded
+
+  faraday.response :xml,     content_type: /\bxml$/
+  faraday.response :json,    content_type: /\bjson$/
+  faraday.response :mashify, content_type: /\bjson$/
+  faraday.response :logger, nil, bodies: true
+
+  faraday.adapter Faraday.default_adapter  # make requests with Net::HTTP
+end
+
+# Alternatively, apply Faraday settings per client
+client = CloudCheckr::API::Client.new do
+  faraday.request :url_encoded
+
+  faraday.response :xml,     content_type: /\bxml$/
+  faraday.response :json,    content_type: /\bjson$/
+  faraday.response :mashify, content_type: /\bjson$/
+  faraday.response :logger, nil, bodies: true
+
+  faraday.adapter Faraday.default_adapter  # make requests with Net::HTTP
+end
+```
+
+You may also want to configure individual Faraday requests. This can be accomplished with any API call (see [Faraday examples](https://github.com/lostisland/faraday) for specifics).
+
+```ruby
+client = CloudCheckr::API::Client.new
+
+# Let's get a list of all endpoints available to you based on your API access key
+endpoints = client.help.get_all_api_endpoints do |request|
+  req.url '/search', page: 2
+  req.params['limit'] = 100
+  req.headers['Content-Type'] = 'application/json'
+  req.body = '{ "name": "value" }'
+  req.options.timeout = 5      # open/read timeout in seconds
+  req.options.open_timeout = 2 # connection open timeout in seconds
+end
+```
 
 ## Contributing
 
@@ -27,3 +153,10 @@ TODO: Write usage instructions here
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create a new Pull Request
+
+### TODO
+
+* Determine if there is a use case for XML format
+* RSpec tests
+
+

data/cloudcheckr.gemspec

@@ -18,7 +18,11 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
+  spec.add_dependency "faraday"
+  spec.add_dependency "faraday_middleware"
+
   spec.add_development_dependency "bundler", "~> 1.6"
   spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec"
+  spec.add_development_dependency "faraday-detailed_logger"
 end

data/lib/cloud_checkr.rb

@@ -0,0 +1,4 @@
+module CloudCheckr
+end
+
+require_relative "./cloud_checkr/api"

data/lib/cloud_checkr/api.rb

@@ -0,0 +1,43 @@
+require_relative "./api/controller"
+require_relative "./api/controllers"
+require_relative "./api/client"
+require_relative "./api/response_error"
+
+module CloudCheckr
+  module API
+    CONTROLLERS = CloudCheckr::API::Controllers.build_controller_classes!
+
+    def self.access_key(new_access_key = nil)
+      if new_access_key.nil?
+        @@access_key ||= ENV['CLOUDCHECKR_ACCESS_KEY']
+      else
+        @@access_key = new_access_key
+      end
+    end
+
+    def self.use_account(new_use_account = nil)
+      if new_use_account.nil?
+        @@use_account ||= ENV['CLOUDCHECKR_USE_ACCOUNT']
+      else
+        @@use_account = new_use_account
+      end
+    end
+
+    def self.connection_builder(&builder)
+      @@connection_builder = builder || @@connection_builder
+    end
+  end
+end
+
+# Dynamically create methods on the Client class for each controller
+
+CloudCheckr::API::CONTROLLERS.each do |controller_name, controller_class|
+  CloudCheckr::API::Client.send(:define_method, controller_name) do
+    instance_variable_get(:"@#{controller_name}") || instance_variable_set(:"@#{controller_name}", controller_class.new(self))
+  end
+end
+
+# Dynamically expose list of controllers available
+
+controller_names = CloudCheckr::API::CONTROLLERS.keys
+CloudCheckr::API::Client.send(:define_method, :controller_names){ controller_names }

data/lib/cloud_checkr/api/client.rb

@@ -0,0 +1,107 @@
+require 'logger'
+require 'ostruct'
+require 'faraday'
+require 'faraday_middleware'
+# require 'faraday/detailed_logger'
+
+module CloudCheckr
+  module API
+    class Client
+      DEFAULT_URL    = "https://api2.cloudcheckr.com".freeze
+      DEFAULT_FORMAT = :json
+
+      attr_reader :access_key, :url, :format
+
+      def initialize(options = {}, &connection_builder)
+        super()
+
+        @access_key         = options.fetch(:access_key,  API.access_key)
+        @use_account        = options.fetch(:use_account, API.use_account)
+        @url                = options.fetch(:url,         DEFAULT_URL)
+        @format             = options.fetch(:format,      :json)
+        @connection_builder = connection_builder
+      end
+
+      # API
+
+      def get(controller_name, api_call, params = nil, headers = nil, &request_builder)
+        handle_response api.get(prepare_path(controller_name, api_call), prepare_params(params), headers, &request_builder)
+      end
+
+      def post(controller_name, api_call, params = nil, headers = nil, &request_builder)
+        handle_response api.post(prepare_path(controller_name, api_call), prepare_params(params), headers, &request_builder)
+      end
+
+      def api
+        @api ||= build_connection
+      end
+
+      def default_params
+        {access_key: @access_key}
+      end
+
+      def require_params!(required_params, params)
+        missing_required_params = required_params.map(&:to_sym) - prepare_params(params).keys.map(&:to_sym)
+        
+        if missing_required_params.any?
+          raise "Missing required parameters: #{missing_required_params.join(', ')}"
+        else
+          nil
+        end
+      end
+
+      protected
+
+      def prepare_path(controller_name, api_call)
+        "/api/#{controller_name}.#{@format}/#{api_call}"
+      end
+
+      def prepare_params(params)
+        if params.nil?
+          default_params
+        else
+          default_params.merge(params)
+        end
+      end
+
+      def handle_response(response)
+        data = response.body
+
+        if response.status != 200
+          # TODO: Currently assumes JSON response
+          raise ::CloudCheckr::API::ResponseError.new(data)
+        else
+          data
+        end
+      end
+
+      def build_connection
+        Faraday.new(url: @url) do |faraday|
+          apply_connection_settings(faraday)
+
+          # Apply global settings, then instance settings
+          [::CloudCheckr::API.connection_builder, @connection_builder].each do |builder|
+            builder.call(faraday) if builder
+          end
+        end
+      end
+
+      def apply_connection_settings(faraday)
+        faraday.request @format
+        # form-encode POST params
+        faraday.request :url_encoded
+
+        faraday.response :xml,     content_type: /\bxml$/
+        faraday.response :json,    content_type: /\bjson$/
+        faraday.response :mashify, content_type: /\bjson$/
+        # faraday.response @format
+        # faraday.response :mashify if @format == :json
+
+        # faraday.response :logger, nil, bodies: true
+        # faraday.response :detailed_logger
+
+        faraday.adapter Faraday.default_adapter  # make requests with Net::HTTP
+      end
+    end
+  end
+end

data/lib/cloud_checkr/api/controller.rb

@@ -0,0 +1,13 @@
+module CloudCheckr
+  module API
+    class Controller
+      
+      attr_reader :client
+
+      def initialize(client)
+        @client = client
+      end
+
+    end
+  end
+end

data/lib/cloud_checkr/api/controllers.rb

@@ -0,0 +1,55 @@
+require 'yaml'
+
+module CloudCheckr
+  module API
+    module Controllers
+
+      # Returns a [Hash] with controller name and class
+      def self.build_controller_classes!
+        endpoints_path    = File.join(File.dirname(__FILE__), 'endpoints.yml')
+        endpoints_schemas = YAML.load_file(endpoints_path)
+        controllers       = {}
+
+        # Define a controller class for each controller name
+        endpoints_schemas.each do |schema|
+          controller_name       = schema['controller_name'].to_sym
+          controller_class_name = schema['controller_name'].split('_').collect(&:capitalize).join + 'Controller'
+
+          controller_class = Class.new(::CloudCheckr::API::Controller) do
+            method_names = []
+
+            # Define a method for each API call
+            schema['api_calls'].each do |api_call|
+              method_name     = api_call['method_name'].to_sym
+              required_params = api_call['param_names'].lazy.select{|name| name.include?('(required)')}.map{|name| name.gsub(/\([^\)]+\)/, '').to_sym}.to_a
+
+              if api_call['method_name'].start_with?('get_')
+                define_method(method_name) do |params = {}, headers = nil, &request_builder|
+                  @client.require_params!(required_params, params)
+                  @client.get(controller_name, method_name, params, headers, &request_builder)
+                end
+              else
+                define_method(method_name) do |params = {}, headers = nil, &request_builder|
+                  @client.require_params!(required_params, params)
+                  @client.post(controller_name, method_name, params, headers, &request_builder)
+                end
+              end
+
+              method_names << method_name
+            end
+
+            define_method(:api_calls){ method_names }
+          end
+
+          # Register the class within the Controllers module
+          self.const_set(controller_class_name, controller_class)
+
+          controllers[controller_name] = controller_class
+        end
+
+        controllers
+      end
+
+    end
+  end
+end

data/lib/cloud_checkr/api/endpoints.json

@@ -0,0 +1,289 @@
+[{
+  "controller_name": "account",
+  "api_calls": [{
+    "method_name": "get_users",
+    "param_names": ["(required)(admin level)access_key", "use_account"]
+  }, {
+    "method_name": "remove_user",
+    "param_names": ["(required)(admin level)access_key", "(required)email", "use_account"]
+  }, {
+    "method_name": "get_accounts",
+    "param_names": ["(required)(admin level)access_key", "use_account"]
+  }, {
+    "method_name": "revoke_account",
+    "param_names": ["(required)(admin level)access_key", "(required)email", "(required)accounts", "use_account"]
+  }, {
+    "method_name": "grant_account",
+    "param_names": ["(required)(admin level)access_key", "(required)email", "(required)accounts", "cost_report", "blended_cost", "unblended_cost", "list_cost", "resource_utilization_reports", "trending_reports", "change_monitoring", "best_practices", "all_access", "use_account"]
+  }, {
+    "method_name": "add_account",
+    "param_names": ["(required)access_key", "(required)account_name", "user_name", "aws_access_key", "aws_secret_key", "account_tag", "emails"]
+  }, {
+    "method_name": "delete_account",
+    "param_names": ["(required)access_key", "(required)account_name"]
+  }, {
+    "method_name": "tag_account",
+    "param_names": ["(required)access_key", "(required)account_name", "(required)account_tag"]
+  }, {
+    "method_name": "untag_account",
+    "param_names": ["(required)access_key", "(required)account_name", "(required)account_tag"]
+  }, {
+    "method_name": "edit_credential",
+    "param_names": ["(required)(admin level)access_key", "(required)aws_access_key", "(required)aws_secret_key", "(required)use_account"]
+  }, {
+    "method_name": "edit_account",
+    "param_names": ["(required)(admin level)access_key", "(required)emails", "(required)use_account", "alert_daily_billing", "alert_health_affected", "alert_health_all", "change_monitoring", "best_practices", "daily_bill_summary", "monthly_bill_summary", "daily_consolidated_bill_summary", "monthly_consolidated_bill_summary", "inventory_summary_report", "ec2_trending_report", "s3_summary_report", "ec2_resource_utilization_report"]
+  }, {
+    "method_name": "add_user",
+    "param_names": ["(required)access_key", "(required)email", "(required)account_access", "(required)user_role", "cost_report", "blended_cost", "unblended_cost", "list_cost", "resource_utilization_reports", "trending_reports", "change_monitoring", "best_practices", "all_access", "auth_types"]
+  }, {
+    "method_name": "add_users",
+    "param_names": ["(required)access_key", "(required)emails", "(required)account_access", "(required)user_role", "cost_report", "blended_cost", "unblended_cost", "list_cost", "resource_utilization_reports", "trending_reports", "change_monitoring", "best_practices", "all_access"]
+  }, {
+    "method_name": "copy_user",
+    "param_names": ["(required)(admin level)access_key", "(required)email_to_copy", "(required)emails", "use_account"]
+  }, {
+    "method_name": "get_account_level_tags",
+    "param_names": ["(required)(admin level)access_key", "account", "use_account"]
+  }, {
+    "method_name": "test_key",
+    "param_names": ["(required)access_key"]
+  }, {
+    "method_name": "get_improperly_tagged_resources",
+    "param_names": ["(required)access_key", "date_from", "date_to", "aws_account_id", "rule_name", "resource_type", "resource_state"]
+  }]
+}, {
+  "controller_name": "alert",
+  "api_calls": [{
+    "method_name": "add_cost_alert",
+    "param_names": ["(required)(admin level)access_key", "(required)alert_name", "emails", "sns_topics", "pagerduty_service_key", "budget", "percent_of_budget", "send_every_days", "only_send_once", "budget_period", "budget_custom_start_date", "budget_custom_end_date", "saved_filter", "account_to_filter", "use_account"]
+  }, {
+    "method_name": "delete_cost_alert",
+    "param_names": ["(required)(admin level)access_key", "(required)alert_name", "use_account"]
+  }, {
+    "method_name": "add_cost_alert_threshold",
+    "param_names": ["(required)(admin level)access_key", "(required)alert_name", "emails", "sns_topics", "pagerduty_service_key", "budget", "percent_of_budget", "send_every_days", "only_send_once", "budget_period", "budget_custom_start_date", "budget_custom_end_date", "saved_filter", "account_to_filter", "use_account"]
+  }]
+}, {
+  "controller_name": "best_practice",
+  "api_calls": [{
+    "method_name": "get_best_practices",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "all_result", "importance", "category", "use_account"]
+  }]
+}, {
+  "controller_name": "billing",
+  "api_calls": [{
+    "method_name": "get_invoice",
+    "param_names": ["(required)access_key", "(required)customer_names", "(required)start_date", "(required)end_date", "(required)format", "(required)cost_type", "regions", "currency_denomination", "currency_conversion", "show_credits", "tag_key", "tag_value", "product_names", "use_account"]
+  }, {
+    "method_name": "get_invoice_customers",
+    "param_names": ["(required)access_key", "use_account"]
+  }, {
+    "method_name": "create_customer",
+    "param_names": ["(required)access_key", "(required)name", "(required)email", "(required)address", "(required)aws_accounts"]
+  }, {
+    "method_name": "get_detailed_billing_analysis",
+    "param_names": ["(required)(admin level)access_key", "(required)saved_filter_name", "start", "end", "use_account"]
+  }, {
+    "method_name": "get_detailed_billing_with_grouping",
+    "param_names": ["(required)(admin level)access_key", "(required)saved_filter_name", "start", "end", "use_account"]
+  }, {
+    "method_name": "get_ri_upfront_cost_amortization",
+    "param_names": ["(required)access_key", "(required)start", "(required)end", "(required)service"]
+  }, {
+    "method_name": "get_detailed_billing_file",
+    "param_names": ["(required)access_key", "(required)start", "(required)end", "(required)cost_type"]
+  }]
+}, {
+  "controller_name": "change_monitoring",
+  "api_calls": [{
+    "method_name": "get_changes",
+    "param_names": ["(required)(admin level)access_key", "start", "end", "resource_id", "use_account"]
+  }]
+}, {
+  "controller_name": "cloudwatch",
+  "api_calls": [{
+    "method_name": "get_history",
+    "param_names": ["(required)(admin level)access_key", "start", "end", "service", "use_account"]
+  }]
+}, {
+  "controller_name": "cloudwatchevent",
+  "api_calls": [{
+    "method_name": "get_detail",
+    "param_names": ["(required)access_key", "start", "end", "max_results", "use_account"]
+  }]
+}, {
+  "controller_name": "help",
+  "api_calls": [{
+    "method_name": "get_all_api_endpoints",
+    "param_names": ["(required)access_key"]
+  }]
+}, {
+  "controller_name": "inventory",
+  "api_calls": [{
+    "method_name": "get_resources_rds_snapshot_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_cloudformation_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_cloudsearch_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_dynamodb_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_elasticache_clusters_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_elasticache_nodes_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_elasticbeanstalk_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_elasticmapreduce_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_glacier_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_swf_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_vpc_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_iam_users",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_iam_groups",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_iam_roles",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_iam_Policies",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_workspaces_directories",
+    "param_names": ["(required)access_key", "custom_security_group", "directory_id", "directory_name", "iam_role_id", "region", "registration_code", "state", "type", "internet_access_enabled", "workdocs_enabled", "workspace_id", "user_name", "bundle_id", "error_code", "ip_address", "security_group_id", "subnet_id", "vpc_id", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_workspaces_details",
+    "param_names": ["(required)access_key", "custom_security_group", "directory_id", "directory_name", "iam_role_id", "region", "registration_code", "state", "type", "internet_access_enabled", "workdocs_enabled", "workspace_id", "user_name", "bundle_id", "error_code", "ip_address", "security_group_id", "subnet_id", "vpc_id", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_tagged_resources",
+    "param_names": ["(required)(admin level)access_key", "date", "tag_key", "resource_type", "use_account"]
+  }, {
+    "method_name": "get_resources",
+    "param_names": ["(required)(admin level)access_key", "date", "use_account"]
+  }, {
+    "method_name": "get_resources_ec2_address_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_ec2_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_ebs_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_ami_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_ec2_security_group_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_ec2_load_balancer_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_s3_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_rds_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_rds_backup_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_rds_security_group_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_rds_parameter_group_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_rds_snapshot_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_cloudformation_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_cloudsearch_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_dynamodb_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_elasticache_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_elasticbeanstalk_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_elasticmapreduce_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_glacier_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_swf_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_vpc_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_workspaces_summary",
+    "param_names": ["(required)access_key", "date"]
+  }, {
+    "method_name": "get_resources_ec2_details",
+    "param_names": ["(required)access_key", "instance_ids", "resource_tags", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_ec2_address_details",
+    "param_names": ["(required)access_key", "instance_ids", "resource_tags", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_ebs_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_ebs_snapshots",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_ami_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_ec2_security_group_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_ec2_load_balancer_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_s3_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_rds_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_rds_backup_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_rds_security_group_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }, {
+    "method_name": "get_resources_rds_parameter_group_details",
+    "param_names": ["(required)access_key", "date", "aws_account_ids", "max_results", "use_account"]
+  }]
+}, {
+  "controller_name": "security",
+  "api_calls": [{
+    "method_name": "get_publicly_accessible_resources",
+    "param_names": ["(required)access_key", "date"]
+  }]
+}]