aws-sdk-cloudwatchevents 1.0.0.rc6 → 1.0.0.rc7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cf3d19888c14e5c20e02745fd9ae5ab638889095
-  data.tar.gz: 4f4c0df152ce68db7018db4fa7222214dd93e6c6
+  metadata.gz: ead30867064577c5df8d81e246d8bf97da73f913
+  data.tar.gz: 8a2caf63633b7734bf49134464fdfd9272bcd493
 SHA512:
-  metadata.gz: a4555e4a6af260214884fcc3db88c85511e5634d1aa4e944b594d6104f6731128333c2eff9f8eaca76fa7915282011c5f5c6ce9020a3e65e126924d8b884e7ed
-  data.tar.gz: 28c9ad00ab5f02676990d5efab52d18a0d498a6520b0639a4ab3a3e29402b48e135fb9e2658cf5ab7db41105f7c9e47fadb68f766fa12edde9a16972b7519017
+  metadata.gz: ea6572b50d7cecb5673c531aec5b29c7d34ff33eeea513e4994dea0f83af2f9799f407d12906e8d95a364a4a1cad7233966144777df14295373cf843fbc242eb
+  data.tar.gz: 1f803e9a80dc184fe65b4e2195c494fea07ce9c92d2ad84ec9baa28590af8f35dd13b0a9d5a69eb21bdb20d29664e0cdcf5aa54043f485997160968610d0444c

data/lib/aws-sdk-cloudwatchevents.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-cloudwatchevents/customizations'
 # @service
 module Aws::CloudWatchEvents
 
-  GEM_VERSION = '1.0.0.rc6'
+  GEM_VERSION = '1.0.0.rc7'
 
 end

data/lib/aws-sdk-cloudwatchevents/client.rb

@@ -184,6 +184,32 @@ module Aws::CloudWatchEvents
       req.send_request(options)
     end
 
+    # Displays the external AWS accounts that are permitted to write events
+    # to your account using your account's event bus, and the associated
+    # policy. To enable your account to receive events from other accounts,
+    # use PutPermission.
+    #
+    # @return [Types::DescribeEventBusResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeEventBusResponse#name #name} => String
+    #   * {Types::DescribeEventBusResponse#arn #arn} => String
+    #   * {Types::DescribeEventBusResponse#policy #policy} => String
+    #
+    # @example Response structure
+    #
+    #   resp.name #=> String
+    #   resp.arn #=> String
+    #   resp.policy #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07/DescribeEventBus AWS API Documentation
+    #
+    # @overload describe_event_bus(params = {})
+    # @param [Hash] params ({})
+    def describe_event_bus(params = {}, options = {})
+      req = build_request(:describe_event_bus, params)
+      req.send_request(options)
+    end
+
     # Describes the specified rule.
     #
     # @option params [required, String] :name
@@ -465,6 +491,58 @@ module Aws::CloudWatchEvents
       req.send_request(options)
     end
 
+    # Running `PutPermission` permits the specified AWS account to put
+    # events to your account's default *event bus*. CloudWatch Events rules
+    # in your account are triggered by these events arriving to your default
+    # event bus.
+    #
+    # For another account to send events to your account, that external
+    # account must have a CloudWatch Events rule with your account's
+    # default event bus as a target.
+    #
+    # To enable multiple AWS accounts to put events to your default event
+    # bus, run `PutPermission` once for each of these accounts.
+    #
+    # @option params [required, String] :action
+    #   The action that you are enabling the other account to perform.
+    #   Currently, this must be `events:PutEvents`.
+    #
+    # @option params [required, String] :principal
+    #   The 12-digit AWS account ID that you are permitting to put events to
+    #   your default event bus. Specify "*" to permit any account to put
+    #   events to your default event bus.
+    #
+    #   If you specify "*", avoid creating rules that may match undesirable
+    #   events. To create more secure rules, make sure that the event pattern
+    #   for each rule contains an `account` field with a specific account ID
+    #   from which to receive events. Rules with an account field do not match
+    #   any events sent from other accounts.
+    #
+    # @option params [required, String] :statement_id
+    #   An identifier string for the external account that you are granting
+    #   permissions to. If you later want to revoke the permission for this
+    #   external account, specify this `StatementId` when you run
+    #   RemovePermission.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.put_permission({
+    #     action: "Action", # required
+    #     principal: "Principal", # required
+    #     statement_id: "StatementId", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07/PutPermission AWS API Documentation
+    #
+    # @overload put_permission(params = {})
+    # @param [Hash] params ({})
+    def put_permission(params = {}, options = {})
+      req = build_request(:put_permission, params)
+      req.send_request(options)
+    end
+
     # Creates or updates the specified rule. Rules are enabled by default,
     # or based on value of the state. You can disable a rule using
     # DisableRule.
@@ -490,7 +568,7 @@ module Aws::CloudWatchEvents
     #   The name of the rule that you are creating or updating.
     #
     # @option params [String] :schedule_expression
-    #   The scheduling expression. For example, "cron(0 20 * * ? *)",
+    #   The scheduling expression. For example, "cron(0 20 * * ? *)" or
     #   "rate(5 minutes)".
     #
     # @option params [String] :event_pattern
@@ -543,10 +621,27 @@ module Aws::CloudWatchEvents
     # targets if they are already associated with the rule.
     #
     # Targets are the resources that are invoked when a rule is triggered.
-    # Example targets include EC2 instances, AWS Lambda functions, Amazon
-    # Kinesis streams, Amazon ECS tasks, AWS Step Functions state machines,
-    # and built-in targets. Note that creating rules with built-in targets
-    # is supported only in the AWS Management Console.
+    #
+    # You can configure the following as targets for CloudWatch Events:
+    #
+    # * EC2 instances
+    #
+    # * AWS Lambda functions
+    #
+    # * Streams in Amazon Kinesis Streams
+    #
+    # * Delivery streams in Amazon Kinesis Firehose
+    #
+    # * Amazon ECS tasks
+    #
+    # * AWS Step Functions state machines
+    #
+    # * Amazon SNS topics
+    #
+    # * Amazon SQS queues
+    #
+    # Note that creating rules with built-in targets is supported only in
+    # the AWS Management Console.
     #
     # For some target types, `PutTargets` provides target-specific
     # parameters. If the target is an Amazon Kinesis stream, you can
@@ -559,10 +654,17 @@ module Aws::CloudWatchEvents
     # Lambda and Amazon SNS resources, CloudWatch Events relies on
     # resource-based policies. For EC2 instances, Amazon Kinesis streams,
     # and AWS Step Functions state machines, CloudWatch Events relies on IAM
-    # roles that you specify in the `RoleARN` argument in `PutTarget`. For
+    # roles that you specify in the `RoleARN` argument in `PutTargets`. For
     # more information, see [Authentication and Access Control][1] in the
     # *Amazon CloudWatch Events User Guide*.
     #
+    # If another AWS account is in the same region and has granted you
+    # permission (using `PutPermission`), you can set that account's event
+    # bus as a target of the rules in your account. To send the matched
+    # events to the other account, specify that account's event bus as the
+    # `Arn` when you run `PutTargets`. For more information about enabling
+    # cross-account events, see PutPermission.
+    #
     # **Input**, **InputPath** and **InputTransformer** are mutually
     # exclusive and optional parameters of a target. When a rule is
     # triggered due to a matched event:
@@ -664,6 +766,33 @@ module Aws::CloudWatchEvents
       req.send_request(options)
     end
 
+    # Revokes the permission of another AWS account to be able to put events
+    # to your default event bus. Specify the account to revoke by the
+    # `StatementId` value that you associated with the account when you
+    # granted it permission with `PutPermission`. You can find the
+    # `StatementId` by using DescribeEventBus.
+    #
+    # @option params [required, String] :statement_id
+    #   The statement ID corresponding to the account that is no longer
+    #   allowed to put events to the default event bus.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.remove_permission({
+    #     statement_id: "StatementId", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07/RemovePermission AWS API Documentation
+    #
+    # @overload remove_permission(params = {})
+    # @param [Hash] params ({})
+    def remove_permission(params = {}, options = {})
+      req = build_request(:remove_permission, params)
+      req.send_request(options)
+    end
+
     # Removes the specified targets from the specified rule. When the rule
     # is triggered, those targets are no longer be invoked.
     #
@@ -767,7 +896,7 @@ module Aws::CloudWatchEvents
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudwatchevents'
-      context[:gem_version] = '1.0.0.rc6'
+      context[:gem_version] = '1.0.0.rc7'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-cloudwatchevents/client_api.rb

@@ -11,10 +11,13 @@ module Aws::CloudWatchEvents
 
     include Seahorse::Model
 
+    Action = Shapes::StringShape.new(name: 'Action')
     Arn = Shapes::StringShape.new(name: 'Arn')
     Boolean = Shapes::BooleanShape.new(name: 'Boolean')
     ConcurrentModificationException = Shapes::StructureShape.new(name: 'ConcurrentModificationException')
     DeleteRuleRequest = Shapes::StructureShape.new(name: 'DeleteRuleRequest')
+    DescribeEventBusRequest = Shapes::StructureShape.new(name: 'DescribeEventBusRequest')
+    DescribeEventBusResponse = Shapes::StructureShape.new(name: 'DescribeEventBusResponse')
     DescribeRuleRequest = Shapes::StructureShape.new(name: 'DescribeRuleRequest')
     DescribeRuleResponse = Shapes::StructureShape.new(name: 'DescribeRuleResponse')
     DisableRuleRequest = Shapes::StructureShape.new(name: 'DisableRuleRequest')
@@ -43,18 +46,22 @@ module Aws::CloudWatchEvents
     ListTargetsByRuleRequest = Shapes::StructureShape.new(name: 'ListTargetsByRuleRequest')
     ListTargetsByRuleResponse = Shapes::StructureShape.new(name: 'ListTargetsByRuleResponse')
     NextToken = Shapes::StringShape.new(name: 'NextToken')
+    PolicyLengthExceededException = Shapes::StructureShape.new(name: 'PolicyLengthExceededException')
+    Principal = Shapes::StringShape.new(name: 'Principal')
     PutEventsRequest = Shapes::StructureShape.new(name: 'PutEventsRequest')
     PutEventsRequestEntry = Shapes::StructureShape.new(name: 'PutEventsRequestEntry')
     PutEventsRequestEntryList = Shapes::ListShape.new(name: 'PutEventsRequestEntryList')
     PutEventsResponse = Shapes::StructureShape.new(name: 'PutEventsResponse')
     PutEventsResultEntry = Shapes::StructureShape.new(name: 'PutEventsResultEntry')
     PutEventsResultEntryList = Shapes::ListShape.new(name: 'PutEventsResultEntryList')
+    PutPermissionRequest = Shapes::StructureShape.new(name: 'PutPermissionRequest')
     PutRuleRequest = Shapes::StructureShape.new(name: 'PutRuleRequest')
     PutRuleResponse = Shapes::StructureShape.new(name: 'PutRuleResponse')
     PutTargetsRequest = Shapes::StructureShape.new(name: 'PutTargetsRequest')
     PutTargetsResponse = Shapes::StructureShape.new(name: 'PutTargetsResponse')
     PutTargetsResultEntry = Shapes::StructureShape.new(name: 'PutTargetsResultEntry')
     PutTargetsResultEntryList = Shapes::ListShape.new(name: 'PutTargetsResultEntryList')
+    RemovePermissionRequest = Shapes::StructureShape.new(name: 'RemovePermissionRequest')
     RemoveTargetsRequest = Shapes::StructureShape.new(name: 'RemoveTargetsRequest')
     RemoveTargetsResponse = Shapes::StructureShape.new(name: 'RemoveTargetsResponse')
     RemoveTargetsResultEntry = Shapes::StructureShape.new(name: 'RemoveTargetsResultEntry')
@@ -75,6 +82,7 @@ module Aws::CloudWatchEvents
     RunCommandTargetValues = Shapes::ListShape.new(name: 'RunCommandTargetValues')
     RunCommandTargets = Shapes::ListShape.new(name: 'RunCommandTargets')
     ScheduleExpression = Shapes::StringShape.new(name: 'ScheduleExpression')
+    StatementId = Shapes::StringShape.new(name: 'StatementId')
     String = Shapes::StringShape.new(name: 'String')
     Target = Shapes::StructureShape.new(name: 'Target')
     TargetArn = Shapes::StringShape.new(name: 'TargetArn')
@@ -92,6 +100,13 @@ module Aws::CloudWatchEvents
     DeleteRuleRequest.add_member(:name, Shapes::ShapeRef.new(shape: RuleName, required: true, location_name: "Name"))
     DeleteRuleRequest.struct_class = Types::DeleteRuleRequest
 
+    DescribeEventBusRequest.struct_class = Types::DescribeEventBusRequest
+
+    DescribeEventBusResponse.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name"))
+    DescribeEventBusResponse.add_member(:arn, Shapes::ShapeRef.new(shape: String, location_name: "Arn"))
+    DescribeEventBusResponse.add_member(:policy, Shapes::ShapeRef.new(shape: String, location_name: "Policy"))
+    DescribeEventBusResponse.struct_class = Types::DescribeEventBusResponse
+
     DescribeRuleRequest.add_member(:name, Shapes::ShapeRef.new(shape: RuleName, required: true, location_name: "Name"))
     DescribeRuleRequest.struct_class = Types::DescribeRuleRequest
 
@@ -173,6 +188,11 @@ module Aws::CloudWatchEvents
 
     PutEventsResultEntryList.member = Shapes::ShapeRef.new(shape: PutEventsResultEntry)
 
+    PutPermissionRequest.add_member(:action, Shapes::ShapeRef.new(shape: Action, required: true, location_name: "Action"))
+    PutPermissionRequest.add_member(:principal, Shapes::ShapeRef.new(shape: Principal, required: true, location_name: "Principal"))
+    PutPermissionRequest.add_member(:statement_id, Shapes::ShapeRef.new(shape: StatementId, required: true, location_name: "StatementId"))
+    PutPermissionRequest.struct_class = Types::PutPermissionRequest
+
     PutRuleRequest.add_member(:name, Shapes::ShapeRef.new(shape: RuleName, required: true, location_name: "Name"))
     PutRuleRequest.add_member(:schedule_expression, Shapes::ShapeRef.new(shape: ScheduleExpression, location_name: "ScheduleExpression"))
     PutRuleRequest.add_member(:event_pattern, Shapes::ShapeRef.new(shape: EventPattern, location_name: "EventPattern"))
@@ -199,6 +219,9 @@ module Aws::CloudWatchEvents
 
     PutTargetsResultEntryList.member = Shapes::ShapeRef.new(shape: PutTargetsResultEntry)
 
+    RemovePermissionRequest.add_member(:statement_id, Shapes::ShapeRef.new(shape: StatementId, required: true, location_name: "StatementId"))
+    RemovePermissionRequest.struct_class = Types::RemovePermissionRequest
+
     RemoveTargetsRequest.add_member(:rule, Shapes::ShapeRef.new(shape: RuleName, required: true, location_name: "Rule"))
     RemoveTargetsRequest.add_member(:ids, Shapes::ShapeRef.new(shape: TargetIdList, required: true, location_name: "Ids"))
     RemoveTargetsRequest.struct_class = Types::RemoveTargetsRequest
@@ -288,6 +311,16 @@ module Aws::CloudWatchEvents
         o.errors << Shapes::ShapeRef.new(shape: InternalException)
       end)
 
+      api.add_operation(:describe_event_bus, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DescribeEventBus"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DescribeEventBusRequest)
+        o.output = Shapes::ShapeRef.new(shape: DescribeEventBusResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalException)
+      end)
+
       api.add_operation(:describe_rule, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribeRule"
         o.http_method = "POST"
@@ -357,6 +390,17 @@ module Aws::CloudWatchEvents
         o.errors << Shapes::ShapeRef.new(shape: InternalException)
       end)
 
+      api.add_operation(:put_permission, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "PutPermission"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: PutPermissionRequest)
+        o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: PolicyLengthExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalException)
+      end)
+
       api.add_operation(:put_rule, Seahorse::Model::Operation.new.tap do |o|
         o.name = "PutRule"
         o.http_method = "POST"
@@ -381,6 +425,16 @@ module Aws::CloudWatchEvents
         o.errors << Shapes::ShapeRef.new(shape: InternalException)
       end)
 
+      api.add_operation(:remove_permission, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "RemovePermission"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: RemovePermissionRequest)
+        o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalException)
+      end)
+
       api.add_operation(:remove_targets, Seahorse::Model::Operation.new.tap do |o|
         o.name = "RemoveTargets"
         o.http_method = "POST"

data/lib/aws-sdk-cloudwatchevents/types.rb

@@ -26,6 +26,35 @@ module Aws::CloudWatchEvents
       include Aws::Structure
     end
 
+    # @api private
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07/DescribeEventBusRequest AWS API Documentation
+    #
+    class DescribeEventBusRequest < Aws::EmptyStructure; end
+
+    # @!attribute [rw] name
+    #   The name of the event bus. Currently, this is always `default`.
+    #   @return [String]
+    #
+    # @!attribute [rw] arn
+    #   The Amazon Resource Name (ARN) of the account permitted to write
+    #   events to the current account.
+    #   @return [String]
+    #
+    # @!attribute [rw] policy
+    #   The policy that enables the external account to send events to your
+    #   account.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07/DescribeEventBusResponse AWS API Documentation
+    #
+    class DescribeEventBusResponse < Struct.new(
+      :name,
+      :arn,
+      :policy)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DescribeRuleRequest
     #   data as a hash:
     #
@@ -487,6 +516,48 @@ module Aws::CloudWatchEvents
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass PutPermissionRequest
+    #   data as a hash:
+    #
+    #       {
+    #         action: "Action", # required
+    #         principal: "Principal", # required
+    #         statement_id: "StatementId", # required
+    #       }
+    #
+    # @!attribute [rw] action
+    #   The action that you are enabling the other account to perform.
+    #   Currently, this must be `events:PutEvents`.
+    #   @return [String]
+    #
+    # @!attribute [rw] principal
+    #   The 12-digit AWS account ID that you are permitting to put events to
+    #   your default event bus. Specify "*" to permit any account to put
+    #   events to your default event bus.
+    #
+    #   If you specify "*", avoid creating rules that may match
+    #   undesirable events. To create more secure rules, make sure that the
+    #   event pattern for each rule contains an `account` field with a
+    #   specific account ID from which to receive events. Rules with an
+    #   account field do not match any events sent from other accounts.
+    #   @return [String]
+    #
+    # @!attribute [rw] statement_id
+    #   An identifier string for the external account that you are granting
+    #   permissions to. If you later want to revoke the permission for this
+    #   external account, specify this `StatementId` when you run
+    #   RemovePermission.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07/PutPermissionRequest AWS API Documentation
+    #
+    class PutPermissionRequest < Struct.new(
+      :action,
+      :principal,
+      :statement_id)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass PutRuleRequest
     #   data as a hash:
     #
@@ -504,7 +575,7 @@ module Aws::CloudWatchEvents
     #   @return [String]
     #
     # @!attribute [rw] schedule_expression
-    #   The scheduling expression. For example, "cron(0 20 * * ? *)",
+    #   The scheduling expression. For example, "cron(0 20 * * ? *)" or
     #   "rate(5 minutes)".
     #   @return [String]
     #
@@ -647,6 +718,25 @@ module Aws::CloudWatchEvents
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass RemovePermissionRequest
+    #   data as a hash:
+    #
+    #       {
+    #         statement_id: "StatementId", # required
+    #       }
+    #
+    # @!attribute [rw] statement_id
+    #   The statement ID corresponding to the account that is no longer
+    #   allowed to put events to the default event bus.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/events-2015-10-07/RemovePermissionRequest AWS API Documentation
+    #
+    class RemovePermissionRequest < Struct.new(
+      :statement_id)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass RemoveTargetsRequest
     #   data as a hash:
     #

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudwatchevents
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc6
+  version: 1.0.0.rc7
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-06-29 00:00:00.000000000 Z
+date: 2017-07-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0.rc14
+        version: 3.0.0.rc15
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0.rc14
+        version: 3.0.0.rc15
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement