aws_sdk 3.1.5

data/lib/aws/simple_workflow/workflow_type.rb

@@ -0,0 +1,177 @@
+# Copyright 2011-2012 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+require 'uuidtools'
+
+module AWS
+  class SimpleWorkflow
+
+    # == Registering a WorkflowType
+    #
+    # To register a workflow type you should use the #workflow_types method
+    # on the domain:
+    #
+    #   domain.workflow_types.register('name', 'version', { ... })
+    #
+    # See {WorkflowTypeCollection#register} for a complete list of options.
+    #
+    # == Deprecating a workflwo type
+    #
+    # WorkflowType inherits from the generic {Type} base class.  Defined in 
+    # {Type} are a few useful methods including:
+    #
+    # * {Type#deprecate}
+    # * {Type#deprecated?}
+    #
+    # You can use these to deprecate a workflow type:
+    #
+    #   domain.workflow_types['name','version'].deprecate
+    #
+    # @attr_reader [Time] creation_date When the workflow type was registered.
+    #
+    # @attr_reader [Time,nil] deprecation_date When the workflow type
+    #   was deprecated, or nil if the workflow type has not been deprecated.
+    #
+    # @attr_reader [String,nil] description The description of this workflow
+    #   type, or nil if was not set when it was registered.
+    #
+    # @attr_reader [Symbol] status The status of this workflow type.  The
+    #   status will either be +:registered+ or +:deprecated+.
+    # 
+    # @attr_reader [Symbol,nil] default_child_policy Specifies the default
+    #   policy to use for the child workflow executions when a workflow 
+    #   execution of this type is terminated.  Values may be one of the
+    #   following (or nil):
+    #
+    #   * +:terminate+ - the child executions will be terminated.
+    #
+    #   * +:request_cancel+ - a request to cancel will be attempted for each
+    #     child execution by recording a WorkflowExecutionCancelRequested 
+    #     event in its history. It is up to the decider to take appropriate
+    #     actions when it receives an execution history with this event.
+    #
+    #   * +:abandon+ - no action will be taken. The child executions will 
+    #     continue to run.
+    #
+    # @attr_reader [Integer,:none,nil] default_execution_start_to_close_timeout
+    #   The default maximum duration for executions of this workflow type.
+    #
+    #   The return value may be an integer (number of seconds), the
+    #   symbol +:none+ (implying no timeout) or +nil+ (not specified).
+    #
+    # @attr_reader [String,nil] default_task_list Specifies 
+    #   the default task list to use for scheduling decision tasks for 
+    #   executions of this workflow type.
+    #
+    # @attr_reader [Integer,:none,nil] default_task_start_to_close_timeout
+    #   The default maximum duration of decision tasks for this workflow type.
+    #
+    #   The return value may be an integer (number of seconds), the
+    #   symbol +:none+ (implying no timeout) or +nil+ (not specified).
+    #
+    class WorkflowType < Type
+
+      include OptionFormatters
+
+      type_attribute :creation_date, :timestamp => true
+
+      type_attribute :deprecation_date, :timestamp => true, :static => false
+
+      type_attribute :description
+
+      type_attribute :status, :to_sym => true, :static => false
+
+      config_attribute :default_child_policy, :to_sym => true
+
+      config_attribute :default_execution_start_to_close_timeout,
+        :duration => true
+
+      config_attribute :default_task_list do
+        translates_output {|v| v['name'] }
+      end
+
+      config_attribute :default_task_start_to_close_timeout,
+        :duration => true
+
+      # @param [Hash] options
+      #
+      # @option (see DecisionTask#continue_as_new_workflow_execution)
+      # 
+      # @option options [String] :workflow_id
+      #   A user defined identifier associated with the workflow execution.
+      #   You can use this to associate a custom identifier with the 
+      #   workflow execution. You may specify the same identifier if a 
+      #   workflow execution is logically a restart of a previous execution. 
+      #   You cannot have two open workflow executions with the same 
+      #   :workflow_id at the same time.
+      #
+      #   If you do not provide +:workflow_id+ a random UUID will be generated.
+      #
+      # @return [WorkflowExecution] Returns the new workflow execution.
+      #
+      def start_execution options = {}
+        
+        options[:domain] = domain.name
+        start_execution_opts(options, self)
+        response = client.start_workflow_execution(options)
+
+        workflow_id = options[:workflow_id]
+        run_id = response.data['runId']
+
+        domain.workflow_executions[workflow_id, run_id]
+
+      end
+
+      # Returns a count of workflow executions of this workflow type.
+      #
+      #   domain.workflow_types['name','version'].count
+      # 
+      # @note (see WorkflowExecution#count_executions)
+      # @param (see WorkflowExecution#count_executions)
+      # @option (see WorkflowExecution#count_executions)
+      # @return [Integer] Returns the count of workflow execution of this type.
+      def count_executions options = {}
+        options[:workflow_type] = self
+        domain.workflow_executions.count(options)
+      end
+
+      # @return [WorkflowExecutionCollection] Returns a collection that
+      #   enumerates only workflow executions of this type.
+      def workflow_executions
+        WorkflowExecutionCollection.new(domain).with_workflow_type(self)
+      end
+
+      # list workflow type only provides type attributes
+      provider(:list_workflow_types) do |provider|
+        provider.provides *type_attributes.keys
+        provider.find do |resp|
+          desc = resp.data['typeInfos'].find do |info|  
+            info[self.class.type_key] == { 'name' => name, 'version' => version }
+          end
+        end
+      end
+
+      # describe workflow type provides type and config attributes
+      provider(:describe_workflow_type) do |provider|
+        provider.provides *type_attributes.keys
+        provider.provides *config_attributes.keys
+        provider.find do |resp|
+          type = { 'name' => name, 'version' => version }
+          resp.data['typeInfo'][self.class.type_key] == type ?
+            resp.data['typeInfo'].merge(resp.data['configuration']) : nil
+        end
+      end
+
+    end
+  end
+end

data/lib/aws/simple_workflow/workflow_type_collection.rb

@@ -0,0 +1,91 @@
+# Copyright 2011-2012 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  class SimpleWorkflow
+
+    class WorkflowTypeCollection < TypeCollection
+
+      # Registers a new workflow type and its configuration settings for 
+      # in the current domain.
+      # 
+      # @param [String] name The name of the workflow type.
+      #
+      # @param [String] version The version of the workflow type.
+      #   The workflow type consists of the name and version, the 
+      #   combination of which must be unique within the domain. 
+      #
+      # @param [Hash] options
+      # 
+      # @option options [Symbol] :default_child_policy (nil) Specifies the default
+      #   policy to use for the child workflow executions when a workflow 
+      #   execution of this type is terminated.  This default can be 
+      #   overridden when starting a workflow execution. The supported child
+      #   policies are:
+      #
+      #   * +:terminate+ - the child executions will be terminated.
+      #
+      #   * +:request_cancel+ - a request to cancel will be attempted for each
+      #     child execution by recording a WorkflowExecutionCancelRequested 
+      #     event in its history. It is up to the decider to take appropriate
+      #     actions when it receives an execution history with this event.
+      #
+      #   * +:abandon+ - no action will be taken. The child executions will 
+      #     continue to run.
+      #
+      # @option options [Integer,:none] :default_execution_start_to_close_timeout (nil)
+      #   The default maximum duration for executions of this workflow type.
+      #   You can override this default when starting an execution.  
+      #   The value should be a number of seconds (integer) or the symbol
+      #   +:none+ (implying no timeout).
+      #
+      # @option options [String] :default_task_list (nil) Specifies 
+      #   the default task list to use for scheduling decision tasks for 
+      #   executions of this workflow type. This default is used only if 
+      #   a task list is not provided when starting the workflow execution.
+      #
+      # @option options [Integer,:none] :default_task_start_to_close_timeout (nil)
+      #   The default maximum duration of decision tasks for this workflow type.
+      #
+      #   The value should be a number of seconds (integer) or the symbol
+      #   +:none+ (implying no timeout).
+      #
+      # @option options [String] :description (nil) Textual description of
+      #   the workflow type.
+      #   
+      def register name, version, options = {}
+
+        options[:domain] = domain.name
+        options[:name] = name
+        options[:version] = version
+
+        upcase_opts(options, :default_child_policy)
+
+        duration_opts(options, 
+          :default_execution_start_to_close_timeout,
+          :default_task_start_to_close_timeout)
+
+        if task_list = options[:default_task_list]
+          options[:default_task_list] = { :name => task_list.to_s }
+        end
+
+        client.register_workflow_type(options)
+
+        self[name, version]
+        
+      end
+      alias_method :create, :register
+
+    end
+  end
+end

data/lib/aws/sns.rb

@@ -0,0 +1,74 @@
+# Copyright 2011-2012 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+require 'aws/core'
+require 'aws/sns/config'
+
+module AWS
+
+  # This class is the starting point for working with Amazon Simple 
+  # Notification Service (SNS).
+  #
+  # To use Amazon SNS you must first {sign up here}[http://aws.amazon.com/sns/].
+  #
+  # For more information about Amazon SNS:
+  #
+  # * {Amazon SNS}[http://aws.amazon.com/sns/]
+  # * {Amazon SNS Documentation}[http://aws.amazon.com/documentation/sns/]
+  #
+  # = 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')
+  # 
+  # Or you can set them directly on the SNS interface:
+  #
+  #   sns = AWS::SNS.new(
+  #     :access_key_id => 'YOUR_ACCESS_KEY_ID',
+  #     :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
+  #
+  class SNS
+
+    AWS.register_autoloads(self) do
+      autoload :Client,                      'client'
+      autoload :Errors,                      'errors'
+      autoload :Policy,                      'policy'
+      autoload :HasDeliveryPolicy,           'has_delivery_policy'
+      autoload :Request,                     'request'
+      autoload :Subscription,                'subscription'
+      autoload :SubscriptionCollection,      'subscription_collection'
+      autoload :Topic,                       'topic'
+      autoload :TopicCollection,             'topic_collection'
+      autoload :TopicSubscriptionCollection, 'topic_subscription_collection'
+    end
+
+    include Core::ServiceInterface
+
+    # @return [TopicCollection] Returns a topic collection for managing
+    #   SNS topics.
+    def topics
+      TopicCollection.new(:config => config)
+    end
+
+    # @return [SubscriptionCollection] Returns a subscription
+    #   collection for managing SNS subscriptions.
+    def subscriptions
+      SubscriptionCollection.new(:config => config)
+    end
+
+  end
+end

data/lib/aws/sns/client.rb

@@ -0,0 +1,371 @@
+# Copyright 2011-2012 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  class SNS
+
+    # Client class for Amazon Simple Notifications Service (SNS).
+    class Client < Core::Client
+
+      API_VERSION = '2010-03-31'
+
+      extend Core::Client::QueryXML
+
+      # @private
+      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'
+
+      ## end client methods ##
+
+    end
+  end
+end