Modifies a defense rule against brute-force attacks.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyAntiBruteForceRule

The operation that you want to perform. Set the value to ModifyAntiBruteForceRule.

SourceIp String No 1.2.XX.XX

The source IP address of the request.

Id Long No 65778

The ID of the defense rule.

Name String No lawtest defense rule

The name of the defense rule.

Span Integer No 1

The maximum period of time during which failed logon attempts from an account can occur. Unit: minutes. Valid values:

  • 1
  • 2
  • 5
  • 10
  • 15
FailCount Integer No 10

The maximum number of failed logon attempts from an account. Valid values:

  • 2
  • 3
  • 4
  • 5
  • 10
  • 50
  • 80
  • 100
ForbiddenTime Integer No 5

The period of time during which logons from an account are not allowed. Unit: minutes. Valid values:

  • 5
  • 15
  • 30
  • 60
  • 120
  • 360
  • 720
  • 1440
  • 10080
  • 52560000: permanent
DefaultRule Boolean No true

Specifies whether to set the defense rule as the default rule. Valid values:

  • true: yes
  • false: no
UuidList.N String No ["292dcc68-b60b-4bbd-a0be-beaa1622****","7eb0dfc0-3205-4b8c-b26c-3f4159dc****"]

The UUIDs of the servers to which the defense rule is applied. Separate multiple UUIDs with commas (,).

Response parameters

Parameter Type Example Description
RequestId String F35F45B0-5D6B-4238-BE02-A62D0760E840

The ID of the request, which is used to locate and troubleshoot issues.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ModifyAntiBruteForceRule
&SourceIp=1.2.XX.XX
&Id=65778
&Name=lawtest defense rule
&Span=1
&FailCount=10
&ForbiddenTime=5
&DefaultRule=true
&UuidList=["[\"292dcc68-b60b-4bbd-a0be-beaa1622****\",\"7eb0dfc0-3205-4b8c-b26c-3f4159dc****\"]"]
&Common request parameters

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyAntiBruteForceRuleResponse>
    <RequestId>F35F45B0-5D6B-4238-BE02-A62D0760E840</RequestId>
</ModifyAntiBruteForceRuleResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "F35F45B0-5D6B-4238-BE02-A62D0760E840"
}

Error codes

HTTP status code Error code Error message Description
400 NotBuy user not buy service The error message returned because the service is not purchased.
500 ServerError ServerError The error message returned because a server error occurred.

For a list of error codes, visit the API Error Center.