aws-sdk 1.8.5 → 1.9.0

data/lib/aws/core/resource.rb

@@ -82,11 +82,11 @@ module AWS
       # Overide this method is subclasses of Resource.  This method should
       # return an array of identifying key/value pairs.
       #
-      #   # @private
-      #   protected
-      #   def resource_identifiers
-      #     [[:user_name, name]]
-      #   end
+      #     # @private
+      #     protected
+      #     def resource_identifiers
+      #       [[:user_name, name]]
+      #     end
       #
       # @private
       protected

data/lib/aws/core/response.rb

@@ -14,7 +14,7 @@
 module AWS
   module Core
 
-    # = Response
+    # # Response
     #
     # Each Service has a Client class.  There is one method per service
     # operation defined on the client.  These methods all return a {Response}
@@ -23,23 +23,23 @@ module AWS
     # In addition to the response data, these responses provide metadata
     # about the HTTP request made and the HTTP response received.
     #
-    # == Response Data
+    # ## Response Data
     #
     # You can access the response data for a client request using the {#data}
     # method or the {#[]} method.  Response data is a hash and {#[]} is
     # a shortcut for accessing this hash.
     #
-    #   # make a request to describe one instance
-    #   ec2 = AWS::EC2.new
-    #   response = ec2.client.describe_instances(:instance_ids => ['i-12345678'])
+    #     # make a request to describe one instance
+    #     ec2 = AWS::EC2.new
+    #     response = ec2.client.describe_instances(:instance_ids => ['i-12345678'])
     #
-    #   # find the instance in the response data (2 ways to get the data)
-    #   instance = response[:reservation_set].first[:instance_set].first
-    #   instance = response.data[:reservation_set].first[:instance_set].first
+    #     # find the instance in the response data (2 ways to get the data)
+    #     instance = response[:reservation_set].first[:instance_set].first
+    #     instance = response.data[:reservation_set].first[:instance_set].first
     #
-    #   instance[:status] #=> 'running'
+    #     instance[:status] #=> 'running'
     #
-    # == Response Metadata
+    # ## Response Metadata
     #
     # In addition to the response data, there is additional information
     # available with the response, including:
@@ -51,10 +51,10 @@ module AWS
     #
     # Given the example and response object from above:
     #
-    #   response.request_type #=> :describe_instances
-    #   response.request_options #=> { :instance_ids => ['i-12345678'] }
-    #   response.http_request #=> #<AWS::Core::Http::Request>
-    #   response.http_response #=> #<AWS::Core::Http::Response>
+    #     response.request_type #=> :describe_instances
+    #     response.request_options #=> { :instance_ids => ['i-12345678'] }
+    #     response.http_request #=> #<AWS::Core::Http::Request>
+    #     response.http_response #=> #<AWS::Core::Http::Response>
     #
     class Response
 
@@ -63,6 +63,9 @@ module AWS
       # @return [Hash] Returns the response data as a hash.
       attr_accessor :data
 
+      # @private
+      attr_accessor :config
+
       # @return [Symbol] The name of the client request method that
       #   returned this response.
       attr_accessor :request_type
@@ -109,7 +112,7 @@ module AWS
       end
 
       # Provides access to the response data.  This is a short-cut
-      # for calling +response.data[key]+.
+      # for calling `response.data[key]`.
       #
       # @param [Symbol,String] key
       # @return [Hash,nil]
@@ -122,7 +125,7 @@ module AWS
         error.nil?
       end
 
-      # @return [Boolean] Returns +true+ if the http request failed due to
+      # @return [Boolean] Returns `true` if the http request failed due to
       #   a networking issue.
       def network_error?
         http_response.network_error?
@@ -154,7 +157,7 @@ module AWS
         @http_request.body_stream.rewind if @http_request.body_stream
       end
 
-      # @return [Boolean] Returns +false+ if it is not safe to retry a
+      # @return [Boolean] Returns `false` if it is not safe to retry a
       #   request.  This happens when the http request body is an IO
       #   object that can not be rewound and re-streamed.
       def safe_to_retry?

data/lib/aws/core/rest_request_builder.rb

@@ -42,10 +42,10 @@ module AWS
 
       # Populates a Http::Request with the following:
       #
-      # * HTTP method
-      # * URI
-      # * headers
-      # * body
+      #   * HTTP method
+      #   * URI
+      #   * headers
+      #   * body
       #
       # @param [Http::Request] request
       #

data/lib/aws/core/service_interface.rb

@@ -27,14 +27,36 @@ module AWS
           base::Errors.module_eval { include Errors }
         end
 
+        AWS::Core::MetaUtils.extend(base) do
+
+          # @private
+          def endpoint_prefix prefix = nil, options = {}
+            if prefix
+              @endpoint_prefix = prefix
+              @global_endpoint = !!options[:global]
+            end
+            @endpoint_prefix
+          end
+
+          # @private
+          def global_endpoint?
+            @global_endpoint
+          end
+
+          def regions
+            RegionCollection.new(:service => self)
+          end
+
+        end
+
       end
 
       # Returns a new interface object for this service.  You can override
       # any of the global configuration parameters by passing them in as
       # hash options.  They are merged with AWS.config or merged
-      # with the provided +:config+ object.
+      # with the provided `:config` object.
       #
-      #   @ec2 = AWS::EC2.new(:max_retries => 2)
+      #     @ec2 = AWS::EC2.new(:max_retries => 2)
       #
       # @see AWS::Cofiguration
       #

data/lib/aws/core/signature/version_3.rb

@@ -28,7 +28,7 @@ module AWS
           headers["x-amz-date"] ||= (headers["date"] ||= Time.now.httpdate)
           headers["host"] ||= host
 
-          headers["x-amz-security-token"] = credentials.session_token if 
+          headers["x-amz-security-token"] = credentials.session_token if
             credentials.session_token
 
           # compute the authorization
@@ -43,7 +43,7 @@ module AWS
         protected
 
         def signature credentials
-          Signer.sign(credentials.secret_access_key, string_to_sign)  
+          Signer.sign(credentials.secret_access_key, string_to_sign)
         end
 
         def string_to_sign

data/lib/aws/core/uri_escape.rb

@@ -28,7 +28,7 @@ module AWS
       module_function :escape
 
       # @param [String] value
-      # @return [String] Returns a URI-escaped path without escaping the 
+      # @return [String] Returns a URI-escaped path without escaping the
       #   separators.
       def escape_path value
         escaped = ""

data/lib/aws/core/xml/frame_stack.rb

@@ -36,7 +36,7 @@ module AWS
           sax_parse(xml)
           @frame.value
         end
-    
+
         # Increase the frame stack level by one.
         # @param [String] element_name The name of the xml opening tag.
         # @param [Hash] attributes A hash of xml element attributes.

data/lib/aws/core/xml/grammar.rb

@@ -129,7 +129,7 @@ module AWS
           allow_methods = %w(
             rename attribute_name boolean integer long float list force string
             ignore collect_values symbol_value timestamp map_entry map blob
-            position
+            enum position
           )
           unless allow_methods.include?(method.to_s)
             raise "#{method} cannot be used in configuration"
@@ -151,9 +151,7 @@ module AWS
           Inflection.ruby_name(value.to_s).to_sym
         end
 
-        ##
-        ## customization methods
-        ##
+        # customization methods
 
         def element element_name, &block
 
@@ -286,6 +284,7 @@ module AWS
         end
         alias_method :==, :eql?
 
+        def enum *args; end
         def position *args; end
         def http_trait *args; end
         alias_method :http_header, :http_trait

data/lib/aws/core/xml/sax_handlers/libxml.rb

@@ -18,7 +18,7 @@ module AWS
     module XML
       module SaxHandlers
         class LibXML
-          
+
           include FrameStack
           include ::LibXML::XML::SaxParser::Callbacks
 
@@ -29,7 +29,7 @@ module AWS
           end
 
           def on_start_element_ns element_name, attributes, *ignore
-            start_element(element_name, attributes) 
+            start_element(element_name, attributes)
           end
 
           def on_end_element_ns *ignore

data/lib/aws/core/xml/sax_handlers/nokogiri.rb

@@ -18,7 +18,7 @@ module AWS
     module XML
       module SaxHandlers
         class Nokogiri
-          
+
           include FrameStack
 
           def sax_parse xml
@@ -32,11 +32,11 @@ module AWS
 
           def start_element_namespace element_name, attributes = [], *ignore
 
-            attributes = attributes.map.inject({}) do |hash,attr| 
+            attributes = attributes.map.inject({}) do |hash,attr|
               hash.merge(attr.localname => attr.value)
             end
 
-            start_element(element_name, attributes) 
+            start_element(element_name, attributes)
 
           end
 

data/lib/aws/core/xml/sax_handlers/rexml.rb

@@ -19,23 +19,23 @@ module AWS
     module XML
       module SaxHandlers
         class REXML
-  
+
           include FrameStack
           include ::REXML::StreamListener
-  
+
           def sax_parse xml
             source = ::REXML::Source.new(xml)
             ::REXML::Parsers::StreamParser.new(source, self).parse
           end
-  
+
           def tag_start name, attrs
             start_element(name, attrs)
           end
-    
+
           def tag_end name
             end_element
           end
-  
+
         end
       end
     end

data/lib/aws/core/xml/stub.rb

@@ -37,9 +37,9 @@ module AWS
         attr_reader :rules
 
         # Returns a hash with stubbed values as if it had parsed
-        # an empty xml document.  
-        # @return [Hash] 
-        def simulate 
+        # an empty xml document.
+        # @return [Hash]
+        def simulate
           if rules[:children]
             data = stub_data_for(rules)
             apply_empty_indexes(rules, data)
@@ -50,9 +50,9 @@ module AWS
         end
 
         # Returns a hash with stubbed values as if it had parsed
-        # an empty xml document.  
+        # an empty xml document.
         # @param [Hash] rules An XML::Parser rule set.
-        # @return [Hash] 
+        # @return [Hash]
         def self.simulate rules
           stub = Stub.new(rules)
           stub.simulate
@@ -74,7 +74,7 @@ module AWS
               data = data[wrapper]
             end
 
-            ruby_name = child_rules[:rename] || 
+            ruby_name = child_rules[:rename] ||
               Inflection.ruby_name(name.to_s).to_sym
 
             if child_rules[:list]
@@ -85,7 +85,7 @@ module AWS
               data[ruby_name] = stub_data_for(child_rules)
             else
               data[ruby_name] = case child_rules[:type]
-                when :integer  then 0 
+                when :integer  then 0
                 when :float    then 0.0
                 when :time     then Time.now
                 when :datetime then Date.parse(Time.now.to_s)
@@ -105,9 +105,9 @@ module AWS
 
         protected
         def apply_empty_indexes rules, data
-          
+
           return unless rules[:children]
-          
+
           rules[:children].each_pair do |name,child_rules|
             if index = child_rules[:index]
               data[index[:name]] = {}

data/lib/aws/data_pipeline.rb

@@ -19,41 +19,41 @@ module AWS
   # This class is the starting point for working with AWS Data Pipeline.
   #
   # To use AWS Data Pipeline you must first
-  # {sign up here}[http://aws.amazon.com/datapipeline/].
+  # [sign up here](http://aws.amazon.com/datapipeline/).
   #
   # For more information about AWS Data Pipeline:
   #
-  # * {AWS Data Pipeline}[http://aws.amazon.com/datapipeline/]
-  # * {AWS Data Pipeline Documentation}[http://aws.amazon.com/documentation/datapipeline/]
+  # * [AWS Data Pipeline](http://aws.amazon.com/datapipeline/)
+  # * [AWS Data Pipeline Documentation](http://aws.amazon.com/documentation/datapipeline/)
   #
-  # = Credentials
+  # # Credentials
   #
   # You can setup default credentials for all AWS services via
   # AWS.config:
   #
-  #   AWS.config(
-  #     :access_key_id => 'YOUR_ACCESS_KEY_ID',
-  #     :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
+  #     AWS.config(
+  #       :access_key_id => 'YOUR_ACCESS_KEY_ID',
+  #       :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
   #
   # Or you can set them directly on the AWS::DataPipeline interface:
   #
-  #   datapipeline = AWS::DataPipeline.new(
-  #     :access_key_id => 'YOUR_ACCESS_KEY_ID',
-  #     :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
+  #     datapipeline = AWS::DataPipeline.new(
+  #       :access_key_id => 'YOUR_ACCESS_KEY_ID',
+  #       :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
   #
-  # = Using the Client
+  # # Using the Client
   #
   # AWS::DataPipeline does not provide higher level abstractions for AWS Data Pipeline
   # this time.  You can still access all of the API methods using
   # {AWS::DataPipeline::Client}.  Here is how you access the client and make
   # a simple request:
   #
-  #   data_pipeline = AWS::DataPipeline.new
+  #     data_pipeline = AWS::DataPipeline.new
   #
-  #   resp = data_pipeline.client.describe_pipelines
-  #   resp[:pipeline_description_list].each do |pipeline|
-  #     puts pipeline[:pipeline_id]
-  #   end
+  #     resp = data_pipeline.client.describe_pipelines
+  #     resp[:pipeline_description_list].each do |pipeline|
+  #       puts pipeline[:pipeline_id]
+  #     end
   #
   # See {Client} for documentation on all of the supported operations.
   #
@@ -61,13 +61,13 @@ module AWS
   #   @return [Client] the low-level DataPipeline client object
   class DataPipeline
 
-    AWS.register_autoloads(self, 'aws/data_pipeline') do
-      autoload :Client, 'client'
-      autoload :Errors, 'errors'
-      autoload :Request, 'request'
-    end
+    autoload :Client, 'aws/data_pipeline/client'
+    autoload :Errors, 'aws/data_pipeline/errors'
+    autoload :Request, 'aws/data_pipeline/request'
 
     include Core::ServiceInterface
 
+    endpoint_prefix 'datapipeline'
+
   end
 end

data/lib/aws/data_pipeline/client.rb

@@ -25,18 +25,18 @@ module AWS
       # @!method activate_pipeline(options = {})
       # Calls the ActivatePipeline API operation.
       # @param [Hash] options
-      #   * +:pipeline_id+ - *required* - (String) The identifier of the
+      #   * `:pipeline_id` - *required* - (String) The identifier of the
       #     pipeline to activate.
       # @return [Core::Response]
 
       # @!method create_pipeline(options = {})
       # Calls the CreatePipeline API operation.
       # @param [Hash] options
-      #   * +:name+ - *required* - (String) The name of the new pipeline. You
+      #   * `:name` - *required* - (String) The name of the new pipeline. You
       #     can use the same name for multiple pipelines associated with your
       #     AWS account, because AWS Data Pipeline assigns each new pipeline a
       #     unique pipeline identifier.
-      #   * +:unique_id+ - *required* - (String) A unique identifier that you
+      #   * `:unique_id` - *required* - (String) A unique identifier that you
       #     specify. This identifier is not the same as the pipeline identifier
       #     assigned by AWS Data Pipeline. You are responsible for defining the
       #     format and ensuring the uniqueness of this identifier. You use this
@@ -48,30 +48,32 @@ module AWS
       #     exists with the same name and unique identifier, a new pipeline
       #     will not be created. Instead, you'll receive the pipeline
       #     identifier from the previous attempt. The uniqueness of the name
-      #     and unique identifier combination is scoped to the AWS account.
-      #   * +:description+ - (String) The description of the new pipeline.
+      #     and unique identifier combination is scoped to the AWS account or
+      #     IAM user credentials.
+      #   * `:description` - (String) The description of the new pipeline.
       # @return [Core::Response]
       #   The #data method of the response object returns
       #   a hash with the following structure:
-      #   * +:pipeline_id+ - (String)
+      #   * `:pipeline_id` - (String)
 
       # @!method delete_pipeline(options = {})
       # Calls the DeletePipeline API operation.
       # @param [Hash] options
-      #   * +:pipeline_id+ - *required* - (String) The identifier of the
+      #   * `:pipeline_id` - *required* - (String) The identifier of the
       #     pipeline to be deleted.
       # @return [Core::Response]
 
       # @!method describe_objects(options = {})
       # Calls the DescribeObjects API operation.
       # @param [Hash] options
-      #   * +:pipeline_id+ - *required* - (String) Identifier of the pipeline
+      #   * `:pipeline_id` - *required* - (String) Identifier of the pipeline
       #     that contains the object definitions.
-      #   * +:object_ids+ - *required* - (Array<String>) Identifiers of the
+      #   * `:object_ids` - *required* - (Array<String>) Identifiers of the
       #     pipeline objects that contain the definitions to be described. You
       #     can pass as many as 25 identifiers in a single call to
       #     DescribeObjects
-      #   * +:marker+ - (String) The starting point for the results to be
+      #   * `:evaluate_expressions` - (Boolean)
+      #   * `:marker` - (String) The starting point for the results to be
       #     returned. The first time you call DescribeObjects, this value
       #     should be empty. As long as the action returns HasMoreResults as
       #     True, you can call DescribeObjects again and pass the marker value
@@ -79,67 +81,69 @@ module AWS
       # @return [Core::Response]
       #   The #data method of the response object returns
       #   a hash with the following structure:
-      #   * +:pipeline_objects+ - (Array<Hash>)
-      #     * +:id+ - (String)
-      #     * +:name+ - (String)
-      #     * +:fields+ - (Array<Hash>)
-      #       * +:key+ - (String)
-      #       * +:string_value+ - (String)
-      #       * +:ref_value+ - (String)
-      #   * +:marker+ - (String)
-      #   * +:has_more_results+ - (Boolean)
+      #   * `:pipeline_objects` - (Array<Hash>)
+      #     * `:id` - (String)
+      #     * `:name` - (String)
+      #     * `:fields` - (Array<Hash>)
+      #       * `:key` - (String)
+      #       * `:string_value` - (String)
+      #       * `:ref_value` - (String)
+      #   * `:marker` - (String)
+      #   * `:has_more_results` - (Boolean)
 
       # @!method describe_pipelines(options = {})
       # Calls the DescribePipelines API operation.
       # @param [Hash] options
-      #   * +:pipeline_ids+ - *required* - (Array<String>) Identifiers of the
+      #   * `:pipeline_ids` - *required* - (Array<String>) Identifiers of the
       #     pipelines to describe. You can pass as many as 25 identifiers in a
       #     single call to DescribePipelines. You can obtain pipeline
       #     identifiers by calling ListPipelines.
       # @return [Core::Response]
       #   The #data method of the response object returns
       #   a hash with the following structure:
-      #   * +:pipeline_description_list+ - (Array<Hash>)
-      #     * +:pipeline_id+ - (String)
-      #     * +:name+ - (String)
-      #     * +:fields+ - (Array<Hash>)
-      #       * +:key+ - (String)
-      #       * +:string_value+ - (String)
-      #       * +:ref_value+ - (String)
-      #     * +:description+ - (String)
+      #   * `:pipeline_description_list` - (Array<Hash>)
+      #     * `:pipeline_id` - (String)
+      #     * `:name` - (String)
+      #     * `:fields` - (Array<Hash>)
+      #       * `:key` - (String)
+      #       * `:string_value` - (String)
+      #       * `:ref_value` - (String)
+      #     * `:description` - (String)
 
       # @!method evaluate_expression(options = {})
       # Calls the EvaluateExpression API operation.
       # @param [Hash] options
-      #   * +:pipeline_id+ - *required* - (String)
-      #   * +:object_id+ - *required* - (String)
-      #   * +:expression+ - *required* - (String)
+      #   * `:pipeline_id` - *required* - (String) The identifier of the
+      #     pipeline.
+      #   * `:object_id` - *required* - (String) The identifier of the object.
+      #   * `:expression` - *required* - (String) The expression to evaluate.
       # @return [Core::Response]
       #   The #data method of the response object returns
       #   a hash with the following structure:
-      #   * +:evaluated_expression+ - (String)
+      #   * `:evaluated_expression` - (String)
 
       # @!method get_pipeline_definition(options = {})
       # Calls the GetPipelineDefinition API operation.
       # @param [Hash] options
-      #   * +:pipeline_id+ - *required* - (String) The identifier of the
+      #   * `:pipeline_id` - *required* - (String) The identifier of the
       #     pipeline.
-      #   * +:version+ - (String)
+      #   * `:version` - (String) The version of the pipeline definition to
+      #     retrieve.
       # @return [Core::Response]
       #   The #data method of the response object returns
       #   a hash with the following structure:
-      #   * +:pipeline_objects+ - (Array<Hash>)
-      #     * +:id+ - (String)
-      #     * +:name+ - (String)
-      #     * +:fields+ - (Array<Hash>)
-      #       * +:key+ - (String)
-      #       * +:string_value+ - (String)
-      #       * +:ref_value+ - (String)
+      #   * `:pipeline_objects` - (Array<Hash>)
+      #     * `:id` - (String)
+      #     * `:name` - (String)
+      #     * `:fields` - (Array<Hash>)
+      #       * `:key` - (String)
+      #       * `:string_value` - (String)
+      #       * `:ref_value` - (String)
 
       # @!method list_pipelines(options = {})
       # Calls the ListPipelines API operation.
       # @param [Hash] options
-      #   * +:marker+ - (String) The starting point for the results to be
+      #   * `:marker` - (String) The starting point for the results to be
       #     returned. The first time you call ListPipelines, this value should
       #     be empty. As long as the action returns HasMoreResults as True, you
       #     can call ListPipelines again and pass the marker value from the
@@ -147,159 +151,211 @@ module AWS
       # @return [Core::Response]
       #   The #data method of the response object returns
       #   a hash with the following structure:
-      #   * +:pipeline_id_list+ - (Array<Hash>)
-      #     * +:id+ - (String)
-      #     * +:name+ - (String)
-      #   * +:marker+ - (String)
-      #   * +:has_more_results+ - (Boolean)
+      #   * `:pipeline_id_list` - (Array<Hash>)
+      #     * `:id` - (String)
+      #     * `:name` - (String)
+      #   * `:marker` - (String)
+      #   * `:has_more_results` - (Boolean)
 
       # @!method poll_for_task(options = {})
       # Calls the PollForTask API operation.
       # @param [Hash] options
-      #   * +:worker_group+ - *required* - (String) Indicates the type of task
-      #     the worker is configured to accept and process. The worker group is
-      #     set as a field on objects in the pipeline when they are created.
-      #     You can only specify a single value for workerGroup in the call to
-      #     PollForTask. There are no wildcard values permitted in workerGroup,
-      #     the string must be an exact match.
-      #   * +:hostname+ - (String) The public DNS name of the calling worker
-      #     client.
-      #   * +:instance_identity+ - (Hash) Identity information for the Amazon
-      #     EC2 instance that is hosting the worker client.
-      #     * +:document+ - (String) A description of an Amazon EC2 instance
+      #   * `:worker_group` - *required* - (String) Indicates the type of task
+      #     the task runner is configured to accept and process. The worker
+      #     group is set as a field on objects in the pipeline when they are
+      #     created. You can only specify a single value for workerGroup in the
+      #     call to PollForTask. There are no wildcard values permitted in
+      #     workerGroup, the string must be an exact, case-sensitive, match.
+      #   * `:hostname` - (String) The public DNS name of the calling task
+      #     runner.
+      #   * `:instance_identity` - (Hash) Identity information for the Amazon
+      #     EC2 instance that is hosting the task runner. You can get this
+      #     value by calling the URI,
+      #     http://169.254.169.254/latest/meta-data/instance-id, from the EC2
+      #     instance. For more information, go to Instance Metadata in the
+      #     Amazon Elastic Compute Cloud User Guide. Passing in this value
+      #     proves that your task runner is running on an EC2 instance, and
+      #     ensures the proper AWS Data Pipeline service charges are applied to
+      #     your pipeline.
+      #     * `:document` - (String) A description of an Amazon EC2 instance
       #       that is generated when the instance is launched and exposed to
       #       the instance via the instance meta-data service in the form of a
       #       JSON representation of an object.
-      #     * +:signature+ - (String) A signature which can be used to verify
+      #     * `:signature` - (String) A signature which can be used to verify
       #       the accuracy and authenticity of the information provided in the
       #       instance identity document.
       # @return [Core::Response]
       #   The #data method of the response object returns
       #   a hash with the following structure:
-      #   * +:task_object+ - (Hash)
-      #     * +:task_id+ - (String)
-      #     * +:pipeline_id+ - (String)
-      #     * +:attempt_id+ - (String)
-      #     * +:objects+ - (Hash<String,Hash>)
-      #       * +:id+ - (String)
-      #       * +:name+ - (String)
-      #       * +:fields+ - (Array<Hash>)
-      #         * +:key+ - (String)
-      #         * +:string_value+ - (String)
-      #         * +:ref_value+ - (String)
+      #   * `:task_object` - (Hash)
+      #     * `:task_id` - (String)
+      #     * `:pipeline_id` - (String)
+      #     * `:attempt_id` - (String)
+      #     * `:objects` - (Hash<String,Hash>)
+      #       * `:id` - (String)
+      #       * `:name` - (String)
+      #       * `:fields` - (Array<Hash>)
+      #         * `:key` - (String)
+      #         * `:string_value` - (String)
+      #         * `:ref_value` - (String)
 
       # @!method put_pipeline_definition(options = {})
       # Calls the PutPipelineDefinition API operation.
       # @param [Hash] options
-      #   * +:pipeline_id+ - *required* - (String) The identifier of the
+      #   * `:pipeline_id` - *required* - (String) The identifier of the
       #     pipeline to be configured.
-      #   * +:pipeline_objects+ - *required* - (Array<Hash>) The objects that
+      #   * `:pipeline_objects` - *required* - (Array<Hash>) The objects that
       #     define the pipeline. These will overwrite the existing pipeline
       #     definition.
-      #     * +:id+ - *required* - (String) Identifier of the object.
-      #     * +:name+ - *required* - (String) Name of the object.
-      #     * +:fields+ - *required* - (Array<Hash>) Key-value pairs that
+      #     * `:id` - *required* - (String) Identifier of the object.
+      #     * `:name` - *required* - (String) Name of the object.
+      #     * `:fields` - *required* - (Array<Hash>) Key-value pairs that
       #       define the properties of the object.
-      #       * +:key+ - *required* - (String) The field identifier.
-      #       * +:string_value+ - (String) The field value, expressed as a
+      #       * `:key` - *required* - (String) The field identifier.
+      #       * `:string_value` - (String) The field value, expressed as a
       #         String.
-      #       * +:ref_value+ - (String) The field value, expressed as the
+      #       * `:ref_value` - (String) The field value, expressed as the
       #         identifier of another object.
       # @return [Core::Response]
       #   The #data method of the response object returns
       #   a hash with the following structure:
-      #   * +:validation_errors+ - (Array<Hash>)
-      #     * +:id+ - (String)
-      #     * +:errors+ - (Array<String>)
-      #   * +:errored+ - (Boolean)
+      #   * `:validation_errors` - (Array<Hash>)
+      #     * `:id` - (String)
+      #     * `:errors` - (Array<String>)
+      #   * `:errored` - (Boolean)
 
       # @!method query_objects(options = {})
       # Calls the QueryObjects API operation.
       # @param [Hash] options
-      #   * +:pipeline_id+ - *required* - (String) Identifier of the pipeline
+      #   * `:pipeline_id` - *required* - (String) Identifier of the pipeline
       #     to be queried for object names.
-      #   * +:query+ - (Hash) Query that defines the objects to be returned.
+      #   * `:query` - (Hash) Query that defines the objects to be returned.
       #     The Query object can contain a maximum of ten selectors. The
       #     conditions in the query are limited to top-level String fields in
-      #     the object. These filters can be applied to both logical, physical,
-      #     and physical attempt objects.
-      #     * +:selectors+ - (Array<Hash>) List of selectors that define the
+      #     the object. These filters can be applied to components, instances,
+      #     and attempts.
+      #     * `:selectors` - (Array<Hash>) List of selectors that define the
       #       query. An object must satisfy all of the selectors to match the
       #       query.
-      #       * +:field_name+ - (String) The name of the field that the
+      #       * `:field_name` - (String) The name of the field that the
       #         operator will be applied to. The field name is the "key"
       #         portion of the field definition in the pipeline definition
-      #         syntax that is used by the AWS Data Pipeline API.
-      #       * +:operator+ - (Hash)
-      #         * +:type+ - (String) The logical operation to be performed:
+      #         syntax that is used by the AWS Data Pipeline API. If the field
+      #         is not set on the object, the condition fails.
+      #       * `:operator` - (Hash)
+      #         * `:type` - (String) The logical operation to be performed:
       #           equal (EQ), equal reference (REF_EQ), less than or equal
       #           (LE), greater than or equal (GE), or between (BETWEEN). Equal
       #           reference (REF_EQ) can be used only with reference fields.
       #           The other comparison types can be used only with String
-      #           fields.
-      #         * +:values+ - (Array<String>) The value that the actual field
+      #           fields. The comparison types you can use apply only to
+      #           certain object fields, as detailed below. The comparison
+      #           operators EQ and REF_EQ act on the following fields: name
+      #           @sphere parent @componentParent @instanceParent @status
+      #           @scheduledStartTime @scheduledEndTime @actualStartTime
+      #           @actualEndTime The comparison operators GE, LE, and BETWEEN
+      #           act on the following fields: @scheduledStartTime
+      #           @scheduledEndTime @actualStartTime @actualEndTime Note that
+      #           fields beginning with the at sign (@) are read-only and set
+      #           by the web service. When you name fields, you should choose
+      #           names containing only alpha-numeric values, as symbols may be
+      #           reserved by AWS Data Pipeline. A best practice for
+      #           user-defined fields that you add to a pipeline is to prefix
+      #           their name with the string "my". Valid values include:
+      #           * `EQ`
+      #           * `REF_EQ`
+      #           * `LE`
+      #           * `GE`
+      #           * `BETWEEN`
+      #         * `:values` - (Array<String>) The value that the actual field
       #           value will be compared with.
-      #   * +:sphere+ - *required* - (String) Specifies whether the query
-      #     applies to logical objects or physical objects. Allowable values:
-      #     LO (logical object), PO (physical object), POAttempt (physical
-      #     object attempt).
-      #   * +:marker+ - (String) The starting point for the results to be
+      #   * `:sphere` - *required* - (String) Specifies whether the query
+      #     applies to components or instances. Allowable values: COMPONENT,
+      #     INSTANCE, ATTEMPT.
+      #   * `:marker` - (String) The starting point for the results to be
       #     returned. The first time you call QueryObjects, this value should
       #     be empty. As long as the action returns HasMoreResults as True, you
       #     can call QueryObjects again and pass the marker value from the
       #     response to retrieve the next set of results.
-      #   * +:limit+ - (Integer) Specifies the maximum number of object names
+      #   * `:limit` - (Integer) Specifies the maximum number of object names
       #     that QueryObjects will return in a single call. The default value
       #     is 100.
       # @return [Core::Response]
       #   The #data method of the response object returns
       #   a hash with the following structure:
-      #   * +:ids+ - (Array<String>)
-      #   * +:marker+ - (String)
-      #   * +:has_more_results+ - (Boolean)
+      #   * `:ids` - (Array<String>)
+      #   * `:marker` - (String)
+      #   * `:has_more_results` - (Boolean)
 
       # @!method report_task_progress(options = {})
       # Calls the ReportTaskProgress API operation.
       # @param [Hash] options
-      #   * +:task_id+ - *required* - (String) Identifier of the task assigned
-      #     to the worker. This value is provided in the TaskObject that the
-      #     service returns with the response for the PollForTask action.
+      #   * `:task_id` - *required* - (String) Identifier of the task assigned
+      #     to the task runner. This value is provided in the TaskObject that
+      #     the service returns with the response for the PollForTask action.
+      # @return [Core::Response]
+      #   The #data method of the response object returns
+      #   a hash with the following structure:
+      #   * `:canceled` - (Boolean)
+
+      # @!method report_task_runner_heartbeat(options = {})
+      # Calls the ReportTaskRunnerHeartbeat API operation.
+      # @param [Hash] options
+      #   * `:taskrunner_id` - *required* - (String) The identifier of the task
+      #     runner. This value should be unique across your AWS account. In the
+      #     case of AWS Data Pipeline Task Runner launched on a resource
+      #     managed by AWS Data Pipeline, the web service provides a unique
+      #     identifier when it launches the application. If you have written a
+      #     custom task runner, you should assign a unique identifier for the
+      #     task runner.
+      #   * `:worker_group` - (String) Indicates the type of task the task
+      #     runner is configured to accept and process. The worker group is set
+      #     as a field on objects in the pipeline when they are created. You
+      #     can only specify a single value for workerGroup in the call to
+      #     ReportTaskRunnerHeartbeat. There are no wildcard values permitted
+      #     in workerGroup, the string must be an exact, case-sensitive, match.
+      #   * `:hostname` - (String) The public DNS name of the calling task
+      #     runner.
       # @return [Core::Response]
       #   The #data method of the response object returns
       #   a hash with the following structure:
-      #   * +:canceled+ - (Boolean)
+      #   * `:terminate` - (Boolean)
 
       # @!method set_status(options = {})
       # Calls the SetStatus API operation.
       # @param [Hash] options
-      #   * +:pipeline_id+ - *required* - (String) Identifies the pipeline that
+      #   * `:pipeline_id` - *required* - (String) Identifies the pipeline that
       #     contains the objects.
-      #   * +:object_ids+ - *required* - (Array<String>) Identifies an array of
+      #   * `:object_ids` - *required* - (Array<String>) Identifies an array of
       #     objects. The corresponding objects can be either physical or
-      #     logical objects, but not a mix of both types.
-      #   * +:status+ - *required* - (String) Specifies the status to be set on
-      #     all the objects in objectIds.member.N. For logical objects, this
-      #     can be either pause or resume. For physical objects, this can be
-      #     either cancel or rerun.
+      #     components, but not a mix of both types.
+      #   * `:status` - *required* - (String) Specifies the status to be set on
+      #     all the objects in objectIds. For components, this can be either
+      #     PAUSE or RESUME. For instances, this can be either CANCEL, RERUN,
+      #     or MARK_FINISHED.
       # @return [Core::Response]
 
       # @!method set_task_status(options = {})
       # Calls the SetTaskStatus API operation.
       # @param [Hash] options
-      #   * +:task_id+ - *required* - (String) Identifies the task assigned to
-      #     the worker. This value is set in the TaskObject that is returned by
-      #     the PollForTask action.
-      #   * +:task_status+ - *required* - (String) If FINISHED, the task was
-      #     Status successfully completed.
-      #   * +:error_code+ - (Integer) If an error occurred during the task,
+      #   * `:task_id` - *required* - (String) Identifies the task assigned to
+      #     the task runner. This value is set in the TaskObject that is
+      #     returned by the PollForTask action.
+      #   * `:task_status` - *required* - (String) If FINISHED, the task
+      #     successfully completed. If FAILED the task ended unsuccessfully.
+      #     The FALSE value is used by preconditions. Valid values include:
+      #     * `FINISHED`
+      #     * `FAILED`
+      #     * `FALSE`
+      #   * `:error_code` - (Integer) If an error occurred during the task,
       #     specifies a numerical value that represents the error. This value
       #     is set on the physical attempt object. It is used to display error
       #     information to the user. The web service does not parse this value.
-      #   * +:error_message+ - (String) If an error occurred during the task,
+      #   * `:error_message` - (String) If an error occurred during the task,
       #     specifies a text description of the error. This value is set on the
       #     physical attempt object. It is used to display error information to
       #     the user. The web service does not parse this value.
-      #   * +:error_stack_trace+ - (String) If an error occurred during the
+      #   * `:error_stack_trace` - (String) If an error occurred during the
       #     task, specifies the stack trace associated with the error. This
       #     value is set on the physical attempt object. It is used to display
       #     error information to the user. The web service does not parse this
@@ -309,26 +365,26 @@ module AWS
       # @!method validate_pipeline_definition(options = {})
       # Calls the ValidatePipelineDefinition API operation.
       # @param [Hash] options
-      #   * +:pipeline_id+ - *required* - (String) Identifies the pipeline
+      #   * `:pipeline_id` - *required* - (String) Identifies the pipeline
       #     whose definition is to be validated.
-      #   * +:pipeline_objects+ - *required* - (Array<Hash>) A list of objects
+      #   * `:pipeline_objects` - *required* - (Array<Hash>) A list of objects
       #     that define the pipeline changes to validate against the pipeline.
-      #     * +:id+ - *required* - (String) Identifier of the object.
-      #     * +:name+ - *required* - (String) Name of the object.
-      #     * +:fields+ - *required* - (Array<Hash>) Key-value pairs that
+      #     * `:id` - *required* - (String) Identifier of the object.
+      #     * `:name` - *required* - (String) Name of the object.
+      #     * `:fields` - *required* - (Array<Hash>) Key-value pairs that
       #       define the properties of the object.
-      #       * +:key+ - *required* - (String) The field identifier.
-      #       * +:string_value+ - (String) The field value, expressed as a
+      #       * `:key` - *required* - (String) The field identifier.
+      #       * `:string_value` - (String) The field value, expressed as a
       #         String.
-      #       * +:ref_value+ - (String) The field value, expressed as the
+      #       * `:ref_value` - (String) The field value, expressed as the
       #         identifier of another object.
       # @return [Core::Response]
       #   The #data method of the response object returns
       #   a hash with the following structure:
-      #   * +:validation_errors+ - (Array<Hash>)
-      #     * +:id+ - (String)
-      #     * +:errors+ - (Array<String>)
-      #   * +:errored+ - (Boolean)
+      #   * `:validation_errors` - (Array<Hash>)
+      #     * `:id` - (String)
+      #     * `:errors` - (Array<String>)
+      #   * `:errored` - (Boolean)
 
       # end client methods #