aws-sdk 1.4.1 → 1.5.0

data/lib/aws/elb/errors.rb

@@ -13,15 +13,11 @@
 
 module AWS
   class ELB
-
-    # @private
     module Errors
 
-      BASE_ERROR_GRAMMAR = Client::XML::BaseError
-
-      include Core::LazyErrorClasses
+      extend Core::LazyErrorClasses
 
-      def self.error_class(code)
+      def self.error_class code 
         super(code.sub(/^ElasticLoadBalancing\./, ''))
       end
 

data/lib/aws/elb/instance_collection.rb

@@ -99,8 +99,8 @@ module AWS
       #   load_balancer.instances['i-123456'].elb_health
       #   # => { :state => ..., :reason_code => ..., :description => ... }
       #
-      # @param [String,EC2::Instance] One or more instances to receive 
-      #   health information for.
+      # @param [String,EC2::Instance] instances A list of instances to
+      #   receive health information for.
       #
       # @return [Array<Hash>] Returns an array of hashes.  Each hash represents
       #   the health of a single instance.  Each hash includes the following

data/lib/aws/elb/request.rb

@@ -16,7 +16,7 @@ module AWS
 
     # @private
     class Request < Core::Http::Request
-      include Core::AuthorizeV2
+      include Core::Signature::Version2
     end
 
   end

data/lib/aws/errors.rb

@@ -12,34 +12,58 @@
 # language governing permissions and limitations under the License.
 
 module AWS
+
+  # = Errors
+  #
+  # There are two basic types of errors:
+  #
+  # * {ClientError}
+  # * {ServerError}
+  #
+  # == Client Errors
+  #
+  # Errors in the three and four hundreds are client errors ({ClientError}).
+  # A client error should not be resent without changes.  The body of the
+  # http response (the error #message) should give more information about
+  # the nature of the problem.
+  #
+  # == Server Errors
+  #
+  # A 500 level error typically indicates the service is having an issue.
+  #
+  # Requests that generate service errors are automatically retried with
+  # an exponential backoff.  If the service still fails to respond with 
+  # a 200 after 3 retries the error is raised.
+  #
   module Errors
 
-    # Base class for the two service error classes:
-    #
-    # * {ClientError}
-    # * {ServerError}
-    #
-    # When interacting with Amazon AWS services, you will sometimes 
-    # receive a non-200 level response.  These http responses are treated
-    # as errors.
-    # 
-    # == Client Errors
-    #
-    # Errors in the three and four hundreds are client errors ({ClientError}).
-    # A client error should not be resent without changes.  The body of the
-    # http response (the error #message) should give more information about
-    # the nature of the problem.
-    #
-    # == Server Errors
-    # 
-    # A 500 level error typically indicates the service is having an issue.
-    #
-    # Requests that generate service errors are automatically retried with
-    # an exponential backoff.  If the service still fails to respond with 
-    # a 200 after 3 retries the error is raised.
-    #
+    # Base class for all errors returned by the service.  
     class Base < StandardError
 
+      # @overload new(error_message)
+      #   @param [String] error_message The body of the error message
+      #
+      # @overload new(http_request, http_response, code = nil, message = nil)
+      #   @param [Http::Request] http_request
+      #   @param [Http::Response] http_response
+      #   @param [String] code (nil)
+      #   @param [String] message (nil)
+      #
+      def initialize req = nil, resp = nil, code = nil, message = nil
+        if req.is_a?(String) or req.nil?
+          super(req)
+        else
+          @http_request = req
+          @http_response = resp
+          @code = code
+          include_error_type
+          super(message || http_response.body)
+        end
+      end
+
+      # @return [String] The response code given by the service.
+      attr_reader :code
+
       # @return [Http::Request] The low level http request that caused the
       #   error to be raised.
       attr_reader :http_request
@@ -48,15 +72,23 @@ module AWS
       #   that wrapped the service error.
       attr_reader :http_response
 
-      def initialize http_request = nil, http_response = nil, message = nil
-        message ||= http_response.body if http_response
-        @http_request = http_request
-        @http_response = http_response
-        super(message)
+      protected
+
+      # Extends the error object with {ServerError} or {ClientError}.
+      # This indicates if the request should be retried (server errors)
+      # or not (client errors).
+      def include_error_type
+        if http_response.status >= 500
+          extend ServerError
+        else
+          extend ClientError
+        end
       end
 
     end
 
+    # Provides the ability to instantiate instances of {ServerError} and
+    # {ClientError}.
     # @private
     module ExceptionMixinClassMethods
       def new(*args)
@@ -86,50 +118,5 @@ module AWS
       extend ExceptionMixinClassMethods
     end
 
-    # @private
-    module ModeledError
-
-      # @return [String] The error message given by the AWS service.
-      attr_accessor :message
-
-      # @return [Integer] The HTTP status code returned by the AWS service.
-      attr_reader :code
-
-      def initialize(req = nil, resp = nil)
-        if req.kind_of?(String)
-          # makes it easier to test handling of modeled exceptions
-          super(nil, nil, req)
-          @message = req
-        elsif req and resp
-          parse_body(resp.body)
-          super(req, resp, self.message)
-          include_error_type
-        else
-          super()
-        end
-      end
-
-      def include_error_type
-        if http_response.status >= 500
-          extend ServerError
-        else
-          extend ClientError
-        end
-      end
-
-      def parse_body(body)
-        error_grammar.parse(body, :context => self)
-      end
-
-      def extract_message(body)
-        error_grammar.parse(body).message
-      end
-
-      def error_grammar
-        self.class::BASE_ERROR_GRAMMAR
-      end
-
-    end
-
   end
 end

data/lib/aws/iam.rb

@@ -334,9 +334,8 @@ module AWS
     #
     # @return [Hash]
     def account_summary
-      client.get_account_summary.summary_map.inject({}) do |h, (k,v)|
-        h[Core::Inflection.ruby_name(k).to_sym] = v
-        h
+      client.get_account_summary.data[:summary_map].inject({}) do |h,(k,v)|
+        h.merge(Core::Inflection.ruby_name(k).to_sym => v)
       end
     end
 

data/lib/aws/iam/client.rb

@@ -14,18 +14,12 @@
 module AWS
   class IAM
 
-    # @private
+    # Client class for AWS Identity and Access Management (IAM).
     class Client < Core::Client
 
-      AWS.register_autoloads(self) do
-        autoload :XML, 'xml'
-      end
-      
-      include Core::ConfiguredClientMethods
-
       API_VERSION = '2010-05-08'
-
-      REQUEST_CLASS = IAM::Request
+      
+      extend Core::Client::QueryXML
 
       # @private
       CACHEABLE_REQUESTS = Set[
@@ -38,7 +32,1181 @@ module AWS
         :get_group_policy
       ]
 
-      configure_client
+      ## client methods ##
+
+      # Calls the AddUserToGroup API operation.
+      # @method add_user_to_group(options = {})
+      #
+      # === Options:
+      #
+      # * +:group_name+ - *required* - (String) Name of the group to update.
+      # * +:user_name+ - *required* - (String) Name of the user to add.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :add_user_to_group, 'AddUserToGroup'
+
+      # Calls the ChangePassword API operation.
+      # @method change_password(options = {})
+      #
+      # === Options:
+      #
+      # * +:old_password+ - *required* - (String)
+      # * +:new_password+ - *required* - (String)
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :change_password, 'ChangePassword'
+
+      # Calls the CreateAccessKey API operation.
+      # @method create_access_key(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - (String) The user name that the new key will belong
+      #   to.
+      #
+      # === Response Structure:
+      #
+      # * +:access_key+ - (Hash)
+      #   * +:user_name+ - (String)
+      #   * +:access_key_id+ - (String)
+      #   * +:status+ - (String)
+      #   * +:secret_access_key+ - (String)
+      #   * +:create_date+ - (Time)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :create_access_key, 'CreateAccessKey'
+
+      # Calls the CreateAccountAlias API operation.
+      # @method create_account_alias(options = {})
+      #
+      # === Options:
+      #
+      # * +:account_alias+ - *required* - (String) Name of the account alias to
+      #   create.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :create_account_alias, 'CreateAccountAlias'
+
+      # Calls the CreateGroup API operation.
+      # @method create_group(options = {})
+      #
+      # === Options:
+      #
+      # * +:path+ - (String) The path to the group. For more information about
+      #   paths, see Identifiers for IAM Entities in Using AWS Identity and
+      #   Access Management. This parameter is optional. If it is not included,
+      #   it defaults to a slash (/).
+      # * +:group_name+ - *required* - (String) Name of the group to create. Do
+      #   not include the path in this value.
+      #
+      # === Response Structure:
+      #
+      # * +:group+ - (Hash)
+      #   * +:path+ - (String)
+      #   * +:group_name+ - (String)
+      #   * +:group_id+ - (String)
+      #   * +:arn+ - (String)
+      #   * +:create_date+ - (Time)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :create_group, 'CreateGroup'
+
+      # Calls the CreateLoginProfile API operation.
+      # @method create_login_profile(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - *required* - (String) Name of the user to create a
+      #   password for.
+      # * +:password+ - *required* - (String) The new password for the user
+      #   name.
+      #
+      # === Response Structure:
+      #
+      # * +:login_profile+ - (Hash)
+      #   * +:user_name+ - (String)
+      #   * +:create_date+ - (Time)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :create_login_profile, 'CreateLoginProfile'
+
+      # Calls the CreateUser API operation.
+      # @method create_user(options = {})
+      #
+      # === Options:
+      #
+      # * +:path+ - (String) The path for the user name. For more information
+      #   about paths, see Identifiers for IAM Entities in Using AWS Identity
+      #   and Access Management. This parameter is optional. If it is not
+      #   included, it defaults to a slash (/).
+      # * +:user_name+ - *required* - (String) Name of the user to create.
+      #
+      # === Response Structure:
+      #
+      # * +:user+ - (Hash)
+      #   * +:path+ - (String)
+      #   * +:user_name+ - (String)
+      #   * +:user_id+ - (String)
+      #   * +:arn+ - (String)
+      #   * +:create_date+ - (Time)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :create_user, 'CreateUser'
+
+      # Calls the CreateVirtualMFADevice API operation.
+      # @method create_virtual_mfa_device(options = {})
+      #
+      # === Options:
+      #
+      # * +:path+ - (String) The path for the virtual MFA device. For more
+      #   information about paths, see Identifiers for IAM Entities in Using
+      #   AWS Identity and Access Management. This parameter is optional. If it
+      #   is not included, it defaults to a slash (/).
+      # * +:virtual_mfa_device_name+ - *required* - (String) The name of the
+      #   virtual MFA device. Use with path to uniquely identify a virtual MFA
+      #   device.
+      #
+      # === Response Structure:
+      #
+      # * +:virtual_mfa_device+ - (Hash)
+      #   * +:serial_number+ - (String)
+      #   * +:base_32_string_seed+ - (String)
+      #   * +:qr_code_png+ - (String)
+      #   * +:user+ - (Hash)
+      #     * +:path+ - (String)
+      #     * +:user_name+ - (String)
+      #     * +:user_id+ - (String)
+      #     * +:arn+ - (String)
+      #     * +:create_date+ - (Time)
+      #   * +:enable_date+ - (Time)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :create_virtual_mfa_device, 'CreateVirtualMFADevice'
+
+      # Calls the DeactivateMFADevice API operation.
+      # @method deactivate_mfa_device(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - *required* - (String) Name of the user whose MFA
+      #   device you want to deactivate.
+      # * +:serial_number+ - *required* - (String) The serial number that
+      #   uniquely identifies the MFA device. For virtual MFA devices, the
+      #   serial number is the device ARN.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :deactivate_mfa_device, 'DeactivateMFADevice'
+
+      # Calls the DeleteAccessKey API operation.
+      # @method delete_access_key(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - (String) Name of the user whose key you want to
+      #   delete.
+      # * +:access_key_id+ - *required* - (String) The Access Key ID for the
+      #   Access Key ID and Secret Access Key you want to delete.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :delete_access_key, 'DeleteAccessKey'
+
+      # Calls the DeleteAccountAlias API operation.
+      # @method delete_account_alias(options = {})
+      #
+      # === Options:
+      #
+      # * +:account_alias+ - *required* - (String) Name of the account alias to
+      #   delete.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :delete_account_alias, 'DeleteAccountAlias'
+
+      # Calls the DeleteAccountPasswordPolicy API operation.
+      # @method delete_account_password_policy(options = {})
+      #
+      # === Options:
+      #
+      # This method accepts no options.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :delete_account_password_policy, 'DeleteAccountPasswordPolicy'
+
+      # Calls the DeleteGroup API operation.
+      # @method delete_group(options = {})
+      #
+      # === Options:
+      #
+      # * +:group_name+ - *required* - (String) Name of the group to delete.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :delete_group, 'DeleteGroup'
+
+      # Calls the DeleteGroupPolicy API operation.
+      # @method delete_group_policy(options = {})
+      #
+      # === Options:
+      #
+      # * +:group_name+ - *required* - (String) Name of the group the policy is
+      #   associated with.
+      # * +:policy_name+ - *required* - (String) Name of the policy document to
+      #   delete.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :delete_group_policy, 'DeleteGroupPolicy'
+
+      # Calls the DeleteLoginProfile API operation.
+      # @method delete_login_profile(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - *required* - (String) Name of the user whose password
+      #   you want to delete.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :delete_login_profile, 'DeleteLoginProfile'
+
+      # Calls the DeleteServerCertificate API operation.
+      # @method delete_server_certificate(options = {})
+      #
+      # === Options:
+      #
+      # * +:server_certificate_name+ - *required* - (String) The name of the
+      #   server certificate you want to delete.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :delete_server_certificate, 'DeleteServerCertificate'
+
+      # Calls the DeleteSigningCertificate API operation.
+      # @method delete_signing_certificate(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - (String) Name of the user the signing certificate
+      #   belongs to.
+      # * +:certificate_id+ - *required* - (String) ID of the signing
+      #   certificate to delete.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :delete_signing_certificate, 'DeleteSigningCertificate'
+
+      # Calls the DeleteUser API operation.
+      # @method delete_user(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - *required* - (String) Name of the user to delete.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :delete_user, 'DeleteUser'
+
+      # Calls the DeleteUserPolicy API operation.
+      # @method delete_user_policy(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - *required* - (String) Name of the user the policy is
+      #   associated with.
+      # * +:policy_name+ - *required* - (String) Name of the policy document to
+      #   delete.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :delete_user_policy, 'DeleteUserPolicy'
+
+      # Calls the DeleteVirtualMFADevice API operation.
+      # @method delete_virtual_mfa_device(options = {})
+      #
+      # === Options:
+      #
+      # * +:serial_number+ - *required* - (String) The serial number that
+      #   uniquely identifies the MFA device. For virtual MFA devices, the
+      #   serial number is the same as the ARN.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :delete_virtual_mfa_device, 'DeleteVirtualMFADevice'
+
+      # Calls the EnableMFADevice API operation.
+      # @method enable_mfa_device(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - *required* - (String) Name of the user for whom you
+      #   want to enable the MFA device.
+      # * +:serial_number+ - *required* - (String) The serial number that
+      #   uniquely identifies the MFA device. For virtual MFA devices, the
+      #   serial number is the device ARN.
+      # * +:authentication_code_1+ - *required* - (String) An authentication
+      #   code emitted by the device.
+      # * +:authentication_code_2+ - *required* - (String) A subsequent
+      #   authentication code emitted by the device.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :enable_mfa_device, 'EnableMFADevice'
+
+      # Calls the GetAccountPasswordPolicy API operation.
+      # @method get_account_password_policy(options = {})
+      #
+      # === Options:
+      #
+      # This method accepts no options.
+      #
+      # === Response Structure:
+      #
+      # * +:password_policy+ - (Hash)
+      #   * +:minimum_password_length+ - (Integer)
+      #   * +:require_symbols+ - (Boolean)
+      #   * +:require_numbers+ - (Boolean)
+      #   * +:require_uppercase_characters+ - (Boolean)
+      #   * +:require_lowercase_characters+ - (Boolean)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :get_account_password_policy, 'GetAccountPasswordPolicy'
+
+      # Calls the GetAccountSummary API operation.
+      # @method get_account_summary(options = {})
+      #
+      # === Options:
+      #
+      # This method accepts no options.
+      #
+      # === Response Structure:
+      #
+      # * +:summary_map+ - (Hash<String,Integer>)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :get_account_summary, 'GetAccountSummary'
+
+      # Calls the GetGroup API operation.
+      # @method get_group(options = {})
+      #
+      # === Options:
+      #
+      # * +:group_name+ - *required* - (String) Name of the group.
+      # * +:marker+ - (String) Use this only when paginating results, and only
+      #   in a subsequent request after you've received a response where the
+      #   results are truncated. Set it to the value of the Marker element in
+      #   the response you just received.
+      # * +:max_items+ - (Integer) Use this only when paginating results to
+      #   indicate the maximum number of user names you want in the response.
+      #   If there are additional user names beyond the maximum you specify,
+      #   the IsTruncated response element is +true+ .
+      #
+      # === Response Structure:
+      #
+      # * +:group+ - (Hash)
+      #   * +:path+ - (String)
+      #   * +:group_name+ - (String)
+      #   * +:group_id+ - (String)
+      #   * +:arn+ - (String)
+      #   * +:create_date+ - (Time)
+      # * +:users+ - (Array<Hash>)
+      #   * +:path+ - (String)
+      #   * +:user_name+ - (String)
+      #   * +:user_id+ - (String)
+      #   * +:arn+ - (String)
+      #   * +:create_date+ - (Time)
+      # * +:is_truncated+ - (Boolean)
+      # * +:marker+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :get_group, 'GetGroup'
+
+      # Calls the GetGroupPolicy API operation.
+      # @method get_group_policy(options = {})
+      #
+      # === Options:
+      #
+      # * +:group_name+ - *required* - (String) Name of the group the policy is
+      #   associated with.
+      # * +:policy_name+ - *required* - (String) Name of the policy document to
+      #   get.
+      #
+      # === Response Structure:
+      #
+      # * +:group_name+ - (String)
+      # * +:policy_name+ - (String)
+      # * +:policy_document+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :get_group_policy, 'GetGroupPolicy'
+
+      # Calls the GetLoginProfile API operation.
+      # @method get_login_profile(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - *required* - (String) Name of the user whose password
+      #   you want to retrieve.
+      #
+      # === Response Structure:
+      #
+      # * +:login_profile+ - (Hash)
+      #   * +:user_name+ - (String)
+      #   * +:create_date+ - (Time)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :get_login_profile, 'GetLoginProfile'
+
+      # Calls the GetServerCertificate API operation.
+      # @method get_server_certificate(options = {})
+      #
+      # === Options:
+      #
+      # * +:server_certificate_name+ - *required* - (String) The name of the
+      #   server certificate you want to retrieve information about.
+      #
+      # === Response Structure:
+      #
+      # * +:server_certificate+ - (Hash)
+      #   * +:server_certificate_metadata+ - (Hash)
+      #     * +:path+ - (String)
+      #     * +:server_certificate_name+ - (String)
+      #     * +:server_certificate_id+ - (String)
+      #     * +:arn+ - (String)
+      #     * +:upload_date+ - (Time)
+      #   * +:certificate_body+ - (String)
+      #   * +:certificate_chain+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :get_server_certificate, 'GetServerCertificate'
+
+      # Calls the GetUser API operation.
+      # @method get_user(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - (String) Name of the user to get information about.
+      #   This parameter is optional. If it is not included, it defaults to the
+      #   user making the request.
+      #
+      # === Response Structure:
+      #
+      # * +:user+ - (Hash)
+      #   * +:path+ - (String)
+      #   * +:user_name+ - (String)
+      #   * +:user_id+ - (String)
+      #   * +:arn+ - (String)
+      #   * +:create_date+ - (Time)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :get_user, 'GetUser'
+
+      # Calls the GetUserPolicy API operation.
+      # @method get_user_policy(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - *required* - (String) Name of the user who the policy
+      #   is associated with.
+      # * +:policy_name+ - *required* - (String) Name of the policy document to
+      #   get.
+      #
+      # === Response Structure:
+      #
+      # * +:user_name+ - (String)
+      # * +:policy_name+ - (String)
+      # * +:policy_document+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :get_user_policy, 'GetUserPolicy'
+
+      # Calls the ListAccessKeys API operation.
+      # @method list_access_keys(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - (String) Name of the user.
+      # * +:marker+ - (String) Use this parameter only when paginating results,
+      #   and only in a subsequent request after you've received a response
+      #   where the results are truncated. Set it to the value of the Marker
+      #   element in the response you just received.
+      # * +:max_items+ - (Integer) Use this parameter only when paginating
+      #   results to indicate the maximum number of keys you want in the
+      #   response. If there are additional keys beyond the maximum you
+      #   specify, the IsTruncated response element is +true+ .
+      #
+      # === Response Structure:
+      #
+      # * +:access_key_metadata+ - (Array<Hash>)
+      #   * +:user_name+ - (String)
+      #   * +:access_key_id+ - (String)
+      #   * +:status+ - (String)
+      #   * +:create_date+ - (Time)
+      # * +:is_truncated+ - (Boolean)
+      # * +:marker+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :list_access_keys, 'ListAccessKeys'
+
+      # Calls the ListAccountAliases API operation.
+      # @method list_account_aliases(options = {})
+      #
+      # === Options:
+      #
+      # * +:marker+ - (String) Use this only when paginating results, and only
+      #   in a subsequent request after you've received a response where the
+      #   results are truncated. Set it to the value of the Marker element in
+      #   the response you just received.
+      # * +:max_items+ - (Integer) Use this only when paginating results to
+      #   indicate the maximum number of account aliases you want in the
+      #   response. If there are additional account aliases beyond the maximum
+      #   you specify, the IsTruncated response element is +true+ .
+      #
+      # === Response Structure:
+      #
+      # * +:account_aliases+ - (Array<String>)
+      # * +:is_truncated+ - (Boolean)
+      # * +:marker+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :list_account_aliases, 'ListAccountAliases'
+
+      # Calls the ListGroupPolicies API operation.
+      # @method list_group_policies(options = {})
+      #
+      # === Options:
+      #
+      # * +:group_name+ - *required* - (String) The name of the group to list
+      #   policies for.
+      # * +:marker+ - (String) Use this only when paginating results, and only
+      #   in a subsequent request after you've received a response where the
+      #   results are truncated. Set it to the value of the Marker element in
+      #   the response you just received.
+      # * +:max_items+ - (Integer) Use this only when paginating results to
+      #   indicate the maximum number of policy names you want in the response.
+      #   If there are additional policy names beyond the maximum you specify,
+      #   the IsTruncated response element is +true+ .
+      #
+      # === Response Structure:
+      #
+      # * +:policy_names+ - (Array<String>)
+      # * +:is_truncated+ - (Boolean)
+      # * +:marker+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :list_group_policies, 'ListGroupPolicies'
+
+      # Calls the ListGroups API operation.
+      # @method list_groups(options = {})
+      #
+      # === Options:
+      #
+      # * +:path_prefix+ - (String) The path prefix for filtering the results.
+      #   For example: /division_abc/subdivision_xyz/, which would get all
+      #   groups whose path starts with /division_abc/subdivision_xyz/. This
+      #   parameter is optional. If it is not included, it defaults to a slash
+      #   (/), listing all groups.
+      # * +:marker+ - (String) Use this only when paginating results, and only
+      #   in a subsequent request after you've received a response where the
+      #   results are truncated. Set it to the value of the Marker element in
+      #   the response you just received.
+      # * +:max_items+ - (Integer) Use this only when paginating results to
+      #   indicate the maximum number of groups you want in the response. If
+      #   there are additional groups beyond the maximum you specify, the
+      #   IsTruncated response element is +true+ .
+      #
+      # === Response Structure:
+      #
+      # * +:groups+ - (Array<Hash>)
+      #   * +:path+ - (String)
+      #   * +:group_name+ - (String)
+      #   * +:group_id+ - (String)
+      #   * +:arn+ - (String)
+      #   * +:create_date+ - (Time)
+      # * +:is_truncated+ - (Boolean)
+      # * +:marker+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :list_groups, 'ListGroups'
+
+      # Calls the ListGroupsForUser API operation.
+      # @method list_groups_for_user(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - *required* - (String) The name of the user to list
+      #   groups for.
+      # * +:marker+ - (String) Use this only when paginating results, and only
+      #   in a subsequent request after you've received a response where the
+      #   results are truncated. Set it to the value of the Marker element in
+      #   the response you just received.
+      # * +:max_items+ - (Integer) Use this only when paginating results to
+      #   indicate the maximum number of groups you want in the response. If
+      #   there are additional groups beyond the maximum you specify, the
+      #   IsTruncated response element is +true+ .
+      #
+      # === Response Structure:
+      #
+      # * +:groups+ - (Array<Hash>)
+      #   * +:path+ - (String)
+      #   * +:group_name+ - (String)
+      #   * +:group_id+ - (String)
+      #   * +:arn+ - (String)
+      #   * +:create_date+ - (Time)
+      # * +:is_truncated+ - (Boolean)
+      # * +:marker+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :list_groups_for_user, 'ListGroupsForUser'
+
+      # Calls the ListMFADevices API operation.
+      # @method list_mfa_devices(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - (String) Name of the user whose MFA devices you want
+      #   to list.
+      # * +:marker+ - (String) Use this only when paginating results, and only
+      #   in a subsequent request after you've received a response where the
+      #   results are truncated. Set it to the value of the Marker element in
+      #   the response you just received.
+      # * +:max_items+ - (Integer) Use this only when paginating results to
+      #   indicate the maximum number of MFA devices you want in the response.
+      #   If there are additional MFA devices beyond the maximum you specify,
+      #   the IsTruncated response element is +true+ .
+      #
+      # === Response Structure:
+      #
+      # * +:mfa_devices+ - (Array<Hash>)
+      #   * +:user_name+ - (String)
+      #   * +:serial_number+ - (String)
+      #   * +:enable_date+ - (Time)
+      # * +:is_truncated+ - (Boolean)
+      # * +:marker+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :list_mfa_devices, 'ListMFADevices'
+
+      # Calls the ListServerCertificates API operation.
+      # @method list_server_certificates(options = {})
+      #
+      # === Options:
+      #
+      # * +:path_prefix+ - (String) The path prefix for filtering the results.
+      #   For example: /company/servercerts would get all server certificates
+      #   for which the path starts with /company/servercerts. This parameter
+      #   is optional. If it is not included, it defaults to a slash (/),
+      #   listing all server certificates.
+      # * +:marker+ - (String) Use this only when paginating results, and only
+      #   in a subsequent request after you've received a response where the
+      #   results are truncated. Set it to the value of the Marker element in
+      #   the response you just received.
+      # * +:max_items+ - (Integer) Use this only when paginating results to
+      #   indicate the maximum number of server certificates you want in the
+      #   response. If there are additional server certificates beyond the
+      #   maximum you specify, the IsTruncated response element will be set to
+      #   +true+ .
+      #
+      # === Response Structure:
+      #
+      # * +:server_certificate_metadata_list+ - (Array<Hash>)
+      #   * +:path+ - (String)
+      #   * +:server_certificate_name+ - (String)
+      #   * +:server_certificate_id+ - (String)
+      #   * +:arn+ - (String)
+      #   * +:upload_date+ - (Time)
+      # * +:is_truncated+ - (Boolean)
+      # * +:marker+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :list_server_certificates, 'ListServerCertificates'
+
+      # Calls the ListSigningCertificates API operation.
+      # @method list_signing_certificates(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - (String) The name of the user.
+      # * +:marker+ - (String) Use this only when paginating results, and only
+      #   in a subsequent request after you've received a response where the
+      #   results are truncated. Set it to the value of the Marker element in
+      #   the response you just received.
+      # * +:max_items+ - (Integer) Use this only when paginating results to
+      #   indicate the maximum number of certificate IDs you want in the
+      #   response. If there are additional certificate IDs beyond the maximum
+      #   you specify, the IsTruncated response element is +true+ .
+      #
+      # === Response Structure:
+      #
+      # * +:certificates+ - (Array<Hash>)
+      #   * +:user_name+ - (String)
+      #   * +:certificate_id+ - (String)
+      #   * +:certificate_body+ - (String)
+      #   * +:status+ - (String)
+      #   * +:upload_date+ - (Time)
+      # * +:is_truncated+ - (Boolean)
+      # * +:marker+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :list_signing_certificates, 'ListSigningCertificates'
+
+      # Calls the ListUserPolicies API operation.
+      # @method list_user_policies(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - *required* - (String) The name of the user to list
+      #   policies for.
+      # * +:marker+ - (String) Use this only when paginating results, and only
+      #   in a subsequent request after you've received a response where the
+      #   results are truncated. Set it to the value of the Marker element in
+      #   the response you just received.
+      # * +:max_items+ - (Integer) Use this only when paginating results to
+      #   indicate the maximum number of policy names you want in the response.
+      #   If there are additional policy names beyond the maximum you specify,
+      #   the IsTruncated response element is +true+ .
+      #
+      # === Response Structure:
+      #
+      # * +:policy_names+ - (Array<String>)
+      # * +:is_truncated+ - (Boolean)
+      # * +:marker+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :list_user_policies, 'ListUserPolicies'
+
+      # Calls the ListUsers API operation.
+      # @method list_users(options = {})
+      #
+      # === Options:
+      #
+      # * +:path_prefix+ - (String) The path prefix for filtering the results.
+      #   For example: /division_abc/subdivision_xyz/, which would get all user
+      #   names whose path starts with /division_abc/subdivision_xyz/. This
+      #   parameter is optional. If it is not included, it defaults to a slash
+      #   (/), listing all user names.
+      # * +:marker+ - (String) Use this parameter only when paginating results,
+      #   and only in a subsequent request after you've received a response
+      #   where the results are truncated. Set it to the value of the Marker
+      #   element in the response you just received.
+      # * +:max_items+ - (Integer) Use this parameter only when paginating
+      #   results to indicate the maximum number of user names you want in the
+      #   response. If there are additional user names beyond the maximum you
+      #   specify, the IsTruncated response element is +true+ .
+      #
+      # === Response Structure:
+      #
+      # * +:users+ - (Array<Hash>)
+      #   * +:path+ - (String)
+      #   * +:user_name+ - (String)
+      #   * +:user_id+ - (String)
+      #   * +:arn+ - (String)
+      #   * +:create_date+ - (Time)
+      # * +:is_truncated+ - (Boolean)
+      # * +:marker+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :list_users, 'ListUsers'
+
+      # Calls the ListVirtualMFADevices API operation.
+      # @method list_virtual_mfa_devices(options = {})
+      #
+      # === Options:
+      #
+      # * +:assignment_status+ - (String) The status (unassigned or assigned)
+      #   of the devices to list. If you do not specify an AssignmentStatus,
+      #   the action defaults to Any which lists both assigned and unassigned
+      #   virtual MFA devices.
+      # * +:marker+ - (String) Use this parameter only when paginating results,
+      #   and only in a subsequent request after you've received a response
+      #   where the results are truncated. Set it to the value of the Marker
+      #   element in the response you just received.
+      # * +:max_items+ - (Integer) Use this parameter only when paginating
+      #   results to indicate the maximum number of user names you want in the
+      #   response. If there are additional user names beyond the maximum you
+      #   specify, the IsTruncated response element is +true+ .
+      #
+      # === Response Structure:
+      #
+      # * +:virtual_mfa_devices+ - (Array<Hash>)
+      #   * +:serial_number+ - (String)
+      #   * +:base_32_string_seed+ - (String)
+      #   * +:qr_code_png+ - (String)
+      #   * +:user+ - (Hash)
+      #     * +:path+ - (String)
+      #     * +:user_name+ - (String)
+      #     * +:user_id+ - (String)
+      #     * +:arn+ - (String)
+      #     * +:create_date+ - (Time)
+      #   * +:enable_date+ - (Time)
+      # * +:is_truncated+ - (Boolean)
+      # * +:marker+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :list_virtual_mfa_devices, 'ListVirtualMFADevices'
+
+      # Calls the PutGroupPolicy API operation.
+      # @method put_group_policy(options = {})
+      #
+      # === Options:
+      #
+      # * +:group_name+ - *required* - (String) Name of the group to associate
+      #   the policy with.
+      # * +:policy_name+ - *required* - (String) Name of the policy document.
+      # * +:policy_document+ - *required* - (String) The policy document.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :put_group_policy, 'PutGroupPolicy'
+
+      # Calls the PutUserPolicy API operation.
+      # @method put_user_policy(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - *required* - (String) Name of the user to associate
+      #   the policy with.
+      # * +:policy_name+ - *required* - (String) Name of the policy document.
+      # * +:policy_document+ - *required* - (String) The policy document.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :put_user_policy, 'PutUserPolicy'
+
+      # Calls the RemoveUserFromGroup API operation.
+      # @method remove_user_from_group(options = {})
+      #
+      # === Options:
+      #
+      # * +:group_name+ - *required* - (String) Name of the group to update.
+      # * +:user_name+ - *required* - (String) Name of the user to remove.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :remove_user_from_group, 'RemoveUserFromGroup'
+
+      # Calls the ResyncMFADevice API operation.
+      # @method resync_mfa_device(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - *required* - (String) Name of the user whose MFA
+      #   device you want to resynchronize.
+      # * +:serial_number+ - *required* - (String) Serial number that uniquely
+      #   identifies the MFA device.
+      # * +:authentication_code_1+ - *required* - (String) An authentication
+      #   code emitted by the device.
+      # * +:authentication_code_2+ - *required* - (String) A subsequent
+      #   authentication code emitted by the device.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :resync_mfa_device, 'ResyncMFADevice'
+
+      # Calls the UpdateAccessKey API operation.
+      # @method update_access_key(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - (String) Name of the user whose key you want to
+      #   update.
+      # * +:access_key_id+ - *required* - (String) The Access Key ID of the
+      #   Secret Access Key you want to update.
+      # * +:status+ - *required* - (String) The status you want to assign to
+      #   the Secret Access Key. Active means the key can be used for API calls
+      #   to AWS, while Inactive means the key cannot be used.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :update_access_key, 'UpdateAccessKey'
+
+      # Calls the UpdateAccountPasswordPolicy API operation.
+      # @method update_account_password_policy(options = {})
+      #
+      # === Options:
+      #
+      # * +:minimum_password_length+ - (Integer)
+      # * +:require_symbols+ - (Boolean)
+      # * +:require_numbers+ - (Boolean)
+      # * +:require_uppercase_characters+ - (Boolean)
+      # * +:require_lowercase_characters+ - (Boolean)
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :update_account_password_policy, 'UpdateAccountPasswordPolicy'
+
+      # Calls the UpdateGroup API operation.
+      # @method update_group(options = {})
+      #
+      # === Options:
+      #
+      # * +:group_name+ - *required* - (String) Name of the group to update. If
+      #   you're changing the name of the group, this is the original name.
+      # * +:new_path+ - (String) New path for the group. Only include this if
+      #   changing the group's path.
+      # * +:new_group_name+ - (String) New name for the group. Only include
+      #   this if changing the group's name.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :update_group, 'UpdateGroup'
+
+      # Calls the UpdateLoginProfile API operation.
+      # @method update_login_profile(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - *required* - (String) Name of the user whose password
+      #   you want to update.
+      # * +:password+ - (String) The new password for the user name.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :update_login_profile, 'UpdateLoginProfile'
+
+      # Calls the UpdateServerCertificate API operation.
+      # @method update_server_certificate(options = {})
+      #
+      # === Options:
+      #
+      # * +:server_certificate_name+ - *required* - (String) The name of the
+      #   server certificate that you want to update.
+      # * +:new_path+ - (String) The new path for the server certificate.
+      #   Include this only if you are updating the server certificate's path.
+      # * +:new_server_certificate_name+ - (String) The new name for the server
+      #   certificate. Include this only if you are updating the server
+      #   certificate's name.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :update_server_certificate, 'UpdateServerCertificate'
+
+      # Calls the UpdateSigningCertificate API operation.
+      # @method update_signing_certificate(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - (String) Name of the user the signing certificate
+      #   belongs to.
+      # * +:certificate_id+ - *required* - (String) The ID of the signing
+      #   certificate you want to update.
+      # * +:status+ - *required* - (String) The status you want to assign to
+      #   the certificate. Active means the certificate can be used for API
+      #   calls to AWS, while Inactive means the certificate cannot be used.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :update_signing_certificate, 'UpdateSigningCertificate'
+
+      # Calls the UpdateUser API operation.
+      # @method update_user(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - *required* - (String) Name of the user to update. If
+      #   you're changing the name of the user, this is the original user name.
+      # * +:new_path+ - (String) New path for the user. Include this parameter
+      #   only if you're changing the user's path.
+      # * +:new_user_name+ - (String) New name for the user. Include this
+      #   parameter only if you're changing the user's name.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :update_user, 'UpdateUser'
+
+      # Calls the UploadServerCertificate API operation.
+      # @method upload_server_certificate(options = {})
+      #
+      # === Options:
+      #
+      # * +:path+ - (String) The path for the server certificate. For more
+      #   information about paths, see Identifiers for IAM Entities in Using
+      #   AWS Identity and Access Management. This parameter is optional. If it
+      #   is not included, it defaults to a slash (/).
+      # * +:server_certificate_name+ - *required* - (String) The name for the
+      #   server certificate. Do not include the path in this value.
+      # * +:certificate_body+ - *required* - (String) The contents of the
+      #   public key certificate in PEM-encoded format.
+      # * +:private_key+ - *required* - (String) The contents of the private
+      #   key in PEM-encoded format.
+      # * +:certificate_chain+ - (String) The contents of the certificate
+      #   chain. This is typically a concatenation of the PEM-encoded public
+      #   key certificates of the chain.
+      #
+      # === Response Structure:
+      #
+      # * +:server_certificate_metadata+ - (Hash)
+      #   * +:path+ - (String)
+      #   * +:server_certificate_name+ - (String)
+      #   * +:server_certificate_id+ - (String)
+      #   * +:arn+ - (String)
+      #   * +:upload_date+ - (Time)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :upload_server_certificate, 'UploadServerCertificate'
+
+      # Calls the UploadSigningCertificate API operation.
+      # @method upload_signing_certificate(options = {})
+      #
+      # === Options:
+      #
+      # * +:user_name+ - (String) Name of the user the signing certificate is
+      #   for.
+      # * +:certificate_body+ - *required* - (String) The contents of the
+      #   signing certificate.
+      #
+      # === Response Structure:
+      #
+      # * +:certificate+ - (Hash)
+      #   * +:user_name+ - (String)
+      #   * +:certificate_id+ - (String)
+      #   * +:certificate_body+ - (String)
+      #   * +:status+ - (String)
+      #   * +:upload_date+ - (Time)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :upload_signing_certificate, 'UploadSigningCertificate'
+
+      ## end client methods ##
 
     end
   end