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.WAF.DeleteRule

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

This is AWS WAF Classic documentation. For more information, see AWS WAF Classic in the developer guide.

For the latest version of AWS WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

Permanently deletes a Rule. You can't delete a Rule if it's still used in any WebACL objects or if it still includes any predicates, such as ByteMatchSet objects.

If you just want to remove a Rule from a WebACL, use UpdateWebACL.

To permanently delete a Rule from AWS WAF, perform the following steps:

Update the Rule to remove predicates, if any. For more information, see UpdateRule.
Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a DeleteRule request.
Submit a DeleteRule request.

Synopsis

data DeleteRule = DeleteRule' {
- ruleId :: Text
- changeToken :: Text
}
newDeleteRule :: Text -> Text -> DeleteRule
deleteRule_ruleId :: Lens' DeleteRule Text
deleteRule_changeToken :: Lens' DeleteRule Text
data DeleteRuleResponse = DeleteRuleResponse' {
- changeToken :: Maybe Text
- httpStatus :: Int
}
newDeleteRuleResponse :: Int -> DeleteRuleResponse
deleteRuleResponse_changeToken :: Lens' DeleteRuleResponse (Maybe Text)
deleteRuleResponse_httpStatus :: Lens' DeleteRuleResponse Int

Creating a Request

data DeleteRule Source #

See: newDeleteRule smart constructor.

Constructors

DeleteRule'
Fields ruleId :: Text The `RuleId` of the Rule that you want to delete. `RuleId` is returned by CreateRule and by ListRules. changeToken :: Text The value returned by the most recent call to GetChangeToken.

Instances

Instances details

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

newDeleteRule Source #

Arguments

:: Text	`$sel:ruleId:DeleteRule'`
-> Text	`$sel:changeToken:DeleteRule'`
-> DeleteRule

Create a value of DeleteRule 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:ruleId:DeleteRule', deleteRule_ruleId - The RuleId of the Rule that you want to delete. RuleId is returned by CreateRule and by ListRules.

$sel:changeToken:DeleteRule', deleteRule_changeToken - The value returned by the most recent call to GetChangeToken.

Request Lenses

deleteRule_ruleId :: Lens' DeleteRule Text Source #

The RuleId of the Rule that you want to delete. RuleId is returned by CreateRule and by ListRules.

deleteRule_changeToken :: Lens' DeleteRule Text Source #

The value returned by the most recent call to GetChangeToken.

Destructuring the Response

data DeleteRuleResponse Source #

See: newDeleteRuleResponse smart constructor.

Constructors

DeleteRuleResponse'
Fields changeToken :: Maybe Text The `ChangeToken` that you used to submit the `DeleteRule` request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus. httpStatus :: Int The response's http status code.

Instances

Instances details

Eq DeleteRuleResponse Source #
Instance details Defined in Amazonka.WAF.DeleteRule Methods (==) :: DeleteRuleResponse -> DeleteRuleResponse -> Bool # (/=) :: DeleteRuleResponse -> DeleteRuleResponse -> Bool #
Read DeleteRuleResponse Source #
Instance details Defined in Amazonka.WAF.DeleteRule Methods readsPrec :: Int -> ReadS DeleteRuleResponse # readList :: ReadS [DeleteRuleResponse] # readPrec :: ReadPrec DeleteRuleResponse # readListPrec :: ReadPrec [DeleteRuleResponse] #
Show DeleteRuleResponse Source #
Instance details Defined in Amazonka.WAF.DeleteRule Methods showsPrec :: Int -> DeleteRuleResponse -> ShowS # show :: DeleteRuleResponse -> String # showList :: [DeleteRuleResponse] -> ShowS #
Generic DeleteRuleResponse Source #
Instance details Defined in Amazonka.WAF.DeleteRule Associated Types type Rep DeleteRuleResponse :: Type -> Type # Methods from :: DeleteRuleResponse -> Rep DeleteRuleResponse x # to :: Rep DeleteRuleResponse x -> DeleteRuleResponse #
NFData DeleteRuleResponse Source #
Instance details Defined in Amazonka.WAF.DeleteRule Methods rnf :: DeleteRuleResponse -> () #
type Rep DeleteRuleResponse Source #
Instance details Defined in Amazonka.WAF.DeleteRule type Rep DeleteRuleResponse = D1 ('MetaData "DeleteRuleResponse" "Amazonka.WAF.DeleteRule" "libZSservicesZSamazonka-wafZSamazonka-waf" 'False) (C1 ('MetaCons "DeleteRuleResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "changeToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newDeleteRuleResponse Source #

Arguments

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

Create a value of DeleteRuleResponse 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:changeToken:DeleteRule', deleteRuleResponse_changeToken - The ChangeToken that you used to submit the DeleteRule request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

$sel:httpStatus:DeleteRuleResponse', deleteRuleResponse_httpStatus - The response's http status code.

Response Lenses

deleteRuleResponse_changeToken :: Lens' DeleteRuleResponse (Maybe Text) Source #

The ChangeToken that you used to submit the DeleteRule request. You can also use this value to query the status of the request. For more information, see GetChangeTokenStatus.

deleteRuleResponse_httpStatus :: Lens' DeleteRuleResponse Int Source #

The response's http status code.