aws-sdk 1.4.1 → 1.5.0

data/lib/aws/simple_workflow/decision_task.rb

@@ -470,9 +470,7 @@ module AWS
       # execution and records a SignalExternalWorkflowExecutionRequested 
       # event in the history.
       #
-      # @param [String] workflow_id
-      #
-      # @param [String] run_id
+      # @param [WorkflowExecution,String] workflow_execution
       #
       # @param [String] signal_name
       #

data/lib/aws/simple_workflow/errors.rb

@@ -13,45 +13,8 @@
 
 module AWS
   class SimpleWorkflow
-
-    # @private
     module Errors
-
-      module ModeledError
-
-        def initialize(request = nil, response = nil)
-          message = extract_message(response)
-          include_error_type(response) if response
-          super(request, response, message)
-        end
-
-        def extract_message(response)
-          if response and
-              response.body
-            JSON.load(response.body)["message"] || code
-          else
-            code
-          end
-        end
-
-        def include_error_type(response)
-          if response.status >= 500
-            extend Errors::ServerError
-          else
-            extend Errors::ClientError
-          end
-        end
-
-        def code
-          self.class.name =~ /(::)?([^:]+)$/
-          $2
-        end
-
-      end
-
-      include Core::LazyErrorClasses
-
+      extend Core::LazyErrorClasses
     end
-
   end
 end

data/lib/aws/simple_workflow/history_event_collection.rb

@@ -24,8 +24,8 @@ module AWS
 
       include Core::Collection::Limitable
 
-      # @param [WorkflowExecution] The execution this history event 
-      #   belongs to.
+      # @param [WorkflowExecution] workflow_execution The execution this 
+      #   history event belongs to.
       #
       # @param [Hash] options
       #

data/lib/aws/simple_workflow/request.rb

@@ -11,62 +11,19 @@
 # ANY KIND, either express or implied. See the License for the specific
 # language governing permissions and limitations under the License.
 
-require 'openssl'
-require 'time'
-
 module AWS
   class SimpleWorkflow
 
+    # @private
     class Request < Core::Http::Request
 
-      attr_accessor :body
-
-      def add_authorization!(signer)
-
-        self.access_key_id = signer.access_key_id
-
-        headers["x-amz-date"] ||= (headers["date"] ||= Time.now.rfc822)
-        headers["host"] ||= host
-
-        #raise ArgumentError, "a security token is required" unless
-        #  signer.session_token
-        #headers["x-amz-security-token"] = signer.session_token
-
-        # compute the authorization
-        request_hash = OpenSSL::Digest::SHA256.digest(string_to_sign)
-        signature = signer.sign(request_hash)
-        headers["x-amzn-authorization"] =
-          "AWS3 "+
-          "AWSAccessKeyId=#{signer.access_key_id},"+
-          "Algorithm=HmacSHA256,"+
-          "SignedHeaders=#{headers_to_sign.join(';')},"+
-          "Signature=#{signature}"
-      end
-
-      def headers_to_sign
-        headers.keys.select do |header|
-            header == "host" ||
-            header =~ /^x-amz/
-        end
-      end
-
-      def canonical_headers
-        headers_to_sign.map do |name|
-          value = headers[name]
-          "#{name.downcase.strip}:#{value.strip}\n"
-        end.sort.join
-      end
+      include Core::Signature::Version3
 
-      def string_to_sign
-        [http_method,
-         "/",
-         "",
-         canonical_headers,
-         body].join("\n")
-      end
+      # @return [String,nil]
+      attr_accessor :body
 
       def read_timeout
-        # these two operations have long polling 
+        # increase read timeout for long polling
         if headers['x-amz-target'] =~ /PollFor(Decision|Activity)Task/
           90 
         else
@@ -75,6 +32,5 @@ module AWS
       end
 
     end
-
   end
 end

data/lib/aws/simple_workflow/type.rb

@@ -17,7 +17,7 @@ module AWS
     # Base class for {WorkflowType} and {ActivityType} objects.
     class Type < Resource
 
-      # @param [Domain] The domain this type is registered to.
+      # @param [Domain] domain The domain this type is registered to.
       # @param [String] name The name of this type.
       # @param [String] version The version of this type.
       def initialize domain, name, version, options = {}

data/lib/aws/simple_workflow/type_collection.rb

@@ -21,7 +21,8 @@ module AWS
       include OptionFormatters
       include Core::Collection::Limitable 
 
-      # @param [Domain] The domain the (workflow or activity types belong to.
+      # @param [Domain] domain The domain the (workflow or activity types 
+      #   belong to.
       def initialize domain, options = {}
 
         @domain = domain
@@ -51,9 +52,9 @@ module AWS
       #   domain.activity_types['name','version']
       #   domain.activity_types.at('name','version')
       #
-      # @param [String] Name of the type.
+      # @param [String] name Name of the type.
       #
-      # @param [String] Version of the type.
+      # @param [String] version Version of the type.
       #
       # @return [ActivityType,WorkflowType]
       #

data/lib/aws/simple_workflow/workflow_execution_collection.rb

@@ -69,9 +69,9 @@ module AWS
       #   domain.workflow_executions['workflow-id', 'run-id']
       #   domain.workflow_executions.at('workflow-id', 'run-id')
       #
-      # @param [String] The workflow execution id.
+      # @param [String] workflow_id The workflow execution id.
       #
-      # @param [String] The workflow execution run id.
+      # @param [String] run_id The workflow execution run id.
       #
       # @return [WorkflowExecution
       #

data/lib/aws/sns/client.rb

@@ -14,21 +14,357 @@
 module AWS
   class SNS
 
-    # @private
+    # Client class for Amazon Simple Notifications Service (SNS).
     class Client < Core::Client
 
-      AWS.register_autoloads(self) do
-        autoload :XML,     'xml'
-      end
-
-      include Core::ConfiguredClientMethods
-
       API_VERSION = '2010-03-31'
 
+      extend Core::Client::QueryXML
+
       # @private
-      REQUEST_CLASS = SNS::Request
+      CACHEABLE_REQUESTS = Set[]
+
+      ## client methods ##
+
+      # Calls the AddPermission API operation.
+      # @method add_permission(options = {})
+      #
+      # === Options:
+      #
+      # * +:topic_arn+ - *required* - (String) The ARN of the topic whose
+      #   access control policy you wish to modify.
+      # * +:label+ - *required* - (String) A unique identifier for the new
+      #   policy statement.
+      # * +:aws_account_id+ - *required* - (Array<String>) The AWS account IDs
+      #   of the users (principals) who will be given access to the specified
+      #   actions. The users must have AWS accounts, but do not need to be
+      #   signed up for this service.
+      # * +:action_name+ - *required* - (Array<String>) The action you want to
+      #   allow for the specified principal(s). Valid values: any Amazon SNS
+      #   action name.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :add_permission, 'AddPermission'
+
+      # Calls the ConfirmSubscription API operation.
+      # @method confirm_subscription(options = {})
+      #
+      # === Options:
+      #
+      # * +:topic_arn+ - *required* - (String) The ARN of the topic for which
+      #   you wish to confirm a subscription.
+      # * +:token+ - *required* - (String) Short-lived token sent to an
+      #   endpoint during the Subscribe action.
+      # * +:authenticate_on_unsubscribe+ - (String) Disallows unauthenticated
+      #   unsubscribes of the subscription. If the value of this parameter is
+      #   +true+ and the request has an AWS signature, then only the topic
+      #   owner and the subscription owner can unsubscribe the endpoint. The
+      #   unsubscribe action will require AWS authentication.
+      #
+      # === Response Structure:
+      #
+      # * +:subscription_arn+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :confirm_subscription, 'ConfirmSubscription'
+
+      # Calls the CreateTopic API operation.
+      # @method create_topic(options = {})
+      #
+      # === Options:
+      #
+      # * +:name+ - *required* - (String) The name of the topic you want to
+      #   create. Constraints: Topic names must be made up of only uppercase
+      #   and lowercase ASCII letters, numbers, and hyphens, and must be
+      #   between 1 and 256 characters long.
+      #
+      # === Response Structure:
+      #
+      # * +:topic_arn+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :create_topic, 'CreateTopic'
+
+      # Calls the DeleteTopic API operation.
+      # @method delete_topic(options = {})
+      #
+      # === Options:
+      #
+      # * +:topic_arn+ - *required* - (String) The ARN of the topic you want to
+      #   delete. http://sns.us-east-1.amazonaws.com/
+      #   ?TopicArn=arn%3Aaws%3Asns%3Aus-east-1%3A123456789012%3AMy-Topic
+      #   &Action=DeleteTopic &SignatureVersion=2 &SignatureMethod=HmacSHA256
+      #   &Timestamp=2010-03-31T12%3A00%3A00.000Z &AWSAccessKeyId=(AWS Access
+      #   Key ID)
+      #   &Signature=DjHBa%2BbYCKQAzctOPnLP7MbHnrHT3%2FK3kFEZjwcf9%2FU%3D
+      #   <DeleteTopicResponse
+      #   xmlns="http://sns.amazonaws.com/doc/2010-03-31/"> <ResponseMetadata>
+      #   <RequestId>fba800b9-3765-11df-8cf3-c58c53254dfb</RequestId>
+      #   </ResponseMetadata> </DeleteTopicResponse>
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :delete_topic, 'DeleteTopic'
+
+      # Calls the GetSubscriptionAttributes API operation.
+      # @method get_subscription_attributes(options = {})
+      #
+      # === Options:
+      #
+      # * +:subscription_arn+ - *required* - (String) The ARN of the
+      #   subscription whose properties you want to get.
+      #
+      # === Response Structure:
+      #
+      # * +:attributes+ - (Hash<String,String>)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :get_subscription_attributes, 'GetSubscriptionAttributes'
+
+      # Calls the GetTopicAttributes API operation.
+      # @method get_topic_attributes(options = {})
+      #
+      # === Options:
+      #
+      # * +:topic_arn+ - *required* - (String) The ARN of the topic whose
+      #   properties you want to get.
+      #
+      # === Response Structure:
+      #
+      # * +:attributes+ - (Hash<String,String>)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :get_topic_attributes, 'GetTopicAttributes'
+
+      # Calls the ListSubscriptions API operation.
+      # @method list_subscriptions(options = {})
+      #
+      # === Options:
+      #
+      # * +:next_token+ - (String) Token returned by the previous
+      #   ListSubscriptions request.
+      #
+      # === Response Structure:
+      #
+      # * +:subscriptions+ - (Array<Hash>)
+      #   * +:subscription_arn+ - (String)
+      #   * +:owner+ - (String)
+      #   * +:protocol+ - (String)
+      #   * +:endpoint+ - (String)
+      #   * +:topic_arn+ - (String)
+      # * +:next_token+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :list_subscriptions, 'ListSubscriptions'
+
+      # Calls the ListSubscriptionsByTopic API operation.
+      # @method list_subscriptions_by_topic(options = {})
+      #
+      # === Options:
+      #
+      # * +:topic_arn+ - *required* - (String) The ARN of the topic for which
+      #   you wish to find subscriptions.
+      # * +:next_token+ - (String) Token returned by the previous
+      #   ListSubscriptionsByTopic request.
+      #
+      # === Response Structure:
+      #
+      # * +:subscriptions+ - (Array<Hash>)
+      #   * +:subscription_arn+ - (String)
+      #   * +:owner+ - (String)
+      #   * +:protocol+ - (String)
+      #   * +:endpoint+ - (String)
+      #   * +:topic_arn+ - (String)
+      # * +:next_token+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :list_subscriptions_by_topic, 'ListSubscriptionsByTopic'
+
+      # Calls the ListTopics API operation.
+      # @method list_topics(options = {})
+      #
+      # === Options:
+      #
+      # * +:next_token+ - (String) Token returned by the previous ListTopics
+      #   request.
+      #
+      # === Response Structure:
+      #
+      # * +:topics+ - (Array<Hash>)
+      #   * +:topic_arn+ - (String)
+      # * +:next_token+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :list_topics, 'ListTopics'
+
+      # Calls the Publish API operation.
+      # @method publish(options = {})
+      #
+      # === Options:
+      #
+      # * +:topic_arn+ - *required* - (String) The topic you want to publish
+      #   to.
+      # * +:message+ - *required* - (String) The message you want to send to
+      #   the topic. Constraints: Messages must be UTF-8 encoded strings at
+      #   most 8 KB in size (8192 bytes, not 8192 characters).
+      # * +:subject+ - (String) Optional parameter to be used as the "Subject"
+      #   line of when the message is delivered to e-mail endpoints. This field
+      #   will also be included, if present, in the standard JSON messages
+      #   delivered to other endpoints. Constraints: Subjects must be ASCII
+      #   text that begins with a letter, number or punctuation mark; must not
+      #   include line breaks or control characters; and must be less than 100
+      #   characters long.
+      # * +:message_structure+ - (String) Optional parameter. It will have one
+      #   valid value: "json". If this option, Message is present and set to
+      #   "json", the value of Message must: be a syntactically valid JSON
+      #   object. It must contain at least a top level JSON key of "default"
+      #   with a value that is a string. For any other top level key that
+      #   matches one of our transport protocols (e.g. "http"), then the
+      #   corresponding value (if it is a string) will be used for the message
+      #   published for that protocol Constraints: Keys in the JSON object that
+      #   correspond to supported transport protocols must have simple JSON
+      #   string values. The values will be parsed (unescaped) before they are
+      #   used in outgoing messages. Typically, outbound notifications are JSON
+      #   encoded (meaning, the characters will be reescaped for sending). JSON
+      #   strings are UTF-8. Values have a minimum length of 0 (the empty
+      #   string, "", is allowed). Values have a maximum length bounded by the
+      #   overall message size (so, including multiple protocols may limit
+      #   message sizes). Non-string values will cause the key to be ignored.
+      #   Keys that do not correspond to supported transport protocols will be
+      #   ignored. Duplicate keys are not allowed. Failure to parse or validate
+      #   any key or value in the message will cause the Publish call to return
+      #   an error (no partial delivery).
+      #
+      # === Response Structure:
+      #
+      # * +:message_id+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :publish, 'Publish'
+
+      # Calls the RemovePermission API operation.
+      # @method remove_permission(options = {})
+      #
+      # === Options:
+      #
+      # * +:topic_arn+ - *required* - (String) The ARN of the topic whose
+      #   access control policy you wish to modify.
+      # * +:label+ - *required* - (String) The unique label of the statement
+      #   you want to remove.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :remove_permission, 'RemovePermission'
+
+      # Calls the SetSubscriptionAttributes API operation.
+      # @method set_subscription_attributes(options = {})
+      #
+      # === Options:
+      #
+      # * +:subscription_arn+ - *required* - (String) The ARN of the
+      #   subscription to modify.
+      # * +:attribute_name+ - *required* - (String) The name of the attribute
+      #   you want to set. Only a subset of the subscriptions attributes are
+      #   mutable. Valid values: DeliveryPolicy
+      # * +:attribute_value+ - *required* - (String) The new value for the
+      #   attribute.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :set_subscription_attributes, 'SetSubscriptionAttributes'
+
+      # Calls the SetTopicAttributes API operation.
+      # @method set_topic_attributes(options = {})
+      #
+      # === Options:
+      #
+      # * +:topic_arn+ - *required* - (String) The ARN of the topic to modify.
+      # * +:attribute_name+ - *required* - (String) The name of the attribute
+      #   you want to set. Only a subset of the topic's attributes are mutable.
+      #   Valid values: Policy | DisplayName
+      # * +:attribute_value+ - *required* - (String) The new value for the
+      #   attribute.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :set_topic_attributes, 'SetTopicAttributes'
+
+      # Calls the Subscribe API operation.
+      # @method subscribe(options = {})
+      #
+      # === Options:
+      #
+      # * +:topic_arn+ - *required* - (String) The ARN of topic you want to
+      #   subscribe to.
+      # * +:protocol+ - *required* - (String) The protocol you want to use.
+      #   Supported protocols include: http -- delivery of JSON-encoded message
+      #   via HTTP POST https -- delivery of JSON-encoded message via HTTPS
+      #   POST email -- delivery of message via SMTP email-json -- delivery of
+      #   JSON-encoded message via SMTP sms -- delivery of message via SMS sqs
+      #   -- delivery of JSON-encoded message to an Amazon SQS queue
+      # * +:endpoint+ - *required* - (String) The endpoint that you want to
+      #   receive notifications. Endpoints vary by protocol: For the http
+      #   protocol, the endpoint is an URL beginning with "http://" For the
+      #   https protocol, the endpoint is a URL beginning with "https://" For
+      #   the email protocol, the endpoint is an e-mail address For the
+      #   email-json protocol, the endpoint is an e-mail address For the sms
+      #   protocol, the endpoint is a phone number of an SMS-enabled device For
+      #   the sqs protocol, the endpoint is the ARN of an Amazon SQS queue
+      #
+      # === Response Structure:
+      #
+      # * +:subscription_arn+ - (String)
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :subscribe, 'Subscribe'
+
+      # Calls the Unsubscribe API operation.
+      # @method unsubscribe(options = {})
+      #
+      # === Options:
+      #
+      # * +:subscription_arn+ - *required* - (String) The ARN of the
+      #   subscription to be deleted.
+      #
+      # === Response Structure:
+      #
+      # This method returns no response data.
+      #
+      # @return [Core::Response]
+      #
+      define_client_method :unsubscribe, 'Unsubscribe'
 
-      configure_client
+      ## end client methods ##
 
     end
   end