Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.CloudWatchEvents.RemoveTargets

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Removes the specified targets from the specified rule. When the rule is triggered, those targets are no longer be invoked.

When you remove a target, when the associated rule triggers, removed targets might continue to be invoked. Allow a short period of time for changes to take effect.

This action can partially fail if too many requests are made at the same time. If that happens, FailedEntryCount is non-zero in the response and each entry in FailedEntries provides the ID of the failed target and the error code.

Synopsis

data RemoveTargets = RemoveTargets' {
- force :: Maybe Bool
- eventBusName :: Maybe Text
- rule :: Text
- ids :: NonEmpty Text
}
newRemoveTargets :: Text -> NonEmpty Text -> RemoveTargets
removeTargets_force :: Lens' RemoveTargets (Maybe Bool)
removeTargets_eventBusName :: Lens' RemoveTargets (Maybe Text)
removeTargets_rule :: Lens' RemoveTargets Text
removeTargets_ids :: Lens' RemoveTargets (NonEmpty Text)
data RemoveTargetsResponse = RemoveTargetsResponse' {
- failedEntryCount :: Maybe Int
- failedEntries :: Maybe [RemoveTargetsResultEntry]
- httpStatus :: Int
}
newRemoveTargetsResponse :: Int -> RemoveTargetsResponse
removeTargetsResponse_failedEntryCount :: Lens' RemoveTargetsResponse (Maybe Int)
removeTargetsResponse_failedEntries :: Lens' RemoveTargetsResponse (Maybe [RemoveTargetsResultEntry])
removeTargetsResponse_httpStatus :: Lens' RemoveTargetsResponse Int

Creating a Request

data RemoveTargets Source #

See: newRemoveTargets smart constructor.

Constructors

RemoveTargets'

Fields

force :: Maybe Bool
If this is a managed rule, created by an Amazon Web Services service on your behalf, you must specify Force as True to remove targets. This parameter is ignored for rules that are not managed rules. You can check whether a rule is a managed rule by using DescribeRule or ListRules and checking the ManagedBy field of the response.
eventBusName :: Maybe Text
The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.
rule :: Text
The name of the rule.
ids :: NonEmpty Text
The IDs of the targets to remove from the rule.

Instances

Instances details

Eq RemoveTargets Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets Methods (==) :: RemoveTargets -> RemoveTargets -> Bool # (/=) :: RemoveTargets -> RemoveTargets -> Bool #
Read RemoveTargets Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets Methods readsPrec :: Int -> ReadS RemoveTargets # readList :: ReadS [RemoveTargets] # readPrec :: ReadPrec RemoveTargets # readListPrec :: ReadPrec [RemoveTargets] #
Show RemoveTargets Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets Methods showsPrec :: Int -> RemoveTargets -> ShowS # show :: RemoveTargets -> String # showList :: [RemoveTargets] -> ShowS #
Generic RemoveTargets Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets Associated Types type Rep RemoveTargets :: Type -> Type # Methods from :: RemoveTargets -> Rep RemoveTargets x # to :: Rep RemoveTargets x -> RemoveTargets #
NFData RemoveTargets Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets Methods rnf :: RemoveTargets -> () #
Hashable RemoveTargets Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets Methods hashWithSalt :: Int -> RemoveTargets -> Int # hash :: RemoveTargets -> Int #
ToJSON RemoveTargets Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets Methods toJSON :: RemoveTargets -> Value # toEncoding :: RemoveTargets -> Encoding # toJSONList :: [RemoveTargets] -> Value # toEncodingList :: [RemoveTargets] -> Encoding #
AWSRequest RemoveTargets Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets Associated Types type AWSResponse RemoveTargets # Methods request :: RemoveTargets -> Request RemoveTargets # response :: MonadResource m => Logger -> Service -> Proxy RemoveTargets -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse RemoveTargets))) #
ToHeaders RemoveTargets Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets Methods toHeaders :: RemoveTargets -> [Header] #
ToPath RemoveTargets Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets Methods toPath :: RemoveTargets -> ByteString #
ToQuery RemoveTargets Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets Methods toQuery :: RemoveTargets -> QueryString #
type Rep RemoveTargets Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets type Rep RemoveTargets = D1 ('MetaData "RemoveTargets" "Amazonka.CloudWatchEvents.RemoveTargets" "libZSservicesZSamazonka-cloudwatch-eventsZSamazonka-cloudwatch-events" 'False) (C1 ('MetaCons "RemoveTargets'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "force") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :: S1 ('MetaSel ('Just "eventBusName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :: (S1 ('MetaSel ('Just "rule") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "ids") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (NonEmpty Text)))))
type AWSResponse RemoveTargets Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets type AWSResponse RemoveTargets = RemoveTargetsResponse

newRemoveTargets Source #

Arguments

:: Text	`$sel:rule:RemoveTargets'`
-> NonEmpty Text	`$sel:ids:RemoveTargets'`
-> RemoveTargets

Create a value of RemoveTargets with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:force:RemoveTargets', removeTargets_force - If this is a managed rule, created by an Amazon Web Services service on your behalf, you must specify Force as True to remove targets. This parameter is ignored for rules that are not managed rules. You can check whether a rule is a managed rule by using DescribeRule or ListRules and checking the ManagedBy field of the response.

$sel:eventBusName:RemoveTargets', removeTargets_eventBusName - The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.

$sel:rule:RemoveTargets', removeTargets_rule - The name of the rule.

$sel:ids:RemoveTargets', removeTargets_ids - The IDs of the targets to remove from the rule.

Request Lenses

removeTargets_force :: Lens' RemoveTargets (Maybe Bool) Source #

If this is a managed rule, created by an Amazon Web Services service on your behalf, you must specify Force as True to remove targets. This parameter is ignored for rules that are not managed rules. You can check whether a rule is a managed rule by using DescribeRule or ListRules and checking the ManagedBy field of the response.

removeTargets_eventBusName :: Lens' RemoveTargets (Maybe Text) Source #

The name or ARN of the event bus associated with the rule. If you omit this, the default event bus is used.

removeTargets_rule :: Lens' RemoveTargets Text Source #

The name of the rule.

removeTargets_ids :: Lens' RemoveTargets (NonEmpty Text) Source #

The IDs of the targets to remove from the rule.

Destructuring the Response

data RemoveTargetsResponse Source #

See: newRemoveTargetsResponse smart constructor.

Constructors

RemoveTargetsResponse'
Fields failedEntryCount :: Maybe Int The number of failed entries. failedEntries :: Maybe [RemoveTargetsResultEntry] The failed target entries. httpStatus :: Int The response's http status code.

Instances

Instances details

Eq RemoveTargetsResponse Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets Methods (==) :: RemoveTargetsResponse -> RemoveTargetsResponse -> Bool # (/=) :: RemoveTargetsResponse -> RemoveTargetsResponse -> Bool #
Read RemoveTargetsResponse Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets Methods readsPrec :: Int -> ReadS RemoveTargetsResponse # readList :: ReadS [RemoveTargetsResponse] # readPrec :: ReadPrec RemoveTargetsResponse # readListPrec :: ReadPrec [RemoveTargetsResponse] #
Show RemoveTargetsResponse Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets Methods showsPrec :: Int -> RemoveTargetsResponse -> ShowS # show :: RemoveTargetsResponse -> String # showList :: [RemoveTargetsResponse] -> ShowS #
Generic RemoveTargetsResponse Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets Associated Types type Rep RemoveTargetsResponse :: Type -> Type # Methods from :: RemoveTargetsResponse -> Rep RemoveTargetsResponse x # to :: Rep RemoveTargetsResponse x -> RemoveTargetsResponse #
NFData RemoveTargetsResponse Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets Methods rnf :: RemoveTargetsResponse -> () #
type Rep RemoveTargetsResponse Source #
Instance details Defined in Amazonka.CloudWatchEvents.RemoveTargets type Rep RemoveTargetsResponse = D1 ('MetaData "RemoveTargetsResponse" "Amazonka.CloudWatchEvents.RemoveTargets" "libZSservicesZSamazonka-cloudwatch-eventsZSamazonka-cloudwatch-events" 'False) (C1 ('MetaCons "RemoveTargetsResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "failedEntryCount") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int)) :: (S1 ('MetaSel ('Just "failedEntries") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [RemoveTargetsResultEntry])) :: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newRemoveTargetsResponse Source #

Arguments

:: Int	`$sel:httpStatus:RemoveTargetsResponse'`
-> RemoveTargetsResponse

Create a value of RemoveTargetsResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:failedEntryCount:RemoveTargetsResponse', removeTargetsResponse_failedEntryCount - The number of failed entries.

$sel:failedEntries:RemoveTargetsResponse', removeTargetsResponse_failedEntries - The failed target entries.

$sel:httpStatus:RemoveTargetsResponse', removeTargetsResponse_httpStatus - The response's http status code.

Response Lenses

removeTargetsResponse_failedEntryCount :: Lens' RemoveTargetsResponse (Maybe Int) Source #

The number of failed entries.

removeTargetsResponse_failedEntries :: Lens' RemoveTargetsResponse (Maybe [RemoveTargetsResultEntry]) Source #

The failed target entries.

removeTargetsResponse_httpStatus :: Lens' RemoveTargetsResponse Int Source #

The response's http status code.